Other

Pygments Customization

Locations of pygments source files (locations shown here for 9x; adjust path as needed per version).

pygments file for defining commands and fish:

C:\source\wad9x\common\docproject\extensions\itasca_lexer.py

pygments file defining styles:

C:\source\wad9x\common\python\python_env\python310\Lib\site-packages\pygments\styles\itasca.py

Configuration

conf_more for setting up exclusions, prolog, &etc.:

C:\source\wad9x\common\docproject\extensions\conf_more.py

system hack

See commented lines in:

common\python\python_env\python310\Lib\site-packages\sphinx\environment\__init__.py

This kills the dependency check on a file. Hack performed because the dependency list of most files is wrong, but not clear why. Net result of wrongness is that each doc build tries to re-build 2/3 of the docs – no good!

maybe good idea?

To test a single file, save it as [file].rrt; make a copy of “contents.rst” that is “contents.rrt”, then change “conf.py” value ‘source_suffix’ to be ‘rrt’. This should put you in a place where only the file of interest is sphinxed.