Commit Graph

4096 Commits

Author SHA1 Message Date
Takeshi KOMIYA
3805e0646f
Merge pull request #10251 from jbms/fix-inline-syntax-highlight
Make code role highlighting consistent with code-block directive
2022-05-06 02:54:42 +09:00
Takeshi KOMIYA
4a496bfc98
Merge pull request #10178 from stephenfin/issue-10177
Revert "Close #9993: std domain: Allow to refer an inline target via ref role"
2022-03-27 23:10:52 +09:00
Takeshi KOMIYA
b20e04968e
Merge pull request #10107 from Jean-Abou-Samra/intl-warnings
Implement #noqa for i18n
2022-03-27 23:00:57 +09:00
Takeshi KOMIYA
c6230dc4db extlinks: Disable hardcoded links detector by default (refs: #10126)
The hardcoded links detector added since 4.4.0 causes troubles in many
projects.  Therefore, this disables it by default, and adds a new
configuration `extlinks_detect_hardcoded_links` to enable it explicitly.
2022-03-27 15:22:11 +09:00
Hugo van Kemenade
658689433e Include trailing / in PEP URL to avoid 301 redirect 2022-03-24 13:31:17 +02:00
Jeremy Maitin-Shepard
099b54cb87 Make code role highlighting consistent with code-block directive
Fixes https://github.com/sphinx-doc/sphinx/issues/5157

This is factored out of the sphinx-immaterial theme:
1ef121a612/sphinx_immaterial/inlinesyntaxhighlight.py (L1)

See also:
https://github.com/sphinx-doc/sphinx/pull/6916
2022-03-19 20:37:49 -07:00
Takeshi KOMIYA
168adb0f0e test: Fix test_markup does not use default settings for docutils 2022-03-19 22:58:27 +09:00
Takeshi KOMIYA
017ef6118b Merge branch '4.4.x' into 4.x 2022-03-19 22:56:54 +09:00
Takeshi KOMIYA
2f85b1a402 test: empty tuple type is now repesented w/o args since py3.11
refs: 15df8f8d89
2022-03-19 17:10:13 +09:00
Michal Čihař
ef79a2bc70 environment: Update default value for pep_base_url
This matches docutils change in https://sourceforge.net/p/docutils/code/9045/

Fixes #10253
2022-03-16 13:57:51 +01:00
Takeshi KOMIYA
b12b39db05
Merge pull request #10212 from AA-Turner/remove-module-docstring-titles
Remove module docstring titles
2022-03-14 02:14:17 +09:00
Jakob Lykke Andersen
9362df53be C++, minor formatting 2022-03-12 20:05:26 +01:00
Jeremy Maitin-Shepard
a9a5cec681
Update tests/test_domain_cpp.py
Co-authored-by: Jakob Lykke Andersen <jakobandersen@users.noreply.github.com>
2022-03-11 05:03:05 -08:00
Jeremy Maitin-Shepard
2c1e4c437e
Update tests/test_domain_cpp.py
Co-authored-by: Jakob Lykke Andersen <jakobandersen@users.noreply.github.com>
2022-03-11 05:02:59 -08:00
Jeremy Maitin-Shepard
ce82f9ee9c
Update tests/test_domain_cpp.py
Co-authored-by: Jakob Lykke Andersen <jakobandersen@users.noreply.github.com>
2022-03-11 05:02:54 -08:00
Jeremy Maitin-Shepard
670e8b149f [C++] Support attributes on class and union and improve formatting 2022-03-10 22:03:42 -08:00
Adam Turner
f05a068be9 Fix whitespace 2022-03-07 15:17:45 +00:00
Takeshi KOMIYA
37e8967f3f Merge branch '4.4.x' into 4.x 2022-03-03 02:24:53 +09:00
Takeshi KOMIYA
12104fe5de test: Follow the new behavior of typing.get_type_hints() since py311
Since python-3.11, `typing.get_type_hints()` will not add Optional[t] to
type annotations even if a default value for function argument is None.

refs: https://github.com/python/cpython/pull/30304 (bpo-46195)
2022-03-03 01:34:21 +09:00
Adam Turner
5775912455 Collapse single line docstrings 2022-02-20 03:13:45 +00:00
Adam Turner
6bb7b891a1 Remove copyright and licence fields 2022-02-20 03:06:23 +00:00
Adam Turner
b691ebcc3e Conform to PEP 257 summary line conventions 2022-02-20 02:57:02 +00:00
Adam Turner
5694e0ce60 Fix module docstring indentation 2022-02-20 00:35:13 +00:00
Adam Turner
4f5a3269a6 Fix module docstring first line 2022-02-20 00:11:08 +00:00
Adam Turner
6b8bccec59 Remove module titles in docstrings 2022-02-19 23:17:29 +00:00
Jean Abou Samra
94d78d8747 Close #3985: Implement #noqa for i18n
When cross-references in the original paragraph and the translated
paragraph do not match, a warning is emitted.  It is useful, because
it allows to catch mistakes, but it can also be an annoyance since
sometimes it is expected that the cross-references will not match.
For example, a reference that is repeated in the original text may
need to be factored out for good style in the target language.
Another example: if the translator needs to translate a universally
understood term in the source language into a term that not everyone
knows is the translation of this original term, adding a reference to
the glossary can be warranted.  This allows the translated message to
start with '#noqa' in order to disable the warning.
2022-02-15 19:51:06 +01:00
Takeshi KOMIYA
01d06f9ffe Fix #10175: LaTeX: named footnote ref is linked to an incorrect footnote
A named footnote reference will be converted to a hyperlink to an
incorrect footnote if the name is also used in the different document.
2022-02-13 20:20:42 +09:00
Takeshi KOMIYA
6f0a8f3516
Merge pull request #10189 from tk0miya/https_pep_role
The latest docutils converts :pep: role to the "https" URL (again)
2022-02-13 19:34:39 +09:00
Takeshi KOMIYA
9d29adb76c The latest docutils converts :pep: role to the "https" URL (again)
docutils-0.19 (unreleased) generates "https" URL from :pep: role.
2022-02-13 19:22:17 +09:00
Takeshi KOMIYA
9ea2b768b0
Merge pull request #10185 from tk0miya/10181_napoleon_use_ivar_corrupted
Fix #10181: napoleon_use_ivar adds unexpected prefix to vars
2022-02-13 18:46:14 +09:00
Takeshi KOMIYA
b07ca9dbcc
Merge pull request #10170 from tk0miya/https_pep_role
The latest docutils converts :pep: role to the "https" URL
2022-02-13 18:44:55 +09:00
Takeshi KOMIYA
8224f6f44a Fix #10181: napoleon_use_ivar adds unexpected prefix to vars
Since 4.0, :ivar: items has not been rendered as hyperlinks.  So any
modules, classes and tilda are now harmful.  This removes the prefixing
filter for napoleon_use_ivar option.

refs: #5129 and #5977
2022-02-12 00:50:56 +09:00
Takeshi KOMIYA
777b1fa105 Merge branch '4.x' into 9529_named_footnotes_in_latex 2022-02-11 13:08:26 +09:00
Takeshi KOMIYA
b6931acac6
Merge pull request #10168 from tk0miya/9529_testcase_for_named_footnote
test: Add testcase for named footnotes
2022-02-11 13:06:01 +09:00
Stephen Finucane
105c583f06 Revert "Close #9993: std domain: Allow to refer an inline target via ref role"
This reverts commit e3ee8b378a. This is a
breaking change that should not have been introduced in a minor release
(or arguably at all, given the impact).

Signed-off-by: Stephen Finucane <stephen@that.guru>
Closes: #10177
2022-02-08 16:00:01 +00:00
Takeshi KOMIYA
083b0b5207 The latest docutils converts :pep: role to the "https" URL
docutils-0.19 (unreleased) generates "https" URL from :pep: role.
2022-02-06 23:10:25 +09:00
Takeshi KOMIYA
680417a10d
Merge pull request #10150 from tk0miya/10146_autodoc_default_options_should_support_no-value
Close #10146: autodoc: autodoc_default_options does not support `no-value` option
2022-02-06 15:59:24 +09:00
Takeshi KOMIYA
1546b21f89 Fix #9529: LaTeX: named footnotes are converted to "?"
Named auto numbered footnote (ex. ``[#named]``) that is referred
multiple times was rendered to a question mark.

This calls `\sphinxstepexplicit` for every footnote node that is
referred multiple times.
2022-02-06 15:59:01 +09:00
Takeshi KOMIYA
9b142f15e6 test: Add testcase for named footnotes 2022-02-06 14:33:29 +09:00
Takeshi KOMIYA
8c1671bd35
Merge pull request #10094 from tk0miya/9777_new_html_structure_of_du18
test: Follow the new HTML structure of docutils-0.18
2022-02-05 21:25:03 +09:00
Takeshi KOMIYA
b0b51cecc2 Close #10146: autodoc: autodoc_default_options does not support no-value option 2022-01-31 01:51:37 +09:00
Takeshi KOMIYA
c75e43a321
Merge pull request #10136 from tk0miya/10133_autodoc_mocked_module
Fix #10133: autodoc: Crashed when mocked module is used for type annotation
2022-01-30 23:35:54 +09:00
Takeshi KOMIYA
444e27865d Fix #10133: autodoc: Crashed when mocked module is used for type annotation 2022-01-30 23:19:55 +09:00
Takeshi KOMIYA
d8a398bbdd Close #10125: extlinks: Improve suggestion message for a reference having title 2022-01-23 20:09:47 +09:00
Jakob Lykke Andersen
c11b109d59 intersphinx role: :external+inv:**: instead of :external:inv+**: 2022-01-16 09:48:11 +01:00
Jakob Lykke Andersen
ccc4f95b42 intersphinx role, hax role name to preserve case 2022-01-16 09:48:06 +01:00
Jakob Lykke Andersen
029d0e5b18 intersphinx role: new inventory parsing from role name 2022-01-16 09:48:06 +01:00
Jakob Lykke Andersen
ce5512e3af intersphinx role, implement warning scheme
and temporarily remove explicit inventories
2022-01-16 09:48:06 +01:00
Jakob Lykke Andersen
184fd6a4aa intersphinx role, update based on merged refactoring 2022-01-16 09:48:06 +01:00
Jakob Lykke Andersen
36c6eafdf1 intersphinx: explicitly parse out inventory specification 2022-01-16 09:48:06 +01:00