Sphinx latexpdf 忽略文件的一部分

Question

在使用latexpdf 构建pdf 时，是否可以让Sphinx 忽略index.rst 的一部分？

例如，我的 index.rst 文件包含（但不以）行

.. image:: https://img.shields.io/....
  :target: https://pypi.org/....

.. image::  https://travis-ci.org/....
  :target: https://travis-ci.org/...

.. image:: https://coveralls.io/repos/github/....
  :target: https://coveralls.io/github/....

.. image::  https://readthedocs.org/.....
  :target: https://libensemble.readthedocs.org/....

这些应该出现在构建的 html 中，而不是 PDF 中。我在这里什么都没看到： https://www.sphinx-doc.org/en/master/latex.html

是否可以让 sphinx 忽略这些行？

Answer 1

我认为你可以使用only directive:

• 在index.rst

 .. only:: html

     .. image::  https://readthedocs.org/.....
     :target: https://libensemble.readthedocs.org/....

• 在Makefile

 htmldoc:

    make -e SPHINXOPTS="-t html" html