Création de fichier d'aide

Question

J'apprécierais quelques suggestions sur la création de fichiers d'aide (Win32).

Je sais comment utiliser un fichier d'aide existant, .chm ou .hlp à partir de C# ou Delphi ou autre. Le problème est, il ya toujours quelqu'un d'autre qui a été assez gentil pour me fournir ces fichiers :)

Maintenant, par où commencer?

J'ai essayé HelpScribble, cela fonctionne, mais je trouve qu'il manque un peu et je pourrais aussi bien utiliser TeX pour rendre mes fichiers d'aide. Microsoft HTML Workshop est un peu brut. La recherche d'autres outils renvoie trop de résultats.

Comment faites-vous les gars? Edition HTML manuelle en utilisant Vim/Dreamweaver. Des meilleures pratiques?

Answer 1

J'ai utilisé adobe robohelp dans un projet il y a deux mois. Je pense que cela donne de bons résultats.

Je vous le recommande.

Answer 2

J'ai utilisé robohelp pendant des années.

Tout va bien, mais le chemin d'accès au support et à la mise à niveau est perturbé. La technologie de base est également très datée.

Nous passons à MadCap flare http://www.madcapsoftware.com/products/flare/robohelp.aspx

Answer 3

Nous utilisons DocBook comme notre format d'aide sous-jacente. C'est essentiellement un sous-ensemble de XML conçu pour créer de la documentation. Nous utilisons Syntext Serna comme éditeur XML car il supporte WYSIWYG et l'édition en ligne de XML #includes.

Le grand avantage de l'utilisation de Docbook est qu'il peut être transformé dans d'autres formats en utilisant les modèles XSL fournis par le projet Docbook. Nous pouvons passer de Docbook à HTML, HTMLHelp et PDF (via XML-FO). La transformation vers les formats de mots MS basés sur XML est également théoriquement possible.

Obtenir du format DocBook dans un fichier CHM est aussi simple que:

1. exécuter les modèles XSL HTML-Aide sur la source XML en utilisant par exemple XSLTProc
2. compiler les fichiers HTML de sortie en utilisant HTML Help compilateur de Microsoft (HHC).