hexdoc-hexcellular


Namehexdoc-hexcellular JSON
Version 1.0.2.1.0.dev0 PyPI version JSON
download
home_pageNone
SummaryPython web book docgen and hexdoc plugin for Hexcellular.
upload_time2024-08-04 19:44:48
maintainerNone
docs_urlNone
authormiyucomics
requires_python>=3.11
licenseNone
keywords hexdoc
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # hexdoc-hexcellular

Python web book docgen and [hexdoc](https://pypi.org/project/hexdoc) plugin for Hexcellular.

## Version scheme

We use [hatch-gradle-version](https://pypi.org/project/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`

## Setup

Install Python 3.11 and Node 18 (20+ is **not** currently supported).

```sh
python3.11 -m venv venv

.\venv\Scripts\activate   # Windows
. venv/bin/activate.fish  # fish
source venv/bin/activate  # everything else

# run from the repo root, not doc/
pip install -e .[dev]
```

## Usage

For local testing, create a file called `.env` in the repo root following this template:
```sh
GITHUB_REPOSITORY=miyucomics/hexcellular
GITHUB_SHA=main
GITHUB_PAGES_URL=https://miyucomics.github.io/hexcellular/
```

Useful commands:
```sh
# show help
hexdoc -h

# render and serve the web book in watch mode
nodemon --config doc/nodemon.json

# 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
```

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "hexdoc-hexcellular",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": null,
    "keywords": "hexdoc",
    "author": "miyucomics",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/c7/19/f93ad6006a8c17cc81672e11878fa60c1b912185a850f6e47ce2c17205ac/hexdoc_hexcellular-1.0.2.1.0.dev0.tar.gz",
    "platform": null,
    "description": "# hexdoc-hexcellular\n\nPython web book docgen and [hexdoc](https://pypi.org/project/hexdoc) plugin for Hexcellular.\n\n## Version scheme\n\nWe use [hatch-gradle-version](https://pypi.org/project/hatch-gradle-version) to generate the version number based on whichever mod version the docgen was built with.\n\nThe version is in this format: `mod-version.python-version.mod-pre.python-dev.python-post`\n\nFor example:\n* Mod version: `0.11.1-7`\n* Python package version: `1.0.dev0`\n* Full version: `0.11.1.1.0rc7.dev0`\n\n## Setup\n\nInstall Python 3.11 and Node 18 (20+ is **not** currently supported).\n\n```sh\npython3.11 -m venv venv\n\n.\\venv\\Scripts\\activate   # Windows\n. venv/bin/activate.fish  # fish\nsource venv/bin/activate  # everything else\n\n# run from the repo root, not doc/\npip install -e .[dev]\n```\n\n## Usage\n\nFor local testing, create a file called `.env` in the repo root following this template:\n```sh\nGITHUB_REPOSITORY=miyucomics/hexcellular\nGITHUB_SHA=main\nGITHUB_PAGES_URL=https://miyucomics.github.io/hexcellular/\n```\n\nUseful commands:\n```sh\n# show help\nhexdoc -h\n\n# render and serve the web book in watch mode\nnodemon --config doc/nodemon.json\n\n# render and serve the web book\nhexdoc serve\n\n# export, render, and merge the web book\nhexdoc export\nhexdoc render\nhexdoc merge\n\n# start the Python interpreter with some extra local variables\nhexdoc repl\n```\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Python web book docgen and hexdoc plugin for Hexcellular.",
    "version": "1.0.2.1.0.dev0",
    "project_urls": {
        "Homepage": "https://miyucomics.github.io/hexcellular/",
        "Source": "https://github.com/miyucomics/hexcellular"
    },
    "split_keywords": [
        "hexdoc"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "eb997b29116fb717b098ceef95bb673f9af31053d05fd1307d7d24f2ea112f67",
                "md5": "47cf889f55e967e7f6b9b4790a56e1ea",
                "sha256": "1bcdb69ba3492dcd2d296a6f9a653068aa51d343c58872652ea52242ec00d385"
            },
            "downloads": -1,
            "filename": "hexdoc_hexcellular-1.0.2.1.0.dev0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "47cf889f55e967e7f6b9b4790a56e1ea",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 11195,
            "upload_time": "2024-08-04T19:44:48",
            "upload_time_iso_8601": "2024-08-04T19:44:48.078214Z",
            "url": "https://files.pythonhosted.org/packages/eb/99/7b29116fb717b098ceef95bb673f9af31053d05fd1307d7d24f2ea112f67/hexdoc_hexcellular-1.0.2.1.0.dev0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c719f93ad6006a8c17cc81672e11878fa60c1b912185a850f6e47ce2c17205ac",
                "md5": "0ff1922919663bb14d6c9e0ee152ff20",
                "sha256": "560a82cfeaca145a27c3dc9b4150bc002a12093d463a31397106e9082397749a"
            },
            "downloads": -1,
            "filename": "hexdoc_hexcellular-1.0.2.1.0.dev0.tar.gz",
            "has_sig": false,
            "md5_digest": "0ff1922919663bb14d6c9e0ee152ff20",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 7052,
            "upload_time": "2024-08-04T19:44:48",
            "upload_time_iso_8601": "2024-08-04T19:44:48.953257Z",
            "url": "https://files.pythonhosted.org/packages/c7/19/f93ad6006a8c17cc81672e11878fa60c1b912185a850f6e47ce2c17205ac/hexdoc_hexcellular-1.0.2.1.0.dev0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-08-04 19:44:48",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "miyucomics",
    "github_project": "hexcellular",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "hexdoc-hexcellular"
}
        
Elapsed time: 0.73872s