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 21:14:46 +0100 To: bsd-novice@bsd-dk.dk
On 18/2-2005, at 12.16, Torben Sørensen wrote:
> Hej Henrik
>
>
> Henrik Lund Kramshøj wrote:
>
>>
>> On 17/2-2005, at 22.04, Torben Sørensen wrote:
>>
>>> 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
>>
>> Hvis der er interesse kan jeg lægge mine Makefiles mv. ud
>
> Ja tak... dem vil jeg gerne se.
http://kramse.dk/files/tmp/dokumentation/
Here there be dragons!
Det er IKKE en færdig præsentation, blot et udpluk af nogle af de filer
som jeg bruger i dagligdagen.
Når jeg skal lave en præsentation i LaTeX laver jeg et nyt katalog,
svarende til eksempel kataloget på ovenstående URL
Derefter sørger jeg for at der er symbolske links til Makefile, mit
images
katalog og reference filer
Se listen fra et rigtigt katalog her:
http://kramse.dk/files/tmp/dokumentation/eksempel/filelisting.txt
Derefter kopierer jeg .tex filer fra en tidligere præsentation og
begynder at fylde på selvepræsentationen og øvelseshæftet
- hvis det er et kursus
Til docbook er det typisk større rapporter som ALTID inddeles
i filer pr kapitel eller lignende
I burde kunne downloade filerne fra eksempel-docbook - installere
openjade og docbook/docbook-xml/docbook-dsssl og tilrette stinavne
(brug /usr/libexec/locate.updatedb efterfulgt at locate xml.dcl osv.)
Derefter kan man bruge openjade via make target validate:
$ make validate
onsgmls -sv
/usr/local/share/sgml/docbook/dsssl/modular/dtds/decls/xml.dcl
security-review.xml
onsgmls:I: OpenSP version "1.3.4"
Så det er en fordel med Docbook - man kan validere før man begynder
at bruge mere tid på at konvertere til RTF (make rtf) eller PDF (make
pdf)
Håber det kan give inspiration :-)
Henrik
PS skulle der blive inkluderet endnu en fil som I vil se indholdet af
så skriv til mig - kan være jeg har glemt en fil eller to for at det
er "komplet"
- jeg er også leveringsdygtig i hele mit setup fra specialet som jeg
skrev i LaTeX - se resultatet på http://www.inet6.dk/thesis.pdf
-- 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