OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: 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


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]