<feed xmlns='http://www.w3.org/2005/Atom'>
<title>delta/python-packages/sphinx-git.git/sphinx/texinputs, branch v2.4.3</title>
<subtitle>github.com: sphinx-doc/sphinx.git
</subtitle>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/'/>
<entry>
<title>Close #7115: LaTeX: Allow to override LATEXOPTS and LATEXMKOPTS via envvars</title>
<updated>2020-02-08T15:27:56+00:00</updated>
<author>
<name>Takeshi KOMIYA</name>
<email>i.tkomiya@gmail.com</email>
</author>
<published>2020-02-08T15:27:56+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=46e58d3989d692e4c5501c3bad7a56a0c28d06aa'/>
<id>46e58d3989d692e4c5501c3bad7a56a0c28d06aa</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>LaTeX: avoid quotes and TeX ligature replacements in PDF output</title>
<updated>2019-12-15T13:19:50+00:00</updated>
<author>
<name>jfbu</name>
<email>jfbu@free.fr</email>
</author>
<published>2019-12-05T17:19:38+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=30b26dd6a12de641776d871f9291de556de093fd'/>
<id>30b26dd6a12de641776d871f9291de556de093fd</id>
<content type='text'>
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
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
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
</pre>
</div>
</content>
</entry>
<entry>
<title>Merge branch '2.2.2' into 2.0</title>
<updated>2019-12-02T16:19:02+00:00</updated>
<author>
<name>Takeshi KOMIYA</name>
<email>i.tkomiya@gmail.com</email>
</author>
<published>2019-12-02T16:19:02+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=7292ab7eef7d540be2dd0532b07bfe016a4149a1'/>
<id>7292ab7eef7d540be2dd0532b07bfe016a4149a1</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>LaTeX: avoid ragged line endings in case of multi-line author display</title>
<updated>2019-11-30T22:49:57+00:00</updated>
<author>
<name>jfbu</name>
<email>jfbu@free.fr</email>
</author>
<published>2019-11-30T22:47:31+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=204c230c7325fdd939635b5b35675a19ace4113f'/>
<id>204c230c7325fdd939635b5b35675a19ace4113f</id>
<content type='text'>
Closes #6876
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Closes #6876
</pre>
</div>
</content>
</entry>
<entry>
<title>Fix typo in LaTeX code comment</title>
<updated>2019-11-22T20:23:07+00:00</updated>
<author>
<name>jfbu</name>
<email>jfbu@free.fr</email>
</author>
<published>2019-11-22T20:23:07+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=d9bd9c40985ac869990e0ef807252220fad2d9e5'/>
<id>d9bd9c40985ac869990e0ef807252220fad2d9e5</id>
<content type='text'>
	modified:   sphinx/texinputs/sphinxmulticell.sty
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
	modified:   sphinx/texinputs/sphinxmulticell.sty
</pre>
</div>
</content>
</entry>
<entry>
<title>Fix #4186: LaTeX: Support upLaTeX as a new latex_engine (experimental)</title>
<updated>2019-11-17T08:37:48+00:00</updated>
<author>
<name>Takeshi KOMIYA</name>
<email>i.tkomiya@gmail.com</email>
</author>
<published>2019-11-17T08:37:48+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=c6f0eb215a234eef4163d20477a49877eb8fe11e'/>
<id>c6f0eb215a234eef4163d20477a49877eb8fe11e</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Trim possibly erroneous comment from Sphinx LaTeX code</title>
<updated>2019-11-15T08:46:23+00:00</updated>
<author>
<name>jfbu</name>
<email>jfbu@free.fr</email>
</author>
<published>2019-11-11T10:05:37+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=b6cb5dd2191f93b56febd40f0366108ef85f1759'/>
<id>b6cb5dd2191f93b56febd40f0366108ef85f1759</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>LaTeX: fix #6809</title>
<updated>2019-11-15T08:46:23+00:00</updated>
<author>
<name>jfbu</name>
<email>jfbu@free.fr</email>
</author>
<published>2019-11-11T09:11:34+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=53ead2a0d9cbd0ab63eca2272ff51a913a9cc153'/>
<id>53ead2a0d9cbd0ab63eca2272ff51a913a9cc153</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>LaTeX: fix #6804</title>
<updated>2019-11-10T11:58:47+00:00</updated>
<author>
<name>jfbu</name>
<email>jfbu@free.fr</email>
</author>
<published>2019-11-09T17:52:21+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=d247299a884b3d3826a9941d1b63cc611b12fcd7'/>
<id>d247299a884b3d3826a9941d1b63cc611b12fcd7</id>
<content type='text'>
In case a code-block is in an environment already using the "framed"
package, measure the vertical size needed for the code lines and use a
nested "framed" only if short enough (i.e. at most 90% of text area on a
page).

Long nested contents will drop the inner frame. They lose the background
color as well as the continuation hints across pagebreaks. But the
caption if present is typeset normally. And highlighted lines and line
numbers are rendered with no alteration.

Short nested contents (should) render exactly as before this commit:
they use "framed" but this must be encapsulated in an unbreakable
"minipage". All decoration including caption are obeyed but of course
not the continuation hints are these never apply.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
In case a code-block is in an environment already using the "framed"
package, measure the vertical size needed for the code lines and use a
nested "framed" only if short enough (i.e. at most 90% of text area on a
page).

Long nested contents will drop the inner frame. They lose the background
color as well as the continuation hints across pagebreaks. But the
caption if present is typeset normally. And highlighted lines and line
numbers are rendered with no alteration.

Short nested contents (should) render exactly as before this commit:
they use "framed" but this must be encapsulated in an unbreakable
"minipage". All decoration including caption are obeyed but of course
not the continuation hints are these never apply.
</pre>
</div>
</content>
</entry>
<entry>
<title>LaTeX: Allow linebreaks at \ (in literals, code-blocks, parsed-literal)</title>
<updated>2019-11-06T17:59:09+00:00</updated>
<author>
<name>jfbu</name>
<email>jfbu@free.fr</email>
</author>
<published>2019-11-06T17:42:52+00:00</published>
<link rel='alternate' type='text/html' href='http://git.baserock.org/cgit/delta/python-packages/sphinx-git.git/commit/?id=a550c7075fcbeb9bcb37ec5546a42f811bb2ee1d'/>
<id>a550c7075fcbeb9bcb37ec5546a42f811bb2ee1d</id>
<content type='text'>
Default configuration is to allow the linebreak after the backslash.
It is possible at user side via 'preamble' key and some LaTeX code
to allow the linebreak before the backslash, but each of inline-literal,
code-block, and parsed-literal has its more or less cumbersome way for
that.

Closes: #6000, #6001

This commit handles only the \ character, which had been left aside
by accident so far. Inline-literals could break at more characters
but this is not yet done in this commit. In this context, in future
it could be useful to modify sphinx.util.texescape to use mark-up
such as \sphinxtextbackslash rather than naked \textbackslash and
similarly for some other characters. This could then be used to
allow linebreaks even in regular text paragraphs.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Default configuration is to allow the linebreak after the backslash.
It is possible at user side via 'preamble' key and some LaTeX code
to allow the linebreak before the backslash, but each of inline-literal,
code-block, and parsed-literal has its more or less cumbersome way for
that.

Closes: #6000, #6001

This commit handles only the \ character, which had been left aside
by accident so far. Inline-literals could break at more characters
but this is not yet done in this commit. In this context, in future
it could be useful to modify sphinx.util.texescape to use mark-up
such as \sphinxtextbackslash rather than naked \textbackslash and
similarly for some other characters. This could then be used to
allow linebreaks even in regular text paragraphs.
</pre>
</div>
</content>
</entry>
</feed>
