sphinx: включая файл.tex через raw:: latex

Question

Я хочу включить латекс док в сфинкс. Сборка sphinx html не содержит латексный файл, связанный с помощью .. raw:: latex директивы. я имею

это моя структура dir

docs/
    source/
        importlatex.rst
        index.rst

    build/
    tex/
       texfile.tex

index.rst похоже

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

Contents:

.. toctree::
   :maxdepth: 2

   icnludelatex
   and-other-stuff

icnludelatex.rst похоже:

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

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

эта ссылка дает пример для включения HTML

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

почему это происходит?

Answer 1

Когда вы используете raw директива, блок интерпретируется только связанным автором. Пример, .. raw:: latex работает, если вы генерируете LaTeX, но он невидим для HTML.

Вам нужен парсер для LaTeX, но при быстром поиске я нахожу парсеры только для markdown ( Recommonmark) и jupyter notebook ( nbsphinx).

Возможно, быстрое и грязное решение - преобразовать ваш латексный документ в первый, используя pandoc (вы можете потерять некоторый форматированный текст).

pandoc -s texfile.tex -o texfile.rst

а затем использовать include директива в вашем icnludelatex.rst,

.. include:: texfile.rst