Comment puis-je lier un document sphinx dans un fichier chm?Comment lier un document sphinx dans un fichier chm?
Il semble que je pourrais créer un lien d'un fichier CHM dans un autre en utilisant une syntaxe comme
<a href="ms-its:path+filename.chm::/pagename.htm">
Est-il possible de transférer cela en commandes sphinx?
Vous savez, l'ouverture d'un sujet compilé dans un CHM est possible avec Microsoft Internet Explorer uniquement en ajoutant le code suivant dans un fichier 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>
Je pense, l'analyseur reStructuredText ne peut pas transférer ces spéciales type de lien de la source (reST).
Mais vous pouvez utiliser le Replacement Text comme indiqué ci-dessous. S'il vous plaît noter, la barre oblique inverse est utilisé deux fois:
================
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
La directive « remplacer » est utilisé pour indiquer le texte de remplacement pour une référence de substitution. Il peut être utilisé dans les définitions de substitution uniquement.
Le résultat affichage des fichiers HTML:
L'aide compilé CHM:
Le sujet garden.htm est présenté dans le volet de la rubrique d'aide Viewer après le lien a été cliqué:
Vous pouvez télécharger ci-dessus utilisé fichier CHM-example.chm de mes informations HTMLHelp (HH) Site see download section ou télécharger CHM.
Veuillez noter que pour ouvrir ce fichier CHM, cliquez avec le bouton droit sur le fichier enregistré, cliquez sur Propriétés, puis sur Débloquer.
Ça a l'air bien, mais ce serait génial d'avoir aussi une solution firefox. – tfv
Voulez-vous utiliser la commande de construction, par ex. 'make html' et un lien depuis un sujet HTML vers un sujet spécial' pagename.htm' de 'filename.chm'? OU voulez-vous utiliser 'make htmlhelp' et faire un lien depuis le module d'aide compilé (fichier CHM) résultant vers un sujet spécial' pagename.htm' dans un autre 'filename.chm'? –
Au final, je veux faire les deux: je veux avoir un concept qui permettrait d'utiliser pleinement les fichiers chm dans Sphinx, c'est-à-dire de les utiliser dans toutes les sorties possibles. En ce moment, je serais heureux si je pouvais en faire travailler un. – tfv