Takeshi KOMIYA
45f56dd7ac
Fix #9008 : Fix typo
2021-03-16 01:28:07 +09:00
Takeshi KOMIYA
17bb78997c
Merge pull request #7298 from tk0miya/7068_pyproperty_directive
...
py domain: Add py:property directive to describe a property (refs: #7068 )
2021-03-13 21:22:29 +09:00
Takeshi KOMIYA
204f86f736
py domain: Add py:property directive to describe a property (refs: #7068 )
2021-03-11 01:56:39 +09:00
Takeshi KOMIYA
54886fd256
Close #7549 : autosummary: Enable autosummary_generate by default
2021-03-10 01:35:49 +09:00
Takeshi KOMIYA
ae413e95ed
Merge pull request #8970 from naveen521kk/patch-1
...
Sphinx is available on Chocolatey
2021-03-07 21:30:46 +09:00
Naveen M K
1b425230e3
lint
2021-03-07 00:21:41 +05:30
Naveen M K
2638e9aecc
Sphinx is available on Chocolatey
2021-03-07 00:13:40 +05:30
Takeshi KOMIYA
0dcdbdc230
doc: Fix indentation
2021-03-06 21:19:26 +09:00
Takeshi KOMIYA
008feac9ad
Merge pull request #8965 from tk0miya/refactor_doc
...
doc: Update document for autodoc
2021-03-06 20:15:24 +09:00
Takeshi KOMIYA
697fdea612
doc: Update document for autodoc :special-members: option
2021-03-06 19:12:52 +09:00
Takeshi KOMIYA
8411b9a536
doc: Update document for autodoc :private-members: option
2021-03-06 19:12:47 +09:00
Takeshi KOMIYA
009fd4c396
doc: Update document for autodoc :undoc-members: option
2021-03-06 19:12:41 +09:00
Takeshi KOMIYA
f37e679fd1
doc: Update document for autodoc :members: option
2021-03-06 19:12:34 +09:00
Takeshi KOMIYA
1ea11b1e48
Fix #759 : autodoc: Add sphinx.ext.autodoc.preserve_defaults extension
...
Add a new extension `sphinx.ext.autodoc.preserve_defaults`.
It preserves the default argument values of function signatures in source code
and keep them not evaluated for readability. This is an experimental
extension and it will be integrated into autodoc core in Sphinx-4.0.
2021-03-06 18:48:18 +09:00
Takeshi KOMIYA
930a880294
Fix #7199 : py domain: Add a new confval: python_use_unqualified_type_names
...
Add a new config variable: python_use_unqualified_type_names. If enabled,
it goes to suppress the module name of the python reference if it can be
resolved.
2021-03-06 14:00:00 +09:00
Takeshi KOMIYA
3059a999b2
Close #8326 : Rename master_doc to root_doc
...
To describe the purpose more accurately, the `master_doc` is now renamed
to `root_doc`. The old name is still available. But it is recommeneded
to use new one from now on.
2021-02-28 17:10:57 +09:00
jfbu
62401ef1ec
Merge branch '3.x'
2021-02-12 21:27:17 +01:00
Jakob Lykke Andersen
a7fcc15683
C++, add noroot option to alias directive
2021-02-12 17:25:12 +01:00
Jakob Lykke Andersen
06a956200b
C, add noroot option to alias directive
2021-02-12 17:25:12 +01:00
Jakob Lykke Andersen
d0a4d0147e
C++, add recursiveness to alias
...
Fixes sphinx-doc/sphinx#8213 in the most basic way.
2021-02-12 17:25:12 +01:00
Harrissou Sant-anna
08c2c23bb4
Make code block types more visible
2021-02-08 13:03:16 +01:00
jfbu
87fa272763
Merge branch '3.x' into merge_3.x_into_master
...
Resolved Conflicts:
sphinx/texinputs/sphinxpackagefootnote.sty
2021-02-04 16:31:45 +01:00
jfbu
fbafb308b8
Merge branch '3.x' into master_with_merged_3.x
2021-02-02 18:01:55 +01:00
pbudzyns
270921d73a
Merge remote-tracking branch 'upstream/3.x' into exclude-members-fix
2021-02-01 10:46:44 +01:00
pbudzyns
35adeeff41
update docs
2021-02-01 10:28:01 +01:00
Takeshi KOMIYA
ffe8fbf271
doc: Update doc for project_copyright (refs: #8783 )
2021-01-30 11:38:16 +09:00
Takeshi KOMIYA
c9480f9943
Merge branch '3.x'
2021-01-28 00:56:46 +09:00
Takeshi KOMIYA
84dc65ad51
html: html_codeblock_linenos_style defaults to 'inline' (refs: #7849 )
...
As discussed in #7879 , the default style of line numbers for code
blocks in HTML output becames 'inline' by default. And 'table' style
is now deprecated and will be removed in Sphinx-6.0.
2021-01-26 01:42:17 +09:00
Takeshi KOMIYA
34417831c5
doc: Add hyperlinks to classifiers for sphinx extensions and themes
2021-01-24 16:45:50 +09:00
Takeshi KOMIYA
0ad32905bf
Merge branch '3.x'
2021-01-24 16:39:43 +09:00
Takeshi KOMIYA
51d500833e
Merge branch '3.x' into 7774_remove_develop.rst
2021-01-24 16:34:47 +09:00
Takeshi KOMIYA
41ee2d6e65
Merge pull request #8738 from tk0miya/8118_today_fmt
...
Fix #8118 : doc: the default setting of today_fmt
2021-01-24 14:42:20 +09:00
Takeshi KOMIYA
0e6a2a9ebd
Merge pull request #8737 from tk0miya/8510_html_logo_url
...
Allow user to use url to reference html logo & favicon
2021-01-24 14:40:56 +09:00
Takeshi KOMIYA
502c4ee5fb
Merge branch '3.x'
2021-01-24 14:32:13 +09:00
Takeshi KOMIYA
15cbc6dbb0
Close #6550 : html: Allow to use HTML permalink texts
...
Add new configuration variables: `html_permalinks` and
`html_permalinks_icon`.
This refines the settings around HTML permalinks.
* html_add_permalinks
* Deprecated.
* html_permalinks
* Enable or disable permalinks feature.
* html_permalinks_icon
* Change the icon for permalinks
2021-01-24 14:17:07 +09:00
Takeshi KOMIYA
3100ceb220
doc: minor fix
2021-01-23 22:32:17 +09:00
Takeshi KOMIYA
f707cb30a1
Merge pull request #7798 from stefanodavid/code-block-crossref-doc
...
documentation for proper code-block cross-referencing
2021-01-23 22:31:02 +09:00
Takeshi KOMIYA
41924776c4
Fix #8118 : doc: the default setting of today_fmt
...
Sphinx has used `'%b %d, %Y'` as a default setting of today_fmt longer.
So this fixes our document as Sphinx does.
2021-01-23 22:11:33 +09:00
Takeshi KOMIYA
7cfcd81b76
doc: html_favicon and html_logo accept URL now
2021-01-23 20:49:15 +09:00
Steve Piercy
cef669cb0f
Update the link to the new sphinx-contrib organization
...
This should be backported to at least 3.x, too.
2021-01-23 17:28:35 +09:00
Takeshi KOMIYA
37fc43a4d3
Merge pull request #8734 from stevepiercy/patch-2
...
Update the link to the new sphinx-contrib organization
2021-01-23 17:27:04 +09:00
jfbu
2e22bd0a23
Merge branch 'master' into latex_font_for_pdflatex
2021-01-23 09:13:08 +01:00
Steve Piercy
bd63ae9950
Update the link to the new sphinx-contrib organization
...
This should be backported to at least 3.x, too.
2021-01-23 00:08:57 -08:00
Takeshi KOMIYA
5ce72f465b
Merge branch '3.x'
2021-01-22 22:52:32 +09:00
jfbu
99a8b7f37f
LaTeX: update default font configuration
...
This replaces times package with tgtermes and tgheros (clones of Times and
Helvetica with better LaTeX support) and the monospace font from txfonts
package (txtt). This font is better matched with Times-like fonts than
Courier clones.
The changes applies to pdflatex/platex/uplatex.
Fixes : #8711
2021-01-20 23:03:08 +01:00
Guillaume Melquiond
8a1d0d0da6
Allow production lists to refer to tokens from other production groups.
...
Outside production lists, syntax "`foo:bar`" already makes it possible to
refer to the production "bar" of group "foo". This commit offers the same
feature inside production lists. Similarly to the reference syntax,
prefixing with a tilde prevents the group from being displayed.
This commit also makes it possible to use "`:bar`" to refer to production
"bar" from a production list without a group name. This is especially
useful when one has a main (unnamed) grammar and one or several named
extensions that need to refer to it.
2021-01-20 17:57:52 +01:00
Takeshi KOMIYA
ca0677086d
Merge pull request #8658 from SolidifiedRay/feature-custom-section
...
Close #8573 : napoleon: Add more custom section styles
2021-01-19 21:13:13 +09:00
SolidifiedRay
7ad85cd1e0
Close #8573 : napoleon: Add more custom section styles
2021-01-18 11:43:40 -08:00
Takeshi KOMIYA
30f8640bab
Merge branch '3.x'
2021-01-16 21:51:46 +09:00
Takeshi KOMIYA
b742bde8e6
Merge pull request #8684 from tk0miya/2030_automatic_dedent
...
Fix #2030 : automatic dedent support in code-block directive
2021-01-14 01:11:02 +09:00