IntenseWebs/sphinx
3
0
Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2026-09-03 20:52:55 -05:00
Code Issues Packages Projects Releases Wiki Activity
7,405 Commits 11 Branches 236 Tags
9569c6dbff8e9bb2cc032ec4bc7ebdd50c4b570e
Commit Graph
100 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
jfbu 7a29b741a3 Update CHANGES for PR#3124 2016-11-17 19:28:02 +01:00
jfbu 308d3aee89 make shorthandoff extra safe also for turkish 
(perhaps xelatex+babel+turkish may not use active ``=`` either now
or in future)
 2016-11-17 10:12:53 +01:00
jfbu 8e1db118c0 polyglossia honors `\addto\captions<language>` like babel 2016-11-17 10:01:46 +01:00
jfbu 5663f750fe refactor multilingual (load user settings on top) 2016-11-17 10:00:01 +01:00
jfbu 7505557384 fix latex inline literals where `< > -` gobbled a space 2016-11-06 13:58:14 +01:00
jfbu c689994cf8 better fix for the `\sphinxcode` issue (with comma character) 
the context is not exactly as in code-blocks
 2016-11-06 13:34:01 +01:00
jfbu 0cdfdb7915 fix a latex issue in `\sphinxcode` for inline literals word-wrap 
this is the same issue which was fixed at 71b9f00 for code-blocks
 2016-11-06 13:21:53 +01:00
jfbu c94f3b7d73 fix faq.rst (texinfo example with `info`) 2016-11-06 12:56:16 +01:00
jfbu f2091e0512 fix bottom of conf.py.txt 2016-11-06 12:41:22 +01:00
jfbu da271b6373 fix `\t` which got converted to tab in conf.py.txt 2016-11-06 12:29:17 +01:00
jfbu ee4138a1de fix typo in doc 2016-11-06 11:30:30 +01:00
jfbu e78c17605c rename `'postamble' to 'atendofbody'` (ref #2877) 2016-11-06 10:11:40 +01:00
jfbu 6481af9f5d update `'fontenc' and 'fontpkg'` doc 2016-11-06 09:07:03 +01:00
jfbu bdede5e9b6 update documentation of `'babel'` key for latex 2016-11-06 08:42:45 +01:00
jfbu 04e1e7d538 fix use of CYRILLIC CAPITAL LETTER ES as C in CHANGES 
this broke build of PDF docs
 2016-11-06 08:10:27 +01:00
jfbu b35539bd2e reset `'babel' to empty if it was for babel_renewcommand` ok 2016-11-05 19:25:20 +01:00
jfbu 4c38038f64 latex multilingual and contentsname setup to after getting user setup 2016-11-05 19:02:12 +01: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
Jean-François B 2de1cd7fde Merge pull request #3115 from jfbu/luatex85 
load latex package luatex85 only under lualatex engine
 2016-11-05 13:35:36 +01:00
Jean-François B 146e3e6029 Merge pull request #3119 from jfbu/testtest2 
add unit test for maxlistdepth (latex)
 2016-11-05 12:08:37 +01:00
jfbu 53d202440f add `@skip_if_stylefiles_notfound` to maxlistdepth test 2016-11-05 11:50:12 +01:00
jfbu 8b3b8e01cc clarify wording in documentation of latex config 2016-11-05 11:11:51 +01:00
jfbu e49132d3e4 use inputenc latex template variable always 2016-11-05 11:06:49 +01:00
jfbu 0473e438dc add unit test for maxlistdepth (latex) 2016-11-04 23:57:00 +01:00
jfbu 7651b2de9b Update CHANGES 2016-11-04 22:35:29 +01:00
jfbu 7b8ef11e5e Update CHANGES for PR#3116 2016-11-04 22:31:54 +01:00
jfbu 5caa6c3be9 Update CHANGES for PR#3083 2016-11-04 22:29:38 +01:00
Jean-François B 20c7c60862 Merge pull request #3116 from jfbu/breakableinlineliterals 
Breakable inline literals in LaTeX
 2016-11-04 22:22:11 +01:00
jfbu be8034e131 make inputenc template use conditional on latex_engine being pdflatex 2016-11-04 22:17:34 +01:00
jfbu cf246d09c0 latex_engine template variable, check luatex85 only if lualatex engine 2016-11-04 22:16:30 +01:00
Jean-François B 7325f8fe8c Merge pull request #3083 from jfbu/add_to_new_default_latex_settings 
Add to new default latex settings
 2016-11-04 21:59:30 +01:00
jfbu e4d73df110 refactor multilingual setup, let "polyglossia" use `\setmainlanguage` 2016-11-04 21:00:37 +01:00
jfbu f2b63b473b fix python error in latex.py from commit 528b6c3 2016-11-03 20:03:53 +01:00
jfbu aa1ea9b863 latex use more of `\protected\def` 
this makes the LaTeX macros more robust, less worrying about where they
are used.
 2016-11-03 19:15:29 +01:00
jfbu ee8b558f14 latex use `\protected macros for \sphinxstyle...`'s commands 
also use ``\sphinxcode`` for literals in titles which will add the
extras (straight quotes, breaks allowed at ``/`` and some other
characters)
 2016-11-03 18:54:24 +01:00
jfbu d32d6f56ef replace `\DeclareRobustCommand by \long\protected\def` 2016-11-03 18:41:57 +01:00
jfbu 097967ed25 allow word wrap in PDF output for inline literals 
modified:   sphinx/texinputs/sphinx.sty
 2016-11-03 18:28:52 +01:00
jfbu 1777939fa4 Update CHANGES for PR#3059 2016-11-02 14:55:47 +01:00
Jean-François B 67fe3d6da0 Fix #2865: let LaTeX image inclusion obey `scale` before textwidth fit (#3059) 2016-11-02 14:50:41 +01:00
Jean-François B 358f5e08ef Merge pull request #3055 from jfbu/allowreferencesinlatextopics 
Fix #2461: re-allow footnotes in topics for latex PDF
 2016-11-02 14:45:27 +01:00
jfbu da1e157e90 fix typo in CHANGES 2016-11-02 08:18:53 +01:00
jfbu b9bb7d8810 Update CHANGES for PR#3104 2016-11-02 08:16:30 +01:00
Jean-François B a759e5eae7 Merge pull request #3104 from jfbu/latex_keyvalueoptions 
``'sphinxpackageoptions'`` for key=value styling of Sphinx LaTeX
 2016-11-01 19:25:49 +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 67a785c2ab use less macros for dimension parameters in LaTeX styling 2016-10-28 17:01:14 +02:00
jfbu fb8bb072cb `'sphinxpackageoptions'` for key=value styling of Sphinx LaTeX 2016-10-27 20:24:33 +02:00
jfbu 4d3f5b3c1c update style files checklist for latex tests 2016-10-27 11:43:20 +02:00
jfbu 5142d17e41 fix mark-up in AUTHORS (funny effect of `T.`) 2016-10-27 10:08:26 +02:00
jfbu 7a96becca1 Update CHANGES for PR#3096 2016-10-27 10:02:53 +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 787fffd25f fix test of current listdepth which was too permissive by one unit 2016-10-26 19:07:44 +02:00
jfbu 4470e7d565 use "kvoptions" to handle sphinx latex package options 
will facilitate adding options in the future, with a "key=value" syntax.
 2016-10-26 12:06:05 +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
jfbu a2672ce11b streamline latex comments in sphinx.sty 2016-10-26 10:16:09 +02:00
jfbu 69d3480ef7 Fix again hyperref duplicate destination warnings 
The method at 4e88bfe worked only for page 1. This moves to
``\maketitle`` the whole control.
 2016-10-25 22:30:40 +02:00
jfbu 24dd7852f4 Fix #3019: (xetex) let Unicode "no-break space" act like LaTeX `~` 2016-10-25 14:37:54 +02:00
Jean-François B 41609f15b8 Fix #3086: revert 1.5a2 change to latex bibliographic entries key widths (#3087) 2016-10-24 15:58:20 +02:00
jfbu d0dbd60d94 Addition and alphabetical order fix in AUTHORS 2016-10-23 15:08:51 +02:00
jfbu 8aa66fda80 Let "make help" provide better info for latexpdf target 2016-10-23 11:25:05 +02:00
jfbu ef73ecefb2 Amend Update CHANGES for PR#3056 (it was already in 1.5a2) 2016-10-23 10:53:55 +02:00
jfbu 637cb141f9 Update CHANGES for PR#3056 2016-10-23 10:46:10 +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
jfbu 039c68d8f3 Fix #3062: Failed to build PDF using 1.5a2 
PR #3030 (3e21ef4) moved "hyperref" loading to later but forgot the
`\hypersetup` at sphinx.sty#L895 for Japanese documents.
 2016-10-19 08:55:27 +02: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
jfbu 78d96b4abb amend Update CHANGES for PR#3057 2016-10-16 17:49:23 +02:00
jfbu 18c31d52bb Update CHANGES for PR#3057 2016-10-16 17:47: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
jfbu 2b865cf90a Make `make synonym to make help` again 2016-10-15 23:42:00 +02:00
jfbu 16e9049bb3 No need for an empty recipe for Makefile as it has been set .PHONY 2016-10-15 22:59:12 +02:00
jfbu 362ee9d974 Fix make-mode in order to allow build to go through 2016-10-15 21:09:21 +02:00
jfbu aad61e814c Fix #2461: re-allow footnotes in topics for latex PDF 
The issue #2291 which was fixed at 9b958b6d (1.3.6) is now alleviated
in another way since PR #3022 (b8e0e93).
 2016-10-15 13:03:18 +02:00
jfbu 40b644b664 Update CHANGES for PR#3022 2016-10-15 12:19:08 +02:00
Jean-François B b8e0e935e4 Improve LaTeX footnotes (#3022) 
Allow code-blocks in footnotes for LaTeX PDF output.

This is done via using a ``footnote environment``, provided by LaTeX
package footnotehyper which replaces old problematic package footnote.
No need to ship a custom tabulary anymore.

The footnote markers are silently removed from the table of contents and
do not end in the PDF bookmarks (the old code in ``sphinx.sty`` copying
``footmisc.sty`` was not satisfactory and has been deleted and replaced
by use of better ``\sphinxfootnotemark``.) Footnotes can be used also in
captions of literal blocks.
 2016-10-15 12:09:58 +02:00
jfbu 58dab8d80b Update CHANGES for PR#3030 2016-10-15 11:56:17 +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
Jean-François B 28d6e34bb3 Merge pull request #3051 from jfbu/betterfixforduplicatedestinationwarning 
(latex) avoid in a better way duplicate name page.1 hyperref warning
 2016-10-14 08:21:36 +02: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 4e88bfeff0 (latex) avoid in a better way duplicate name page.1 hyperref warning 
The  ``\pagenumbering{alph}`` trick has the inconvenient that it is
mandatory to reset later the page numbering to arabic else errors will
arise as soon as the document has more than 26 pages. This resetting is
done by Sphinx code for ``\tableofcontents`` now called
``\sphinxtableofcontents`` but not by original ``\tableofcontents``.
Thus, user putting ``\tableofcontents`` in ``'tableofcontents'`` key
would get errors now without that fix.

The titlepage environment creates a group and clears the page before
exiting, thus this solution is quite analogous to the one recommended by
hyperref author at http://tex.stackexchange.com/a/333219/4686.
 2016-10-13 20:17:28 +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 a16cb8ea57 update info strings of Sphinx LaTeX style file and classes 
makes latex compilation logs more precise
 2016-10-13 10:58:44 +02:00
jfbu c3b6f8cc95 Update CHANGES for PR#3032 2016-10-12 22:42:12 +02: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