IntenseWebs/sphinx
3
0 Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2026-10-13 17:02:12 -05:00
Code Issues Packages Projects Releases Wiki Activity
11,634 Commits 11 Branches 236 Tags
2259466d4b8ca90248aaeba6e9630aa78f4b4509
Commit Graph
100 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
jfbu 2259466d4b Remove some spaces added in last commit, which are ignored anyhow 2019-01-05 00:14:45 +01:00
jfbu 37f1aacd1f LaTeX do not strip spaces from numfig_format split at %s 
Only for figure and table, currently. Code-bloks have some FIXME code to
still be handled.

PDF output should remain unchanged so this is backwards compatible. The
`\nobreakspace` from LaTeX default `\fnum@figure` is removed by a normal
space. If figname is an abbreviation, the dot is followed by a `\@` to
avoid double space. At the location where the `\@` is inserted the `@`
has catcode non-letter so a space after it is not swallowed.

MEMO: when this is will be moved to sphinxmessages.sty on master branch
it is needed to use `\@{}` or to modify locally catcode of `@` to avoid
space swallowing..

Closes: #5889
 2019-01-04 23:53:17 +01:00
jfbu 18bf90822c Fix LaTeX writer handling of user custom numfig_format 2019-01-04 23:35:30 +01:00
Jean-François B 7ff7dfc427 Merge pull request #5867 from jfbu/latex_checkmark 
LaTeX: escape Unicode HEAVY CHECK MARK into latex macros
 2019-01-02 15:25:45 +01:00
Jean-François B 955488df2c Merge branch '1.8' into latex_checkmark 2019-01-02 14:34:32 +01:00
Jean-François B 38c5ec13a5 Merge pull request #5865 from jfbu/fix_spelling_typos 
Fix various spelling typos
 2018-12-28 12:34:34 +01:00
jfbu 7fe1016f5e LaTeX: escape Unicode HEAVY CHECK MARK into latex macros 
Closes: #3707
 2018-12-27 17:35:11 +01:00
jfbu 1e07cb10fc Fix various spelling typos 2018-12-27 13:06:33 +01:00
jfbu 3f92aa7e6a Remove from CHANGES mention of non-existing 1.7.10 release 2018-12-23 22:13:00 +01:00
Jean-François B a77f344035 Merge pull request #5850 from jfbu/latex_sphinxmaketitle 
LaTeX: ``\sphinxmaketitle`` and optional ``\sphinxbackoftitlepage``
 2018-12-23 11:01:46 +01:00
jfbu 0034664a6e Update date and version of LaTeX class files 2018-12-22 18:35:17 +01:00
jfbu 1920d1d950 LaTeX: `\sphinxmaketitle and optional \sphinxbackoftitlepage` 
Closes: #5849
 2018-12-21 21:38:27 +01:00
jfbu bd2ca4763c [tests] LaTeX: use latex engines with `--halt-on-error` option 2018-12-18 13:41:48 +01:00
Jean-François B e2431d80bd Merge pull request #5811 from jfbu/latex_fix_sphinxVerbatim_requires_hllines_markup 
LaTeX: allow sphinxVerbatim usage without explicit "hllines" extra setup
 2018-12-16 17:14:25 +01:00
jfbu 88a019dc99 LaTeX: allow sphinxVerbatim usage without explicit "hllines" extra setup 
Fixes: #5810
 2018-12-16 16:54:28 +01:00
jfbu c899b27b4a Update CHANGES for PR #5754 2018-12-11 18:24:09 +01:00
jfbu c050d44299 LaTeX update a comment about inputenc 2018-12-11 18:03:01 +01:00
jfbu f42d344e2c LaTeX: update sphinx.sty version and date 2018-11-18 10:16:30 +01:00
Jean-François B 9c8c2101d7 Merge pull request #5630 from jfbu/5520_latex_caption_package 
LaTeX: compatibility with caption package
 2018-11-18 10:11:04 +01:00
jfbu cdb70a1dde LaTeX: add a comment 2018-11-18 10:00:23 +01:00
jfbu 15cf5ff09a LaTeX: compatibility with captions package, last part 
Make sure vertiale spacing is the same for tabular(y)/longtable
also for multi-line captions
 2018-11-18 09:47:01 +01:00
jfbu 4457038550 LaTeX: compatibility with caption package, 2nd part 
Ensure same vertical spaces above caption for tabular(y) and longtable
rendered tables.

Fixes: #5520
 2018-11-18 00:40:28 +01:00
Jean-François B 3a512ef68c Merge branch '1.8' into 5520_latex_caption_package 2018-11-14 00:12:27 +01:00
jfbu 7f19885641 LaTeX: compatibility with caption package 
This compatibility is mainly re-instored for convenience of user to
style the fonts used for the caption, and also possibly influence the
horizontal position via "width" or "margin" option of caption package
(attention that caption package obeys the document class tacit "twoside"
option, so if left and right margins are not set-up to be the same,
positioning of caption will depend on parity of the page number).

Regarding vertical skips, for captions placed on top (which is the table
templates default and also the literalblockcappos default), this commit
ensures that the vertical spacing separating the caption last baseline
to the top of framing is governed by \sphinxbelowcaptionspace in all
these three cases: tabular(y), longtable, literal blocks; the "skip"
option of caption package is ignored for them.

The "skip" is obeyed for the spacing between an image and its caption,
which currently in Sphinx is always below the image (no customization of
the figure caption vertical placement is currently available).

If literalblockcappos is "b" (captions follow code-blocks), this commit
removes the caption-package added \abovecaptionskip, so that "skip" is
also ignored for code-blocks in this case. This looks better due to the
extra space already added by the framing of the code-block and achieves
same spacing as without caption package (presumably loaded mainly to
style the fonts used for the caption). However in future maybe caption's
package "skip" should be obeyed for "literalblock" caption type.

Fixes: 5520
 2018-11-13 23:55:11 +01:00
jfbu 994b0ea827 LaTeX: update date and version of sphinx.sty 2018-11-06 18:32:41 +01:00
Jean-François B c9999b1208 Merge pull request #5583 from jfbu/5579_style_index_entries 
LaTeX: add styling to general index, similar to domain indices
 2018-11-06 18:12:19 +01:00
jfbu 00a75b2742 LaTeX: deprecate optional argument scre to visit_index() 
And it is already ignored.
 2018-11-04 21:48:35 +01:00
jfbu 0f45cf75b3 LaTeX general index: also style "extras" in triple entries 2018-11-01 11:41:19 +01:00
jfbu 4df3b067b7 LaTeX: add styling to general index, similar to domain indices 
Closes: #5579. Also closes #5576.
 2018-10-31 19:22:34 +01:00
Jean-François B 47bd24e7d2 Merge pull request #5574 from jfbu/5561_remove_unneeded_xindy_option 
LaTeX: do not use `-I xelatex` option with xindy (Fix: #5561)
 2018-10-31 18:45:48 +01:00
Jean-François B cc45e560a7 Merge branch '1.8' into 5561_remove_unneeded_xindy_option 2018-10-31 18:44:37 +01:00
jfbu a695099a1b LaTeX: do not use -I xelatex option with xindy (Fix: #5561) 
It is not supported by old xindy (TeXLive 2013 or earlier), and probably
irrelevant anyhow as the .idx file should not have ^^ab or ^^^^abcd
entries.
 2018-10-30 17:57:33 +01:00
jfbu f4d7b2e60e Fix invalid escape sequence \d in test (refs #5513) 2018-10-30 17:47:59 +01:00
Jean-François B 9875a57622 Merge pull request #5513 from jfbu/3704_latex_figure_labelpos 
Fix #3704: (latex) wrong ``\label`` positioning for figures with a legend
 2018-10-07 12:09:18 +02:00
jfbu 7ab09b5065 Fix #3704: wrong `\label` positioning for figures with a legend 2018-10-07 10:16:11 +02:00
jfbu 6f08c09ecb Improve Table of Deprecated APIs for LaTeX output (docs) 2018-09-22 11:44:04 +02:00
jfbu b87d339b72 Fix typo in make.bat template help string, update help strings 
modified:   sphinx/templates/quickstart/Makefile_t
	modified:   sphinx/templates/quickstart/make.bat_t
 2018-09-20 22:58:54 +02:00
Jean-François B e4c6963325 Merge pull request #5455 from jfbu/5453_PDF_howto_pagenumbers 
Fix #5453 and move LaTeX ``\pagestyle`` to template
 2018-09-20 20:32:25 +02:00
jfbu 94bb3e3057 Update CHANGES for #5455 2018-09-20 19:58:06 +02:00
jfbu 6f62c50557 Merge branch '1.8' into 5453_PDF_howto_pagenumbers 2018-09-20 19:56:51 +02:00
jfbu f1b7969a8c Fix #5453 and move LaTeX `\pagestyle` to template 2018-09-18 20:52:08 +02:00
jfbu 8a23ad1f44 Update LaTeX docs for a 1.7.6 change (refs #5178) 2018-08-02 12:46:33 +02:00
jfbu 5a220d648a Fix LaTeX docs of Latin Modern font with XeLaTeX/LuaLaTeX 
refs: #5251
 2018-08-02 10:06:31 +02:00
Jean-François B 53ea40555f Merge pull request #5245 from jfbu/latex_refactor_declareunicodecharacter 
LaTeX: streamline ``\DeclareUnicodeCharacter`` usage
 2018-08-01 18:27:11 +02:00
jfbu ee87338b0b LaTeX: streamline `\DeclareUnicodeCharacter` usage 2018-08-01 12:01:23 +02:00
jfbu 2dd35f6907 Update CHANGES 2018-07-31 19:24:51 +02:00
jfbu a281cdaf35 Update CHANGES for PR #5239 2018-07-31 19:16:37 +02:00
jfbu 69f21c144c Update CHANGES for PR #5235 2018-07-31 19:11:04 +02:00
Jean-François B 5edcb2850c Merge pull request #5239 from jfbu/latex_revert_5181_RTDbug_workaround 
Revert "LaTeX: extend to all projects the #3742 fix for PDF builds at RTD"
 2018-07-31 19:04:21 +02:00
Jean-François B 73a79549fa Merge pull request #5235 from jfbu/latex_fix_PAPER_envvar 
LaTeX: fix usage of PAPER envvar, which got broken at Sphinx 1.5
 2018-07-31 18:42:06 +02:00
Jean-François B b899bc7656 Merge pull request #5242 from jfbu/latex_xindy_checks_if_index_empty 
Let Latexmk check if idx file is empty before xindy call
 2018-07-31 18:00:36 +02:00
jfbu 077e9afd29 LaTeX: fix usage of PAPER envvar, which got broken at Sphinx 1.5 
Fix: #5234
 2018-07-31 17:37:04 +02:00
jfbu d07103fde2 Fix typo in updated docs 2018-07-31 17:11:59 +02:00
jfbu b8f43e56ae Update latex docs 2018-07-31 16:54:25 +02:00
jfbu e726073c87 Let Latexmk check if idx file is empty before xindy call 
Fix: #5240
 2018-07-31 12:27:35 +02:00
jfbu f0067f4a04 Revert "LaTeX: extend to all projects the #3742 fix for PDF builds at RTD" 
This reverts commit 9b2aac68ea.
 2018-07-31 10:46:48 +02:00
jfbu 8de8f087bd Merge branch '1.7' 2018-07-31 09:50:58 +02:00
jfbu 5ce05e2733 Fix updated CHANGES 2018-07-31 09:50:37 +02:00
jfbu dc3db45550 Merge branch '1.7' 2018-07-31 09:48:43 +02:00
jfbu cc6f0a26b1 Update CHANGES 2018-07-31 09:48:13 +02:00
Jean-François B bb2ca12331 Merge pull request #5237 from jfbu/latex_avoid_remreset_warning 
LaTeX: avoid "The remreset package is obsolete" warnings in latex log
 2018-07-31 09:43:19 +02:00
jfbu f5e38f4010 LaTeX: avoid "The remreset package is obsolete" warnings in latex log 2018-07-31 09:27:55 +02:00
jfbu 50cf7842f6 Merge branch '1.7' 2018-07-30 23:45:46 +02:00
Jean-François B e955bccf2b Merge pull request #5236 from jfbu/latex_reduce_hyperref_warnings 
Latex reduce hyperref warnings
 2018-07-30 23:43:18 +02:00
jfbu 685b680295 LaTeX: update date of Sphinx LaTeX style file 2018-07-30 19:54:38 +02:00
jfbu 3bdf67a6b4 LaTeX: reduce hyperref warnings related to PDF bookmarks 2018-07-30 19:54:38 +02:00
jfbu 9a0097bef2 Update LaTeX xindy docs 2018-07-30 19:52:12 +02:00
Jean-François B c43986dbbf Merge pull request #5192 from jfbu/latex_xindy_cyrillic_latin 
LaTeX: for Cyrillic and with xindy, get Latin letter groups too
 2018-07-25 15:48:39 +02:00
Jean-François B dbb2d13406 Merge pull request #5212 from jfbu/latex_xindy_fix_latin 
Latex xindy fix latin
 2018-07-25 15:36:01 +02:00
jfbu d8b90fcd66 renamed: sphinx-isolatin.xdy -> LatinRules.xdy 2018-07-24 09:22:18 +02:00
jfbu 5193c2aa22 LaTeX: index Latin names with diacritics in Cyrillic documents 2018-07-24 09:22:08 +02:00
jfbu 34ec2e3fb9 Merge branch 'latex_xindy_fix_latin' into latex_xindy_cyrillic_latin 2018-07-24 09:21:52 +02:00
jfbu b3d89f9417 LaTeX: add xindy merge rules for TeX-escaped Greek letters 
The effect is that indexed Greek letters are sorted with uppercase Greek
letters before lowercase Greek: ΓΔΘ...αβγ...; without this commit the
Greek letters are ordered according to the ascii characters used in the
TeX control sequences as set-up in sphinx.util.texescape, i.e. the order
is αβχΔδεηΓγ... In both cases indexed terms starting with such a Greek
letter end up in the same group as terms starting with a non-letter.

This commit does not create letter-groups for Greek letters, as such
letter-groups would require to make sure non-escaped letters such as α
are accepted by TeX engine, and this requires extra-steps for pdflatex (or
OpenType font with Greek script for xelatex/lualatex), and if those
steps were made default by Sphinx, there would not be a reason anymore
to escape via sphinx.util.texescape the Greek letters from rest source.
 2018-07-24 09:20:13 +02:00
jfbu 5aca2031c5 LaTeX: add xindy merge rules for superior and inferior figures 2018-07-24 09:20:13 +02:00
jfbu aa424e9003 LaTeX: correct usage of xindy with Latin scripts (refs: #5134) 2018-07-24 09:20:08 +02:00
jfbu c2a396c776 LaTeX: for Cyrillic and with xindy, get Latin letter groups too 
Refs: #5134
 2018-07-18 00:07:12 +02:00
jfbu e584b8e1db Update LaTeX docs 2018-07-17 15:45:30 +02:00
Jean-François B 6f4e377ae7 Merge pull request #5181 from jfbu/3742_index_in_PDF_bookmark_at_RTD 
LaTeX: extend to all projects the #3742 fix for PDF builds at RTD
 2018-07-17 15:31:38 +02:00
jfbu fd3e7a56c3 LaTeX: Fix #5134 Lisp syntax for some xindy merge-rule patterns 2018-07-17 11:59:28 +02:00
Jean-François B 54456ba455 Merge branch 'master' into 3742_index_in_PDF_bookmark_at_RTD 2018-07-16 17:15:45 +02:00
jfbu 9b31ee8d5e Fix an error in PR #5134 regarding handling of Cyrillic 2018-07-16 14:01:10 +02:00
Jean-François B 6c12dba968 Merge pull request #5134 from jfbu/latex_xindy 
Add new config value ``latex_use_xindy``
 2018-07-16 10:17:06 +02:00
Jean-François B 82a7a2235f Merge branch 'master' into latex_xindy 2018-07-16 09:26:23 +02:00
Jean-François B 276d1c26c4 Merge pull request #5135 from jfbu/5133_latex_index_itln 
Fix: #5133 via ``\sphinxsymbolsname``, ``\sphinxnumbersname``
 2018-07-16 09:21:21 +02:00
Jean-François B d35cb7e202 Merge pull request #5177 from jfbu/5176_latex_index_special_chars 
Fix #5176
 2018-07-16 09:13:52 +02:00
Jean-François B 3156981d09 Merge pull request #5178 from jfbu/4272_xelatex_use_babel_for_french 
LaTeX: for French and xelatex, use babel not polyglossia (fix: #4272, #5130)
 2018-07-16 09:05:25 +02:00
Jean-François B 379dfeff31 Merge branch '1.7' into 5176_latex_index_special_chars 2018-07-16 09:02:42 +02:00
jfbu fb45af7cde Rename macros for conformity with choices done at PR #5134 2018-07-16 01:57:40 +02:00
Jean-François B b5f36e7c34 Merge branch '1.7' into 4272_xelatex_use_babel_for_french 2018-07-16 01:38:56 +02:00
jfbu 768abe9b85 Update CHANGES for #5176 fix 2018-07-16 01:22:35 +02:00
jfbu 6f237096d4 LaTeX: fix indexing of terms containing " character 2018-07-16 01:19:06 +02:00
jfbu ef3447b0f9 LaTeX: fix indexing of terms containing ! character 2018-07-16 01:19:06 +02:00
jfbu bfad757e45 LaTeX: fix indexing of terms containing @ character 2018-07-16 01:19:06 +02:00
jfbu 3c3dca8203 Fix failed test (changed \sphinxleftcurlybrace) 2018-07-16 01:06:27 +02:00
jfbu 9b2aac68ea LaTeX: extend to all projects the #3742 fix for PDF builds at RTD 
Refs: https://github.com/rtfd/readthedocs.org/issues/2857
 2018-07-15 15:24:25 +02:00
jfbu 7b44adb048 Use xindy for Sphinx's own PDF documentation 
Makeindex gathered under heading "Symbols" all command line options,
this seems less satisfactory than index produced by xindy.
 2018-07-14 19:15:33 +02:00
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 799c0af6e8 LaTeX: for French and xelatex, use babel not polyglossia (fix: #4272) 2018-07-12 15:08:54 +02:00
jfbu a68d06a1da LaTeX: fix indexing of terms containing " character 2018-07-11 18:49:03 +02:00
jfbu 7166451dbd LaTeX: fix indexing of terms containing ! character 2018-07-11 18:49:03 +02:00