ReST/Sphinx - 自動生成されたセクションURLへの静的エイリアス

Question

オンラインドキュメントを指すいくつかの「ヘルプ」ボタンが付いたWebアプリケーションがあります。ヘルプセクションへのリンクは、アプリケーションデータベースにハードコードされています。以前はHTMLとJSでドキュメントが作成されていて、手動でセクションへのURLを制御することができました。

しかし、私はSphinxとReSTに移行したので、自動セクションURLの生成は素晴らしいとわかりましたが、自分の構造のこの動作を制御する方法を理解できません。

私のチャプター/セクションの名前を更新するたびに、アプリケーションdb内のハードコードされたリンクを更新しないために、ドキュメントの実際のURLを指し示すURLエイリアスを持つ方法がありますか？例えば

：

• 私はそれに私のハードコードリンク（ 「第1章＃はI様のりんご」のようなものになるだろう第1章
• に「私はりんごが好き」と呼ばれるサブセクションを持っています私は＃ 記号の次の部分のみを気にしています）
• タイトルを「私はリンゴが嫌いです」に変更します。新しいリンクは「Chapter1＃I-hate-apples」になりますが、dbでは同じセクションを指し示す「＃I様リンゴ」が必要です。

Answer 1

docutilsドキュメントのHyperlink Targets（具体的には「内部ハイパーリンクターゲット」）を参照してください。

.. _my-target: 
.. _synonym-to-my-target: 

My Subsection 
------------- 

スフィンクスは、各同義語のターゲットを生成します。

間接的なハイパーリンクターゲットを作成することもできます。

.. _my-target: synonym-to-my-target_ 
.. _synonym-to-my-target: 

My Subsection 
-------------