summaryrefslogtreecommitdiff
path: root/sphinx/builders/html
Commit message (Collapse)AuthorAgeFilesLines
* html builder: Append CRC32 checksum to asset URIs (#11415)Adam Turner2023-05-111-8/+33
|
* Remove HTML 4 support (#11385)Adam Turner2023-04-281-13/+9
|
* Remove ``HTMLTranslator`` and ``html5_ready`` from ``sphinx.builders.html`` ↵Adam Turner2023-04-281-18/+0
| | | | (#11383)
* Remove deprecated ``style`` key for HTML templates (#11381)Adam Turner2023-04-281-1/+0
|
* Partially revert "Disable localisation when SOURCE_DATE_EPOCH is set ↵Adam Turner2023-04-211-1/+1
| | | | | (#10949)" (#11343) This keeps some of the added tests, and avoids a full revert of ``sphinx.locale``.
* Disable localisation when ``SOURCE_DATE_EPOCH`` is set (#10949)James Addison2023-04-071-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This commit disables Sphinx's localisation features when reproducible builds are requested, as determined by a non-empty SOURCE_DATE_EPOCH_ environment variable. The `Reproducible Builds`_ project aims to provide confidence to consumers of packaged software that the artefacts they're downloading and installing have not been altered by the environment they were built in, and can be replicated at a later date if required. Builds of localised documentation using Sphinx currently account for a large category of reproducible build testing failures, because the builders intentionally use varying environment locales at build-time. This can affect the contents of the ``objects.inv`` file. During investigation, it turned out that many ``gettext``-localised values (particularly in Python modules under ``sphinx.domains``) were being translated at module-load-time and would not subsequently be re-localised. This creates two unusual effects: 1. Attempting to write a test case to build the same application in two different languages was not initially possible, as the first-loaded translation catalogue (as found in the ``sphinx.locale.translators`` global variable) would remain in-use for subsequent application builds under different locales. 2. Localisation of strings could vary depending on whether the relevant modules were loaded before or after the resource catalogues were populated. We fix this by performing all translations lazily so that module imports can occur in any order and localisation of inventory entries should occur only when translations of those items are requested. Localisation can then be disabled by configuring the ``gettext`` language to the ISO-639-3 'undetermined' code (``'und'``), as this should not have an associated translation catalogue. We also want to prevent ``gettext`` from attempting to determine the host's locale from environment variables (including ``LANGUAGE``). .. _SOURCE_DATE_EPOCH: https://reproducible-builds.org/docs/source-date-epoch/ .. _Reproducible Builds: https://www.reproducible-builds.org/
* Add missing quotes in html 4 deprecation textRafael Fontenelle2023-03-211-1/+1
|
* Remove useless compatability importsAdam Turner2023-03-171-7/+0
| | | | | | This exposed names at ``sphinx.builders.html.sphinxcontrib.serializinghtml``, etc, which offers no benefit. This was originally broken in commit 9dfbfbf16b9873de3ff94984e40b5bc41e28005e, four years ago.
* Resolve ``flake8-return`` errorsAdam Turner2023-02-181-1/+1
|
* Unescape quotation marks where possibleAdam Turner2023-02-181-1/+1
|
* Fix COM812Adam Turner2023-02-181-6/+6
|
* Restore correct parallel search index building (#11192)Jeremy Maitin-Shepard2023-02-151-4/+3
| | | | | | | | | | | | Revert b32841e153431ec02de31e9ec32e79ab3ac7d1c2 to fix parallel search index building The image-related changes were already reverted in 2a7c40d07f4b0e0fd2a4bc942e74634c2df24dee, but the search index changes also need to be reverted. It would be nice to support parallel search index building, but the necessary support for merging the search indices produced by each process needs to be added first.
* Resolve Ruff SIM114 violationsAdam Turner2023-02-151-4/+4
|
* Merge branch '6.1.x'Adam Turner2023-01-101-10/+9
|\ | | | | | | | | | | # Conflicts: # CHANGES # sphinx/__init__.py
| * Undo parallel image changesAdam Turner2023-01-101-10/+9
| |
* | Replace deprecation tooling with module level ``__getattr__`` (#11054)Adam Turner2023-01-081-11/+18
|/
* Fix copying images under parallel execution (#11100)Adam Turner2023-01-071-4/+7
|
* Move console output utilities to ``sphinx.util.display``Adam Turner2023-01-031-1/+2
| | | | | - Merge `old_status_iterator` into ``status_iterator``. ``old_status_iterator`` was deprecated in version 1.6.
* Move tasks into parallel writingAdam Turner2023-01-021-9/+8
|
* Address SIM103 lints (#11052)danieleades2023-01-021-4/+1
| | | Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* Run pyupgrade (#11070)Adam Turner2023-01-021-9/+9
|
* Use PEP 604 typesAdam Turner2023-01-011-4/+4
|
* Use PEP 595 typesAdam Turner2023-01-012-29/+29
|
* Insert ``from __future__ import annotations``Adam Turner2023-01-012-0/+4
|
* Factor out HTML 4 translator (#11051)Adam Turner2022-12-301-3/+8
| | | Move the HTML 4 translator into a private module.
* Fix lookup table for multi-word key names (``kbd`` role) (#10962)textshell2022-12-301-4/+4
| | | | | It seems the original PR adding multi word key support forgot to add commas and python helpfully just concatenated the strings instead of building the required tuples.
* Adopt the Ruff code linting toolAdam Turner2022-12-291-1/+1
| | | | https://github.com/charliermarsh/ruff
* remove blanket 'noqas'Daniel Eades2022-12-161-6/+10
|
* Revert ``html_codeblock_linenos_style`` removal (#10922)Adam Turner2022-10-161-1/+3
|
* Merge branch '5.x'Adam Turner2022-09-251-1/+12
|\ | | | | | | | | | | | | | | | | | | # Conflicts: # CHANGES # doc/conf.py # sphinx/__init__.py # sphinx/builders/html/__init__.py # sphinx/domains/python.py # tests/test_build_html.py
| * Split out `sphinx_highlight.js`Adam Turner2022-09-241-0/+1
| |
| * Deprecate HTML 4 support (#10843)Adam Turner2022-09-231-1/+12
| |
* | Merge branch '5.x'Adam Turner2022-09-091-1/+1
|\ \ | |/ | | | | | | | | | | | | | | # Conflicts: # setup.py # sphinx/application.py # sphinx/environment/__init__.py # sphinx/ext/autodoc/directive.py # tests/test_build_html.py
| * Fix some static typing errors (#10745)danieleades2022-08-141-1/+1
| |
* | Merge branch '5.x'Jean-François B2022-08-061-1/+1
|\ \ | |/
| * set up mypy for incremental adoption of 'strict optional'daniel.eades2022-07-261-1/+1
| |
* | Merge branch '5.x'Adam Turner2022-07-241-3/+2
|\ \ | |/ | | | | | | | | # Conflicts: # CHANGES # sphinx/__init__.py
| * Update include_patterns implementation (#10680)Adam Turner2022-07-231-3/+2
| |
* | Merge branch '5.x'Adam Turner2022-07-181-1/+1
|\ \ | |/ | | | | | | | | # Conflicts: # sphinx/ext/autodoc/__init__.py # sphinx/writers/html5.py
| * Improve static typing strictness (#10569)danieleades2022-07-181-1/+1
| |
* | Merge branch '5.x'Adam Turner2022-07-171-10/+18
|\ \ | |/
| * Add `include_patterns` as the opposite of `exclude_patterns` (#10518)Adam Turner2022-07-171-2/+3
| |
| * Allow specifying multiple CSS files in themes (#10465)Takeshi KOMIYA2022-07-171-8/+15
| | | | | | Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
* | Merge branch '5.x'Takeshi KOMIYA2022-07-031-2/+5
|\ \ | |/
| * Use `get_settings()` from Docutils 0.19 (#10624)Adam Turner2022-07-021-2/+5
| |
* | Remove more deprecated items in Sphinx 6.0 (#10562)Adam Turner2022-06-261-12/+8
| |
* | Merge branch '5.x'Adam Turner2022-06-161-3/+15
|\ \ | |/ | | | | | | | | | | # Conflicts: # .github/workflows/builddoc.yml # .github/workflows/lint.yml # sphinx/registry.py
| * Increase static typing strictness (#10530)Adam Turner2022-06-161-3/+15
| |
* | Remove deprecated items for Sphinx 6.0 (#10471)Adam Turner2022-06-161-36/+1
|/
* Merge branch '5.0.x' into 5.xTakeshi KOMIYA2022-06-171-0/+1
|\
View Lorry Controller Status