IntenseWebs/sphinx
3
0
Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2025-02-25 18:55:22 -06:00
Code Issues Packages Projects Releases Wiki Activity
7,301 Commits 2 Branches 219 Tags
e70746e8daf208d88c9e8d88b1fc623d0cbe669d
Commit Graph

1434 Commits

Author SHA1 Message Date
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
fb9dc3539a Merge pull request #2966 from tk0miya/2877_rename_footer 
Fix #2877: Rename ``latex_elements['footer']`` to ``latex_elements['postpreamble']``
 2016-09-21 10:48:20 +09:00
Takeshi KOMIYA
090e357969 Merge pull request #2963 from tk0miya/326_numref_section 
make section numref-able and allow to refer the captions in linktext
 2016-09-21 10:45:57 +09:00