Takeshi KOMIYA
2c98e909bf
Merge branch '3.x'
2020-12-14 02:02:29 +09:00
Ned Batchelder
bac6ab8d0c
Describe the intersphinx mapping a bit more
2020-12-13 08:04:55 -05:00
Takeshi KOMIYA
1d9eeedde3
Fix #8508 : LaTeX: uplatex becomes a default setting of latex_engine for Japanese
...
Since v2.3, Sphinx supports uplatex as an alternative of latex_engine for Japanese
docs (refs: #4186 , #6841 ). uplatex is able to build a document without conversion
character encoding internally. It allows using unicode characters in documents.
Additionally, uplatex is compatible with platex (current default latex_engine for
Japanese docs).
This changes the default latex_engine for Japanese document to uplatex.
2020-11-29 15:09:49 +09:00
Takeshi KOMIYA
da4c69c624
Merge pull request #8291 from QuentinSoubeyran/8285_napoleon_google_style_use_annotations
...
Fix #8285 : napoleon can use PEP526 annotations
2020-11-28 18:11:30 +09:00
François Freitag
6b90a63f08
Fix #6629 : linkcheck: Handle rate-limiting
...
Follow the Retry-After header if present, otherwise use an exponential
back-off.
2020-11-25 17:34:55 +01:00
Quentin Soubeyran
ec30f77712
refactored code and tests, prepared for numpy feature
2020-11-25 08:45:25 +01:00
Quentin Soubeyran
f268665292
added napoleon_google_attr_annotations option to use PEP 526 on google style
2020-11-25 08:45:25 +01:00
Takeshi KOMIYA
3a4ae2092a
Merge branch '3.x'
2020-11-21 01:01:36 +09:00
Takeshi KOMIYA
5676fdeb4e
Rename :novalue: option to :no-value: option
...
According to the existing options of autodoc directives, `:novalue:`
option is now renamed to `:no-value:` option.
2020-11-15 14:20:30 +09:00
Marlon James
6082ce67a4
autodoc: document :novalue: option
2020-11-15 14:19:33 +09:00
Takeshi KOMIYA
7eabbfc5ec
Merge pull request #8284 from tk0miya/7996_man_make_section_directory_by_default
...
Close #7996 : manpage: Make a section directory on build manpage by default
2020-10-28 11:03:13 +09:00
Takeshi KOMIYA
c40b4249cd
Merge branch '3.x' into master
2020-10-28 02:23:36 +09:00
Takeshi KOMIYA
a843fd3db8
Close #7996 : manpage: Make a section directory on build manpage by default
2020-10-28 02:15:36 +09:00
Pradyun Gedam
18b2f2cdf2
Reword section on Third Party Themes
...
- No longer attempt to be the location for listing themes -- only Sphinx-RTD-Theme was listed here.
- Mention the classifier used when searching on PyPI.
- Emphasize sphinx-themes.org as a gallery of themes.
2020-10-21 11:16:59 +05:30
Thomas Grainger
3f26564c28
Apply suggestions from code review
2020-10-05 22:10:25 +01:00
Thomas Grainger
3eecf133d8
Fix #8289 : Allow to suppress "duplicated ToC entry found" warnings from epub builder
2020-10-05 09:29:16 +01:00
Takeshi KOMIYA
598b85da75
Merge branch '3.x' into master
2020-10-04 22:41:44 +09:00
Takeshi KOMIYA
178c05b059
Close #7996 : manpage: Add man_make_section_directory
...
Add a new config variable; man_make_section_directory to make a
section directory on build man page. During 3.x, it defaults to
False and will be changed to True on 4.0 release.
2020-10-03 22:30:20 +09:00
François Freitag
5166dd194c
Strip trailing whitespaces and normalize line endings
...
Trailing whitespace do not have impact on the result, they are just
unused bytes. Most text editors are configured to strip trailing
whitespaces. Remove them all in one go.
Update a handful of files to use the UNIX line ending.
2020-10-03 13:47:01 +02:00
Takeshi KOMIYA
f2c0dfe7c4
Close #6518 : autodoc: Add autodoc_type_aliases
...
autodoc_type_aliases allows to keep user defined type alises not
evaluated in the generated document.
2020-10-03 16:03:35 +09:00
Takeshi KOMIYA
26ea870267
Merge branch '3.x' into master
2020-10-03 13:43:21 +09:00
Steve Piercy
81d7f2ee8a
Update link to sphinxcontrib on GitHub
2020-09-26 16:32:59 -07:00
Bradley Dice
a0116eaa58
Fix typo: anchestor -> ancestor.
2020-09-20 17:36:01 -05:00
Tetsuo Koyama
9fe3fe4f6b
Add "Getting Started as a Translator"
2020-09-20 01:08:21 +09:00
Tetsuo Koyama
eef2f2a8b6
✏️ Fix grammer
2020-09-20 00:53:57 +09:00
Jakob Lykke Andersen
500f45fd4c
C, recursive alias declarations
...
Fixes sphinx-doc/sphinx#8141
2020-09-13 16:37:53 +02:00
Takeshi KOMIYA
bec30596a8
Merge branch '3.x' into master
2020-09-13 10:54:21 +09:00
Falko Axmann
849ef212bc
Fixes minor typo in quickstart.rst
2020-08-30 14:39:20 +02:00
Takeshi KOMIYA
8412347f5d
Merge branch '3.x'
2020-08-14 14:28:58 +09:00
Takeshi KOMIYA
dab15e2857
Merge pull request #8058 from nijel/single-domain
...
i18n: Add support for having single text domain
2020-08-14 14:21:43 +09:00
Adam J. Stewart
fa8ad979af
sphinx.ext.autodoc: fix typo in docs
2020-08-11 11:05:00 -05:00
Takeshi KOMIYA
a8927bcd3e
Merge branch '3.x'
2020-08-08 18:16:59 +09:00
Michal Čihař
1bf7fe424e
i18n: Add support for having single text domain
...
The gettext_compact can now be a string which is then a single domain
for all documents.
Fixes #784
2020-08-07 20:22:30 +02:00
Matt from Documatt
db9375363c
Add link to third party themes on GitLab
...
GitLab, alternative to GitHub, also contains a lot of beautiful open source themes.
2020-08-07 14:46:19 +02:00
Takeshi KOMIYA
f743be0054
Merge pull request #8047 from cjmayo/typos
...
Assorted typos including sphinx-buid in internationalization figure
2020-08-06 02:38:07 +09:00
Takeshi KOMIYA
059dc108ba
Close #6698 : doctest: Add :no-trim-doctest-flags: options
...
To control trimming doctest flags manually, this adds new options
:trim-doctest-flags: and :no-trim-doctest-flags: to doctest
directives. It helps to describes doctest module itself in python
doc (see #6698 ).
2020-08-05 23:39:05 +09:00
Chris Mayo
fe4a158caf
Fix typos in the documentation
2020-08-03 19:30:38 +01:00
Takeshi KOMIYA
57af828882
Merge pull request #8035 from tk0miya/8034_argument_for_private-members
...
Close #8034 : autodoc: :private-member: can take an list of member names
2020-08-03 01:57:13 +09:00
Takeshi KOMIYA
af15593c0c
Close #7768 : i18n: figure_language_filename supports {docpath} token
...
To build structured i18n imaging directory, figure_language_filename
now supports `{docpath}` token that is a dirname of the current
document.
2020-08-02 16:28:54 +09:00
Takeshi KOMIYA
d7a84e83cc
Close #8034 : autodoc: :private-member: can take an list of member names
...
Now :private-member: option can take an explicit list of member names to
be documented as its arguments (like :special-members: does).
2020-08-02 01:27:14 +09:00
Takeshi KOMIYA
c14c00397e
Merge branch '3.x'
2020-08-01 16:59:00 +09:00
Ebram Shehata
df2d4839c4
Update basics.rst
2020-07-29 15:14:29 +02:00
Chris Holdgraf
84f7dffd99
comments
2020-07-29 10:38:18 +01:00
Chris Holdgraf
c7085162d1
rearranging a few docs and small updates
2020-07-29 10:38:18 +01:00
Chris Holdgraf
729dcd0e03
flake8
2020-07-29 10:38:18 +01:00
Chris Holdgraf
60b105d6aa
several documentation improvements to theming, templating, and extension development
2020-07-29 10:38:18 +01:00
Takeshi KOMIYA
3336dcc2ae
Merge pull request #7997 from sphinx-doc/fix/6863
...
fix 6863: add description literalinclude option (start/end have same string)
2020-07-25 22:53:48 +09:00
Yoshiki Shibukawa
70aa913bb2
fix 6863: add description literalinclude option (start/end have same string)
2020-07-25 22:36:06 +09:00
Takeshi KOMIYA
778e297577
Update CHANGES for PR #7690
2020-07-25 21:45:13 +09:00
Takeshi KOMIYA
ac0a800265
Merge pull request #7690 from keewis/transform_numpy_parameter_types
...
preprocessing numpy types
2020-07-25 21:41:32 +09:00