On Thu, 4 Jul 2013, Stéphane Gourichon wrote:

Le mercredi 3 juillet 2013 13:03:12 UTC+2, [email protected] a écrit :

I would like to point you to the asciidoc-odf project. It allows you to
export to PDF using templates that can be modified in LibreOffice
(graphically). The project works mostly, but could use some more activity
;-)

Interesting indeed. Thanks Dag for pointing this out.

I've started to use asciidoc to produce technical reports and
documentation, and missed a clean and easy PDF output.
Usual docbook chains are a little difficult to adjust and manual processing
(e.g. copy-paste asciidoc-generated HTML to OpenOffice) is ugly and
inefficient.

I never could control the DocBook output exactly the way I wanted.


The real need is a solution that would bring together the benefits of:
* unattended asciidoc->whatever (DocBook, ODF)->PDF conversion
* easy tuning of appearance, style

It looks like asciidoc-odf provides the easy tuning by modifying a template
document. I have to check if it fits all my needs.

Oh, by the way, people love "through" examples: a simple web page offering
a source asciidoc, a sample template, a resulting ODF, a resulting PDF.
Many a time, people browse sites when they don't have access to a complete
environment or time to experiment: they can not git clone, have right
prerequisites, install the backend as documented, etc.
Having a "through" example with source and generated files confirms how it
works and have user do "Aha", that's what I need!
That would probably bring more users and its share of feebdack.

You can find my curriculum-vitae (the reason I started unoconv and asciidoc-odf) as part of the examples in the Git repository:

    
https://github.com/dagwieers/asciidoc-odf/blob/master/examples/curriculum-vitae-dag-wieers.txt

this together with my cv theme (an ODT stylesheet):

    
https://github.com/dagwieers/asciidoc-odf/blob/master/themes/cv/cv.odt.styles

produces:

    http://dag.wieers.com/cv/curriculum-vitae-dag-wieers.pdf

I just updated Git with the latest file(s). If you prefer to look at the automation, the Makefile is available here:

    http://dag.wieers.com/cv/Makefile

One of the benefits (and as a freelancer the most important one) is that I can export to DOC and ODF as well. So if I need to distribute a new version of my resume when looking for a new project, I can simply modify the AsciiDoc file and type 'make'. Most contacts demand a DOC file for their internal database.


Question : Can we set ODF document properties from asciidoc source using
asciidoc-odf ? Some of my documents use them in page footers. In practice,
exact footer text (and document subtitle) definitely needs to be different
in different documents: it includes a kind of document ID currently fetched
using an ODF document property.

There are two ways to do this.

 - You make use of an ODF stylesheet when producing an .fodt file
 - You make use of an ODF template to produce a real .odt file

The first one works best if you prefer to tinker with the file by hand, the second one works best if you like to tinker with the look&feel using LibreOffice. The first method gives the most possibilities (as the LibreOffice interface does not give 100% control of what ODF can do).

I use the first method, the second method, while it should work has not been tested as much and probably could use some more work to get it finished.

The other benefit of the first method is that it generates an .fodt (Flat ODT file) that you can inspect using a text-editor. Once modified with LibreOffice to your liking, you can copy over the important changes back into the ODT stylesheet for future document output. So once your stylesheet is as you want it to look, you can reuse the stylesheet for all future (and older) AsciiDoc files.

--
-- dag wieers, [email protected], http://dag.wieers.com/
-- dagit linux solutions, [email protected], http://dagit.net/

[Any errors in spelling, tact or fact are transmission errors]

--
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/groups/opt_out.


Reply via email to