This is the mail archive of the docbook-apps@lists.oasis-open.org mailing list .


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [docbook-apps] reference man pages as both seperate files + linkedinto one document


That helps! I thought it was something basic. I changed it to be

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd";>

but I'm still having problems. If I run:

xmllint --xinclude --outfile new.sgml RefMan.sgml

I get no errors. But when I try to convert to html I have this problem:

prompt% docbook2html new.sgml
Using catalogs: /etc/sgml/xml-docbook-4.2-1.0-17.cat
Using stylesheet: /usr/share/sgml/docbook/utils-0.6.12/docbook-utils.dsl#html
Working on: /home/mcooper/mc/obj/sysinfo/main/redhat-9/doc/RefMan/new.sgml
jade:/home/mcooper/mc/obj/sysinfo/main/redhat-9/doc/RefMan/new.sgml:2:115:E: URL not supported by this version
jade:/home/mcooper/mc/obj/sysinfo/main/redhat-9/doc/RefMan/new.sgml:2:115:E: DTD did not contain element declaration for
document type name
jade:/home/mcooper/mc/obj/sysinfo/main/redhat-9/doc/RefMan/new.sgml:4:5:E: element "book" undefined
jade:/home/mcooper/mc/obj/sysinfo/main/redhat-9/doc/RefMan/new.sgml:5:11:E: element "bookinfo" undefined
jade:/home/mcooper/mc/obj/sysinfo/main/redhat-9/doc/RefMan/new.sgml:6:21:E: there is no attribute "fileref"
jade:/home/mcooper/mc/obj/sysinfo/main/redhat-9/doc/RefMan/new.sgml:6:69:E: there is no attribute "align"
jade:/home/mcooper/mc/obj/sysinfo/main/redhat-9/doc/RefMan/new.sgml:6:78:E: element "graphic" undefined
....


The new.sgml file (output from xmllint) starts with:

<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd";>
<!-- $Revision$ -->
<book>
<bookinfo>
....


I'm able to manually pull down http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd.

If I remove the DOCTYPE from the original RefMan.sgml I have problems because I can't validate the content during the docbook2html.

Any suggestions?

mike

John L. Clark wrote:
On Tue, Feb 24, 2004 at 10:50:56AM -0800, Mike Cooper wrote:

Ahhh. That's just what I'm looking for. Unfortunately I'm having trouble now with xmllint. :-(

When I run "xmllint --postvalid --xinclude RefMan.sgml" I get:

RefMan.sgml:1: parser error : Space required after the Public Identifier
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
                                                     ^
RefMan.sgml:1: parser error : SystemLiteral " or ' expected
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
                                                     ^
RefMan.sgml:1: parser error : SYSTEM or PUBLIC, the URI is missing
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN">

I've fiddled with the prolog and can't seem to see why it's complaining.


This might be an SGML/XML difference, but your document is not valid
XML; I'm sorry I didn't notice it the first time through.  It's
reasonably straightforward to fix - a public external identifier must
have an accompanying system identifier[0].  A system identifier is
typically a URL that can be used to obtain a copy of the constraining
DTD.  Note that the whole DocType declaration is optional[1]; having one
facilitates validation.  The fix is to replace

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN">

(which is a public identifier without the system identifier, and which
explains the parser errors you are getting) with

    <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN"
    "http://www.oasis-open.org/docbook/xml/3.1/docbookx.dtd";>

or to remove it entirely.

You also might want to upgrade your DocBook version references, as there
is no supported XML version of DocBook prior to 4.0 (hence, the above
system identifier may not address an actual document).  For the most
recent version, 4.2, this would look like:

    <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd";>

Take care,

John L. Clark

[0] http://www.w3.org/TR/2004/REC-xml-20040204/#NT-ExternalID

[1] http://www.w3.org/TR/2004/REC-xml-20040204/#NT-prolog

To unsubscribe from this list, send a post to docbook-apps-unsubscribe@lists.oasis-open.org, or visit http://www.oasis-open.org/mlmanage/.



Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]