* Run tests and build docs with Sphinx 8.2
* CircleCI job
* Update Read the Docs dependencies
* Update matrix
* Run tests with 3.13
* Use 8.x to build our docs
* Tests: `sphinxdev` tox environment installs Sphinx from `master`
It seems we had a bug in the name and it wasn't installing Sphinx from `master`.
I expect this test to fail now because we pin `Sphinx<8`, but that's fine for now.
* Prepare for 3.0 release
- Drop Python <3.8
- Drop docutils <=0.18
- Add support for docutils 0.21
- Add support for Python 3.12
This follows the plan we wrote in
https://sphinx-rtd-theme.readthedocs.io/en/stable/development.html#roadmap-release-3-0-0
The main idea here is to move forward with newer versions and drop support for
old stuffs so we reduce the maintanence burden.
* Update CircleCI matrix
* More fixes to CircleCI
* Run test over Sphinx 8.0
* Update contributing guide
* Remove deprecated `readthedocs-sphinx-ext`
* Remove old Sphinx versions
* Uninstall our extension
* Show a warning if `extra_css_files` is in the `html_context`
See https://github.com/readthedocs/sphinx_rtd_theme/pull/450
* Update development page
* Add deprecate warning for `analytics_` theme options
* Update docs
* Remove unused dependency
Closes#1533
* Remove environment variables from our docs
This was already added in a more generic way to the theme itself.
* Require Sphinx >=6.0
* Deprecation warning about `get_html_theme_path`
See https://github.com/readthedocs/sphinx_rtd_theme/pull/1479#issuecomment-2296317034
* 2.0 milestone: drop supported versions
The new policy is:
- Python >=3.6
- Sphinx >= 5
- HTML4 and HTML5 writer
- docutils >= 0.14, < 0.19
* Update roadmap after discussion
By the beginning of 2024 we should support newer Sphinx versions and HTML5 only.
* Remove Python 2.7 from CircleCI
* Run only supported versions on Python 3.11
* Update with feedback from review
* Update documentation to match our support
* Add Sphinx 6.2 that was missing
* Update tox/circleci to work
* Revert tox command
* Drop support for HTML4 and keep `-qa` testing
- drop support for HTML4 on 2.0
- keep `-qa` TOX environment to be able to compare feature branches
- emit `logger.errors` on Python 2 and html_writer4=True
- require Sphinx >= 5.0
- remove logic for old Sphinx versions
* Update Tox and CircleCI
* Update contributing page to match our plans
---------
Co-authored-by: Anthony Johnson <aj@ohess.org>
* Remove version logic on sphinxcontrib-jquery, require >=4,<5
* Bump to Sphinx 6.1.x
* Remove testing for Sphinx 1.7, sphinxcontrib-jquery 4.x blocks it
* support Python 3.11 with Sphinx 5.3+
* Update tox.ini
Co-authored-by: Michael R. Crusoe <1330696+mr-c@users.noreply.github.com>
Co-authored-by: Benjamin Balder Bach <benjamin@overtag.dk>
Co-authored-by: Benjamin Balder Bach <benjaoming@gmail.com>
* Allow Sphinx version 6 and add dependency for sphinxcontrib-jquery
* Adds Sphinx 6.0b2 to Tox test matrix
* Adds Sphinx 6 to relevant Circle CI pipelines
* Build docs with Sphinx 6.0b2
* Use stable Sphinx 6.0.0
* Add docutils 0.18 citation/footnote support using CSS grid
This is a fix for #1322 that continues our pattern for HTML5 support
using CSS grids, introduced for support for docutils < 0.17 HTML5
support.
* Add lots of backreferences to a footnote
* Drop brackets from footnote/citation links
The brackets seem to be another docutils addition.
* Tune grid display for Sphinx 4 and 5
Backrefs have a new styling that drops a lot of punctuation
* Bump dependency on docutils to < 0.19
* Small tweak to footnote backrefs row span
We don't want to use too large a value here, as some browsers might make
explicit rows for us. We can't target -1 because the row count is
implicit.
* Revert some new styling and use nonbreaking backrefs for now
* Downgrade tox
* Use before pseudo class to break up backrefs consistently
* Do not overflow object cross references
* Rebuild theme for https://github.com/readthedocs/sphinx_rtd_theme/pull/1369
* Adds a demo for the regression
* Mock sphinx-automodapi for now, but we can use it soon
* we can replace sphinx-automodapi demo entirely with autosummary since it uses this under the hood
* We need a python 2.7 compliant test module. Add a short-term workaround until this is removed in 2.0.
* Add comment about the terrible tox workaround
* Use a less hacky way of conditional autosummary in demo API docs
- Use `only` directive for conditional reST instead
- Drops 1.6 from our text matrix, it was deprecated in 1.0 release.
There were issues with the conditional directive only on 1.6 for some
reason.
Co-authored-by: Benjamin Bach <benjamin@overtag.dk>
Co-authored-by: Anthony Johnson <aj@ohess.org>
* Refines tox matrix, adds a new target "sphinxdev" that can test the latest upstream development branch
* Adds missing tox environments in circle ci config
* Remove odd undefined py2 and py3 tox environments
* Add Python 3.10 support
* Add new Sphinx versions to tox test matrix, but do not allow docutils >= 0.17 on Sphinx>=4.3
* Stop py2 and py27 support from sphinxlatest because of build breakage
* Circle CI: Repeat sphinx versions for Python 2.7 (pending adjustments)
* tox.ini config: Ensure that we are getting the expected Sphinx version
* Set sphinx versions for Python 3.10
* Add new Sphinx versions to tox test matrix, but do not allow docutils >= 0.17 on Sphinx>=4.3
* Stop py2 and py27 support from sphinxlatest because of build breakage
* Circle CI: Repeat sphinx versions for Python 2.7 (pending adjustments)
* tox.ini config: Ensure that we are getting the expected Sphinx version
Many of our PRs have out of date assets, making it hard to test the
latest changes. This will at least throw an error on the PR when build
assets aren't updated.
Many of our PRs have out of date assets, making it hard to test the
latest changes. This will at least throw an error on the PR when build
assets aren't updated.
Sphinx 4.x moves javascript and css declarations to `script_files` and `css_files`. This patch fixes duplicatd link and script tags when using sphinx4
Sphinx 4.x changes the default setting of html_codeblock_linenos_style to 'inline' and deprecates `html_codeblock_linenos_style`. The css for `.hll` to make the hightling span the full line cause the line number and code to be split on seperate lines. I could not get the highlight to span the full line so it was removed completely. I also made line numbers not selectible by the user.
This changes also adds the needed changes to the tox testing enviorment alhough, sphinx4 is not officially released to pypi yet. You will need to test these changes locally using: `pip install git+https://github.com/sphinx-doc/sphinx@master`
