I want to repeat here (and I don't know if such a page exists yet) that using a tool like XMLEditor (http://www.xmlmind.com/xmleditor/) which has a free/non commercial version makes it so that you don't need to understand all of the intricacies of DocBook. Docs created with this tool may need to be edited in a text editor - but it's not a frequent occurrence and this tool makes tackling DocBook a lot less scary.
Thanks Nicole C. Engard PS. Thank you Robert for introducing me to the indexterm tag :) On Fri, Jun 4, 2010 at 10:44 AM, Lori Bowen Ayre <[email protected]> wrote: > You said: Let me know if you have any questions or would like to help out > in the DocBook XML conversion and would like some recommended readings to > get started, let me know. > Hi Robert, > I'd love to have some suggestions for how to get started understanding how > all of these pieces work and how one gets involved in contributing > documentation. Is there a "So you want to contribute your documentation to > the community eh?" page? > Lori > > > On Thu, Jun 3, 2010 at 1:03 PM, Soulliere, Robert > <[email protected]> wrote: >> >> Hi all, >> >> >> >> I've been experimenting with DocBook for a few days. I want to thank >> Jeremy and SITKA for letting me use their stylesheets and processing tools >> which saved me a ton of time. >> >> >> >> I produced an experimental docbook document I placed on our test server at >> Mohawk College. You can take a look at: >> >> >> http://libdog.mohawkcollege.ca/evergreen_documentation/draft/html/index.html >> >> >> >> A link to the pdf version is available at the bottom right corner of each >> page. >> >> >> >> Just a few notes about how DocBook works. >> >> >> >> The Table of contents is auto-generated based on the chapters. As we add >> new chapters in the form of XML files and include them in the root.xml file, >> they will appear in the TOC. Moreover, they will be automatically numbered. >> >> >> >> The index in the Appendices section is also auto-generated. To add a >> term to the index use the <indexterm> DocBook element >> >> see: http://www.docbook.org/tdg5/en/html/indexterm.singular.html for more >> details. >> >> >> >> Let me know if you have any questions or would like to help out in the >> DocBook XML conversion and would like some recommended readings to get >> started, let me know. >> >> >> >> I also added a new github repository for documentation at: >> >> http://github.com/rsoulliere/Evergreen-DocBook >> >> >> >> This is not forked from any evergreen repositories, but might serve as a >> temporary DocBook repository until we find a permanent repository home. I >> will add the contributors to my other repository to this one as well. >> >> >> >> Let me know if anyone has any other suggestions for a different server for >> the DocBook documentatin or for the repository, or if everyone is OK with >> this setup for now? >> >> >> >> Thanks, >> >> Robert >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> >> ________________________________ >> This E-mail contains privileged and confidential information intended >> only for the individual or entity named in the message. If the reader >> of this message is not the intended recipient, or the agent responsible >> to deliver it to the intended recipient, you are hereby notified that >> any review, dissemination, distribution or copying of this communication >> is prohibited. If this communication was received in error, please >> notify the sender by reply E-mail immediately, and delete and destroy >> the original message. >> >> _______________________________________________ >> OPEN-ILS-DOCUMENTATION mailing list >> [email protected] >> http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation >> > > > _______________________________________________ > OPEN-ILS-DOCUMENTATION mailing list > [email protected] > http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation > > _______________________________________________ OPEN-ILS-DOCUMENTATION mailing list [email protected] http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation
