Debian Codegraph @

texmf-dist/source/latex/dccpaper/dccpaper.dtx

raw
1 % \iffalse meta-comment
2 %<*internal|ijdc9|ijdc14|idcc|base>
3 \def\Version{2026/05/08 v2.7}
4 %</internal|ijdc9|ijdc14|idcc|base>
5 %<*internal>
6 \iffalse
7 %</internal>
8 %<*readme>
9 # The dccpaper bundle: LaTeX classes for submissions to IJDC and IDCC
10
11 The dccpaper bundle consists of three very similar classes.
12
13 ijdc-v14.cls corresponds to the template used by the
14 [International Journal of Digital Curation], beginning with volume 14.
15
16 ijdc-v9.cls corresponds to the template used by the
17 [International Journal of Digital Curation] for volumes 9 to 13 inclusive.
18
19 idcc.cls corresponds to the template used for the
20 [International Digital Curation Conference], beginning with IDCC15.
21
22 As the classes are so similar, their common features are abstracted out
23 into dccpaper-base.sty; please do not attempt to use this package
24 independently of the above classes.
25
26 The classes are able to produce both submissions and camera-ready papers.
27
28 [International Journal of Digital Curation]: http://www.ijdc.net/
29 [International Digital Curation Conference]: https://www.dcc.ac.uk/events/idcc
30
31 %</readme>
32 %<ijdc9|ijdc14|idcc|base>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
33 %<*ijdc9>
34 \ProvidesClass{ijdc-v9}
35 [\Version\space Class for submissions to the International Journal of Digital Curation, volumes 9--13 inclusive.]
36 %</ijdc9>
37 %<*ijdc14>
38 \ProvidesClass{ijdc-v14}
39 [\Version\space Class for submissions to the International Journal of Digital Curation, volume 14 onwards.]
40 %</ijdc14>
41 %<*idcc>
42 \ProvidesClass{idcc}
43 [\Version\space Class for submissions to the International Digital Curation Conference.]
44 %</idcc>
45 %<*base>
46 \ProvidesPackage{dccpaper-base}
47 [\Version\space Common class code for IJDC and IDCC papers.]
48 %</base>
49 %<*biblatex|apacite>
50 @book{apa6ed,
51 author = {{American Psychological Association}},
52 shortauthor = {{APA}},
53 publisher = {Author},
54 %<biblatex> date = {2010},
55 %<apacite> year = {2010},
56 title = {Publication manual of the {American} {Psychological} {Association}},
57 edition = {6},
58 %<biblatex> location = {Washington, DC}
59 %<apacite> address = {Washington, DC}
60 }
61
62 @book{borgman2007sda,
63 author = {Borgman, C. L.},
64 %<biblatex> date = {2007},
65 %<apacite> year = {2007},
66 %<biblatex> title = {Scholarship in the digital age},
67 %<biblatex> subtitle = {Information, infrastructure, and the {Internet}},
68 %<apacite> title = {Scholarship in the digital age: Information, infrastructure, and the {Internet}},
69 %<biblatex> location = {Cambridge, MA},
70 %<apacite> address = {Cambridge, MA},
71 publisher = {MIT Press}
72 }
73
74 @inbook{borgman.etal2006bdl,
75 author = {Borgman, C. L. and Wallis, J. C. and Enyedy, N.},
76 %<biblatex> date = {2006},
77 %<apacite> year = {2006},
78 %<biblatex> title = {Building digital libraries for scientific data},
79 %<biblatex> subtitle = {An exploratory study of data practices in habitat ecology},
80 %<apacite> title = {Building digital libraries for scientific data: An exploratory study of data practices in habitat ecology},
81 editor = {J. Gonzalo and C. Thanos and M. F. Verdejo and R. C. Carrasco},
82 %<biblatex> booktitle = {{Lecture} {Notes} in {Computer} {Science}},
83 %<biblatex> booksubtitle = {Vol. 4172. {Research} and {Advanced} {Technology} for {Digital} {Libraries}},
84 %<apacite> booktitle = {{Lecture} {Notes} in {Computer} {Science:} {Vol.} 4172. {Research} and {Advanced} {Technology} for {Digital} {Libraries}},
85 pages = {170--183},
86 doi = {10.1007/11863878_15}
87 }
88
89 %<biblatex>@report{ccsds2012oais,
90 %<apacite>@techreport{ccsds2012oais,
91 author = {{Consultative Committee for Space Data Systems}},
92 shortauthor = {{CCSDS}},
93 %<biblatex> date = {2012},
94 %<apacite> year = {2012},
95 title = {Reference model for an {Open} {Archival} {Information} {System} {(OAIS)}},
96 type = {Magenta Book},
97 number = {CCSDS 650.0-M-2},
98 url = {http://public.ccsds.org/publications/archive/650x0m2.pdf}
99 }
100
101 %<biblatex>@report{dcc2005dcp,
102 %<apacite>@techreport{dcc2005dcp,
103 author = {{Digital Curation Centre}},
104 %<biblatex> date = {2005},
105 %<apacite> year = {2005},
106 %<biblatex> title = {Digital curation and preservation},
107 %<biblatex> subtitle = {Defining the research agenda for the next decade},
108 %<apacite> title = {Digital curation and preservation: Defining the research agenda for the next decade},
109 %<apacite> type = {\bibnotype},
110 %<biblatex> note = {Report of the Warwick Workshop, November 7–8, 2005},
111 %<apacite> howpublished = {Report of the Warwick Workshop, November 7–8, 2005},
112 url = {http://www.dcc.ac.uk/webfm_send/346}
113 }
114
115 @article{esanu.etal2004sar,
116 author = {Esanu, J. and Davidson, J. and Ross, S. and Anderson, W.},
117 %<biblatex> date = {2004},
118 %<apacite> year = {2004},
119 %<biblatex> title = {Selection, appraisal, and retention of digital scientific data},
120 %<biblatex> subtitle = {Highlights of an {ERPANET\slash CODATA} workshop},
121 %<apacite> title = {Selection, appraisal, and retention of digital scientific data: Highlights of an {ERPANET\slash CODATA} workshop},
122 %<biblatex> journaltitle = {Data Science Journal},
123 %<apacite> journal = {Data Science Journal},
124 volume = {3},
125 pages = {227--232},
126 url = {http://www.jstage.jst.go.jp/browse/dsj}
127 }
128
129 @article{mazairac.beetzIPboq,
130 author = {Mazairac, W. and Beetz, J.},
131 %<biblatex> pubstate = {inpress},
132 %<apacite> year = {\BIP},
133 %<biblatex> title = {{BIMQL}},
134 %<biblatex> subtitle = {An Open Query Language for Building Information Models},
135 %<apacite> title = {{BIMQL}: An Open Query Language for Building Information Models},
136 %<biblatex> journaltitle = {Advanced Engineering Informatics},
137 %<apacite> journal = {Advanced Engineering Informatics},
138 doi = {10.1016/j.aei.2013.06.001}
139 }
140
141 %<biblatex>@report{nsf2003rse,
142 %<apacite>@techreport{nsf2003rse,
143 author = {{National Science Foundation, Blue-Ribbon Advisory Panel on Cyberinfrastructure}},
144 %<biblatex> date = {2003},
145 %<apacite> year = {2003},
146 title = {Revolutionizing science and engineering through cyberinfrastructure},
147 %<apacite> type = {\bibnotype},
148 url = {http://www.nsf.gov/publications/pub_summ.jsp?ods_key=cise051203}
149 }
150
151 @article{rinaldo.etal2011rsc,
152 author = {Rinaldo, C. and Warnement, J. and Baione, T. and Kalfatovic, M. R. and Fraser, S.},
153 %<biblatex> date = {2011-07},
154 %<apacite> year = {2011},
155 %<apacite> month = jul,
156 title = {Retooling special collections digitisation in the age of mass scanning},
157 %<biblatex> journaltitle = {Ariadne},
158 %<apacite> journal = {Ariadne},
159 volume = {67},
160 url = {http://www.ariadne.ac.uk/issue67/rinaldo-et-al/}
161 }
162
163 @unpublished{santini2004sas,
164 author = {Santini, M.},
165 %<biblatex> date = {2004},
166 %<apacite> year = {2004},
167 title = {A shallow approach to syntactic feature extraction for genre classification},
168 howpublished = {Paper presented at the Seventh Annual Colloquium for the UK Special Interest Group for Computational Linguistics, Birmingham, UK},
169 url = {ftp://ftp.itri.bton.ac.uk/reports/ITRI-04-02.pdf}
170 }
171
172 %<biblatex>@report{santini2004saa,
173 %<apacite>@techreport{santini2004saa,
174 author = {Santini, M.},
175 %<biblatex> date = {2004},
176 %<apacite> year = {2004},
177 title = {State-of-the-art on automatic genre identification},
178 type = {Technical Report},
179 number = {ITRI-04-03},
180 institution = {Information Technology Research Institute},
181 url = {ftp://ftp.itri.bton.ac.uk/reports/ITRI-04-03.pdf}
182 }
183
184 @article{smith.etal2003das,
185 author = {Smith, M. and Barton, M. and Bass, M. and Branschofsky, M. and McClellan, G. and Stuve, D. and Walker, J. H.},
186 %<biblatex> date = {2003},
187 %<apacite> year = {2003},
188 %<biblatex> title = {{DSpace}},
189 %<biblatex> subtitle = {An open source dynamic digital repository},
190 %<apacite> title = {{DSpace}: An open source dynamic digital repository},
191 %<biblatex> journaltitle = {D-Lib Magazine},
192 %<apacite> journal = {D-Lib Magazine},
193 volume = {9},
194 number = {1},
195 doi = {10.1045/january2003-smith}
196 }
197
198 %<biblatex>@data{waterton.etal2013ual,
199 %<apacite>@misc{waterton.etal2013ual,
200 author = {Waterton, C. and Watson, N. and Norton, L.},
201 title = {Understanding and Acting in {Loweswater}, 2007–2010},
202 %<biblatex> entrysubtype = {Data set},
203 %<apacite> type = {Data set},
204 %<biblatex> date = {2013},
205 %<apacite> year = {2013},
206 publisher = {UK Data Archive},
207 %<biblatex> location = {Colchester, UK},
208 %<apacite> address = {Colchester, UK},
209 doi = {10.5255/UKDA-SN-7359-1}
210 }
211
212 @book{witten.frank2005dmp,
213 author = {Witten, I. H. and Frank, E.},
214 %<biblatex> date = {2005},
215 %<apacite> year = {2005},
216 %<biblatex> title = {Data mining},
217 %<biblatex> subtitle = {Practical machine learning tools and techniques},
218 %<apacite> title = {Data mining: Practical machine learning tools and techniques},
219 edition = {2},
220 %<biblatex> location = {San Francisco, CA},
221 %<apacite> address = {San Francisco, CA},
222 publisher = {Morgan Kaufmann}
223 }
224 %</biblatex|apacite>
225 %<*internal>
226 \fi
227 \def\nameofplainTeX{plain}
228 \ifx\fmtname\nameofplainTeX\else
229 \expandafter\begingroup
230 \fi
231 %</internal>
232 %<*install>
233 \input docstrip.tex
234 \keepsilent
235 \askforoverwritefalse
236 \preamble
237
238 ----------------------------------------------------------------
239 The dccpaper bundle: Classes for submissions to IJDC and IDCC
240 Author: Alex Ball
241 E-mail: [email protected]
242 License: Released under the LaTeX Project Public License v1.3c or later
243 See: http://www.latex-project.org/lppl.txt
244 ----------------------------------------------------------------
245
246 \endpreamble
247 \postamble
248
249 Copyright (C) 2026 Digital Curation Centre, University of Edinburgh
250 <[email protected]>
251 \endpostamble
252
253 \usedir{tex/latex/dccpaper}
254 \generate{
255 \file{ijdc-v9.cls}{\from{\jobname.dtx}{ijdc9}}
256 \file{ijdc-v14.cls}{\from{\jobname.dtx}{ijdc14}}
257 \file{idcc.cls}{\from{\jobname.dtx}{idcc}}
258 \file{dccpaper-base.sty}{\from{\jobname.dtx}{base}}
259 }
260 %</install>
261 %<install>\endbatchfile
262 %<*internal>
263 \usedir{source/latex/dccpaper}
264 \generate{
265 \file{\jobname.ins}{\from{\jobname.dtx}{install}}
266 }
267 \nopreamble\nopostamble
268 \usedir{doc/latex/dccpaper}
269 \generate{
270 \file{README.md}{\from{\jobname.dtx}{readme}}
271 \file{dccpaper-biblatex.bib}{\from{\jobname.dtx}{biblatex}}
272 \file{dccpaper-apacite.bib}{\from{\jobname.dtx}{apacite}}
273 }
274 \ifx\fmtname\nameofplainTeX
275 \expandafter\endbatchfile
276 \else
277 \expandafter\endgroup
278 \fi
279 %</internal>
280 %<*driver>
281 \ProvidesFile{dccpaper.dtx}
282 [\Version\ Classes for submissions to IJDC and IDCC]
283 \documentclass{ijdc-v14}
284 \let\DccpaperMaketitle=\maketitle
285
286 % For typesetting the documentation generally
287 \usepackage{doc}
288 \usepackage{enumitem}
289 \usepackage{listings}
290 \colorlet{Command}{red!75!black}
291 \colorlet{Environment}{blue!75!black}
292 \colorlet{Option}{violet}
293 \colorlet{Value}{olive!75!black}
294 \lstloadlanguages{[LaTeX]TeX}
295 \lstset
296 { columns=fullflexible
297 , basicstyle=\ttfamily
298 , language={[LaTeX]TeX}
299 , texcsstyle=*\color{Command}
300 , moretexcs=
301 { affil
302 , conference
303 , correspondence
304 , submitted
305 , received
306 , revised
307 , accepted
308 , subno
309 , volume
310 , issue
311 , maketitle
312 , sisetup
313 , toprule
314 , cmidrule
315 , midrule
316 , bottomrule
317 , DeclareLanguageMapping
318 , printbibliography
319 , addbibresource
320 , subsection
321 , subparagraph
322 }
323 , moredelim=**[s][\color{Option}]{[}{]}
324 , moredelim=**[s][\color{Environment}]{\{}{\}}
325 , mathescape
326 }
327 \newcommand*{\pkg}[1]{\href{http://www.ctan.org/pkg/#1}{\textsf{#1}}}
328 \ifcsname cs\endcsname
329 \renewcommand*{\cs}[1]{\textcolor{Command}{\texttt{\textbackslash#1}}}
330 \else
331 \newcommand*{\cs}[1]{\textcolor{Command}{\texttt{\textbackslash#1}}}
332 \fi
333 \newcommand*{\env}[1]{\textcolor{Environment}{\ttfamily #1}}
334 \newcommand*{\key}[1]{\textcolor{Option}{\ttfamily #1}}
335 \newcommand*{\val}[1]{\textcolor{Value}{\ttfamily #1}}
336 \let\myrmfamily=\rmfamily
337 \renewcommand*{\meta}[1]{\ensuremath{\langle\textrm{\emph{#1}}\rangle}}
338 \def\brackets#1{%
339 \texttt{\textcolor{Environment}{\char`\{}#1\textcolor{Environment}{\char`\}}}}
340 \def\marg#1{%
341 \textcolor{Environment}{\ttfamily\char`\{}\meta{#1}\textcolor{Environment}{\ttfamily\char`\}}}
342 \def\sqbrackets#1{%
343 \texttt{\textcolor{Option}{[}#1\textcolor{Option}{]}}}
344 \def\oarg#1{%
345 \textcolor{Option}{\ttfamily\char`\{}\meta{#1}\textcolor{Option}{\ttfamily\char`\}}}
346 \makeatletter
347 \let\PrintMacroName=\@gobble
348 \let\PrintEnvName=\@gobble
349 \makeatother
350 \newenvironment{optionkey}[1]{}{}
351 \newenvironment{optionvalue}[1]{}{}
352
353 % For typesetting the implementation
354 \usepackage{metalogo}
355 % This bit inspired by ydoc
356 \makeatletter
357 \newwrite\ydocwrite
358 \def\ydocfname{\jobname.lsttemp}
359 \def\ydoc@catcodes{%
360 \let\do\@makeother
361 \dospecials
362 \catcode`\\=\active
363 \catcode`\^^M=\active
364 \catcode`\ =\active
365 }
366 \def\macrocode{%
367 \begingroup
368 \ydoc@catcodes
369 \macro@code
370 }
371 \def\endmacrocode{}
372 \begingroup
373 \endlinechar\m@ne
374 \@firstofone{%
375 \catcode`\|=0\relax
376 \catcode`\(=1\relax
377 \catcode`\)=2\relax
378 \catcode`\*=14\relax
379 \catcode`\{=12\relax
380 \catcode`\}=12\relax
381 \catcode`\ =12\relax
382 \catcode`\%=12\relax
383 \catcode`\\=\active
384 \catcode`\^^M=\active
385 \catcode`\ =\active
386 }*
387 |gdef|macro@code#1^^M% \end{macrocode}(*
388 |endgroup|expandafter|macro@@code|expandafter(|ydoc@removeline#1|noexpand|lastlinemacro)*
389 )*
390 |gdef|ydoc@removeline#1^^M(|noexpand|firstlinemacro)*
391 |gdef|ydoc@defspecialmacros(*
392 |def^^M(|noexpand|newlinemacro)*
393 |def (|noexpand|spacemacro)*
394 |def\(|noexpand|bslashmacro)*
395 )*
396 |gdef|ydoc@defrevspecialmacros(*
397 |def|newlinemacro(|noexpand^^M)*
398 |def|spacemacro(|noexpand )*
399 |def|bslashmacro(|noexpand\)*
400 )*
401 |endgroup
402 \def\macro@@code#1{%
403 {\ydoc@defspecialmacros
404 \xdef\themacrocode{#1}}%
405 \PrintMacroCode
406 \end{macrocode}%
407 }
408 \def\PrintMacroCode{%
409 \begingroup
410 \let\firstlinemacro\empty
411 \let\lastlinemacro\empty
412 \def\newlinemacro{^^J}%
413 \let\bslashmacro\bslash
414 \let\spacemacro\space
415 \immediate\openout\ydocwrite=\ydocfname\relax
416 \immediate\write\ydocwrite{\themacrocode}%
417 \immediate\closeout\ydocwrite
418 \let\input\@input
419 \lstinputlisting[firstnumber=last]{\ydocfname}%
420 \endgroup
421 }
422 \makeatother
423
424 \let\maketitle=\DccpaperMaketitle
425
426 \usepackage{dcolumn,csquotes,framed}
427 \usepackage[iso,british]{isodate}
428 \usepackage[expansion=false]{microtype}
429 \ifXeTeX\else\DisableLigatures{family=tt*}\fi
430 \undef\Bbbk % Work around conflict with amsmath, loaded by markdown
431 \usepackage[tightLists=false]{markdown}
432 \markdownSetup{rendererPrototypes={%
433 link = {#1\footnote{\ifx\empty#4\empty\else#4:
434 \fi\url{#3}}}%
435 }}
436 \usepackage{fnpct}
437
438 \ifx\undefined\apacitefalse
439 \usepackage[style=apa]{biblatex}
440 \addbibresource{dccpaper-biblatex.bib}
441 \DeclareLanguageMapping{british}{british-apa}
442 \else
443 \usepackage{apacite}
444 \bibliographystyle{apacite}
445 \let\textcite=\citeA
446 \let\autocite=\cite
447 \fi
448
449 \title[The \textsf{dccpaper} bundle]{The \protect\textsf{dccpaper} bundle: Classes for submissions to IJDC and IDCC}
450
451 \author{Alex Ball}
452 \affil{University of Bath}
453 \correspondence{Alex Ball, University of Bath, Claverton Down, Bath BA2 7AY. Email: \email{[email protected]}}
454
455 \received{4 July 2013}
456 \revised{10 December 2013}
457 \accepted{1 January 2014}
458
459 \GetFileInfo{dccpaper-base.sty}
460
461 \begin{document}
462 \maketitle
463
464 \begin{abstract}
465 This is the documentation for the \pkg{dccpaper} bundle, consisting of the following classes:
466 \begin{itemize}
467 \item\textsf{ijdc-v14}, which corresponds to the template used by the International Journal of Digital Curation (IJDC), beginning with volume 14.
468 \item\textsf{ijdc-v9}, which corresponds to the template used by the International Journal of Digital Curation for volumes 9 to 13 inclusive.
469 \item\textsf{idcc}, which corresponds to the template used for the International Digital Curation Conference, beginning with IDCC15.
470 \end{itemize}
471
472 The version to which it relates is \fileversion, last revised \printdateTeX{\filedate}.
473
474 The code for this bundle is maintained at \url{https://github.com/alex-ball/dccpaper}.
475
476 Please note that the DOI attached to this document is fake and should not be used for identification purposes.
477
478 \bigskip
479 \begin{framed}\noindent
480 \textbf{Disclaimer:} Only the Microsoft Word templates are officially supported at the time of writing (though the IJDC accepts conversions to ODT format). These \LaTeX\ classes are maintained primarily to support legacy documents.
481 \end{framed}
482 \end{abstract}
483
484 \section{Introduction}
485
486 The \LaTeX\ class \textsf{ijdc-v14} produces camera-ready papers and articles suitable for inclusion in the International Journal of Digital Curation (IJDC), with applicability from volume 14 onwards. This is a minor change to the template used for volumes 9--13, which remains available as \textsf{ijdc-v9}. The similar \textsf{idcc} class produces submissions for the International Digital Curation Conference (IDCC), beginning with the 2015 conference. This document explains how to use these classes.
487
488 \section{Dependencies}
489
490 Certain aspects of the template design have been implemented using third-party packages, aside from those that are required parts of the \LaTeX\ system. Therefore you should ensure that you have these packages installed on your system before attempting to use the class.
491
492 \begin{itemize}
493 \item\pkg{atbegshi} is used for switching geometry between pages.
494 \item Tables in your document must be formatted according to the design principles promoted and supported by the \pkg{booktabs} package.
495 \item\pkg{caption} is used to format the figure and table captions.
496 \item\pkg{etoolbox} is used behind the scenes for patching commands.
497 \item\pkg{footmisc} is used to format the footnotes.
498 \item\pkg{titlesec} is used to format the section headings.
499 \item\pkg{hyperxmp} is used for including an XMP metadata packet.
500 \item\pkg{iftex} is used to test which \TeX\ engine you are using.
501 If you use Lua\LaTeX\ or \XeLaTeX\, you will also need \pkg{fontspec}.
502 \end{itemize}
503
504 In some cases the class prefers to use packages that are not part of the base installation (but are nevertheless commonly available in \TeX\ distributions), but will fall back to their base equivalents if necessary.
505
506 \begin{itemize}
507 \item
508 If using the \textsf{ijdc-v14} class or the \textsf{idcc} class for conferences from
509 2020, the main text font will be the first available out of Baskerville, BaskervilleF
510 (\pkg{baskervillef}), Baskervaldx (\pkg{baskervaldx}), Baskervald (\pkg{baskervaldadf}),
511 or the standard Computer Modern/Latin Modern.
512 The sans-serif font will be the first available out of Lucida Sans, Go Sans
513 (\pkg{gofonts}) or Helvetica (\pkg{helvet}).
514 \item
515 If using the \textsf{ijdc-v9} class or the \textsf{idcc} class for conferences up
516 to 2019,
517 \pkg{newtx} will be used if available in place of \pkg{mathptmx}, and
518 \pkg{tgheros} will be used in place of \pkg{helvet}.
519 \item
520 \pkg{xcolor} will be used if available in place of \pkg{color}.
521 \end{itemize}
522
523 For referencing, you are encouraged to use either \pkg{biblatex-apa} (preferred) or \pkg{apacite}.
524
525 \section{Loading the Classes}
526
527 \subsection{International Journal of Digital Curation}
528
529 The class is loaded in the usual way with
530 \lstinline|\documentclass[$\meta{options}$]{ijdc-v14}|.
531 The following options are available:
532
533 \begin{description}[font=\normalfont\key]
534 \item[paper]
535 Use this for research papers.
536 \item[article]
537 Use this for general articles if you like, but you do not have to as the class defaults to this state.
538 \item[conference]
539 Use this for a conference paper.
540 \item[brief]
541 Use this for a brief report.
542 \item[editorial]
543 Use this for an editorial.
544 \item[preprint]
545 Use this for a conference preprint.
546 \end{description}
547
548 \subsection{International Digital Curation Conference}
549
550 The class is loaded in the usual way with
551 \lstinline|\documentclass[$\meta{options}$]{idcc}|.
552 Two types of option are available. The first relates to the conference to which the submission will be made:
553 \begin{description}[font=\normalfont]
554 \item[\key{15}, \key{16}, .~.~.~, \key{26}, \key{27}]
555 Use this to select the year of the conference, e.g.\@ \key{27} for 2027.
556 \end{description}
557
558 The second relates to the type of submission:
559 \begin{description}[font=\normalfont\key]
560 \item[lightning]
561 Use this for lightning talk proposals.
562 \item[paper]
563 Use this for conference papers and extended abstracts. It is normally the default.
564 \item[poster]
565 (Legacy.) Use this for poster proposals.
566 \item[workshop]
567 (Legacy.) Use this for workshop proposals.
568 \item[abstract]
569 (Legacy.) Use this for conference paper extended abstracts. This becomes the default if you select one of the options for the 2019 to 2022 conferences inclusive.
570 \item[research]
571 (Legacy.) Use this for full research papers.
572 \item[practice]
573 (Legacy.) Use this for full practice papers. This becomes the default if you select one of the options for the 2015 to 2018 conferences inclusive.
574 \item[demo]
575 (Legacy.) Use this for demonstration proposals.
576 \item[bof]
577 (Legacy.) Use this for Birds of a Feather session proposals.
578 \item[data]
579 (Legacy.) Use this for data paper abstracts and full data papers.
580 \end{description}
581
582 \begin{framed}\noindent
583 To emulate a conference paper/extended abstract from 2024,
584 use the \textsf{ijdc-v14} class with the \key{conference} option,
585 rather than the \textsf{idcc} class.
586 \end{framed}
587
588 \section{Preamble Commands}
589
590 The following commands should be given in the preamble to fill out the document metadata.
591
592 The following command should be used in all submissions.
593
594 \begin{description}
595 \item[]
596 \hskip-\labelsep
597 \lstinline|\title[$\meta{name}$]{$\meta{full version}$}|
598 \hskip\labelsep
599 The long version of the title is shown on the cover page of the submission, while the short version appears in the (even page) headers.
600 \end{description}
601
602 The following commands should be given in general articles and IDCC submissions. They should \emph{not} be given in peer-reviewed IJDC papers until after the peer review process is complete.
603
604 \begin{description}
605 \item[]
606 \hskip-\labelsep
607 \lstinline|\author{$\meta{name}$}|
608 \hskip\labelsep
609 The name of one author. Repeat the command for each additional author.
610
611 It is customary in IJDC and IDCC papers to group authors by institution. Within each institution, the authors are ordered by the level of contribution (or alphabetically where this is equal), and the institutional groups are ordered by the level of contribution of the first author in the group (or alphabetically by first author where this is equal). A different convention may be used if appropriate.
612
613 \item[]
614 \hskip-\labelsep
615 \lstinline|\affil{$\meta{name}$}|
616 \hskip\labelsep
617 The affiliation (institution, company) of the immediately preceding author(s). This command may be repeated as necessary.
618
619 \item[]
620 \hskip-\labelsep
621 \lstinline|\correspondence{$\meta{name, postal address.}$ Email: \email{$\meta{email address}$}}|
622 \hskip\labelsep
623 Name, address and email address of the corresponding author. This information appears in the footer of the cover page.
624 \end{description}
625
626 If an IJDC submission is a conference paper (that has not already been formally published), for reasons of transparency the name of the conference should be given.
627
628 \begin{description}
629 \item[]
630 \hskip-\labelsep
631 \lstinline|\conference{$\meta{name of conference}$}|\\\hspace*{\dimexpr-\leftmargini}%
632 \lstinline|\conference*{$\meta{name of conference}$}|
633 \hskip\labelsep
634 The conference at which the earlier version of the paper was presented, e.g.\ ‘the International Digital Curation Conference IDCC24, 19-21 February 2024’. Use the unstarred command if this paper is a reworked version of the conference paper; use the starred command if the paper is unchanged from the conference version.
635 \end{description}
636
637 For IDCC papers, authors are invited to record the date on which they made their submission.
638
639 \begin{description}
640 \item[]
641 \hskip-\labelsep
642 \lstinline|\submitted{$\meta{date}$}|
643 \hskip\labelsep
644 The date on which the initial submission was made to the conference by the authors.
645 \end{description}
646
647 Some additional commands are used by the editorial team when preparing a submission for publication. Though authors would not normally need to use them, here they are for completeness.
648
649 \begin{description}
650 \item[]
651 \hskip-\labelsep
652 \lstinline|\received{$\meta{date}$}|
653 \hskip\labelsep
654 The date on which the initial submission was received by the editorial team (IJDC papers only).
655
656 \item[]
657 \hskip-\labelsep
658 \lstinline|\revised{$\meta{date}$}|
659 \hskip\labelsep
660 The date on which the latest revision was received by the editorial team.
661
662 \item[]
663 \hskip-\labelsep
664 \lstinline|\accepted{$\meta{date}$}|
665 \hskip\labelsep
666 The date on which the submission was accepted for publication.
667
668 \item[]
669 \hskip-\labelsep
670 \lstinline|\subno{$\meta{number}$}|
671 \hskip\labelsep
672 The submission number allocated by the IJDC Open Journal System.
673
674 \item[]
675 \hskip-\labelsep
676 \lstinline|\volume{$\meta{number}$}|
677 \hskip\labelsep
678 The number of the IJDC volume in which the submission will be published.
679
680 \item[]
681 \hskip-\labelsep
682 \lstinline|\issue{$\meta{number}$}|
683 \hskip\labelsep
684 The number of the IJDC issue in which the submission will be published.
685
686 \item[]
687 \hskip-\labelsep
688 \lstinline|\date{$\meta{year}$}|
689 \hskip\labelsep
690 The year in which the submission will be published.
691 \end{description}
692
693 \newpage
694 \section{Document Body}
695
696 When it comes to writing the body of the submission, the template should allow you to use the usual \LaTeX\ markup without much adaptation. So, for example, for a full paper or an IDCC extended abstract, you would start as in Figure~\ref{fig:start-paper}.
697
698 \begin{figure}[ht]
699 \begin{lstlisting}[frame=single]
700 \begin{document}
701 \maketitle
702
703 \begin{abstract}
704 Text of the abstract\dots
705 \end{abstract}
706
707 \section{Introduction}
708
709 The text of the introduction starts here\dots
710 \end{lstlisting}
711 \caption{Sample code for the beginning of an IJDC submission or IDCC paper.}
712 \label{fig:start-paper}
713 \end{figure}
714
715 Please note that if submitting a poster, lightning talk or demonstration proposal to the IDCC instead of a paper, you should \emph{not} use the \texttt{abstract} environment. Instead, start with a section headed `Abstract' as in Figure~\ref{fig:start-abstract} (for posters or lightning talks) or Figure~\ref{fig:start-demo} (overleaf, for demonstrations). Further guidance on how to write such submissions is given on the conference website.
716
717 If submitting a workshop proposal, please see the second document template in \hyperref[sec:samples]{Appendix~D}.
718
719 \begin{figure}[ht]
720 \begin{lstlisting}[frame=single]
721 \begin{document}
722 \maketitle
723
724 \section{Abstract}
725
726 The text of the proposal starts here\dots
727 \end{lstlisting}
728 \caption{Sample code for the beginning of an IDCC proposal.}
729 \label{fig:start-abstract}
730 \end{figure}
731
732 \begin{figure}[ht]
733 \begin{lstlisting}[frame=single]
734 \begin{document}
735 \maketitle
736
737 \begin{description}
738 \item[Demo Organiser(s):]~\\
739 Name, position, organization.
740 \end{description}
741
742 \section{Abstract}
743
744 The text of the proposal starts here\dots
745 \end{lstlisting}
746 \caption{Sample code for the beginning of an IDCC demonstration proposal.}
747 \label{fig:start-demo}
748 \end{figure}
749
750 \noindent
751 IJDC and IDCC papers follow the formatting conventions specified by the \textcite{apa6ed}, with a few minor changes. There are some instances where this affects how you write your submission.
752
753 \subsection{Headings}
754
755 Five levels of heading are defined (\lstinline|\section| down to \lstinline|\subparagraph|) but most authors only need the first one or two levels. \lstinline|\section| and \lstinline|\subsection| headings should be written in title case, that is, with Each Significant Word Given an Initial Capital, while the remaining headers should be written in sentence case as if running text. Do not end your heading names with full stops\slash periods.
756
757 \subsection{Quotations}
758
759 Quotations should be put in a \texttt{quote} environment, wrapped in inverted commas, with the citation placed in parentheses at the end.
760
761 \begin{quote}
762 ‘Cras porttitor dictum lacus. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos hymenaeos. In consectetuer, diam at volutpat elementum, libero lectus pulvinar sem.’ (Borgman, 2007)
763 \end{quote}
764
765 \subsection{Tables}
766
767 \begin{itemize}
768 \item
769 Table text should be in the \lstinline|\small| font size.
770 \item
771 Tables should not use vertical lines to separate columns, and ideally should not use horizontal lines to separate rows in the body of the table; white space and text alignment should be sufficient. The top and bottom rules should be drawn with \lstinline|\toprule| and \lstinline|\bottomrule| respectively, with other rules drawn with \lstinline|\midrule| or \lstinline|\cmidrule|. See the documentation of the \pkg{booktabs} package for more information.
772 \item
773 Text in the body of tables should normally be left-aligned. Numeric data should be aligned at the decimal point among itself but centred with respect to the heading; the \texttt{D} column type from the \pkg{dcolumn} package and the \texttt{S} column type from the \pkg{siunitx} package are particularly useful for this.
774 \item
775 Where decked (subdivided) headings are used, there should be a border beneath the upper-level heading (column spanner) indicating to which of the lower-level headings it applies.
776 \item
777 Empty cells can either be left blank or represented by an em dash. A blank cell indicates non-applicability, while an em dash signifies that the data was not collected or has been omitted.
778 \item
779 Captions should end in a full stop\slash period and appear above the table.
780 \end{itemize}
781
782 Table~\ref{tab:issues} on the following page demonstrates these features. The code used to produce the table is shown in Figure~\ref{fig:table} (the \pkg{dcolumn} package was loaded in the preamble). Note the different relative positions of the table and figure captions.
783
784 \begin{table}[p!]
785 \caption{Papers and articles published in the IJDC in 2008 and 2009.}
786 \label{tab:issues}
787 \centering\small
788 \begin{tabular}{lD..{2.0}D..{2.0}D..{2.1}D..{2.1}}
789 \toprule
790 & \multicolumn{2}{c}{Frequency} & \multicolumn{2}{c}{Percentage} \\
791 \cmidrule(lr){2-3}\cmidrule(l){4-5}
792 Issue
793 & \multicolumn{1}{c}{Peer-reviewed} & \multicolumn{1}{c}{General}
794 & \multicolumn{1}{c}{Peer-reviewed} & \multicolumn{1}{c}{General} \\
795 \midrule
796 3(1) & 9 & 7 & 56.3 & 43.8 \\
797 3(2) & 5 & 7 & 41.7 & 58.3 \\
798 4(1) & 10 & 4 & 71.4 & 28.6 \\
799 4(2) & 8 & 6 & 57.1 & 42.9 \\
800 4(3) & 3 & 15 & 16.7 & 83.3 \\
801 \bottomrule
802 \end{tabular}
803 \end{table}
804
805 \begin{figure}[p!]
806 \begin{lstlisting}[frame=single]
807 \begin{table}
808 \caption{Papers and articles published in the IJDC in 2008 and 2009.}
809 \label{tab:issues}
810 \centering\small
811 \begin{tabular}{lD..{2.0}D..{2.0}D..{2.1}D..{2.1}}
812 \toprule
813 & \multicolumn{2}{c}{Frequency} & \multicolumn{2}{c}{Percentage} \\
814 \cmidrule(lr){2-3}\cmidrule(l){4-5}
815 Issue
816 & \multicolumn{1}{c}{Peer-reviewed} & \multicolumn{1}{c}{General}
817 & \multicolumn{1}{c}{Peer-reviewed} & \multicolumn{1}{c}{General} \\
818 \midrule
819 3(1) & 9 & 7 & 56.3 & 43.8 \\
820 3(2) & 5 & 7 & 41.7 & 58.3 \\
821 4(1) & 10 & 4 & 71.4 & 28.6 \\
822 4(2) & 8 & 6 & 57.1 & 42.9 \\
823 4(3) & 3 & 15 & 16.7 & 83.3 \\
824 \bottomrule
825 \end{tabular}
826 \end{table}
827 \end{lstlisting}
828 \caption{Code used to typeset Table~\ref{tab:issues}.}
829 \label{fig:table}
830 \end{figure}
831
832 \subsection{Reference List and Citations}
833
834 As mentioned above, you are encouraged to use either \pkg{biblatex-apa} (with \pkg{biblatex}\slash\pkg{biber}) or \pkg{apacite} (with Bib\TeX) to generate your reference list and citations.
835
836 \begin{itemize}
837 \item
838 To use \pkg{biblatex} for your reference list, add the following to your preamble:
839 \begin{lstlisting}
840 \usepackage[style=apa]{biblatex}
841 \addbibresource{$\meta{bib file}$.bib}
842 \end{lstlisting}
843 Prior to the release of \pkg{biblatex-apa} v7.5, you also needed this line:
844 \begin{lstlisting}
845 \DeclareLanguageMapping{british}{british-apa}
846 \end{lstlisting}
847 Include \lstinline|\printbibliography| at the end of the document to print the list.
848 \item
849 To use \pkg{apacite} for your reference list, add the following to your preamble:
850 \begin{lstlisting}
851 \usepackage{apacite}
852 \bibliographystyle{apacite}
853 \end{lstlisting}
854 and include \lstinline|\bibliography{$\meta{bib file}$}| at the end of the document.
855 \end{itemize}
856
857 In-text citations are given parenthetically in author–date format. If author forms part of the narrative, as with \textcite{rinaldo.etal2011rsc}, only the date is added in parenthesis, otherwise both author and date are given \autocite{smith.etal2003das}. Where multiple citations are given at once, the order should be the same as in the reference list, i.e.\ alphabetically by author, with co-authored works coming after singly-authored works, then chronologically \autocite{borgman.etal2006bdl, dcc2005dcp, mazairac.beetzIPboq, santini2004sas, santini2004saa, smith.etal2003das, witten.frank2005dmp}. Please consult the documentation of the package you are using for how to achieve this.
858
859 Please \textbf{do not cite entire websites} through the reference list mechanism. Instead, provide the title of the website (in English) and the URL in a footnote.\footnote{Digital Curation Centre: \url{http://www.dcc.ac.uk/}} If the title of the website is not clear from the visible pages, the contents of the HTML title element may be used. Other explanatory notes, whether about the body text or cited items, should also be given as footnotes rather than as endnotes or reference list annotations.\footnote{This avoids unnecessary page turning or scrolling.}
860
861 Please \textbf{provide digital object identifiers} (DOIs) for referenced items where available.
862
863 The data underlying the results presented in the submission should be placed in an appropriate custodial environment and cited \autocite{waterton.etal2013ual}, with the reference placed in the reference list. The \pkg{biblatex-apa} package provides a \texttt{data} entry type which should be used for datasets; the \texttt{entrysubtype} value should be \enquote{\texttt{Data set}} or similar. If using \pkg{apacite}, use the \texttt{misc} entry type with a \texttt{type} value of \enquote{\texttt{Data set}} or similar.
864
865 \section{Acknowledgements}
866
867 Any acknowledgements should be placed in a section immediately before the references.\nocite{*}
868
869 \ifx\undefined\apacitefalse
870 \printbibliography
871 \else
872 \bibliography{dccpaper-apacite.bib}
873 \fi
874
875 \newpage
876 \section{Appendix A: Change History}
877
878 \begin{description}
879 \item[v2.7] 2026-05-08\\
880 Added details of IDCC 2027.
881 \item[v2.6] 2025-06-13\\
882 Added details of IDCC 2026 and \texttt{paper} option to \textsf{idcc} class. Added \texttt{brief} option to \textsf{ijdc-v14} class. Removed some unused internal settings.
883 \item[v2.5] 2024-08-23\\
884 Added details of IDCC 2025.
885 \item[v2.4] 2023-08-11\\
886 Added details of and update documentation for IDCC 2024.
887 \item[v2.3] 2022-01-27\\
888 Added details of IDCC 2022. Added \texttt{conference} option to \textsf{ijdc-v14} class.
889 \item[v2.2] 2021-09-03\\
890 Updated procedure for inserting XMP packet into PDF output.
891 \item[v2.1] 2021-01-25\\
892 Added details of IDCC 2021.
893 \item[v2.0] 2020-01-15\\
894 Added new formatting for IJDC volume 14 and IDCC 2020.
895 \item[v1.8.1] 2019-10-07\\
896 Updated to work with changed \LaTeX\ internals.
897 \item[v1.8] 2019-03-08\\
898 Added details of IDCC 2020.
899 \item[v1.7.1] 2018-05-14\\
900 Fixed loading of maths fonts. Reverted experimental formatting.
901 \item[v1.7] 2018-05-01\\
902 Added details of IDCC 2019, along with new formatting and submission types.
903 \item[v1.6] 2017-10-20\\
904 Added details of IDCC 2018. Allowed files to be unpacked by \TeX\ without compiling. Refactored some documentation commands for efficiency.
905 \item[v1.5] 2016-08-05\\
906 Added details of IDCC 2017. Slightly refactored code to convert dccpaper-base.tex into a package, dccpaper-base.sty.
907 \item[v1.4.1] 2015-06-22\\
908 Fixed bug preventing compilation in DVI mode.
909 \item[v1.4] 2015-05-22\\
910 Added details of IDCC 2016. Improved whitespace handling. Fixed bug triggered by \texttt{demo} option. Fixed missing use of \lstinline|\Authfont|. Added missing DOI tweak for \pkg{biblatex-apa}.
911 \item[v1.3.2] 2015-01-21\\
912 Removed dependence on user supplying a title. Fixed bug triggered by numbered sections.
913 \item[v1.3.1] 2014-10-14\\
914 Fixed typographical error relating to details of IDCC 2015.
915 \item[v1.3] 2014-08-07\\
916 Added documentation of \lstinline|\conference| command. Improved display of footnotes, footnote markers and \texttt{itemize}\slash \texttt{enumerate} lists. Fixed a bug in the handling of author information. Fixed and improved how the transition from first to subsequent page geometry is achieved. Updated the details of IDCC 2015.
917 \item[v1.2] 2014-04-11\\
918 Added implementation, installation and licence sections to the Appendix of the documentation. Moved the majority of the file postamble information to the README, and synchronized the latter with the GitHub version. Improved the adaptation of \pkg{apacite} referencing to the house style.
919 \item[v1.1] 2014-03-06\\
920 Refactored the source for distribution through CTAN, and to allow the addition of the \textsf{idcc} class.
921 \item[v1.0] 2013-12-18\\
922 First public release of \textsf{ijdc-v9} class.
923 \end{description}
924
925 \newpage
926 \section{Appendix B: Implementation}
927
928 \lstset
929 { aboveskip=1em plus 0.5em minus 0.2em
930 , belowskip=1em plus 0.5em minus 0.2em
931 , frame=single
932 , numbers=left
933 , numberstyle=\color{gray}\footnotesize\itshape
934 , basicstyle=\footnotesize\ttfamily
935 , breaklines=true
936 , escapechar=
937 }%
938 \MakeShortVerb{\|}%
939 \DocInput{\jobname.dtx}
940
941 \newpage
942 \section{Appendix C: Installation}
943
944 \begin{markdown*}{hybrid=true}
945 %</driver>
946 %<readme>## Installation
947 %<readme>
948 %<*driver|readme>
949 ### Managed way
950
951 The latest stable release of the dccpaper bundle has been packaged for
952 TeX Live and MiKTeX. If you are running TeX Live and have `tlmgr`
953 installed, you can install the bundle simply by running
954 `tlmgr install dccpaper`. If you are running MiKTeX, you can install the
955 bundle by running `mpm --install=dccpaper`. Both `tlmgr` and `mpm` have
956 GUI versions that you might find friendlier.
957
958 ### Automated way
959
960 A makefile is provided which you can use with the Make utility:
961
962 * Running `make source` generates the derived files
963 - README.md
964 - ijdc-v9.cls
965 - idcc.cls
966 - dccpaper-base.sty
967 - dccpaper-apacite.bib
968 - dccpaper-biblatex.bib
969 * Running `make` generates the above files and also dccpaper.pdf.
970 * Running `make inst` installs the files in the user's TeX tree.
971 * Running `make install` installs the files in the local TeX tree.
972
973 ### Manual way
974
975 1. Run `tex dccpaper.dtx` to generate the source files.
976 2. Compile dccpaper.dtx with (any version of) LaTeX and Biber to generate the
977 documentation. Due to a dependency on the markdown package, you will need
978 either to use LuaLaTeX or to enable shell escape.
979 3. Move the files to your TeX tree as follows:
980 - `source/latex/dccpaper`:
981 dccpaper.dtx,
982 dccpaper.ins
983 - `tex/latex/dccpaper`:
984 ijdc-v9.cls,
985 idcc.cls,
986 dccpaper-base.sty,
987 dccpaper-by.eps,
988 dccpaper-by.pdf
989 - `doc/latex/dccpaper`:
990 dccpaper.pdf,
991 dccpaper-apacite.bib,
992 dccpaper-biblatex.bib,
993 README.md
994
995 4. You may then have to update your installation's file name database
996 before TeX and friends can see the files.
997
998 %</driver|readme>
999 %<*driver>
1000 \end{markdown*}
1001
1002 \newpage
1003 \section{Appendix D: Sample Documents}
1004 \label{sec:samples}
1005
1006 The following code demonstrates one way to write an IDCC conference paper.
1007
1008 \begin{lstlisting}[frame=single]
1009 \documentclass[25,paper]{idcc}
1010
1011 \title{How to write a conference paper}
1012 \author{First Author}
1013 \affil{First Author's Affiliation}
1014 \author{Second Author}
1015 \affil{Second Author's Affiliation}
1016 \correspondence{Your Name, Institution, Postal address. Email:
1017 \email{[email protected]}}
1018
1019 \submitted{1 September 2023}
1020
1021 \usepackage[style=apa]{biblatex}
1022 \addbibresource{references.bib}
1023
1024 \begin{document}
1025 \maketitle
1026
1027 \begin{abstract}
1028 Text of the abstract\dots
1029 \end{abstract}
1030
1031 \section{Introduction}
1032
1033 The text of the introduction starts here\dots
1034
1035 \section{Conclusions}
1036
1037 The text of the conclusions starts here\dots
1038
1039 \section{Acknowledgements}
1040
1041 Any acknowledgements should be placed here\dots
1042
1043 \printbibliography
1044 \end{document}
1045 \end{lstlisting}
1046
1047 This can be converted to an IJDC paper by making the following changes.
1048 (This was the submission format for IDCC24.)
1049
1050 \begin{lstlisting}[frame=single]
1051 \documentclass[conference]{ijdc-v14}
1052 \end{lstlisting}
1053
1054 \begin{lstlisting}[frame=single,firstnumber=11]
1055 \conference*{the International Digital Curation Conference IDCC24,
1056 19-21 February 2024}
1057 \submitted{1 September 2023}
1058 \end{lstlisting}
1059
1060 \newpage
1061 If submitting a workshop proposal to the IDCC, there is a specific set of information you need to include. The following code provides the bare bones of the 2024 template; please refer to the latest corresponding Word template for the information you need to provide and the headings to use.
1062
1063 \begin{lstlisting}[frame=single]
1064 \documentclass[workshop,24]{idcc}
1065
1066 \title{Getting your workshop accepted}
1067 \author{First Author}
1068 \affil{First Author's Affiliation}
1069 \author{Second Author}
1070 \affil{Second Author's Affiliation}
1071 \correspondence{Your Name, Institution, Postal address. Email: \email{[email protected]}}
1072
1073 \submitted{1 September 2023}
1074
1075 \usepackage[style=apa]{biblatex}
1076 \addbibresource{references.bib}
1077
1078 \begin{document}
1079 \begin{description}
1080 \item[Workshop Organiser(s):]~\\
1081 Name, position, organization.
1082
1083 \item[Workshop title:]~\\
1084 Title.
1085
1086 \item[Brief description:]~\\
1087 60 words or fewer.
1088
1089 \item[Long description:]~\\
1090 About 500 words.
1091
1092 \item[Room layout/workshop style:]~\\
1093 Cabaret, classroom, boardroom, other.
1094
1095 \item[Minimum/maximum number of delegates:]~\\
1096 Minimum for viability, maximum for workability.
1097
1098 \item[Number of speakers:]~\\
1099 Number.
1100
1101 \item[Equipment requirements:]~\\
1102 Anything beyond projector/screen, mic/PA system, lectern, e.g. flipcharts,
1103 whiteboards.
1104
1105 \item[Workshop length:]~\\
1106 Half day or full day.
1107
1108 \item[Funding model:]~\\
1109 Fully funded, part funded (subsidised) or delegate fee.
1110 \end{description}
1111 \end{document}
1112 \end{lstlisting}
1113
1114 \newpage
1115 \section{Appendix E: Licence}
1116
1117 \begin{markdown*}{hybrid=true}
1118 %</driver>
1119 %<readme>## Licence
1120 %<readme>
1121 %<*driver|readme>
1122 Copyright 2026 Digital Curation Centre, University of Edinburgh.
1123
1124 This work consists of the image files dccpaper-by.eps and
1125 dccpaper-by.pdf, the documented LaTeX file dccpaper.dtx and a Makefile.
1126
1127 The text files contained in this work may be distributed and/or modified
1128 under the conditions of the [LaTeX Project Public License (LPPL)][lppl],
1129 either version 1.3c of this license or (at your option) any later
1130 version.
1131
1132 The image files distributed with this bundle derive from the file
1133 [by.eps] distributed by Creative Commons. The image is a trademark of
1134 Creative Commons and is subject to the [Creative Commons trademark policy][cctp].
1135
1136 This work is “maintained” (as per LPPL maintenance status) by [Alex Ball][me].
1137
1138 [lppl]: http://www.latex-project.org/lppl.txt "LaTeX Project Public License (LPPL)"
1139 [by.eps]: http://mirrors.creativecommons.org/presskit/buttons/88x31/eps/by.eps "CC BY licence badge"
1140 [cctp]: http://creativecommons.org/policies "Creative Commons trademark policy"
1141 [me]: http://alexball.me.uk/ "Alex Ball"
1142 %</driver|readme>
1143 %<*driver>
1144 \end{markdown*}
1145
1146 The file dccpaper.pdf, generated by this work, is licensed as shown on page 1.
1147 \end{document}
1148 %</driver>
1149 % \fi
1150 % \iffalse
1151 %<*ijdc9|ijdc14>
1152 % \fi
1153 %
1154 % \subsection{ijdc-v14.cls and ijdc-v9.cls}
1155 % \setcounter{lstnumber}{21}
1156 %
1157 % \begin{macro}{dccp@type}
1158 % \begin{macro}{dccp@editorial}
1159 % The type of paper is recorded in \cs{dccp@type}. The possible values are
1160 % `General Article', `Research Paper' (was `Peer-Reviewed Paper'), or `Editorial'.
1161 % The latter is provided through the constant \cs{dccp@editorial} so we can
1162 % test for it later with ease.
1163 %
1164 % \begin{macrocode}
1165 \def\dccp@type{General Article}
1166 \def\dccp@editorial{Editorial}
1167 % \end{macrocode}
1168 % \end{macro}
1169 % \end{macro}
1170 %
1171 % \begin{macro}{ifdcp@mast@ul}
1172 % \begin{macro}{dcp@mast@ultrue}
1173 % \begin{macro}{dcp@mast@ulfalse}
1174 % We provide a boolean for whether to underline the masthead.
1175 %
1176 % \begin{macrocode}
1177 \newif\ifdcp@mast@ul
1178 % \end{macrocode}
1179 % \end{macro}
1180 % \end{macro}
1181 % \end{macro}
1182 %
1183 % \begin{optionkey}{editorial}
1184 % \begin{optionkey}{paper}
1185 % \begin{optionkey}{article}
1186 % \begin{optionkey}{conference}
1187 % \begin{optionkey}{brief}
1188 % \begin{optionkey}{preprint}
1189 % These five options set \cs{dccp@type} appropriately. The \key{editorial}
1190 % option additionally switches page numbers to roman numerals.
1191 %
1192 % \begin{macrocode}
1193 \DeclareOption{editorial}{\let\dccp@type=\dccp@editorial%
1194 \AtBeginDocument{% Editorials use Roman numerals for page numbers
1195 \pagenumbering{roman}%
1196 \renewcommand{\thelastpage}{\@roman\c@lastpage}%
1197 }%
1198 }
1199 % \end{macrocode}
1200 % \iffalse
1201 %<*ijdc14>
1202 % \fi
1203 %
1204 % The |ijdc-v14| template uses the term `Research Paper'.
1205 %
1206 % \begin{macrocode}
1207 \DeclareOption{paper}{\def\dccp@type{Research Paper}}
1208 % \end{macrocode}
1209 % \iffalse
1210 %</ijdc14>
1211 %<*ijdc9>
1212 % \fi
1213 %
1214 % \addtocounter{lstnumber}{-1}
1215 % The |ijdc-v9| template uses the term `Peer-Reviewed Paper'.
1216 % \begin{macrocode}
1217 \DeclareOption{paper}{\def\dccp@type{Peer-Reviewed Paper}}
1218 % \end{macrocode}
1219 % \iffalse
1220 %</ijdc9>
1221 % \fi
1222 %
1223 % The \key{article} option is redundant, but included for symmetry with
1224 % \key{paper}.
1225 %
1226 % \begin{macrocode}
1227 \DeclareOption{article}{\def\dccp@type{General Article}}
1228 \DeclareOption{conference}{\def\dccp@type{Conference Paper}}
1229 \DeclareOption{brief}{\def\dccp@type{Brief Report}}
1230 \DeclareOption{preprint}{\def\dccp@type{Conference Preprint}}
1231 \ProcessOptions\relax
1232
1233 % \end{macrocode}
1234 % \end{optionkey}
1235 % \end{optionkey}
1236 % \end{optionkey}
1237 % \end{optionkey}
1238 % \end{optionkey}
1239 % \end{optionkey}
1240 %
1241 % \begin{macro}{dccp@publ@long}
1242 % \begin{macro}{dccp@publ@short}
1243 % \begin{macro}{dccp@publ@msg}
1244 % \begin{macro}{dccp@titlefoot@bib}
1245 % \begin{macro}{dccp@titlefoot@doi}
1246 % \begin{macro}{dccp@normhead@doi}
1247 % These definitions are used to fill out the headers and footers. They include
1248 % some details that are defined in \textsf{dccpaper-base} and provided by
1249 % the user: \cs{thedate}, \cs{thevolume}, \cs{theissue}, \cs{thelastpage}, \cs{thedoi}.
1250 %
1251 % \begin{macrocode}
1252 \def\dccp@publ@long{International Journal of Digital Curation}
1253 \def\dccp@publ@short{IJDC}
1254 \def\dccp@publ@msg{The \emph{\dccp@publ@long} is an international journal
1255 committed to scholarly excellence and dedicated to the advancement of digital
1256 curation across a wide range of sectors. The \dccp@publ@short\ is published by
1257 the University of Edinburgh on behalf of the Digital Curation Centre. ISSN:
1258 1746-8256. URL: \url{http://www.ijdc.net/}}
1259 \def\dccp@titlefoot@bib{%
1260 \dccp@publ@long\\
1261 \thedate, Vol.\ \thevolume, Iss.\ \theissue, \thepage--\thelastpage.%
1262 }
1263 \def\dccp@titlefoot@doi{%
1264 \url{https://doi.org/\thedoi}\\
1265 DOI: \thedoi
1266 }
1267 \def\dccp@normhead@doi{doi:\thedoi}
1268 % \end{macrocode}
1269 % \end{macro}
1270 % \end{macro}
1271 % \end{macro}
1272 % \end{macro}
1273 % \end{macro}
1274 % \end{macro}
1275 %
1276 % \cs{dccp@subject} will be used for the PDF subject, and will specify the journal
1277 % and the issue.
1278 %
1279 % \begin{macro}{dccp@subject}
1280 % \begin{macrocode}
1281 \def\dccp@subject{\dccp@publ@long, \thedate, Vol.\ \thevolume, Iss.\ \theissue}
1282
1283 % \end{macrocode}
1284 % \end{macro}
1285 % \iffalse
1286 %<*ijdc14>
1287 % \fi
1288 %
1289 % \begin{macro}{dccp@variant}
1290 % Different fonts are used depending on the volume. The |ijdc-v14| template
1291 % uses Baskerville as the main text font.
1292 %
1293 % \begin{macrocode}
1294 \def\dccp@variant{baskerville}
1295
1296 % \end{macrocode}
1297 %
1298 % \iffalse
1299 %</ijdc14>
1300 %<*ijdc9>
1301 % \fi
1302 %
1303 % \addtocounter{lstnumber}{-2}
1304 % The |ijdc-v9| template uses Times.
1305 %
1306 % \begin{macrocode}
1307 \def\dccp@variant{times}
1308
1309 % \end{macrocode}
1310 % \end{macro}
1311 %
1312 % \iffalse
1313 %</ijdc9>
1314 % \fi
1315 %
1316 % The class is based on the \pkg{article} class, and uses A4 paper.
1317 %
1318 % \begin{macrocode}
1319 \LoadClass[a4paper,12pt,twoside]{article}
1320
1321 % \end{macrocode}
1322 %
1323 % The rest of the formatting happens in the following file.
1324 %
1325 % \begin{macrocode}
1326 \RequirePackage{dccpaper-base}
1327 % \end{macrocode}
1328 % \iffalse
1329 %</ijdc9|ijdc14>
1330 %<*idcc>
1331 % \fi
1332 %
1333 % \subsection{idcc.cls}
1334 % \setcounter{lstnumber}{21}
1335 %
1336 % \begin{macro}{dccp@publ@long}
1337 % \begin{macro}{dccp@publ@short}
1338 % \begin{macro}{dccp@publ@msg}
1339 % These definitions are used to fill out the headers and footers.
1340 % The ones for \cs{dccp@publ@short} and \cs{dccp@publ@msg} are a fallback,
1341 % defined here but ordinarily overridden using a package option.
1342 %
1343 % \begin{macrocode}
1344 \def\dccp@publ@long{International Digital Curation Conference}
1345 \def\dccp@publ@short{IDCC}
1346 \def\dccp@publ@msg{The \dccp@publ@long\ takes place on [TBC] in [TBC]. URL:
1347 \url{https://www.dcc.ac.uk/events/idcc}}
1348 % \end{macrocode}
1349 % \end{macro}
1350 % \end{macro}
1351 % \end{macro}
1352 %
1353 % \begin{macro}{dccp@subject}
1354 % \cs{dccp@subject} will be used for the PDF subject. The value here is again a
1355 % fallback, ordinarily overridden using a package option.
1356 %
1357 % \begin{macrocode}
1358 \def\dccp@subject{\dccp@publ@long}
1359
1360 % \end{macrocode}
1361 % \end{macro}
1362 %
1363 % \begin{macro}{ifdcp@mast@ul}
1364 % \begin{macro}{dcp@mast@ultrue}
1365 % \begin{macro}{dcp@mast@ulfalse}
1366 % We provide a boolean for whether to underline the masthead.
1367 %
1368 % \begin{macrocode}
1369 \newif\ifdcp@mast@ul
1370 \dcp@mast@ultrue
1371 % \end{macrocode}
1372 % \end{macro}
1373 % \end{macro}
1374 % \end{macro}
1375 %
1376 % \begin{macro}{ifdcp@wplong}
1377 % \begin{macro}{dcp@wplongtrue}
1378 % \begin{macro}{dcp@wplongfalse}
1379 % We provide a boolean for deciding whether to print `Workshop` or `Workshop
1380 % Proposal`.
1381 %
1382 % \begin{macrocode}
1383 \newif\ifdcp@wplong
1384 \dcp@wplongtrue
1385 % \end{macrocode}
1386 % \end{macro}
1387 % \end{macro}
1388 % \end{macro}
1389 %
1390 % \begin{macro}{dccp@type@fallback}
1391 % \begin{macro}{dccp@type}
1392 % Paper type is recorded in \cs{dccp@type}. The values are normally set by
1393 % an option key. Over the years there are have been several different
1394 % default values (representing the most popular submission type).
1395 %
1396 % \begin{macrocode}
1397 \def\dccp@type@practice{Practice Paper}
1398 \def\dccp@type@abstract{Extended Abstract}
1399 \def\dccp@type@paper{Conference Paper}
1400 \def\dccp@type@fallback{\dccp@type@paper}
1401 \def\dccp@type{\dccp@type@fallback}
1402 % \end{macrocode}
1403 % \end{macro}
1404 % \end{macro}
1405 %
1406 % \begin{optionkey}{abstract}
1407 % \begin{optionkey}{abstract}
1408 % \begin{optionkey}{research}
1409 % \begin{optionkey}{lightning}
1410 % \begin{optionkey}{data}
1411 % \begin{optionkey}{poster}
1412 % \begin{optionkey}{demo}
1413 % \begin{optionkey}{bof}
1414 % \begin{optionkey}{workshop}
1415 % \begin{optionkey}{practice}
1416 % These options set the value of \cs{dccp@type} appropriately.
1417 %
1418 % \begin{macrocode}
1419 \DeclareOption{abstract}{\def\dccp@type{\dccp@type@abstract}}
1420 \DeclareOption{paper}{\def\dccp@type{\dccp@type@paper}}
1421 \DeclareOption{research}{\def\dccp@type{Research Paper}}
1422 \DeclareOption{lightning}{\def\dccp@type{Lightning Talk}}
1423 \DeclareOption{data}{\def\dccp@type{Data Paper}}
1424 \DeclareOption{poster}{\def\dccp@type{Poster}}
1425 \DeclareOption{demo}{\def\dccp@type{Demonstration}}
1426 \DeclareOption{bof}{\def\dccp@type{Birds of a Feather}}
1427 \DeclareOption{workshop}{\def\dccp@type{Workshop\ifdcp@wplong\space Proposal\fi}}
1428 \DeclareOption{practice}{\def\dccp@type{\dccp@type@practice}}
1429 % \end{macrocode}
1430 % \end{optionkey}
1431 % \end{optionkey}
1432 % \end{optionkey}
1433 % \end{optionkey}
1434 % \end{optionkey}
1435 % \end{optionkey}
1436 % \end{optionkey}
1437 % \end{optionkey}
1438 % \end{optionkey}
1439 % \end{optionkey}
1440 %
1441 % \begin{macro}{dccp@variant}
1442 % Different fonts are used depending on the year of the conference. Since 2020,
1443 % Baskerville is used as the main text font. Previously, Times was used.
1444 %
1445 % \begin{macrocode}
1446 \def\dccp@variant{baskerville}
1447 % \end{macrocode}
1448 % \end{macro}
1449 %
1450 % \begin{optionkey}{15}
1451 % \begin{optionkey}{16}
1452 % \begin{optionkey}{17}
1453 % \begin{optionkey}{18}
1454 % \begin{optionkey}{19}
1455 % \begin{optionkey}{20}
1456 % \begin{optionkey}{21}
1457 % \begin{optionkey}{22}
1458 % \begin{optionkey}{24}
1459 % \begin{optionkey}{25}
1460 % \begin{optionkey}{26}
1461 % The details for each conference are slightly different, so they each have an
1462 % associated option for overriding the fallback definitions for
1463 % \cs{dccp@publ@short}, \cs{dccp@publ@msg} and \cs{dccp@subject}.
1464 %
1465 % \begin{macrocode}
1466 \DeclareOption{15}{%
1467 \def\dccp@publ@short{IDCC15}
1468 \def\dccp@publ@msg{The 10th \dccp@publ@long\ takes place on 9--12 February
1469 2015 in London. URL: \url{http://www.dcc.ac.uk/events/idcc15/}}
1470 \def\dccp@subject{10th \dccp@publ@long, 2015}
1471 \def\dccp@type@fallback{\dccp@type@practice}
1472 \def\dccp@variant{times}
1473 \dcp@mast@ulfalse
1474 \dcp@wplongfalse
1475 }
1476 \DeclareOption{16}{%
1477 \def\dccp@publ@short{IDCC16}
1478 \def\dccp@publ@msg{The 11th \dccp@publ@long\ takes place on 22--25 February
1479 2016 in Amsterdam. URL: \url{http://www.dcc.ac.uk/events/idcc16/}}
1480 \def\dccp@subject{11th \dccp@publ@long, 2016}
1481 \def\dccp@type@fallback{\dccp@type@practice}
1482 \def\dccp@variant{times}
1483 \dcp@mast@ulfalse
1484 \dcp@wplongfalse
1485 }
1486 \DeclareOption{17}{%
1487 \def\dccp@publ@short{IDCC17}
1488 \def\dccp@publ@msg{The 12th \dccp@publ@long\ takes place on 20--23 February
1489 2017 in Edinburgh. URL: \url{http://www.dcc.ac.uk/events/idcc17/}}
1490 \def\dccp@subject{12th \dccp@publ@long, 2017}
1491 \def\dccp@type@fallback{\dccp@type@practice}
1492 \def\dccp@variant{times}
1493 \dcp@mast@ulfalse
1494 \dcp@wplongfalse
1495 }
1496 \DeclareOption{18}{%
1497 \def\dccp@publ@short{IDCC18}
1498 \def\dccp@publ@msg{The 13th \dccp@publ@long\ takes place on 19--22 February
1499 2018 in Barcelona. URL: \url{http://www.dcc.ac.uk/events/idcc18/}}
1500 \def\dccp@subject{13th \dccp@publ@long, 2018}
1501 \def\dccp@type@fallback{\dccp@type@practice}
1502 \def\dccp@variant{times}
1503 \dcp@mast@ulfalse
1504 }
1505 \DeclareOption{19}{%
1506 \def\dccp@publ@short{IDCC19}
1507 \def\dccp@publ@msg{The 14th \dccp@publ@long\ takes place on 4--7 February
1508 2019 in Melbourne. URL: \url{http://www.dcc.ac.uk/events/idcc19/}}
1509 \def\dccp@subject{14th \dccp@publ@long, 2019}
1510 \def\dccp@type@fallback{\dccp@type@abstract}
1511 \def\dccp@variant{times}
1512 \dcp@mast@ulfalse
1513 }
1514 \DeclareOption{20}{%
1515 \def\dccp@publ@short{IDCC20}
1516 \def\dccp@publ@msg{The 15th \dccp@publ@long\ takes place on 17--20 February
1517 2020 in Dublin. URL: \url{http://www.dcc.ac.uk/events/idcc20/}}
1518 \def\dccp@subject{15th \dccp@publ@long, 2020}
1519 \def\dccp@type@fallback{\dccp@type@abstract}
1520 }
1521 \DeclareOption{21}{%
1522 \def\dccp@publ@short{IDCC}
1523 \def\dccp@publ@msg{The 16th \dccp@publ@long\ takes place on 19 April
1524 2021, Edinburgh, Scotland.\par\bigskip URL: \url{https://dcc.ac.uk/events/idcc2021}}
1525 \def\dccp@subject{16th \dccp@publ@long, 2021}
1526 \def\dccp@type@fallback{\dccp@type@abstract}
1527 }
1528 \DeclareOption{22}{%
1529 \def\dccp@publ@short{IDCC}
1530 \def\dccp@publ@msg{The 17th \dccp@publ@long\ takes place on 13--16 June
1531 2022, Edinburgh, Scotland.\par\bigskip URL: \url{https://www.dcc.ac.uk/events/idcc22}}
1532 \def\dccp@subject{17th \dccp@publ@long, 2022}
1533 \def\dccp@type@fallback{\dccp@type@abstract}
1534 }
1535 \DeclareOption{24}{%
1536 \def\dccp@publ@short{IDCC}
1537 \def\dccp@publ@msg{The 18th \dccp@publ@long\ takes place on 19--21 February
1538 2024 in Edinburgh, Scotland.\par\bigskip URL: \url{https://www.dcc.ac.uk/events/idcc24}}
1539 \def\dccp@subject{18th \dccp@publ@long, 2024}
1540 }
1541 \DeclareOption{25}{%
1542 \def\dccp@publ@short{IDCC25}
1543 \def\dccp@publ@msg{The 19th \dccp@publ@long\ takes place on 17--19 February
1544 2025 in The Hague, Netherlands.\par\bigskip URL: \url{https://www.dcc.ac.uk/events/idcc25}}
1545 \def\dccp@subject{19th \dccp@publ@long, 2025}
1546 }
1547 \DeclareOption{26}{%
1548 \def\dccp@publ@short{IDCC26}
1549 \def\dccp@publ@msg{The 20th \dccp@publ@long\ takes place on 16--18 February
1550 2026 in Zagreb, Croatia.\par\bigskip URL: \url{https://www.dcc.ac.uk/events/idcc26}}
1551 \def\dccp@subject{20th \dccp@publ@long, 2026}
1552 }
1553 \DeclareOption{27}{%
1554 \def\dccp@publ@short{IDCC27}
1555 \def\dccp@publ@msg{The 21st \dccp@publ@long\ takes place on 9--12 February
1556 2027 in Lisbon, Portugal.\par\bigskip URL: \url{https://www.dcc.ac.uk/events/idcc27}}
1557 \def\dccp@subject{21st \dccp@publ@long, 2027}
1558 }
1559 \ProcessOptions\relax
1560
1561 % \end{macrocode}
1562 % \end{optionkey}
1563 % \end{optionkey}
1564 % \end{optionkey}
1565 % \end{optionkey}
1566 % \end{optionkey}
1567 % \end{optionkey}
1568 % \end{optionkey}
1569 % \end{optionkey}
1570 % \end{optionkey}
1571 % \end{optionkey}
1572 % \end{optionkey}
1573 %
1574 % \begin{macro}{@clearglobaloption}
1575 % The \key{demo} option, if passed, would be passed on to the \pkg{graphics}
1576 % package wreaking havoc with each and every included image. To avoid this,
1577 % we clear it from the list of class options using
1578 % \href{http://tex.stackexchange.com/q/33245}{code from Enrico Gregorio}.
1579 %
1580 % \begin{macrocode}
1581 \def\@clearglobaloption#1{%
1582 \def\@tempa{#1}%
1583 \def\@tempb{\@gobble}%
1584 \@for\next:=\@classoptionslist\do{%
1585 \ifx\next\@tempa
1586 \message{Option \next\space has been hidden from subsequent packages}%
1587 \else
1588 \edef\@tempb{\@tempb,\next}%
1589 \fi
1590 }%
1591 \let\@classoptionslist\@tempb
1592 \expandafter\ifx\@tempb\@gobble
1593 \let\@classoptionslist\@empty
1594 \fi
1595 }
1596 \@clearglobaloption{demo}
1597
1598 % \end{macrocode}
1599 % \end{macro}
1600 %
1601 % The class is based on the \pkg{article} class, and uses A4 paper.
1602 %
1603 % \begin{macrocode}
1604 \LoadClass[a4paper,12pt,twoside]{article}
1605
1606 % \end{macrocode}
1607 %
1608 % The rest of the formatting happens in the following file.
1609 %
1610 % \begin{macrocode}
1611 \RequirePackage{dccpaper-base}
1612 % \end{macrocode}
1613 % \iffalse
1614 %</idcc>
1615 %<*base>
1616 % \fi
1617 %
1618 % \subsection{dccpaper-base.sty}
1619 % \setcounter{lstnumber}{21}
1620 %
1621 % The \pkg{dccpaper} classes are deliberately very similar. This package
1622 % contains the common code.
1623 %
1624 % We use British English orthography.
1625 %
1626 % \begin{macrocode}
1627 \RequirePackage[british]{babel}
1628 % \end{macrocode}
1629 %
1630 % The macro patching commands from \pkg{etoolbox} and \pkg{xpatch} come in
1631 % useful for handling author and date information, and also for
1632 % compatibility with \pkg{apacite}.
1633 %
1634 % \begin{macrocode}
1635 \RequirePackage{etoolbox,xpatch}
1636 % \end{macrocode}
1637 %
1638 % The code for setting fonts is a little complicated to cope with several
1639 % variations of what people might have installed, plus the two typographical
1640 % variants of the IJDC and IDCC templates. Generally speaking, we use OTF fonts
1641 % with Lua\LaTeX\ and \XeLaTeX, Type 1 fonts with PDF\LaTeX, and
1642 % \textsf{newtxmath} for mathematics.
1643 %
1644 % Please note that \textsf{newtxmath} v1.55 is incompatible with \pkg{biblatex},
1645 % but earlier and later versions (starting v1.551) are compatible.
1646 %
1647 % Here is the font selection cascade when PDF\LaTeX\ is used. Our options are
1648 % limited by the support files available through CTAN. Users of the
1649 % Lucida fonts from TUG are invited to feed back on whether this works
1650 % successfully or not.
1651 %
1652 % \begin{macrocode}
1653 \RequirePackage{iftex}
1654 \ifPDFTeX
1655 \RequirePackage[T1]{fontenc}
1656 \ifdefstring{\dccp@variant}{baskerville}{%
1657 \IfFileExists{baskervillef.sty}{
1658 \RequirePackage[scaled=.95]{baskervillef}
1659 \RequirePackage[baskerville,vvarbb]{newtxmath}
1660 }{
1661 \IfFileExists{Baskervaldx.sty}{
1662 \RequirePackage[scaled=.95]{baskervaldx}
1663 \RequirePackage[baskervaldx,vvarbb]{newtxmath}
1664 }{
1665 \IfFileExists{baskervald.sty}{
1666 \RequirePackage{baskervald}
1667 \RequirePackage[baskervaldx,vvarbb]{newtxmath}
1668 }{}
1669 }
1670 }
1671 \IfFileExists{lsr.pfb}{%
1672 \renewcommand{\sfdefault}{hls}
1673 \def\hls@scale{0.805}
1674 }{%
1675 \IfFileExists{GoSans.sty}{%
1676 \RequirePackage[scale=.8]{GoSans}
1677 }{%
1678 \RequirePackage[scaled=0.82]{helvet}}}
1679 }{%
1680 % \end{macrocode}
1681 %
1682 % When \textsf{newtxtext} is use, it emulates \pkg{tgheros} so all we have to do
1683 % is set the scaling factor; but it also switches the monospaced font, so we
1684 % have to switch it back.
1685 %
1686 % \begin{macrocode}
1687 \IfFileExists{newtxtext.sty}{%
1688 \RequirePackage{newtxtext,newtxmath}
1689 }{%
1690 \RequirePackage{mathptmx}}
1691 \IfFileExists{tgheros.sty}{%
1692 \ifx\undefined\qhv@scale
1693 \RequirePackage[scale=0.92]{tgheros}\else
1694 \def\qhv@scale{0.92}\fi
1695 }{%
1696 \RequirePackage[scaled=0.92]{helvet}}
1697 \renewcommand{\ttdefault}{cmtt}
1698 }
1699 % \end{macrocode}
1700 %
1701 % Here is the font selection cascade used for Lua\LaTeX\ and \XeLaTeX. There
1702 % are a few more options that come from system fonts people may have installed.
1703 % We have to be a little careful when mixing OTF and Type 1 fonts.
1704 %
1705 % Here is the Baskerville/Lucida selection:
1706 %
1707 % \begin{macrocode}
1708 \else
1709 \RequirePackage{fontspec}
1710 \ifdefstring{\dccp@variant}{baskerville}{%
1711 \IfFontExistsTF{Baskerville}{%
1712 \setmainfont{Baskerville}
1713 \RequirePackage[baskerville,vvarbb]{newtxmath}
1714 }{%
1715 \IfFileExists{baskervillef.sty}{%
1716 \setmainfont[Scale=.95]{BaskervilleF}
1717 \RequirePackage[baskerville,vvarbb]{newtxmath}
1718 }{%
1719 \IfFileExists{Baskervaldx.sty}{%
1720 \setmainfont[Scale=.95]{baskervaldx}
1721 \RequirePackage[baskervaldx,vvarbb]{newtxmath}
1722 }{%
1723 \IfFileExists{baskervald.sty}{%
1724 \RequirePackage[T1]{fontenc}
1725 \RequirePackage{baskervald}
1726 \RequirePackage[baskervaldx,vvarbb]{newtxmath}
1727 }{}
1728 }
1729 }
1730 }
1731 \IfFontExistsTF{Lucida Sans}{%
1732 \setsansfont[Scale=.805]{Lucida Sans}
1733 }{
1734 \IfFontExistsTF{LucidaSansOT}{%
1735 \setsansfont[Scale=.805]{LucidaSansOT}
1736 }{%
1737 \IfFileExists{GoSans.sty}{%
1738 \RequirePackage[scale=.8]{GoSans}
1739 }{%
1740 \@ifpackageloaded{fontenc}{}{%
1741 \appto\sffamily{\fontencoding{T1}\selectfont}
1742 }
1743 \RequirePackage[scaled=0.82]{helvet}
1744 }
1745 }
1746 }
1747 }{%
1748 % \end{macrocode}
1749 %
1750 % Here is the Times/Helvetica selection:
1751 %
1752 % \begin{macrocode}
1753 \IfFileExists{newtxtext.sty}{%
1754 \setmainfont{TeXGyreTermesX}
1755 \RequirePackage{newtxmath}
1756 }{%
1757 \RequirePackage[T1]{fontenc}
1758 \RequirePackage{mathptmx}
1759 }
1760 \IfFontExistsTF{texgyreheros-regular.otf}{%
1761 \setsansfont{texgyreheros}%
1762 [ Extension = .otf
1763 , UprightFont = *-regular
1764 , ItalicFont = *-italic
1765 , BoldFont = *-bold
1766 , BoldItalicFont = *-bolditalic
1767 , Scale = 0.92
1768 ]
1769 }{%
1770 \IfFileExists{newtxtext.sty}{%
1771 \appto\sffamily{\fontencoding{T1}\selectfont}%
1772 }{}
1773 \RequirePackage[scaled=0.92]{helvet}
1774 }
1775 }
1776 % \end{macrocode}
1777 %
1778 % In both variants, the monospaced font is left untouched as the \pkg{fontspec}
1779 % default.
1780 %
1781 % Using \textsf{newtxmath} for mathematics generally works, but the package assumes
1782 % certain characters will fall back to text equivalents, which works under T1 encoding
1783 % but not under the TU encoding used by \pkg{fontspec}. This solution is from egreg's
1784 % answer on TeX.se: \url{https://tex.stackexchange.com/a/394139}.
1785 %
1786 % \begin{macrocode}
1787 \@ifpackageloaded{newtxmath}{%
1788 \DeclareSymbolFont{oldoperators}{OT1}{ntxtlf}{m}{n}
1789 \SetSymbolFont{oldoperators}{bold}{OT1}{ntxtlf}{b}{n}
1790 \AtBeginDocument{%
1791 \DeclareMathSymbol{0}{\mathalpha}{operators}{`0}%
1792 \DeclareMathSymbol{1}{\mathalpha}{operators}{`1}%
1793 \DeclareMathSymbol{2}{\mathalpha}{operators}{`2}%
1794 \DeclareMathSymbol{3}{\mathalpha}{operators}{`3}%
1795 \DeclareMathSymbol{4}{\mathalpha}{operators}{`4}%
1796 \DeclareMathSymbol{5}{\mathalpha}{operators}{`5}%
1797 \DeclareMathSymbol{6}{\mathalpha}{operators}{`6}%
1798 \DeclareMathSymbol{7}{\mathalpha}{operators}{`7}%
1799 \DeclareMathSymbol{8}{\mathalpha}{operators}{`8}%
1800 \DeclareMathSymbol{9}{\mathalpha}{operators}{`9}%
1801 \DeclareMathSymbol{\Gamma}{\mathalpha}{oldoperators}{"00}%
1802 \DeclareMathSymbol{\Delta}{\mathalpha}{oldoperators}{"01}%
1803 \DeclareMathSymbol{\Theta}{\mathalpha}{oldoperators}{"02}%
1804 \DeclareMathSymbol{\Lambda}{\mathalpha}{oldoperators}{"03}%
1805 \DeclareMathSymbol{\Xi}{\mathalpha}{oldoperators}{"04}%
1806 \DeclareMathSymbol{\Pi}{\mathalpha}{oldoperators}{"05}%
1807 \DeclareMathSymbol{\Sigma}{\mathalpha}{oldoperators}{"06}%
1808 \DeclareMathSymbol{\Upsilon}{\mathalpha}{oldoperators}{"07}%
1809 \DeclareMathSymbol{\Phi}{\mathalpha}{oldoperators}{"08}%
1810 \DeclareMathSymbol{\Psi}{\mathalpha}{oldoperators}{"09}%
1811 \DeclareMathSymbol{\Omega}{\mathalpha}{oldoperators}{"0A}%
1812 \DeclareMathSymbol{!}{\mathclose}{operators}{"21}%
1813 \DeclareMathSymbol{+}{\mathbin}{operators}{"2B}%
1814 \DeclareMathSymbol{:}{\mathrel}{operators}{"3A}%
1815 \DeclareMathSymbol{;}{\mathpunct}{operators}{"3B}%
1816 \DeclareMathSymbol{=}{\mathrel}{operators}{"3D}%
1817 \DeclareMathSymbol{?}{\mathclose}{operators}{"3F}%
1818 \DeclareMathDelimiter{(}{\mathopen} {operators}{"28}{largesymbols}{"00}%
1819 \DeclareMathDelimiter{)}{\mathclose}{operators}{"29}{largesymbols}{"01}%
1820 \DeclareMathDelimiter{[}{\mathopen} {operators}{"5B}{largesymbols}{"02}%
1821 \DeclareMathDelimiter{]}{\mathclose}{operators}{"5D}{largesymbols}{"03}%
1822 \DeclareMathAccent{\acute}{\mathalpha}{operators}{"B4}%
1823 \ifLuaTeX\DeclareMathAccent{\grave}{\mathalpha}{operators}{"60}\fi
1824 \DeclareMathAccent{\ddot}{\mathalpha}{operators}{"A8}%
1825 \DeclareMathAccent{\tilde}{\mathalpha}{oldoperators}{"7E}%
1826 \DeclareMathAccent{\bar}{\mathalpha}{oldoperators}{"16}%
1827 \DeclareMathAccent{\breve}{\mathalpha}{oldoperators}{"15}%
1828 \DeclareMathAccent{\check}{\mathalpha}{oldoperators}{"14}%
1829 \DeclareMathAccent{\hat}{\mathalpha}{oldoperators}{"5E}%
1830 \DeclareMathAccent{\dot}{\mathalpha}{oldoperators}{"5F}%
1831 \DeclareMathAccent{\mathring}{\mathalpha}{oldoperators}{"17}%
1832 \DeclareMathSymbol{\mathdollar}{\mathord}{operators}{"24}%
1833 }%
1834 }
1835 \fi
1836 % \end{macrocode}
1837 %
1838 % We will need support for included graphics and colour. The structural elements
1839 % are a medium turquoise, while the links are slightly darker to make them
1840 % easier to read on screen.
1841 %
1842 % \begin{macrocode}
1843 \RequirePackage{graphicx}
1844 \IfFileExists{xcolor.sty}%
1845 {\RequirePackage{xcolor}}%
1846 {\RequirePackage{color}}
1847 \definecolor[named]{struct}{rgb}{0,0.5,0.5}
1848 \definecolor[named]{links}{rgb}{0,0.4,0.4}
1849 % \end{macrocode}
1850 %
1851 % We will calculate some lengths later.
1852 %
1853 % \begin{macrocode}
1854 \RequirePackage{calc}
1855
1856 % \end{macrocode}
1857 %
1858 % Ragged right text is easier to read on screen, but fully justified text looks
1859 % better. The \cs{raggedyright} layout from Peter Wilson's \pkg{memoir} class
1860 % (2005/09/25 v1.618) is an excellent compromise. The code below replicates it.
1861 %
1862 % First we save the original definitions of \cs{\textbackslash} and
1863 % \cs{parindent} as \cs{OrigLineBreak} and \cs{RaggedParindent} respectively.
1864 %
1865 % \begin{macrocode}
1866 \let\OrigLineBreak\\
1867 \newdimen\RaggedParindent
1868 \setlength{\RaggedParindent}{\parindent}
1869
1870 % \end{macrocode}
1871 %
1872 % \begin{macro}{raggedyright}
1873 % The \cs{raggedyright} layout more or less lays text out as with full
1874 % justification, but then lets the shorter lines relax a bit from the right
1875 % margin. It is the default for DCC papers.
1876 %
1877 % \begin{macrocode}
1878 \newcommand{\raggedyright}[1][2em]{%
1879 \let\\\@centercr\@rightskip \z@ \@plus #1\relax
1880 \rightskip\@rightskip
1881 \leftskip\z@skip
1882 \parindent\RaggedParindent}
1883 \AtBeginDocument{\raggedyright}
1884
1885 % \end{macrocode}
1886 % \end{macro}
1887 %
1888 % \begin{macro}{flushleftright}
1889 % The \cs{flushleftright} layout restores full justification, in case it is
1890 % needed.
1891 %
1892 % \begin{macrocode}
1893 \newcommand*{\flushleftright}{%
1894 \let\\\OrigLineBreak
1895 \leftskip\z@skip
1896 \rightskip\leftskip
1897 \parfillskip\@flushglue
1898 \everypar{}}
1899
1900 % \end{macrocode}
1901 % \end{macro}
1902 %
1903 % Pdf\TeX\ 1.40.15 introduced the facility to include dummy interword spaces
1904 % to improve text extraction and reflow. It would be really, really nice if
1905 % we could switch this on if available, but unfortunately it triggers a
1906 % long-standing bug in MikTeX: https://tex.stackexchange.com/q/318425
1907 %
1908 % \begin{macrocode}
1909 \RequirePackage{ifpdf}
1910 \newtoggle{dccp@dummyspaces}
1911 \def\fixspaces{\toggletrue{dccp@dummyspaces}}
1912 \def\nofixspaces{\togglefalse{dccp@dummyspaces}}
1913 \AtBeginDocument{%
1914 \iftoggle{dccp@dummyspaces}{%
1915 \ifpdf
1916 \ifdef{\pdfinterwordspaceon}{\pdfinterwordspaceon}{}%
1917 \fi
1918 }{}%
1919 }
1920
1921 % \end{macrocode}
1922 %
1923 % The classes have some special metadata requirements. We start with the author
1924 % information.
1925 %
1926 % \begin{macro}{thecorrespondence}
1927 % \begin{macro}{correspondence}
1928 % The macro \cs{thecorrespondence} is used in the title page footer for the name,
1929 % postal address and email address of the corresponding author.
1930 %
1931 % \begin{macrocode}
1932 \def\thecorrespondence{}
1933 \newcommand*{\correspondence}[1]{\def\thecorrespondence{#1}}
1934 % \end{macrocode}
1935 % \end{macro}
1936 % \end{macro}
1937 %
1938 % The handling of authors here is inspired by Patrick W Daly's \pkg{authblk},
1939 % (2001/02/27 1.3), and defines the familiar user commands. Authors are
1940 % presented in blocks, one affiliation but perhaps several authors per block.
1941 %
1942 % \begin{macro}{Authfont}
1943 % \begin{macro}{Affilfont}
1944 % \begin{macro}{affilsep}
1945 % \begin{macro}{authblksep}
1946 % We make the presentation of the author information configurable (just in case)
1947 % with some hooks and lengths:
1948 % \begin{itemize}
1949 % \item \cs{Authfont} is the font used for author names;
1950 % \item \cs{Affilfont} is the font used for affiliations;
1951 % \item \cs{affilsep} is the line spacing between author names and affiliations;
1952 % \item \cs{authblksep} is the line spacing between author name/affiliation
1953 % blocks.
1954 % \end{itemize}
1955 %
1956 % \begin{macrocode}
1957 \newcommand*{\Authfont}{\normalfont}
1958 \newcommand*{\Affilfont}{\normalfont\small}
1959 \newlength{\affilsep}\setlength{\affilsep}{0pt}
1960 \newlength{\authblksep}\setlength{\authblksep}{1.5\baselineskip}
1961 % \end{macrocode}
1962 % \end{macro}
1963 % \end{macro}
1964 % \end{macro}
1965 % \end{macro}
1966 %
1967 % \begin{macro}{AuthorBlock}
1968 % The \cs{AuthorBlock} command will be used to collect all the author information.
1969 %
1970 % \begin{macrocode}
1971 \newcommand{\AuthorBlock}{}
1972 % \end{macrocode}
1973 % \end{macro}
1974 %
1975 % \begin{macro}{MainAuthor}
1976 % The \cs{MainAuthor} command collects abbreviated author information for use in
1977 % the headers.
1978 %
1979 % \begin{macrocode}
1980 \newcommand{\MainAuthor}{}
1981 % \end{macrocode}
1982 % \end{macro}
1983 %
1984 % \begin{macro}{dccp@author}
1985 % The \cs{dccp@author} command, meanwhile, collects a full list of authors for the
1986 % PDF metatdata.
1987 %
1988 % \begin{macrocode}
1989 \newcommand{\dccp@author}{}
1990 % \end{macrocode}
1991 % \end{macro}
1992 %
1993 % We define counters for
1994 % \begin{itemize}
1995 % \item the total number of authors defined;
1996 % \item the number of authors in the current block;
1997 % \item the number of blocks defined.
1998 % \end{itemize}
1999 %
2000 % \begin{macrocode}
2001 \newcounter{authors}
2002 \newcounter{authorsinblock}
2003 \newcounter{block}
2004 % \end{macrocode}
2005 %
2006 % The |block| counter will increase once in the preamble, and again when the
2007 % information is typeset, so we need to reset it at the beginning of the
2008 % document.
2009 %
2010 % \begin{macrocode}
2011 \AtBeginDocument{\setcounter{block}{0}}
2012 % \end{macrocode}
2013 %
2014 % \begin{macro}{author}
2015 % The new definition of the author command starts here.
2016 %
2017 % \begin{macrocode}
2018 \renewcommand{\author}[1]{%
2019 % \end{macrocode}
2020 %
2021 % If this is the first or second \cs{author} command, we add the name to our
2022 % abbreviated list of authors. Otherwise, we replace the name of the second
2023 % and subsequent authors with `et al.' in that list.
2024 %
2025 % At the same time, we use a simpler technique to populate \cs{dccp@author}.
2026 %
2027 % \begin{macrocode}
2028 \ifnum\theauthors=0
2029 \def\dccp@author{#1}%
2030 \def\MainAuthor{#1}%
2031 \else
2032 \appto\dccp@author{, #1}%
2033 \ifnum\theauthors=1%
2034 \def\OtherMainAuthors{ and #1}%
2035 \appto\MainAuthor{\OtherMainAuthors}%
2036 \else
2037 \ifnum\theauthors=2%
2038 \def\OtherMainAuthors{ et al.}%
2039 \fi
2040 \fi
2041 \fi
2042 \stepcounter{authors}%
2043 % \end{macrocode}
2044 %
2045 % Each block has its author names collected in a macro like \cs{blocki@auth},
2046 % and its affiliation collected in a macro like \cs{blocki@affil} (the `i' is a
2047 % serial number).
2048 %
2049 % If this is the first author in a block, we need to create the block and add it
2050 % to \cs{AuthorBlock}; second and subsequent blocks are preceded by a \cs{quad} of
2051 % space.
2052 %
2053 % \begin{macrocode}
2054 \ifnum\theauthorsinblock=0%
2055 \stepcounter{block}%
2056 \expandafter\def\csname block\roman{block}@auth\endcsname{\Authfont#1}%
2057 \ifnum\theblock>1\appto\AuthorBlock{\quad}\fi
2058 \appto\AuthorBlock{%
2059 \stepcounter{block}%
2060 \begin{minipage}[t]{0.45\textwidth}\centering
2061 \csname block\roman{block}@auth\endcsname
2062 \ifx\undefined\csname block\roman{block}@affil\endcsname
2063 \else
2064 \\[\affilsep]\csname block\roman{block}@affil\endcsname
2065 \fi
2066 \end{minipage}%
2067 \rule{0pt}{2\baselineskip}%
2068 }
2069 \else
2070 % \end{macrocode}
2071 %
2072 % Otherwise we just add the name to the right \cs{blocki@auth}-style macro.
2073 %
2074 % \begin{macrocode}
2075 \csappto{block\roman{block}@auth}{, #1}%
2076 \fi
2077 \stepcounter{authorsinblock}%
2078 }
2079 % \end{macrocode}
2080 % \end{macro}
2081 %
2082 % \begin{macro}{affil}
2083 % The \cs{affil} command adds an affiliation to the current block and closes it by
2084 % resetting the |authorsinblock| counter.
2085 %
2086 % \begin{macrocode}
2087 \newcommand{\affil}[1]{%
2088 \expandafter\def\csname block\roman{block}@affil\endcsname{\Affilfont#1}%
2089 \setcounter{authorsinblock}{0}%
2090 }
2091
2092 % \end{macrocode}
2093 % \end{macro}
2094 %
2095 % \begin{macro}{HeadTitle}
2096 % The \cs{HeadTitle} collects the abbreviated title for use in the headers.
2097 %
2098 % \begin{macrocode}
2099 \newcommand*{\HeadTitle}{}
2100 % \end{macrocode}
2101 % \end{macro}
2102 %
2103 % \begin{macro}{title}
2104 % We wrap the normal \cs{title} command with code to populate \cs{HeadTitle} with
2105 % the optional argument if provided, or the mandatory one otherwise. We also
2106 % provide a persistent \cs{thetitle} macro, stripped of any \cs{thanks}.
2107 %
2108 % \begin{macrocode}
2109 \let\ProperTitle=\title
2110 \renewcommand{\title}[2][\empty]{
2111 \ifx\empty #1%
2112 \renewcommand*{\HeadTitle}{#2}%
2113 \else
2114 \renewcommand*{\HeadTitle}{#1}%
2115 \fi%
2116 \begingroup\let\footnote\@gobble
2117 \ProperTitle{#2}%
2118 \begingroup
2119 \renewcommand{\thanks}[1]{}
2120 \protected@xdef\thetitle{#2}
2121 \endgroup\endgroup
2122 }
2123 % \end{macrocode}
2124 % \end{macro}
2125 %
2126 % \begin{macro}{thetitle}
2127 % To prevent \LaTeX\ throwing an error if no title is supplied, we supply a
2128 % fallback value and issue a warning instead.
2129 %
2130 % \begin{macrocode}
2131 \def\thetitle{%
2132 Please supply a title
2133 \ClassWarning{dccpaper}{%
2134 Please supply a title in the preamble with \noexpand\title{}%
2135 }
2136 }
2137
2138 % \end{macrocode}
2139 % \end{macro}
2140 %
2141 % \begin{macro}{date}
2142 % \begin{macro}{thedate}
2143 % We make \cs{thedate} persistent, borrowing the technique used in Peter Wilson's
2144 % \pkg{memoir} class (2005/09/25 v1.618).
2145 %
2146 % \begin{macrocode}
2147 \xpretocmd{\date}{\begingroup\let\footnote\@gobble}{}{}%
2148 \xapptocmd{\date}{%
2149 \begingroup
2150 \renewcommand{\thanks}[1]{}
2151 \protected@xdef\thedate{#1}
2152 \endgroup\endgroup%
2153 }{}{}
2154 % \end{macrocode}
2155 % \end{macro}
2156 % \end{macro}
2157 %
2158 % We ensure \cs{thedate} is defined using a dummy date.
2159 %
2160 % \begin{macrocode}
2161 \date{20xx}
2162
2163 % \end{macrocode}
2164 %
2165 % \begin{macro}{thevolume}
2166 % \begin{macro}{volume}
2167 % \begin{macro}{theissue}
2168 % \begin{macro}{issue}
2169 % \begin{macro}{thesubno}
2170 % \begin{macro}{subno}
2171 % \begin{macro}{thedoi}
2172 % IJDC articles have extra bibliographic information:
2173 % \begin{itemize}
2174 % \item \cs{volume} sets the volume number, \cs{thevolume};
2175 % \item \cs{issue} sets the issue number, \cs{theissue};
2176 % \item \cs{subno} sets the submission number, \cs{thesubno}.
2177 % \end{itemize}
2178 %
2179 % These numbers are used to build the DOI, \cs{thedoi}.
2180 %
2181 % \begin{macrocode}
2182 \newcommand*{\thevolume}{0}
2183 \newcommand*{\volume}[1]{\renewcommand*{\thevolume}{#1}}
2184 \newcommand*{\theissue}{0}
2185 \newcommand*{\issue}[1]{\renewcommand*{\theissue}{#1}}
2186 \newcommand*{\thesubno}{0}
2187 \newcommand*{\subno}[1]{\renewcommand*{\thesubno}{#1}\fixspaces}
2188 \newcommand*{\thedoi}{10.2218/ijdc.v\thevolume i\theissue .\thesubno}
2189 % \end{macrocode}
2190 % \end{macro}
2191 % \end{macro}
2192 % \end{macro}
2193 % \end{macro}
2194 % \end{macro}
2195 % \end{macro}
2196 % \end{macro}
2197 %
2198 % \begin{macro}{dol@stpage}
2199 % They also display the page range. The following code was borrowed from Peter
2200 % Wilson's \pkg{memoir} class (2005/09/25 v1.618). It defines a counter
2201 % |lastpage| which, on the second run, will contain the number of the last page.
2202 %
2203 % \begin{macrocode}
2204 \newcounter{lastpage}
2205 \setcounter{lastpage}{0}
2206 \newcommand{\dol@stpage}{%
2207 \if@filesw
2208 \addtocounter{page}{-1}%
2209 \immediate\write\@auxout%
2210 {\string\setcounter{lastpage}{\the\c@page}}%
2211 \stepcounter{page}%
2212 \fi
2213 }
2214 \AtBeginDocument{\AtEndDocument{\clearpage\dol@stpage}}
2215
2216 % \end{macrocode}
2217 % \end{macro}
2218 %
2219 % \begin{macro}{dccp@dates}
2220 % DCC papers display some important dates. We collect these in \cs{dccp@dates},
2221 % initially setting the value to something sensible for papers in draft.
2222 %
2223 % \begin{macrocode}
2224 \def\dccp@dates{\emph{Draft from} \today}
2225 % \end{macrocode}
2226 % \end{macro}
2227 %
2228 % \begin{macro}{submitted}
2229 % \begin{macro}{received}
2230 % \begin{macro}{revised}
2231 % \begin{macro}{accepted}
2232 % Several types of date can be added:
2233 % \begin{itemize}
2234 % \item \cs{submitted} for when the authors submitted the paper (intended for
2235 % IDCC papers).
2236 % \item \cs{received} for when the paper was received by the editorial board
2237 % (intended for IJDC papers).
2238 % \item \cs{revised} for when the most recent version was received by the
2239 % editorial board.
2240 % \item \cs{accepted} for when the paper was accepted by the editorial board.
2241 % \end{itemize}
2242 %
2243 % \begin{macrocode}
2244 \newcommand*{\submitted}[1]{%
2245 \def\dccp@dates{\emph{Submitted} #1}}
2246 \newcommand*{\received}[1]{%
2247 \def\dccp@dates{\emph{Received} #1}}
2248 \newcommand*{\revised}[1]{%
2249 \appto\dccp@dates{%
2250 \space\space\space
2251 \ifdefstring{\dccp@variant}{baskerville}{$\sim$}{\textbar}%
2252 \space\space\space
2253 \emph{Revision received} #1}%
2254 }
2255 \newcommand*{\accepted}[1]{%
2256 \appto\dccp@dates{%
2257 \space\space\space
2258 \ifdefstring{\dccp@variant}{baskerville}{$\sim$}{\textbar}%
2259 \space\space\space
2260 \emph{Accepted} #1}%
2261 }
2262 % \end{macrocode}
2263 % \end{macro}
2264 % \end{macro}
2265 % \end{macro}
2266 % \end{macro}
2267 %
2268 % \begin{macro}{dccp@conf}
2269 % \begin{macro}{ifdccp@revision}
2270 % \begin{macro}{dccp@revisiontrue}
2271 % \begin{macro}{dccp@revisionfalse}
2272 % \begin{macro}{conference}
2273 % IJDC papers need to say if they had a previous life as a conference paper.
2274 % This statement goes in \cs{dccp@conf}, which is initially empty. The user
2275 % command for setting this text is \cs{conference}. The starred variant gives
2276 % slightly less verbose wording.
2277 %
2278 % \begin{macrocode}
2279 \let\dccp@conf=\empty
2280 \newif\ifdccp@revision
2281 \newcommand*{\conference@nostar}[1]{%
2282 \renewcommand*{\dccp@conf}{An earlier version of this paper was presented at #1.}%
2283 }
2284 \newcommand*{\conference@star}[1]{%
2285 \renewcommand*{\dccp@conf}{This paper was presented at #1.}%
2286 }
2287 \newcommand*{\conference}{\@ifstar\conference@star\conference@nostar}
2288 % \end{macrocode}
2289 % \end{macro}
2290 % \end{macro}
2291 % \end{macro}
2292 % \end{macro}
2293 % \end{macro}
2294 %
2295 % \begin{macro}{FixTextHeight}
2296 % The macro \cs{FixTextHeight} will be useful when switching from the first page
2297 % geometry to the regular geometry for the rest of the paper. It is based on
2298 % code from Hideo Umeki's \pkg{geometry} package (2002/07/08 v3.2).
2299 %
2300 % \begin{macrocode}
2301 \newcommand{\FixTextHeight}{%
2302 \setlength\@tempdima{\textheight}%
2303 \addtolength\@tempdima{-\topskip}%
2304 \@tempcnta\@tempdima
2305 \@tempcntb\baselineskip
2306 \divide\@tempcnta\@tempcntb
2307 \setlength\@tempdimb{\baselineskip}%
2308 \multiply\@tempdimb\@tempcnta
2309 \advance\@tempdima-\@tempdimb
2310 \global\advance\footskip\@tempdima
2311 \multiply\@tempdima\tw@
2312 \ifdim\@tempdima>\baselineskip
2313 \addtolength\@tempdimb{\baselineskip}%
2314 \global\advance\footskip-\baselineskip
2315 \fi
2316 \addtolength\@tempdimb{\topskip}%
2317 \global\textheight\@tempdimb
2318 }
2319
2320 % \end{macrocode}
2321 % \end{macro}
2322 %
2323 % The width of the textblock (on all pages) is 150mm, which on A4 paper implies
2324 % margins of 30mm each. (Making both horizontal margins the same in a two-sided
2325 % context makes the paper more pleasant to read on screen).
2326 %
2327 % \begin{macrocode}
2328 \setlength{\textwidth}{150mm}
2329 \setlength{\oddsidemargin}{30mm - \hoffset - 1in}
2330 \setlength{\evensidemargin}{30mm - \hoffset - 1in}
2331 % \end{macrocode}
2332 %
2333 % It is rare to have marginal notes, but in case we ever do, we centre them in
2334 % the margin.
2335 %
2336 % \begin{macrocode}
2337 \setlength{\marginparwidth}{30mm - 2\marginparsep}
2338 % \end{macrocode}
2339 %
2340 % We also want a distance of 15mm from the top of the page to the top of the
2341 % header, and two blank lines between the bottom of the header and the top of
2342 % the textblock.
2343 %
2344 % \begin{macrocode}
2345 \setlength{\topmargin}{15mm - \voffset - 1in}
2346 \setlength{\headsep}{2\baselineskip}
2347
2348 % \end{macrocode}
2349 %
2350 % \begin{macro}{dccp@editorial}
2351 % IJDC editorials have slightly different headers and footers. This requires
2352 % testing for \cs{dccp@editorial} if it exists. In case it doesn't, we provide it.
2353 %
2354 % \begin{macrocode}
2355 \providecommand{\dccp@editorial}{Editorial}
2356 % \end{macrocode}
2357 % \end{macro}
2358 %
2359 % \begin{macro}{ps@title}
2360 % \begin{macro}{TitleHead}
2361 % \begin{macro}{TitleFoot}
2362 % The height of the footer can vary a lot. To keep it a fixed distance from the
2363 % bottom of the page rather than the top, we need to vary the \cs{textheight}
2364 % accordingly. This means we need to measure the height of the footer. (The
2365 % header is more predictable but we may as well measure it while we are at it).
2366 %
2367 % Here we define the header and footer of the title page (i.e.\ the
2368 % \val{title} page style), making sure we save them to auxiliary macros
2369 % \cs{TitleHead} and \cs{TitleFoot} so we can measure them.
2370 %
2371 % \begin{macrocode}
2372 \def\ps@title{%
2373 \def\@oddhead{%
2374 \begin{minipage}{\textwidth}%
2375 \centering
2376 \ifdefstring{\dccp@variant}{baskerville}{\huge\sffamily}{\LARGE\bfseries}%
2377 \color{struct}%
2378 \ifx\dccp@type\dccp@editorial
2379 \dccp@publ@long
2380 \else
2381 \dccp@publ@short\space\space\textbar\space\space\emph{\dccp@type}%
2382 \fi
2383 \par
2384 \ifdcp@mast@ul\rule[0.4em]{\textwidth}{0.5pt}\fi
2385 \end{minipage}%
2386 }%
2387 \let\@evenhead=\@oddhead
2388 \let\TitleHead=\@oddhead
2389 \def\@oddfoot{%
2390 \begin{minipage}[b]{\textwidth}%
2391 \fontsize{9pt}{11pt}\selectfont
2392 \ifx\dccp@type\dccp@editorial
2393 \else
2394 {\centering\dccp@dates\par}
2395 \bigskip
2396 Correspondence should be addressed to \thecorrespondence\par
2397 \bigskip
2398 \fi
2399 \ifx\empty\dccp@conf
2400 \else
2401 \dccp@conf\par
2402 \bigskip
2403 \fi
2404 \dccp@publ@msg\par
2405 \bigskip
2406 \begin{minipage}[b]{\linewidth - 25mm}
2407 Copyright rests with the authors. This work is released under a Creative
2408 Commons Attribution 4.0 International Licence. For details please see
2409 \url{http://creativecommons.org/licenses/by/4.0/}%
2410 \end{minipage}\hfill
2411 \begin{minipage}[b]{19mm}
2412 \href{http://creativecommons.org/licenses/by/4.0/}%
2413 {\includegraphics[width=\hsize]{dccpaper-by}}%
2414 \end{minipage}
2415 \par
2416 \bigskip
2417 \makebox[0pt][l]{\parbox{0.4\hsize}{%
2418 \ifx\undefined\dccp@titlefoot@bib\else\dccp@titlefoot@bib\fi
2419 }}\hfill
2420 \makebox[0pt][c]{\normalsize\thepage}\hfill
2421 \makebox[0pt][r]{\parbox{0.4\hsize}{%
2422 \raggedleft\ifx\undefined\dccp@titlefoot@doi\else\dccp@titlefoot@doi\fi
2423 }}%
2424 \end{minipage}%
2425 }%
2426 \let\@evenfoot=\@oddfoot
2427 \let\TitleFoot=\@oddfoot
2428 }
2429 % \end{macrocode}
2430 % \end{macro}
2431 % \end{macro}
2432 % \end{macro}
2433 %
2434 % We set the normal page style to \val{title} here so that \cs{TitleHead} and
2435 % \cs{TitleFoot} are defined, but we will override it with the \val{dccpaper}
2436 % page style later.
2437 %
2438 % \begin{macrocode}
2439 \pagestyle{title}
2440 % \end{macrocode}
2441 %
2442 % The first page should use the \val{title} page style, however.
2443 %
2444 % \begin{macrocode}
2445 \AtBeginDocument{\thispagestyle{title}}
2446
2447 % \end{macrocode}
2448 %
2449 % \begin{macro}{ps@dccpaper}
2450 % \begin{macro}{NormalHead}
2451 % \begin{macro}{NormalFoot}
2452 % Here are the normal headers and footers (i.e.\ the \val{dccpaper} page
2453 % style). We save them to \cs{NormalHead} and \cs{NormalFoot}, again so we can
2454 % measure them.
2455 %
2456 % \begin{macrocode}
2457 \def\ps@dccpaper{%
2458 \def\@oddhead{%
2459 \begin{minipage}{\textwidth}\frenchspacing
2460 {%
2461 \fontsize{9pt}{11pt}\selectfont
2462 \ifx\undefined\dccp@normhead@doi\else\dccp@normhead@doi\fi
2463 }\hfill
2464 {\MainAuthor}\space\space\space
2465 \textcolor{struct}{\textbar}\space\space\space
2466 \thepage\par
2467 \vskip6pt\color{struct}{\hrule height 1bp}\par
2468 \end{minipage}
2469 }%
2470 \def\@evenhead{%
2471 \begin{minipage}{\textwidth}
2472 \thepage\space\space\space
2473 \textcolor{struct}{\textbar}\space\space\space
2474 {\HeadTitle}\hfill
2475 {%
2476 \fontsize{9pt}{11pt}\selectfont
2477 \ifx\undefined\dccp@normhead@doi\else\dccp@normhead@doi\fi
2478 }\par
2479 \vskip6pt\color{struct}{\hrule height 1bp}\par
2480 \end{minipage}
2481 }%
2482 \let\NormalHead=\@oddhead
2483 \def\@oddfoot{\begin{minipage}[b]{\textwidth}
2484 \centering\ifdefstring{\dccp@variant}{baskerville}{\sffamily}{\bfseries}%
2485 \normalsize\color{struct}
2486 \ifx\dccp@type\dccp@editorial
2487 \dccp@publ@long
2488 \else
2489 \dccp@publ@short\space\space\textbar\space\space\emph{\dccp@type}%
2490 \fi
2491 \par
2492 \end{minipage}}%
2493 \let\@evenfoot=\@oddfoot
2494 \let\NormalFoot=\@oddfoot
2495 }
2496 \pagestyle{dccpaper}
2497
2498 % \end{macrocode}
2499 % \end{macro}
2500 % \end{macro}
2501 % \end{macro}
2502 %
2503 % \begin{macro}{dccp@firstpagehead}
2504 % \begin{macro}{dccp@firstpagefoot}
2505 % \begin{macro}{dccp@restpagehead}
2506 % \begin{macro}{dccp@restpagefoot}
2507 % We need to wait until the author has supplied the necessary information before
2508 % we can do our measuring and set the remainder of the geometry, so we do it at
2509 % the end of the preamble. First we put our saved macros into boxes we can
2510 % measure (i.e.\ \cs{dccp@firstpagehead}, \cs{dccp@firstpagefoot},
2511 % \cs{dccp@restpagehead}, \cs{dccp@restpagefoot}).
2512 %
2513 % \begin{macrocode}
2514 \AtEndPreamble{
2515 \newsavebox{\dccp@firstpagehead}
2516 \sbox\dccp@firstpagehead{\normalfont\TitleHead}
2517 \newsavebox{\dccp@firstpagefoot}
2518 \sbox\dccp@firstpagefoot{\normalfont
2519 \def\email#1{#1}\def\url#1{#1}\def\href#1#2{#2}\TitleFoot}
2520 \newsavebox{\dccp@restpagehead}
2521 \sbox\dccp@restpagehead{\normalfont\NormalHead}
2522 \newsavebox{\dccp@restpagefoot}
2523 \sbox\dccp@restpagefoot{\normalfont\NormalFoot}
2524 % \end{macrocode}
2525 % \end{macro}
2526 % \end{macro}
2527 % \end{macro}
2528 % \end{macro}
2529 %
2530 % We can now set the geometry of the title page\dots
2531 %
2532 % \begin{macrocode}
2533 \setlength{\headheight}{\ht\dccp@firstpagehead + \dp\dccp@firstpagehead}
2534 \setlength{\footskip}{%
2535 2\baselineskip + \ht\dccp@firstpagefoot + \dp\dccp@firstpagefoot
2536 }
2537 \setlength{\textheight}{%
2538 \paperheight
2539 - 30mm % 15mm top and bottom
2540 - \headheight
2541 - \headsep
2542 - \footskip
2543 }
2544 % \end{macrocode}
2545 %
2546 % \begin{macro}{dccp@resetgeometry}
2547 % {\dots}and provide a macro that will reset the geometry for the remaining
2548 % pages.
2549 %
2550 % \begin{macrocode}
2551 \def\dccp@resetgeometry{%
2552 \setlength{\headheight}{\ht\dccp@restpagehead + \dp\dccp@restpagehead}
2553 \global\headheight=\headheight
2554 \setlength{\footskip}{%
2555 2\baselineskip + \ht\dccp@restpagefoot
2556 }
2557 \global\footskip=\footskip
2558 \setlength{\textheight}{%
2559 \paperheight
2560 - 30mm % 15mm top and bottom
2561 - \headheight
2562 - \headsep
2563 - \footskip
2564 }
2565 \FixTextHeight
2566 \global\textheight=\textheight
2567 }
2568 }
2569
2570 % \end{macrocode}
2571 % \end{macro}
2572 %
2573 % \begin{macro}{maketitle}
2574 % The \cs{maketitle} command is redefined to the correct formatting. At the end it
2575 % sets a hook that will reset the geometry when the first page is shipped out,
2576 % i.e.\ with effect from the second page. It is here rather than at the end of
2577 % the abstract in case the abstract itself spills over to the second page.
2578 %
2579 % \begin{macrocode}
2580 \RequirePackage{atbegshi}
2581 \renewcommand{\maketitle}{%
2582 \null\nobreak\vspace*{-0.528\baselineskip}%
2583 \begingroup
2584 \centering
2585 {\Large\ifdefstring{\dccp@variant}{baskerville}{\bfseries}{}\thetitle\par}
2586 \vspace{0.7\baselineskip}
2587 \AuthorBlock\par
2588 \vspace{1.7\baselineskip}
2589 \endgroup
2590 \AtBeginShipoutNext{\dccp@resetgeometry}%
2591 }
2592
2593 % \end{macrocode}
2594 % \end{macro}
2595 %
2596 % \begin{environment}{widequote}
2597 % \begin{macro}{afterabstract}
2598 % \begin{environment}{abstract}
2599 % The \env{abstract} environment is redefined in terms of an environment
2600 % \env{widequote}, which mimics the \env{quote} environment, but is a bit
2601 % wider. We also provide a hook, \cs{afterabstract}, so that if some annotation
2602 % needs to be appended to the title page after the abstract, we can do that.
2603 %
2604 % \begin{macrocode}
2605 \newenvironment{widequote}{%
2606 \list{}{%
2607 \setlength{\rightmargin}{2\parindent}%
2608 \setlength{\leftmargin}{2\parindent}%
2609 }%
2610 \flushleftright\item[]%
2611 }{%
2612 \endlist
2613 }
2614 \def\afterabstract{}
2615 \renewenvironment{abstract}{%
2616 \vskip1em%
2617 \begin{center}%
2618 {\bfseries\abstractname\vspace{-.5em}\vspace{\z@}}%
2619 \end{center}%
2620 \widequote\footnotesize
2621 }{%
2622 \endwidequote\afterabstract\newpage
2623 }
2624
2625 % \end{macrocode}
2626 % \end{environment}
2627 % \end{macro}
2628 % \end{environment}
2629 %
2630 % We use the \pkg{titlesec} package to give headings the correct formatting.
2631 % The settings below try to space out headings so they occupy an integer number
2632 % of normal lines (an attempt at grid typesetting). They are a little
2633 % complicated because we want it to work even if the heading appears at the top
2634 % of the page.
2635 %
2636 % \begin{macrocode}
2637 \RequirePackage{titlesec}
2638 \titlespacing*{\section}{0pt}{0pt}{\baselineskip}
2639 \titlespacing*{\subsection}{0pt}{0pt}{0.6\baselineskip}
2640 \titlespacing{\subsubsection}{\parindent}{\baselineskip}{0pt}
2641 \titlespacing{\paragraph}{\parindent}{\baselineskip}{0pt}
2642 \titlespacing{\subparagraph}{\parindent}{\baselineskip}{0pt}
2643 % \end{macrocode}
2644 %
2645 % \begin{macro}{dccp@old@ep}
2646 % An unfortunate side effect of spacing headings like this is that if a
2647 % \cs{subsection} immediately follows a \cs{section} it forms an unsightly gap. To
2648 % remedy this, we count how many paragraphs there have been since the last
2649 % \cs{section}. Note that as we do not normally number the sections, an automatic
2650 % reset of the |sectionpars| counter within the |section| counter won't work.
2651 %
2652 % \begin{macrocode}
2653 \newcounter{sectionpars}
2654 \let\dccp@old@ep\everypar
2655 \newtoks\everypar
2656 \dccp@old@ep{\the\everypar\stepcounter{sectionpars}}
2657 % \end{macrocode}
2658 % \end{macro}
2659 %
2660 % We need to manually reset |sectionpars| when \cs{section} is called. Also,
2661 % the normal font size is 12pt/14.5pt, while \cs{Large} is 17pt/22pt;
2662 % so the \cs{Large} line height = 1.5172 $\times$ normal line height. Nevertheless
2663 % it seems to work better if we let the heading eat 0.528\cs{baselineskip} into
2664 % the 2\cs{baselineskip} of padding above it.
2665 %
2666 % \begin{macrocode}
2667 \titleformat{\section}
2668 [block]
2669 {%
2670 \vspace{2\baselineskip}%
2671 \nobreak
2672 \vspace*{-0.528\baselineskip}%
2673 \setcounter{sectionpars}{0}%
2674 \filcenter\normalfont\Large\bfseries
2675 }
2676 {\thesection}
2677 {1em}
2678 {}
2679 % \end{macrocode}
2680 %
2681 % The others use a \cs{normalsize} font so that makes life easier. The format
2682 % for \cs{subsection} command includes conditional spacing: if the |sectionpars|
2683 % counter equals 2, this means the heading immediately follows a \cs{section}, so
2684 % less white space is needed.
2685 %
2686 % \begin{macrocode}
2687 \titleformat{\subsection}
2688 {%
2689 \ifnum\thesectionpars>2%
2690 \vspace{2\baselineskip}%
2691 \else
2692 \vspace{\baselineskip}%
2693 \fi\nobreak
2694 \vspace*{-0.6\baselineskip}%
2695 \normalfont\normalsize\bfseries
2696 }
2697 {\thesubsection}
2698 {1em}
2699 {}
2700 \titleformat{\subsubsection}
2701 [block]
2702 {\normalfont\normalsize\bfseries}
2703 {\thesubsubsection}
2704 {1em}
2705 {}
2706 \titleformat{\paragraph}
2707 [block]
2708 {\normalfont\normalsize\bfseries\itshape}
2709 {\thesubsubsection}
2710 {1em}
2711 {}
2712 \titleformat{\subparagraph}
2713 [block]
2714 {\normalfont\normalsize\itshape}
2715 {\thesubsubsection}
2716 {1em}
2717 {}
2718 % \end{macrocode}
2719 %
2720 % DCC papers do not typically number their sections.
2721 %
2722 % \begin{macrocode}
2723 \setcounter{secnumdepth}{0}
2724
2725 % \end{macrocode}
2726 %
2727 % To help with the display of tables we load the \pkg{array} and
2728 % \pkg{booktabs} packages. As we don't like lines between rows in the table
2729 % body, we stretch them out a bit so that white space does the job instead.
2730 %
2731 % \begin{macrocode}
2732 \RequirePackage{array,booktabs}
2733 \renewcommand{\arraystretch}{1.25}
2734
2735 % \end{macrocode}
2736 %
2737 % We use the \pkg{caption} package to give captions the right format.
2738 %
2739 % \begin{macrocode}
2740 \RequirePackage
2741 [ format=hang
2742 , labelsep=period
2743 , font=small
2744 , labelfont=bf
2745 , figureposition=bottom
2746 , tableposition=top
2747 ]{caption}
2748
2749 % \end{macrocode}
2750 %
2751 % \begin{macro}{footnotelayout}
2752 % Footnotes should be set right up against the left margin. They should be
2753 % set hung and in the same half-ragged style as the main text. They should also,
2754 % for neatness, be at the bottom of the page regardless of how short it is. The
2755 % \pkg{footmisc} package helps here.
2756 %
2757 % \begin{macrocode}
2758 \RequirePackage[hang,bottom]{footmisc}
2759 \settowidth{\footnotemargin}{\footnotesize\textsuperscript{99}\space}
2760 \renewcommand{\footnotelayout}{\raggedyright}
2761 % \end{macrocode}
2762 % \end{macro}
2763 %
2764 % \begin{macro}{dccp@footnote}
2765 % \begin{macro}{dccp@next@token}
2766 % \begin{macro}{dccp@supercomma}
2767 % \begin{macro}{dccp@check@for@footnote}
2768 % Also, if multiple footnotes are set at once, the markers should be separated
2769 % with superscript commas. The \pkg{footmisc} package should help here but
2770 % its solution is clobbered by \pkg{hyperref}. So after a footnote is set,
2771 % we check to see if the next token is also a footnote, and if so, slip a comma
2772 % in before it.\footnote{This solution was provided at
2773 % \url{http://tex.stackexchange.com/q/40072}} This tweak needs to be done late,
2774 % \cs{AtBeginDocument}. Note that the \pkg{newtx} superior figures are a bit
2775 % lower than normal superscript text.
2776 %
2777 % \begin{macrocode}
2778 \AtBeginDocument{
2779 \let\dccp@footnote\footnote
2780 \def\dccp@next@token{\relax}%
2781 \def\dccp@supercomma{\textsuperscript{,}}%
2782 \IfFileExists{newtxtext.sty}%
2783 {\def\dccp@supercomma{\raisebox{-0.2ex}{\textsuperscript{,}}}}%
2784 {}
2785
2786 \newcommand\dccp@check@for@footnote{%
2787 \ifx\footnote\dccp@next@token
2788 \dccp@supercomma
2789 \fi
2790 }
2791
2792 \renewcommand\footnote[1]{%
2793 \dccp@footnote{#1}%
2794 \futurelet\dccp@next@token\dccp@check@for@footnote
2795 }
2796 }
2797
2798 % \end{macrocode}
2799 % \end{macro}
2800 % \end{macro}
2801 % \end{macro}
2802 % \end{macro}
2803 %
2804 % By default lists are quite loose. These settings help to tighten them.
2805 %
2806 % \begin{macrocode}
2807 \topsep = \z@
2808 \partopsep = \z@
2809 \appto{\enumerate}{\itemsep = 0.5ex plus 0.25ex minus 0.25ex}
2810 \appto{\itemize}{\itemsep = 0.5ex plus 0.25ex minus 0.25ex}
2811
2812 % \end{macrocode}
2813 %
2814 % A DCC paper should either be using \pkg{biblatex} or \pkg{apacite} for
2815 % references.
2816 %
2817 % If \pkg{biblatex} is used, we need to ensure that the reference list
2818 % heading is a normal section rather than a starred one so it appears in the
2819 % PDF bookmarks.
2820 %
2821 % \begin{macrocode}
2822 \AtBeginDocument{
2823 \@ifpackageloaded{biblatex}{%
2824 \defbibheading{bibliography}[\refname]{\section{#1}}%
2825 % \end{macrocode}
2826 %
2827 % We also move the ‘doi:’ portion of a DOI inside the hyperlink.
2828 %
2829 % \begin{macrocode}
2830 \DeclareFieldFormat{doi}{%
2831 \ifhyperref{%
2832 \href{https://doi.org/#1}{\nolinkurl{doi:#1}}%
2833 }{%
2834 \nolinkurl{doi:#1}%
2835 }%
2836 }
2837 }{%
2838 % \end{macrocode}
2839 %
2840 % If \pkg{apacite} is used, there are a few other adaptations we need to
2841 % make.
2842 %
2843 % \begin{macrocode}
2844 \@ifpackageloaded{apacite}{%
2845 % \end{macrocode}
2846 %
2847 % \begin{macro}{@ifauthorsunequalc@de}
2848 % With \pkg{hyperref} loaded, \pkg{apacite} makes the whole of a citation
2849 % a link to the reference list item. We patch \cs{@ifauthorsunequalc@de} so only
2850 % the year portion gets linked.
2851 %
2852 % \begin{macrocode}
2853 \def\@ifauthorsunequalc@de#1{%
2854 \if@F@cite
2855 \@F@citefalse
2856 \else
2857 \if@Y@cite
2858 {\@BAY}%
2859 \fi
2860 {\@BBC}%
2861 \fi
2862 \edef\@cite@undefined{?}%
2863 \def\BBA{\@BBA}%
2864 \if@A@cite
2865 %%\hyper@natlinkstart{#1}% We remove this line...
2866 {\csname b@\@citeb\APAC@extra@b@citeb\endcsname}%
2867 %%\hyper@natlinkend% ...and this one.
2868 \if@Y@cite
2869 {\@BBAY}%
2870 \fi
2871 \fi
2872 \if@Y@cite
2873 \hyper@natlinkstart{#1}%
2874 {\csname Y@\@citeb\APAC@extra@b@citeb\endcsname}%
2875 \hyper@natlinkend
2876 \fi
2877 \let\BBA\relax
2878 }
2879 % \end{macrocode}
2880 % \end{macro}
2881 %
2882 % The Spanish language support file defines a different version of
2883 % \cs{@ifauthorsunequalc@de}, which might override the patch we have just
2884 % introduced. So we employ the same test that \pkg{apacite} uses when
2885 % deciding whether to load that file; if successful, we patch the Spanish
2886 % version. Note that as \pkg{apacite} loads language support files
2887 % \cs{AtBeginDocument}, we have to do our thing after that, \cs{AfterEndPreamble}.
2888 %
2889 % (Note that as we set the language to British English earlier, this should
2890 % never be needed, but we try to be resilient to tinkering!)
2891 %
2892 % \begin{macrocode}
2893 \AfterEndPreamble{%
2894 \@ifundefined{iflanguage}{%
2895 \relax
2896 }{%
2897 \edef\APAC@tmp{nohyphenation}%
2898 \ifx\languagename\APAC@tmp
2899 \else
2900 \edef\APAC@tmp{spanish}%
2901 \ifx\languagename\APAC@tmp
2902 \def\@ifauthorsunequalc@de#1{%
2903 \if@F@cite
2904 \@F@citefalse
2905 \else
2906 \if@Y@cite
2907 {\@BAY}%
2908 \fi
2909 {\@BBC}%
2910 \fi
2911 \edef\@cite@undefined{?}%
2912 \def\BBA{\@BBA}%
2913 \@ifundefined{spanishe@\@citeb\APAC@extra@b@citeb}%
2914 {}% skip
2915 {{% Use `e' instead of `y' in Spanish
2916 \global\let\oldBBA\BBA
2917 \global\def\BBA{e\global\let\BBA\oldBBA}%
2918 }}%
2919 \if@A@cite
2920 %%\hyper@natlinkstart{#1}% We remove this line...
2921 {\csname b@\@citeb\APAC@extra@b@citeb\endcsname}%
2922 %%\hyper@natlinkend% ...and this one.
2923 \if@Y@cite
2924 {\@BBAY}%
2925 \fi
2926 \fi
2927 \if@Y@cite
2928 \hyper@natlinkstart{#1}%
2929 {\csname Y@\@citeb\APAC@extra@b@citeb\endcsname}%
2930 \hyper@natlinkend
2931 \fi
2932 \let\BBA\relax
2933 }%
2934 \fi
2935 \fi
2936 }%
2937 % \end{macrocode}
2938 %
2939 % Another thing \pkg{apacite} does \cs{AtBeginDocument} is set the URL style
2940 % to monospaced. So we reset it back to normal roman type \cs{AfterEndPreamble}.
2941 %
2942 % \begin{macrocode}
2943 \urlstyle{APACrm}
2944 }%
2945 % \end{macrocode}
2946 %
2947 % \begin{macro}{doi}
2948 % \begin{macro}{doiprefix}
2949 % We pre-empt \pkg{apacite}'s \cs{providecommand} of \cs{doi} with our own
2950 % definition that includes the `doi' URI scheme label in the link, remembering
2951 % to remove the one inserted by \cs{doiprefix}.
2952 %
2953 % \begin{macrocode}
2954 \newcommand{\doi}[1]{\href{https://doi.org/#1}{\nolinkurl{doi:#1}}}%
2955 \renewcommand{\doiprefix}{\unskip}%
2956 }{}%
2957 }%
2958 % \end{macrocode}
2959 % \end{macro}
2960 % \end{macro}
2961 %
2962 % \begin{macro}{bibitemsep}
2963 % Both \pkg{biblatex} and \pkg{apacite} use \cs{bibitemsep} for the space
2964 % between bibliography items. Just in case they haven't been loaded, though, we
2965 % protect our setting of that length with an \cs{ifx} test.
2966 %
2967 % \begin{macrocode}
2968 \ifx\undefined\bibitemsep
2969 \else
2970 \setlength{\bibitemsep}{1em plus 1ex minus 1ex}%
2971 \fi
2972 }
2973 % \end{macrocode}
2974 % \end{macro}
2975 %
2976 % As mentioned above, if \pkg{apacite} is used, we can use a package option
2977 % to ensure that the reference list heading appears in the PDF bookmarks.
2978 %
2979 % \begin{macrocode}
2980 \PassOptionsToPackage{numberedbib}{apacite}
2981
2982 % \end{macrocode}
2983 %
2984 % We, of course, use \pkg{hyperref} for enhancing the PDF with working links,
2985 % bookmarks, metadata, etc.
2986 %
2987 % \begin{macrocode}
2988 \RequirePackage
2989 [ colorlinks=true
2990 , linkcolor=black
2991 , anchorcolor=black
2992 , citecolor=links
2993 , filecolor=black
2994 , menucolor=black
2995 , runcolor=black
2996 , urlcolor=links
2997 ]{hyperref}
2998 % \end{macrocode}
2999 %
3000 % Links should be in roman type, not monospaced.
3001 %
3002 % \begin{macrocode}
3003 \urlstyle{rm}
3004 % \end{macrocode}
3005 %
3006 % \begin{macro}{email}
3007 % We provide an \cs{email} command for displaying the email address of the
3008 % corresponding author.
3009 %
3010 % \begin{macrocode}
3011 \newcommand*{\email}[1]{\href{mailto:#1}{#1}}
3012 % \end{macrocode}
3013 % \end{macro}
3014 %
3015 % Once the user has had a chance to provide the metadata, we can add it to the
3016 % PDF metadata.
3017 %
3018 % \begin{macrocode}
3019 \AtBeginDocument{%
3020 \hypersetup
3021 { pdftitle={\thetitle}
3022 , pdfauthor={\dccp@author}
3023 , pdfsubject={\dccp@subject}
3024 }
3025 % \end{macrocode}
3026 %
3027 % The APA has its own style for line breaks in URLs. The \pkg{apacite}
3028 % package provides the code for this, but in case \pkg{biblatex} is used
3029 % instead, we repeat the settings (from 2013/07/21 v6.03) here.
3030 %
3031 % \begin{macrocode}
3032 \@ifundefined{Url@force@Tilde}{\def\Url@force@Tilde{\relax}}{}%
3033 \def\url@apa@dot{\mathchar"2E }%
3034 \def\url@apa@comma{\mathchar"2C }%
3035 \def\url@apa@questionmark{\mathchar"3F }%
3036 \def\url@apa@exclamation{\mathchar"21 }%
3037 \def\url@apa@hyphen{\mathchar"2D }%
3038 \def\url@apa@underscore{\_}%
3039 \def\UrlBreaks{\do\@\do\\\do\|\do\;\do\>\do\]\do\)\do\'\do+\do\=\do\#}%
3040 \def\UrlBigBreaks{\do\/\do\:\do@url@hyp}%
3041 \def\UrlNoBreaks{\do\(\do\[\do\{\do\<}% \)}
3042 \def\UrlOrds{\do\*\do\~\do\'\do\"}%
3043 \def\UrlSpecials{%
3044 \do\.{\mathbin{}\url@apa@dot }%
3045 \do\,{\mathbin{}\url@apa@comma }%
3046 \do\-{\mathbin{}\url@apa@hyphen }%
3047 \do\?{\mathbin{}\url@apa@questionmark }%
3048 \do\!{\mathbin{}\url@apa@exclamation }%
3049 \do\_{\mathbin{}\url@apa@underscore }%
3050 \do\ {\Url@space}\do\%{\Url@percent}\do\^^M{\Url@space}%
3051 \Url@force@Tilde}%
3052 \def\Url@OTnonTT{\do\<{\langle}\do\>{\mathbin{\rangle}}\do
3053 \_{\mathbin{}\_}\do\|{\mid}\do\{{\lbrace}\do\}{\mathbin{\rbrace}}\do
3054 \\{\mathbin{\backslash}}\UrlTildeSpecial}
3055 }
3056
3057 % \end{macrocode}
3058 %
3059 % We now embed the Creative Commons licence information in the PDF using an XMP
3060 % packet. In order to avoid a bug whereby Adobe Acrobat confuses the XMP author
3061 % information and the regular author information, though, we \emph{only} embed
3062 % the licence information. We can use \pkg{hyperxmp} for this, but we have to
3063 % discard the information collected by that package and construct our own
3064 % packet.
3065 %
3066 % \begin{macrocode}
3067 \RequirePackage{hyperxmp}
3068 \hypersetup{keeppdfinfo}
3069 \def\cc@xmp@packet{}
3070 \def\hyxmp@construct@packet{%
3071 \let\hyxmp@xml\cc@xmp@packet
3072 }
3073 % \end{macrocode}
3074 %
3075 % We need to make sure that any characters to appear verbatim in the XMP packet
3076 % are treated as ordinary characters and not active ones. The likely active
3077 % characters are symbols and punctuation, so should be treated as `other'
3078 % (category 12).
3079 %
3080 % \begin{macrocode}
3081 \begingroup
3082 \catcode`\"=12
3083 \catcode`\&=12
3084 \catcode`\#=12
3085 \catcode`\<=12
3086 \catcode`\>=12
3087 \catcode`\_=12
3088 % \end{macrocode}
3089 %
3090 % We construct the XMP packet as the document begins.
3091 %
3092 % \begin{macrocode}
3093 \AtBeginDocument{%
3094 % \end{macrocode}
3095 %
3096 % \begin{macro}{sp}
3097 % For convenience we define \cs{sp} to be a level of indent, translating to three
3098 % spaces.
3099 %
3100 % \begin{macrocode}
3101 \def\sp{\space\space\space}
3102 % \end{macrocode}
3103 % \end{macro}
3104 %
3105 % The text of the XMP packet is recorded in \cs{cc@xmp@packet}. We use |^^J| to
3106 % break lines.
3107 %
3108 % \begin{macrocode}
3109 \long\gdef\cc@xmp@packet{%
3110 <?xpacket begin="\hyxmp@bom" id="W5M0MpCehiHzreSzNTczkc9d"?>^^J%
3111 <x:xmpmeta xmlns:x='adobe:ns:meta/'>^^J%
3112 <rdf:RDF xmlns:rdf='http://www.w3.org/1999/02/22-rdf-syntax-ns#'>^^J%
3113 \sp<rdf:Description rdf:about=''^^J%
3114 \sp\sp xmlns:xapRights='http://ns.adobe.com/xap/1.0/rights/'>^^J%
3115 \sp\sp<xapRights:Marked>True</xapRights:Marked>^^J%
3116 \sp</rdf:Description>^^J%
3117 \sp<rdf:Description rdf:about=''^^J%
3118 \sp\sp xmlns:dc='http://purl.org/dc/elements/1.1/'>^^J%
3119 \sp\sp<dc:rights>^^J%
3120 \sp\sp\sp<rdf:Alt>^^J%
3121 \sp\sp\sp\sp<rdf:li xml:lang='x-default'>This work is licensed under a Creative Commons Attribution 4.0 International Licence.</rdf:li>^^J%
3122 \sp\sp\sp</rdf:Alt>^^J%
3123 \sp\sp</dc:rights>^^J%
3124 \sp</rdf:Description>^^J%
3125 \sp<rdf:Description rdf:about=''^^J%
3126 \sp\sp xmlns:cc='http://creativecommons.org/ns#'>^^J%
3127 \sp\sp<cc:license rdf:resource='http://creativecommons.org/licenses/by/4.0/'/>^^J%
3128 \sp</rdf:Description>^^J%
3129 </rdf:RDF>^^J%
3130 </x:xmpmeta>^^J%
3131 \hyxmp@padding
3132 <?xpacket end="w"?>^^J%
3133 }%
3134 }
3135 \endgroup
3136 % \end{macrocode}
3137 % \iffalse
3138 %</base>
3139 % \fi
3140 %\Finale