GitHub Training Manual
Welcome to the GitHub Training Manual repository. In this repository, you will find the content used by the GitHub Professional Services team during our official GitHub training courses and the scripts used when teaching.
The content is all written in Markdown, and the scripts are shell scripts.
Goals and scope
The goal of this project is to serve as a content source for training on Git and GitHub. While GitHub, select GitHub Partners, and select customers may have their own use case directly with GitHub, the content is open source so we can share and improve as a community. You can find more information on contributing in the contributing guide.
The topic scope is limited to GitHub's core product features, on GitHub.com and also for GitHub Enterprise users.
Deploy the manual
These manuals are designed to be generated using docsify. To get your own manuals up and running, all you have to do is:
- Fork this repository
- In your fork, click on Settings
- Scroll down to the GitHub Pages section, and set Source: to
main branch /docs folder.
- Click Save.
- Return to the GitHub Pages section of Settings, and you'll receive the URL of your published manual.
The official docsify documentation is your best bet for getting up to speed with the tool.
In general, you'll find all of the manual content in the
docs/ folder of this repository. All content is written in Markdown, and it's all stitched together in
docs/_sidebar.md, which specifies the order and hierarchy of the content.
Preview changes on your machine
You can install, and serve the contents of the
docs/ folder locally with minimal setup. The steps are thoroughly described in the doscify quick start guide.
You can also simply run the following scripts:
Generate a PDF
Docsify doesn't currently support creating PDFs, but you can generate one using GitBook legacy. We've tried to make this simple for you by creating
script/generate-pdf. The legacy version of GitBook is being shut down soon, but it still works. You'll need to follow the installation instructions below to install GitBook. The previous installation instructions on the GitBook site have been removed.
Download and install Calibre.
Run Calibre once to set up the application.
Make sure that the Calibre command line interface is available on your path. This is located at
/Applications/calibre.app/Contents/MacOS/on macOS if you are running the application from the default location.
Scripts that accompany the manual, and their documentation can be found in the
script/ directory. This repository includes development container configuration. So you can run the scripts on the Visual Studio developer container or GitHub Codespaces.