1

定义列表上强制断行我要呈现在新结构化PDF文件有适当的换行符,使得:如何使胶乳/ PDF用新结构化

Keyword 
    Definition 

这与正确呈现阅读文档模板,但使用默认设置和make latexpdf时不会产生换行符。是否有一个简单的功能,我可以应用于此问题的conf.py的LaTeX输出选项?

注:我已经提交了TeX这个问题,并被告知尝试堆栈溢出。上面的代码片段应该是重现我的用例所需的最短代码。正如我所说,据我所知,这些是默认设置。我没有做出任何重大改变。缺少定义列表的换行符似乎是LaTeX pdf文件的预期输出。

回答

1

使用rinohtype Sphinx的PDF生成器可以很好地控制这些样式方面。默认样式表实际上在关键字和定义列表中的定义之间插入换行符。否则,生成的PDF样式与LaTeX构建器的输出非常相似。您可以创建自己的style sheet and template configuration,根据需要自定义PDF的外观。

(全面披露:我rinohtype的作者)

1

这是部分答案,以我的知识为限。我希望它能让你更进一步。

默认情况下,转换将粗体样式应用于术语,并且该术语的定义与术语和换行的内联换行在后续行中包含缩进。请参阅下面的屏幕截图,了解Pyramid文档的PDF输出示例。 PDF for Pyramid documentation

当你做make latexpdf调用两个处理器连续,转换的reST文件到一个LaTeX文件,然后通过pdflatex运行这些文件来生成PDF。

下面是在pyramid.tex第一步的第一项词汇出现什么:

\item[{ACE\index{ACE|textbf}}] \leavevmode\phantomsection\label{\detokenize{glossary:term-ace}} 
An \sphinxstyleemphasis{access control entry}. An access control entry is one element 
in an {\hyperref[\detokenize{glossary:term-acl}]{\sphinxtermref{ACL}}}. An access control entry is a three-tuple that 
describes three things: an \sphinxstyleemphasis{action} (one of either \sphinxcode{Allow} or 
\sphinxcode{Deny}), a {\hyperref[\detokenize{glossary:term-principal}]{\sphinxtermref{principal}}} (a string describing a user or 
group), and a {\hyperref[\detokenize{glossary:term-permission}]{\sphinxtermref{permission}}}. For example the ACE, \sphinxcode{(Allow, 
'bob', 'read')} is a member of an ACL that indicates that the 
principal \sphinxcode{bob} is allowed the permission \sphinxcode{read} against the 
resource the ACL is attached to. 

现在的问题归结为如何更改输出,以便它可以根据您的需要的样式。为此,您需要解析LaTeX customization上的Sphinx文档。如何做到这一点超出了我的理解。

0

可以实现与替代注入生胶乳代码。

Keyword 
    |br| Definition 

Keyword2 
    |br| Long definition long definition long definition long definition long 
    definition long definition long definition long definition long definition 
    long definition long definition long definition long definition long 
    definition long definition long definition long definition long definition 
    long definition long definition long definition long definition long 
    definition long definition long definition 


.. |br| raw:: latex 

     \mbox{}\newline 

这会产生在PDF:

enter image description here

注意,生胶乳代码没有注入到其他目标,只有目标latexpdf。