layout

Jakob Voss authored
revision cfdc42cddf447d3f30ada5fe076649715482e1f0
layout/template
\documentclass[
a5paper,pagesize,
10pt,
DIV=12, % Seitenspiegel
BCOR=2mm,
open=any, % Kapitel sowohl links als auch rechts beginnen
ngerman
]{scrbook}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage{amssymb,amsmath}
\usepackage{ifxetex,ifluatex}
\usepackage{fixltx2e} % wegen \textsubscript
% use upquote if available, for straight quotes in verbatim environments
\IfFileExists{upquote.sty}{\usepackage{upquote}}{}
\ifnum 0\ifxetex 1\fi\ifluatex 1\fi=0 % if pdftex
\usepackage[utf8]{inputenc}
$if(euro)$
\usepackage{eurosym}
$endif$
\else % if luatex or xelatex
\usepackage{fontspec}
\ifxetex
\usepackage{xltxtra,xunicode}
\fi
\defaultfontfeatures{Mapping=tex-text,Scale=MatchLowercase}

ewcommand{\euro}{€}
$if(mainfont)$
\setmainfont{$mainfont$}
$endif$
$if(sansfont)$
\setsansfont{$sansfont$}
$endif$
$if(monofont)$
\setmonofont{$monofont$}
$endif$
$if(mathfont)$
\setmathfont{$mathfont$}
$endif$
\fi



% use microtype if available
\IfFileExists{microtype.sty}{\usepackage{microtype}}{}
$if(geometry)$
\usepackage[$for(geometry)$$geometry$$sep$,$endfor$]{geometry}
$endif$

$if(natbib)$
\usepackage{natbib}
\bibliographystyle{plainnat}
$endif$
$if(biblatex)$
\usepackage{biblatex}
$if(biblio-files)$
\bibliography{$biblio-files$}
$endif$
$endif$
$if(listings)$
\usepackage{listings}
$endif$
$if(lhs)$
\lstnewenvironment{code}{\lstset{language=Haskell,basicstyle=\small\ttfamily}}{}
$endif$
$if(highlighting-macros)$
$highlighting-macros$
$endif$
$if(verbatim-in-note)$
\usepackage{fancyvrb}
$endif$
$if(tables)$
\usepackage{longtable}
$endif$

% Kopf- und Fußzeile
\usepackage{scrpage2}
\pagestyle{scrheadings}
\clearscrheadfoot
\setkomafont{pageheadfoot}{¶
ormalfont}
\renewcommand*{\chaptermarkformat}{}
\lefoot[\pagemark]{\pagemark\,\textsf{\enspace\,\textbar\enspace\,\headmark}}
\rofoot[\pagemark]{\textsf{\headmark\enspace\,\textbar\enspace\,}\pagemark}

% TODO: chaptermark auch bei unnumbered-Kapitel (Vorwort & Anhänge) setzen

% Kein Abstand vor Kapitelüberschriften
\renewcommand{\chapterheadstartvskip}{\vspace*{-\baselineskip}}
\renewcommand{\chapterheadendvskip}{\vspace*{0.5\baselineskip}}

% Abstände von section und subsection auf basis von scrbook ändern
\makeatletter
\renewcommand{\subsection}{\@startsection{subsection}{2}{\z@}%
{0.5\baselineskip}%
{0.1\baselineskip}%
{\ifnum \scr@compatibility>\@nameuse{scr@v@2.96}\relax
\setlength{\parfillskip}{\z@ plus 1fil}\fi
\raggedsection¶
ormalfont\sectfont¶
obreak\size@subsection
}%
}
\renewcommand{\section}{\@startsection{section}{1}{\z@}%
{1\baselineskip}%
{0.5\baselineskip}%
{\ifnum \scr@compatibility >\@nameuse {scr@v@2.96}\relax
\setlength {\parfillskip}{\z@ plus 1fil}\fi
\raggedsection¶
ormalfont\sectfont¶
obreak\size@section
}%
}
\makeatother

% Listen
\usepackage{enumitem}
\renewcommand{\labelitemi}{--}
\setlist[itemize,1]{leftmargin=2em}
\setlist[enumerate,1]{leftmargin=2em}

% Interner Link mit Pfeil mittels \shortrightarrow
\usepackage{stmaryrd}

ewcommand{\internallinkarrow}{\rotatebox[origin=c]{45}{$$\shortrightarrow$$}}

% Bilder
\usepackage{graphicx}
% We will generate all images so they have a width \maxwidth. This means
% that they will get their normal width if they fit onto the page, but
% are scaled down if they would overflow the margins.
\makeatletter
\def\maxwidth{\ifdim\Gin@nat@width>\linewidth\linewidth
\else\Gin@nat@width\fi}
\makeatother
\let\Oldincludegraphics\includegraphics
\renewcommand{\includegraphics}[1]{\Oldincludegraphics[width=\maxwidth]{#1}}

% Merkbox
% TODO: Hintergrund heller ?
% TODO: Icon/Ecken
% Siehe https://tex.stackexchange.com/questions/63752/colored-frame-for-the-framed-environment
\usepackage{framed}
\usepackage{xcolor}
\definecolor{merkboxrahmen}{RGB}{253,243,237}
\definecolor{merkboxhintergrund}{RGB}{244,207,180}

ewenvironment{merkbox}%
{\def\FrameCommand{\fboxsep=\FrameSep\fcolorbox{merkboxrahmen}{merkboxhintergrund}}%
\MakeFramed{\advance\hsize-\width \FrameRestore}}
{\endMakeFramed}

% Links
\usepackage[setpagesize=false, % page size defined by xetex
unicode=false, % unicode breaks when used with xetex
xetex]{hyperref}

% PDF-Einstellungen
\hypersetup{breaklinks=true,
bookmarks=true,
pdfauthor={$author-meta$},
pdftitle={$title-meta$},
colorlinks=true,
urlcolor=$if(urlcolor)$$urlcolor$$else$blue$endif$,
linkcolor=$if(linkcolor)$$linkcolor$$else$magenta$endif$,
pdfborder={0 0 0}}
\urlstyle{same} % don't use monospace font for urls

% Externe Links als Fußnote

ewcommand{\hreffn}[2]{#2\footnote{\url{#1}}}

% Fußnoten fortlaufend
\usepackage{remreset}
\makeatletter
\@removefromreset{footnote}{chapter}
\makeatother

% Interne Links mit Pfeil davor
\let\orighyperref\hyperref
\renewcommand{\hyperref}[2][\mylabel]{%
\def\mylabel{#2}%
\orighyperref[#1]{\internallinkarrow\,#2}%
}

$if(strikeout)$
\usepackage[normalem]{ulem}
% avoid problems with \sout in headers with hyperref:
\pdfstringdefDisableCommands{\renewcommand{\sout}{}}
$endif$
\setlength{\parindent}{0pt}
\setlength{\parskip}{6pt plus 2pt minus 1pt}
\setlength{\emergencystretch}{3em} % prevent overfull lines
$if(numbersections)$
\setcounter{secnumdepth}{5}
$else$
\setcounter{secnumdepth}{0}
$endif$
$if(verbatim-in-note)$
\VerbatimFootnotes % allows verbatim text in footnotes
$endif$

% Neue Deutsche Rechtschreibung
\ifxetex
\usepackage{polyglossia}
\setmainlanguage{ngerman}
\else
\usepackage[ngerman]{babel}
\fi

% Abbildungen durchgängig nummerieren
\usepackage{chngcntr}
\counterwithout{figure}{chapter}
\renewcommand\figurename{Abb.}

$for(header-includes)$
$header-includes$
$endfor$

\title{$title$}
\author{$for(author)$$author$$sep$ \and $endfor$}
\date{$date$}

\begin{document}
\maketitle
% Schmutztitel
\maketitle

% TODO: Hauptsachtitel
\thispagestyle{empty}
\begin{center}

\textbf{Normdaten in Wikidata}

Handbuch

...Liste der Autoren...

Hannover, 2014
\end{center}

% Rückseite des Hauptsachtitel
\pagebreak
\thispagestyle{empty}

\vfill
... (CC, ISBN etc.)


$if(commit-date)$Letzte Änderung: $commit-date$.$endif$

$if(build-date)$Erstellungszeit: $build-date$.$endif$

$for(include-before)$
$include-before$

$endfor$
$if(toc)$
% Motto/Widmung
\pagebreak
\thispagestyle{empty}

\vspace{3cm}
\textit{hier ein Motto}


{
\hypersetup{linkcolor=black}
\setcounter{tocdepth}{$toc-depth$}
\renewcommand{\contentsname}{Inhaltsverzeichnis}
\renewcommand{\listfigurename}{Abbildungsverzeichnis}
\tableofcontents
\listoffigures
%\listoftables
}
$endif$
$body$

$if(natbib)$
$if(biblio-files)$
$if(biblio-title)$
$if(book-class)$
\renewcommand\bibname{$biblio-title$}
$else$
\renewcommand\refname{$biblio-title$}
$endif$
$endif$
\bibliography{$biblio-files$}

$endif$
$endif$
$if(biblatex)$
\printbibliography$if(biblio-title)$[title=$biblio-title$]$endif$

$endif$

$for(include-after)$
$include-after$

$endfor$
\end{document}
ueber-dieses-handbuch
# Über dieses Handbuch {.unnumbered}

Der Inhalt mit allen Bearbeitungsschritten dieses Handbuchs stehen in einem
git-Repository
gesamte Inhalt dieses Handbuchs steht unter
sowie
unter zur
Verfügung. Ein git-Repository ist ein Verzeichnis von Dateien das alle
Änderungen beinhaltet, die an den Dateien vorgenommen wurde
als git-Repository
zur Verfügung
. Das Repository
enthält alle Ausgangsdateien (Texte, Bilder und
Layoutanweisungen) sowie, Änderungen und einige
Skripte zur Erstellung der [HTML- und
PDF-Ausgaben](http://hshdb.github.io/normdaten-in-wikidata/). Die Repository-Datei
`README.md` enthält weitere Hinweise zur technischen
Umsetzung.

Die Weiternutzung aller Inhalte ist unter den Bedingungen der [CC-BY-SA
Lizenz](https://creativecommons.org/licenses/by-sa/4.0/deed.de) erlaubt. Wenn
möglich sollte dafür das git-Repository weitergeführt werden (in der
git-Terminologie als "Fork" bezeichnet), so dass Korrekturen und Erweiterungen
leichter zurückfliessen können. Für Kommentare und Korrekturen können die
enstsprechenden Funktionen [bei
Penflip](https://www.penflip.com/nichtich/normdaten-in-wikidata/discussions)
und [bei GitHub](https://github.com/hshdb/normdaten-in-wikidata/issues)
verwendet werden.

Zur Erstellung des Handbuchs wurden im Wesentlichen folgende Werkzeuge verwendet:

* Penflip (<https://penflip.com>) als Plattform zum gemeinsamen Schreiben
* Pandoc (<http://johnmacfarlane.net/pandoc/>) um aus dem Text das Buch als
HTML- und PDF-Datei zu erzeugen
* Trello (<https://trello.com>) zum Projektmanagement
* GitHub (<https://github.com>) zum Hosting des Repository und des fertigen Buchs
* Annotator (<https://annotatorjs.org>) zum Korrekturlesen

Eine Übersicht über das Projekt zur Erstellung dieses Handbuchs gibt ein
Erfahrungsbericht mit dem Tit
gibt der Artikel "Collaborative creation of a
Wikidata
handbook", der auf der für die OpenSym 2014 Konferenz vorgestellt werden soll.