Beschijving van het database formaat. 26 aug 99, Maarten(steenbrg@nl.linux.org)
Eerst maar eens een voorbeeldrecord, zodat je weet welke regel waarvoor staat:
Wat het id is maakt niet uit, zolang het maar een uniek getal is.
De DATABASE file staat nu in volgorde van id. Als iedereen altijd achteraan
toevoegt, en het id 1 hoger maakt dan de vorige, gaat het altijd goed.

           id: 69
        titel: NT OS Loader + Linux
       auteur: Bernd Reichert
     vertaler: Ellen Bokhorst
       versie: v1.11, 2 September 1997
          URL: http://www.nl.linux.org/doc/HOWTO/Linux+NT-Loader-NL.html
     abstract: Dit document beschrijft het gebruik van de Windows NT bootloader om Linux op te starten.
         mail: reichert@dial.eunet.ch
mail_vertaler: bokkie@nl.linux.org
     docsoort: 2
       doccat: 7
   docproject: 2
     keywords: windowsnt bootloader

mysql> select id, soort from docsoort;
+----+-------------+
| id | soort       | Formaat				Directory
+----+-------------+
|  1 | HOWTO       | (linuxdoc/docbook 'article')	HOWTO
|  2 | ""          | was mini-HOWTO, komen te vervallen
|  3 | FAQ/VVV     | (linuxdoc/docbook 'article')	HOWTO
|  4 | artikel     | externe website
|  5 | Manpage     | (manpage formaat)			MANPAGE
|  6 | webpage     | externe website
|  7 | handleiding | laTeX manual (als GUIDE)		MANUAL
|  8 | tutorial    | laTeX manual (als HOWTO)		TUTORIAL
|  9 | GUIDE       | (linuxdoc/docbook 'book')		GUIDE
| 10 | GNU/Info    | texinfo formaat			INFOPAGE
| 11 | Overig      | bv in ASCII- of HTML-formaat	MISC
+----+-------------+
mysql> select * from doccat;
+----+--------------------+---------------------------------------------------
| id | categorie          | beschrijving                                      
+----+--------------------+---------------------------------------------------
|  1 | algemeen           | Algemene documenten (niet Linux specifiek)        
|  2 | distributies       | Distributie specifieke documenten.                
|  3 | document structuur | LinuxDoc/DocBook DTD SGML, LaTeX e.d.             
|  4 | emulator           | Dosemu, Wine etc..                                
|  5 | kernel             | Kernel (compilen, kerneld, modprobe etc...)       
|  6 | netwerk            | Netwerken en het configureren van netwerk services
|  7 | installatie        | Installatie van Linux (naast andere Operating Syst
|  8 | ISP                | Het configureren van Linux voor bepaalde Internet 
|  9 | spellen            | Games, configuratie installatie tips etc..        
| 10 | configuratie       | Algemene configuratie documenten.                 
| 11 | mail               | Mail configuratie (sendmail + m4, procmail, exim e
| 12 | news               | Newsconfiguratie.                                 
| 13 | X Window System    | Over het X Window systeem (X11)                   
| 14 | systeem            | systeemtaken zoals diskquota,printen hardware inst
| 15 | geluid             | Soundcards, MIDI e.d.                             
| 16 | applicaties        | Over verschillende Unix applicaties               
| 17 | beginners          | Informatie voor beginnende gebruikers             
| 18 | Programmeren       | Programmeren onder Linux
+----+--------------------+---------------------------------------------------
mysql> select * from docproject;
+----+--------------+---------------------------------------------------------
| id | project      | beschrijving                                            
+----+--------------+---------------------------------------------------------
|  0 | (geen)          | Documenten die niet onder een bepaald project of groep
|  1 | NLLDP           | Nederlandse Linux Documentatie Project                  
|  2 | NL.Linux.org    | Het NL.Linux.ORG documentatie team.                     
|  3 | Linux-NL.CX     | De documentatie van de Linux-NL.CX site.                 
|  4 | Linux.gelrevision.nl | GelreVision LInux support site
+----+--------------+---------------------------------------------------------

Aanvulling: 21 nov 99 J-W Smaal <smaal@nl.linux.org>
Velden (zoals abstract en keywords) moeten op een *enkele* regel staan, velden 
worden gescheiden door een "\n" (enkele newline).  Records worden gescheiden 
door "\n\n"  (twee keer een newline).


URL's van lokale bestanden:

De structuur van nldoc is drastisch gewijzigd sinds de invoering van
DocBook conversies met nog meer conversies in aantocht van andere 
documentformaten dan SGML/XML DocBook sourcefiles. Zie voor meer 
informatie over deze structuur het bestand nldoc/README. Het is nu
mogelijk afbeeldingen en voorbeeldscripts in een subdir te plaatsen
met het sourcedocument zelf. Deze afbeeldingen en/of voorbeeldscripts
worden dan getarred/gezipt in een eigen sgml.tar.gz/xml.tar.gz archief, 
n met de broncode en n in het htmlformaat voor de gebruikers op te 
halen via FTP. Dit betekent dus ook dat je je bronbestand zonder
problemen kunt opsplitsen in meerdere bestanden zolang je deze maar
in een eigen subdir onder HOWTO of GUIDE plaatst.

Na een commit wordt het sourcebestand of de meerdere sourcebestanden
in een eigen subdir geconverteerd naar de formaten:
DVI, PDF, PS, HTML, ONEHTML, TXT (later komt hier nog RTF bij).
Meerdere uitvoerbestanden worden geplaatst in een tar-archief.
De volledige source wordt geplaatst in een tar-archief, te verkrijgen via
FTP, en in de webspace als losse sourcefile(s) in een eigen directory als
het er meerdere zijn.

Welke URL je in de DATABASE-file plaatst voor sourcefiles op nl.linux.org
is sterk afhankelijk van het formaat en een eventueel gebruikte subdir:

DocBook SGML: Ga er vanuit dat het html-formaat in een aparte subdir wordt
geplaatst ongeacht of het document onder de directory GUIDE of HOWTO in een
subdir staat. Het eerste in te lezen bestand door een browser heeft de naam
van het type document (zoals article, book) van de gebruikte DTD. 
De URL wordt in een dergelijk geval bijvoorbeeld:

http://nl.linux.org/doc/HOWTO/Naam-HOWTO-NL/article.html
of
http://nl.linux.org/doc/GUIDE/Naam-GUIDE-NL/book.html

LinuxDoc SGML: Sourcefiles in een aparte dir onder de subdir HOWTO of GUIDE/sgml
krijgen in webspace ook een eigen subdir. De naam van het document blijft
gelijk, afgezien van de extensie die verandert in .html.
De url wordt in dit geval

http://nl.linux.org/doc/HOWTO/Naam-HOWTO-NL/Naam-HOWTO-NL.html

LinuxDoc SGML sourcefiles die direct onder de subdir HOWTO/ worden geplaatst,
behouden gewoon hun eigen naam en de URL wordt daarom:

http://nl.linux.org/doc/HOWTO/Naam-HOWTO-NL.html

Als je er niet uitkomt welke URL je in de DATABASE moet gebruiken, wacht
dan even totdat je het CVS_REPORT per mail binnenkrijgt, waarin de URL
van het document staat vermeld zoals deze moet zijn, je kunt als je
even online blijft tijdens het bekijken van deze mail dan gelijk even
kijken of het document eruit ziet zoals je bedoeling was (en of een
eventuele conversie is geslaagd!)

Let er bij sourcefiles in eigen subdirs alsjeblieft op dat je voor de
documentnaam exact dezelfde naam gebruikt als voor de subdir. Onder de 
CVS werkdirectory krijg je dan bijvoorbeeld een directory als:

HOWTO/PPP-pap/PPP-pap.sgml
of 
HOWTO/DocBook-Install-NL/DocBook-Install-NL.sgml

---------------------------------------------------------------------------
Per veld kan in de DATABASE file niet meer worden gebruikt dan 255 tekens!
---------------------------------------------------------------------------
Aanvulling dec 2002: Ellen Bokhorst, bokkie@nl.linux.org
