lyx_mirror/lib/doc/da_Intro.lyx

#LyX 1.4.0cvs created this file. For more info see http://www.lyx.org/
\lyxformat 245
\begin_document
\begin_header
\textclass book
\language danish
\inputencoding default
\fontscheme default
\graphics default
\paperfontsize default
\spacing single
\papersize default
\use_geometry false
\use_amsmath 0
\cite_engine basic
\use_bibtopic false
\paperorientation portrait
\secnumdepth 2
\tocdepth 2
\paragraph_separation indent
\defskip medskip
\quotes_language swedish
\papercolumns 1
\papersides 2
\paperpagestyle default
\tracking_changes false
\output_changes true
\end_header

\begin_body

\begin_layout Title
Introduktion til LyX
\end_layout

\begin_layout Author
af John Weiss og LyX-holdet
\end_layout

\begin_layout Standard
\begin_inset LatexCommand \tableofcontents{}

\end_inset


\end_layout

\begin_layout Chapter
LyX-filosofien
\end_layout

\begin_layout Section
Hvad er LyX?
\end_layout

\begin_layout Standard
LyX er et system til at udf<64>rdige dokumenter\SpecialChar \@.
 Det udm<64>rker sig ved at kunne
 lave komplekse tekniske og videnskabelige artikler med formler, krydshenvisning
er, litteraturhenvisninger, indekser m.m\SpecialChar \@.
 Det er glimrende til dokumenter
 af enhver l<>ngde, hvor teksth<74>ndterings-funktionaliteter er p<>kr<6B>vede:
 automatisk afsnits- og sidenummerering, stavekontrol o.s.v\SpecialChar \@.
 Det kan ogs<67> bruges
 til at skrive et brev til Mor, men det skal indr<64>mmes at der nok findes
 enklere programmer til s<>dan noget\SpecialChar \@.
 Det er absolut ikke det bedste v<>rkt<6B>j
 til at lave plakater, flyers eller reklamemateriale (vi kommer tilbage
 til hvorfor), selvom den slags ogs<67> kan laves med en ekstra indsats\SpecialChar \@.
 Eksempler
 p<>, hvad det er brugt til: breve, eksamensprojekter, afhandlinger, l<>reb<65>ger
 og -noter, seminarmateriale, konference-proceedings, programdokumentation,
 b<>ger (om PostgreSQL, overv<72>gning, kryptologi, fiktionslitteratur, poesi
 og selv en b<>rnebog eller to), artikler i videnskabelige tidsskrifter,
 filmmanuskripter, forretningsplaner\SpecialChar \ldots{}
 og meget mere.
\end_layout

\begin_layout Standard
LyX er et program, der har en moderne tilgang til dokumentskrivning p<> computer
 med et markeringsparadigme, en tilgang, der bryder med det gammeldags 
\begin_inset Quotes sld
\end_inset

skrivemaskine-koncept
\begin_inset Quotes srd
\end_inset

\SpecialChar \@.
 Det er lavet til tekstforfattere, der hurtigt vil have et professionelt
 resultat med en minimal indsats uden at skulle v<>re specialister i tekstops<70>tni
ng\SpecialChar \@.
 Arbejdet med tekstops<70>tning klares hovedsageligt af computeren, ikke
 forfatteren; med LyX kan forfatteren koncentrere sig om indholdet\SpecialChar \@.

\end_layout

\begin_layout Standard
En af de udfordringer du kommer ud for, n<>r du tager LyX i brug, er den
 anderledes t<>nkem<65>de, du er n<>dt til at l<>gge for dagen\SpecialChar \@.
 Engang for l<>nge
 siden var gammeldags skrivemaskiner det eneste man havde til at skrive
 dokumenter p<>, s<> vi l<>rte os allesammen sm<73> trick til at komme udenom
 deres begr<67>nsninger\SpecialChar \@.
 Understregning, som ikke er andet end at overskrive
 med 
\begin_inset Quotes sld
\end_inset

_
\begin_inset Quotes srd
\end_inset

-tegnet, blev en m<>de at l<>gge tryk p<> ord og s<>tninger\SpecialChar \@.
 Du var n<>dt til
 at l<>re dig s<>jlebredder og tabulatorstop --- og s<>tte disse inden du lavede
 en tabel\SpecialChar \@.
 Det samme gjaldt for breve og andre h<>jrejusterede tekster\SpecialChar \@.
 Orddeling
 ved linjeskift kr<6B>vede et tr<74>net <20>je og en den fremsynethed\SpecialChar \@.

\end_layout

\begin_layout Standard
Med andre ord er blev vi alle tr<74>net op til at bekymre os om sm<73> detaljer
 om, hvilket tegn der skulle placeres hvor\SpecialChar \@.
 Derfor har alle tekstbehandlingsprogr
ammer overtaget denne m<>de at t<>nke p<>\SpecialChar \@.
 De bruger stadig tabulatorstop til
 at lave afstande mellem teksterne\SpecialChar \@.
 Du skal stadig t<>nke over, pr<70>cis hvor
 p<> siden de forskellige elementer bliver placeret\SpecialChar \@.
 N<>r tekster skal fremh<6D>ves
 g<>res det ved at v<>lge en anden skrifttype svarende til at udskifte skrivemaski
nens skrifttypehjul\SpecialChar \@.
 Dette er filosofien bag WYSIWYG-tekstbehandling: 
\begin_inset Quotes sld
\end_inset

What You See Is What You Get
\begin_inset Quotes erd
\end_inset

 (Du ser, hvad du f<>r).
 Desv<73>rre er resultatet oftest 
\begin_inset Quotes sld
\end_inset

Du f<>r ikke mere end det, du ser
\begin_inset Quotes srd
\end_inset

\SpecialChar \@.

\end_layout

\begin_layout Standard
Det er her, LyX afviger fra almindelig tekstbehandling\SpecialChar \@.
 Du skal ikke bekymre
 dig om, hvor tegnene placeres p<> arket\SpecialChar \@.
 Du fort<72>lle LyX 
\emph on
hvad det er, du laver
\emph default
 og LyX klarer resten efter et regels<6C>t kaldet en 
\emph on
stil
\emph default

\begin_inset Foot
status open

\begin_layout Standard
Retf<EFBFBD>rdigvis skal det siges, at de nyeste udgaver af de mest popul<75>re kontorprog
rammer har f<>et en slags stilark, som kan marker teksten p<> en lignende
 m<>de\SpecialChar \@.
 De bruges dog sj<73>ldent i praksis\SpecialChar \@.

\end_layout

\end_inset

\SpecialChar \@.
 Lad os se p<> et lille eksempel:
\end_layout

\begin_layout Standard
Du er ved at skrive en rapport\SpecialChar \@.
 I begyndelsen af rapporten vil du have et
 afsnit kaldet 
\begin_inset Quotes sld
\end_inset

Introduktion
\begin_inset Quotes srd
\end_inset

, s<> du bruger menuen i dit tekstbehandlingsprogram til <20>ndring af skriftst<73>rrel
ser og v<>lger en ny skriftst<73>rrelse\SpecialChar \@.
 S<> aktiverer du fed skrift og skriver
 
\begin_inset Quotes sld
\end_inset

1.\InsetSpace ~
\InsetSpace ~
Introduktion
\begin_inset Quotes srd
\end_inset

\SpecialChar \@.
 Hvis du senere vil flytte afsnittet til et andet sted i dokumentet eller
 inds<64>tter et nyt afsnit f<>r dette, er du naturligvis n<>dt til at <20>ndre
 nummereringen for denne og alle efterf<72>lgende sektioner samt i indholdsfortegne
lsen\SpecialChar \@.

\end_layout

\begin_layout Standard
I LyX v<>lger du 
\family sans
Sektion
\family default
 i menuen til venstre for menuknapperne og skriver 
\begin_inset Quotes sld
\end_inset

Introduktion
\begin_inset Quotes srd
\end_inset

\SpecialChar \@.

\end_layout

\begin_layout Standard
Det er det hele\SpecialChar \@.
 Hvis du flytter rundt p<> afsnittene vil de automatisk f<>
 nye numre --- overalt\SpecialChar \@.
 Og hvis du inds<64>tter referencer til afsnittet korrekt
 (ved at inds<64>tte krydsreference-m<>rker), vil LyX automatisk opdatere dem
 i hele filen, s<> du altid nogensinde skal skrive et afsnitsnummer selv\SpecialChar \@.

\end_layout

\begin_layout Standard
Lad os kigge p<> problematikken omkring konsistens\SpecialChar \@.
 Fem dage senere <20>bner
 du igen rapporten og begynder at skrive sektion\InsetSpace ~
4\SpecialChar \@.
 Nu glemmer du at du brugte
 18-punkts fed skrift i stedet for 16-punkts, s<> titlen p<> sektion\InsetSpace ~
4 st<73>r
 nu med en anden skrift end den du brugte til sektion\InsetSpace ~
1\SpecialChar \@.
 Dette problem findes
 ganske enkelt ikke i LyX\SpecialChar \@.
 Maskinen holder styr p<> alle detaljerne om, hvilke
 ting der har hvilken skriftst<73>rrelse for dig\SpecialChar \@.
 S<>dan noget er computere trods
 alt ret gode til\SpecialChar \@.

\end_layout

\begin_layout Standard
Endnu et eksempel: Du laver en liste\SpecialChar \@.
 I andre tekstbehandlingsprogrammer
 er en liste blot en masse tabulatorstop og linjeskift\SpecialChar \@.
 du skal selv s<>rge
 for at placere et m<>rke ud for hvert punkt p<> listen, hvilket m<>rke det
 skal v<>re, hvor mange tomme linjer der skal mellem hvert punkt og s<> videre\SpecialChar \@.

 I LyX skal du kun t<>nke p<> to ting: hvilken slags liste er det og hvad
 skal der st<73> i den\SpecialChar \@.
 Det er det hele\SpecialChar \@.

\end_layout

\begin_layout Standard
S<EFBFBD> den grundl<64>ggende id<69> bag LyX er: angiv 
\emph on
hvad
\emph default
 du laver, ikke 
\emph on
hvordan
\emph default
 du g<>r det\SpecialChar \@.
 I stedet for 
\begin_inset Quotes sld
\end_inset

Du ser, hvad du f<>r
\begin_inset Quotes srd
\end_inset

 er LyX-filosofien 
\begin_inset Quotes sld
\end_inset

Du ser, hvad du 
\emph on
mener
\emph default

\begin_inset Quotes srd
\end_inset

 (What You See Is What You Mean, WYSIWYM)\SpecialChar \@.
 Den g<>r det meget simplere at
 skrive dokumenter\SpecialChar \@.
 Det er ogs<67> derfor LyX ikke er ret godt til at lave plakater
 og flyers --- i disse tilf<6C>lde vil du netop 
\emph on
gerne
\emph default
 bestemme pr<70>cis hvor alt skal st<73>, fordi der ikke findes funktionsbestemte
 enheder som afsnit, sektioner o.s.v\SpecialChar \@.
 Det betyder ikke at LyX mangler en bestemt
 funktion, snarere at det ganske enkelt ikke er det rigtigt v<>rkt<6B>j til
 dette --- du bruger heller ikke en skruetr<74>kker til at hamre s<>m i med
 (medmindre din skruetr<74>kker har livsvarig garanti)\SpecialChar \@.

\end_layout

\begin_layout Section
Forskelle mellem LyX og anden tekst\SpecialChar \-
behandling
\begin_inset Foot
status open

\begin_layout Standard
Nej, vi pr<70>ver ikke p<> at starte (eller vinde) en fundamentalistisk tekstbehandl
ingskrig, men vi mener at det er vigtigt at beskrive LyX's egenskaber\SpecialChar \@.
 Og
 en af LyX's vigtigste egenskaber, WYSIWYM adskiller sig grundl<64>ggende fra,
 hvad 99% af alle mennesker kender\SpecialChar \@.

\end_layout

\end_inset


\end_layout

\begin_layout Standard
Dette finder du ikke i LyX:
\end_layout

\begin_layout Itemize
Linealen
\end_layout

\begin_layout Itemize
Tabulatorstop
\end_layout

\begin_layout Itemize
Ekstra mellemrum (f.eks.
 at inds<64>tte 
\family sans
Enter
\family default
 eller 
\family sans
Space
\family default
 to eller flere gange efter hinanden)
\end_layout

\begin_layout Standard
Tabulatorstop er sammen med linealen, der viser hvor ting er placeret p<>
 siden, ubrugelige i LyX\SpecialChar \@.
 Programmet tager sig selv af, hvor p<> siden tingene
 placeres\SpecialChar \@.
 Det samme g<>lder ekstra mellemrum; LyX tilf<6C>jer det efter behov
 afh<66>ngigt af konteksten\SpecialChar \@.
 I starten kan det v<>re irriterende ikke at kunne
 inds<64>tte to tomme linjer efter hinanden, men det giver mening, n<>r du t<>nker
 i WYSIWYM\SpecialChar \@.

\end_layout

\begin_layout Standard
Her er nogle ting, der findes i LyX, men bruges p<> en anden m<>de, end man
 skulle tro:
\end_layout

\begin_layout Itemize
Indrykningsstyring
\end_layout

\begin_layout Itemize
Sideskift
\end_layout

\begin_layout Itemize
Linjeafstand (f.eks.
 enkelt, dobbelt o.s.v.)
\end_layout

\begin_layout Itemize
Afstand, vandret og lodret
\end_layout

\begin_layout Itemize
Skrifttyper og -st<73>rrelser
\end_layout

\begin_layout Itemize
Skriftjustering (fed, skr<6B>tstillet, understreget o.s.v.)
\end_layout

\begin_layout Standard
Selvom de findes i LyX, har du normalt ikke brug for dem\SpecialChar \@.
 LyX tager sig af
 disse ting for dig afh<66>ngigt af, hvad du er i gang med\SpecialChar \@.
 Forskellige dele
 af dokumentet s<>ttes automatisk med en anden skrifttype og -st<73>rrelse\SpecialChar \@.
 Afsnitsin
drykning afh<66>nger af konteksten; forskellige afsnitstyper indrykkes forskelligt\SpecialChar \@.

 Sideskift h<>ndteres ogs<67> automatisk\SpecialChar \@.
 Normalt er afstanden mellem ord, linjer
 og afsnit fleksibel, styret af LyX\SpecialChar \@.

\begin_inset Foot
status open

\begin_layout Standard
Det er muligt selv at finjustere disse (hvoraf enkelte kr<6B>ver kendskab til
 LaTeX), i hele dokumentet eller dele heraf\SpecialChar \@.
 Se detaljerne i manualen 
\emph on
Brugermanualen
\emph default
 og/eller 
\emph on
Udvidede funktioner
\emph default
\SpecialChar \@.

\end_layout

\end_inset

 
\end_layout

\begin_layout Standard
Til sidste er der nogle omr<6D>der, hvor vi mener at LyX (og LaTeX) overg<72>r
 mange tekstbehandlingsprogrammer:
\end_layout

\begin_layout Itemize
Orddeling
\end_layout

\begin_layout Itemize
Alle former for lister
\end_layout

\begin_layout Itemize
Matematik
\end_layout

\begin_layout Itemize
Tabeller
\end_layout

\begin_layout Itemize
Krydsreferencer
\end_layout

\begin_layout Standard
Godt nok kan mange nyere tekstbehandlingsprogrammer h<>ndtere matematiske
 symboler, tabeller og orddeling --- og mange har bev<65>get sig mod stildefinition
er og WYSIWYM-filosofien.
 Det er dog f<>rst for nylig at dette er sket, hvorimod LyX bygger p<> do
 kuementudviklingssystemet-LaTeX, der har eksisteret i mere end 15 <20>r og
 
\emph on
virker
\emph default
\SpecialChar \@.
 Alle fejlene er luget ud
\begin_inset Foot
status open

\begin_layout Standard
Okay, vi ved godt at intet er helt perfekt, men LaTeX er s<> t<>t p<> at v<>re
 fejlfrit, som et program kan komme\SpecialChar \@.

\end_layout

\end_inset

\SpecialChar \@.

\end_layout

\begin_layout Section
Hvad 
\emph on
er
\emph default
 LaTeX (og hvad rager det mig)?
\end_layout

\begin_layout Standard
LaTeX er et dokumentudviklingssystem, der blev lavet af Leslie Lamport tilbage
 i 1985
\begin_inset Foot
status open

\begin_layout Standard
Oplysningerne i dette afsnit kommer fra 
\emph on

\begin_inset Quotes sld
\end_inset

A Guide to LaTeX2e
\emph default
,
\begin_inset Quotes erd
\end_inset

 af Helmut Kopka og Patrick Daly, som er n<>vnt i 
\emph on
Brugermanualen
\emph default
s litteraturliste\SpecialChar \@.

\end_layout

\end_inset

\SpecialChar \@.
 Det er igen bygget op omkring et tekstops<70>tningssprog kaldet TeX (udtales
 
\begin_inset Quotes sld
\end_inset

t<EFBFBD>k
\begin_inset Quotes srd
\end_inset

), som Donald Knuth lavede i 1984.
 Dog er det de f<>rreste, der ved n<>jagtig hvad TeX er\SpecialChar \@.
 TeX udf<64>rer en r<>kke
 skriftops<70>tningskommandoer fra en ren tekstfil\SpecialChar \@.
 Det er en smule mere indviklet
 end en skrivemaskine, men ikke n<>r s<> involveret i selve udskriftsprocessen\SpecialChar \@.

 Dog er mange af pressens udskrifts-trick blevet omsat til algoritmer af
 Knuth og inkorporeret i TeX, hvilket er skyld i det fremragende udseende
 af udskrifter fra TeX\SpecialChar \@.
 I alle tilf<6C>lde er det, der kommer fra TeX en s<>kaldt
 
\begin_inset Quotes sld
\end_inset

enhedsuafh<EFBFBD>ngig
\begin_inset Quotes srd
\end_inset

 fil, 
\family typewriter
dvi
\family default
.
 Du kan sende 
\family typewriter
dvi
\family default
-filen til alt hvad der forst<73>r 
\family typewriter
dvi
\family default
 eller oms<6D>tter 
\family typewriter
dvi
\family default
 til andre formater s<>som PostScript<70>, PDF, m.m\SpecialChar \@.

\end_layout

\begin_layout Standard
Hvis ikke det var for <20>n yderligere funktion, ville TeX kun v<>re et program
 til ops<70>tning af tekst\SpecialChar \@.
 TeX giver imidlertid mulighed for at definere makroer\SpecialChar \@.

 Det er her, det bliver sp<73>ndende\SpecialChar \@.

\end_layout

\begin_layout Standard
De fleste brugere at TeX bruger i virkeligheden en makropakke, som Knuth
 lavede for at skjule en del af detaljerne omkring ops<70>tningen af tekst\SpecialChar \@.

 Det er det, de fleste kender som TeX\SpecialChar \@.
 Almindelige brugere arbejder ikke
 med r<> TeX, som udelukkende er kommandoer til ops<70>tning af tekst\SpecialChar \@.
 Kun folk,
 der laver nye makropakker g<>r det\SpecialChar \@.
 Det er her, Lesslie Lamport kommer ind
 i historien\SpecialChar \@.
 Han ville have en makropakke, der var mere bruger\SpecialChar \-
orienteret
 og mindre skrivemaskine\SpecialChar \-
orienteret\SpecialChar \@.
 Et kommandos<6F>t, der kunne s<>tte tekst,
 sektioner, tabeller og matematiske formler op p<> en ensartet, sammenh<6E>ngende
 m<>de\SpecialChar \@.
 S<>dan blev LaTeX f<>dt\SpecialChar \@.

\end_layout

\begin_layout Standard
Sidel<EFBFBD>bende med udviklingen af LaTeX lavede andre deres egne makropakker
 til TeX til at lave slides eller artikler til matematik-tidsskrifter o.s.v\SpecialChar \@.

 Nogle brugte det r<> TeX-funktioner til dette, mens andre begyndet at <20>ndre
 i LaTeX\SpecialChar \@.
 I et fors<72>g p<> at rydde op i dette rod, begyndte et hold af LaTeX-folk
 (heriblandt Lamport, naturligvis) sidst i 80'erne at arbejde p<> LaTeX2e,
 den nuv<75>rende udgave af LaTeX\SpecialChar \@.
 Denne nye udgave af LaTeX har kommandoer,
 der g<>r det lettere at oprette TeX-makroer, bruge nye skrifttyper m.m\SpecialChar \@.
 Faktisk
 er LaTeX et ret omfattende selvst<73>ndigt sprog! Brugere verden over har
 lavet deres egne tilf<6C>jelser til LaTeX ud over de almindelige\SpecialChar \@.

\end_layout

\begin_layout Standard
Der er to m<>der at udvide LaTeX: klasser og stile\SpecialChar \@.
 En 
\emph on
klasse
\emph default
 er en samling LaTeX- og TeX-makroer, der beskriver en bestemt slags dokument,
 s<>som en bog eller artikel\SpecialChar \@.
 Der er klasser til slides, fysiske eller matematiske
 tidsskrifter\SpecialChar \ldots{}
 mange universiteter har ligefrem sine egne klasse sine eksamenspro
jekter og afhandlinger! En 
\emph on
stil 
\emph default
afviger fra en klasse ved at den ikke definerer en ny dokumenttype, men
 en anden 
\emph on
opf<EFBFBD>rsel
\emph default
, ethvert dokument kan have\SpecialChar \@.
 For eksempel styrer LyX sidens margin og linjeafstan
d med to LaTeX stil-filer\SpecialChar \@.
 Der er stil-filer til en lang r<>kke ting: udskrivning
 af labels eller konvolutter, <20>ndring af indrykningsopf<70>rsel, tilf<6C>jelse
 af nye skrifttyper, h<>ndtering af grafik, design af nye tjekkede sidehoveder,
 justering af litteraturlister, <20>ndring af fodnoters, tabellers og figurers
 placering og fremtr<74>den, ops<70>tning af lister o.s.v., o.s.v\SpecialChar \@.

\end_layout

\begin_layout Standard
Her er en opsummering:
\end_layout

\begin_layout List
\labelwidthstring 00.00.0000
TeX: Skriftops<70>tningssprog med makrofunktionalitet.
\end_layout

\begin_layout List
\labelwidthstring 00.00.0000
LaTeX: Makropakke, der bygger p<> TeX\SpecialChar \@.

\end_layout

\begin_layout List
\labelwidthstring 00.00.0000
klasser: Beskrivelser af en dokumenttype ved brug af LaTeX\SpecialChar \@.

\end_layout

\begin_layout List
\labelwidthstring 00.00.0000
stile: <20>ndrer LaTeX's standardopf<70>rsel p<> en eller anden m<>de.
\end_layout

\begin_layout List
\labelwidthstring 00.00.0000
LyX: Visuel, WYSIWYM-tekstbehandling, der bruger LaTeX-systemet til udskrifterne.
\end_layout

\begin_layout Standard
Form<EFBFBD>let med dette afsnit var at pr<70>ve at forklare 
\emph on
hvorfor
\emph default
 LyX er anderledes end andre tekstbehandlingsprogrammer\SpecialChar \@.
 Forklaringen er
 enkel: LyX bruger LaTeX til sine udskrifter\SpecialChar \@.
 Ligesom LaTeX fokuserer LyX
 p<> konteksten af det, du skriver --- 
\emph on
hvad
\emph default
 du er ved at skrive.
 Maskinen styrer derefter, 
\emph on
hvordan 
\emph default
det skal se ud.
\end_layout

\begin_layout Chapter
Dokumentationen
\end_layout

\begin_layout Standard
For at g<>re det nemmere at svare p<> dine sp<73>rgsm<73>l og beskrive alle LyX's
 funktioner, er dokumentationen delt op i flere filer\SpecialChar \@.
 De tjener hvert sit
 form<72>l som beskrevet herunder\SpecialChar \@.
 Du b<>r l<>se dette afsnit n<>je f<>r du pl<70>jer
 dig gennem dem\SpecialChar \@.
 Det indeholder en masse nyttige oplysninger og kommentarer,
 der kan spare din tid\SpecialChar \@.

\end_layout

\begin_layout Standard
Noget af dokumentationen kan v<>re mangelfuld eller for<6F>ldet, selvom vi fors<72>ger
 h<>rdt p<> at f<>lge med\SpecialChar \@.
 Som resten af LyX er manualerne udarbejdet af frivillige,
 der har 
\begin_inset Quotes sld
\end_inset

virkelige job
\begin_inset Quotes srd
\end_inset

, familier, opvask, kattebakker der skal t<>mmes o.s.v\SpecialChar \@.
 Vi g<>r vores bedste
 for at holde manualerne i tip-top stand, men det lykkes ikke altid, da
 udviklerne ynder at tilf<6C>je nye funktioner mens vi skriver om det gamle!
 (Hvis du vil hj<68>lpe med at rette op p<> dette, skal du endelig l<>se kapitel\InsetSpace ~
\InsetSpace ~

\begin_inset LatexCommand \ref{kap:Bidrag}

\end_inset

)\SpecialChar \@.

\end_layout

\begin_layout Standard
G<EFBFBD>r os i <20>vrigt en tjeneste --- hvis der er noget i manualerne, der forvirrer
 dig, er uklart eller forkert, m<> du endelig lade os det vide! Du kan kontakte
 de nuv<75>rende vedligeholdere af manualerne ved at skrive p<> engelsk til
 
\family typewriter
lyx-docs@lists.lyx.org
\family default
.
 Hvis du har sp<73>rgsm<73>l, der ikke <20>benlyst besvares af dokumentationen og
 skal bruge hurtig hj<68>lp, kan du benytte dig af postlisten for LyX-brugere,
 som du kan n<> p<> 
\family typewriter
lyx-users@lists.lyx.org
\family default
.
\end_layout

\begin_layout Section
Formatet
\end_layout

\begin_layout Standard
Nogen trykker manualerne, mens andre l<>ser dem p<> sk<73>rmen med LyX\SpecialChar \@.
 Fremtoningen
 p<> sk<73>rmen afviger p<> flere punkter fra den trykte version\SpecialChar \@.
 For det f<>rste
 er titlen i dokumentets top, ikke p<> en separat side, som den er p<> visse
 trykte versioner\SpecialChar \@.
 Hverken fodnoter eller indholdsfortegnelse er synlig\SpecialChar \@.
 Fodnoter
 ser s<>ledes ud
\begin_inset Foot
status open

\begin_layout Standard
Hej!
\end_layout

\begin_layout Standard
Klik p<> den gr<67> firkant til venstre ovenp<6E> denne boks\SpecialChar \@.
 Den der st<73>r 
\begin_inset Quotes sld
\end_inset

fodnote
\begin_inset Quotes srd
\end_inset

 p<>\SpecialChar \@.

\end_layout

\end_inset

\SpecialChar \@.
 Klik p<> den med venstre museknap for at <20>bne den\SpecialChar \@.
 For indholdsfortegnelsen
 kan du enten klikke p<> den gr<67> firkant eller kigge i menuen 
\family sans
Navig<EFBFBD>r
\family default
, hvor indholdsfortegnelsen vises automatisk\SpecialChar \@.
 (Pr<50>v det af!)
\end_layout

\begin_layout Standard
I de trykte manualer optr<74>der alle krydsreferencer som kapitelnumre, sektionsnum
mer, undersektionsnumre o.s.v\SpecialChar \@.
 P<> sk<73>rmen vil krydsreferencer derimod v<>re
 gr<67> bokse som denne: 
\begin_inset LatexCommand \ref{kap:Bidrag}

\end_inset

.
 (De trykte manualer viser blot et nummer.) Hvis du klikker p<> firkanten
 med venstre museknap, vil du f<> et vindue med listen over alle krydsreferencer
 i dokumentet\SpecialChar \@.
 Denne introduktion har kun en enkelt, kaldet 
\begin_inset Quotes sld
\end_inset

kap:Bidrag
\begin_inset Quotes srd
\end_inset

.
 Du kan hoppe til dette kapitel blot ved at klikke p<> knappen 
\begin_inset Quotes sld
\end_inset

G<EFBFBD> til reference
\begin_inset Quotes srd
\end_inset

\SpecialChar \@.
 Det er liges<65> nemt at hoppe tilbage hvor du kom fra\SpecialChar \@.
 Klik p<> 
\begin_inset Quotes sld
\end_inset

G<EFBFBD> tilbage
\begin_inset Quotes srd
\end_inset

 eller tryk 
\family sans
C-<
\family default
 for at komme tilbage til din tidligere placering.
 (Hvad 
\begin_inset Quotes sld
\end_inset


\family sans
C-<
\family default

\begin_inset Quotes erd
\end_inset

 betyder? Se herunder)\SpecialChar \@.

\end_layout

\begin_layout Standard
Nu, hvor vi har afklaret nogle af forskellene mellem den udskrevne version
 og den p<> sk<73>rmen, kan vi starte med at se p<> dette dokuments format\SpecialChar \@.
 Du
 vil st<73>de p<> ord i forskellige skrifter:
\end_layout

\begin_layout Itemize

\emph on
Fremh<EFBFBD>vet stil
\emph default
 bruges til generel fremh<6D>vning, bogtitler, titler p<> andre afsnit i manualerne
 og noter fra forfatterne\SpecialChar \@.

\end_layout

\begin_layout Itemize

\family typewriter
Skrivemaskine
\family default
 bruges til program- og filnavne, LaTeX-, og LyX-koder og funktioner.
\end_layout

\begin_layout Itemize

\family sans
Grotesk
\family default
 bruges til navne p<> menuer, knapper, vinduer og tastaturknapper.
\end_layout

\begin_layout Itemize

\noun on
Kapit<EFBFBD>ler
\noun default
 bruges til personnavne.
\end_layout

\begin_layout Standard
For genvejstaster henvises du nok til afsnittet 
\emph on
Key Bindings
\emph default
 i 
\begin_inset Quotes eld
\end_inset


\emph on
Avancerede funktioner
\begin_inset Quotes erd
\end_inset


\emph default
 (filen 
\family typewriter
Extended.lyx
\family default
).
 N<>r vi skal beskrive taster, bruger vi f<>lgende konventioner:
\end_layout

\begin_layout Itemize

\family sans
\begin_inset Quotes sld
\end_inset

C-
\family default

\begin_inset Quotes erd
\end_inset

 betyder 
\family sans
Control-
\family default
 tasten.
\end_layout

\begin_layout Itemize

\family sans
\begin_inset Quotes sld
\end_inset

S-
\family default

\begin_inset Quotes erd
\end_inset

 betyder 
\family sans
Skifte-
\family default
 tasten.
\end_layout

\begin_layout Itemize
\begin_inset Quotes sld
\end_inset


\family sans
M-
\family default

\begin_inset Quotes erd
\end_inset

 betyder 
\family sans
Meta-
\family default
 tasten, som p<> de fleste tastaturer er 
\family sans
Alt-
\family default
 tasten.
\end_layout

\begin_layout Itemize

\family sans
\begin_inset Quotes sld
\end_inset

F1
\family default

\begin_inset Quotes erd
\end_inset

 \SpecialChar \ldots{}
 
\family sans

\begin_inset Quotes sld
\end_inset

F12
\family default

\begin_inset Quotes erd
\end_inset

 er funktionstasterne.
\end_layout

\begin_layout Itemize

\family sans
\begin_inset Quotes sld
\end_inset

Esc
\family default

\begin_inset Quotes erd
\end_inset

 er escape-tasten.
\end_layout

\begin_layout Itemize

\family sans
\begin_inset Quotes sld
\end_inset

Venstre
\family default

\begin_inset Quotes erd
\end_inset

, 
\family sans

\begin_inset Quotes sld
\end_inset

H<EFBFBD>jre
\family default

\begin_inset Quotes erd
\end_inset

, 
\family sans

\begin_inset Quotes sld
\end_inset

Op
\family default

\begin_inset Quotes erd
\end_inset

, 
\family sans

\begin_inset Quotes sld
\end_inset

Ned
\family default

\begin_inset Quotes erd
\end_inset

: piletaster.
\end_layout

\begin_layout Itemize

\family sans
\begin_inset Quotes sld
\end_inset

Insert
\family default

\begin_inset Quotes erd
\end_inset

, 
\family sans

\begin_inset Quotes sld
\end_inset

Delete
\family default

\begin_inset Quotes erd
\end_inset

, 
\family sans

\begin_inset Quotes sld
\end_inset

Home
\family default

\begin_inset Quotes erd
\end_inset

, 
\family sans

\begin_inset Quotes sld
\end_inset

End
\family default

\begin_inset Quotes erd
\end_inset

, 
\family sans

\begin_inset Quotes sld
\end_inset

PageUp
\family default

\begin_inset Quotes erd
\end_inset

, 
\family sans

\begin_inset Quotes sld
\end_inset

PageDown
\family default

\begin_inset Quotes srd
\end_inset

: Det er de 6 taster, der er placeret lige over piletasterne p<> mange PC-tastatu
rer.
 
\family sans

\begin_inset Quotes sld
\end_inset

PageUp
\family default

\begin_inset Quotes erd
\end_inset

 og 
\family sans

\begin_inset Quotes sld
\end_inset

PageDown
\family default

\begin_inset Quotes erd
\end_inset

 kaldes 
\family sans

\begin_inset Quotes sld
\end_inset

Prior
\family default

\begin_inset Quotes erd
\end_inset

 og 
\family sans

\begin_inset Quotes sld
\end_inset

Next
\family default

\begin_inset Quotes erd
\end_inset

 p<> visse tastaturer.
\end_layout

\begin_layout Itemize

\family sans
Retur
\family default
 og 
\family sans
Enter
\family default
 refererer til samme tast.
 Nogle tastaturer har navngivet 
\family sans
Retur
\family default
-tasten 
\begin_inset Quotes sld
\end_inset

Return
\begin_inset Quotes erd
\end_inset

, andre som 
\begin_inset Quotes sld
\end_inset

Enter,
\begin_inset Quotes erd
\end_inset

 atter andre har to taster.
 LyX behandler dem alle som samme tast, og kalder den b<>de 
\family sans
Retur
\family default
 og 
\family sans
Enter
\family default
.
\end_layout

\begin_layout Standard
Du kan ogs<67> st<73>de p<> fraser som 
\begin_inset Quotes sld
\end_inset

(Se 
\emph on
'Avancerede funktioner
\emph default
')
\begin_inset Quotes erd
\end_inset

\SpecialChar \@.
 Vi har vist de mulige standard-genvejstaster for en funktion i dens beskrivelse
 i manualen 
\emph on

\begin_inset Quotes sld
\end_inset

Avancerede funktioner
\emph default

\begin_inset Quotes erd
\end_inset

, s<> kig ogs<67> der\SpecialChar \@.
 Bem<65>rk, at der er to forskellige tastaturudl<64>gninger,
 der benyttes kan bruges i LyX: 
\begin_inset Quotes eld
\end_inset

CUA
\begin_inset Quotes erd
\end_inset

-typen er den normale og bekendt for de fleste PC-brugere\SpecialChar \@.
 
\begin_inset Quotes eld
\end_inset

emacs
\begin_inset Quotes erd
\end_inset

-typen er den almindelige for dem, der 
\begin_inset Quotes eld
\end_inset

voksede op
\begin_inset Quotes erd
\end_inset

 med Unix-systemer og brugte Emacs til tekstredigering\SpecialChar \@.
 Medmindre andet er
 angivet, vil dokumentationen referere til CUA-typen\SpecialChar \@.
 Hvis du kender Emacs,
 kan du nok selv l<>se dokumentationen og finde genvejstasterne selv\SpecialChar \@.

\end_layout

\begin_layout Section
Manualerne
\end_layout

\begin_layout Standard
Den f<>lgende liste beskriver indholdet af dokumentationens filer\SpecialChar \@.
 Bem<65>rk,
 at ikke alle er oversat til dansk:
\end_layout

\begin_layout Description

\emph on
Introduktion
\end_layout

\begin_deeper
\begin_layout Standard
Denne fil.
\end_layout

\end_deeper
\begin_layout Description

\emph on
Selvstudium (Tutorial) 
\end_layout

\begin_deeper
\begin_layout Standard
Hvis du ikke kender LyX i forvejen og ikke har brugt LaTeX, b<>r du starte
 her\SpecialChar \@.
 Hvis du tror, at LaTeX er et fleksibelt plastikmateriale, skal du helt
 sikkert l<>se 
\emph on
Selvstudium
\emph default
\SpecialChar \@.
 Bem<65>rk at du efter at have l<>st 
\emph on
Selvstudium
\emph default
 muligvis stadig vil tro, at LaTeX er et elastisk materiale --- men du vil
 vide, hvordan du bruger LyX\SpecialChar \@.

\end_layout

\begin_layout Standard
Hvis du 
\emph on
har
\emph default
 pr<70>vet at bruge LaTeX f<>r, kan du l<>se 
\emph on
Selvstudium
\emph default
 fra starten af afsnittet 
\begin_inset Quotes eld
\end_inset

LyX for LaTeX-brugere
\begin_inset Quotes erd
\end_inset

\SpecialChar \@.
 (Det vil heller ikke skade et skimme resten af dokumentet)
\end_layout

\begin_layout Standard
Hvis du p<> noget tidspunkt f<>ler dig p<> dybt vand, b<>r du tjekke 
\emph on
Selvstudium
\emph default
 inden du dykker ned i de andre manualer\SpecialChar \@.
 Den er et godt springbr<62>dt\SpecialChar \@.

\end_layout

\end_deeper
\begin_layout Description

\emph on
Brugermanual (User's\InsetSpace ~
Guide)
\end_layout

\begin_deeper
\begin_layout Standard
Den prim<69>re dokumentation\SpecialChar \@.
 Vi vil d<>kke 
\emph on
de fleste
\emph default
 af de grundl<64>ggende LyX-funktioner her\SpecialChar \@.
 Brugermanualen vil g<> ud fra, at
 du har l<>st 
\emph on
Selvstudium
\emph default
\SpecialChar \@.

\end_layout

\end_deeper
\begin_layout Description

\emph on
Avancerede\InsetSpace ~
funktioner (Extended\InsetSpace ~
Features)
\end_layout

\begin_deeper
\begin_layout Standard
En udvidelse af 
\emph on
Brugermanual
\emph default
\SpecialChar \@.
 Dokumenterer hvordan du bruger de g<> LaTeX-kommandoer, yderligere layout,
 redigeringsfunktioner til bestemte form<72>l --- og viser nogle af de (noget
 bizarre men snedige) trick, LaTeX-kendere har adgang til\SpecialChar \@.

\end_layout

\end_deeper
\begin_layout Description

\emph on
Tilpasning (Customization)
\end_layout

\begin_deeper
\begin_layout Standard
En beskrivelse af avancerede LyX-funktioner, herunder hvordan du tilpasser
 LyX's generelle opf<70>rsel til dine behov\SpecialChar \@.
 Det omfatter tastaturudl<64>gninger,
 sprogtilpasning og konfigurationsfiler\SpecialChar \@.
 Du skal end ikke t<>nke p<> at kigge
 her, f<>r du har l<>st 
\emph on
Selvstudium
\emph default
\SpecialChar \@.

\end_layout

\end_deeper
\begin_layout Description

\emph on
LaTeX-konfiguration (LaTeX\InsetSpace ~
configuration)
\end_layout

\begin_deeper
\begin_layout Standard
LyX unders<72>ger dit system ved installationen\SpecialChar \@.
 Denne fil indeholder de oplysninger
, LyX fandt frem til om dit system\SpecialChar \@.
 Tjek her for at se, om du mangler noget,
 du muligvis gerne ville have\SpecialChar \@.

\end_layout

\end_deeper
\begin_layout Standard
Disse filer vil referere til hinanden, n<>r det er n<>dvendigt\SpecialChar \@.
 For eksempel
 indeholder 
\emph on
Brugermanual
\emph default
 nogen information om installation og tilpasning, men henviser l<>seren til
 
\emph on
Tilpasning
\emph default
 for mere information\SpecialChar \@.

\end_layout

\begin_layout Standard
Vi vil lige gentage en vigtigt pointe:
\end_layout

\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset


\end_layout

\begin_layout Standard
\align center
L<EFBFBD>s 
\emph on
Selvstudium
\emph default
 nu, hvis du ikke kender LyX i forvejen\SpecialChar \@.

\end_layout

\begin_layout Standard
\begin_inset VSpace bigskip
\end_inset


\end_layout

\begin_layout Standard
Ellers vil du frustrere dig selv un<75>digt\SpecialChar \@.
 LyX kan rigtigt meget, men kr<6B>ver
 en anden angrebsvinkel\SpecialChar \@.

\end_layout

\begin_layout Chapter
\begin_inset LatexCommand \label{kap:Bidrag}

\end_inset

Bidrag til LyX-projektet
\end_layout

\begin_layout Section
At bidrage til LyX
\end_layout

\begin_layout Standard
LyX er hovedsageligt skrevet i C++ (LaTeX-indl<64>seren er skrevet i Perl).
 Det er et stort projekt og er derfor ikke uden fejl eller behov for forbedringe
r i kildeteksten.
\end_layout

\begin_layout Subsection
Rapport<EFBFBD>r fejl
\end_layout

\begin_layout Standard
Under brugen af LyX kan det ske at du finder noget, du anser for at v<>re
 en fejl\SpecialChar \@.
 Nedbrud, om end de er sj<73>ldne, kan forekomme\SpecialChar \@.
 Fejl i brugerfladen
 opfattes af LyX-udviklerne som alvorlige fejl: det er is<69>r en hj<68>lp, at
 f<> at vide, hvis der er dele af brugerfladen, du synes er forvirrende eller
 uklare\SpecialChar \@.

\end_layout

\begin_layout Standard
LyX har et fejlsporingssystem, som du finde p<> 
\family typewriter

\begin_inset LatexCommand \htmlurl[LyX fejlsporing]{http://bugzilla.lyx.org/}

\end_inset


\family default
.
 Du bar tjekke dette inden du indrapporterer en fejl, s<> du undg<64>r at den
 allerede er anmeldt\SpecialChar \@.
 Hvis du har kommentarer til en eksisterende fejl eller
 vil rapportere en ny fejl, kan du enten bruge fejlsporingssystemet eller
 sende et engelsksproget brev til udviklingslisten p<> 
\family typewriter
lyx-devel@lists.lyx.org
\family default
.
 Du finder arkivet fra denne liste p<> LyX's hoved-webside, 
\family typewriter

\begin_inset LatexCommand \htmlurl[LyX webside]{http://www.lyx.org/}

\end_inset


\family default
.
\end_layout

\begin_layout Standard
En god (brugbar) fejlrapport fort<72>ller som minimum hvilken udgave af LyX,
 du har problemer med\SpecialChar \@.
 N<>jagtige, detaljerede beskrivelser foretr<74>kkes ---
 jo mere tid udviklerne skal bruge p<> at udpege kilden til en fejl, des
 mindre tid har de til andre forbedringer\SpecialChar \@.
 N<>vn hvilket system du k<>rer LyX
 p<>\SpecialChar \@.
 Oplys versionerne p<> de biblioteker, du har installeret p<> dit system
 og, hvis det er relevant, udgaverne af de eksterne programmer, LyX benytter\SpecialChar \@.

 Hvis det er et problem med overs<72>ttelsen af kildekoden, skal du vedl<64>gge
 filen
\family typewriter
 config.log
\family default
, og n<>vne hvilken overs<72>tter, du bruger.
 
\end_layout

\begin_layout Standard
Hvis du f<>r LyX til at bryde ned, vil vi bede dig om at tage dig tid til
 at spore fejlen med gdb\SpecialChar \@.
 Kun LyX fra gdb ved for eksempel at skrive 
\family typewriter
\size small

\begin_inset Quotes srd
\end_inset

gdb /users/steve/lyx-1.0.x/src/lyx
\family default
\size default

\begin_inset Quotes erd
\end_inset

 og derefter 
\family typewriter
\size small

\begin_inset Quotes sld
\end_inset

run
\family default
\size default

\begin_inset Quotes erd
\end_inset

.
 F<> LyX til at bryde ned, hvorefter du g<>r tilbage til gdb\SpecialChar \@.
 Brug kommandoen
 
\begin_inset Quotes sld
\end_inset


\family typewriter
\size small
bt
\family default
\size default

\begin_inset Quotes erd
\end_inset

 til at lave en 
\begin_inset Quotes sld
\end_inset

backtrace
\begin_inset Quotes srd
\end_inset

-fil og medtag indholdet i din fejlrapport
\begin_inset Foot
status open

\begin_layout Standard
hvis du vil v<>re grundig, kan du bruge kommandoerne 
\family typewriter

\begin_inset Quotes srd
\end_inset

info locals
\family default

\begin_inset Quotes erd
\end_inset

 og 
\family typewriter

\begin_inset Quotes srd
\end_inset

up
\family default

\begin_inset Quotes erd
\end_inset

 til at udskrive indholdet af lokale variable og nogle f<> stakniveauer\SpecialChar \@.

\end_layout

\end_inset

.
 Hvis det er muligt, er en beskrivelse af hvordan man kan fremprovokere
 fejlen vigtigere end en 
\begin_inset Quotes sld
\end_inset

backtrace
\begin_inset Quotes srd
\end_inset

-fil, fordi vi s<> selv har mulighed for at unders<72>ge fejlen\SpecialChar \@.
 Hvis fejlen
 ikke er let at reproducere er 
\begin_inset Quotes sld
\end_inset

backtrace
\begin_inset Quotes srd
\end_inset

-filen essentiel, da den i s<> tilf<6C>lde er alt hvad vi har at g<> ud fra.
\end_layout

\begin_layout Subsection
Bidrag med fejlrettelser og nye funktioner
\end_layout

\begin_layout Standard
Hvis du har lavet <20>ndringer i LyX's kildetekst, som du synes b<>r indf<64>res
 i LyX, kan du sende dine <20>ndringer som en diff-fil (i 'unified' format)
 til udviklingslisten, der blev n<>vnt ovenfor, sammen med en beskrivelse
 af <20>ndringen og hvad den g<>r.
\end_layout

\begin_layout Section
Bidrag til dokumentationen
\end_layout

\begin_layout Standard
LyX's dokumentation er omfattende\SpecialChar \@.
 Alligevel er LyX under konstant udvikling,
 og hver ny udgave tilf<6C>jer nye funktioner\SpecialChar \@.
 Du kan komme ud for at noget
 af dokumentationen tr<74>nger til en opdatering\SpecialChar \@.
 Dette afsnit beskriver hvad
 du g<>r, hvis du finder en fejl eller har forslag til forbedring af dokumentatio
nen.
\end_layout

\begin_layout Subsection
Rapport<EFBFBD>r fejl i manualerne
\end_layout

\begin_layout Standard
Send et engelsksproget brev til postlisten 
\family typewriter
lyx-docs@lists.lyx.org
\family default
, hvis du finder fejl i dokumentationen\SpecialChar \@.
 Dokumentationsholdet vil tage sig
 af de n<>dvendige rettelser\SpecialChar \@.

\end_layout

\begin_layout Subsection
Deltag i dokumentationsholdet.
\end_layout

\begin_layout Standard
Ligesom alt andet i LyX-projektet, kan LyX's dokumentationsprojekt altid
 bruge hj<68>lp! Hvis du er interesseret i at bidrage til dokumentationsprojektet,
 skal du 
\emph on
f<EFBFBD>rst
\emph default
 gennemf<6D>re f<>lgende registrering:
\end_layout

\begin_layout Enumerate
Hent den seneste kildetekst til LyX\SpecialChar \@.
 Udpak den
\begin_inset Foot
status open

\begin_layout Standard
De mere eventyrlystne kan hente den seneste kildtekst fra LyX's CVS-arkiv
 --- den ligger i modulet 
\family typewriter
lyxdoc
\family default
.
\end_layout

\end_inset

\SpecialChar \@.
 Du vil finde et katalog inden i hovedkataloget kaldet 
\family typewriter
lib/doc/
\family default
.
 Inden i dette katalog ligger filen 
\family typewriter
DocStyle.lyx
\family default
\SpecialChar \@.
 L<>s den, det er dokumentationens skabelon\SpecialChar \@.

\end_layout

\begin_layout Enumerate
Tag et par dages pause og l<>s derefter 
\family typewriter
DocStyle.lyx
\family default
 igen\SpecialChar \@.

\end_layout

\begin_layout Enumerate
L<EFBFBD>s derefter 
\emph on
Brugermanual
\emph default
 og 
\emph on
Selvstudium
\emph default
\SpecialChar \@.

\end_layout

\begin_deeper
\begin_layout Standard
Meningen med denne <20>velse er, at give dig id<69>er\SpecialChar \@.
 
\emph on
Selvstudium
\emph default
 og 
\emph on
Brugermanualen
\emph default
 vil altid v<>re de mest opdaterede filer i dokumentationen\SpecialChar \@.
 Du vil kunne
 f<> et godt indtryk af, hvordan vi vil have manualerne til at se ud og virke\SpecialChar \@.

\end_layout

\end_deeper
\begin_layout Enumerate
Kontakt holdet p<> engelsk p<>: 
\end_layout

\begin_deeper
\begin_layout Standard

\family typewriter
lyx-docs@lists.lyx.org
\end_layout

\begin_layout Standard
og beskriv de <20>ndringer, du foresl<73>r og g<> noget respons p<> dem\SpecialChar \@.

\end_layout

\end_deeper
\begin_layout Standard
De <20>ndringer, du kan foresl<73> at lave kan v<>re alt lige fra at <20>ge forst<73>elighede
n af teksten til at lave st<73>rre omstruktureringer af dokumentationen.
 Alle forbedringer modtages med tak\SpecialChar \@.

\end_layout

\end_body
\end_document