Fichiers d'aide Windows - quelles sont les options?

Autrefois, l'aide n'était pas triviale mais possible: générer un fichier .rtf funky avec des balises spéciales, l'exécuter dans un compilateur et obtenir un fichier WinHelp (.hlp) qui fonctionne vraiment bien.

Ensuite, Microsoft a décidé que WinHelp n'était plus branché et cool et est passé à CHM, à tel point que WinHelp a été supprimé de Vista.

Maintenant, CHM peut-être bien, 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 moyens de faire fonctionner CHM sur le réseau, ce n'est pas un bon choix, car lorsqu'un utilisateur appuie sur le bouton Aide, il veut de l'aide et ne pas avoir à faire des réglages funky.

Bottom Line: Je trouve CHM absolument inutilisable. Mais WinHelp n'étant plus une option non plus, je me demande quelles sont les alternatives, surtout quand il s'agit d'intégrer à mon application (par exemple, pour WinHelp et CHM, des fonctions vous permettent de passer directement à un sujet)?

Le PDF a l'inconvénient de nécessiter Adobe Reader (ou l'un des plus légers que peu de gens utilisent). Je pourrais vivre avec cela vu que c'est un peu standard de nos jours, mais pouvez-vous le dire de manière fiable pour passer à une page / ancre donnée?

Les fichiers HTML semblent être le meilleur choix, vous n'avez alors qu'à traiter avec différents navigateurs (CSS et autres).

Edit: I am looking to create my own Help Files. As I am a fan of the "No Setup, Just Extract and Run" Philosophy, i had that problem many times in the past because many of my users will run it off the network, which causes exactly this problem.

Je suis donc à la recherche d'un moyen plus robuste et pérenne de 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 très bon format, mais Security Stuff le rend inutilisable, car un système d'aide est censé fournir de l'aide à l'utilisateur, pas pour générer encore plus de problèmes.

0

5 Réponses

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

Personnellement, je trouve que CHM est 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 ajoutez un raccourci clavier dans Crimson Editor Donc, quand j'appuie sur F1, il charge le CHM et effectue une recherche du mot sur lequel est positionné le curseur (idéal pour une référence de fonction rapide).

0
ajouté

Si vous faites "juste extraire et exécuter", vous allez courir dans des problèmes de sécurité. Cela est particulièrement vrai si vous utilisez Vista (ou plus tard). Y a-t-il une raison pour laquelle vous vouliez éviter d'emballer vos applications dans un programme d'installation? L'utilisation d'un programme d'installation atténuerait le problème de "source externe". Vous seriez en mesure d'utiliser des 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 bien. 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.

0
ajouté
Oui, la raison pour laquelle je veux éviter un installateur est parce qu'ils ne sont pas nécessaires. Je déteste installer des choses parce qu'il y a toujours beaucoup de désordre (Clés de registre, éléments de désinstallation), aussi longtemps que je n'ai pas de dépendances externes, ne démarre pas les entrées du menu, etc., je ne veux pas utiliser un installateur , surtout pas si c'est seulement nécessaire pour régler les problèmes de sécurité inutiles avec le système d'aide :(
ajouté l'auteur Michael Stum, source

Si vous ne voulez pas utiliser un programme d'installation 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 de la boîte, mais il est disponible gratuitement en téléchargement pour Vista et Server 2008.

0
ajouté
Parce que l'utilisateur doit alors effectuer des étapes supplémentaires pour autoriser les fichiers HLP, même localement?
ajouté l'auteur Roger Lipscombe, source

HTML serait le meilleur choix suivant, SEULEMENT SI vous les servez à partir d'un serveur Web public. Si vous essayiez de l'intégrer à votre application, tous les fichiers (et images (et stylesheets (et ...))) feraient ressembler CHM à un cadeau des dieux.

Cela dit, une fois regroupés dans le package d'installation (au lieu d'être diffusés sur le réseau), j'ai trouvé que les fichiers CHM fonctionnaient bien.

OTOH, un autre piège à propos des fichiers CHM: Même si vous essayez d'ouvrir un fichier CHM sur un disque local , vous pouvez tomber sur le bloc de sécurité si vous l'avez initialement téléchargé car le fichier pourrait être marqué comme "est venu de source externe" quand il a été obtenu.

0
ajouté
Après avoir considéré à peu près tout le reste, il semble que les fichiers HTML sont en effet mon seul choix, car chaque autre alternative est gravement brisée.
ajouté l'auteur Michael Stum, source
oui, cela arrive tout le temps. voyages jusqu'à même les développeurs expérimentés.
ajouté l'auteur Cheeso, source
Le problème de déverrouillage CHM peut être résolu par programme, même si vous avez votre propre programme de mise à jour. (Les systèmes d'installation classiques le résolvent déjà) Voir stackoverflow.com/questions/6823166/…
ajouté l'auteur Marco van de Voort, source

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

Nous utilisons Aide et Manuel et pouvons donc facilement produire les deux types de sortie à partir du même projet source. Les fichiers HTML contiennent également des fonctionnalités de recherche et ne nécessitent pas de serveur Web. Par conséquent, même si ce n'est pas une solution optimale, cela fonctionne très bien.

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

  • WinHelp - obsolète
  • HtmlHelp (CHM) - obsolète sur Vista, ne fonctionne pas à partir du partage réseau, autre que cela fonctionne vraiment bien
  • Microsoft Help 2 (HXS) - cela semble fonctionner jusqu'au moment où il ne le fait pas, les index corrompus ou similaires, cela est utilisé par Visual Studio 2005 et au-dessus, par exemple
0
ajouté
(VIsta a un successeur (plate-forme d'assistance), mais ce n'est pas librement disponible, et maintenant dans Windows 8 fois toujours pas très populaire)
ajouté l'auteur Marco van de Voort, source
Je ne savais pas que CHM était obsolète sur Vista. Est-ce officiel? Un lien?
ajouté l'auteur PhiLho, source