To find more about us or download PDFs of our curriculums, please see our website. This GitHub is meant for contributers to the curriculum or anyone who wants to build off what we have created. If you don't have experience with GitHub or LaTeX, don't worry, just email us at bitsandbots.neu@gmail.com with your lesson ideas and we'll get back to you!
The first step is to download a LaTeX distributions. I suggest the following:
Mac: MacTex
Windows: MiKTeX
Linux/Cross Platform: TeX Live
I've tested a few offline LaTeX editors, and personally found the simplest to be:
Mac Only: TeXworks Windows: MiKTeX Linux/Windows/Mac: Texmaker
After unzipping and installing TeX Live,
you may still need to install latexmk
and xelatex
.
sudo apt-get install latexmk texlive-xetex
While I highly suggest an offline editor (to make your git workflow simpler), Overleaf is a great online editor which you can use to get started writing LaTeX right away.
Note: Select XeLaTeX
as the LaTeX varient when you compile the lessons (on TeXworks, it appears on the top left drop down menu).
All style and template definitions go in
Please feel free to open an issue on GitHub or to email us at: bitsandbots.neu@gmail.com
We would be happy to help you start contributing! If I get enough emailss, I'll also create a video guide to installing it on every platform.
If you'd like to report a bug, see the section above).
Fork our repo. When you're ready to merge your contributions, create a PR to master and add one of the core members as a reviewer.
Copyright 2019 Bits&Bots
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Please feel free to email us at bitsandbots.neu@gmail.com to explain why the license is too restricting for your use. We reserve the right to decline/accept exception requests depending on your use case.
The details of the exception will be specified in our email communication and may be different per request.
git clone git@github.com:bits-and-bots/lessons.git
If you want to build all the lessons at once, or just prefer working in a text editor, you can use the included makefile to compile lessons.
To compile all the lessons in your terminal, navigate to the project directory, and run:
make
To compile a specific lesson, just include the name of the pdf file you want to generate. For example to build lesson one, you would write:
make lesson1.pdf
The resulting pdf files for that will be placed in the newly created out folder.
If you want to build all the lessons at once, you can use the included powershell script to compile lessons.
To compile all the lessons in your terminal, you can
win-compile-all.ps1
and select "Run with PowerShell"
or.\win-compile-all.ps1
Additionally, if you are able to install WSL (Windows Subsytem for Linux) onto your Windows machine, you can follow the mac/linux instructions more directly.
TODO: script to compile individual lessons
git checkout master
git pull
git checkout -b <BRANCH_NAME>
git push --set-upstream origin
git add -A
git commit -m "<A message saying what you changed>"
git push