README.md

Codex Docs

This repo contains the documentation for the Wild Me product Codex. Documentation is published with every accepted PR.

Planned changes

• Retirement of product

Local Setup

1. Install the prereqs:

• install sphinx
• install sphinx-book-theme: pip install sphinx-book-theme
• install myst-parser (used by sphinx markdown extension): pip install myst-parser

2. Clone the wildme-docs repo: git clone https://github.com/WildMeOrg/wildme-docs.git

Build locally

To build:

1. cd to the docs directory:
2. Run the following commands:

   python -m venv .venv
   source .venv/bin/activate
   make html
   

3. Files will be in docs/_build/html/

If you aren't seeing your changes, try make clean html to force a complete rebuild.

To see files as they will appear online, including url paths:

1. In a new terminal, cd to docs/_build/html/
2. python -m SimpleHTTPServer or python3 -m http.server
3. Open http://localhost:8000 in your browser