docbook-apps

  • 1.  Docbook 5.0 and stylesheets

    Posted 02-24-2009 21:52
    Hi, I'm reposting a message from Betty, an intern who is subscribed to this
    list but having difficulty posting.. Note that I think I have partially
    found the answer from the following document,
    http://www.docbook.org/docs/howto/ , which includes links to
    http://docbook.sourceforge.net/release/xsl-ns/current/ , but I am still
    seeking general clarification about why 4.0 seems to be the norm (I mean, to
    a newcomer it seems odd that I'd produce 5.0 documents and then process them
    back to 4.0?!)... because of a large installed base, or something else?

    Karen G. Schneider

    -------------------------

    From: "Betty Ing" <ingbe@mcmaster.ca>
    To: docbook-apps@lists.oasis-open.org
    Date: Tue, 24 Feb 2009 14:58:14 -0500
    Subject: DocBook 5 Stylesheets
    Hello,

    I have been looking at the "Using XInclude" example in Ch. 23 - Modular
    DocBook - of DocBook XSL.

    http://www.sagehill.net/docbookxsl/ModularDoc.html#UsingXinclude

    I would like to create the chapter file and book file using DocBook 5
    and DocBook 5 stylesheets. I also plan to use xsltproc. What changes do
    I need to make in the xml files, and where can I locate DocBook 5
    stylesheets?

    Thanks in advance.

    Betty




    --
    --
    | 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
    | Be a part of the Evergreen International Conference, May 20-22, 2009!
    | http://www.solinet.net/evergreen



  • 2.  Re: [docbook-apps] Docbook 5.0 and stylesheets

    Posted 02-25-2009 07:36
      |   view attached
    Hello,

    indeed the picture is a bit blurry at the moment while docbook is
    migrating from 4.x to 5.0. Some points to try to answer your questions:

    - 4.x docbook will not evolve anymore, the current standard is now 5.0
    - 5.0 is not officially an OASIS standard yet, because of administrative
    reasons only
    - many people have been using exclusively 5.0 for more than a year
    without issues.
    - there are not really 5.0 stylesheets at the moment. Some work is being
    done on XSLT2 stylesheets, but this is not production ready I believe.
    So 4.x stylesheets have been adapted to be capable of handling 5.0 documents
    - 5.0 documents are not exactly processed back to 4.x: it is just that
    there is a first step that makes some adjustments to the document so it
    is correctly processed by the stylesheet. However this is transparent to
    the user. The user just apply the stylesheet once.
    - there is the namespace aware stylesheet version (-ns) that is specific
    to 5.0 but basically based on the standard stylesheet.tax

    So in short: just apply current -ns stylesheet with xsltproc on your
    document.

    Concerning xincludes, the syntax is the same as in DB 4.x, just remember
    to use the namespace.

    All this is my vision of the issue, I will let experts precise or
    correct all if necessary

    Camille.


    Karen Schneider wrote:
    > Hi, I'm reposting a message from Betty, an intern who is subscribed to
    > this list but having difficulty posting.. Note that I think I have
    > partially found the answer from the following document,
    > http://www.docbook.org/docs/howto/ , which includes links to
    > http://docbook.sourceforge.net/release/xsl-ns/current/ , but I am
    > still seeking general clarification about why 4.0 seems to be the norm
    > (I mean, to a newcomer it seems odd that I'd produce 5.0 documents and
    > then process them back to 4.0?!)... because of a large installed base,
    > or something else?
    >
    > Karen G. Schneider
    >
    > -------------------------
    >
    > From: "Betty Ing" <ingbe@mcmaster.ca></ingbe@mcmaster.ca><mailto:ingbe@mcmaster.ca>>
    > To: docbook-apps@lists.oasis-open.org
    > <mailto:docbook-apps@lists.oasis-open.org>
    > Date: Tue, 24 Feb 2009 14:58:14 -0500
    > Subject: DocBook 5 Stylesheets
    > Hello,
    >
    > I have been looking at the "Using XInclude" example in Ch. 23 - Modular
    > DocBook - of DocBook XSL.
    >
    > http://www.sagehill.net/docbookxsl/ModularDoc.html#UsingXinclude
    >
    > I would like to create the chapter file and book file using DocBook 5
    > and DocBook 5 stylesheets. I also plan to use xsltproc. What changes do
    > I need to make in the xml files, and where can I locate DocBook 5
    > stylesheets?
    >
    > Thanks in advance.
    >
    > Betty
    >
    >
    >
    >
    > --
    > --
    > | 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 <mailto:kgs@esilibrary.com>
    > | Web: http://www.esilibrary.com
    > | Be a part of the Evergreen International Conference, May 20-22, 2009!
    > | http://www.solinet.net/evergreen

    </mailto:kgs@esilibrary.com></mailto:docbook-apps@lists.oasis-open.org></mailto:ingbe@mcmaster.ca>

    Attachment(s)

    vcf
    camille.vcf   320 B 1 version


  • 3.  Re: [docbook-apps] Docbook 5.0 and stylesheets

    Posted 02-25-2009 16:00
    Thanks, this is helpful. I also went to the OASIS list archives and tried to
    get a feel for 5.0 activity. I'm not overly concerned about the officialness
    of 5.0, since it's certainly a de facto standard (and I've watched other
    standards projects and know this process is hard). I'm a little concerned
    that overall the movement toward de jure status of 5.0 is very slow, with a
    minimum of people involved in the heavy lifting (not that this isn't usually
    the case in most projects) -- more in the sense of what it might or might
    not say about Docbook's health as a living standard, de facto or otherwise.
    But it certainly seems true that most of the tools appear to support it, and
    it has a widely popular base.

    Karen G. Schneider, Equinox Software

    On Wed, Feb 25, 2009 at 2:35 AM, Camille Bégnis <camille@neodoc.biz> wrote:

    > Hello,
    >
    > indeed the picture is a bit blurry at the moment while docbook is migrating
    > from 4.x to 5.0. Some points to try to answer your questions:
    >
    > - 4.x docbook will not evolve anymore, the current standard is now 5.0
    > - 5.0 is not officially an OASIS standard yet, because of administrative
    > reasons only
    > - many people have been using exclusively 5.0 for more than a year without
    > issues.
    > - there are not really 5.0 stylesheets at the moment. Some work is being
    > done on XSLT2 stylesheets, but this is not production ready I believe. So
    > 4.x stylesheets have been adapted to be capable of handling 5.0 documents
    > - 5.0 documents are not exactly processed back to 4.x: it is just that
    > there is a first step that makes some adjustments to the document so it is
    > correctly processed by the stylesheet. However this is transparent to the
    > user. The user just apply the stylesheet once.
    > - there is the namespace aware stylesheet version (-ns) that is specific to
    > 5.0 but basically based on the standard stylesheet.tax
    >
    > So in short: just apply current -ns stylesheet with xsltproc on your
    > document.
    >
    > Concerning xincludes, the syntax is the same as in DB 4.x, just remember to
    > use the namespace.
    >
    > All this is my vision of the issue, I will let experts precise or correct
    > all if necessary
    >
    > Camille.
    >
    >
    > Karen Schneider wrote:
    >
    >> Hi, I'm reposting a message from Betty, an intern who is subscribed to
    >> this list but having difficulty posting.. Note that I think I have partially
    >> found the answer from the following document,
    >> http://www.docbook.org/docs/howto/ , which includes links to
    >> http://docbook.sourceforge.net/release/xsl-ns/current/ , but I am still
    >> seeking general clarification about why 4.0 seems to be the norm (I mean, to
    >> a newcomer it seems odd that I'd produce 5.0 documents and then process them
    >> back to 4.0?!)... because of a large installed base, or something else?
    >>
    >> Karen G. Schneider
    >>
    >> -------------------------
    >>
    >> From: "Betty Ing" <ingbe@mcmaster.ca <mailto:ingbe@mcmaster.ca>>
    >> To: docbook-apps@lists.oasis-open.org <mailto:
    >> docbook-apps@lists.oasis-open.org>
    >> Date: Tue, 24 Feb 2009 14:58:14 -0500
    >> Subject: DocBook 5 Stylesheets
    >> Hello,
    >>
    >> I have been looking at the "Using XInclude" example in Ch. 23 - Modular
    >> DocBook - of DocBook XSL.
    >>
    >> http://www.sagehill.net/docbookxsl/ModularDoc.html#UsingXinclude
    >>
    >> I would like to create the chapter file and book file using DocBook 5
    >> and DocBook 5 stylesheets. I also plan to use xsltproc. What changes do
    >> I need to make in the xml files, and where can I locate DocBook 5
    >> stylesheets?
    >>
    >> Thanks in advance.
    >>
    >> Betty
    >>
    >>
    >>
    >>
    >> --
    >> --
    >> | 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 <mailto:kgs@esilibrary.com>
    >> | Web: http://www.esilibrary.com
    >> | Be a part of the Evergreen International Conference, May 20-22, 2009!
    >> | http://www.solinet.net/evergreen
    >>
    >


    --
    --
    | 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
    | Be a part of the Evergreen International Conference, May 20-22, 2009!
    | http://www.solinet.net/evergreen



  • 4.  Re: [docbook-apps] Docbook 5.0 and stylesheets

    Posted 05-08-2009 15:23
    I thought I'd try to get an update on the questions responded to in this
    thread from February (responses included below my sig file) because I've
    been asked questions about DocBook that I expect I'll hear more of as we
    continue to discuss the use of DocBook in our project. I also had to
    convince someone who tried xlstproc for the first time that yes, it does
    support 5.0.

    1. Will there be (are there) 5.0 stylesheets?

    2. Is there a projected timetable for DocBook 5 becoming an OASIS standard?
    (I know 4.5 is an OASIS standard.)

    3. If we're starting from scratch (that is, have no legacy DocBook XML), is
    it better to use the namespace-aware stylesheets (the -ns versions)?

    4. Any way to invoke a switch in xsltproc that says "relax, don't worry,
    this is actually working"? ;)

    --
    | 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
    | Be a part of the Evergreen International Conference, May 20-22, 2009!
    | http://www.lyrasis.org/evergreen

    On Wed, Feb 25, 2009 at 3:35 AM, Camille Bégnis <camille@neodoc.biz> wrote:

    > Hello,
    >
    > indeed the picture is a bit blurry at the moment while docbook is migrating
    > from 4.x to 5.0. Some points to try to answer your questions:
    >
    > - 4.x docbook will not evolve anymore, the current standard is now 5.0
    > - 5.0 is not officially an OASIS standard yet, because of administrative
    > reasons only
    > - many people have been using exclusively 5.0 for more than a year without
    > issues.
    > - there are not really 5.0 stylesheets at the moment. Some work is being
    > done on XSLT2 stylesheets, but this is not production ready I believe. So
    > 4.x stylesheets have been adapted to be capable of handling 5.0 documents
    > - 5.0 documents are not exactly processed back to 4.x: it is just that
    > there is a first step that makes some adjustments to the document so it is
    > correctly processed by the stylesheet. However this is transparent to the
    > user. The user just apply the stylesheet once.
    > - there is the namespace aware stylesheet version (-ns) that is specific to
    > 5.0 but basically based on the standard stylesheet.tax
    >
    > So in short: just apply current -ns stylesheet with xsltproc on your
    > document.
    >
    > Concerning xincludes, the syntax is the same as in DB 4.x, just remember to
    > use the namespace.
    >
    > All this is my vision of the issue, I will let experts precise or correct
    > all if necessary
    >
    > Camille.
    >
    >