Docs: Show todos in previews

That includes local builds.
Also fix release version numbers.
This commit is contained in:
Krystine Sherwin 2024-08-29 10:43:01 +12:00
parent 25623b1010
commit 558f313a78
No known key found for this signature in database
1 changed files with 9 additions and 4 deletions

View File

@ -61,15 +61,24 @@ if os.getenv("READTHEDOCS"):
autosectionlabel_prefix_document = True autosectionlabel_prefix_document = True
autosectionlabel_maxdepth = 1 autosectionlabel_maxdepth = 1
# include todos for previews
extensions.append('sphinx.ext.todo')
# set version # set version
if os.getenv("READTHEDOCS"): if os.getenv("READTHEDOCS"):
rtds_version = os.getenv("READTHEDOCS_VERSION") rtds_version = os.getenv("READTHEDOCS_VERSION")
if rtds_version == "latest": if rtds_version == "latest":
release = yosys_ver + "-dev" release = yosys_ver + "-dev"
todo_include_todos = False
elif rtds_version.startswith("yosys-"):
release = yosys_ver
todo_include_todos = False
else: else:
release = rtds_version release = rtds_version
todo_include_todos = True
else: else:
release = yosys_ver release = yosys_ver
todo_include_todos = True
# assign figure numbers # assign figure numbers
numfig = True numfig = True
@ -84,10 +93,6 @@ latex_elements = {
''' '''
} }
# include todos during rewrite
extensions.append('sphinx.ext.todo')
todo_include_todos = False
# custom cmd-ref parsing/linking # custom cmd-ref parsing/linking
sys.path += [os.path.dirname(__file__) + "/../"] sys.path += [os.path.dirname(__file__) + "/../"]
extensions.append('util.cmdref') extensions.append('util.cmdref')