47

ドキュメントを書いていますが、PDFファイルまたはzipアーカイブへのリンクを含めたいと思います。どうすれば最初の言語とスフィンクスを使用してそれを達成できますか?

私がそうするなら

here is a pdf file : `pdf <doc/mypdf.pdf>`_

コンパイル中にsphinxがdocディレクトリの内容をコピーしないため、機能しません(sphinx-quickstartによって生成されたmakefileを使用します)。

それどころか、imageディレクティブを使用します:

.. image:: img/plop.png

sphinxは、ビルドディレクトリにplop.pngイメージをコピーします。PDFまたはzipアーカイブで同じ動作を取得するにはどうすればよいですか?

4

2 に答える 2

69

:download:解決策は、 「ロール」を使用することです(ロールに関する sphinx ドキュメントで詳しく説明されています)。

mypdf.pdfディレクトリにファイルがあると仮定した短い例を次に示しますdoc。ディレクトリdocと最初のファイルは同じディレクトリにある必要があります。

here is a pdf file :download:`pdf <doc/mypdf.pdf>`

:download:とファイルへのパスの間に空白を入れてはならないことに注意してください。

于 2013-01-15T20:32:01.490 に答える