2010-02-07 23 views
19

Piszę dokumentację z Sphinx i chcę wydrukować określony blok tekstu tylko dla dokumentacji HTML, a nie dla dokumentacji LaTeX. Coś mi mówi, że powinienem był to zrobić z sphinx.ext.ifconfig, ale nie wiem, jak to zrobić. Czy ktoś wie, jak to zrobić?Dane wyjściowe w dokumentacji Sphinx

Odpowiedz

25

Nie jest wymagane żadne rozszerzenie. Po prostu użyj only directive. Działa to tak:

 
.. only:: latex 

    The stuff in here only appears in the latex output. 

.. only:: html 

    The stuff in this block only appears in the HTML output. It's 
    often useful to use this directive with it: 

    .. raw:: html 

     It's good for embedding stuff, like video. 
+0

Czy możliwe jest rozróżnienie pomiędzy 'singlehtml' i' html'? – Carel

+0

@Carel tak, z Sphinx 1.2 i późniejszym można odróżnić 'html' od' singlehtml' przy użyciu jawnych znaczników budowniczych 'builder_html' i' builder_singlehtml'. – ddbeck

+0

Czy mógłbyś rzucić okiem na podobne pytanie. http://stackoverflow.com/questions/42798152/adding-custom-tag-in-sphinx – Learner

Powiązane problemy