Как сделать ссылку из документа Sphinx в файл CHM?

Вы знаете, что открыть тему, скомпилированную в CHM, можно только в Microsoft Internet Explorer (!), Добавив следующий код в HTML-файл:

<p>Sample of CHM link to a topic in a compiled help file that is stored on a local computer</p>
<!-- To link to a topic in a compiled help file that is stored on a local computer, create a link using the following syntax:  -->
<A HREF="ms-its:D:\UserData-Sphinx\CHM-example.chm::/garden/garden.htm">Link to Garden topic here</a>

Думаю, парсер reStructuredText не может передавать эти особые ссылки из источника (reST).

Но вы можете использовать Replacement Text, как показано ниже. Обратите внимание, что обратная косая черта используется дважды:

================
Replacement Text
================

I recommend you try |HTMLHelp|_ and continue compiling help in CHM file format.

.. |HTMLHelp| replace:: CHM, *the* best help format around
.. _HTMLHelp: ms-its:D:\\UserData-Sphinx\\CHM-example.chm::/garden/garden.htm

Директива replace используется для указания текста замены для ссылки на замену. Его можно использовать только в определениях замены.

Полученное представление файла HTML:

Скомпилированная справка CHM:

Тема garden.htm отображается на панели тем средства просмотра справки после нажатия ссылки:

Вы можете загрузить использованный выше CHM-example.chm файл с моего информационного сайта HTMLHelp (HH) см. Раздел загрузки или загрузите CHM.

Обратите внимание: чтобы открыть этот файл CHM, щелкните сохраненный файл правой кнопкой мыши, выберите «Свойства», а затем нажмите «Разблокировать».