Bagaimana cara menambahkan tautan ke halaman lain di reStructuredText? [duplikat]

Saya menggunakan Sphinx untuk membuat dokumentasi proyek saya, tetapi saya kesulitan memahami konsep dasar tentang RST.

Jadi saya punya proyek dasar dengan index.rst dan saya menggunakan sphinx-rtd-theme untuk menatanya. Jadi saya membuat html dan di sebelah kiri saya memiliki menu, seperti di sini. Sekarang saya membuat halaman baru untuk dokumentasi, dan file pertama bernama auth.rst.

Yang saya tidak mengerti adalah bagaimana cara menambahkan link ke halaman lain seperti auth.rst di menu samping sebelah kiri? Saat ini, saya memiliki dua tautan di menu itu: Selamat datang di dokumentasi Test-API! dan Indeks dan tabel, bagaimana cara menambahkan tautan baru ke halaman lain dokumentasi saya? Saya tidak mengerti di mana hal ini didefinisikan dalam kode di bawah dan saya tidak menemukan banyak tentang ini

Welcome to Test-API's documentation!
================================

.. toctree::
   :maxdepth: 2
   :caption: Contents:



Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

python python-sphinx restructuredtext
person JayK23    schedule 09.02.2021    source sumber

Jawaban (1)


arrow_upward
1
arrow_downward

Di bawah ':caption ...' Anda menulis jalur relatif (dari mana file RST ini ada di disk) ke target pertama (auth.rst dalam kasus Anda)

Contoh, mengingat struktur folder ini:

RST
  |- a.rst
  |- b.rst
  |-folder2 
    |-c.rst
    |-d.rst

Di a, jika saya ingin mereferensikan b dan c, saya dapat memiliki:

.. toctree::
   :maxdepth: 2
   :caption: Contents:
   b
   folder2/c

Dan jika saya ingin mereferensikan d dari c, saya akan melakukan ini di c:

.. toctree::
   :maxdepth: 2
   :caption: Contents:
   d
person CowKeyMan    schedule 09.02.2021