All Projects â†’ codebar â†’ Tutorials

codebar / Tutorials

🗒 codebar's tutorials

Programming Languages

javascript
184084 projects - #8 most used programming language
python
139335 projects - #7 most used programming language
ruby
36898 projects - #4 most used programming language

Projects that are alternatives of or similar to Tutorials

Gitman
Language-agnostic dependency manager using Git.
Stars: ✭ 139 (-39.83%)
Mutual labels:  command-line, version-control
Inquirer.js
A collection of common interactive command line user interfaces.
Stars: ✭ 15,378 (+6557.14%)
Mutual labels:  command-line
Pdd
📅 Tiny date, time diff calculator with piggybacked timers
Stars: ✭ 218 (-5.63%)
Mutual labels:  command-line
Gitlab Cli
Create a merge request from command line in gitlab
Stars: ✭ 224 (-3.03%)
Mutual labels:  command-line
Noflo Jekyll
Flow-based reimplementation of the Jekyll static site generator
Stars: ✭ 219 (-5.19%)
Mutual labels:  jekyll
Jquery.terminal
jQuery Terminal Emulator - JavaScript library for creating web-based terminals with custom commands
Stars: ✭ 2,623 (+1035.5%)
Mutual labels:  command-line
Jekyll Admin
A Jekyll plugin that provides users with a traditional CMS-style graphical interface to author content and administer Jekyll sites.
Stars: ✭ 2,531 (+995.67%)
Mutual labels:  jekyll
Icevision
End-to-End Object Detection Framework - Pluggable to any Training Library: Fastai, Pytorch-Lightning with more to come
Stars: ✭ 218 (-5.63%)
Mutual labels:  tutorials
Jekyll Mdl
A Jekyll theme based in Google Material Design Lite library.
Stars: ✭ 227 (-1.73%)
Mutual labels:  jekyll
Go Termd
Package termd provides terminal markdown rendering, with code block syntax highlighting support.
Stars: ✭ 223 (-3.46%)
Mutual labels:  command-line
Klog
A plain-text file format and command line tool for time tracking
Stars: ✭ 222 (-3.9%)
Mutual labels:  command-line
Hcl
Command-line tool for manipulating Harvest timesheets
Stars: ✭ 219 (-5.19%)
Mutual labels:  command-line
Nef
💊 steroids for Xcode Playgrounds
Stars: ✭ 226 (-2.16%)
Mutual labels:  jekyll
Jekyll Gist
📃 Liquid tag for displaying GitHub Gists in Jekyll sites.
Stars: ✭ 218 (-5.63%)
Mutual labels:  jekyll
Aws Adfs
Command line tool to ease aws cli authentication against ADFS (multi factor authentication with active directory)
Stars: ✭ 229 (-0.87%)
Mutual labels:  command-line
Kmdr Cli
🧠 The CLI tool for learning commands from your terminal
Stars: ✭ 218 (-5.63%)
Mutual labels:  command-line
Hcz Jekyll Blog
A simple material theme for blogger
Stars: ✭ 220 (-4.76%)
Mutual labels:  jekyll
Millennial
A minimalist Jekyll theme for running an online publication
Stars: ✭ 223 (-3.46%)
Mutual labels:  jekyll
Wai Tutorials
W3C WAI’s Web Accessibility Tutorials
Stars: ✭ 229 (-0.87%)
Mutual labels:  tutorials
Git Novice
Version Control with Git
Stars: ✭ 227 (-1.73%)
Mutual labels:  version-control

This is the source code for http://tutorials.codebar.io/

Getting started

This is a GitHub Pages repo, so you can render the pages with Jekyll. First make sure to install the version of Ruby indicated in .ruby-version, as well as the bundler gem. Then:

  1. bundle install, which will install Jekyll
  2. bundle exec jekyll serve --watch
  3. go to http://localhost:4000/

(you could also use your favourite manager, chruby, rbenv, rvm, etc. See instructions for rvm at the end of this README)

If you are just updating or adding new tutorials, follow steps 1 to 3 only.

If you also want to make changes to the structure of the site (i.e. if you want to modify the site's Javascript files) and run the tests, you need to install Node (follow the link for installation instructions). Then:

$ npm install
$ gulp

and go to http://localhost:4000/test/specrunner.html to run the tests. Tests should be green.

Gulp is only used for development, not in production. In your local copy of this repo, it will concatenate and minify the files inside the javascripts-dev folder, as well as watch for changes in that folder. The concatenated and minified JS file will be generated inside the javascripts folder. You can push both folders when you are finished with your changes. GitHub pages will then generate the site in production with whatever is inside the javascripts folder.

Getting in Touch

You can go to the general codebar Slack channel here or the dedicated tutorials channel here. Use it to get in touch and chat to other codebar students/coaches, or if you need help.

If you are not on Slack use this link to get an invite.

Contributing

We encourage you to contribute with your suggestions and corrections. Head to our issues page and open a new issue or help on the existing ones.

General tutorial rule
  1. All tutorials get the students to build something that they are able to show around at the end of the workshop.

  2. All tutorials follow a structure:

    • Objectives - "In this tutorial we are going to look at..."
    • Goals - "By the end of this tutorial you will have..."
    • Then the exercises.
      • Bonus - This is not always required but if you feel there is something that could be added then please include it.
      • Further reading - Again this is not always required but if you feel there was something in the tutorials that could be covered in more depth then please include any good reading materials/videos or extra tutorials.
  3. Repetition is good. A tutorial can contain multiple exercises that ask the students to take similar steps (e.g. for HTTP Requests one exercise introduces GET, another has GET and POST etc).

  4. Explaining and getting the students to focus on one new thing at a time, presenting students with lots of new content and usage examples can be confusing.

  5. Before starting to write a new tutorial please speak with someone from codebar to see whether it is of interest to students.

To add downloadable files to a new or existing tutorial:
  • Add a folder with your exercise files inside the tutorial folder. For example, for Javascript lesson 3:
js/lesson3/
├── assets/
├── files/
│   ├── index.html
│   ├── jquery.js
│   ├── script.js
│   └── style.css
└── tutorial.md
  • Add a frontmatter variable files to the tutorial page with a list of the files you added, including folder name:
---
layout: page
title: Introduction to jQuery
files:
  - files/index.html
  - files/jquery.js
  - files/script.js
  - files/style.css
---
  • In the copy of the tutorial, add your link to the files, making it point to just download:
Download the files that you will need to work through the example
[here](download).

And you're done. Commit and push as usual.

RVM

Another way of installing the project dependencies is via RVM. Follow the quick installation guide and then run:

$ rvm install 2.2.1  # inside `codebar/tutorials` folder
$ rvm gemset use codebar-tutorial --create
$ gem install bundler
$ bundle install
$ jekyll serve  # go to http://127.0.0.1:4000/

If you also want to make changes to the JavaScript of the site, you'll need to have Node installed. This can be done with a tool like NVM.

License

codebar Tutorials are released under the Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0).

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].