Welcome to Codecheck's Organization Documentation Repo!
We use Mkdocs to build the site using only Markdown,
and we host it by pushing the built HTML pages to GitHub Pages.
This page is live here. If you just want to view our documentation, I recommend the live page.
If you want to work on the site, you will want to install and run a local dev copy of it.
- Install all dependencies.
git clone
the contents of this repo.cd [directory of clone]/source && mkdocs serve
- Access http://localhost:8000/
- Yatta, you're ready!
- Python3 & Pip3
- Mkdocs (
pip3 install mkdocs
)
- All of the source files are located in
/source
. - You can
mkdocs serve
to run and view the site locally. - When you want to generate the static pages:
- First, go to
/source
andpython3 build.py
. - The static pages will be generated into
./source/site
. - Move all the files in
/source/site
to the top. Remove any old files.