Skip to content


Repository files navigation


Welcome to the LearnTeachCode Code & Coffee Compendium Github Repository! Maintained by the Code & Coffee Office Hours study group, this repository hosts the source code for code-coffee-compendium resource site.

This site was generated using Asciidoctor - a static-site generator for the AsciiDoc markup language.

Want extra coding help? Join our Slack group.


Contributors are welcome to fork this repository and make changes. Please submit a Pull Request (PR) with your changes to be reviewed by a repository owner.

Not sure where to start? There are a number of issues that you can work on. Find them here.


This project has a number of dependencies that must be met before running on your machine.

  1. Docker

  2. Git (for contributors, quicker access to the repository source code)

  3. A Bash terminal (standard terminal environment for *nix and macOS).

To Windows users: Windows Command Prompt will not satisfy this dependency. Instead, you can use PowerShell or another Bash terminal (like Git Bash for example).

Viewing the site through a local web server

Please make sure you have all required dependencies before continuing.

There may be situations where you want to view the site locally through a local web server. In this case, you should run For example, type the following command in the project directory:

  1. Clone or download this repository to your machine.

  2. Open a terminal window. Change your current directory to the cloned project directory.

  3. Using a Bash terminal, type the following command to update all dependent submodules:

git submodule update --init --recursive
  1. Next, type the following command:

If you receive a permissions error on *nix or macOS, prepend sudo to the command. For example, type the following command:
sudo sh

After running the script, you can access the site through your web browser through this URL: http://localhost:1313/code-coffee-compendium/home

You can stop the local web server by pressing CTRL + C in the Bash terminal where you ran the script.