私はドキュメントを書いており、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アーカイブで同じ動作を得るにはどうすればよいですか?
sphinxドキュメント で解決策を見つけました。
以下は、ディレクトリdoc
にファイルmypdf.pdf
があると仮定した短い例です。ディレクトリdoc
と最初のファイルは同じディレクトリにある必要があります。
here is a pdf file :download:`pdf <doc/mypdf.pdf>`
:download:
とファイルへのパスの間に空白を入れてはいけないことに注意してください。
image
ディレクティブは、PDFファイルに対しても機能します。
.. image:: doc/mypdf.pdf