Generating Docs
Enable GitHub Pages
-
On GitHub go to “Settings” -> “Pages”.
-
In the “Source” section, choose “Deploy from a branch” in the dropdown menu.
-
In the “Branch” section choose “gh-pages” and “/root” in the dropdown menus and click save.
You should now be able to verify the pages deployment in the Actions list.
For full documentation visit mkdocs.org.
Commands
mkdocs new [dir-name]- Create a new project.mkdocs serve- Start the live-reloading docs server.mkdocs build- Build the documentation site.mkdocs -h- Print help message and exit.
Project layout
mkdocs.yml # The configuration file.
docs/
index.md # The documentation homepage.
... # Other markdown pages, images and other files.