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: new user and issue with 'article'


Hi,
I just started using docbook, seen it's results many times over the years, 
love the resulting documents. I am using gemdoc on xp for processing, and 
html-kit for editing.

My first forays into docbook were simple one-page bits of troubleshooting 
info for our network. I started using the <book> way formatting, then 
after some exploring on the web found a tutorial, now a bit outdated, that 
explained how <article> is differant from <book> for shorter writings. So 
now I am using <article> but I found when I use this -
 
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.1//EN">

I get this error during validation -

Line: 3, Char: 12 Error: element "ARTHEADER" undefined

and when I use this - 

<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V5.0//EN">

I get 27 errors -

Line: 1, Char: 57 Warning: cannot generate system identifier for public 
text "-//OASIS//DTD DocBook V5.0//EN"
Line: 1, Char: 57 Error: reference to entity "ARTICLE" for which no system 
identifier could be generated
Line: 1, Char: 0: entity was defined here
Line: 1, Char: 57 Error: DTD did not contain element declaration for 
document type name
Line: 2, Char: 10 Error: element "ARTICLE" undefined
Line: 3, Char: 12 Error: element "ARTHEADER" undefined
Line: 4, Char: 9 Error: element "TITLE" undefined
Line: 5, Char: 9 Error: element "AUTHOR" undefined
Line: 6, Char: 16 Error: element "FIRSTNAME" undefined
Line: 7, Char: 14 Error: element "SURNAME" undefined
Line: 8, Char: 18 Error: element "AFFILIATION" undefined
Line: 9, Char: 12 Error: element "ORGNAME" undefined
Line: 10, Char: 14 Error: element "ORGDIV" undefined
Line: 13, Char: 14 Error: element "COPYRIGHT" undefined
Line: 14, Char: 11 Error: element "YEAR" undefined
Line: 15, Char: 13 Error: element "HOLDER" undefined
Line: 17, Char: 14 Error: element "PUBLISHER" undefined
Line: 18, Char: 20 Error: element "PUBLISHERNAME" undefined
Line: 21, Char: 10 Error: element "WARNING" undefined
Line: 21, Char: 16 Error: element "PARA" undefined
Line: 22, Char: 15 Error: element "ORDEREDLIST" undefined
Line: 23, Char: 13 Error: element "LISTITEM" undefined
Line: 23, Char: 19 Error: element "PARA" undefined
Line: 24, Char: 11 Error: element "LISTITEM" undefined
Line: 24, Char: 17 Error: element "PARA" undefined
Line: 25, Char: 11 Error: element "LISTITEM" undefined
Line: 25, Char: 17 Error: element "PARA" undefined

Both of the above examples use the same .sgml document, listed here -

<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V5.0//EN">
  <article>
    <artheader>
        <title>Karen R. gets error in GL - Unable to print report while 
transactions are being updated</title>
          <author>
             <firstname>Chip</firstname>
             <surname>Wiegand</surname>
             <affiliation>
               <orgname>Simrad, Inc</orgname>
               <orgdiv>IT</orgdiv>
             </affiliation>
          </author>
        <copyright>
          <year>2005</year>
          <holder>Simrad, Inc</holder>
        </copyright>
       <publisher>
         <publishername>Simrad, Inc</publishername>
       </publisher>
    </artheader> 
  <warning><para>Everyone must be either logged out of MAS200 or at the 
Library Master module before running this -</para></warning>
  <orderedlist>
     <listitem><para>On the File menu click on Run</para></listitem>
     <listitem><para>enter this (without the quotes) 'GLWSJA' in all 
caps</para></listitem>
    <listitem><para>Then try running Karens report</para></listitem>
  </orderedlist>
 </article>

When I use this DTD -

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

it validates with no errors. Should I just continue to use this older 
version DTD or what is the fix for my problems above?
Thanks,
Regards,

Chip Wiegand
Computer Services
Simrad, Inc
425-778-8821 
425-771-7211 (FAX)


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