Commit Graph

20229 Commits

Author SHA1 Message Date
James Addison
ecc8613fc4
Use microsecond-resolution timestamps for outdated file detection (#11435)
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2023-07-20 20:06:53 +01:00
chrysle
d6f10904a3
Document `--no-color and --color options to sphinx-build` (#11443) 2023-07-20 18:19:14 +01:00
Henry Schreiner
cc78e2a8d8
Provide timezone information in `datetime.fromtimestamp` (#11468)
Python 3.12 has deprecated ``datetime.utcfromtimestamp``.
Resolve the warning by working out ``tzdelta`` via explicit timezone calculations.

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2023-07-20 18:14:18 +01:00
picnixz
037b6194d1
Use RFC 8081 font file MIME types in the EPUB builder (#11486)
The "font" top-level media type was formalised via :rfc:`8081` in 2017.
Standard MIME types for OTF and TTF fonts have been
`registered with IANA`_ as ``font/otf`` and ``font/ttf``.
These are also listed in the EPUB 3 `core media types`_ specification.

Sphinx-generated EPUB documents including custom OTF or TTF fonts
specify a MIME type for those fonts in ``content.opf`` of
``application/x-font-otf`` or ``application/x-font-ttf`` respectively.

The ``epubcheck`` application presents informational warnings that
these MIME types are non-standard when checking such a generated
EPUB document.
Adding the correct MIME type will prevent those messages
and will also result in a valid EPUB.

.. _core media types: https://www.w3.org/TR/epub/#sec-core-media-types
.. _registered with IANA: https://www.iana.org/assignments/media-types/media-types.xhtml#font
2023-07-20 18:07:43 +01:00
Adam Turner
571becb6af Re-instate the footnote-reference class 2023-07-14 07:50:12 +01:00
Adam Turner
0858c3b841 Resolve `mypy` warnings 2023-07-14 07:06:46 +01:00
Adam Turner
7c8eda24a1 Resolve `sphinx-lint` warnings 2023-07-14 06:55:18 +01:00
Adam Turner
de3aa8a318 Replace non-functional Bitbucket URLs
- ``sphinx-contrib`` has moved to GitHub
- Replace personal project links with links to the Bitbucket archive
2023-07-14 06:52:25 +01:00
Adam Turner
d3c91f9512 Refactor `status_iterator` 2023-05-15 10:43:55 +01:00
Adam Turner
d8d7fed993 Don't add colours to messagelog
We need to remove colours later for display, so it is pointless to add them.
2023-05-15 10:20:31 +01:00
Adam Turner
00eeea3d9b Simplify `make clean` 2023-05-13 01:17:35 +01:00
danieleades
31759d6b08
Expand the mypy whitelist for 'sphinx.util' (#11406) 2023-05-12 23:51:59 +01:00
danieleades
1c5158e010
Remove 'sphinx.ext.duration' from the mypy whitelist (#11404) 2023-05-12 23:50:44 +01:00
danieleades
2c58722627
Remove 'sphinx.util.typing' from mypy whitelist (#11397) 2023-05-12 23:48:07 +01:00
Adam Turner
343e149398 Merge branch '7.0.x'
# Conflicts:
#	CHANGES
#	sphinx/__init__.py
2023-05-12 22:57:09 +01:00
Adam Turner
d48cc783b6 Bump to 7.0.1 final 2023-05-12 22:48:41 +01:00
Willem
de6b18ac7d
Remove remaining references to the setuptools integration (#11418)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2023-05-12 22:46:17 +01:00
Adam Turner
749af9561e Bump version 2023-05-12 13:57:37 +01:00
Jean-François B
53b9b28366 Update CHANGEs 2023-05-12 12:00:22 +02:00
Stefanie Molin
e09d02e440
Allow `copyright` to contain multiple entries (#10983)
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2023-05-11 22:43:48 +01:00
TLouf
86b07d4a97
Allow multi-line object description signatures (#11011)
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
Co-authored-by: Jean-François B <2589111+jfbu@users.noreply.github.com>
Co-authored-by: TLouf <loufthomas@gmail.com>
2023-05-11 14:28:57 +01:00
Adam Turner
c73628dfca Accept a version tuple in `app.require_sphinx()` 2023-05-11 13:50:45 +01:00
Adam Turner
ae206694e6
html builder: Append CRC32 checksum to asset URIs (#11415) 2023-05-11 05:19:31 +01:00
Adam Turner
706f5f9cc8
Warn on deprecated Python-specific index types (#11412) 2023-05-09 22:57:39 +01:00
Adam Turner
db546189ce
Support Docutils 0.20 (#11411) 2023-05-09 21:00:04 +01:00
Adam Turner
8942a1dddf Test with Docutils 0.20 2023-05-09 19:24:18 +01:00
James Addison
c9d0933e5d
linkcheck: Use context managers for HTTP requests (#11318)
This closes HTTP responses when no content reads are required, as
when requests are made in streaming mode, ``requests`` doesn't know
whether the caller may intend to later read content from a streamed
HTTP response object and holds the socket open.

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2023-05-09 17:09:35 +01:00
Adam Turner
2b1c106bbf Update documentation workflow
- Add 'workflow_dispatch' target
- Force output to use colour
- Print traceback on error
- Use parallel building
2023-05-09 16:51:52 +01:00
Adam Turner
ba7408209e Change concurrency groups for GitHub workflows
This means that 'push' triggered workflows are not cancelled.
2023-04-29 22:44:55 +01:00
Adam Turner
b546879539 Bump version 2023-04-29 22:26:43 +01:00
Adam Turner
d568b2f4f7 Bump to 7.0.0 final 2023-04-29 22:25:57 +01:00
Adam Turner
ff79edf353 Remove `jsdump` references post removal 2023-04-28 22:50:01 +01:00
Adam Turner
1a5133ac39 Bump to 7.0.0rc1 final 2023-04-28 12:30:48 +01:00
Adam Turner
5795fc7f9f
Update `sphinx.deprecation` for Sphinx 7.0 (#11386) 2023-04-28 12:10:13 +01:00
Adam Turner
6202087f91 Add a note to CHANGES for PR 11385 2023-04-28 12:04:41 +01:00
Adam Turner
ad473730a3
Remove HTML 4 support (#11385) 2023-04-28 11:32:12 +01:00
Adam Turner
3e3251d3ba
Remove `HTMLTranslator and html5_ready from sphinx.builders.html` (#11383) 2023-04-28 11:01:14 +01:00
Adam Turner
77fd819a09
Remove deprecated `LaTeXTranslator.docclasses` attribute (#11382) 2023-04-28 10:50:57 +01:00
Adam Turner
4be56f3b7d
Remove deprecated `style` key for HTML templates (#11381) 2023-04-28 10:41:59 +01:00
Adam Turner
49027a9ae6
Autosummary: Always emit grouped `ImportError` exceptions (#11380) 2023-04-28 10:32:04 +01:00
Adam Turner
a464c5851d
Make the `env argument to Builder` subclasses required (#11379) 2023-04-28 10:25:57 +01:00
Adam Turner
d22e660347
Remove deprecated `sphinx.util.docutils.is_html5_writer_available()` function (#11378) 2023-04-28 10:14:53 +01:00
Adam Turner
ce606d82cd
Removed deprecated `sphinx.util.get_matching_files()` function (#11373) 2023-04-28 09:55:14 +01:00
Adam Turner
262e1d9857
Remove deprecated `sphinx.io.read_doc()` function (#11372) 2023-04-27 16:01:14 +01:00
Adam Turner
24f476949d
Remove deprecated `sphinx.pycode.ast.parse()` (#11371) 2023-04-27 15:18:44 +01:00
Adam Turner
583fb74bd4
Remove deprecated `sphinx.util.stemmer` module (#11370) 2023-04-27 14:53:51 +01:00
Adam Turner
3c4e78e236
Make `locale required in sphinx.util.i18n.format_date()` (#11366) 2023-04-27 01:30:40 +01:00
Adam Turner
ce5ce1ac2d
Remove support for the `jsdump format in sphinx.search` (#11365) 2023-04-27 01:28:45 +01:00
Adam Turner
973e8fb5cf
Remove the deprecated `sphinx.ext.napoleon.iterators` module (#11364) 2023-04-27 01:27:07 +01:00
Adam Turner
2a9e805206
Remove the deprecated Setuptools integration (#11363) 2023-04-27 01:22:04 +01:00