On Thu, 26 Jul 2012 03:15:37 +0200, Lea Hayes <[email protected]> wrote:
Hi Alex
After serious consideration this seems to be the easiest approach overall (whilst a little extra initial preparation is required). Though at this stage I am not committed to this approach, I am still in the experimental phase really. I am looking for something with flexibility over visual styles (which DocBook seems to lack), whilst maintaining good semantics, whilst having both HTML and PDF output that are both consistent in style and easy to use. And hopefully far easier to edit using WYSIWYG. Whilst I do not mind manually typing XML elements around my text when writing XML comments, I can see this becoming very tedious when writing large amounts of technical documentation.
Many thanks for this. Actually I'm going on holidays and, among other things, I'd like to find a reasonable solution for the problem. I've written a few docbook code (with a Maven plugin which embeds source examples) but I'm tired of it because I didn't have a good experience with any of the available editors. In the meantime, my tiny CMS is now feature-ready and entering the beta stage, it runs all of my sites and it's based on HTML 5, which I appreciate and I think it should be enough for decent document writing. The idea is to have a unique platform for writing articles, embedding code samples, both for my blog posts and eventually being collected in book form. The missing point was conversion to PDF, which seems to be solved by the tool you pointed to.
-- Fabrizio Giudici - Java Architect, Project Manager Tidalwave s.a.s. - "We make Java work. Everywhere." [email protected] http://tidalwave.it - http://fabriziogiudici.it -- You received this message because you are subscribed to the Google Groups "Java Posse" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/javaposse?hl=en.
