docbook-apps

  • 1.  Re: [docbook-apps] DocBook Customization -- Subsets

    Posted 06-04-2009 18:26
    We've looked at the simplified version of DocBook and it's TOO simple.
    We have a couple of examples of local style manuals (thank you!). If
    anyone else wants to share their tag subsets, that would be gratefully
    received. We appreciate the goal of reducing complexity and
    ambiguity--makes sense--but we're less clear where to begin for a set
    of books above the article level.

    We could authorize like, twenty tags, and then require people to argue
    for additions, but that could be a de-motivator. ;) (The first DocBook
    sample I worked with from the community was using EBNF!)


    --
    --
    | Karen G. Schneider
    | Community Librarian
    | Equinox Software Inc. "The Evergreen Experts"
    | Toll-free: 1.877.Open.ILS (1.877.673.6457) x712
    | kgs@esilibrary.com
    | Web: http://www.esilibrary.com



  • 2.  Re: [docbook-apps] DocBook Customization -- Subsets

    Posted 06-04-2009 21:14
    +--
    | We've looked at the simplified version of DocBook and it's TOO simple.
    | We have a couple of examples of local style manuals (thank you!). If
    | anyone else wants to share their tag subsets, that would be gratefully
    | received. We appreciate the goal of reducing complexity and
    | ambiguity--makes sense--but we're less clear where to begin for a set
    | of books above the article level.
    +--

    Our local style doesn't support the 'book' element---all our
    publications are articles---but it's enough for our few dozen
    separate publications. Here's our user manual:

    http://www.nmt.edu/tcc/help/pubs/docbook/

    This document has two purposes:

    - It has localizing information, like where in our file system
    you can get model Makefiles, and how to use xep (which we
    love and have under an academic license).

    - Since I also do the stylesheet customization, the approach was
    to describe only the tags that are decently supported in our
    stylesheet layer.

    Here's our local stylesheet layer, in literate form (the
    definitive versions of the XSLT files displayed here actually
    reside in the DocBook source):

    http://www.nmt.edu/tcc/doc/docbook43/ims/

    Bon appetit,
    John Shipman (john@nmt.edu), Applications Specialist, NM Tech Computer Center,
    Speare 119, Socorro, NM 87801, (505) 835-5950, http://www.nmt.edu/~john
    ``Let's go outside and commiserate with nature.'' --Dave Farber



  • 3.  RE: [docbook-apps] DocBook Customization -- Subsets

    Posted 06-05-2009 03:20
    Hi Karen,

    Have you considered the DocBook Publishers schema customization? It's available on Sourceforge at:
    http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/docbook/relaxng/publishers/

    It would be fairly easy to include any of the technical inlines you might need as well.

    Best regards,

    --Scott

    Scott Hudson
    Senior XML Architect

    +1 (303) 542-2146 | Office
    +1 (303) 332-1883 | Cell
    Scott.Hudson@flatironssolutions.com
    ==========================================
    Flatirons Solutions
    http://www.flatironssolutions.com