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
Jean Abou Samra
dfcb5d2f4c
Categorize warnings for inconsistent references in i18n
...
This allows suppressing them using the suppress_warnings configuration
variable.
2022-02-15 14:32:22 +01:00
Takeshi KOMIYA
2be0630951
Merge pull request #10108 from tk0miya/9456_html_show_search_summary
...
Close #9456 : html search: Add a config variable; html_show_search_summary
2022-01-18 02:24:34 +09:00
Takeshi KOMIYA
d44ea70272
Merge pull request #10109 from kianmeng/revert-typo-change
...
Revert typo change
2022-01-18 01:26:06 +09:00
Kian-Meng Ang
6b47019b31
Revert typo change
2022-01-17 03:16:34 +08:00
Takeshi KOMIYA
72bb5c998f
Close #9456 : html search: Add a config variable; html_show_search_summary
...
refs: #9494
2022-01-17 01:44:42 +09:00
Takeshi KOMIYA
bd55cce6e6
Bump version
2022-01-17 00:21:22 +09:00
Takeshi KOMIYA
99947d9b18
Bump version
2022-01-17 00:19:41 +09:00
Takeshi KOMIYA
88f9647a22
Bump to 4.4.0 final
v4.4.0
2022-01-17 00:17:38 +09:00
Takeshi KOMIYA
fc428ad324
Merge pull request #9822 from jakobandersen/intersphinx_role
...
Intersphinx role (2)
2022-01-16 18:10:15 +09:00
Jakob Lykke Andersen
5d595ec0c4
intersphinx role, simplify role_name check
...
Co-authored-by: Takeshi KOMIYA <i.tkomiya@gmail.com >
2022-01-16 09:48:39 +01:00
Jakob Lykke Andersen
6ee0ecbe40
intersphinx role, simplify role name matching
2022-01-16 09:48:29 +01:00
Jakob Lykke Andersen
3bf8bcd6e1
intersphinx role, update docs
2022-01-16 09:48:20 +01:00
Jakob Lykke Andersen
c11b109d59
intersphinx role: :external+inv:**: instead of :external:inv+**:
2022-01-16 09:48:11 +01:00
Jakob Lykke Andersen
9589a2bc05
intersphinx role, remove redundant method
2022-01-16 09:48:06 +01:00
Jakob Lykke Andersen
941db550f0
intersphinx role, fix flake8 warnings
2022-01-16 09:48:06 +01:00
Jakob Lykke Andersen
9a3f2b8542
intersphinx role, CHANGES
2022-01-16 09:48:06 +01:00
Jakob Lykke Andersen
540d76035c
intersphinx role, documentation
2022-01-16 09:48:06 +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
Jakob Lykke Andersen
454a1c599e
intersphinx: remove dual warning from role resolution
2022-01-16 09:48:06 +01:00
Jakob Lykke Andersen
69fa5260fc
intersphinx role: rename to 'external'
2022-01-16 09:47:54 +01:00
Jakob Lykke Andersen
8605644e83
intersphinx: more role testing
2022-01-16 09:47:54 +01:00
Takeshi KOMIYA
35dcc60a7c
intersphinx: Add :intersphinx:***: role
2022-01-16 09:47:53 +01:00
Takeshi KOMIYA
b4227dbe1b
refactor: Add CustomReSTDispatcher as a base class of custom dispatchers
...
To create custom reST dispatcher easily, this adds CustomReSTDispatcher
class as a base class of custom dispatchers.
2022-01-16 09:47:53 +01:00
Takeshi KOMIYA
26a4f5d2b8
Merge pull request #10105 from sphinx-doc/bot/pull-translations
...
Update message catalogs
2022-01-16 14:13:48 +09:00
tk0miya
d1e1d8645f
Update message catalogs
2022-01-16 00:13:04 +00:00
Takeshi KOMIYA
da3981ae30
Update CHANGES for PR #10101
2022-01-16 03:04:01 +09:00
Takeshi KOMIYA
453e0c798e
Merge pull request #10100 from tk0miya/9413_xml_namespace
...
Fix #9413 : xml: Invalid XML was generated when cross referencing python objects
2022-01-16 02:49:01 +09:00
Takeshi KOMIYA
d82d370739
Merge pull request #10078 from danieleades/refactor/unused-loop-control-variables
...
address some unused loop control variables
2022-01-16 02:46:32 +09:00
Takeshi KOMIYA
3b8387f469
Merge pull request #10097 from tk0miya/10029_strip_value_from_cmdoption
...
Fix #9981 : std domain: Strip value part of the option directive from genindex
2022-01-16 02:44:24 +09:00
Takeshi KOMIYA
542db8ffb6
Merge pull request #10101 from Gobot1234/4.x
...
Fix empty returns section
2022-01-16 02:40:58 +09:00
James Hilton-Balfe
ff2105a2f3
Update tests/test_ext_napoleon_docstring.py
2022-01-15 17:31:23 +00:00
Takeshi KOMIYA
76c9b3c605
Fix #9413 : xml: Invalid XML was generated when cross referencing python objects
2022-01-16 02:02:12 +09:00
Takeshi KOMIYA
a55a765e79
Merge pull request #9661 from latosha-maltba/dedent
...
code-block: Fix handling of :dedent: and add unit tests
2022-01-16 02:00:40 +09:00
James Hilton-Balfe
d52adad64e
Fix formatting
2022-01-15 14:04:38 +00:00
James Hilton-Balfe
dc60b1db76
Add a test for this
2022-01-15 13:59:25 +00:00
James Hilton-Balfe
4b8bb7b301
Only add returns section if there is something
2022-01-15 13:43:20 +00:00
Takeshi KOMIYA
ff54f97aba
code-block: Pass list of strings ends with CR code to dedent_lines()
2022-01-15 20:35:21 +09:00
Takeshi KOMIYA
e2f141620d
Fix a flake8 warning
2022-01-15 20:01:30 +09:00
Takeshi KOMIYA
44e6d0ce2a
doc: Remove a mention to :dedent: 0
...
`:dedent: 0` option for the code-block directive is a secret feature.
So it should not be mentioned in our docs.
2022-01-15 19:59:47 +09:00
Takeshi KOMIYA
6611140c76
Merge branch '4.x' into HEAD
2022-01-15 19:46:45 +09:00
Takeshi KOMIYA
0938c193ea
Update CHANGES for PR #10099
2022-01-15 15:18:36 +09:00
Takeshi KOMIYA
54159f66d3
Merge pull request #10099 from mgeier/skip-data-uris
...
Skip "data:" URIs in ImageConverter
2022-01-15 14:21:08 +09:00
danieleades
9c68cd12d7
Update recipe.py
2022-01-14 08:58:54 +00:00
danieleades
18d7dfbd95
Update tests/test_ext_napoleon.py
...
Co-authored-by: Takeshi KOMIYA <i.tkomiya@gmail.com >
2022-01-14 08:58:02 +00:00
danieleades
99f905b8b4
Update sphinx/writers/texinfo.py
...
Co-authored-by: Takeshi KOMIYA <i.tkomiya@gmail.com >
2022-01-14 08:57:56 +00:00