Building the jsPsych documentation¶
The documentation hosted at https://www.jspsych.org is generated using mkdocs and the mkdocs-material theme. The documentation files are located in the
/docs directory of the GitHub repository. The documentation is written using markdown.
To build a local copy of the docs, you will need to install
Poetry is a package manager for python. Follow the install instructions on the
poetry website to get it running.
Install dev dependencies¶
Run the command
poetry install in the root directory of jsPsych to install
mkdocs-material, and their dependencies.
Building a local copy of the docs¶
poetry run mike deploy [version] -u to build a new version of the documentation or to override an existing version. For example, if you are testing an edit to version
7.2 of the documentation, run
poetry mike deploy 7.2 -u.
This will build the documentation and commit it directly to the
mike instead of
mkdocs for the build step to support versioning of the documentation.
mike runs the
mkdocs command under the hood.
Viewing the local docs¶
poetry run mike serve to launch a local webserver. The docs will be viewable at