* 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>
* 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 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>
* Update Breadcrumb Styles
- Fixes extra padding to the left/right
- Used slash instead of >>
- Make literalls match other link style
- Adds demo docs for testing
* Update comment
* Update src/sass/_theme_breadcrumbs.sass
Co-authored-by: Ana Costa <anacosta.xl@gmail.com>
* Build theme.css for https://github.com/readthedocs/sphinx_rtd_theme/pull/1073
* Build theme.css for https://github.com/readthedocs/sphinx_rtd_theme/pull/1073
Co-authored-by: Benjamin Bach <benjamin@overtag.dk>
Co-authored-by: Ana Costa <anacosta.xl@gmail.com>
* 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>
* Fix definition lists inside api docs
This is similar to #1080 (and is needed to fix citations in the demo here)
Fixes#1052
* Build Assets
* Build Assets 2
* New build of theme.css and theme.js
* Regenerate theme.css for https://github.com/readthedocs/sphinx_rtd_theme/pull/1084
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>
This matches the version number in the Python package, and allows
bumpversion to continue working. We can revisit changing this version
later, but currently this version will never be updated again, as
bumpversion will not match this string anymore.
Fixes#1326
