* Typo in recommended pinning
The paragraph above recommends "less than the next major version". But the example says `<=`. Make them match
* Update development.rst
* Add a call to add_js_files since it doesn't happen when loading extension from theme https://github.com/sphinx-contrib/jquery/issues/23
* Avoid importing from sphinxcontrib.jquery in __init__
* Add reference to issue
* Drop development version header from changelog
This makes just as much sense as a point release header, and won't
require any special attention when we're cutting a release.
* Bump release 1.2.0
* Update package lock
* Sphinx 6: Use logo_url instead of logo
* Handle removal of favicon template context + refactor display of logo and link so it's easier to see what belongs to <4.0 and what is >=4.0
* Adds a favicon to the demo
* Import condensed version logic @agjohnson
* Update sphinx_rtd_theme/layout.html
Co-authored-by: Anthony <aj@ohess.org>
Co-authored-by: Anthony <aj@ohess.org>
* 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 changelog entry for docutils 0.18 support
* Update docs/changelog.rst
Co-authored-by: Anthony <aj@ohess.org>
Co-authored-by: Anthony <aj@ohess.org>
* 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
* Docs: Clean up several broken cross-references
* Adds a section about upgrading the theme and add navigation structure to installation guide
* Add a reference from Changelog to "How to upgrade"
* Also don't import sphinx_rtd_theme in the theme's own docs/conf.py
* Remove trailing linebreaks
* Update docs/installing.rst
Co-authored-by: Anthony <aj@ohess.org>
* Apply suggestions from code review
Co-authored-by: Anthony <aj@ohess.org>
* Update docs/installing.rst
* Replace guidance with reference to Reproducible Builds
* Build link into sentence
* Update the tip about using build logs and the need to pin the theme for older projects
* Remove tip box for Read the Docs users re: @agjohnson's request
Co-authored-by: Anthony <aj@ohess.org>
* 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>
* Update __init__.py because it wasn't updated by previous bump2version
* Add some comments about docker mechanisms that are disturbing release workflow
* Bump to version 1.1.0b3
* Revert "Bump to 1.1.0b2, rebuild assets"
This reverts commit 615eb528cc.
* Add changelog entry for #1073
* Changelog entry for #1193
* Bump to 1.1.0 using bump2version
* Use PEP440 and make it a beta, i.e. "1.1.0b1"
* Auto-generated package-lock.json but with version bumps
* Bump to 1.1.0b2, rebuild assets
* Revert "Update layout.html to support a sphinx version that is not three-integers (#1345)"
This reverts commit 45cf21874f.
* Always slice list before unpacking so number of elements is expected range
`map` filter returns a generator that needs to run through the `list` filter before slicing
* Let's keep it a 3-tuple but always set 3rd component to -1 -- in case a project was unpacking 3 values
* 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
* Update layout.html to support a sphinx version that is not three-integers. Useful for sphinx==5.2.0.post0
* Apply suggestions from code review
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* No reason to only have the first three elements from the sphinx version
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Benjamin Balder Bach <benjamin@overtag.dk>
* Remove font-smoothing
This is a non standard css feature and is not supported on many platforms. And has been removed from the css standard specification.
It is advized to not use it according to MDN along with many other guides on the internet.
* rebuild theme.css and badge_only.css for https://github.com/readthedocs/sphinx_rtd_theme/pull/1094
Co-authored-by: Benjamin Bach <benjamin@overtag.dk>
* 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
* Fix#1078: Citation not styled properly
Turns out our demo docs werent being rendered by sphinx as citations so this may have slipped though the sphinx 2 fixes.
I updated the demo docs and included the need style fixes.
* Group citations and footnotes
* Build Assets
* Build theme.css with "Fix #1078: Citation not styled properly #1080"
Co-authored-by: Benjamin Bach <benjamin@overtag.dk>
