| 95216c61 | 06-Apr-2022 |
Patrick Sanan <patrick.sanan@gmail.com> |
Docs: add manual page redirects
For the dirhtml docs buld, add a script to add HTML files for all previous man page locations, e.g.
docs/manualpages/Foo/Bar.html
linking to the new dirhtml loca
Docs: add manual page redirects
For the dirhtml docs buld, add a script to add HTML files for all previous man page locations, e.g.
docs/manualpages/Foo/Bar.html
linking to the new dirhtml locations, e.g
docs/manualpages/Foo/Bar/index.html
show more ...
|
| b8a29d3a | 22-Mar-2022 |
Patrick Sanan <patrick.sanan@gmail.com> |
Docs: refactor classic docs build into pre and post to allow proper mapping
The URLs required to link to the new, integrated manual pages now depend on the Sphinx builder (dirhtml or html), as in th
Docs: refactor classic docs build into pre and post to allow proper mapping
The URLs required to link to the new, integrated manual pages now depend on the Sphinx builder (dirhtml or html), as in the new htmlmap_modified. To allow this same mapping file to be used with C2HTML when the HTML source pages are built (with the classic process), refactor to delay this stage until after the main Sphinx build and to use htmlmap_modified.
show more ...
|
| 5becb6a3 | 17-Mar-2022 |
Patrick Sanan <patrick.sanan@gmail.com> |
Docs: update htmlmap links in place, based on builder type
Generate an htmlmap_modified file (in the classic docs tree) with modified manpage links based on the location of generated HTML files from
Docs: update htmlmap links in place, based on builder type
Generate an htmlmap_modified file (in the classic docs tree) with modified manpage links based on the location of generated HTML files from the Sphinx html or dirhtml builder.
show more ...
|
| 589e537f | 15-Mar-2022 |
Patrick Sanan <patrick.sanan@gmail.com> |
Docs: Generate MyST (.md) files instead of .html for man pages
Use a new version of Sowing doctext that accepts the -myst flag.
We use a mostly-duplicated local myst.def here.
Split the copying of
Docs: Generate MyST (.md) files instead of .html for man pages
Use a new version of Sowing doctext that accepts the -myst flag.
We use a mostly-duplicated local myst.def here.
Split the copying of the classic docs into a "pre" and "post" stage, now accepting a destination argument, so that .md manualpage files may be copied at the start of the Sphinx build.
Change -html to -myst in the manualpages target.
Remove the manualpages_buildcite target entirely, as we remove the -mapref argument from the manualpages target. Now the .cit file is generated during a single run of doctext and converted to htmlmap, which is used to create man pages links with the custom Sphinx extension.
Remove the add_version_header.py script, which leaves a few classic HTML pages without a version, but this feature was mainly for the man pages, which now have the same version information at the bottom as all the Sphinx-generated pages.
This commit does not address further required changes: - index.html pages auto-generated in the docs/manualpages/ tree have not been converted to .md - Man page postprocessing stages have not been updated to operate on .md instead of .html and will thus fail
show more ...
|
| 8f2bcf5f | 12-Mar-2022 |
Patrick Sanan <patrick.sanan@gmail.com> |
Docs: add MyST (Markdown) parser extension
Ignore the images directory, as it does not contain Sphinx source files, and README.md images there are otherwise interpreted as such. |