From: Henrik Lund Kramshøj <none@hlk--kramse.dk.lh.bsd-dk.dk> Subject: Re: Dokumentation.. hvad gør jeg? Date: Fri, 18 Feb 2005 10:34:18 +0100 To: bsd-novice@bsd-dk.dk
On 17/2-2005, at 22.04, Torben Sørensen wrote:
> Hej folks
>
> Jeg sidder og lægger sidste hånd på et CMS lavet i PHP og vil gerne
> lave noget dokumentation...
> Jeg hørte engang Peter Toft snakke noget om DocBook... men hvordan får
> jeg det installeret og kommer i gang med det?
> Kan jeg bruge vejledningen på linuxbog.dk eller skal man gøre noget
> specielt på FBSD?
>
> Er der andre dokumentationsværktøjer der kan bruges?
>
> OS: FreeBSD 5.3
Jeg har brugt LaTeX i mange år og brugt meget tid på Docbook XML
Begge dele er suveræne!
LaTeX er nemmere at komme igang med - du kan betale 50,- til den danske
brugergruppe og få en lækker DVD med LaTeX og en masse pakker
- samt nem installation
På vores BSD'er kan man selvfølgelig også bruge ports
Med LaTeX laver du en smule opsætning i starten af dit projekt
- låner eventuelt en opsætning og udvider efterhånden som du får
lyst ;-)
LaTeX er dejligt til "interne" ting - dvs hvor det kun er MIG
der retter og med pdflatex kommer det ud i PDF direkte.
Til gengæld har jeg haft behov for at aflevere ting som
underleverandører
som skal videreforarbejdes ... dvs skulle finde et fælles format
Planen var at lave Docbook XML og så lade "kunden" - et andet firma
bruge Open Office eller Word (Word har jo XML så alt virker lalalala
MARKETING)
Jeg endte med at bruge Docbook XML og så lave PDF til afleveringer
og RTF som underleverandør
- og det virker faktisk!
Mit niveau i Docbook XSL stylesheets er dog stadig begrænset så
output er ikke helt på niveau med mine LaTeX rapporter
- selvom TeX bruges nedenunder
På FreeBSD findes der vist en meta-port docproject eller noget
- læs om docproject på FreeBSD siderne, der er vist også noget intro
materiale
Konklusion
Begge dele adskiller præsentation fra indhold og begge dele kan
nemt splittes til seperate filer, styres med Makefile's, inkludere
eksterne filer/udklip osv.
LaTeX giver pt det bedste og flotteste output for mig
Docbook XML giver mulighed for at skrive med EMACS og levere
RTF som andre kan åbne med Word
Hvis der er interesse kan jeg lægge mine Makefiles mv. ud
(drømmer om at lave et hyggemøde med gennemgang af de værktøjer
som jeg som freelance konsulent bruger - jeg er omtrent 100%
afhængig af Open Source!)
Mvh
Henrik
-- Henrik Lund Kramshøj, cand.scient, CISSP e-mail: hlk@security6.net, tlf: 2026 6000 www.security6.net - IPv6, sikkerhed, netværk og UNIX
This archive was generated by hypermail 2b30 : Wed 15 Nov 2006 - 18:25:11 CET