2009/11/2 Emanuel Calvo Franco
<postgres.arg@gmail.com>
>>
>> No es mucho quilombo despeus para recopilar las paginas?
>>
>
> No, hay plugins para trac que generan los PDF recopilados
automaticamente
> (en formato artículo o en formato libro). Lo mejor es que se puede
> seleccionar que páginas incorporar, por lo que cada uno se podría
armar su
> propio manual en PDF con los temas que le interesen.
>
> También hay otros plugins en trac para agregarle indices, menúes,
tags,
> comentarios, votación, etc., por lo que tendríamos un manual
interactivo y
> automático sin tener que programar nada.
>
> Si la pregunta viene por el lado de "se puede hacer un make ..." la
> respuesta es no, esto no pasa por los archivos fuentes sgml, y no
hay una
> forma fácil de generarlos.
> O sea, perderíamos la flexibilidad que tienen los fuentes de
generar html,
> pdf, hlp (para windows), xml, etc., pero por otro lado, en general
solo se
> esta distribuyendo el html y pdf, cosa que sería posible si
usaríamos el
> trac.
>
Mmmh creo que seria un punto debil de esto...
Hay plug-ins para generar PDF, Docbooks, DOC, ODS, etc.
Aparte, si nos fijamos en las traducciones portugesa, francesa y
japonesa, en general ofrecen el HTML y PDF, y algunas como mucho el MAN.
Igualmente, el archivo CHM de ayuda para windows calculo que
podría ser generado desde los HTML y las páginas MAN podrían ser
generadas desde la wiki con herramientas externas (si es que se van a
generar, como se puede integrar facilmente a la ayuda de pgadmin3
cambiando la URL, en mi opinión no haría falta).
> Otro detalle es que el formato de trac es muy
simplificado, lo que lo hace
> más manejable, pero por ej no soporta bloques de código con
formato (en trac
> son solo sin formato), por eso no se puede incluir negritas o
cursivas en
> los bloques de código.
> Se podrían usar preprocesadores en html o rst pero me parece que
no vale la
> pena (hoy, quizas mas adelante con tiempo podríamos ajustar estos
detalles).
> Justamente trac simplifica el formato wiki para hacer las cosas
más rápidas
> y simples, y en general, de las páginas que probé, se respeta
bastante el
> "espíritu" del original (con la salvedad del los bloques de
código, que no
> creo que influya mucho)
>
Esperemos mas feedback de esto...
Ya modifiqué trac para que permita formato en bloques PRE, de
igual modo como hace la documentación oficial.
Prácticamente las páginas traducidas se ven igual que las
páginas originales:
Sds
Mariano