Python web book docgen for Patchouli and Hex Casting.
Reason this release was yanked:
Outdated, use hexdoc 1!0.1.x and hexdoc-hexcasting instead.
Project description
hexdoc
This is the Python docgen for Hex Casting.
Version scheme
We use hatch-gradle-version to generate the version number based on whichever mod version the docgen was built with.
The version is in this format: mod-version.python-version.mod-pre.python-dev.python-post
For example:
- Mod version:
0.11.1-7
- Python package version:
1.0.dev0
- Full version:
0.11.1.1.0rc7.dev0
Creating a plugin / addon
WIP.
- Run these commands, then follow the prompts:
pip install cookiecutter cookiecutter gh:object-Object/HexMod --directory doc
- Note: if you run this from within an existing mod repo, add the flag
-f
and leaveoutput_directory
blank.
- Note: if you run this from within an existing mod repo, add the flag
- Fill in the TODOs in
doc/properties.toml
(mostly paths to files/folders in your mod so hexdoc can find the data it needs). - Try running the docgen locally by following the instructions in
doc/README.md
. - If it doesn't already exist, create an empty
gh-pages
branch and push it. - On GitHub, under
Settings > Pages
, set the source toDeploy from a branch
, the branch togh-pages
, and the folder todocs/
. - Commit and push the docgen, and see if the CI works.
- On GitHub, under
Settings > Environments
, create two new environments calledpypi
andtestpypi
. - Follow these instructions for PyPI and TestPyPI: https://docs.pypi.org/trusted-publishers/creating-a-project-through-oidc/
- TestPyPI is a duplicate of PyPI which can be used for testing package publishing without affecting the real index. The CI workflow includes a manual execution option to publish to TestPyPI.
- If you like to live dangerously, this step is optional - you can remove the
publish-testpypi
job and theTestPyPI
release choice from your workflow without impacting the rest of the CI.
Setup
python -m venv venv
.\venv\Scripts\activate # Windows
source venv/bin/activate # anything other than Windows
# run from the repo root, not doc/
pip install -e .[dev]
Usage
For local testing, create a file called .env
following this template:
GITHUB_REPOSITORY=gamma-delta/HexMod
GITHUB_SHA=main
GITHUB_PAGES_URL=https://gamma-delta.github.io/HexMod
Then run these commands to generate the book:
# run from the repo root, not doc/
hexdoc render doc/properties.toml _site/src/docs
hexdoc merge --src _site/src/docs --dst _site/dst/docs
Or, run this command to render the book and start a local web server:
hexdoc serve doc/properties.toml --src _site/src/docs --dst _site/dst/docs
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-0.11.1.1.0rc7.dev17.tar.gz
(130.8 kB
view hashes)
Built Distribution
Close
Hashes for hexdoc-0.11.1.1.0rc7.dev17.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | bb559abb206024e369bf859ed91c80da8a68faaf0bb3c301dd071b74d191350c |
|
MD5 | ed5726e39ed0ed6319c482d00f16af34 |
|
BLAKE2b-256 | f8b40e3513c0b592dafbd91795ad91e6bc62f4438331f34e02a750deef36e58f |
Close
Hashes for hexdoc-0.11.1.1.0rc7.dev17-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e2af6310a4565b51b5483742b9540dc3ffcf5124c6a72929b9402c74a8f05d5a |
|
MD5 | 9c9f0ce3ee6a62374d2a74722bd52789 |
|
BLAKE2b-256 | aac2357f84aaf170f6d371a86d558c9e73af85002835891be8d1a0e1f955d87c |