From 86d33d1d16a82cc9c5b312cebd16f786cfd8b3bd Mon Sep 17 00:00:00 2001
From: Edward Longman <el7g15@soton.ac.uk>
Date: Mon, 28 Jan 2019 18:13:41 +0000
Subject: [PATCH] Add new helpful guide and table describing document parts.

---
 ECS.bib          |  8 ++++++++
 Introduction.tex |  4 ++--
 README.tex       |  3 ++-
 Starting.tex     | 28 ++++++++++++++++++++++++++--
 elencopar.tex    | 22 ++++++++++++++++++++++
 5 files changed, 60 insertions(+), 5 deletions(-)
 create mode 100644 elencopar.tex

diff --git a/ECS.bib b/ECS.bib
index 9856c25..cd6f7ea 100644
--- a/ECS.bib
+++ b/ECS.bib
@@ -36,3 +36,11 @@
   month = {August},
   year = {2017}
 }
+@electronic{latex_moril,
+  author = {Lapo F. Mori},
+  title = {Writing a thesis with LaTeX},
+  url = {https://tug.org/pracjourn/2008-1/mori/},
+  month = {December},
+  year = {2008},
+  journal = {The PracTeX Journal}
+}
diff --git a/Introduction.tex b/Introduction.tex
index 1910790..e1ec42c 100644
--- a/Introduction.tex
+++ b/Introduction.tex
@@ -33,8 +33,8 @@ It is recommended to take a little time out to learn how to use \LaTeX{} by crea
 \url{http://www.LaTeXTemplates.com}\\
 Making the effort now means you're not stuck learning the system when what you \emph{really} need to be doing is writing your thesis.
 
-For best practice information and how to write a large \LaTeX{} document (a~thesis perhaps..?) then an excellent source is \url{https://web.science.mq.edu.au/~rdale/resources/writingnotes/}.
-This is a plain to read guide that will cover things you perhaps haven't thought of but probably should.
+For best practice information and how to write a large \LaTeX{} document (a~thesis perhaps..?) then two excellent sources are \href{https://web.science.mq.edu.au/~rdale/resources/writingnotes/}{Robert Dale's Writing Advice for Student} and \href{https://tug.org/pracjourn/2008-1/mori/mori.pdf}{Writing a thesis with \LaTeX{}}(Ch. 2 and 4 onwards)
+These are plain to read guides that will cover things you perhaps haven't thought of but probably should.
 It will help you to achieve consistency in your \LaTeX{} markup and make sure your documents are well formatted and easy to maintain.
 
 \subsection{A Short Math Guide for \LaTeX{}}
diff --git a/README.tex b/README.tex
index 482b7ed..3191bc8 100644
--- a/README.tex
+++ b/README.tex
@@ -22,7 +22,8 @@ Thesis Output.}
 %%\doi{10.1002/0470841559.ch1}
 \subject    {}
 \keywords   {}
-
+%% --Special Environment for matter_arrangement diagram
+\include{elencopar}
 \begin{document}
 \pagenumbering{gobble} % removes page number
 %%\copyrightDeclaration{} % !!! Comment this line when printing the hardcopy although it does not affect you page numbering!!!
diff --git a/Starting.tex b/Starting.tex
index 6e060e3..650bfbb 100644
--- a/Starting.tex
+++ b/Starting.tex
@@ -38,8 +38,32 @@ These files are designed as a starting point for the structure of your thesis.
 If you are familiar with \LaTeX{}, go and explore the template and use it. Maybe start with putting your info in the section \emph{THESIS/DOC INFORMATION} block of the \verb|Thesis.tex| or \verb|Progress.tex| file. You can then modify the rest of this file to your unique specifications based on your degree/university. If you are new to \LaTeX{} then read about the file structure below.
 
 \section{File Structure}
-The \verb|Thesis.tex| file is composed of two main parts.
-Firstly, \verb|frontmatter| is all the information that goes before your \verb|mainmatter|.
+The \verb|Thesis.tex| file is composed of three main parts.
+Firstly, \verb|frontmatter|, \verb|mainmatter|, \verb|backmatter| as in Figure~\ref{matter_arrangement}
+\begin{figure}[b]\caption{Separation of document content within thesis. Modified from \citet[p.~5]{latex_moril}. The symbol *
+indicates optional sections and $^\circ$ indicates sections that should
+not be in the table of contents.}\label{matter_arrangement}
+\begin{elencopar}{frontmatter}
+    \item Title page$^\circ$%
+    \item Abstract*$^\circ$%
+    \item Table of contents
+    \item Other lists$^\circ$%
+    \item Definitions and Abbreviations*%
+    \item Acknowledgements*$^\circ$
+    \item Dedication*$^\circ$%
+\end{elencopar} \\[\spacez]
+%
+\begin{elencopar}{mainmatter}
+    \item Inner chapters
+    \item Appendices*%
+\end{elencopar} \\[\spacez]
+%
+\begin{elencopar}{backmatter}
+    \item Bibliography%
+    \item Glossary*%
+    \item Index*%
+\end{elencopar}
+\end{figure}
 
 It is advisable to write each chapter (and possibly section) in a separate file to 
 keep each file of a manageable size.
diff --git a/elencopar.tex b/elencopar.tex
new file mode 100644
index 0000000..12ff216
--- /dev/null
+++ b/elencopar.tex
@@ -0,0 +1,22 @@
+%% --Special Environment for lists with spanning parentheses.
+\newlength\spacez
+\setlength\spacez{\itemsep}%
+\addtolength\spacez{\parsep}
+
+
+\newsavebox{\tbox}
+\newlength{\altezz}
+\newcommand{\elencoarg}{}
+\newenvironment{elencopar}[1]
+{\renewcommand{\elencoarg}{#1} \noindent\begin{lrbox}{\tbox}
+    \begin{minipage}[c]{.50\textwidth}\raggedright
+       \begin{itemize}}
+{\end{itemize}
+\end{minipage}
+\end{lrbox}%
+\setlength{\altezz}{1\ht\tbox}%
+\addtolength\altezz{0.5\itemsep}%
+\parbox{.50\textwidth}{\usebox{\tbox}}
+\parbox{.3\textwidth}{$\left.\rule{0pt}{\altezz}\right\}$ \elencoarg}}
+
+%% --end special environment
-- 
GitLab