Question

Il semblerait que les fichiers d'aide CHM ne sont plus le format de fichier d'aide de choix.

WinHelp
 - obsolète

HtmlHelp (CHM)
 - pas pris en charge sur Vista par défaut
 - ne fonctionne pas bien sur un partage réseau

Aide 2 (HXS)
 - Je comprends cela est utilisé dans VS2005 + pour afficher l'aide

basée sur le Web
 - Peut-être difficile à gérer pour plusieurs versions

Quelle application format de fichier d'aide utiliseriez-vous dans une nouvelle (C #) qui fournit plusieurs versions de la même base de code?

Nous voudrions utiliser CHM aide mais il ne semble pas être la direction que Microsoft veut se déplacer dans.

Quelqu'un emploie HXS pour leurs fichiers d'aide?

Feeback apprécié


Mise à jour sur la base de commentaires lassevk;

Attend comme si HXS aide ne vise pas à être utilisé pour des projets d'aide normaux.


Pas de solution correcte

Autres conseils

Qu'est-ce que vous fait penser exactement il n'y a pas de spectateur .chm par défaut sur Windows Vista? (Il est certainement l'un sur mon ordinateur, ainsi que sur ma boîte Win7)

Vous pourriez confondre avec .chm .hlp (Microsoft en effet chuté .hlp soutien dans Vista, puis finalement repris dans une mise à jour de Windows)

Bottom line: Les fichiers .chm semblent encore être pris en charge sur toutes les versions de Windows, et la seule alternative réelle à CHM fichiers que je connaisse est .html

this.Mode = Modes.Rant;

Il y a des problèmes énormes avec presque tous les formats de fichiers d'aide parce que les fabricants semblent (généralement Microsoft pour un certain nombre d'entre eux) ne pas vouloir faire un travail plus que un peu assez bon pour leur propre usage.

Je ne peux pas vous dire combien de fois le nouveau format de HXS a complètement lavé au jet de mon aide Visual Studio lorsque les parties intègrent 3e. On pourrait dire que cela est la faute des outils d'installation tiers, mais depuis un certain temps, il a été pas documentation sur la façon de le faire, ils ont dû choisir entre l'ingénierie inverse (et se tromper , parfois) ou non l'intégration du tout. Je ne sais toujours pas si l'intégration fonctionne, mais ces jours-ci je passe juste Visual Studio pour utiliser l'aide en ligne. Il fonctionne, la plupart du temps, alors que le aide intégrée tombe invariablement vers le bas pour que la barre de progression qui vient verrouiller Visual Studio jusqu'à ce qu'il a reconstruit le fichier d'aide, sauf qu'il n'a pas, car les fichiers sont maintenant corrompus, donc chaque fois que je frappe F1, Visual studio juste verrouille à moins que je tuerai le programme DExplore un certain nombre de fois.

Comment cela a fini comme une solution à tout problème, je ne sais pas encore.

En second lieu, les outils doivent être présents. CHM spectateur est présent sur la pré-vista, pas sur Vista, mais les outils nécessaires pour montrer HXS n'est pas présent sur la pré-Vista, mais je crois comprendre qu'ils sont sur Vista. Nice, maintenant je le choix entre l'utilisation d'un format qui doit être sur mesure installé sur l'ordinateur des utilisateurs, ou ... heu, un autre qui a besoin d'être sur mesure installé sur d'autres ordinateurs des utilisateurs. Droit.

this.Mode = Modes.JustTicked;

Là où je travaille, nous envoyons les fichiers CHM, et une version HTML basé sur des fichiers pour ceux qui déployer leurs applications via un partage réseau. En ce qui concerne Vista, nous avons pas vu beaucoup de encore, mais la version html travaillerions aussi.

Je préférerais avoir une aide brillante fichier bien.

Une belle résultat de version html est que nous pouvons créer un lien dans les mêmes fichiers dans le module Web qui suit notre produit. De cette façon, il n'y aurait qu'une seule version que les besoins des clients.

Nous cherchons à valoriser l'outil que nous utilisons au travail ainsi de suite mon emploi du temps pour cette semaine, agréable et calme au travail, je vais examiner les différents types de sortie, il peut produire, entre autres HXS.


Modifier : Hmm, un coup d'œil sur les pages d'aide pour l'aide et le manuel, le produit que nous utilisons, a ceci à dire au sujet de HXS :

  

Aide Visual Studio est également connu comme MS Help 2.0. A l'origine ce format d'aide était destinée à être le successeur de l'aide HTML. Cependant, Microsoft puis reporté indéfiniment sa sortie et il est maintenant clair qu'il ne va jamais être publié en tant que format d'aide pour les applications utilisateur normal.

     

S'il vous plaît noter que ceci est un format d'aide spéciale qui est utilisée uniquement pour la documentation des composants de programmation tiers conçus pour l'intégration dans Visual Studio .NET. Il ne convient pas à d'autres fins et ne peut pas être utilisé pour des projets d'aide normaux pour les programmes d'application!

Je suppose que HXS est complètement hors de la table, alors.


Remarque : Web ne signifie pas nécessairement que vous avez besoin d'un web serveur , seulement que vous avez besoin d'un web navigateur . Que vous intégrez dans votre application, en utilisant un composant de navigateur Web, ou si vous venez de lancer le navigateur par défaut des utilisateurs, ce serait un choix que vous auriez à faire, mais la plupart des produits d'aide sur le Web que j'ai vu ne nécessite pas la configuration du serveur du tout.

Pour moi, CHM est toujours la réponse. Je construis des fichiers CHM avec le Sandcastle Aide outil File Builder qui est disponible sur CodePlex.

Les préoccupations au sujet de l'accessibilité des CHM sont valides. Pour répondre à cela, je produisais un convertisseur CHM-to-Web assez facilement, avec quelques bidouillages IStorage, une recherche et remplacement du texte, et une transformation XSL. Cette page est un site web qui a été produit automatiquement en 8 secondes environ. Il a une expansion / effondrement TreeView à gauche main côté navigation. Cadres basé (pas très sympathique URL), mais cela fonctionne assez bien.

La seule documentation d'aide utile que j'ai jamais vu a été HTML brut. La plupart, sinon la totalité, des projets open-source que j'ai vu ont toutes les pages d'aide HTML (pour les API et documents de référence). Tout ce qui utilise un format propriétaire ou qui a besoin d'un lecteur propriétaire tous courent le risque d'aller obsolète (CHM), ou ayant une compatibilité ou des problèmes ballonnement (PDF).

Pour une raison quelconque, Microsoft est tout simplement mauvais dans les fichiers d'aide. L'aide en ligne pour Visual Studio / SQL Studio / Bureau est terrible, MSDN est un gâchis, CHM sont maladroites, et la recherche Microsoft ne retourne jamais les résultats que vous voulez vraiment. (Juste mon avis:)

Adobe RoboHelp peut être utilisé à l'auteur du contenu d'aide qui a un contenu / index / recherche / glossaire et fonctionne dans un navigateur tout comme HTML généré. Prise en charge de 35 langues.

Nous avons une application Web basée sur Flex qui utilise pour gérer le contenu de l'aide de l'application. L'application Flex et son travail de système d'aide sur la plupart des navigateurs sous Windows / MacOSX / Linux.

Quelques réflexions mises à jour pour tous ceux qui lisent encore cette question ...

Selon Wikipedia, Microsoft a décidé sur Microsoft Assistance Markup après avoir renoncé à une aide 2 .

Il y a aussi Microsoft du système d'aide, ce qui est livré avec Visual Studio 2010.

Licencié sous: CC-BY-SA avec attribution
Non affilié à StackOverflow
scroll top