The Ligato Docs repository contains the documentation source text and figures for the Ligato project. You can locate the documentation website at docs.ligato.io.
All commited changes to this repository will be reflected to the docs website after a build process is completed. The build process can take several minutes before the updates appear on the docs website. You can watch the build process on ReadTheDocs Ligato Builds.If the build fails for some reason, the changes will not appear on the docs website.
You should verify changes locally before pushing to the main docs repository to ensure that everything looks okay. You can fix broken links, or other formatting issues, before you deploy to the docs website. To do so, you need to install
1. Install MkDocs
Look over install mkdocs
Please make sure you install version 1.0.4, otherwise some elements may not format properly.
$ mkdocs --version mkdocs, version 1.0.4 from /usr/local/lib/python3.6/dist-packages/mkdocs (Python 3.6)
2. Clone Repository
$ git clone https://github.com/ligato/docs
$ cd docs
3. Start Server
To start the local server, use following command in the root directory:
$ mkdocs serve
The documentation site should be accessible at:
http://localhost:8000/. The server watches for and lists any changes in a log.
Note: The mkdocs rtd-dropdown theme is used (configured inside the mkdocs.yml file). If not present, you might need to install it. Instructions here.