sphinx：通过 raw::latex 包含 .tex 文件答案

【问题标题】：sphinx: Including .tex file via raw:: latexsphinx：通过 raw::latex 包含 .tex 文件
【发布时间】：2017-07-12 17:39:56
【问题描述】：

我想在 sphinx 中包含乳胶文档。 sphinx html 构建不包括使用 .. raw:: 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

为什么会这样？

【问题讨论】：

【解决方案1】：

当您使用raw 指令时，该块仅由相关的writer 解释。例如，.. raw:: latex 在您生成 LaTeX 但它对 HTML 不可见的情况下有效。

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

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

pandoc -s texfile.tex -o texfile.rst

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

.. include:: texfile.rst

【讨论】：