mirror of https://github.com/Outer-Wilds-New-Horizons/new-horizons.git synced 2025-12-11 20:15:44 +01:00

* Reworked docs

* Add base_url to config.json

* Add Pipfile

* Update docs_build.yml

* Add opengraph metadata

* Make caching work

* Add link to addon creation tool

* Add link to VSCode

2022-04-15 14:09:50 -07:00

1.1 KiB

Raw Blame History

Setup to build docs

Requirements

Python 3.10

Clone the repo

Clone the entire repo and navigate to the docs folder

git clone https://github.com/xen-42/outer-wilds-new-horizons
cd outer-wilds-new-horizons/docs

Setup Pipenv

Install pipenv if you haven't already

pip install --user pipenv

Install dependencies

pipenv install --dev

Environment Variables

URL_PREFIX: Path to put before all links and static files, see below for recommended values
- Production: "/"
- Local Build: "" (set as empty string)
- PyCharm Development Server: "/outer-wilds-new-horizons/docs/out/"

Copy Schemas

Create a folder called schemas in the docs/content/pages/ folder and copy all schemas to generate into it, make sure not to add this folder to git. Production build automatically copies over schemas.

Generating

Run generate with pipenv

pipenv run python -m menagerie generate

Opening

Production: Go to the site
Local: Open out/index.html
PyCharm Development Server: Right click out/index.html -> Open In -> Browser -> Default

1.1 KiB Raw Blame History