web-dev-qa-db-ja.com

スフィンクスで最初にファイルへのリンクを行う方法は?

私はドキュメントを書いており、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アーカイブで同じ動作を得るにはどうすればよいですか?

31
Ger

sphinxドキュメント で解決策を見つけました。

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

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

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

46
Ger

imageディレクティブは、PDFファイルに対しても機能します。

.. image:: doc/mypdf.pdf
0
Henrik