3

各アイテムが以下の対応するテキストへのリンクであるreStructuredTextで番号付きリストを作成するにはどうすればよいですか？たとえば、「FAQ」ページで使用する場合、質問はハイパーリンクとしてリストされ、番号が付けられ、各質問のリンクはページの下の回答につながります。例えば：

1. question 1 [links to #1 below]
2. question 2 [links to #2 below]
3. question 3 [links to #3 below]
4. ...

#1 question 1:
the answer to question 1

#2 question 2:
the answer to question 2

#3 question 3:
the answer to question 3

HTMLでは、これはとシンボルで行うことができますhrefsが#、同等のreStructuredText構文は何ですか？

4

2 に答える 2

5

最初の良い例はDocutilsFAQです（reStructuredTextはDocutilsと一緒に開発され、Sphinxは単にDocutilsの拡張です）。ここでFAQは、セクションの見出しと目次ディレクティブを使用して簡単に作成されます（ページ下部のreStructuredTextソースのリンクを参照してください）。

コメントで、ページにすでに目次があると言っているので、FAQセクションのローカルにある2番目の目次が必要です。これは、ディレクティブの:local:オプションを使用して実行できます。contents次の例を試して、このローカル目次の動作を確認してください。

=======================================
Testing the inclusion of an FAQ section
=======================================

.. contents:: Table of Contents
   :depth: 1

Some uninteresting section
==========================

with some text...

FAQ
===

.. contents::
  :local:
  :backlinks: none
  :depth: 1

Question 1
----------

Lorem ipsum dolor sit amet...

Question 2
----------

Suspendisse tortor tellus...

Question 3
----------

Mauris in magna sed arcu semper auctor vitae eu risus...

Some other uninteresting section
================================

with some text...
于 2012-06-03T23:02:54.950 に答える
3

「restructuredtextlist」については、最初のGoogle検索結果の列挙リストと内部ハイパーリンクターゲットを参照してください。これらを次のように組み合わせることができます。

#. `question 1`_
#. `question 2`_

.. _question 1:
the answer to question 1

コメントごとの後方参照には、「インライン内部ターゲット」を使用できます。これは、クイックリファレンスで言及されていますが、実際には完全なリファレンスのみで説明されています。残念ながら、同じテキストをリンクとターゲットの両方にすることは不可能のようです（構文で技術的に許可されていても、あいまいになります）。そのため、リスト項目には質問だけでなく多くのテキストが必要になります。最善の方法は、各質問を特定のリストアイテムではなく、リストにリンクすることです。たとえば、

.. _List of questions:
...

.. _question 1:
the answer to question 1
`List of questions`_
于 2012-06-02T01:03:38.037 に答える