Installation and Setup¶
Quick Installation¶
To install the juvix-mkdocs
plugin, run:
pip3 install mkdocs-juvix-plugin
Add the plugin to your mkdocs.yml
:
mkdocs.yml
plugins:
- juvix
# - todos
Front-matter Options¶
Customize plugin behavior using front-matter options:
---
preprocess:
juvix: true
isabelle: true
include_at_bottom: true
---
Creating a New Project¶
Create a new project using the CLI command:
juvix-mkdocs new my-juvix-project
View all options with:
juvix-mkdocs new --help
For Anoma setup:
juvix-mkdocs new my-juvix-project --anoma-setup
Building and Running¶
Build the website:
juvix-mkdocs build
Run the development server:
juvix-mkdocs serve
Some flags are available for these commands:
--remove-cache
: Remove the cache database.--verbose
: Print verbose output.--debug
: Print debug output.--no-open
: Do not open the browser after building.--quiet
: Do not print any output.
Development Mode
For development, after poetry install
and poetry shell
:
juvix-mkdocs new -n -f -D
juvix-mkdocs serve -p my-juvix-project