sphinx: Einschließlich .tex Datei über roh :: Latex

Question

Ich möchte Latex Doc in Sphinx enthalten. sphinx html build enthält nicht die Latexdatei, die mit der .. raw:: latex Direktive verknüpft ist. Ich habe

das ist mein dir Struktur

docs/ 
    source/ 
     importlatex.rst 
     index.rst 

    build/ 
    tex/ 
     texfile.tex 

index.rst wie

Welcome to documentation! 
========================= 

Contents: 

.. toctree:: 
    :maxdepth: 2 

    icnludelatex 
    and-other-stuff 

icnludelatex.rst sieht wie folgt aussieht:

Include Latex 
============= 

.. raw:: latex 
    :file: ../tex/texfile.tex 

this reference gibt Beispiel für einschließlich html

.. raw:: html 
    :file: inclusion.html 

Warum passiert das?

Answer 1

Wenn Sie eine raw Direktive verwenden, wird der Block nur von Writer interpretiert. Beispiel: .. raw:: latex funktionieren, wenn Sie LaTeX generieren, aber für HTML nicht sichtbar sind.

Sie brauchen einen Parser für LaTeX, aber in einer schnellen Suche finde ich nur Parser für Markdown (recommonmark) und Jupyter Notebook (nbsphinx).

Vielleicht ist eine schnelle und schmutzige Lösung, konvertieren Sie Ihre Latex-Doc zu ersten mit Pandoc (Sie können einige formatierten Text verlieren).

pandoc -s texfile.tex -o texfile.rst 

Und beim nächsten Gebrauch der include Richtlinie in Ihrem icnludelatex.rst.

.. include:: texfile.rst