Advertisement
If you have a new account but are having problems posting or verifying your account, please email us on hello@boards.ie for help. Thanks :)
Hello all! Please ensure that you are posting a new thread or question in the appropriate forum. The Feedback forum is overwhelmed with questions that are having to be moved elsewhere. If you need help to verify your account contact hello@boards.ie
Hi there,
There is an issue with role permissions that is being worked on at the moment.
If you are having trouble with access or permissions on regional forums please post here to get access: https://www.boards.ie/discussion/2058365403/you-do-not-have-permission-for-that#latest

docbook

  • 19-02-2005 5:35pm
    #1
    oscarBravo
    Technology & Internet Moderators Posts: 28,830 Mod ✭✭✭✭


    Does anyone use docbook to write documentation? I've been playing with it for a user manual that I want to make available in HTML and PDF formats. I had it sorta working, but then I broke it.

    My document starts out like this: 
    <!doctype book PUBLIC "-//OASIS//DTD DocBook V4.3//EN" [
]>
<book>
  <bookinfo>
	<date>2005-02-19</date>
    ...and so on. When I run nsgmls to check it out, I get a whole bunch o' nasty stuff like this: 
    nsgmls:I: "OpenSP" version "1.5"
nsgmls:/usr/share/sgml/docbook/sgml-dtd-4.3/dbpoolx.mod:815:17:E: character ":" invalid: only "CDATA", "ENTITIES", "ENTITY", "ID", "IDREF", "IDREFS", "NAME", "NAMES", "NMTOKEN", "NMTOKENS", "NOTATION", "NUMBER", "NUMBERS", "NUTOKEN", "NUTOKENS" and parameter separators allowed
nsgmls:/usr/share/sgml/docbook/sgml-dtd-4.3/dbpoolx.mod:835:17:E: character ":" invalid: only "CDATA", "ENTITIES", "ENTITY", "ID", "IDREF", "IDREFS", "NAME", "NAMES", "NMTOKEN", "NMTOKENS", "NOTATION", "NUMBER", "NUMBERS", "NUTOKEN", "NUTOKENS" and parameter separators allowed
    ...ad nauseam.

    I don't really understand all this SGML stuff. Can anyone give me some pointers as to what the hell I'm doing wrong here? Ta.


Comments

  • #2
    phil
    Registered Users, Registered Users 2 Posts: 568 ✭✭✭phil


    are the errors on your own files or system files?

    What way are you running nsgmls?


  • #3
    oscarBravo
    Technology & Internet Moderators Posts: 28,830 Mod ✭✭✭✭oscarBravo


    The error was on the system file dbpoolx.mod. I don't even know why it was using this file; I'm not using XML.

    I worked around it by switching from 4.3 to 4.1 - it does all I need it to do. I'm still getting my head around some aspects of it. For example, if I use the wrapper script docbook2pdf, I get a nice neat .pdf - except the graphics don't appear. If I manually run jade, jadetex, dvips and ps2pdf, it works fine. Strange.


Advertisement