sphinx/doc
jfbu 30b26dd6a1 LaTeX: avoid quotes and TeX ligature replacements in PDF output
Refs: #6890

The comma character is not TeX-escaped because it is frequent in general
text and escaping it would make the LaTeX output larger for only dealing
with the problem of the LaTeX-ligature of ,, into a single character.
And one there is problem with the commas in options to Verbatim from
PygmentsBridge.

The hyphen character is escaped (not in ids and URIs!) to
\sphinxhyphen{} for both Unicode and non-Unicode engines. This is needed
to work around hyperref transforming -- and --- from section titles into
EN DASH resp. EM DASH in PDF bookmarks.

https://github.com/latex3/hyperref/issues/112

Note to expert LaTeX users: if Sphinx latex user with xelatex has

- turned off Smart Quotes for some reason,

- but does want TeX ligatures and thus overrode Sphinx
latex_elements['fontenc'] default (since #6888) to this effect,

then this should be added to LaTeX preamble:

    \def\sphinxhyphen#1{-}% (\protected is now not needed)
    \let\sphinxhyphenforbookmarks\sphinxhyphen
2019-12-15 14:19:50 +01:00
..
_static Remove unnecessary encoding cookie from Python source files 2018-12-16 12:22:12 -08:00
_templates Merge pull request #5096 from tk0miya/update_docs 2018-06-21 01:29:42 +09:00
_themes/sphinx13 doc: avoid font-size when :mod: role in headings 2019-10-26 15:35:06 +09:00
development/tutorials Fix #6405: docs: wrong link 2019-06-01 01:24:57 +09:00
extdev LaTeX: avoid quotes and TeX ligature replacements in PDF output 2019-12-15 14:19:50 +01:00
man Close #5602: apidoc: Add `--templatedir` option 2019-06-16 13:39:21 +09:00
usage Fix documentation typo 2019-12-13 23:27:04 +01:00
authors.rst Fixup windows newlines. 2014-09-21 20:23:24 +02:00
changes.rst Use "any" role in changelog. 2014-09-19 13:18:29 +02:00
conf.py Fix docs of inheritance-diagram "parts" option 2019-03-19 01:19:29 +09:00
contents.rst Fix ToC (#5917) 2019-01-10 18:08:12 +01:00
develop.rst Add sphinxcontrib-beamer to list of extensions. 2019-12-09 11:06:23 +01:00
devguide.rst add devguide.rst as a file instead of symlink. 2016-12-18 10:06:30 +09:00
examples.rst Add "who uses it" page. 2008-06-23 12:35:22 +00:00
faq.rst docs: Update FAQ for github pages 2019-07-07 16:08:54 +09:00
glossary.rst doc: Add "extensions" to usage guide 2018-06-20 09:30:47 +01:00
intro.rst fix long line for doclinter 2019-10-26 17:21:57 +09:00
latex.rst Update 'fontenc' latex_elements key documentation 2019-12-07 12:27:21 +01:00
make.bat make.bat must follow #4097. 2018-06-17 15:24:23 +09:00
Makefile make: Default to Python 3 2018-06-21 15:11:35 +01:00
templating.rst doc: Fold lines by 80 columns 2019-05-30 01:07:05 +09:00
theming.rst doclinter: restrict by 90 columns 2019-05-26 10:53:53 +09:00