[OPEN-ILS-DOCUMENTATION] ***SPAM*** Re: ***SPAM*** Re: ***SPAM*** Docbook

[Nicole Engard]

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 <lori.ayre at galecia.com> 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
> <robert.soulliere at mohawkcollege.ca> 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
>> OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
>> http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation
>>
>
>
> _______________________________________________
> OPEN-ILS-DOCUMENTATION mailing list
> OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
> http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation
>
>