Dear Marco, On Tue, Sep 09, 2014 at 10:47:21PM +0200, Marco Ciampa wrote: > Hi Roman, I am afraid of being a bit off topic (see below). > I am wondering about this: > > http://wiki.gimp.org/wiki/Documentation:Main > https://bugzilla.gnome.org/show_bug.cgi?id=723512 > > Why are you choosing this tool (publican)? Two reasons:
* It would improve and extend the possible formats we can export to, since we would not have to write all the Makefile rules ourself. * I've used it inside Red Hat. > Have you considered po4a[1] eventually with the aid of sisu[2] Nope. Thanks for sharing. > > [1] > http://po4a.alioth.debian.org/ > > [2] > http://www.jus.uio.no/sisu/sisu_markup/ > http://en.wikipedia.org/wiki/SiSU > http://www.sisudoc.org/ > I actually haven't started on the work looking into publican because of real life. What I do know is, that publican would not lower the barrier for writers to contribute new content to the manual, since it still uses DocBook. I did consider looking into asciidoc[1] tho, since asciidoc provides the same semantic model, but is simple text. Yet a first glance at it, I was unable to see any way on extracting the strings in order to support translation based on po files. It looks like SiSU tries to achieve a similar goal by using text. I think that would improve the manual, since no one has to write XML anymore. The additional benefit of asciidoc would be, that it could export to docbook, which then could hook into our current setup. Not sure if this is applicable tho. > I am considering these tools for another project (KiCad) but I think that > GIMP too could gain from these, as you pointed out, only I want to > discuss pros and cons with someone more skilled than me. :-) > > Maybe we can catch two birds with one stone analizing these two tools for > the two projects that IMHO have similar goals. po4a could be a potential candidate to extract strings from asciidoc... not sure. > What do you think? It's certainly worth looking into. All I did with publican is to check if we could benefit from it. Cheers, -- Roman Joost www: http://www.romanofski.de email: romanof...@gimp.org _______________________________________________ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list