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
|
%%
%% This is file `rub-kunstgeschichte-example.tex',
%% generated with the docstrip utility.
%%
%% The original source files were:
%%
%% rub-kunstgeschichte.dtx (with options: `example')
%%
%% This is a generated file.
%%
%% Copyright (C) 2024 by Joran Schneyer <joran.schneyer@ruhr-uni-bochum.de>
%%
%% This work may be distributed and/or modified under the
%% conditions of the LaTeX Project Public License, either version 1.3c
%% of this license or (at your option) any later version.
%% The latest version of this license is in
%% https://www.latex-project.org/lppl.txt
%% and version 1.3c or later is part of all distributions of LaTeX
%% version 2008 or later.
%%
%% This work has the LPPL maintenance status `maintained'.
%%
%% The Current Maintainer of this work is Joran Schneyer <joran.schneyer@ruhr-uni-bochum.de>.
%%
%% This work consists of the files rub-kunstgeschichte.dtx
%% rub-kunstgeschichte.ins
%% and the derived files rub-kunstgeschichte.cls
%% rub-kunstgeschichte-example.tex
%%
%% Load the rub-kunstgeschichte class
\documentclass{rub-kunstgeschichte}
\title{Example usage of the \textsf{rub-kunstgeschichte} class}
\author{Joran Schneyer}
\configureTitlepage{
email = {joran.schneyer@ruhr-uni-bochum.de}
}
%% bibliography file (usually you would put this in a seperate .bib file)
\begin{filecontents}{rub-kunstgeschichte-example.bib}
@manual{guidelines,
author = {{Kunstgeschichtliches Institut}},
year = {2023},
title = {Anleitung zur Erstellung von Hausarbeiten im Fach Kunstgeschichte},
organization = {Ruhr University Bochum},
url = {https://kgi.ruhr-uni-bochum.de/wp-content/uploads/2023/04/Anleitung-zum-Erstellen-von-Hausarbeiten-im-Fach-Kunstgeschichte_Fassung-Juli-2023.pdf},
urldate = {2024-11-04}
}
@article{exampleArticle,
author = {Maxi Mustermann},
title = {A very interesting article},
year = {2001},
journal = {Important example journal}
}
@book{exampleBook,
author = {John Smith},
title = {A long example book marked as primary literature},
year = {2024},
keywords = {source}
}
@inbook{bible,
author = {{The Bible}},
title = {The Holy Bible: King James Version},
booktitle = {The New Testament},
publisher = {Oxford University Press},
year = {1769},
location = {Oxford},
keywords = {source}
}
@online{exampleWebsite,
author = {{Example consortium}},
title = {The truth about example documents},
year = {2020},
note = {Internet forum article},
url = {https://example.com},
urldate = {2100-04-01}
}
@manual{biblatexDocs,
author = {Philip Kime and Moritz Wemheuer and Philipp Lehman},
title = {The biblatex Package},
subtitle = {Programmable Bibliographies and Citations},
year = {2024},
url = {https://ctan.org/pkg/biblatex},
urldate = {2024-06-25}
}
@online{biblatexCheatsheet,
title = {Biblatex Cheat Sheet},
author = {Clea F. Rees},
year = {2017},
url = {https://ctan.org/pkg/biblatex-cheatsheet},
urldate = {2024-06-25}
}
\end{filecontents}
\addbibresource{rub-kunstgeschichte-example.bib}
%% Load additional packages
\usepackage[ngerman]{babel} % Sets the language of the document
\usepackage{graphicx}
\usepackage{float}
\begin{document}
\maketitle
\tableofcontents
\section{Introduction}
The \textsf{rub-kunstgeschichte} class aims to implement
the guidelines on scientific writing of the art history institute
``KGI'' (\textit{Kunstgeschichtliches Institut})
at Ruhr University Bochum.
This example document showcases a typical use
of the \textsf{rub-kunstgeschichte} class.
Just by using the class, the page is already formatted
so that the typeset text has 12pt font size,
there is a 1.5 times line-spacing present
and the page size is A4 with 2cm margins at top, left and bottom,
as well as a 4cm margin on the right.\autocite[See:][11]{guidelines}
Also, paragraphs don't have an indentation
in the first line by default,
contrary to typical \LaTeX{} documents.
Furthermore the \texttt{hyperref} package
is automatically loaded to enable clickable
links and references.
Notably, the first page is a custom title page
that aims to recreate the titlepage template
of the guidelines in \LaTeX.
Note, how the fields have descriptive default values in CAPS,
so that you can easily see which information is still missing
for the title page.
As the documentation of this class states,
you can either pass the corresponding key-value options
into an optional argument of \verb|\maketitle|,
or use the \verb|\configureTitlepage| macro
in the preamble.\footnote{For a full list of titlepage options
refer to the \texttt{rub-kunstgeschichte} class documentation.}
We use the \texttt{babel} package
to set the language to german
(even though this example document is actually written in english)
to showcase how headings are automatically translated.
\section{How to cite sources}
This class automatically loads the \texttt{biblatex} package
for sophisticated bibliography and citations.
The class also sets some options by default
that make \texttt{biblatex} behave closer to the
suggested citation style in the guidelines of the institute.
You can cite sources using the \verb|\autocite| command,
which is configured by this class to use footnotes
\autocite{exampleArticle}.
Page numbers can be added in the optional argument
\autocite[394]{exampleBook}
and citation signals in a second one
that comes before the one for page numbers
\autocite[see][]{exampleWebsite}.
You can even cite multiple sources at once
using the \verb|\autocites| command
\autocites[111]{exampleBook}[see also][13]{exampleArticle}.
For more information refer to the documentation
of the \texttt{biblatex} package
\autocite{biblatexDocs}
or the biblatex cheatsheet
\autocite{biblatexCheatsheet}.
\clearpage
\appendix
\section{The appendix}
We finished the main content of the example document
so we call \verb|\appendix| before this first appendix section.
It will automatically disable section numbering
for any appendix sections.
Here, we can include a bibliography
containing all cited sources,
divided into primary and secondary literature,
with \verb|\printbibliographies|.
Primary literature (also called a \textit{source})
is something like the bible\autocite{bible},
letters, treatises etc.
We put the bibliography on a new page
by using \verb|\clearpage| before printing it.
Note, that since we used
\verb|\usepackage[ngerman]{babel}| in the preamble,
the headings of the bibliography are typed in german.
\clearpage
\printbibliographies
\clearpage
\section{Figures}
The guidelines suggest putting all figures
in a dedicated appendix section
after the bibliography instead of in between the
main content text.\autocite[10,25]{guidelines}
We can include figures with \verb|\includegraphics|
inside a \texttt{figure} environment.
We also add a caption with the meta information
of the shown artwork,\autocite[25--26]{guidelines}
as well as a short caption in square brackets
and a label for back-referencing.
\begin{figure}[H]
\centering
\includegraphics[width=0.8\linewidth]{example-image-golden}
\caption{An Artist, The artwork title, Where was it made?,
The year, Material, Measurements, Where is it kept?,
Inventory number.}
\label{fig:exampleArtwork}
\end{figure}
\end{document}
\endinput
%%
%% End of file `rub-kunstgeschichte-example.tex'.
|