python-sphinx：通过raw :: latex包含.tex文件

我想在狮身人面像中包含乳胶文档. 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

为什么会这样呢？

解决方法:

使用原始指令时,该块仅由关联的编写器解释.例如,.. 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

标签：python-sphinx,docstring,latex,python
来源： https://codeday.me/bug/20191111/2018003.html