From 06f77bb1fa8f9660a11edc1563617e4092c26225 Mon Sep 17 00:00:00 2001
From: Marcel <marcel@ru.is>
Date: Fri, 25 Oct 2024 09:36:10 +0000
Subject: [PATCH] Allow the official RU cover page to be included.

The communication department wants to have a unified look. They
provide a unified cover page in Indesign. Add a small package
that prepends a pdf to the document. This method should address the
requirements of our communication departments.

The current drawback of this method is that the cover page is in
A4 on A4 stock. We also need a B5 version if the thesis will be
trimmed to B5 stock.
---
 instructions.tex | 13 +++++++++++++
 rucover.sty      | 23 +++++++++++++++++++++++
 2 files changed, 36 insertions(+)
 create mode 100644 rucover.sty

diff --git a/instructions.tex b/instructions.tex
index 8d3c0d7..738c3fe 100644
--- a/instructions.tex
+++ b/instructions.tex
@@ -46,6 +46,19 @@ On debian based systems, you will need to install the \verb|texlive-luatex| pack
   In the \path{main.tex}, uncomment the package line near the top: \path{\usepackage{apacite}}, then go to the bottom of the file and comment out the: \path{\bibliographystyle{IEEEtran/bibtex/ieeetran}}
 \end{itemize}
 
+\section{Coverpage}
+
+Reykjavik University's communications department insists on a common outer appearance of all our theses.
+This class supports their desire through the \texttt{rucover} package.
+To generate a conforming cover page, follow the instructions at
+\url{https://en.ru.is/media/skjol-td/Instructions_2020.pdf}, enter the relevant information into \url{https://en.ru.is/media/skjol-td/TD_E-cover_2019.pdf} and save the file as \texttt{cover.pdf}.
+Place \texttt{cover.pdf} into the same directory that you have your thesis' main file.
+
+\LaTeX{} includes the file automatically if you add \texttt{\textbackslash usepackage\{rucover\}} to your preamble.
+You can control the filename with \texttt{\textbackslash usepackage[filename=name.pdf]\{rucover\}}.
+
+
+
 \section{Files and Directories/Folders}
 \begin{itemize}
 %\item \path{cls/}: contains the \path{rureport.cls} template used to format these instructions.
diff --git a/rucover.sty b/rucover.sty
new file mode 100644
index 0000000..0afa9b6
--- /dev/null
+++ b/rucover.sty
@@ -0,0 +1,23 @@
+% Marcel Kyas <marcel at ru.is>
+%
+% Simple hack to place the cover page in front of the thesis
+
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{rucover}[2024/10/24]
+
+\providecommand\rucover{cover.pdf}
+\RequirePackage{xkeyval}
+\DeclareOptionX{filename}{\def\rucover{#1}}
+\ProcessOptionsX
+
+\IfFileExists{\rucover}{%
+	\RequirePackage{pdfpages}
+	\AtBeginDocument{%
+		\pagestyle{empty}%
+		\includepdf{cover.pdf}%
+		\pagestyle{empty}%
+		\clearforchapter%
+	}%
+}{%
+	\typeout{Cover page file \rucover not found}
+}