ReST/Sphinx - 자동 생성 섹션 URL에 대한 정적 별칭

Question

온라인 도움말을 가리키는 "도움말"버튼이있는 웹 애플리케이션이 있습니다. 도움말 섹션에 대한 링크는 앱 데이터베이스에 하드 코딩되어 있습니다. 이전에는 설명서가 HTML과 JS로 작성되었으므로 수동으로 섹션의 URL을 제어 할 수있었습니다.

그러나 Sphinx 및 ReST로 이전 했으므로 자동 섹션 URL 생성이 뛰어 났지만 내 구조에 대한이 동작을 제어하는 ​​방법을 알 수 없습니다.

내 챕터/섹션의 이름을 업데이트 할 때마다 응용 프로그램 db의 하드 코드 된 링크를 업데이트하지 않기 위해 내 설명서의 실제 URL을 가리키는 일종의 URL 별칭이있는 방법이 있습니까? 예를 들어

:

• 나는이 장에서 "나는 사과를 좋아한다"라는 조항 1.
• 그것은 내 하드 링크 ( "장 # I-같은-사과"같은 것 # 기호 다음 부분 만 신경 쓰고 있습니다.
• 제목을 '사과 싫어'로 변경합니다. 새로운 링크는 "Chapter1 # I-hate-apples"가 될 것이지만, db에서는 여전히 같은 섹션을 가리키는 # I-like-apples가 필요합니다.

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 
-------------