Skip to content

Commit d61fdb0

Browse files
author
Grant Olson
committed
Tell SDK users how to build a copy of the documentation that can be accessed even if Anki servers go away
1 parent 766e0e1 commit d61fdb0

3 files changed

Lines changed: 17 additions & 0 deletions

File tree

README.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,9 @@ Forums: https://forums.anki.com/
1515

1616
You can follow steps [here](https://developer.anki.com/vector/docs/index.html) to set up your Vector robot with the SDK.
1717

18+
You can also generate a local copy of the SDK documetation by
19+
following the instructions in the `docs` folder of this project.
20+
1821

1922
## Privacy Policy and Terms and Conditions
2023

docs/README.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,14 @@ so changes to the source code will be reflected in docs builds.
77

88
To update and build the docs, follow the steps below.
99

10+
## Installing sphinx
11+
12+
The
13+
[Sphinx Documetation Generator](https://www.sphinx-doc.org/en/master/)
14+
is used to build the docs. You'll need to have it installed on your
15+
system with `pip install -r requirements.txt` using the
16+
`requirements.txt` file in this directory and not the main project directory.
17+
1018
## Updating the Docs
1119

1220
There are a few files that are not automatically generated and reside in `source`. For example,
@@ -22,3 +30,6 @@ the html version of the docs.
2230
make clean
2331
make html
2432
```
33+
34+
You will now have an offline copy of the documetation that can be
35+
accessed by opening `.build/html/index.html`

docs/requirements.txt

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
sphinx
2+
sphinx-autodoc-typehints
3+
sphinx_rtd_theme

0 commit comments

Comments
 (0)