PVME-Docs is a static site that is generated from the pvme-guides repository.
The site is generated using the Material for Mkdocs theme.
Python
Install the python version specified in the Pipfile [requires] section.
Pipenv
pip install pipenv
Pipenv is used to create virtual environments from a Pipfile and Pipfile.lock
pipenv sync
This will setup a virtual environment and install packages from Pipfile.lock.
note: use pipenv --rm to reset the old environment in case of any installation issues.
Clone pvme-guides
git clone --depth 1 https://github.com/pvme/pvme-guides.git
Building the site
pipenv run mkdocs build
This will build the site locally under the site/ folder.
Updating packages
pipenv update
Updates packages in Pipfile.lock to the latest version according to the versions specified in Pipfile.
Installing new packages
pipenv install package
This adds the package to the Pipfile and Pipfile.lock.
Debugging
pipenv run python gen_pages.py
This will write the generated .md files to the docs/pvme-guides folder. This is useful for comparing builds.
Note: You might need to remove the docs/pvme-guides folder before building the site.
Viewing Changes
Build the site and open a live server using:
pipenv run mkdocs serve
Alternatively, after running pipenv run mkdocs build, open /site/index.html using a live server.