Conversation
Co-authored-by: Abdo <abdo@abdnh.net>
| To build the API docs used by Anki's existing Python Sphinx pipeline: | ||
|
|
||
| ``` | ||
| ./ninja python:sphinx |
There was a problem hiding this comment.
hey @abdnh and @andrewsanchez
When you run this command, does this work for you?
Because, on my side, when I try to run, I get an error.
In this line: https://github.com/ankitects/anki/blob/main/build/configure/src/python.rs#L233 I must change it to:
"$uv sync --group sphinx && $python python/sphinx/build.py" // remove this line
"$uv sync --group docs && $python python/sphinx/build.py" // add this line
Does it make sense?
There was a problem hiding this comment.
It doesn't work, because the sphinx group was removed as you noted.
| sphinx = [ | ||
| docs = [ | ||
| "sphinx", | ||
| "sphinx_rtd_theme", |
There was a problem hiding this comment.
@andrewsanchez is there a reason to remove it?
I'm asking because when I try to run it, I get a build error, and I have to add it back to work welll
There was a problem hiding this comment.
I specified the html theme in conf.py so not sure why you're getting that error but I'll check!
There was a problem hiding this comment.
okay, because I can't get it to run successfully locally.
3 participants
This is intended to demo an approach for closing #4578
Docs will temporarily be built from this branch and can be previewed here: https://anki-core.readthedocs.io/en/latest/ (
anki.readthedocs.iowas taken so using this just for demo purposes).