wiki.smarken.dk - linuxbog:dokumentation

anvendte-elementer

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige næste ---------- Appendiks A. Elementer anvendt i denne bog For at skrive denne bog har vi anvendt følgende elementer. Der er til venstre angivet hvor mange gang det enkelte element blev anvendt. DocBook har mange elementer, men du kan jo starte med at lære de nævnte elementer i denne rækkefølge.

c1211

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige næste ---------- Kapitel 3. DocBook i XML : Ett konkret exempel Autogenerering av databasbeskrivning Autogenerering av databasbeskrivning Här skall vi prova att sätta DocBook i arbete, och samtidigt prova köra DockBook i XML istället för SGML. Vi tänker oss att vi jobbar med en relativt stor databas, som dessutom genomgår förändringar ibland. Vi vill kunna ta ut, automatiskt, ett dokument som beskrive…

docbook-compile

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 2. DocBook næste ---------- 2.3. Oversætte SGML til andre formater Du kan oversætte SGML filerne til HTML, PDF, Postscript og RTF. Der er også mulighed for at vælge at oversætte SGML til én

docbook-epilog

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 2. DocBook næste ---------- 2.5. Epilog Har du brug for at se flere SGML eksempler, så se f.eks.[|www.linuxbog.dk/linuxbog/friheden]. Tilsvarende er der en del eksempler i/usr/lib/sgml/stylesheets/nwalsh-modular/doc.

docbook-igang

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 2. DocBook næste ---------- 2.2. Igang med Docbook Når man skal igang med docBook er det nemmest at have en model, en tom ramme, som man så kan starte med at skrive i med det samme. Du kan for eksempel fjerne alle paragraffer i eksemplet, som følger med denne bog, og skrive i de rensede filer.

docbook-pakker

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 2. DocBook næste ---------- 2.4. De forskellige dele af docbook-systemet Her er en kort beskrivelse af de dele, som indgår i docbook systemet. Et dokument system består af tre dele:

docbook

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige næste ---------- Kapitel 2. DocBook DocBook er et sæt af stylesheets, som beskriver hvordan man laver en bog, artikel eller lignende ud af tekstfiler. DocBook er ligesom LaTeX således

dokumentation-apprevhist

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige næste ---------- Appendiks B. Versionshistorie for bogen Igennem tiden har bogen udviklet sig meget. Vi frigiver ofte nye versioner, når der er kommer en del rettelser ind, eller nye afsnit er blevet skrevet. Kommentarer, ris og ros, og specielt fejl og mangler bedes sendt tillinuxbog@sslug.dk, men er du medlem af SSLUG så skriv tilsslug-bog@sslug.dk. Her er en liste over, hvad der er ændret i bogen.…

dokumentation-forord

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige næste ---------- Forord Når man skal skrive bøger så kan man vælge mange forskellige måder. I denne bog vil vi gennemgå nogle af dem. Hvis man er typen der vil arbejde med teksten præcist som den kommer til at se ud på tryk, så skal man have fat i Abiword, KWord eller OpenOffice.org, der ikke bliver beskrevet i denne bog. Vi vil beskrive systemene DocBook/XML,

dokumentation-omos

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Forord næste ---------- 3. Om forfatterne og bogens historie Figur 2. Peter Toft {linuxbog:dokumentation:pto.png} Peter Toft er civilingeniør og har en Ph.D.-grad fra DTU. Han har kørt Linux dagligt siden 1994. Aktiv Linuxforfatter og foredragsholder om Linux i Danmark og Sverige. Tidligere bestyrelsesformand for SSLUG. Medorganisator ved de danske Linux-konferencer (Linux98, Open Networks 99, Linu…

dokumentation-ophavsret

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Forord næste ---------- 2. Ophavsret Denne bog er skrevet af Linux-brugere til Linux-brugere. Store dele af bogen er skrevet eller redigeret af enkelte forfattere, hvilket er nævnt i revisions-historien til bogen.

dokumentation-tak

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Forord næste ---------- 4. Vi siger tak for hjælpen Vi har haft stor glæde af mange SSLUG-medlemmers støtte, rettelser og forslag til forbedringer - bliv ved med dette. Specielt vil vi nævne:

dokumentation-typografi

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Forord næste ---------- 5. Typografi Vi vil afslutte indledningen med at nævne den anvendte typografi. * Navne på filer og kataloger skrives somfoo.bar * Kommandoer, du udfører ved at taste, skrives som

ftav-byg-fra-db

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 6. Fremstilling af “Friheden til at vælge” bøgerne næste ---------- 6.2. Bygning af bøgerne fra kildekode Der er relativt få grunde til at bygge bøgerne selv fra kildekode. Her opsummerer vi et par af de årsager der kan være.

ftav-cvsadgang

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 6. Fremstilling af “Friheden til at vælge” bøgerne næste ---------- 6.3. Adgang til kildekoden fra CVS For at få adgang til bøgerne via CVS, skal du vise at du vil være aktiv og kan arbejde ansvarligt med bøgerne :) Få login på tyge.sslug.dk ved at skrive til Peter Toft

ftav-mere-byg-bog

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 6. Fremstilling af “Friheden til at vælge” bøgerne næste ---------- 6.6. Mere om bygning af bøgerne fra CVS Dette afsnit er til dig der har fået CVS adgang, eller dig der har haft det igennem et stykke tid, men gerne vil vide hvordan byggesystemet fungerer (eller forsøger at fungere).

ftav-scripts

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 6. Fremstilling af “Friheden til at vælge” bøgerne næste ---------- 6.7. Specialudviklede scripts Til brug for den automatiske bygning af bøgerne, har det været nødvendigt at udvikle specielle scripts. Nogle af scriptne er som sådan ikke nødvendige for at bygge bøgerne, men de hjælper læseren til bedre at læse bogen.

ftav-skrivevejl

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 6. Fremstilling af “Friheden til at vælge” bøgerne næste ---------- 6.5. Vejledning i at skrive LæsDocBook Hver bog er organiseret gennem bog.sgml og indhold.sgml pga. integration med

ftav-watch-add

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 6. Fremstilling af “Friheden til at vælge” bøgerne næste ---------- 6.4. E-mail notifikation Hvis du vil have en email hver gang der ryger en fil ind i CVS-arkivet (cvs commit), så kan I tilmelde jer

ftav

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige næste ---------- Kapitel 6. Fremstilling af "Friheden til at vælge" bøgerne Dette kapitel har oprindeligt været linuxbog-gruppens interne retningslinjer og hjælp for skrivning og fremstilling af bøgerne

html-reference

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 1. HTML næste ---------- 1.3. HTML-reference I dette afsnit gives en HTML-reference. 1.3.1. Strukturelle elementer * Kommentar: Eksempel:

html

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige næste ---------- Kapitel 1. HTML Det er ofte smart at skrive dokumentation i HTML, fordi HTML forstås på alle platforme. Ideen med HTML er, at man skriver en fil i ren tekst og tilføjer nogle mærker der afgrænser elementer i teksten med bestemte typer oplysninger. Det kan for eksempel være overskrifter eller henvisninger til illustrationer. Det er vigtigt at bemærke at

index

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation Version 2.7.20040524 - 2020-12-31 Peter Toft Henrik Grove Kristian Sørensen Michael Rasmussen Ophavsret © 2000-2005 Forfatterne har ophavsret til bogen, men udgiver den under “Åben dokumentlicens (ÅDL) - version 1.0

latex-afslutning

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 4. LaTeX næste ---------- 4.10. Afsluttende bemærkninger Om jeg så havde haft alverdens papir til rådighed bliver jeg aldrig færdig med at fortælle om LaTeX. Det skyldes (som jeg håber du har fornemmet indtil nu) at kombinationsmulighederne er ganske ufattelige. Selv efter at have brugt LaTeX til stort set alt i over 6 år, kan jeg stadig lære nye ting (en del af det er dog nærmere ren TeX), og …

latex-basale-kommandoer

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 4. LaTeX næste ---------- 4.3. Basale kommandoer I ethvert LaTeX dokument har du brug for en række kommandoer. Alt efter hvad dit dokument omhandler, er disse mere eller mindre avancerede. Det lyder måske skræmmende at skulle lære en række kommandoer, men du får hurtigt lært de fleste af dem du nogensinde vil få brug for. Generelt er alle kommandoer man bruger i LaTeX logiske, det betyder at du…

latex-billeder

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 4. LaTeX næste ---------- 4.7. Billeder Der findes mange måder at sætte billeder ind i dokumenterne på, min anbefaling er at konvertere alt til indkapslet Postscript (EPS/Encapsulated PostScript), og sætte dem ind med følgende kode:

latex-diverse

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 4. LaTeX næste ---------- 4.9. Diverse Man kan indsætte kommentarer (som ikke kommer med i det oversatte dokument) i sin LaTeX-fil, det gøres med et %-tegn, som gør resten af linjen til en kommentar. Det kan f.eks. bruges til at huske sig selv på at et afsnit ikke er færdigskrevet, eller til at placere tydelige identifikationer af at man f.eks. begynder på et nyt afsnit, det kan f.eks. gøres so…

latex-formatering

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 4. LaTeX næste ---------- 4.4. Formatering Nu er tiden vist kommet til at se lidt på hvordan vi får skrevet noget reelt tekst, og hvordan vi kan formatere det.

latex-henvisninger

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 4. LaTeX næste ---------- 4.6. Henvisninger m.m. Fodnoter laves med \footnote{Fodnotetekst} på det sted i teksten hvor fodnoten skal være. Behøver man at skrive at du blot skal skrive fodnoten, og så holder LaTeX styr på dem.

latex-omgivelser

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 4. LaTeX næste ---------- 4.5. Omgivelser Omgivelser (på engelsk: environments) er nogle kommandoer, som man bruger til at omgive større mængder tekst, som af en eller andre grund udgår en enhed. Et eksempel herpå er f.eks. punktopstilling. Denne omgivelse hedder

latex-opbygning

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 4. LaTeX næste ---------- 4.2. Opbygning af et LaTeX-dokument Som sagt skriver man sit dokument i en editor efter eget valg, og oversætter det herefter. Før vi går i detaljer med indholdet af den fil man kan oversætte, skal vi lige se på den overordnede opbygning af filen.

latex-tabeller

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 4. LaTeX næste ---------- 4.8. Tabeller Tabeller kan laves ved hjælp af omgivelsen tabular . Efter \begin{tabular} skal man i krøllede parenteser angive hvordan indholdet i de forskellige søjler skal justeres, og om der skal være en streg mellem to søjler. Man angiver at en søjle skal være venstrejusteret ved med et

latex

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige næste ---------- Kapitel 4. LaTeX Dette afsnit er ment som en introduktion til LaTeX. Der kræves ingen forudsætninger ud over at du skal kunne bruge en computer. LaTeX minder i de grundlæggende

stikord

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige ---------- Stikordsregister Symboler ",Igang med Docbook<,Igang med Docbook,Kommentarer
DocBook,Tekstblokke - para-,SpecialtegnLaTeX ,LaTeXBasale kommandoer ,Basale kommandoerBilleder og grafik ,BillederDags dato ,DiverseEksempelprÃ¦ambler ,PrÃ¦amblerFormatering af tekst ,

validering-af-html

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 1. HTML næste ---------- 1.2. Validering af hjemmesider Det er altid irriterende hvis en hjemmeside vises dårligt eller slet ikke kan vises. Et godt trick er at bruge[

wysiwyg

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige næste ---------- Kapitel 5. DocBook med WYSIWYG Hvis du ikke er så stærk i at anvende DocBook, eller blot vil have en mulighed for at fremstille en hurtig artikel, er dette kapitel sikkert interessant for dig.

x1289

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 3. DocBook i XML : Ett konkret exempel næste ---------- 3.2. Skaffa fram rådatat Vi utgår från att vi har PostgreSQL körande, med möjlighet att koppla upp via TCP/IP. Vi har endast 2 tabeller tills vidare, skapade så här:

x1300

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 3. DocBook i XML : Ett konkret exempel næste ---------- 3.3. Transformera till DocBook Itables.xmlhar vi nu ett 'well-formed' XML dokument. Detta skall nu mappas mot docbook. XSL-transformering är precis vad docbook i XML går ut på. En XML-parser validerar dokumentet som skall översättas, mot en DTD, docbooks DTD. Om det är OK kan processen med att skapa måldokumentet fortsätta. Skapandet av må…

x1323

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 3. DocBook i XML : Ett konkret exempel næste ---------- 3.4. Skapa ett HTML-dokument För att skapa ett HTML-dokument behöver vi bara fylla på make-filen. Vi lägger till följande:

x1328

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 3. DocBook i XML : Ett konkret exempel næste ---------- 3.5. Skapa ett uppdelat HTML-dokument För att skapa en HTML-struktur uppdelad per section behöver vi bara fylla på make-filen igen. Vi lägger till följande:

x1333

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 3. DocBook i XML : Ett konkret exempel næste ---------- 3.6. Skapa ett PDF-dokument Båda HTML-varianterna klarar Saxon av i ett svep. Med PDF är det annorlunda. Saxon kan skapa utdata i FO-format, som är

x1340

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 3. DocBook i XML : Ett konkret exempel næste ---------- 3.7. Parametrar Vi har skickat in lite parametrar till Saxon, utan att kommentera dem. * paper.type=A4 : Utan denna blir det US-letter

x1361

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 3. DocBook i XML : Ett konkret exempel næste ---------- 3.8. XML - SGML Huvuddokumentet är väldigt likt dess SGML-kusin. Skillanden ligger i att ?xml? taggen skall finnas med, och att en

x1373

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 3. DocBook i XML : Ett konkret exempel næste ---------- 3.9. Komplett Makefile Vi lägger till ett clean kommando: #A list over source files SRC=datamodel.xml docbook_tables.xml tables.xml to_docbook_table.xsl DB=/usr/share/sgml/docbook/xsl-stylesheets SAXON=/home/bnl/distributions/java/saxon.jar TARGET=/home/bnl/public_html/sslug/docbook_xml/target OPTIONS=paper.type=A4 \ admon.graphi…

x1377

Anonymous (anonymous@undisclosed.example.com) — 2026-11-13T12:47:22+00:00

Linux - Friheden til at skrive dokumentation: Version 2.7.20040524 - 2020-12-31 forrige Kapitel 3. DocBook i XML : Ett konkret exempel næste ---------- 3.10. Problem/Fördelar/Nackdelar När dokumenten blir stora, kan man råka ut för att Fop eller Saxon krashar på 'out-of-memory'. Jag upplever detta vid 100+ tabeller. Lösningen är att skicka med -Xmx128m till java, dvs tillåt att java får använda 128 mb minne.