fichiers d'aide Windows - quelles sont les options?

voix
34

De retour dans l'ancien temps, l'aide n'a pas été trivial mais possible: générer un certain fichier .rtf funky avec des balises spéciales, exécutez par un compilateur, et vous avez obtenu un fichier WinHelp (.hlp) qui fonctionne vraiment bien.

Ensuite, Microsoft a décidé que WinHelp n'était pas plus branché et cool et sont passés à CHM, jusqu'au point qu'ils ont effectivement mis la hache WinHelp de Vista.

Maintenant, peut-être CHM gentil, mais tout le monde qui a essayé d'ouvrir un fichier CHM sur le réseau connaîtra la belle « Navigation à la page Web a été annulée » écran qui est causée par des restrictions de sécurité.

Bien qu'il existe des façons de faire CHM travailler hors réseau, c'est à peine un bon choix, parce que lorsqu'un utilisateur appuie sur le bouton d'aide qu'il veut aider et ne pas avoir à faire quelques réglages funky.

Bottom Line: Je trouve absolument CHM inutilisable. Mais avec WINHELP ne pas être une option plus non plus, je me demande quelles sont les alternatives, surtout quand il vient d'intégrer à ma demande (par exemple pour WinHelp et CHM il y a des fonctions qui vous permettent de passer directement à un sujet)?

PDF présente l'inconvénient de nécessiter l'Adobe Reader (ou l'un des plus légers que peu de gens utilisent). Je pourrais vivre avec cette vision que cela est une sorte de norme de nos jours, mais pouvez-vous dire de manière fiable pour accéder à une page donnée / ancre?

les fichiers HTML semblent être le meilleur choix, alors vous suffit de traiter avec les différents navigateurs (CSS) et d'autres choses.

Edit: Je cherche à créer mon propre fichiers d' aide. Comme je suis fan de « No Setup, il suffit d' extraire et exécuter » la philosophie, j'ai eu ce problème à plusieurs reprises dans le passé parce que beaucoup de mes utilisateurs vont l' exécuter en dehors du réseau, ce qui provoque exactement ce problème.

Donc, je suis à la recherche d'un moyen plus robuste et évolutive pour fournir de l'aide à mes utilisateurs sans avoir à coder un système d'aide différent pour chaque application que je fais.

CHM est un format très agréable, mais que la sécurité Stuff le rend inutilisable, comme un système d'aide est censé fournir une aide à l'utilisateur, et non pas pour générer encore plus de problèmes.

Créé 04/08/2008 à 11:43
source utilisateur
Dans d'autres langues...                            


10 réponses

voix
15

HTML serait le meilleur choix suivant, SEULEMENT SI vous les servir d'un serveur Web public. Si vous avez essayé de regrouper avec votre application, tous les fichiers (et des images (et les feuilles de style (et ...))) feraient CHM ressembler à un cadeau des dieux.

Cela dit, alors qu'en réalité, fourni dans le package d'installation, (au lieu d'être servi sur le réseau), j'ai trouvé les fichiers CHM à travailler bien.

OTOH, un autre écueil sur les fichiers CHM: Même si vous essayez d'ouvrir un fichier CHM sur un locale disque, vous pouvez tomber sur le bloc de sécurité si vous avez téléchargé d' abord de quelque part, parce que le fichier pourrait être marqué comme « venu de source externe » quand il a été obtenu.

Créé 04/08/2008 à 11:51
source utilisateur

voix
5

Je n'aime pas l'option html, et en fait déplacé de HTML brut à CHM par compression et de les indexer. Même les utiliser sur une poignée de clients non-Windows même. Il suffit de résoudre la petite rupture constante des gens qui mettent sur le réseau (profondeur d'imbrication limitée, des effets de verrouillage étranges), antivirus qui est mort dans des répertoires avec 30000 fichiers html, et 20 minutes de temps de décompression lors de l'installation sur un ancien système, les zones de sécurité du navigateur et caractéristiques, erreurs de calcul espace nécessaire dans le programme d'installation, etc.

Et puis, je ne comprends même pas les gens qui commencent à « corriger » les produits, 3e partie avec les tentatives « d'intégration » défectueux etc, les plaintes concernant la lenteur (navigateur de démarrage)

Nous avions tous attendu des années pour les problèmes à disparaître à mesure que les systèmes d'exploitation et de matériel améliorés, mais les problèmes récurrents dans un gardé nombre éblouira de variétés et était assez. Nous avons trouvé chmlib, et avons décidé que nous pourrions utiliser pour toujours quelque chose à partir de cette évasion comme un simple lecteur externe, si les OS fournis ont cessé de fonctionner et commutées.

Pendant ce temps, nous avons aussi un propre compilateur, donc nous sommes libres MS l'épreuve du futur. Cela ne signifie pas que nous ne changerons (solutions avec les serveurs web locaux semblent aujourd'hui favori), mais au moins nous avons un choix.

Créé 06/09/2009 à 01:03
source utilisateur

voix
3

Cela dépend de l'importation de la documentation en ligne est à votre produit, une bonne infrastructure de documentation peut être complexe à mettre en place, mais une fois fait, il est rentable. Voici comment nous le faisons -

  • Source d'aide DITA XML compilant, stocké dans SCC (ClearCase).
  • Aide pour l' édition XMetal
  • Compilation d'aide, personnalisé Ouvrir DITA Toolkit , avec Perl sur mesure pré - traitement / Java
  • Aide références croisées source applications ressources au moment de la compilation, les fichiers .rc etc
  • Aide Les livrables de source unique, PDF, CHM, Eclipse Help , HTML.
  • référentiel source unique produit d'aide pour plusieurs produits de 10 ans qui des milliers de sujets communs.

D'après ce que vous décrivez, je regarderais Eclipse aide, ce ne est pas simple à intégrer dans les applications .NET ou MFC, vous avez essentiellement à faire la cartographie de l'aide pour résoudre la demande à une URL puis tirer l'URL vers Eclipse wrapper d'aide ou d'un navigateur.

Créé 21/09/2008 à 01:11
source utilisateur

voix
3

Si vous ne souhaitez pas utiliser un programme d' installation et vous ne voulez pas l'utilisateur d'effectuer des étapes supplémentaires pour permettre aux fichiers CHM sur le réseau, pourquoi ne pas revenir à WinHelp? Vista ne comprend pas WinHlp32.exe hors de la boîte, mais il est disponible gratuitement en téléchargement pour les deux Vista et Server 2008.

Créé 04/08/2008 à 14:48
source utilisateur

voix
3

Notre logiciel est à la fois distribué localement aux clients et a servi d'un partage réseau. Nous avons opté pour générer à la fois un fichier CHM et un ensemble de fichiers HTML pour le service du réseau. Les utilisateurs à partir du programme utilisent localement le fichier CHM, et les utilisateurs à obtenir leur programme servi d'un partage réseau doit utiliser les fichiers HTML.

Nous utilisons aide et manuel et peut ainsi facilement produire les deux types de sortie du même projet source. Les fichiers HTML contiennent également des capacités de recherche et ne nécessite pas de serveur web, donc qu'il ne soit pas une solution optimale, fonctionne très bien.

Jusqu'à présent, tous les types un seul fichier pour Windows Semble cassés d'une manière ou d'une autre:

  • WinHelp - obsoleted
  • HtmlHelp (CHM) - Vista sur obsoleted, ne fonctionne pas de partage réseau, autre que cela fonctionne vraiment bien
  • Microsoft Help 2 (HXS) - cela semble fonctionner jusqu'à jusqu'au moment où il n'a pas, index corrompus ou similaires, il est utilisé par Visual Studio 2005 et au-dessus, à titre d'exemple
Créé 04/08/2008 à 12:02
source utilisateur

voix
3

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

Personnellement, je trouve CHM excellent. L' une des premières choses que je fais lors de la mise en place 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 pour dans Crimson Editor . Alors , quand j'appuyez sur F1 , il charge le CHM et effectue une recherche pour le mot mon curseur est sur (idéal pour référence de fonction rapide).

Créé 04/08/2008 à 11:52
source utilisateur

voix
2

Je pense que la solution que nous allons finir par aller avec pour notre application héberge l'aide nous fichiers. Cela nous donne un accès immédiat aux fichiers et la possibilité de les tenir à jour.

Ce que je prévois est d'avoir le contenu chargé dans une grande série de fichiers XML, chacun contenant de l'aide pour un élément spécifique. Cette XML contiendrait des liens vers d'autres fichiers XML. Nous utiliser XSLT pour afficher le contenu nécessaire.

En fonction de la licence, nous pouvons construire un fichier XSLT spécifique au client afin d'adapter l'apparence à ce dont ils ont besoin. Nous devrons peut-être être en mesure de montrer que l'aide pour les versions particulières de notre produit aussi bien et qui peut être fait en filtrant les choses dans le XSLT.

Créé 27/11/2008 à 21:39
source utilisateur

voix
2

PDF présente l'inconvénient de nécessiter l'Adobe Reader

J'utilise Foxit Reader sous Windows à la maison et au travail. Beaucoup plus petit et très rapide à ouvrir. Très pratique lorsque vous vous demandez ce que a80000326.pdf exactement est et pourquoi il est engorgent votre dossier de documents.

Créé 05/08/2008 à 19:55
source utilisateur

voix
2

Si vous faites « extraire juste et exécuter », vous allez courir dans les questions de sécurité. Cela est particulièrement vrai si vous êtes utilisateurs exécutent Vista (ou version ultérieure). est-il une raison pour laquelle vous vouliez éviter l'emballage de vos applications à l'intérieur d'un installateur? L'utilisation d'un programme d'installation atténuerait le problème « source externe ». Vous seriez en mesure d'utiliser des fichiers .chm sans aucun problème.

Nous utilisons InstallAware pour créer nos packages d' installation. Ce n'est pas pas cher, mais il 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.

Créé 04/08/2008 à 13:11
source utilisateur

voix
1

J'utilise un package commercial appelé AuthorIT qui peut générer un certain nombre de formats différents, tels que chm, html, pdf, word, windows aide, xml, xhtml, et quelques autres, je ne l'ai jamais entendu parler (ne sonne dita une cloche?). Il est un système de gestion de contenu orienté vers les besoins des rédacteurs de documentation technique. L'avantage est que vous pouvez utiliser et réutiliser le même contenu pour construire un ensemble de guides, puis les générer dans différents formats.

Ainsi, la ligne de fond par rapport à la question du choix CHM ou html ou tout ce qui est que si vous utilisez ce que vous n'êtes pas enfermé dans un format donné, mais vous pouvez fournir plusieurs parmi lesquels l'utilisateur peut choisir, et vous pouvez même ajouter d'autres formats comme vous allez le long, sans frais supplémentaires.

Si vous avez juste un guide pour créer ce ne sera pas utile de votre temps, mais si vous avez une documentation nécessaire pour gérer alors il est le meilleur à ma connaissance. Leur soutien est très utile aussi.

Créé 18/09/2008 à 15:47
source utilisateur

Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more