El futuro de la dirección de Ayudar a los formatos de Archivo

Question

Parecería que ayuda CHM archivos no son el formato de archivo de ayuda de elección.

WinHelp
- obsoleto

HtmlHelp (CHM)
- no se admiten en la Vista por defecto
- no funciona así en un recurso compartido de red

Ayuda 2 (HXS)
- Entiendo que este es utilizado en VS2005+ para mostrar la ayuda

Basado En La Web
- Podría ser difícil de manejar para varias versiones

¿Qué formato de archivo de ayuda tendría que utilizar en una nueva (C#) de la aplicación que proporciona múltiples versiones de la misma base de código?

Nos gustaría utilizar ayuda CHM sin embargo no parece ser la dirección que Microsoft nos quiere mover.

¿Alguien emplean HXS para sus archivos de ayuda?

La retroalimentación apreciado

---

Actualización basado en lassevk comentarios;

Parece como si HXS ayuda no está destinado a ser utilizado para el normal ayuda a proyectos.

---

Answer 1

¿Qué hace que usted piensa que no existe ningún valor predeterminado .chm visor de windows Vista ?(Ciertamente hay uno en mi equipo, así como en mi Win7 cuadro)

Puede confundir .chm con .hlp (Microsoft, de hecho, cayó .hlp apoyo en la vista, luego con el tiempo se reanudó en una actualización de windows)

Línea de base :.archivos chm parecen ser todavía se admite en todas las versiones de windows, y la única alternativa real para .archivos chm sé que es .html

Answer 2

this.Mode = Modes.Rant;

Hay enormes problemas con casi toda la ayuda de los formatos de archivo debido a que los fabricantes (normalmente de Microsoft para muy pocos de ellos) no parecen querer hacer un trabajo más que ligeramente lo suficientemente bueno para su propio uso.

No puedo decirle cuántas veces la nueva HXS formato completamente regado mi ayuda de Visual Studio cuando 3ª partes integren.Se podría decir que la culpa es de la tercera parte de la instalación de las herramientas, pero por mucho tiempo no fue no documentación sobre cómo hacer esto, por lo que tuvieron que elegir entre la ingeniería inversa (y equivocarse, a veces) o no integrar a todos.Todavía no sé si la integración funciona, pero en estos días acabo de cambiar de Visual Studio para utilizar la ayuda en línea.Simplemente funciona, en su mayoría, mientras que el sistema de ayuda invariablemente cae abajo para que la barra de progreso que sólo cerraduras de Visual Studio hasta que se ha reconstruido el archivo de ayuda, excepto que no, porque ahora los archivos están corruptos, así que en cualquier momento me golpeó F1, Visual Studio solo bloquea a menos de que me maten los DEXPLORE programa de cualquier número de veces.

Cómo esta terminó como una solución a cualquier problema, todavía no sé.

En segundo lugar, las herramientas que necesita para estar presente.CHM visor está presente en la pre-vista, no en Vista, pero las herramientas necesarias para mostrar HXS no está presente en la pre-vista, pero tengo entendido que ellos están en la Vista.Agradable, así que ahora tengo una elección entre el uso de un formato que debe ser personalizado instalado en el ordenador de los usuarios, o ...err, otro que necesita ser instalado en el personalizado en otros ordenadores de los usuarios.A la derecha.

this.Mode = Modes.JustTicked;

Donde yo trabajo enviamos archivos CHM, y un archivo de html basado en la versión para aquellos que desplegar sus aplicaciones a través de un recurso compartido de red.Como para Vista, no hemos visto mucho de eso, pero la versión de html podría trabajar allí.

Me gustaría mucho más tener un brillante ayudar archivo sin embargo.

Un buen resultado de la versión de html es que podemos vincular en los mismos archivos en el módulo web que sigue nuestro producto.De esta manera solo existe una versión de que las necesidades de los clientes.

Estamos buscando a mejorar la herramienta que utilizamos en el trabajo, así que en mi agenda para esta semana, agradable y tranquilo en el trabajo, voy a estar buscando en los diferentes tipos de salida que se pueden producir, entre otras cosas HXS.

---

Editar:Hmm, un rápido vistazo a las páginas de ayuda de Ayuda y Manual, el producto que usamos, ha esto que decir acerca de HXS:

Ayuda de Visual Studio es también conocida como MS Ayudar a 2.0.Originalmente, este formato fue diseñado para ser el sucesor de la Ayuda HTML.Sin embargo, Microsoft, a continuación, ha pospuesto su lanzamiento de forma indefinida y ahora está claro que nunca va a ser lanzado como un formato de ayuda para el usuario normal de las aplicaciones.

Por favor, tenga en cuenta que este es un especial formato de ayuda que sólo se utiliza para la documentación de la programación de terceros componentes diseñados para la integración en Visual Studio .NET.No es adecuado para cualquier otro propósito y no puede ser utilizado para el normal ayudar a que los proyectos para los programas de aplicación!

Supongo que HXS está completamente fuera de la mesa.

---

Nota:Basado en la Web no significa necesariamente que usted necesita un web servidor, sólo eso, usted necesita un web navegador.Si usted integrarlo en su aplicación, con un componente de explorador web, o si usted acaba de lanzar los usuarios del navegador predeterminado, que sería una opción que usted tendría que hacer, pero la mayoría de las web de ayuda en función de las salidas que he visto no requiere de un servidor de configuración.

Answer 3

Para mí, CHM es todavía la respuesta.Voy a construir archivos CHM con el Castillos de arena Archivo de Ayuda de la herramienta creador de que está disponible en Codeplex.

Las preocupaciones acerca de la accesibilidad de CHM son válidos.Para solucionarlo, he producido un CHM-a-Web convertidor con bastante facilidad, con algunos IStorage hacking, un texto de búsqueda y reemplazo, y una transformación XSL. Esta página es un sitio web que se produce de forma automática en unos 8 segundos.Tiene una expandir/contraer treeview en el lado izquierdo de navegación.Marcos (no muy URL amigable), pero funciona bastante bien.

Answer 4

La única utilidad de la documentación de ayuda que he visto ha sido claro con HTML.La mayoría, si no todos, de los proyectos open source, he visto todas tener el código HTML de las páginas de ayuda (para las Api de referencia y docs).Cualquier cosa que utiliza un formato propietario o que requiere de una propiedad de un lector todos corren el riesgo de volver obsoleto (CHM), o tener compatibilidad o inflar los problemas (Pdf).

Por alguna razón, Microsoft es malo en los archivos de ayuda.La ayuda en pantalla de Visual Studio/SQL Estudio/Oficina es terrible, MSDN es un lío, CHMs toscos, y la búsqueda de Microsoft nunca devuelve los resultados que realmente desea.(Es sólo mi opinión :)

Answer 5

Adobe RoboHelp puede ser utilizado para el autor el contenido de la ayuda que ha contenido/índice/search/glosario y funciona en un navegador como es el HTML generado.Apoya a 35 idiomas.

Tenemos un Flex basado en la aplicación web que utiliza este para la gestión de la aplicación del contenido de la ayuda.El Flex de la aplicación y su sistema de ayuda de trabajar en la mayoría de los navegadores en Windows/MacOSX/Linux.

Answer 6

Algunos actualizado pensamientos para alguien sigue leyendo esta pregunta...

De acuerdo a Wikipedia, Microsoft decidió en Microsoft Asistencia De Lenguaje De Marcado De después de dar una Ayuda de 2.

También hay Sistema De Ayuda De Microsoft, que es lo que se distribuye con Visual Studio 2010.