He estado usando una herramienta llamadadoxigenopara documentar el código. Esto ha creado una carpeta de .htmlarchivos, .jsarchivos javascript y .pngarchivos de imagen, y crea una documentación realmente agradable basada en navegador al ejecutarse index.htmlen la carpeta.
Sin embargo, no es muy fácil de usar, ya que el usuario tiene que buscarlo index.htmlen un archivo junto con cientos de otros. Intenté fusionarlos todos en uno solo .htmlcon una variedad de herramientas en línea como HTMLDOC, pero ninguna de ellas funcionó.
Me preguntaba a) si había alguna manera de fusionar esta colección de htmlarchivos .jsy .pngen un solo archivo ob) si no, ¿hay alguna manera de crear una especie de "paquete" que oculte los archivos subyacentes y ejecute el índice? página cuando se hace clic? En última instancia, quiero que el usuario pueda hacer clic en un único archivo/paquete llamado "documentación" en lugar de mirar una lista enorme.
Muchas gracias,
David
Respuesta1
Lamentablemente, existen varios formatos de "archivo web" que compiten entre sí y no conozco ninguno que sea compatible con todos los navegadores.