docbook-apps

  • 1.  Re: [docbook-apps] Modular DocBook still not working

    Posted 04-03-2009 14:45
    Hi Betty,

    > Thanks to Remko, Camille, and Thomas for your suggestions. I have since
    > modified SectionA and SectionB accordinly; Chapter is still the same as
    > before.
    >
    > I am still getting the following errors:
    > [...]
    > What else am I still missing? Suggestions are welcome.

    Your XML files are still invalid. I've attached a diff between old and new
    version. Hope that helps you. If you have question, don't hesitate. :-)

    Before you can apply any stylesheet, make sure your whole document is valid.


    Tom




  • 2.  Re: [docbook-apps] Modular DocBook still not working

    Posted 04-03-2009 15:52
    Hi Thomas,

    You are correct that I should be validating all the files before
    applying a style sheet. SectionA and SectionB do validate now with
    XMLmind. Chapter.xml does not contain any fatal error; however, there
    is an Info pop-up obtained on validation. I have attached the pop-up
    and the two revised sections. Chapter.xml has not changed (still 2001
    date for XInclude).

    After the transform, I'm still getting the initial errors, that is:

    -----

    Element include in namespace 'http://www.w3.org/2001/XInclude'
    encountered in chapter, but no template matches.

    Element include in namespace 'http://www.w3.org/2001/XInclude'
    encountered in chapter, but no template matches.

    Writing index.html for chapter

    -----

    What next???

    Betty


    On Fri, 03 Apr 2009 16:45:17 +0200
    Thomas Schraitle <tom_schr@web.de> wrote:
    > Hi Betty,
    >
    > > Thanks to Remko, Camille, and Thomas for your suggestions. I have
    > since
    > > modified SectionA and SectionB accordinly; Chapter is still the
    > same as
    > > before.
    > >
    > > I am still getting the following errors:
    > > [...]
    > > What else am I still missing? Suggestions are welcome.
    >
    > Your XML files are still invalid. I've attached a diff between old
    > and new
    > version. Hope that helps you. If you have question, don't hesitate.
    > :-)
    >
    > Before you can apply any stylesheet, make sure your whole document is
    > valid.
    >
    >
    > Tom
    >


    </tom_schr@web.de>

    Attachment(s)

    doc
    Info pop.doc   39 KB 1 version
    xml
    SectionB.xml   1 KB 1 version
    xml
    SectionA.xml   2 KB 1 version


  • 3.  Re: [docbook-apps] Modular DocBook still not working

    Posted 04-03-2009 16:02
    Hmm don't always rely on XMLMind to validate the same way the parser does.
    I am using Mind and find though good it does not always catch errors that
    the parser does. What version of xslt are you using? xalan that is? or
    other?



    "Betty Ing"
    <ingbe@mcmaster.c
    a> To
    "Thomas Schraitle"
    04/03/2009 10:51 <tom_schr@web.de>,
    AM docbook-apps@lists.oasis-open.org,
    "Betty Ing" <ingbe@mcmaster.ca>
    cc

    Subject
    Re: [docbook-apps] Modular DocBook
    still not working










    Hi Thomas,

    You are correct that I should be validating all the files before
    applying a style sheet. SectionA and SectionB do validate now with
    XMLmind. Chapter.xml does not contain any fatal error; however, there
    is an Info pop-up obtained on validation. I have attached the pop-up
    and the two revised sections. Chapter.xml has not changed (still 2001
    date for XInclude).

    After the transform, I'm still getting the initial errors, that is:

    -----

    Element include in namespace 'http://www.w3.org/2001/XInclude'
    encountered in chapter, but no template matches.

    Element include in namespace 'http://www.w3.org/2001/XInclude'
    encountered in chapter, but no template matches.

    Writing index.html for chapter

    -----

    What next???

    Betty


    On Fri, 03 Apr 2009 16:45:17 +0200
    Thomas Schraitle <tom_schr@web.de> wrote:
    > Hi Betty,
    >
    > > Thanks to Remko, Camille, and Thomas for your suggestions. I have
    > since
    > > modified SectionA and SectionB accordinly; Chapter is still the
    > same as
    > > before.
    > >
    > > I am still getting the following errors:
    > > [...]
    > > What else am I still missing? Suggestions are welcome.
    >
    > Your XML files are still invalid. I've attached a diff between old
    > and new
    > version. Hope that helps you. If you have question, don't hesitate.
    > :-)
    >
    > Before you can apply any stylesheet, make sure your whole document is
    > valid.
    >
    >
    > Tom
    >

    [attachment "Info pop.doc" deleted by Tom Towle/IL/HCSC] [attachment
    "SectionA.xml" deleted by Tom Towle/IL/HCSC] [attachment "SectionB.xml"
    deleted by Tom Towle/IL/HCSC]
    ---------------------------------------------------------------------
    To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
    For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org



    **********

    The information contained in this communication is confidential, private, proprietary, or otherwise privileged and is intended only for the use of the addressee. Unauthorized use, disclosure, distribution or copying is strictly prohibited and may be unlawful. If you have received this communication in error, please notify the sender immediately at (312)653-6000 in Illinois; (800)835-8699 in New Mexico; (918)560-3500 in Oklahoma; or (972)766-6900 in Texas.

    **********




  • 4.  Re: [docbook-apps] Modular DocBook still not working

    Posted 04-03-2009 16:21
    Hi,

    On Freitag, 3. April 2009, Betty Ing wrote:
    >
    > You are correct that I should be validating all the files before
    > applying a style sheet. SectionA and SectionB do validate now with
    > XMLmind. Chapter.xml does not contain any fatal error; however, there
    > is an Info pop-up obtained on validation. I have attached the pop-up
    > and the two revised sections. Chapter.xml has not changed (still 2001
    > date for XInclude).
    >
    > After the transform, I'm still getting the initial errors, that is:
    >
    > -----
    >
    > Element include in namespace 'http://www.w3.org/2001/XInclude'
    > encountered in chapter, but no template matches.
    > [...]

    If you are sure, your files are valid, you have to use an option in your
    XML parser to resolves XInclude elements through the referenced file.

    For example, xmllint from the libxml2 library has the option --xinclude.
    In your case, to get a file all.xml where all XIncludes are resolved,
    write:

    $ xmllint --output all.xml --xinclude Chapter.xml

    Validate the file all.xml with jing, for example.

    On the other hand, you need to use the same option to resolve the XInclude
    in the transformation process. For example, xsltproc from the libxslt
    library has also an option --xinclude:

    $ xsltproc --output Chapter.html --xinclude \
    .../html/docbook.xsl Chapter.xml

    It works for me with the previous command.


    Tom

    --
    Thomas Schraitle



  • 5.  RE: [docbook-apps] Modular DocBook still not working

    Posted 04-03-2009 17:25
    Betty,

    I was able to take the files you attached to this message
    (i.e., the ones with the syntax errors fixed), along with
    the original Chapter.xml file, and successfully build html
    output using xsltproc. I used the following command line:

    xsltproc --xinclude path-to-stylesheets/html/chunk.xsl Chapter.xml

    where path-to-stylesheets is the directory that contains the
    standard stylesheets. I was running on Linux, with the latest
    stylesheet distribution.

    To help debug the problem, can you post some additional
    information about your environment? In particular, OS,
    version of the docbook stylesheets, version of xsltproc?

    Also, are you running the stylesheets from inside xmlmind,
    from the command line, or in some other way?

    Best Regards,
    Dick Hamilton
    Managing Writers: A Real World Guide to Managing Technical Documentation
    http://xmlpress.net/managingwriters.html

    >


  • 6.  Re: [docbook-apps] Modular DocBook IS WORKING!

    Posted 04-03-2009 18:40
    Dick,

    Thank you for including your command line, which is where my problem
    lies. One of the first people who responded to my post asked me about
    xinclude for the style sheets, but since I'm new to DocBook, I didn't
    realize that it also serves as a switch for the xsltproc command. Using
    your command line, I was also able to obtain html with correct section
    navigation. Despite the errors, I previously did obtain html output as
    well, but just without section navigation.

    Fyi, I'm running Windows XP Version 2002 SP3. Libxslt, which includes
    xsltproc.exe is 1.1.24. DocBook-xsl style sheets are 1.74.0
    (2008-06-02).

    We built a GUI to run the style sheets and will need to modify it to
    accommodate switches. For now, it's just the command line.

    Since it has taken some time to resolve my problem, where would I have
    found a complete example for what I was trying to accomplish? I didn't
    think that integrating a few sections into a chapter would pose any
    major problems, but that was not the case. For the newly initiated,
    complete tested examples are the best, rather than excerpts here and
    there depending on certain options. These options can follow once we
    have a working example.

    On this note, thanks to you and the others who have helped in solving
    my modular DocBook problem.

    Betty




    On Fri, 3 Apr 2009 11:25:07 -0600
    "Dick Hamilton" <rlhamilton@frii.com> wrote:
    > Betty,
    >
    > I was able to take the files you attached to this message
    > (i.e., the ones with the syntax errors fixed), along with
    > the original Chapter.xml file, and successfully build html
    > output using xsltproc. I used the following command line:
    >
    > xsltproc --xinclude path-to-stylesheets/html/chunk.xsl Chapter.xml
    >
    > where path-to-stylesheets is the directory that contains the
    > standard stylesheets. I was running on Linux, with the latest
    > stylesheet distribution.
    >
    > To help debug the problem, can you post some additional
    > information about your environment? In particular, OS,
    > version of the docbook stylesheets, version of xsltproc?
    >
    > Also, are you running the stylesheets from inside xmlmind,
    > from the command line, or in some other way?
    >
    > Best Regards,
    > Dick Hamilton
    > Managing Writers: A Real World Guide to Managing Technical
    > Documentation
    > http://xmlpress.net/managingwriters.html
    >
    > >


  • 7.  RE: [docbook-apps] Modular DocBook IS WORKING!

    Posted 04-03-2009 19:23
    Betty,

    I'm glad it's working.

    Regarding your question, usually, Bob Stayton's book has
    the kinds of detailed examples you need. This may be the
    rare exception.

    Other places to look for information include Dave Pawson's
    DocBook FAQ (http://www.dpawson.co.uk/docbook/) and the
    DocBook WIKI (http://wiki.docbook.org). Finally, you can
    often get good information searching the docbook mailing
    list archives (http://docbook.org/help). Turns out that
    none of them contains the exact command line you need (or
    at least, I couldn't find it in a quick search), but most
    of the time you can get a good head start, and of course
    the list, as you've seen, will also respond.

    All that said, I think there is a need for a primer/cookbook
    for DocBook to cover some of these basic things.

    Best Regards,
    Dick Hamilton

    Managing Writers: A Real World Guide to Managing Technical Documentation
    http://xmlpress.net/managingwriters.html

    >


  • 8.  Re: [docbook-apps] Modular DocBook IS WORKING!

    Posted 04-03-2009 19:52
    Dick,

    If there is not such a primer already, it would be an opportunity for
    someone to pursue...

    Many thanks for the tips!

    Betty


    On Fri, 3 Apr 2009 13:23:21 -0600
    "Dick Hamilton" <rlhamilton@frii.com> wrote:
    > Betty,
    >
    > I'm glad it's working.
    >
    > Regarding your question, usually, Bob Stayton's book has
    > the kinds of detailed examples you need. This may be the
    > rare exception.
    >
    > Other places to look for information include Dave Pawson's
    > DocBook FAQ (http://www.dpawson.co.uk/docbook/) and the
    > DocBook WIKI (http://wiki.docbook.org). Finally, you can
    > often get good information searching the docbook mailing
    > list archives (http://docbook.org/help). Turns out that
    > none of them contains the exact command line you need (or
    > at least, I couldn't find it in a quick search), but most
    > of the time you can get a good head start, and of course
    > the list, as you've seen, will also respond.
    >
    > All that said, I think there is a need for a primer/cookbook
    > for DocBook to cover some of these basic things.
    >
    > Best Regards,
    > Dick Hamilton
    >
    > Managing Writers: A Real World Guide to Managing Technical
    > Documentation
    > http://xmlpress.net/managingwriters.html
    >
    > >