mirror of
https://github.com/Outer-Wilds-New-Horizons/new-horizons.git
synced 2025-12-11 20:15:44 +01:00
42 lines
1.1 KiB
Markdown
42 lines
1.1 KiB
Markdown
# Setup to build docs
|
|
|
|
## Requirements
|
|
- Python 3.10
|
|
|
|
## Clone the repo
|
|
Clone the entire repo and navigate to the docs folder
|
|
```shell
|
|
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
|
|
```shell
|
|
pip install --user pipenv
|
|
```
|
|
Install dependencies
|
|
```shell
|
|
pipenv install --dev
|
|
```
|
|
|
|
## Environment Variables
|
|
- URL_PREFIX: Path to put before all links and static files, see below for recommended values
|
|
- Production and Local Builds: "/"
|
|
- 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
|
|
```shell
|
|
pipenv run menagerie generate
|
|
```
|
|
|
|
## Opening
|
|
- Production: Go to the site
|
|
- Local: Go into `docs/out` in a new terminal window and run `py -m http.server 8080` and then connect to http://localhost:8080/
|
|
- PyCharm Development Server: Right click `out/index.html` -> Open In -> Browser -> Default
|