Juan Luis Cano Rodríguez
95519b3c06
Links to relevant reST syntax explanation
2021-05-31 16:26:21 +02:00
Juan Luis Cano Rodríguez
1da5ab5808
Style fixes
...
Co-authored-by: Steve Piercy <web@stevepiercy.com >
2021-05-31 16:26:21 +02:00
Takeshi KOMIYA
988a79de65
linkcheck: Emit a warning for disallowed redirects
...
Now linkcheck builder integrates `linkcheck_warn_redirects` into
`linkcheck_allowed_redirects`. As a result, linkcheck builder will
emit a warning when "disallowed" redirection detected via
`linkcheck_allowed_redirects`.
2021-05-31 21:53:09 +09:00
Takeshi KOMIYA
2887dd07df
doc: Fix indentation
2021-05-31 02:59:35 +09:00
Takeshi KOMIYA
48c80b17b4
doc: Fix indentation
2021-05-31 02:58:29 +09:00
Takeshi KOMIYA
676834b998
Merge branch '4.x' into 6525_linkcheck_warn_redirects
2021-05-31 02:54:41 +09:00
Takeshi KOMIYA
fe89a07a92
Fix typo in doc/usage/configuration.rst
...
Co-authored-by: François Freitag <mail@franek.fr >
2021-05-31 02:54:17 +09:00
Takeshi KOMIYA
46c2e45aa6
deprecate sphinx.ext.autosummary._app
2021-05-31 02:09:10 +09:00
Juan Luis Cano Rodríguez
bfca913f16
Move virtual environment explanation to installation
2021-05-29 19:15:15 +02:00
Juan Luis Cano Rodríguez
5b3e5d887b
Amend code documentation introduction
2021-05-29 13:44:26 +02:00
Juan Luis Cano Rodríguez
d6cb2d0c38
Use more appropriate terminology for emphasized text
2021-05-29 13:22:36 +02:00
Juan Luis Cano Rodríguez
bfd3b51435
Style
2021-05-29 13:22:21 +02:00
Juan Luis Cano Rodríguez
1631291b0e
Consistent heading styles
2021-05-29 13:21:50 +02:00
Juan Luis Cano Rodríguez
ffa8e110d0
Add index tweaks
2021-05-27 21:32:49 +02:00
Juan Luis Cano Rodríguez
337ee6afaa
Style
2021-05-27 18:17:33 +02:00
Juan Luis Cano Rodríguez
39b5564c63
Beginning of the tutorial, tweaks to introduction
2021-05-27 18:15:26 +02:00
Grey Li
6a0dae08d0
Fix typo in doc/intl.rst
...
The pot files are in the gettext folder instead of locale folder.
2021-05-27 17:28:10 +08:00
Juan Luis Cano Rodríguez
70ee9bcd6a
Tutorial link in front page, audience, objectives, and prerequisites
2021-05-26 21:25:38 +02:00
Takeshi KOMIYA
abe5ab4fa7
Merge pull request #9242 from tk0miya/refactor_env2
...
refactor: Make the app argument for BuildEnvironment required
2021-05-22 02:22:42 +09:00
Takeshi KOMIYA
63fbfb02f1
refactor: Make the app argument for BuildEnvironment required
...
At present, some attributes of env object are considered as optional
because they have been initialized by None on the constructor. But
they have always been fullfilled actually.
To be clear the type hints of the env object, this makes the `app`
argument for the BuildEnvironment class required. It can ensure the
attributes of env object are not optional.
2021-05-22 02:09:49 +09:00
Takeshi KOMIYA
c97e9b14c4
Update docs
2021-05-20 23:43:34 +09:00
Takeshi KOMIYA
ce9e2e6c74
Rename linkcheck_ignore_redirects to linkcheck_allowed_redirects
2021-05-20 23:26:16 +09:00
Takeshi KOMIYA
4d061f2b49
Fix #9252 : doc: Update explanation of highlight_language
2021-05-20 02:07:01 +09:00
Takeshi KOMIYA
549f09e048
Merge pull request #9239 from igo95862/https-links
...
Upgrade URLs to use HTTPS
2021-05-19 22:59:19 +09:00
igo95862
0f4039ab56
doc: Fixed opensearch.org link and upgraded to HTTPS
2021-05-17 20:39:14 +03:00
igo95862
82f37344b0
doc: Upgraded dublincore.org link to HTTPS
2021-05-17 20:39:14 +03:00
igo95862
cb004cc046
doc: Upgrade example.com links to HTTPS
2021-05-17 20:39:14 +03:00
igo95862
3f0a840c54
doc: Upgraded plantuml.org link to HTTPS
2021-05-17 20:39:14 +03:00
igo95862
b6c2edb5ca
doc: Upgraded mathjax documentation link to HTTPS
2021-05-17 20:39:14 +03:00
igo95862
bb173a5789
doc: Moved flask links to new home and HTTPS
...
Seems like Flask is no longer pocoo project but
palletsprojects.com
2021-05-17 20:39:13 +03:00
igo95862
cfa449624d
doc: Moved Jinja links to new home page and HTTPS
...
Seems like Jinja is no longer pocoo project but
palletsprojects.com
2021-05-17 20:38:48 +03:00
Takeshi KOMIYA
bc7087a1a2
Merge branch '4.x' into 3014_autodoc-process-bases
2021-05-17 22:40:27 +09:00
igo95862
7554ad9593
doc: Upgraded babel.pocoo.org links to HTTPS
2021-05-16 16:37:51 +03:00
igo95862
29aaf20a11
doc: Upgraded some of sphinx-doc.org links to HTTPS
...
Seems like that link is used in some tests and code so
upgrading it outside documentation might break something
2021-05-16 16:37:36 +03:00
igo95862
6c5f77c689
doc: Upgrade pygments.org links to HTTPS
2021-05-16 15:53:58 +03:00
igo95862
e67c9e5df1
doc: Upgrade docutils.sourceforge.io links to HTTPS
...
Also change any docutils.sourceforge.net link to io
top level domain.
2021-05-16 15:53:49 +03:00
igo95862
28b9475019
doc: Upgrade writethedocs.org domain link to HTTPS
2021-05-16 15:08:18 +03:00
Takeshi KOMIYA
630e5bd15f
manpage: Stop creating a section directory on build manpage by default
2021-05-16 17:06:58 +09:00
Takeshi KOMIYA
8d87dde43b
Merge pull request #9232 from tk0miya/9217_dont_make_section_directory
...
manpage: Stop creating a section directory on build manpage by default
2021-05-16 17:02:41 +09:00
Takeshi KOMIYA
707319aab2
Close #6525 : linkcheck: Add linkcheck_ignore_redirects
...
Add a new confval; linkcheck_ignore_redirects to ignore hyperlinks
that are redirected as expected.
2021-05-16 02:48:03 +09:00
Takeshi KOMIYA
05eb2ca06f
Close #6525 : linkcheck: Add linkcheck_warn_redirects
...
Add a new confval; `linkcheck_warn_redirects` to emit a warning when
the hyperlink is redirected. It's useful to detect unexpected redirects
under the warn-is-error mode.
2021-05-16 02:29:03 +09:00
Takeshi KOMIYA
51ae283a38
Close #4257 : autodoc: Add autodoc_class_signature
...
Add `autodoc_class_signature` to separate the class entry and the
definition of `__init__()` method.
2021-05-16 01:53:48 +09:00
Takeshi KOMIYA
67db20d705
Close #3014 : autodoc: Add autodoc-process-bases
...
Add `autodoc-process-bases` to modify the base classes of the class
definitions. This allows the extensions to insert or modify the list
of the base classes via event-handlers.
2021-05-16 00:46:06 +09:00
Takeshi KOMIYA
fa8117cd2f
manpage: Stop creating a section directory on build manpage by default
2021-05-15 22:23:40 +09:00
Takeshi KOMIYA
5078069eb1
Deprecate app.html_themes
...
The register is much better to store the HTML themes instead of the
application object. So this migrates it to the registry object.
2021-05-12 01:36:14 +09:00
Takeshi KOMIYA
c341807991
Merge pull request #9185 from AWhetter/autodoc_typehints_both
...
autodoc.typehints can accurately represent overloads
2021-05-12 00:23:58 +09:00
Takeshi KOMIYA
0b0414ea17
Update "versionadded" in doc/usage/extensions/autodoc.rst
2021-05-12 00:04:43 +09:00
Dmitry Shachnev
356f7c53e2
Fix typos in doc/extdev/deprecated.rst
2021-05-09 20:14:38 +03:00
Ashley Whetter
28d3f8136e
autodoc.typehints can accurately represent overloads
2021-05-08 21:34:25 -07:00
Takeshi KOMIYA
ac51fe8d2a
doc: Update CHANGES and docs for PR #9176
2021-05-09 02:13:15 +09:00