Fichiers d'aide de Windows - quelles sont les options?

Je n'aime pas l'option html, et je suis passé du HTML simple au CHM en les compressant et en les indexant. Même les utiliser sur une poignée de clients Non-Windows même. Il a simplement résolu le petit Bris constant de personnes le mettant sur le réseau (profondeur de nidification limitée, étranges effets de verrouillage), antivirus qui est mort dans les répertoires avec 30000 fichiers html, et 20 minutes de temps de décompression lors de l'installation sur un système plus ancien, les zones de sécurité du navigateur et les fonctionnalités, les mauvais calculs de nécessaire place dans l'installateur etc.

Et puis je ne comprend même pas les gens qui commencent la "correction", 3e partie du produit défectueux "l'intégration" des tentatives etc, les plaintes concernant slowliness (démarrage du navigateur)

nous avions tous attendu pendant des années que les problèmes disparaissent à mesure que les os et le matériel s'amélioraient, mais les problèmes continuaient de se répéter dans un nombre éblouissant de variétés et assez était suffisant. Nous avons trouvé chmlib, et avons décidé que nous pourrions utiliser pour toujours quelque chose basé sur ce comme s'échapper avec un simple lecteur externe,si L'OS fourni a cessé de fonctionner et commuté.

en attendant nous avons aussi un propre compilateur,donc nous sommes à l'épreuve du futur DE MS free. Cela ne veut pas dire que nous ne changerons jamais (les solutions avec des serveurs Web locaux semblent préférées de nos jours), mais au moins nous avons le choix.

notre logiciel est à la fois distribué localement aux clients et servi à partir d'un réseau partagé. Nous avons choisi de générer à la fois un fichier CHM et un ensemble de fichiers HTML pour servir à partir du réseau. Les utilisateurs qui démarrent le programme localement utilisent le fichier CHM, et les utilisateurs qui reçoivent leur programme à partir d'un partage réseau doivent utiliser les fichiers HTML.

Nous utilisons Aide et Manuel et peut donc facilement produire les deux types de résultats à partir du même projet source. Les fichiers HTML contiennent aussi les capacités de recherche et ne nécessite pas un serveur web, donc bien que ce ne soit pas une solution optimale, fonctionne très bien.

Jusqu'à présent, tous les types de fichiers uniques pour Windows semblent cassés d'une manière ou d'une autre:

• WinHelp - rendu obsolète
• HtmlHelp (CHM) - obsolète sur Vista, ne fonctionne pas à partir du partage de réseau, Autre que cela fonctionne vraiment bien
• Microsoft Help 2 (HXS) - cela semble fonctionner jusqu'au point où il n'est pas, index corrompus ou similaire, Ceci est utilisé par Visual Studio 2005 et ci-dessus, comme exemple

si vous ne voulez pas utiliser un installateur et que vous ne voulez pas que l'utilisateur effectue des étapes supplémentaires pour autoriser les fichiers CHM sur le réseau, pourquoi ne pas revenir à WinHelp? Vista n'inclut pas WinHlp32.exe hors de la boîte, mais c'est disponible gratuitement en téléchargement pour Vista et Server 2008.

cela dépend de comment importer la documentation en ligne est à votre produit, une bonne infrastructure de documentation peut être complexe à établir, mais une fois fait, il paie. Voici comment nous le faisons -

• sources de l'Aide DITA compilant XML, stocké dans SCC (ClearCase).
• aide à éditer XMetal
• Aider à la compilation, personnalisé Open DITA Toolkit, avec prétraitement Perl/Java personnalisé
• sources de l'Aide de la croix références demandes de ressources au moment de la compilation .Les fichiers RC etc
• aide produits livrables à partir d'une seule source, PDF, CHM,Eclipse Help, HTML.
• le dépôt source unique produit de l'aide pour plusieurs produits 10+ avec des milliers de sujets partagés.

à partir de ce que vous décrivez, je regarderais L'aide Eclipse, ce n'est pas simple à intégrer dans les applications .NET ou MFC, vous avez essentiellement à faire la cartographie d'aide pour résoudre la demande à une URL alors Lancez L'URL de L'enveloppe D'aide Eclipse ou d'un navigateur.

Est la question de savoir comment générer vos propres fichiers d'aide, ou quel est le meilleur format de fichier d'aide?

personnellement, je trouve le CHM excellent. L'une des premières choses que je fais lors de la configuration d'une machine est de télécharger le Manuel PHP au format CHM (http://www.php.net/download-docs.php) et ajouter un raccourci clavier dans Crimson Editor. Ainsi, lorsque j'appuie sur F1, il charge le CHM et effectue une recherche pour le mot sur lequel mon curseur est activé (idéal pour une fonction de référence rapide).

si vous faites "just extract and run", vous allez avoir des problèmes de sécurité. Ceci est particulièrement vrai si vous êtes des utilisateurs qui exécutent Vista (ou plus tard). y a-t-il une raison pour laquelle vous vouliez éviter d'empaqueter vos applications dans un installateur? L'utilisation d'un installateur soulagerait le problème des "sources externes". Vous serez en mesure d'utiliser .fichiers chm sans aucun problème.

Nous utilisons InstallAware pour créer nos paquets d'installation. Ce n'est pas bon marché, mais c'est très bon. Si le coût est votre préoccupation, WIX est open source et assez robuste. WIX a une courbe d'apprentissage, mais il est facile de travailler avec.

PDF A l'inconvénient d'exiger le lecteur Adobe

j'utilise Foxit Reader sur les fenêtres à la maison et au travail. Beaucoup plus petit et très rapide à ouvrir. Très pratique lorsque vous vous demandez ce qui exactement a80000326.pdf est et pourquoi il bloque votre dossier de documents.

je pense que la solution que nous allons trouver pour notre application est d'héberger les fichiers d'aide nous-mêmes. Cela nous donne un accès immédiat aux fichiers et la possibilité de les tenir à jour.

ce que je prévois, c'est de charger le contenu dans une énorme série de fichiers XML, chacun contenant de l'aide pour un élément spécifique. Ce XML contiendrait des liens vers d'autres fichiers XML. Nous utiliserions XSLT pour afficher le contenu au besoin.

en Fonction de la licence, nous pouvons créer un fichier XSLT spécifique au client afin d'adapter l'apparence et la sensation à ce dont ils ont besoin. Nous pouvons avoir besoin de montrer l'aide seulement pour des versions particulières de notre produit aussi bien et cela peut être fait en filtrant des trucs dans le XSLT.

J'utilise un paquet commercial appelé AuthorIT qui peut générer un certain nombre de formats différents, tels que chm, html, pdf, word, Windows help, xml, xhtml, et quelques autres dont je n'ai jamais entendu parler (dita sonne-t-il une cloche?). Il s'agit d'un système de gestion du contenu orienté vers les besoins des rédacteurs de documentation technique. L'avantage est que vous pouvez utiliser et de réutiliser le même contenu pour créer un ensemble de guides et de générer dans différents formats.

donc le résultat relatif à la question de choisir chm ou html ou quoi que ce soit est que si vous utilisez ce que vous n'êtes pas verrouillé dans un format donné, mais vous pouvez fournir plusieurs parmi lesquels l'utilisateur peut choisir, et vous pouvez même ajouter plus de formats au fur et à mesure, sans frais supplémentaires.

si vous n'avez qu'un seul guide à créer, il n'en vaudra pas la peine, mais si vous avez un ensemble de documentation à gérer, alors c'est le meilleur à ma connaissance. Leur soutien est également très utile.