Question

我想在sphinx中包含latex doc。 sphinx html build不包含使用.. raw:: latex指令链接的latex文件。我有

这是我的目录结构

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

this reference给出了包含html

的示例

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

为什么会这样？

Answer 1

使用raw指令时，块仅由关联的 writer 解释。例如，.. raw:: latex在生成LaTeX时有效，但对HTML不可见。

你需要的是LaTeX的解析器，但在快速搜索中，我只找到markdown（recommonmark）和jupyter notebook（nbsphinx）的解析器。

也许，一个快速而肮脏的解决方案是使用pandoc将您的latex文档转换为rst（您可能会丢失一些格式化的文本）。

pandoc -s texfile.tex -o texfile.rst

然后在include中使用icnludelatex.rst指令。

.. include:: texfile.rst