Docsy Documentation
The documentation for PM is generated using Hugo with the Docsy theme. The main advangtage of Hugo is how fast it is, and you can basically see your changes to the documentation in real time when viewing the site on a local server. The Docsy theme brings all of the advanced features that are needed for technical documentation, including detailed support for code markup (via prism), latex support (via katex), etc.
This documentation is stored in the github repository
principia-materia-docsy.
When you push to the github repository, the site will automatically be built using github actions and served at
https://marianettigroup.github.io/. If you want to push to github without rebuilding,
include [skip actions]
in your commit message.
To view the documentation locally, start by installing hugo; snap is probably the most convenient way:
sudo snap install hugo
Now change into the directory of your local pm-docsy repo, and start the hugo server:
hugo server
You can then view the docs by pointing your browser to the local port that hugo prints out, which is normally http://localhost:1313/.
If you want to add to the documentation, you will find the markdown source files in the repo here: content/en/docs/.
The command line input tags are documented in the following yaml file: data/input_tag_info.yaml. This file is automatically generated by the Data Aggregator module. There is a command line interface command which can regenerate the yaml file:
$ pm-get_variable_doc
- name: basis_atoms
description: Basis atoms of the crystal structure.
type: dict-float-array
dimension: scalar \( \leftrightarrow N_{j}\times3\) where \(j\) labels species of atom.
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.