标签：python-sphinx docstring latex python

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

本站声明： 1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享；
2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关；
3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关；
4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除；
5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。