Takeshi KOMIYA
ae1f523d52
Add `--extensions to sphinx-quickstart` to support enable arbitary extensions from command line (ref: #2904 )
2016-11-02 11:11:15 +09:00
jfbu
aff72931fc
minor update to latex.rst
2016-10-30 00:08:17 +02:00
jfbu
e70746e8da
uppercase colour names (latex styling)
2016-10-30 00:04:23 +02:00
jfbu
a48a9c883a
style the latex chapter in the docs (for pdf output)
2016-10-29 16:30:33 +02:00
jfbu
528b6c374c
refactor the handling of latex options
...
previously, modifying a single option via ``\sphinxsetup`` redeclared
all dimensions and colours, even if they had not changed.
2016-10-29 14:03:12 +02:00
jfbu
b6695ad7fc
use 'sphinxpackageoptions' as argument to `\sphinxsetup`
...
Indeed, LaTeX's handling of package options is not robust when options
contain LaTeX macros; thus we pass all the user customization to
``\sphinxsetup``, not as package options to "sphinx.sty".
Also, make parameters for long code line breaking (ref #2343 , 1.4.2)
accessible as sub-keys of 'sphinxpackageoptions'. The space reserved for
the continuation character has been modified for coherence and
compatibility with use in footnotes. In fact it did not use the correct
font for the dimension computation. The documentation explains how to
recover former value.
2016-10-28 21:45:44 +02:00
jfbu
fb8bb072cb
`'sphinxpackageoptions'` for key=value styling of Sphinx LaTeX
2016-10-27 20:24:33 +02:00
Jean-François B
5fa47df1e8
Merge pull request #3096 from jfbu/latex_fixtoodeeplynested
...
Fix #777 : (part II) LaTeX output "too deeply nested"
2016-10-27 09:58:48 +02:00
jfbu
4e2bdf6671
ignore `'maxlistdepth'` if package "enumitem" in use
2016-10-27 09:24:12 +02:00
jfbu
183a2ca75a
Fix label placement in doc/config.rst (caused extra white line)
2016-10-26 23:49:49 +02:00
jfbu
e59ab1538d
fix typos and mark-up in doc/config.rst
2016-10-26 23:16:15 +02:00
jfbu
a3cf7185f1
fix mark-up in doc/config.rst
2016-10-26 22:56:58 +02:00
jfbu
3af9353b38
Fix #777 : (part II) LaTeX output "too deeply nested"
...
The standard classes have a severe cap on maximal nesting of list-like
environments (a total of six levels, and four for each of enumerate and
itemize). This commit defines a new key ``'maxlistdepth'``. _Only_ if it
is set (i.e. non-empty) will sphinx.sty do some hack to lift the LaTeX
limitations and extend the maximal list depth to the desired value.
2016-10-26 10:30:52 +02:00
Philip Molloy
47bae16513
Fix indentation in conf.py
2016-10-25 17:03:56 -04:00
Jakob Lykke Andersen
efa5382e9b
Merge pull request #3072 from jakobandersen/multiline-signatures
...
Make rendering of multiline signatures better in html.
2016-10-24 13:38:33 +02:00
jfbu
720e155b83
Add a comment to Makefile template for make-mode, update doc/Makefile
2016-10-23 10:45:23 +02:00
jfbu
54dbd3882d
add advice on use of tabulary (latex output)
2016-10-20 15:47:38 +02:00
Jakob Lykke Andersen
4c2815bc95
Make rendering of multiline signatures better in html.
2016-10-20 09:28:59 +02:00
Takeshi KOMIYA
2b6eac73c3
Merge branch 'stable'
2016-10-20 14:42:54 +09:00
jfbu
6438cf54db
fix capitalization in config.rst: "Example of configuration file"
2016-10-17 17:25:40 +02:00
jfbu
daee1fc51d
Fix config.rst description of `latex_documents` docclass element
2016-10-17 09:46:38 +02:00
Jean-François B
828c96ec10
Fix #3047 : spacing before footnote in pdf output is not coherent ( #3057 )
...
A ``\sphinxBeforeFootnote`` macro is inserted by footnote environment
and ``\footnotemark`` command. Its default is to remove the space before
the footnote mark. Formerly, footnotes from explicit mark-up were
preceded by a space allowing a linebreak, but automatically generated
footnotes had no such space.
2016-10-16 17:40:19 +02:00
Jean-François B
3e21ef45cf
Merge pull request #3030 from jfbu/loadhyperreflater
...
(latex) separate loading of hyperref from sphinx.sty
2016-10-15 11:47:51 +02:00
jfbu
ec8dd32e35
add example to use of `'printindex'` key
2016-10-14 11:21:18 +02:00
jfbu
689327d6fc
add missing versionchanged directive for tableofcontents
2016-10-14 11:14:15 +02:00
jfbu
536d52063f
Revert "new `'packages' key to latex_elements`"
...
This reverts commit 9972d729ab
2016-10-14 09:04:45 +02:00
jfbu
9972d729ab
new `'packages' key to latex_elements`
...
serves to load packages after ``sphinx.sty`` itself and before hyperref.
2016-10-14 09:04:08 +02:00
jfbu
9cdf4fe00f
(latex) separate loading of hyperref from sphinx.sty
...
new 'hyperref' key in ``latex_elements``.
2016-10-14 09:02:18 +02:00
Takeshi KOMIYA
fcd5073437
Merge pull request #3052 from doctorlard/figure_language_filename_tokens_2
...
Fix #3028 : figure_language_filename format tokens, document tokens.
2016-10-14 11:58:01 +09:00
jfbu
340edb32c6
(latex) mention Bjornstrup fncychap chapter style in the docs
2016-10-13 23:21:05 +02:00
Jean-François B
b22db35849
Merge pull request #3040 from jfbu/updatelatexsphinxdocumentation
...
update latex.rst (``LaTeX customization`` chapter in the docs)
2016-10-13 22:14:15 +02:00
jfbu
fc3908485c
kill unwanted TABs
2016-10-13 15:47:30 +02:00
Yoshiki Shibukawa
6ee4289a95
Fix doc/Makefile that can't build man because of doc/man folder exists
2016-10-13 22:25:22 +09:00
Takeshi KOMIYA
2981664178
sphinx-quickstart supports user templates (ref: #2912 )
2016-10-13 21:21:57 +09:00
jfbu
44907736ec
update more latex.rst
2016-10-13 14:09:43 +02:00
Jonathan Harker
59ba8c1dee
Fix #3028 : figure_language_filename format tokens, document tokens.
2016-10-13 16:41:57 +13:00
Jean-François B
749a6a0558
Merge pull request #3032 from jfbu/improvelatexcompatibilities
...
Fix #3031 : incompatibility with LaTeX package ``tocloft``
2016-10-12 22:40:28 +02:00
jfbu
0861ca9a03
escape some backslashes in latex.rst example code
2016-10-12 22:33:09 +02:00
jfbu
613b80d3ed
update latex.rst (`LaTeX customization` chapter in the docs)
2016-10-12 22:12:36 +02:00
Takeshi KOMIYA
d87ba0d1da
Merge branch '2527_reversed_toctree'
2016-10-13 00:13:04 +09:00
Takeshi KOMIYA
c8fe4a1848
Rename :reverse: option of toctree directive to :reversed:
2016-10-12 19:36:49 +09:00
Takeshi KOMIYA
8481ed3560
Merge remote-tracking branch 'JonhVillalovos/master'
2016-10-12 18:49:08 +09:00
Takeshi KOMIYA
cbe0ce6beb
Add example of conf.py to doc/config.rst
2016-10-12 18:40:19 +09:00
jfbu
b0a3b6cbc0
fix typo in config.rst
2016-10-11 20:55:00 +02:00
jfbu
143daf21d8
Fix #3031 : incompatibility with LaTeX package `tocloft`
...
Use ``\sphinxtableofcontents``, and environments ``sphinxtheindex``
and ``sphinxthebibliography``.
2016-10-11 20:42:58 +02:00
jfbu
861973bfbb
Merge branch 'usegeometrypackage'
2016-10-10 20:55:44 +02:00
jfbu
34f1ce17fd
Fix #3018 : LaTeX problem with page dimensions and chapter titles
...
New key ``'geometry'`` to ``latex_elements``.
2016-10-07 23:40:39 +02:00
jfbu
5b78aa28fe
Fix #147 and fix #1986 : Problem with latex chapter style
...
Notice that as an after effect ``Contents`` or ``Python Module Index``
will appear (by default) in bold, and larger than formerly (it was a
bug of Sphinx that they were not styled).
I am leaving the `\py@HeaderFamily` in the `sphinx.sty` patch to the
Bjarne `fncychap.sty` style for backwards compatibility. And as it does
`\bfseries` by default I left only the size changing commands in the
`fncychap` customization of Bjarne style.
Also, the `\@makechapterhead` re-definition obeys `\mainmatter` etc...
2016-10-07 11:55:43 +02:00
Jean Jordaan
aa22bede25
Fix grammar and wording
2016-10-02 19:21:12 +07:00
Takeshi KOMIYA
ec934d476a
Fix #2983 : Rename `epub3_description and epub3_contributor to epub_description and epub_contributor`.
2016-10-01 00:17:19 +09:00
Takeshi KOMIYA
jfbu
Philip Molloy
Jakob Lykke Andersen
Jakob Lykke Andersen
Yoshiki Shibukawa
Jonathan Harker
Jean Jordaan