On Tuesday, 23 December 2014 23:20:15 UTC+1, Lex Trotman wrote: > > On 23 December 2014 at 22:02, Marco Ciampa <[email protected] <javascript:>> > wrote: > > Hi all, > > I'm an old newbie, not really a programmer nor Linux expert that tries > to > > be useful translating free software and free software manuals in my > > mother tongue (Italian). > > > > To this aim I have started the experiment to port all KiCad > documentation, > > odt based, into a light markup to easy the translation effort through > the > > use of po files. > > This is the result of this effort: > > > > https://github.com/ciampix/kicad-doc > > > > Now to the point. I would like to make asciidoc or asciidoctor to > > produce good pdf / epub results. I do not know, even superficially, > > docbook and xslt but I know that to this aim I have to start coding > > with this format and associated tools. > > Sadly yes if you are using the FOP toolchain. > > > > > Is there a way to do it easily? I mean I am not even able to produce a > > decent pdf cover without page number and possibly with the KiCad logo on > > top of it! >
if you use the dblatex backend instead of FOP (and I would think this to be the right way since it produces better pdf in my view), than you could avoid messing with xsl (mostly). simple things like whether to emit title pages and frontmatter etc. _can_ be switched on and of in the shipped asciidoc/dblatex xsl stylesheet and more complicated things could be adjusted in replacying the LateX styles used by dblatex (which means struggling with TeX instead of xml/xsl...). it also is possible to output the `.tex' file generated by dblatex and to try and handpolish this later on (of course this is not desirable compared to doing it in the stylefiles itself, but ....). the stylefiles in question are somewhere in the dblatex tree and have names following this scheme: `dbk_something.sty' plus a file `docbook.sty'. I got away for my purposes with minor tweaks to `dbk_headfoot', `dbk_locale', `dbk_revision', and `docbook'. regarding the title page, lex is probably right to propose to do that separately and glue it together (e.g. with `pdftk'). > > You could try producing the cover page in something like Libreoffice, > printing it to pdf and then I believe there are tools that can glue > there is a command line tool to due this: http://www.pdflabs.com/tools/pdftk-the-pdf-toolkit/ > PDFs together (maybe even directly in libreoffice, see > http://en.wikipedia.org/wiki/List_of_PDF_software) so you can glue it > to the start of the PDF of the book contents you made conveniently > with a2x. > > > > > With rest + Sphinx I am able to produce an almost perfect pdf, epub and > > html. I would like to do it with Asciidoc too, because I personally like > > much more asciidoc syntax than rest, this without having to study too > > much docbook and xslt transformations. > > > > Is it feasible? Is it better to buy a good docbook + xslt manual and > > start studing seriously? > > See http://sagehill.net/docbookxsl/CustomizingPart.html (referenced by > Asciidoc FAQ #3), it covers book covers :) > > Cheers > Lex > > > > -- > > > > > > Marco Ciampa > > > > I know a joke about UDP, but you might not get it. > > > > +--------------------+ > > | Linux User #78271 | > > | FSFE fellow #364 | > > +--------------------+ > > > > -- > > You received this message because you are subscribed to the Google > Groups "asciidoc" group. > > To unsubscribe from this group and stop receiving emails from it, send > an email to [email protected] <javascript:>. > > To post to this group, send email to [email protected] > <javascript:>. > > Visit this group at http://groups.google.com/group/asciidoc. > > For more options, visit https://groups.google.com/d/optout. > -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/asciidoc. For more options, visit https://groups.google.com/d/optout.
