| A question about Buckminster Documentation... [message #652447] |
Thu, 03 February 2011 22:37  |
 Henrik Lindberg
Messages: 2509
Registered: July 2009 |
Senior Member |
|
|
On 2/1/11 3:14 PM, Matthew Webber wrote:
> Is there a way that the community can assist in keeping the BuckyBook
> up-to-date?
>
Simple answer:
yes please !!! :)
Longer answer:
The Bucky Book is written using DocBook, and I have edited and generated
the PDF version using a tool that runs locally (Serna-Free). (the source
is not in any way tied to Serna, but it helped manage the XSLT
stylesheets, running different types of generation etc. and I have made
a bunch of stylesheet customizations).
I have on my TODO list since quite some time to make the source of the
book available at Eclipse, but I never seem to find the time to
configure the DocBook to PDF generation part of it so it is runnable by
anyone.
Maybe as a first step, I can just make the source available, thereby
making it possible to edit and provide patches. Maybe some docbook,
xslt, fop, pdf, guru would like to take it from there :).
A bigger (and more long term) task, if someone would like to take that
on ;) - is to transform the text to wiki text so the continued
maintenance can be done on the wiki + using Mylyn wiki text (which I
have used successfully in other projects to generate both pdf and
eclipse help).
Meanwhile, logging [documentation] issues in bugzilla is very helpful,
and if there is clear instructions on what to change and where it has a
far greater chance of being included. (I hope to be able to make a round
of edits in time for Indigo release).
Regards
- henrik
|
|
|
|
|
Powered by
FUDForum. Page generated in 0.01459 seconds
] 
Search
Help
Register
Login
Home
