summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/dk-bib/dk-bib.ltx
blob: 4782345b222e2691f84f7559e2c0d478a0fed97e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
% Copyright (C) 2004, 2005, 2006 Arne Jørgensen

% This file is free software; you can redistribute it and/or modify it
% under the terms of the GNU General Public License as published by
% the Free Software Foundation; either version 2 of the License, or
% (at your option) any later version.

% This file is distributed in the hope that it will be useful, but
% WITHOUT ANY WARRANTY; without even the implied warranty of
% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
% General Public License for more details.

% You should have received a copy of the GNU General Public License
% along with this file; if not, write to the Free Software Foundation,
% Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

\documentclass[a4paper,pointednumbers,abstracton,bibtotoc]{scrartcl}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage[english,danish]{babel}
\usepackage{lmodern}
\usepackage[osf,sc]{mathpazo}
\usepackage{booktabs}
\usepackage[danish]{varioref}
\usepackage[protrusion=true,expansion=true]{microtype}
\usepackage{hyperref}

% subversion date and revision
\def\dkbib@svn $#1 #2 #3 #4-#5-#6 #7 #8 ${%
  \def\dkbibrevision{#3}
  \year  =#4
  \month =#5
  \day   =#6
}
\dkbib@svn $Id: dk-bib.ltx 90 2006-05-17 20:51:31Z arne $

% this is how the LaTeX package can be called
\usepackage[isbn=true,ordinals2word=true]{dk-bib}

% if you want your own way of typesetting URL's, ISBN's, and ISSN's do
\newcommand{\dkbiburl}[1]{\textsc{url} \url{#1}}
\newcommand{\dkbibisbn}[1]{%
  \textsc{isbn} \href{http://isbn.nu/#1}{#1}}

\newcommand{\BibTeX}{\textsc{Bib}\TeX}
\bibliographystyle{dk-plain}

\setkomafont{title}{\rmfamily}
\setkomafont{sectioning}{\rmfamily\bfseries}

\title{Dk-bib -- danske varianter af \BibTeX s standardstilarter}
\author{Arne Jørgensen\thanks{\href{mailto:arne.jorgensen@tug.dk}%
    {\texttt{arne.jorgensen@tug.dk}}}}
\makeatletter
\hypersetup{pdfauthor={Arne J\o rgensen},
  pdftitle={Dk-bib Manual, version \dkbib@version\ (r\dkbibrevision)},
  pdfsubject={Danish variants of the standard BibTeX styles, version \dkbib@version},
  pdfkeywords={dk-abbrv.bst dk-alpha.bst dk-apali.bst dk-plain.bst
    dk-unsrt.bst dk-bib.sty 88591-dk.csf cp850-dk.csf mac-dk.csf
    utf8-dk.csf BibTeX BibTeX8 LaTeX},
  pdfstartview={FitH},
}
\makeatother

\begin{document}
\maketitle

{\selectlanguage{english}{%
\renewcommand{\abstractname}{Abstract in English}
\begin{abstract}
  Dk-bib is a translation of the four standard \BibTeX\ style files
  (abbrv, alpha, plain and unsrt) and the apalike style file into
  Danish. The files have been extended with \textsc{url},
  \textsc{isbn}, \textsc{issn}, \texttt{annote} and \texttt{printing}
  fields which can be enabled through a \LaTeX\ style file.

  Dk-bib also comes with a couple of Danish sorting order files for
  \BibTeX8.

  This manual is in Danish.
\end{abstract}
}}
\section{Introduktion}
Dk-bib er en oversættelse til dansk af de fire
\BibTeX-standardstilarter (abbrv, alpha, plain, unsrt), samt
apalike-stilarten.

Stilarterne er udvidet med \textsc{url}-, \textsc{isbn}-,
\textsc{issn}-, \texttt{printing}- (oplag) og \texttt{annote}-felter
der kan slås til ved hjælp af den medfølgende \LaTeX-pakke.

Sammen med dk-bib leveres også en række danske sorteringsdefinitioner
til \BibTeX8.

Har du brug for en generel introduktion til \BibTeX\ kan kapitel~12
og~13 i~\cite{Mittelbach:2004} anbefales.

\section{Simpel brug}
I sin simpleste form anvendes de ved blot at skrive
\begin{verbatim}
  \bibliographystyle{dk-plain}
\end{verbatim}
i stedet for
\begin{verbatim}
  \bibliographystyle{plain}
\end{verbatim}
i \LaTeX-dokumentet.

Dette bevirker at der blandt andet skrives \emph{og} mellem
forfatternavne i stedet for det engelske \emph{and} og at der skrives
for eksempel \emph{2.~udgave} i stedet for \emph{second edition}.

\subsection{Apalike-stilarten}
Ønsker du at bruge oversættelsen af apalike-stilarten skal du forkorte
en smule og blot skrive
\begin{verbatim}
  \bibliographystyle{dk-apali}
\end{verbatim}

Apalike.bst har brug for en anden udgave af \LaTeX's
\verb|\cite|-kommando end den der som standard er defineret. Vi er
derfor nødt til at fortælle \LaTeX\ at vi bruger apalike.

Det kan du gøre ved at tilføje følgende i præamblen:
\begin{verbatim}
  \usepackage[apalike]{dk-bib}
\end{verbatim}

\section{ISBN-, ISSN- og URL-felter}
Hvis \BibTeX-databasen indeholder \textsc{isbn}-, \textsc{issn}- eller
\textsc{url}-felter og du ønsker at have disse med i din
litteraturliste kan du gøre bruge at \LaTeX-pakken \texttt{dk-bib}.

I præamblen af dit \LaTeX-dokument tilføjer du
\begin{verbatim}
  \usepackage[isbn,issn,url]{dk-bib}
\end{verbatim}

Hvis du er utilfreds med måden disse felter bliver sat på er det
muligt at definere din egen måde. Det gør du ved i præamblen at
definere en eller flere af kommandoerne \verb|\dkbibisbn|,
\verb|\dkbibissn| og \verb|\dkbiburl|. De skal alle tage ét argument,
henholdsvis \textsc{isbn}"-nummeret, \textsc{issn}"-nummeret og
\textsc{url}'en.

Følgende eksempel sætter ordet \textsc{isbn} med kapitæler og gør
\textsc{isbn}-nummeret til et link (ved hjælp af hyperref-pakken):
\begin{verbatim}
  \newcommand{\dkbibisbn}[1]{%
    \textsc{isbn} \href{http://isbn.nu/#1}{#1}}
\end{verbatim}

\section{"`Printing"'-feltet til oplagsnumre}
Ønsker du at medtage hvilket oplag af en publikation du referer eller
henviser til kan du gøre brug af \verb|printing|-feltet. I
\verb|.bib|-filen tilføjes for eksempel nedenstående ved en
publikation:
\begin{verbatim}
  printing =     {1},
\end{verbatim}

Af hensyn til bagudkompatibiliteten medtages dette dog ikke i
litteraturlisten før det aktiveres ved at tilføje \verb|printing| som
tilvalg til \verb|dk-bib|-pakken:
\begin{verbatim}
  \usepackage[printing]{dk-bib}
\end{verbatim}

Bemærk at de danske \BibTeX-stilarter er de eneste der benytter
\verb|printing|-feltet og at der tilsyneladende ikke er andre
\BibTeX-stilarter der medtager oplagsinformation. Deler du dine
\verb|.bib|-filer med andre \LaTeX-brugere kan du derfor ikke
umiddelbart forvente at de vil kunne gøre brug af oplagsnummeret i
dine \verb|.bib|-filer eller at du har glæde af oplagsnumre i deres.

\section{Ordenstal i "`edition"'- og "`printing"'-felterne}
Hvis du udveksler \BibTeX-databasefiler (\texttt{.bib}-filer) med
andre \LaTeX-brugere vil du måske bemærke at der er tradition for at
skrive udgavenummeret med ord og på engelsk, for eksempel

\begin{verbatim}
  edition =      {second},
\end{verbatim}

De danske \BibTeX-stilarter oversætter disse (op til 
\makeatletter
\@nameuse{dkbib@word\the\dkbib@maxordinaldepth}
\makeatother
udgave) til \emph{2.~udgave}. På samme vis oversættes oplagsnummeret.

Ønsker du at der i din danske litteraturliste i stedet for for
eksempel \emph{2.~udgave} står \emph{anden udgave} kan du bruge
\LaTeX-pakken \texttt{dk-bib} således:

\begin{verbatim}
  \usepackage[ordinals2word]{dk-bib}
\end{verbatim}

Bemærk at udgave og oplag bliver omskrevet uanset om der i
\BibTeX-databasen står \emph{second} som ovenfor eller for eksempel

\begin{verbatim}
  edition = 	 {2},
\end{verbatim}

Som udgangspunkt omskrives i dette tilfælde alle udgave- og
oplagsnumre op til og med 
\makeatletter
\emph{\@nameuse{dkbib@word\the\dkbib@maxordinaldepth}}%
\makeatother%
, men du kan selv sætte en \emph{lavere}
grænse med
\begin{verbatim}
  \usepackage[ordinals2word,ordinaldepth=10]{dk-bib}
\end{verbatim}

\section{"`Annote"'-feltet til kommentarer}
Blandt \BibTeX's "`standardfelter"' finder vi \texttt{annote}-feltet
der kan bruges til at fremstille en kommenteret litteraturliste.

Ønsker du at få disse kommentarer med i din litteraturliste bruges
\texttt{annote}-tilvalget til \texttt{dk-bib}-pakken:

\begin{verbatim}
  \usepackage[annote]{dk-bib}
\end{verbatim}

Kommentarerne bliver sat i en typografi der minder om dem der anvendes
af \BibTeX-stilarterne annotate og annotation.

Du kan bestemme en anden typografi ved at definere kommandoen
\verb|\dkbibannote| i præamblen. Kommandoen skal tage to argumenter;
nøglen i \BibTeX-databasen og selve kommentaren, for eksempel

\begin{verbatim}
  \newcommand{\dkbibannote}[2]{\textbf{#1:} #2}
\end{verbatim}

\section{"`Specialeafhandling"' og "`Ph.d.-afhandling"'}
De danske \BibTeX-stilarter oversætter felterne \emph{Master's
  thesis} og \emph{PhD thesis} til henholdsvis
\emph{Specialeafhandling} og \emph{Ph.d.-afhandling}.

Nogle uddannelsesinstitutioner bruger ikke begrebet
\emph{specialeafhandling}, men for eksempel \emph{hovedopgave} eller
slet og ret \emph{speciale}. Andre kan få ret ophidsede diskussioner
ud af stavemåden af ph.d.

Måden man løser dette på er (helt uafhængigt af dk-bib) at indsætte
et \texttt{type}-felt i \BibTeX-databasen ved den pågældende
afhandling, for eksempel
\begin{verbatim}
  type = 	 {Hovedopgave},
\end{verbatim}
eller
\begin{verbatim}
  type = 	 {{PhD}-afhandling},
\end{verbatim}

Sidstnævnte er i øvrigt ikke noget forsvar af eller undskyldning for
at anvende en anden stavemåde end den af Dansk Sprognævn anbefalede,
nemlig \emph{ph.d.} (og husk at det ved lov er bestemt at offentlige
myndigheder skal følge sprognævnets anvisninger).

\section{Dansk sortering med \BibTeX8}
Da \BibTeX\ ikke er i stand til at sortere de andre bogstaver end A-Z
og a-z korrekt kan vi på dansk med fordel anvende \BibTeX8.

\BibTeX8 beskrives i \cite[afsnit~13.1.1]{Mittelbach:2004} og leveres som
udgangspunkt med en sorteringdefinition der er tilpasset skandinaviske
sprog og \textsc{iso} 8859-1-tegnsættet. Denne sortering tager dog kun
højde for Æ, æ, Ø, ø, Å og å og sorterer derfor ikke accentuerede
bogstaver med mere korrekt.

\begin{table}
  \centering
  \begin{tabular}{ll}
\toprule
\emph{Sorteringsdefinition} & \emph{Tilvalg til {\ttfamily inputenc}-pakken}\\
\midrule
88591-dk & latin1, latin9, ansinew, cp1252\\
cp850-dk & cp850\\
mac-dk & applemac\\
utf8-dk (eksperimentiel!) & utf8, utf8x\\
\bottomrule
\end{tabular}
\caption{Sorteringsdefinitioner til \BibTeX8 og de tilsvarende tilvalg
  til \texttt{inputenc}-pakken.}
\label{tab:csf-inputenc}
\end{table}

Sammen med denne pakke leveres derfor også et antal
sorteringsdefinitioner tilpasset dansk sortering og flere tegnsæt. Se
sammenhængen mellem sorteringsdefinitioner og tilvalg til
\texttt{inputenc}-pakken i tabel~\vref{tab:csf-inputenc}.

Hvis din \BibTeX-database skal sorteres med \texttt{bibtex8} skal den
skrives i samme tegnsæt som \LaTeX-dokumentet anvender og de danske
bogstaver skal skrives direkte -- det vil sige skriv
\verb|Svend Åge Madsen| og ikke \verb|Svend \AA{}ge Madsen|.

På grund af måden både \BibTeX\ og \BibTeX8 er konstrueret på er der
dog et par problemer der kun besværligt lader sig løse.

BibTeX8 kan ikke sortere dobbelt-A under Å, så har du for eksempel en
forfatter ved navn Ole Aagesen kan du sikre at han placeres korrekt i
bibliografien ved at indskrive følgende i starten af
\texttt{bib}-filen:
\begin{verbatim}
  @preamble{ "\providecommand{\Aa}[1]{Aa}" }
\end{verbatim}
og herefter skrive forfatteren ind i \texttt{bib}-filen som (antallet
af \verb|{}| er vigtigt)
\begin{verbatim}
  author =       {Ole {\Aa{Å}}gesen}
\end{verbatim}

Ligeledes kan \BibTeX8 heller ikke sortere det islandske \TH\ korrekt
under Th. Løsningen er her at skrive (igen er antallet af \verb|{}|
vigtigt)
\begin{verbatim}
  author =       {\TH{}orvaldur Bjarnarson}
\end{verbatim}

Slutteligt vil jeg \emph{advare} mod at bruge sorteringsdefinitionen
til \textsc{utf-8}-tegnsættet uden omhyggelig korrekturlæsning.
Sorteringsdefinitionen benytter sig af en række ikke"-dokumenterede
effekter ved \texttt{bibtex8} og på grund af
\textsc{utf-8}-tegnsættets og \BibTeX8's opbygning kan der forekomme
en række sammenfald mellem sjældent og hyppigere brugte bogstaver (for
eksempel \L{} og \'{A}).

\section{Fejl, forbedringer og tak}
Finder du fejl i oversættelserne, \BibTeX-stilarterne, \LaTeX-pakken
eller har du blot forslag til forbedring er du hjertelig velkommen til
at sende dem via \href{mailto:arne.jorgensen@tug.dk}{e-post} eller på
\url{https://arnested.dk/projects/dk-bib}.

De danske \BibTeX-stilarter er oprindeligt oversat fra den norske
oversættelse af de oprindelige stilarter. En stor tak til Dag Langmyhr
for disse. En tak skal også lyde til Thomas Esser, Morten Høgholm,
Mads Sørensen, Rasmus Villemoes, Thomas Widmann og min kære broder,
Palle Jørgensen, for at bidrage med kommentarer og forslag.

\bibliography{litteratur}

\end{document}

%%% Local Variables: 
%%% mode: latex
%%% TeX-master: t
%%% End: