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。