document hypersetup package

doc/wrappers/hypersetup/.latexmkrc

@@ -0,0 +1,4 @@
+$makeindex = "makeindex -s gind.ist %O -o %D %S";
+$clean_ext .= ' glo';
+$clean_ext .= ' hd';
+$clean_ext .= ' ins';

doc/wrappers/hypersetup/Makefile

@@ -0,0 +1,8 @@
+doc:
+	latexmk
+
+full:
+	latexmk -gg
+
+clean:
+	latexmk -C

doc/wrappers/hypersetup/hypersetup.tex

@@ -0,0 +1,52 @@
+\documentclass[full]{l3doc}
+
+\usepackage{mkessler-hypersetup}
+
+\title{The \pkg{mkessler-hypersetup} package}
+\author{Maximilian Ke\ss ler}
+
+\begin{document}
+
+\maketitle
+
+\begin{abstract}
+  This is just a quick wrapper around the \pkg{hyperref} package
+  and - optionally - the cleveref package.
+\end{abstract}
+
+\begin{documentation}
+
+\section{Usage}
+
+The package provides one option: \texttt{cleveref}.
+When given, \pkg{cleveref} is also loaded.
+
+The package loads \pkg{hyperref} at the end of the preamble,
+and (optionally), \pkg{cleveref} afterwards.
+This ensures proper loading order of these packages.
+
+Additionally, we provide some default settings
+that are shown in \autoref{tab:hyperref-values}.
+
+\begin{table}[htpb]
+  \centering
+  \begin{tabular}{c | c}
+  Key  & Value \\
+  \hline
+  colorlinks & none \\
+  citecolor & violet \\
+  urlcolor & blue!80!black \\
+  linkcolor & red!50!black \\
+  pdftitle & \cs{@course} if defined, else \cs{@title} \\
+  pdfauthor & \cs{@author}
+  \end{tabular}
+  \caption{Hyperref values set by \pkg{mkessler-hypersetup}}
+  \label{tab:hyperref-values}
+\end{table}
+
+
+
+\end{documentation}
+
+
+\end{document}