NLO-scripts voor de documentatiesectie
--------------------------------------
De scripts die worden gebruikt voor het omzetten van de sourcefiles
naar de diverse formaten zijn in modules opgezet, dus kunnen eenvoudig
worden aangevuld met eventueel de omzetting van andere sourcefiles.
Vraag me (bokkie@nl.linux.org) erom als je een specifiek probleem hebt, 
waarbij meerdere sourcefiles moeten worden omgezet. Uiteraard zal 
er geen module worden geschreven wanneer het slechts een enkel bestand betreft.

Als je benieuwd bent naar de scripts en ze graag lokaal zou willen
testen, of omdat je lokaal ook graag de beschikking zou willen hebben
over de verschillende formaten van de sourcefiles om ze op je gemak
te kunnen lezen, vraag me er dan om, dan stuur ik ze naar je op
in een tar.gz archief. Hieronder volgen wat aanwijzingen waar je bij
het installeren van de scripts dan op moet letten:

Nodig: CVS, DSSSL, PERL, MYSQL en heel veel diskruimte :-)

Plaats de scripts in een enkele directory in je homedirectory of
directory waar je voldoende permissies hebt (ook in de parent daarvan).
Een voorkeursdirectory zou dus kunnen zijn: /home/username/scripts
Kijk in de module var.pm welke programma's je nodig hebt, die staan
daar allen in opgesomd. De scripts zelf zijn geschreven in Perl,
je hebt Perl dus nodig minimaal versie 5.6.0 vanwege het gebruik van
globale variabelen met de declaratie 'our'. Tevens wordt verwacht
dat je lokaal een CVS repository beschikbaar hebt waarin de sourcefiles
staan (dus de XML/SGML, texi, enz bestanden). Je kunt er ook voor
kiezen een CVS repository aan te maken met slechts je eigen bronbestanden.
De directory waar deze CVS repository is te vinden, kun je weer aanpassen
in var.pm. Zorg daarnaast voor een MySQL database met de structuur zoals
beschreven in intern/nldocs.sql. Eventueel kun je dit bestand gebruiken
om de structuur in MySQL in te lezen. Let hierbij op de juiste permissies!
Let op in var.pm dat je in de directory's die je opgeeft voor webspace en
ftpspace voldoende permissies hebt voordat je het mailfilter script opstart.
Maak op je systeem in ieder geval de groep 'www' aan, waarvan je jezelf
deelnemer maakt.

Test het mailfilter-script allereerst met 'perl -c mailfilter'.
Als dit geen foutmeldingen oplevert, kun je het daadwerkelijk runnen met
./mailfilter.
Als je hebt gekozen voor een volledige CVS repository met alle source-files
dan duurt het errrrrrug lang eer het script klaar is. In de logdirectory
(variabele $logdir) vind je wat logfiles, waarin eventueel opgetreden
fouten zijn vermeld, welke bestanden werden geconverteerd, enz.

Als je geheel opnieuw wilt beginnen met de conversie, dan kun je
alles onder $ftpspace, $webspace, $logdir, $homedir/$cvs_alias
gewoon verwijderen. Vervolgens start je het mailfilter script dan
weer opnieuw op.

Denk er alsjeblieft om dat je bij de omzetting van alle sourcefiles
zeker een paar honderd meg ruimte nodig hebt. O ja, en voor de grapjassen
onder jullie, pas je ook even het mailadres aan in var.pm ? :-)


Installatiescripts op NLO voor de documentatiesectie:
====================================================

Plaats de scripts in de directory /home/www/nl-linux-org/robot/scripts

mkdir -p /home/www/nl-linux-org/robot/scripts
mkdir -p /home/www/nl-linux-org/robot/log

chmod 02775 /home/www/nl-linux-org/robot/log

In subdir scripts:
*.pl bestanden en het mailfilterscript rwx perm voor owner 
*.pl bestanden en het mailfilterscript wx perm voor group
*.pl bestanden en het mailfilterscript geen perm voor other
overige bestanden rw perm voor owner en group, other geen
owner=bokkie; group=www voor files en dir 

mkdir -p /home/ftp/pub/HOWTO
mkdir -p /home/ftp/pub/MISC
mkdir -p /home/ftp/pub/GUIDE
mkdir -p /home/ftp/pub/INFOPAGE
mkdir -p /home/ftp/pub/MANPAGE
chmod 02775 /home/ftp/pub/HOWTO
chmod 02775 /home/ftp/pub/MISC
chmod 02775 /home/ftp/pub/GUIDE
chmod 02775 /home/ftp/pub/INFOPAGE
chmod 02775 /home/ftp/pub/MANPAGE
chown bokkie:www /home/ftp/pub/HOWTO
chown bokkie:www /home/ftp/pub/GUIDE
chown bokkie:www /home/ftp/pub/INFOPAGE
chown bokkie:www /home/ftp/pub/MANPAGE
chown bokkie:www /home/ftp/pub/MISC
mkdir -p /home/www/nl-linux-org/robot/pub
chmod 02775 /home/www/nl-linux-org/robot/pub
chown bokkie:www /home/www/nl-linux-org/robot/pub

In /home/CVS/CVSROOT/loginfo:
^nldoc /home/www/nl-linux-org/robot/scripts/mailfilter &

deactiveren van de regel voor de module 'nlhowto'

Verwijderen files voor bv nieuwe start
======================================
rm -rf /home/ftp/pub/HOWTO/*
rm -rf /home/ftp/pub/GUIDE/*
rm -rf /home/ftp/pub/MISC/*
rm -rf /home/ftp/pub/MANPAGE/*
rm -rf /home/ftp/pub/INFOPAGE/*
rm -rf /home/www/nl-linux-org/robot/pub/*
rm -rf /home/www/nl-linux-org/robot/docs
rm -rf /home/www/nl-linux-org/robot/log

Alleen de directory /home/www/nl-linux-org/robot/docs verwijderen
(niet alleen inhoud, ook de directory zelf) als je een full-report
via mail wilt krijgen, maar gebruikers niet tot last wilt zijn door de
bestanden van de webserver te verwijderen. Wijzig vervolgens een
van de bestanden onder nldoc/ in je werkkopie en commit deze wijziging.
Alle bestanden zullen opnieuw worden geconverteerd en er zal een
CVS_DOC_REPORT per mail worden gezonden naar de nldoc lijst. 
Dit proces duurt minimaal een half uur.

