Commit Graph

175 Commits

Author SHA1 Message Date
jfbu
7e851510eb Fix duplicate reference (my wrong, refs: #5919) 2019-01-13 10:52:42 +01:00
jfbu
ad8205bb0b [DOC] Move description of latex_elements to latex.rst 2019-01-10 16:48:03 +01:00
jfbu
d4d1a4ba84 Merge branch 'master' into latex_tableofcontentshook 2018-12-23 11:31:10 +01:00
jfbu
8e14532b08 LaTeX: move some hard-coded re-definitions to user hook for TOC 2018-12-22 17:33:03 +01:00
jfbu
1920d1d950 LaTeX: `\sphinxmaketitle and optional \sphinxbackoftitlepage`
Closes: #5849
2018-12-21 21:38:27 +01:00
Matthias Geier
4af446349c DOC: Fix some minor mistakes in "LaTeX customization" 2018-12-11 18:20:28 +01:00
Matthias Geier
0095449314 DOC: Fix some minor mistakes in "LaTeX customization" 2018-12-11 14:06:59 +01:00
Takeshi KOMIYA
8bc136a9cb Use \sphinxcite instead of \cite 2018-05-03 20:58:30 +09:00
Takeshi KOMIYA
b35198d847 Deprecate highlightlang directive
highlightlang directive is not documented, and marked as old in v0.2.
2018-04-15 00:33:02 +09:00
Takeshi KOMIYA
b2bd9f75a6 Merge branch '1.7' 2018-04-09 01:46:00 +09:00
jfbu
e81f80880a Slight rework of latex doc 2018-04-02 19:47:57 +02:00
jfbu
8c55793902 Let LaTeX with XeTeX/LuaTeX not use small typeface in code-blocks
closes: #4791
2018-03-28 23:17:34 +02:00
jfbu
4ca7bfc601 Merge branch 'stable' 2017-12-12 11:00:52 +01:00
jfbu
faadbef757 Expose some sphinx.sty LaTeX internals for customizability (refs: #4285) 2017-12-12 10:57:49 +01:00
jfbu
43e6f1aa96 Fix VerbatimHighlightColor key declared non-sphinx-prefixed colour name 2017-12-11 23:09:19 +01:00
jfbu
ad4481eb15 Merge branch 'stable' 2017-12-11 22:54:34 +01:00
jfbu
70f8d4ddfc Support `:emphasize-lines:` in PDF output (closes #1238) 2017-12-10 12:37:36 +01:00
Takeshi KOMIYA
7e7b389eed Merge branch 'stable' 2017-10-23 12:23:58 +09:00
jfbu
6b4a0123fa Fix the fix of #4090 (sorry) 2017-10-22 13:28:46 +02:00
jfbu
5e86c1c934 Fix #4090: extra LaTeX macros via `latex_additional_files` 2017-10-22 13:24:03 +02:00
jfbu
90e3425ed7 Fix #4149: Documentation: Help choosing latex_engine 2017-10-22 11:45:28 +02:00
jfbu
634d76faf1 latex: add option to put literal block captions before or after
According to ``literalblockcappos`` setting in ``'sphinxsetup'``, (t)op
or (b)ottom, the caption will be typeset before or after the literal
block. If typeset above, its distance to frame is now identical to the
setting used for captions of tables (one half of the baseline).

Further keys ``verbatimcontinuedalign`` and ``verbatimcontinuesalign``
allow to horizontally align the continuation hints relative to the
literal block contents: either (l)eft, (c)enter, or (r)ight.
2017-06-17 10:40:12 +02:00
jfbu
3d5e0c5d7c Merge branch 'stable' 2017-06-17 10:37:30 +02:00
jfbu
c2277ae61c latex: hint that code-blocks continue on next page (closes #3764) 2017-06-14 09:49:39 +02:00
Takeshi KOMIYA
f6d0b07704 Merge branch 'stable' 2017-06-13 00:32:39 +09:00
jfbu
db8ff5fb75 Fix markup typo and missing bit in docs 2017-06-05 19:43:09 +02:00
jfbu
8b35c36cfe Shorten a definition list in latex docs 2017-06-05 16:55:37 +02:00
jfbu
5e2d4ca77b Merge branch 'stable' 2017-06-05 15:40:18 +02:00
jfbu
bd8c7e1410 Make the latex docs more concise 2017-06-05 15:34:23 +02:00
jfbu
d4f37925c0 Merge branch 'stable' 2017-06-03 17:36:19 +02:00
Sanjeev Gupta
a259df7dea Proof read and polish english. Some typos. 2017-06-02 00:22:33 +08:00
Takeshi KOMIYA
78a20617b5 Merge branch '1.6-release' 2017-05-13 15:42:28 +09:00
jfbu
773659c41a Mention latex table templates in docs 2017-05-11 22:50:58 +02:00
jfbu
f7876f6b74 Update latex docs 2017-05-07 11:12:18 +02:00
jfbu
a700f4631f Merge branch '1.6-release' 2017-05-07 11:11:02 +02:00
jfbu
38e6dfca34 Update latex docs 2017-05-07 11:10:41 +02:00
jfbu
f547e59a7a Merge branch '1.6-release' 2017-05-05 13:34:47 +02:00
jfbu
79412051d2 Merge branch 'stable' into 1.6-release 2017-05-05 13:33:50 +02:00
jfbu
321a5e7a5e Fix #3702: abstract LaTeX styling of figure legends into sphinxlegend 2017-05-04 09:59:29 +02:00
Takeshi KOMIYA
c7d90ab18c Update doc 2017-04-29 15:15:22 +09:00
Takeshi KOMIYA
361a34257b Remove deprecated feature: latex_keep_old_macro_names 2017-04-27 21:49:19 +09:00
Takeshi KOMIYA
aa6dfb8b41 Merge branch 'stable' 2017-03-18 18:25:50 +09:00
jfbu
39bce2f90a Remove documentation of `\sphinxquotedblleft` from next minor release
Indeed, the macros will perhaps be removed already at 1.6, (PR #3562),
hence it is better not to document them at 1.5.4.
2017-03-16 23:01:12 +01:00
jfbu
bc0682af0e Merge branch 'stable'
Conflicts resolved:
	sphinx/domains/cpp.py
	sphinx/domains/python.py
	sphinx/texinputs/sphinx.sty
	sphinx/util/docfields.py
	sphinx/writers/latex.py
	tests/test_build_latex.py

Also updated:
    sphinx/domains/__init__.py
2017-03-12 13:01:47 +01:00
jfbu
990f51d680 Update latex docs 2017-03-10 08:42:37 +01:00
jfbu
c28e1da763 Update (again) latex docs after PR##3429 2017-03-01 22:26:49 +01:00
jfbu
5b5398768c Make `'extraclassoptions' key of latex_elements` public 2017-02-28 12:43:36 +01:00
Mike Fiedler
a0d39222a7 Update latex.rst
typo & extra word removal

Signed-off-by: Mike Fiedler <miketheman@gmail.com>
2017-02-26 09:00:34 +01:00
Mike Fiedler
b8dd3176b8
Update latex.rst
typo & extra word removal

Signed-off-by: Mike Fiedler <miketheman@gmail.com>
2017-02-25 20:17:37 -05:00
jfbu
64475a8d7d shorten and link latex docs 2017-02-06 14:24:19 +01:00
jfbu
101af91b80 more precise latex docs 2017-02-06 13:55:25 +01:00
jfbu
451115f2d1 no need to pass truedimen as class option, package option is enough 2017-02-05 20:07:41 +01:00
jfbu
9c6a071572 Fix #3356 and #3394 (latex) text layout of Japanese documents
- make text width integer multiple of zenkaku width

- fix incompatibility of ``geometry`` package with ``jsbook`` LaTeX
  class (``'manual'`` docclass)

- fix issue with shortened text area height in ``'manual'`` docclass
2017-02-05 17:25:50 +01:00
jfbu
e46887b1e9 polish latex.rst doc slightly 2017-01-16 15:15:07 +01:00
jfbu
6f0d0ede3a polish an item in latex.rst doc file 2017-01-16 09:41:37 +01:00
jfbu
8c21abeccc Fix #3308: Parsed-literals don't wrap very long lines with pdf builder 2017-01-16 00:15:29 +01:00
jfbu
ee4138a1de fix typo in doc 2016-11-06 11:30:30 +01:00
Takeshi KOMIYA
392da57094 Merge pull request #3121 from jfbu/inlineliteralwraptoggle
add option to control if inline literal word-wraps in latex
2016-11-06 14:55:29 +09:00
jfbu
44160fa691 rename `'sphinxpackageoptions' to 'sphinxsetup'` 2016-11-05 16:58:01 +01:00
jfbu
a50dfbab0c add option to control if inline literal word-wraps in latex 2016-11-05 16:43:13 +01: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
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
jfbu
fc3908485c kill unwanted TABs 2016-10-13 15:47:30 +02:00
jfbu
44907736ec update more latex.rst 2016-10-13 14:09:43 +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
d45c5f8e82 #2725: latex builder: allow to use user-defined template file (experimental) 2016-08-17 22:52:42 +09:00
jfbu
067d3cabf0 latex, make use of `\small` for code listings customizable 2016-06-30 11:20:30 +02:00
jfbu
5bd76815ff Added an item about sphinxVerbatim to doc/latex.rst 2016-06-22 22:30:58 +02:00
jfbu
12ade10d55 New latex.rst for extended documentation of LaTeX's customizing. 2016-06-20 09:23:41 +02:00