Python web book docgen for Patchouli and Hex Casting.
Project description
hexdoc
A Jinja-based documentation generator for Patchouli books.
This is the library that powers Hex Casting's web book.
Plugins
See hexdoc-hexcasting-template for instructions to set up a hexdoc plugin for a pre-existing Hex Casting addon.
Contributing
Setup
git submodule update --init
python3.11 -m venv venv
.\venv\Scripts\activate # Windows
. venv/bin/activate.fish # fish
source venv/bin/activate # everything else
pip install -e .[dev]
pre-commit install
Usage
For local testing, create a file called .env
in the repo root following this template:
GITHUB_SHA=main
GITHUB_REPOSITORY=hexdoc-dev/hexdoc
GITHUB_PAGES_URL=https://hexdoc.hexxy.media
Useful commands:
# show help
hexdoc -h
# render and serve the web book in watch mode
nodemon
# render and serve the web book
hexdoc serve
# export, render, and merge the web book
hexdoc export
hexdoc render
hexdoc merge
# start the Python interpreter with some extra local variables
hexdoc repl
# run tests
pytest # fast, skips Cookiecutter
nox # slow, full test suite in an isolated venv
nox --no-install # after the first Nox run, use this to skip reinstalling everything
# update test snapshots
nox -- --snapshot-update
# run hexdoc commands in an isolated environment to ensure it works on its own
nox -s hexdoc -- export
nox -s hexdoc -- repl
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
hexdoc-1!0.1.0.dev7.tar.gz
(94.3 kB
view hashes)
Built Distribution
hexdoc-1!0.1.0.dev7-py3-none-any.whl
(136.7 kB
view hashes)
Close
Hashes for hexdoc-1!0.1.0.dev7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 56e33e847d0963b54e26d63c46a5a348506d5dff77169ed1ea8697d6902c2d93 |
|
MD5 | 62b2bb9c82371b1d7a4ee813a46e85e8 |
|
BLAKE2b-256 | 9a79af2b500fef2267c1f518419b74f5e2784614ba42d7c0f90f19fdb0b2a4dc |