Takeshi KOMIYA
59e0746cb5
doc: Remove intro.rst (ref: #7751 )
2020-05-31 12:06:45 +09:00
Takeshi KOMIYA
350f5b3600
Merge pull request #7751 from stephenfin/doc/intro-section
...
[doc] Remove the intro guide in favour of the quickstart guide
2020-05-31 01:12:35 +09:00
Takeshi KOMIYA
6be72c6ed2
Merge pull request #7752 from stephenfin/doc/latex-rework
...
[doc] Rework "latex" document
2020-05-31 01:09:23 +09:00
Stephen Finucane
f3360e6922
docs: Fix typo, replace field lists with paragraphs
...
Signed-off-by: Stephen Finucane <stephen@that.guru >
2020-05-30 15:43:05 +01:00
Stephen Finucane
aaf2dafd63
docs: Compare docutils with Sphinx
...
Add an FAQ entry comparing the two.
Signed-off-by: Stephen Finucane <stephen@that.guru >
2020-05-30 15:38:12 +01:00
Stephen Finucane
e4e5c509b6
doc: Rework "templating" documents
...
Signed-off-by: Stephen Finucane <stephen@that.guru >
2020-05-30 15:29:13 +01:00
Stephen Finucane
97d1b323b7
docs: Merge intro and quickstart guide
...
The intro guide mostly contained out-of-date information or information
that was duplicated from elsewhere. Remove it in favour of an enhanced
quickstart guide.
Signed-off-by: Stephen Finucane <stephen@that.guru >
2020-05-30 15:25:45 +01:00
Stephen Finucane
f07ad49c22
docs: Add usage, development index page
...
Signed-off-by: Stephen Finucane <stephen@that.guru >
2020-05-30 15:24:40 +01:00
Stephen Finucane
52bb0b02bb
docs: Fix a typo and some indentation
...
Signed-off-by: Stephen Finucane <stephen@that.guru >
2020-05-30 15:23:36 +01:00
Stephen Finucane
ceb72f9cd7
doc: Rework "latex" document
...
Remove some unnecessary indentation, consistently document option
defaults, and fix some wrapping and whitespace.
Signed-off-by: Stephen Finucane <stephen@that.guru >
2020-05-30 15:23:36 +01:00
Takeshi KOMIYA
800dcf0f0a
Close #2106 : autodoc: Support multiple signatures on docstring
2020-05-30 15:40:21 +09:00
Kai Welke
0ee57a6f6e
Fixed broken link to pygments lexers doc
2020-05-26 09:35:47 +02:00
Michaël Defferrard
5e5bd748e6
remove repeted word in reStructuredText Primer
2020-05-20 22:30:58 +02:00
Takeshi KOMIYA
752d3285d2
Update docs (refs: #7469 )
2020-05-21 00:56:32 +09:00
Daniel Fremont
de4aca857c
revisions per comments from tk0miya
2020-05-17 09:07:11 -07:00
Daniel Fremont
f9e9bdc4a0
Merge remote-tracking branch 'sphinx/3.x' into 3.x
2020-05-17 08:09:45 -07:00
Jakob Lykke Andersen
ff7545a191
Allow NoUri from 'missing-reference' handlers.
...
Also extend documentation of 'missing-reference'.
2020-05-17 12:34:33 +02:00
Takeshi KOMIYA
d47427e94f
Merge pull request #7647 from tk0miya/fix_versionchanged
...
doc: Fix wrong version info
2020-05-10 16:03:01 +09:00
Takeshi KOMIYA
b1554ae25a
doc: Fix wrong version info
2020-05-10 01:12:39 +09:00
Takeshi KOMIYA
891c659ced
Deprecate sphinx.util:rpartition()
2020-05-09 22:00:04 +09:00
Takeshi KOMIYA
1ba671a677
Deprecate ignore parameter for Documenter.get_doc()
2020-05-03 01:59:47 +09:00
Takeshi KOMIYA
155cb87452
doc: Fix examples of doctest extensions are still in py2 (refs: #7575 )
2020-04-29 22:46:44 +09:00
Takeshi KOMIYA
87308d9607
Close #7143 : py domain: Add :final: option to py:*: directives
2020-04-28 01:24:29 +09:00
Takeshi KOMIYA
4eafda8588
Merge pull request #7546 from tk0miya/4030_autosummary_context
...
Close #4030 : autosummary: Add autosummary_context
2020-04-27 02:01:34 +09:00
Takeshi KOMIYA
037fe96dc1
Close #4030 : autosummary: Add autosummary_context
2020-04-25 11:15:43 +09:00
Takeshi KOMIYA
e5192ba48b
refactor: AutosummaryRender
2020-04-25 01:25:00 +09:00
Takeshi KOMIYA
0374d217d4
refactor: Deprecate unused parameters
2020-04-23 22:54:53 +09:00
Takeshi KOMIYA
931bfcca88
refactor: autosummary: Change first argument for AutosummaryRenderer
2020-04-23 22:51:23 +09:00
Takeshi KOMIYA
ebfa8dbf2a
Merge pull request #7538 from tk0miya/7535_autogen_crashes_on_inherited_template
...
Fix #7535 : sphinx-autogen: crashes when custom template uses inheritance
2020-04-23 21:46:06 +09:00
Takeshi KOMIYA
61b823ad10
refactor: Deprecate unused parameters
2020-04-23 02:25:58 +09:00
Takeshi KOMIYA
c9e4945623
Merge pull request #7473 from eric-wieser/meta-public
...
Add support for :meta public:
2020-04-23 02:15:42 +09:00
Takeshi KOMIYA
e1c7e9d481
Fix #7534 : docs: Big vertical whitespace rendered in official doc
2020-04-22 23:37:44 +09:00
Takeshi KOMIYA
6e28675727
doc: Fix version
2020-04-21 23:38:18 +09:00
Takeshi KOMIYA
7671bcc23b
Remove autosummary_recursive configuration
...
Now autosummary directive has :recursive: option to enable the
recursive feature individually. So the configuration is no longer
needed.
2020-04-21 23:38:18 +09:00
Takeshi KOMIYA
b9da9237bc
Merge branch '3.x' into 6040_autosummary_recursive
2020-04-21 23:04:38 +09:00
Takeshi KOMIYA
476b73b6ca
autosummary: Add :recursive: option to autosummary directive
2020-04-21 22:47:00 +09:00
Takeshi KOMIYA
c2c95ef587
Merge pull request #7411 from tk0miya/latex_theme_options
...
LaTeX: Add `latex_theme_options` to override theme options
2020-04-20 01:50:06 +09:00
Takeshi KOMIYA
12cb90c3fa
Merge pull request #7492 from tk0miya/7490_autosummary_caption
...
Close #7490 : autosummary: Add ``:caption:`` option to autosummary directive
2020-04-20 00:52:45 +09:00
Takeshi KOMIYA
05aff200b1
LaTeX: Add :confval:latex_theme_options to override theme options
2020-04-20 00:51:08 +09:00
Takeshi KOMIYA
b5066cf48f
Merge pull request #7513 from tk0miya/7488_docs
...
Fix #7488 : Update docs
2020-04-20 00:47:34 +09:00
Takeshi KOMIYA
68375c92f2
Fix #7488 : Update docs
2020-04-19 23:01:57 +09:00
Takeshi KOMIYA
4627742cb3
doc: Fix html_use_opensearch of sphinx-doc.org
2020-04-19 01:50:38 +09:00
Matthias Geier
fc78f09441
DOC: Use html_baseurl
2020-04-17 17:01:48 +02:00
Takeshi KOMIYA
1e3ce31b03
Merge pull request #7443 from mgeier/theme-options-toctree
...
Add globaltoc_collapse and globaltoc_includehidden options
2020-04-16 23:11:28 +09:00
Takeshi KOMIYA
dc46897768
Close #7490 : autosummary: Add `:caption:` option to autosummary directive
2020-04-16 23:04:57 +09:00
Matthias Geier
3baa6e09e2
FIXUP: move "versionadded"
2020-04-15 21:02:41 +02:00
Takeshi KOMIYA
19d5d8d75c
Fix #7477 : imgconverter: Invoke "magick convert" command on Windows
2020-04-15 23:23:28 +09:00
Eric Wieser
0d7451c23d
Add support for :meta public:
...
A common use case for this is a class like `namedtuple`, which has a public `_replace` method that is so-named in order not to conflict with arbitrary user-provided attributes.
Rejected spellings include:
* `:meta not-private:`
* `:meta private: False`
2020-04-14 08:41:45 +01:00
Matthias Geier
c17f00c7a2
DOC: globaltoc_collapse, globaltoc_includehidden
2020-04-13 19:22:17 +02:00
Takeshi KOMIYA
b2a601a33d
Merge branch '3.0.x' into 3.x
2020-04-13 23:36:10 +09:00