7 Commits

Author SHA1 Message Date
Chris Johns
e31a0b22fe sphinx/style: Fix building with the latest sphinx
Tested on sphinx 7.2, 6.1.3 AND 5.3.0

Closes #4980
2023-12-20 08:05:52 +11:00
Joel Sherrill
13237ab34b layout.html: Revert patch forcing Spinx to >= 6.0
Unfortunately, updating past Sphinx 5.x results in unordered bullet
lists not formatting correctly as show in a screen capture attached
to #4928. Revert this patch until the issue is resolved and output
is reviewed for other potential issues.

    From: Utkarsh Verma <utkarsh@bitbanged.com>
    Date: Wed, 14 Jun 2023 05:36:26 +0000
    Subject: [PATCH] eng: Fix builds for newer Sphinx versions (>=7)

    The current Sphinx theme depends on the `style` parameter which got
    deprecated in v5.1 and finally got removed in v7. Now, the `styles` key
    should be preferred which is a list of stylesheets. This commit
    implements this change.

Updates #4915.
Updates #4928.
2023-07-25 15:20:12 -05:00
Utkarsh Verma
4c87f9b594 eng: Fix builds for newer Sphinx versions (>=7)
The current Sphinx theme depends on the `style` parameter which got
deprecated in v5.1 and finally got removed in v7. Now, the `styles` key
should be preferred which is a list of stylesheets. This commit
implements this change.

Closes #4915
2023-06-14 15:45:56 +10:00
Amar Takhar
9845183527 Update sphinx_rtd_theme to https://github.com/readthedocs/sphinx_rtd_theme/
68a19ca / 0.4.3.dev0. I have been using this one for a while without
issues.

This should fix the search issues.

closes #3880
2020-02-26 00:09:17 -05:00
Chris Johns
5ce8e43506 build: Fix indexing so it works on HTML and PDF.
- Remove all genindex.rst files, these are generated and should not
  exist in our source.
- Fix the HTML templates so the local specialisation works.
- Add a index link to the sidebar for HTML.

Note, there is no TOC entry for the index in the PDF output and I
cannot figure out how to add one.

Closes #3503
2018-08-21 13:47:40 +10:00
Chris Johns
c18d76ae55 Add my-style.css support and add RTEMS to that CSS. 2016-05-02 20:51:25 -04:00
Amar Takhar
a316b1ff6d Add support for singlehtml (inlined) HTML file, plus some other fixes.
* This is still broken.
  * Rename sphinx_rtd_theme so it doesn't pickup locally installed ones
  * Add a hack to theme.css to get around inliner bug.
  * Some unrelated fixups in common/waf.py

Unfortunatly several dozen fixes got merged into this.
2016-05-02 20:51:25 -04:00