2010-01-04 14 views
6

Estoy buscando un sistema de plantilla de documentación o, más bien, crearé una. Debe apoyar las siguientes características:sistema de plantilla de documentación de wiki/docbook/latex

  • crear una salida en formato PDF y HTML
  • Soporte para gran & complicado (látex) Fórmulas
  • Las referencias entre documentos
  • Bibliografías
  • plantillas serán ocupados por una secuencia de comandos Python

He intentado LaTeX con varios T convertidores eX-to-HTML pero no estoy satisfecho con los resultados. He estado usando DocBook por un tiempo, pero creo que la edición de DocBook no es fácil de escribir y el soporte para fórmulas aún no es suficiente.

El problema principal es que habrá usuarios de este sistema que no conocen la sintaxis de LaTeX o DocBook. He pensado en una alternativa para estos usuarios que ofrecen una posibilidad de edición con la sintaxis de Wiki (convertida por Python en LaTeX).

En resumen: deseo HTML y PDF de al menos LaTeX y Wiki de entrada. DocBook podría usarse como formato intermedio.

¿Alguien ha tenido un problema similar o puede darme un consejo sobre qué herramientas y qué formatos de archivo debo usar?

Respuesta

7

Utilizamos esfinge: http://sphinx.pocoo.org

Lo hace casi todo eso.

Su secuencia de comandos python o sus usuarios o quien sea (no puedo seguir la pregunta) puede crear contenido utilizando RST markup (que es tal vez el más fácil de los lenguajes de marcado). Lo ejecuta a través de Sphinx y obtiene HTML y Latex.

+1

y eche un vistazo a http://www1.american.edu/econ/ itex2mml/mathhack.rst para incluir fórmulas de látex en RST. – tonfa

+0

Sphinx tiene un módulo pngmath que traduce las fórmulas de látex en archivos png para su inclusión en HTML. La única sutileza es manejar los caracteres Unicode sin problemas.Tengo un pequeño "reescritor" que reemplaza algunos Unicode con látex adecuado para la versión de látex. –

+0

Ya he usado sphinx para un proyecto pero no encaja completamente en mi perfil de aplicación. Una cosa es que no genero un documento grande sino varios documentos más o menos independientes que solo se refieren entre sí por un hyperref. Me gusta mucho RST, ¿hay algún convertidor de RST a LaTeX o DocBook? –

1

Creé un pre-procesador LaTeX y un módulo python que le permite incrustar Python o SQL dentro de un archivo LaTeX. El python y/o SQL se ejecuta y la salida se pliega.

Con latex2html o latex2rtf puede usar el código LaTeX para producir HTM y RTF.

He publicado por usted en http://simson.net/pylatex/

+0

Interesante. Prefiero Python sobre Lua (TeX) así que pensaré en cómo puedo usar esto. ¿Puedes reparar el controlador de extensión de archivo .py en tu servidor web o cambiar el nombre de los archivos, por favor? Gracias. –

0

Arbortext soporta de forma nativa LaTeX. Puede enviar el motor de publicación o el compositor de impresión LaTeX y lo transmitirá directamente.

También admite una gran cantidad de otros lenguajes de composición e incluso le da la oportunidad de manipular el diseño de la página como lo vería en InDesign (sin el dolor de cabeza ni la sobrecarga de la identificación).

0

Creo que Asciidoc está más orientado a lo que intenta obtener. Es un lenguaje de marcado simple, permite fórmulas de látex y genera documentos Docbook desde los que puede generar aún más la representación de HTML o látex legible

Cuestiones relacionadas