Syntax fout aangetroffen
------------------------

Stel dat je je document hebt aangeleverd via CVS commit <document-naam>
en er komt een mail terug via de lijst dat de Syntax niet correct is, wat
moet je dan doen?

1. Los het zelf op (hieronder uitleg);
2. Vraag een ander het voor je te corrigeren (je kunt het altijd vragen 
   via de lijst of direct aan bokkie@nl.linux.org);

DocBook SGML/XML en LinuxDoc SGML
---------------------------------
   Wanneer je document met CVS-commit wordt aangeleverd wordt eerst
   gecontroleerd of de syntax wel correct is. Je document
   wordt vergeleken met een Document Type Definitie (DTD)
   waarin regels staan waaraan je document moet voldoen. Dit kunnen
   regels zijn over de te gebruiken tags zoals <article>....</article>,
   <emphasis>...</emphasis>, enz als ook over bijvoorbeeld de volgorde
   van deze tags. Met welke DTD je document wordt vergeleken is
   meestal af te lezen uit de eerste regel van het brondocument
   dat je hebt geschreven of vertaald. Er bestaan verschillende 
   programma's om te controleren of je brondocument voldoet aan
   de regels in de DTD. In de scripts op nl.linux.org is dit het
   programma 'nsgmls'. Dit programma is te vinden in het package
   openjade-x.y.z. Stel dat je de CVS-werkdirectory hebt staan
   in /home/bokkie/nldoc/, en het bronbestand in 
   /home/bokkie/nldoc/HOWTO/DocBook-Install-NL.sgml, 
   dan werkt de controle ongeveer als volgt:
   
   nsgmls -s -c /home/bokkie/nldoc/config/catalog \
   /home/bokkie/nldoc/HOWTO/DocBook-Install-NL.sgml
  
  Krijg je hierop geen uitvoer, dan is de Syntax correct.
  De catalog file dient om de juiste DTD op te zoeken die
  in dit geval in n van de subdirectory's te vinden moet zijn 
  in /home/bokkie/nldoc/config/dtd. In de catalog file staat
  het fysieke bestand opgesomd dat relateert aan de eerste
  regel in je bronbestand. 
 
  Als de DTD die je hebt gebruikt, niet voorkomt in de catalog
  file en dan wellicht ook niet in de subdirectory 'dtd' van
  /home/bokkie/nldoc/config/dtd, dan moet je beiden toevoegen.
  
  Bij xml bestanden echter moet voor de bestandsnaam nog een
  verwijzing worden opgenomen naar de xml-declaratie. Een voorbeeld:

  Het bronbestand is: /home/bokkie/nldoc/HOWTO/Print2Win-NL.xml

  nsgmls -s -c /home/bokkie/nldoc/config/catalog \
  /home/bokkie/nldoc/config/xml.dcl \
  /home/bokkie/nldoc/HOWTO/Print2Win-NL.xml

Als je wel uitvoer krijgt, dan moeten de fouten eerst worden
opgelost. In de uitvoer worden de regels waarin de fouten staan
als eerste gegeven, gevolgd door de geconstateerde fout. Deze laatste
foutmelding kan ook nogal eens voortkomen uit een eerder opgetreden fout.
Begin daarom altijd met de eerste regel uitvoer op te lossen, de rest
volgt dan vaak vanzelf.

NB: Het programma 'nsgmls' wordt ook gebruikt bij linux-doc sourcefiles,
hiervoor in de plaats wordt dus niet het programma sgmlcheck van het
sgmltools 1.x package gebruikt!
