jfbu
60b160431a
LaTeX: add hyperref support to general index as handled by xindy
...
- achieve hyperlinked page numbers in general index, despite xindy's
incompatibility with hyperref,
- obtain compatibility of pdflatex with xindy for documents with
Cyrillic scripts,
- use xindy by default with xelatex/lualatex because any non-ascii
character as first letter of an indexed term breaks PDF build if using
makeindex with lualatex, and produces incoherent index with xelatex.
This commit also switches off xindy logs (which were activated in parent
commits) as they are voluminous and not of immediate use to Sphinx user.
2018-07-14 19:13:59 +02:00
jfbu
90c2b528b1
Update docs and CHANGES for `latex_use_xindy` config variable
2018-06-30 23:37:26 +02:00
Takeshi KOMIYA
1140e81df7
Merge remote-tracking branch 'stephenfin/doc-rework'
2018-06-26 01:05:19 +09:00
Takeshi KOMIYA
1ebf6d4983
Merge pull request #5111 from stephenfin/tox-fixes
...
Run everything but unit tests under Python 3
2018-06-26 00:59:36 +09:00
Daniel Hahler
8f94429a21
doc: fix func/meth references to Sphinx
2018-06-25 08:25:56 +02:00
Stephen Finucane
2a4827af4f
make: Default to Python 3
...
As with the tox change, it makes sense to test things against Python 3
by default now, seeing as that will be the only version supported in
Sphinx 2.0.
Signed-off-by: Stephen Finucane <stephen@that.guru >
2018-06-21 15:11:35 +01:00
Martin Larralde
a68298b7d8
Update napoleon docs with features from #4613
2018-06-21 14:10:52 +02:00
Takeshi KOMIYA
f14d60dcd2
Merge pull request #5096 from tk0miya/update_docs
...
doc: update URL of PDF and EPUB
2018-06-21 01:29:42 +09:00
Stephen Finucane
d9ccc95717
doc: Add "extensions" to usage guide
...
Signed-off-by: Stephen Finucane <stephen@that.guru >
2018-06-20 09:30:47 +01:00
Stephen Finucane
0b81af6a2e
doc: Rework "extensions" documents
...
This is mostly spacing and other "niceness" fixes.
Signed-off-by: Stephen Finucane <stephen@that.guru >
2018-06-20 09:26:59 +01:00
Stephen Finucane
b595c4a45b
doc: Add "builders" to usage guide
...
This is placed in a directory as this document will eventually be split
up. However, this is not the day to do this.
Signed-off-by: Stephen Finucane <stephen@that.guru >
2018-06-20 09:26:59 +01:00
Stephen Finucane
7e27e09493
doc: Rework "builders" document
...
There are a number of cleanup items.
- Some paragraphs are reworded or clarified
- Semantic markup is added where possible
- Everything is wrapped to ~80 characters
A number of TODOs are inserted. These will be resolved separately.
Signed-off-by: Stephen Finucane <stephen@that.guru >
2018-06-20 09:26:59 +01:00
Takeshi KOMIYA
fd8e0be57a
Merge branch '1.7'
2018-06-19 23:39:23 +09:00
Takeshi KOMIYA
1dffeba0bc
Merge pull request #5102 from tk0miya/update_docs3
...
doc: Use badge to show latest release
2018-06-19 23:35:42 +09:00
Takeshi KOMIYA
b84240d871
Merge pull request #5108 from tk0miya/alabaster-0.711
...
Alabaster 0.711
2018-06-19 23:35:17 +09:00
Jakob Lykke Andersen
cff1146775
Customizable Python interpreter in doc/Makefile
...
Fix after previous stray edit.
2018-06-17 09:57:52 +02:00
Takeshi KOMIYA
0e8fb2dd25
doc: update download URL for PDF and EPUB
2018-06-17 16:55:18 +09:00
Takeshi KOMIYA
248869e2db
doc: Use badge to show latest release
2018-06-17 16:45:58 +09:00
shimizukawa
1b36b3fef7
make.bat must follow #4097 .
2018-06-17 15:24:23 +09:00
Takayuki SHIMIZUKAWA
0f1eb957af
Merge pull request #5083 from dombre/master
...
Fixed internationalization quick guide
2018-06-17 15:20:05 +09:00
Takeshi KOMIYA
af1502c32e
Merge pull request #5084 from tk0miya/3784_mathjax_integrity
...
Close #3784 : mathjax: Add :confval:`mathjax_options`
2018-06-17 00:33:58 +09:00
Takeshi KOMIYA
71c0eb6b1a
Merge branch '1.7'
2018-06-16 18:23:36 +09:00
Takeshi KOMIYA
0016bccb67
Merge pull request #5087 from jflory7/fix/google-style-guide
...
Update Google style guide link (previous link deprecated)
2018-06-15 22:46:11 +09:00
Roy Wellington Ⅳ
503eb7f2fd
Fix minor typo of "them"
2018-06-13 23:13:23 +02:00
Roy Wellington Ⅳ
d66e663f28
Fix minor typo of "them"
2018-06-13 11:25:21 -07:00
Justin W. Flory
61ef928310
Update Google style guide link (previous link deprecated)
2018-06-13 12:12:49 -05:00
Takeshi KOMIYA
34126021d9
Close #3784 : mathjax: Add :confval:mathjax_options
2018-06-13 23:24:21 +09:00
dombre
5df7228cde
Update intl.rst
...
Fixes #5081
2018-06-13 15:32:41 +02:00
Drew Risinger
fb5a4cbcc0
Autodoc.rst typo: ommit->omit
...
Fix typo in docs/ext/autodoc.rst. Changed "ommit"->"omit"
2018-06-12 23:54:35 -04:00
Jon Dufresne
2f17a0e8c8
Update Python 2 doc links to Python 3
...
Python 3 docs are more actively maintained and are the future.
2018-06-09 20:59:43 -07:00
Takeshi KOMIYA
40ee7cd0c4
Merge pull request #5029 from kmaehashi/autosummary-inherited-docs
...
autosummary: expose inherited_members to template
2018-06-09 22:11:03 +09:00
Jakob Lykke Andersen
cc026946f7
C++, add support for anon entities.
...
Anonymous entities are specified with names starting with "@",
but are rendered as "[anonymous]".
Fixes sphinx-doc/sphinx#3593 and sphinx-doc/sphinx#2683 .
2018-06-09 12:24:34 +02:00
Takeshi KOMIYA
fc7817b854
Merge pull request #5034 from tk0miya/add_html_js_files
...
Add :confval:`html_js_files`
2018-06-09 11:51:11 +09:00
Jean-François B
95a8099913
Merge branch 'master' into latex_remove_shorthandoff_variable
2018-06-08 19:53:46 +02:00
Takeshi KOMIYA
9fc2657d7e
Add :confval:html_js_files
2018-06-09 02:38:36 +09:00
Takeshi KOMIYA
9617b138c7
Merge pull request #5049 from tk0miya/4193_canonical_url
...
html: Output ``canonical_url`` metadata if :confval:`html_baseurl` set
2018-06-09 02:35:56 +09:00
Jonathan Demaeyer
7ed05e1d69
Link to cdnjs was incorrect
2018-06-08 13:56:45 +02:00
jfbu
359854fa78
Postpone to 3.0 removal of ExtBabel.get_shorthandoff()
2018-06-07 18:29:24 +02:00
Takeshi KOMIYA
b914327317
Reorder deprecated APIs (app)
2018-06-08 00:51:00 +09:00
Takeshi KOMIYA
e081b1f154
Reorder deprecated APIs (env)
2018-06-08 00:51:00 +09:00
Takeshi KOMIYA
a2c4ed6614
Fix wrong module name in CHANGES
2018-06-08 00:51:00 +09:00
jfbu
b41b1dac5c
Deprecate sphinx.writers.latex.ExtBabel.get_shorthandoff()
...
This partially reverts d17f3955a5
2018-06-06 19:16:14 +02:00
Takeshi KOMIYA
e30b10a57d
html: Output `canonical_url metadata if :confval:html_baseurl` set
2018-06-06 21:18:17 +09:00
jfbu
a32c358342
Remove usage of internal shorthandoff variable from LaTeX writer
2018-06-05 18:38:59 +02:00
Takeshi KOMIYA
158d7d2fd3
docs: Fix location of attributes
2018-06-05 22:57:04 +09:00
Kenichi Maehashi
270c1883e8
expose inherited_members to autosummary template
2018-06-01 13:29:00 +09:00
Takeshi KOMIYA
72011465ad
Merge pull request #5020 from tk0miya/5018_update_docs
...
Fix #5018 : wrong signature of env-merge-info and env-check-consistency
2018-05-29 01:25:46 +09:00
Takeshi KOMIYA
1deceda6da
Merge branch 'master' into 3606_load_mathjax_async
2018-05-28 23:04:13 +09:00
Takeshi KOMIYA
3c6be1b5b3
Merge pull request #5008 from tk0miya/refactor_latex2
...
Refactor latex writer
2018-05-28 22:59:40 +09:00
Takeshi KOMIYA
7c1613be18
Merge pull request #5013 from tk0miya/fix_doc
...
Update docs (T/O)
2018-05-28 22:57:33 +09:00