IntenseWebs/sphinx
3
0
Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2025-02-25 18:55:22 -06:00
Code Issues Packages Projects Releases Wiki Activity

add option to control if inline literal word-wraps in latex

Browse Source
This commit is contained in:
jfbu 2016-11-05 16:43:13 +01:00
parent 2de1cd7fde
commit a50dfbab0c
2 changed files with 14 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
doc/latex.rst
View File

@ -151,6 +151,16 @@ Here are the currently available options together with their default values.
before or after, but this is accessible currently only by re-defining some before or after, but this is accessible currently only by re-defining some
macros with complicated LaTeX syntax from :file:`sphinx.sty`. macros with complicated LaTeX syntax from :file:`sphinx.sty`.
``inlineliteralwraps``
default ``true``. Allows linebreaks inside inline literals: but extra
potential break-points (additionally to those allowed by LaTeX at spaces
or for hyphenation) are currently inserted only after the characters ``. ,
; ? ! /``. Due to TeX internals, white space in the line will be stretched
(or shrinked) in order to accomodate the linebreak.
.. versionadded:: 1.5
set this option to ``false`` to recover former behaviour.
``verbatimvisiblespace`` ``verbatimvisiblespace``
default ``\textcolor{red}{\textvisiblespace}``. When a long code line is default ``\textcolor{red}{\textvisiblespace}``. When a long code line is
split, space characters located at end of the line before the break are split, space characters located at end of the line before the break are

3
sphinx/texinputs/sphinx.sty
View File

@ -85,6 +85,7 @@
% verbatim % verbatim
\DeclareBoolOption[true]{verbatimwithframe} \DeclareBoolOption[true]{verbatimwithframe}
\DeclareBoolOption[true]{verbatimwrapslines} \DeclareBoolOption[true]{verbatimwrapslines}
\DeclareBoolOption[true]{inlineliteralwraps}
% \textvisiblespace for compatibility with fontspec+XeTeX/LuaTeX % \textvisiblespace for compatibility with fontspec+XeTeX/LuaTeX
\DeclareStringOption[\textcolor{red}{\textvisiblespace}]{verbatimvisiblespace} \DeclareStringOption[\textcolor{red}{\textvisiblespace}]{verbatimvisiblespace}
\DeclareStringOption % must use braces to hide the brackets \DeclareStringOption % must use braces to hide the brackets
@ -243,7 +244,9 @@
% in 'alltt' \@noligs is done already, and the \scantokens must be avoided. % in 'alltt' \@noligs is done already, and the \scantokens must be avoided.
\long\protected\def\sphinxcode#1{{\def\@tempa{alltt}% \long\protected\def\sphinxcode#1{{\def\@tempa{alltt}%
\ifx\@tempa\@currenvir\else \ifx\@tempa\@currenvir\else
\ifspx@opt@inlineliteralwraps
\sphinxbreaksviaactive\let\sphinxafterbreak\empty \sphinxbreaksviaactive\let\sphinxafterbreak\empty
\fi
\@noligs\endlinechar\m@ne\everyeof{\noexpand}% \@noligs\endlinechar\m@ne\everyeof{\noexpand}%
\expandafter\scantokens \expandafter\scantokens
\fi {\texttt{#1}}}} \fi {\texttt{#1}}}}