¡Te damos la bienvenida al nuevo sysarmy --help! Para recuperar tu usuario pedí un password reset.

documentar instructivos en texto plano exportable a {html,xhtml,pdf,epub,netflix}

Buenas,

Tengo que generar algunos instructivos de cómo realizar algunas tareas poco frecuentes (agregar discos/bloques de un storage) que yo mismo olvidaré.

En el lugar en el que estoy adoran ofimática office, incluyendo offfice 365, pero en área es más administrar redes, servidores Linux, etc. A mí office me parece horrible y me distraigo mucho con lo de WYSIWYG, preferiría usar vim, por mal que lo haga.

Precisaría que los documentos de salida sean HTML, PDF para que el usuario de un desktop windows la tenga más amigable y hasta más fácil de imprimir formateado.

He visto lo linda que quedan parseados los documentos markdown en repositorios github/gitlab y así empecé usando pandoc. Pero ahora estoy agregando y tocando a mano plantillas CSS y blah blah no se cuánto.

Ha poco conocí asciidoc, la salida html es muy linda pero no es markdown y hasta resulta un lenguaje en sí mismo.

¿Qué herramienta piola me recomendarían? ¿Habrá algún parser markdown con los estilos ya precargados?¿Algo que ya use pandoc?

Gracias, saludos,

Respuestas

  • No se si entiendo cual es el problema puntual.

    Los usuarios se quejan por el disenio del HTML?.

    Algo que come MarkDown y escupe HTML bonito puede ser https://getnikola.com

    Por estilos Prearmados fijate Bootstrap es un CSS que agregas al HTML y hace que se vea un poco mejor.

    Te recomendaria a menos que sea muy necesario no mandarte con asciidoc, latex, etc.
  • Has pensado utilizar LaTeX para crear tus instructivos? Quedarían muy profesionales y la salida la puedes lanzar en PDF o HTML para los usuarios que comentas.
Este hilo ha sido cerrado.