tfscript/docs
Paco Hope 7208ced0ca Merge branch 'main' of https://git.paco.to/tfscript/tfscript 2022-08-13 16:51:00 -04:00
..
source broke types out to its own doc file 2022-08-13 16:50:56 -04:00
Makefile Adding documentation 2022-08-09 18:48:18 -04:00
README.md Added some instructions 2022-08-13 16:17:20 -04:00
requirements.txt Updated styles and theme options 2022-08-09 19:55:04 -04:00
sync.sh Adding documentation 2022-08-09 18:48:18 -04:00

README.md

Building Documentation

This is the documentation that appears on The tfscript website.

Building the Docs

Before you can build the docs, you have to do the Prerequisites below.

  1. Run make html
  2. The docs appear in docs/build/html. You can open them in a browser (e.g., on Mac do open docs/build/html/index.html)
  3. Run sync.sh to upload it to the S3 bucket (only works if you have the right profile/permissions in AWS)

Prerequisites

I recommend building a Python venv.

Windows

  1. Make the virtual environment python3 -m venv .venv
  2. Activate it:
  • Windows: .venv\Scripts\activate
  • Other: .venv/bin/activate
  1. Install all the requirements into it:
    1. pip install -r requirements.txt
    2. pip3 install -e .

Now you can run the steps above in the Building section.