summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/sapthesis
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/sapthesis
Initial commit
Diffstat (limited to 'macros/latex/contrib/sapthesis')
-rw-r--r--macros/latex/contrib/sapthesis/README101
-rw-r--r--macros/latex/contrib/sapthesis/examples/LaureaMagistrale_eng.tex216
-rw-r--r--macros/latex/contrib/sapthesis/examples/LaureaMagistrale_ita.tex221
-rw-r--r--macros/latex/contrib/sapthesis/examples/Laurea_ita.tex218
-rw-r--r--macros/latex/contrib/sapthesis/examples/Master.tex219
-rw-r--r--macros/latex/contrib/sapthesis/examples/PhD.tex221
-rw-r--r--macros/latex/contrib/sapthesis/examples/Specialization.tex220
-rw-r--r--macros/latex/contrib/sapthesis/examples/TFA.tex229
-rw-r--r--macros/latex/contrib/sapthesis/sapienza-MLblack-pos.pdfbin0 -> 16817 bytes
-rw-r--r--macros/latex/contrib/sapthesis/sapienza-MLred-pos.pdfbin0 -> 16467 bytes
-rw-r--r--macros/latex/contrib/sapthesis/sapthesis-doc.pdfbin0 -> 233337 bytes
-rw-r--r--macros/latex/contrib/sapthesis/sapthesis-doc.tex649
-rw-r--r--macros/latex/contrib/sapthesis/sapthesis.bst1778
-rw-r--r--macros/latex/contrib/sapthesis/sapthesis.cls1208
-rw-r--r--macros/latex/contrib/sapthesis/sapthesis.layout7
15 files changed, 5287 insertions, 0 deletions
diff --git a/macros/latex/contrib/sapthesis/README b/macros/latex/contrib/sapthesis/README
new file mode 100644
index 0000000000..a3abe94360
--- /dev/null
+++ b/macros/latex/contrib/sapthesis/README
@@ -0,0 +1,101 @@
+*********************************************************************
+* sapthesis class *
+*********************************************************************
+
+ This is the README file of the "sapthesis" LaTeX class.
+ Official web page:
+ http://biccari.altervista.org/c/informatica/latex/sapthesis.php
+
+
+
+** License **********************************************************
+
+ Copyright (c) 2008-2018 by Francesco Biccari.
+
+ This work (specified below) may be distributed and/or
+ modified under the conditions of the
+ LaTeX Project Public License,
+ either version 1.3 of this license or any later version.
+ The latest version of this license is in
+ http://www.latex-project.org/lppl.txt
+ and version 1.3 or later is part of all distributions of
+ LaTeX version 2005/12/01 or later.
+
+ This work has the LPPL maintenance status 'maintained'.
+ The Current Maintainer of this work is Francesco Biccari.
+
+ The "Sapienza - University of Rome" logo is a registered
+ trademark of "Sapienza" university. The logo can be used
+ only according to the "Protocollo per l'uso del
+ marchio/logotipo e del sistema di identità visiva della
+ Sapienza" document available, with other information,
+ at the following link (in italian):
+ https://www.uniroma1.it/it/pagina/marchio-identita-visiva-e-sistema-grafico
+ In particular it can be used in the theses of "Sapienza"
+ university without explicit authorization.
+
+
+
+** Class information ************************************************
+
+ Sapthesis is a LaTeX class to typeset theses that adhere to
+ "Sapienza - University of Rome"'s guidelines for publishing.
+ The supported types of theses are: Laurea, LaureaMagistrale,
+ Dottorato di Ricerca, Master di primo livello, Master di
+ secondo livello, TFA, Specializzazione.
+
+ It is compatible with two compilation methods:
+ pdflatex and xelatex.
+
+ The documentation is provided in the file sapthesis-doc.pdf.
+
+ The version number of this class is reported at the top of the
+ class file sapthesis.cls and in the pdf manual
+ sapthesis-doc.pdf.
+
+
+
+** Installation instruction *****************************************
+
+ Sapthesis can be installed in 3 different ways:
+
+ 1. The simplest way to install sapthesis is by the package manager
+ of your TeX distribution (TeX Live, MiKTeX or MacTeX).
+
+ 2. Instead, if you want to install sapthesis manually, you have to
+ download the sapthesis.zip archive from CTAN or, better, from
+ the official sapthesis website
+ http://biccari.altervista.org/c/informatica/latex/sapthesis.php
+
+ The sapthesis.zip archive contains:
+
+ 1. sapthesis.cls (main file)
+ 2. sapthesis-doc.pdf (manual of sapthesis.cls)
+ 3. sapthesis-doc.tex (source of the manual)
+ 4. README (this file)
+ 5. sapienza-MLred-pos.pdf (red university logo)
+ 6. sapienza-MLblack-pos.pdf (black university logo)
+ 7. examples folder with several examples of usage
+ 8. sapthesis.bst (an english BibTeX style)
+ 9. sapthesis.layout (sapthesis layout file for LyX)
+
+ You can simply copy sapthesis.cls and sapthesis.bst
+ together with sapienza-MLred-pos.pdf and
+ sapienza-MLblack-pos.pdf into your local work directory where
+ your thesis files will live.
+
+ 3. The last possibility is copying the files of Sapthesis
+ (discussed in the previous point) into your texmf tree
+ (or your localtexmf tree) at these locations:
+
+ <texmf>/tex/latex/sapthesis/sapthesis.cls
+ <texmf>/tex/latex/sapthesis/sapienza-MLred-pos.pdf
+ <texmf>/tex/latex/sapthesis/sapienza-MLblack-pos.pdf
+ <texmf>/doc/latex/sapthesis/sapthesis-doc.pdf
+ <texmf>/doc/latex/sapthesis/sapthesis-doc.tex
+ <texmf>/doc/latex/sapthesis/examples/*.tex
+ <texmf>/doc/latex/sapthesis/README
+ <texmf>/bibtex/bst/sapthesis/sapthesis.bst
+ <texmf>/doc/latex/sapthesis/sapthesis.layout
+
+ Then, you need to update the file database.
diff --git a/macros/latex/contrib/sapthesis/examples/LaureaMagistrale_eng.tex b/macros/latex/contrib/sapthesis/examples/LaureaMagistrale_eng.tex
new file mode 100644
index 0000000000..363702f64e
--- /dev/null
+++ b/macros/latex/contrib/sapthesis/examples/LaureaMagistrale_eng.tex
@@ -0,0 +1,216 @@
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = en_US
+
+\documentclass[LaM,binding=0.6cm]{sapthesis}
+
+\usepackage{microtype}
+
+\usepackage{hyperref}
+\hypersetup{pdftitle={Usage example of the Sapthesis class for a Laurea Magistrale thesis in English},pdfauthor={Francesco Biccari}}
+
+% Remove in a normal thesis
+\usepackage{lipsum}
+\usepackage{curve2e}
+\definecolor{gray}{gray}{0.4}
+\newcommand{\bs}{\textbackslash}
+
+% Commands for the titlepage
+\title{Usage example of the Sapthesis class\\ for a Laurea Magistrale thesis in English}
+\author{Francesco Biccari}
+\IDnumber{1234567}
+\course{Fisica}
+\courseorganizer{Facolt\`{a} di Scienze Matematiche, Fisiche e Naturali}
+\AcademicYear{2012/2013}
+\copyyear{2013}
+\advisor{Prof. Nome Cognome}
+\advisor{Dr. Nome Cognome}
+\coadvisor{Dr. Nome Cognome}
+\authoremail{biccari@email.com}
+
+\examdate{16 April 2013}
+\examiner{Prof. Nome Cognome}
+\examiner{Prof. Nome Cognome}
+\examiner{Dr. Nome Cognome}
+\versiondate{\today}
+
+
+
+\begin{document}
+
+\frontmatter
+
+\maketitle
+
+\dedication{Dedicated to\\ Donald Knuth}
+
+\begin{abstract}
+This document is an example which shows the main features of
+the \LaTeXe\ class \texttt{sapthesis.cls} developed by Francesco Biccari
+with the help of GuIT (Gruppo Utilizzatori Italiani di \TeX).
+\end{abstract}
+
+\begin{acknowledgments}
+Ho deciso di scrivere i ringraziamenti in italiano
+per dimostrare la mia gratitudine verso i membri
+del GuIT, il Gruppo Utilizzatori Italiani di \TeX, e, in particolare,
+verso il prof. Enrico Gregorio.
+\end{acknowledgments}
+
+\tableofcontents
+
+% Do not use the starred version of the chapter command!
+\chapter{Capitolo non numerato}
+
+In this manual you can skip the gray text because it is just dummy text.%
+\footnote{This is a footnote.}
+
+\textcolor{gray}{\lipsum[1-22]}
+
+
+\section*{Paragrafo non numerato}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum[1-22]}
+
+
+
+
+\mainmatter
+
+\chapter{Style features of \textsf{sapthesis}}
+
+In this chapter I will discuss my stylistic choices of \textsf{sapthesis}.
+I will show the page layout geometry and I will describe the page style.
+
+\section{Page layout}
+
+The page is fixed at the dimensions of an A4 paper, therefore you have to print your thesis on A4 paper to obtain the best results. The font dimension is fixed at 11\, pt. The text column and the margins are chosen to fill to the best an A4 paper while keeping a reasonable line length (396\, pt) for a good readability. The text height and the text width are in golden ratio (\textasciitilde 1.6180) as well as the outer and inner margins in a two-side document after binding margin removal. Also the top margin (excluding the header) and bottom margin are in the golden ratio. In Fig.~\ref{layout} a sketch of the \textsf{sapthesis} page layout is shown.
+
+\begin{figure}[h]
+\centering
+\setlength{\unitlength}{0.27mm}
+\begin{picture}(420,297)(-210,0)
+\polyline(-210,0)(210,0)(210,297)(-210,297)(-210,0)
+\Line(0,0)(0,297)
+\put(27.05,37.4){\polygon(0,0)(139.2,0)(139.2,223.8)(0,223.8)}
+\put(-27.05,37.4){\polygon(0,0)(-139.2,0)(-139.2,223.8)(0,223.8)}
+\put(27.05,268.16){\polygon(0,0)(139.2,0)(139.2,4.22)(0,4.22)}
+\put(-27.05,268.16){\polygon(0,0)(-139.2,0)(-139.2,4.22)(0,4.22)}
+\end{picture}
+\caption{Page layout scheme of \textsf{sapthesis class} using a zero binding margin.}
+\label{layout}
+\end{figure}
+
+
+\section{Page style}
+
+The captions have a smaller font respect to the text and the label is in boldface. The appearance of the margin notes has been improved.
+They have the same font dimension of the footnotes and are typed in italics.
+Moreover I defined a new command to typeset margin note aligned to the left on the right page and vice versa on the left page.
+Notice that if a binding margin greater than 1.5\, cm is used, the dimensions of the margin notes become too small and very ugly.
+Do not use them in this case.
+
+The mathematical objects, figures and tables are numbered within the chapters (e.g. 1.1, 1.2,\ldots for the first chapter, 2.1, 2.2 for the second one and so on\ldots). See for example the number of this simple equation
+\begin{equation}
+x_{1,2}=\frac{-b\pm\sqrt{b^2-4ac}}{2a}
+\end{equation}
+
+
+The title page is automatically composed when the \texttt{\bs maketitle} command is given.
+The parameters needed for the title page, author, title, etc\ldots , are supplied by dedicated commands explained in the next section.
+Two copies of the university logo in \texttt{pdf} format, one for color printing and the other one for black and white printing, are supplied in the \textsf{sapthesis} package. They are shown in Fig.~\ref{fig:largenenough}.
+
+\begin{figure}
+\centering
+\includegraphics[width=0.7\textwidth]{sapienza-MLred-pos}\\[3ex]
+\includegraphics[width=0.7\textwidth]{sapienza-MLblack-pos}
+\caption{Logo of the Sapienza -- University of Rome.}
+\label{fig:largenenough}
+\end{figure}
+
+
+
+\section{About figures and tables}
+
+As regards the image formats, please use vector images as much as possible! Use jpg images only for photographs! pdf\LaTeX\ supports the pdf, jpg and png formats.
+
+A very simple table is show in Tab.~\ref{tab:letters}. Remember to typeset
+always the table caption above the table. Do not use vertical lines.
+
+\begin{table}
+\caption{This is a simple table.}
+\label{tab:letters}
+\centering
+\begin{tabular}{lcc}
+\toprule
+Letter & Test & Test \\
+\midrule
+A & C & E \\
+B & D & F \\
+\bottomrule
+\end{tabular}
+\end{table}
+
+
+\section{A section}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum[1-10]}
+
+
+
+\section{Another section}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum}
+
+
+\appendix
+\chapter{Special commands provided by \textsf{sapthesis}}
+
+\textsf{Sapthesis} provides some special commands, particularly useful for scientific works. You can use for example the roman shape, instead of the italic, for the imaginary unit (\texttt{\bs iu}) and Napier's number (\texttt{\bs eu}):
+\begin{equation}
+\eu^{\iu\pi}+1=0
+\end{equation}
+
+There are also two commands to speed up the writing of derivatives. In the following example we have used the commands \texttt{\bs der} and \texttt{\bs pder}):
+\begin{equation}
+\der{f}{x} \qquad \pder{f}{*{2}{y}}
+\end{equation}
+
+
+\textsf{Sapthesis} provides also 4 commands to improve the writing of subscripts, \texttt{\bs rb} and \texttt{\bs tb}, and superscripts, \texttt{\bs rp} and \texttt{\bs tp}. Two of these commands, \texttt{\bs rb} and \texttt{\bs rp}, can be used both in text and in math mode and compose their argument in roman. The other two, \texttt{\bs tb} and \texttt{\bs tp}, can be used only in text mode and compose their argument as are. Here it is an usage example of \texttt{\bs rb} and \texttt{\bs rp}:
+\[
+a_b \neq a\rb{b}\qquad a^b \neq a\rp{b}
+\]
+And here it is an usage example of \texttt{\bs tb}: \emph{Cu\tb{It} indicates copper bought in Italy}. And a usage example of \texttt{\bs ts}: \emph{Cher G\tp{le} Napol\'eon}.
+
+
+Then several commands for the correct typesetting of unit of measurements are provided. For example the command \texttt{\bs un} typesets its argument in roman and leaves a thin space between the number and the unit: $25\un{m}$, $3.5\un{m/s}$. Other commands are: (\texttt{\bs g}) 45\g, (\texttt{\bs C}) 30\,\C, (\texttt{\bs A}) 12\,\A, (\texttt{\bs micro}) 40\,\micro m, (\texttt{\bs ohm}) 27\,\ohm.
+
+We have also \texttt{\bs x} as abbreviation of \texttt{\bs times}: \texttt{\$7 \bs x 10\^{}5\$} gives $7 \x 10^5$. Then \texttt{\bs di} is the differential symbol which automatically insert the correct spacing.
+\[
+\int x \di x
+\]
+
+Finally we have defined the color \textsf{sapred} which is the official color
+of Sapienza -- University of Rome. It is defined as RGB(130,36,51). \textcolor{sapred}{This text is written with the color \textsf{sapred}.}
+
+In the following dummy text you can observe the usage of \texttt{\bs mnote} command which typesets fancy margin notes.
+
+\textcolor{gray}{\lipsum}
+\marginpar{This is a fancy margin note!}
+\textcolor{gray}{\lipsum}
+
+\backmatter
+% bibliography
+%\cleardoublepage
+%\phantomsection
+%\bibliographystyle{sapthesis} % BibTeX style
+%\bibliography{bibliography} % BibTeX database without .bib extension
+
+\end{document}
diff --git a/macros/latex/contrib/sapthesis/examples/LaureaMagistrale_ita.tex b/macros/latex/contrib/sapthesis/examples/LaureaMagistrale_ita.tex
new file mode 100644
index 0000000000..425de42d61
--- /dev/null
+++ b/macros/latex/contrib/sapthesis/examples/LaureaMagistrale_ita.tex
@@ -0,0 +1,221 @@
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = it_IT
+
+\documentclass[LaM,binding=0.6cm]{../sapthesis}
+
+\usepackage{microtype}
+\usepackage[italian]{babel}
+\usepackage[utf8]{inputenc}
+%\input{ix-utf8enc.dfu}
+
+
+\usepackage{hyperref}
+\hypersetup{pdftitle={Esempio d'uso della classe Sapthesis per una tesi di Laurea Magistrale},pdfauthor={Francesco Biccari}}
+
+% Remove in a normal thesis
+\usepackage{lipsum}
+\usepackage{curve2e}
+\definecolor{gray}{gray}{0.4}
+\newcommand{\bs}{\textbackslash}
+
+% Commands for the titlepage
+\title{Esempio d'uso della classe Sapthesis\\
+per una tesi di Laurea Magistrale}
+\author{Francesco Biccari}
+\IDnumber{1234567}
+\course{Fisica}
+\courseorganizer{Facoltà di Scienze Matematiche, Fisiche e Naturali}
+\AcademicYear{2012/2013}
+\copyyear{2013}
+\advisor{Prof. Nome Cognome}
+\advisor{Dr. Nome Cognome}
+\coadvisor{Dr. Nome Cognome}
+\authoremail{biccari@email.com}
+
+\examdate{16 April 2013}
+\examiner{Prof. Nome Cognome}
+\examiner{Prof. Nome Cognome}
+\examiner{Dr. Nome Cognome}
+\versiondate{\today}
+
+
+
+\begin{document}
+
+\frontmatter
+
+\maketitle
+
+\dedication{Dedicato a\\ Donald Knuth}
+
+\begin{abstract}
+This document is an example which shows the main features of
+the \LaTeXe\ class \texttt{sapthesis.cls} developed by Francesco Biccari
+with the help of GuIT (Gruppo Utilizzatori Italiani di \TeX).
+\end{abstract}
+
+\begin{acknowledgments}
+Ho deciso di scrivere i ringraziamenti in italiano
+per dimostrare la mia gratitudine verso i membri
+del GuIT, il Gruppo Utilizzatori Italiani di \TeX, e, in particolare,
+verso il prof. Enrico Gregorio.
+\end{acknowledgments}
+
+\tableofcontents
+
+% Do not use the starred version of the chapter command!
+\chapter{Capitolo non numerato}
+
+In this manual you can skip the gray text because it is just dummy text.%
+\footnote{This is a footnote.}
+
+\textcolor{gray}{\lipsum[1-22]}
+
+
+\section*{Paragrafo non numerato}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum[1-22]}
+
+
+
+
+\mainmatter
+
+\chapter{Style features of \textsf{sapthesis}}
+
+In this chapter I will discuss my stylistic choices of \textsf{sapthesis}.
+I will show the page layout geometry and I will describe the page style.
+
+\section{Page layout}
+
+The page is fixed at the dimensions of an A4 paper, therefore you have to print your thesis on A4 paper to obtain the best results. The font dimension is fixed at 11\, pt. The text column and the margins are chosen to fill to the best an A4 paper while keeping a reasonable line length (396\, pt) for a good readability. The text height and the text width are in golden ratio (\textasciitilde 1.6180) as well as the outer and inner margins in a two-side document after binding margin removal. Also the top margin (excluding the header) and bottom margin are in the golden ratio. In Fig.~\ref{layout} a sketch of the \textsf{sapthesis} page layout is shown.
+
+\begin{figure}[h]
+\centering
+\setlength{\unitlength}{0.27mm}
+\begin{picture}(420,297)(-210,0)
+\polyline(-210,0)(210,0)(210,297)(-210,297)(-210,0)
+\Line(0,0)(0,297)
+\put(27.05,37.4){\polygon(0,0)(139.2,0)(139.2,223.8)(0,223.8)}
+\put(-27.05,37.4){\polygon(0,0)(-139.2,0)(-139.2,223.8)(0,223.8)}
+\put(27.05,268.16){\polygon(0,0)(139.2,0)(139.2,4.22)(0,4.22)}
+\put(-27.05,268.16){\polygon(0,0)(-139.2,0)(-139.2,4.22)(0,4.22)}
+\end{picture}
+\caption{Page layout scheme of \textsf{sapthesis class} using a zero binding margin.}
+\label{layout}
+\end{figure}
+
+
+\section{Page style}
+
+The captions have a smaller font respect to the text and the label is in boldface. The appearance of the margin notes has been improved.
+They have the same font dimension of the footnotes and are typed in italics.
+Moreover I defined a new command to typeset margin note aligned to the left on the right page and vice versa on the left page.
+Notice that if a binding margin greater than 1.5\, cm is used, the dimensions of the margin notes become too small and very ugly.
+Do not use them in this case.
+
+The mathematical objects, figures and tables are numbered within the chapters (e.g. 1.1, 1.2,\ldots for the first chapter, 2.1, 2.2 for the second one and so on\ldots). See for example the number of this simple equation
+\begin{equation}
+x_{1,2}=\frac{-b\pm\sqrt{b^2-4ac}}{2a}
+\end{equation}
+
+
+The title page is automatically composed when the \texttt{\bs maketitle} command is given.
+The parameters needed for the title page, author, title, etc\ldots , are supplied by dedicated commands explained in the next section.
+Two copies of the university logo in \texttt{pdf} format, one for color printing and the other one for black and white printing, are supplied in the \textsf{sapthesis} package. They are shown in Fig.~\ref{fig:largenenough}.
+
+\begin{figure}
+\centering
+\includegraphics[width=0.7\textwidth]{sapienza-MLred-pos}\\[3ex]
+\includegraphics[width=0.7\textwidth]{sapienza-MLblack-pos}
+\caption{Logo of the Sapienza -- University of Rome.}
+\label{fig:largenenough}
+\end{figure}
+
+
+
+\section{About figures and tables}
+
+As regards the image formats, please use vector images as much as possible! Use jpg images only for photographs! pdf\LaTeX\ supports the pdf, jpg and png formats.
+
+A very simple table is show in Tab.~\ref{tab:letters}. Remember to typeset
+always the table caption above the table. Do not use vertical lines.
+
+\begin{table}
+\caption{This is a simple table.}
+\label{tab:letters}
+\centering
+\begin{tabular}{lcc}
+\toprule
+Letter & Test & Test \\
+\midrule
+A & C & E \\
+B & D & F \\
+\bottomrule
+\end{tabular}
+\end{table}
+
+
+\section{A section}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum[1-10]}
+
+
+
+\section{Another section}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum}
+
+
+\appendix
+\chapter{Special commands provided by \textsf{sapthesis}}
+
+\textsf{Sapthesis} provides some special commands, particularly useful for scientific works. You can use for example the roman shape, instead of the italic, for the imaginary unit (\texttt{\bs iu}) and Napier's number (\texttt{\bs eu}):
+\begin{equation}
+\eu^{\iu\pi}+1=0
+\end{equation}
+
+There are also two commands to speed up the writing of derivatives. In the following example we have used the commands \texttt{\bs der} and \texttt{\bs pder}):
+\begin{equation}
+\der{f}{x} \qquad \pder{f}{*{2}{y}}
+\end{equation}
+
+
+\textsf{Sapthesis} provides also 4 commands to improve the writing of subscripts, \texttt{\bs rb} and \texttt{\bs tb}, and superscripts, \texttt{\bs rp} and \texttt{\bs tp}. Two of these commands, \texttt{\bs rb} and \texttt{\bs rp}, can be used both in text and in math mode and compose their argument in roman. The other two, \texttt{\bs tb} and \texttt{\bs tp}, can be used only in text mode and compose their argument as are. Here it is an usage example of \texttt{\bs rb} and \texttt{\bs rp}:
+\[
+a_b \neq a\rb{b}\qquad a^b \neq a\rp{b}
+\]
+And here it is an usage example of \texttt{\bs tb}: \emph{Cu\tb{It} indicates copper bought in Italy}. And a usage example of \texttt{\bs ts}: \emph{Cher G\tp{le} Napol\'eon}.
+
+
+Then several commands for the correct typesetting of unit of measurements are provided. For example the command \texttt{\bs un} typesets its argument in roman and leaves a thin space between the number and the unit: $25\un{m}$, $3.5\un{m/s}$. Other commands are: (\texttt{\bs g}) 45\g, (\texttt{\bs C}) 30\,\C, (\texttt{\bs A}) 12\,\A, (\texttt{\bs micro}) 40\,\micro m, (\texttt{\bs ohm}) 27\,\ohm.
+
+We have also \texttt{\bs x} as abbreviation of \texttt{\bs times}: \texttt{\$7 \bs x 10\^{}5\$} gives $7 \x 10^5$. Then \texttt{\bs di} is the differential symbol which automatically insert the correct spacing.
+\[
+\int x \di x
+\]
+
+Finally we have defined the color \textsf{sapred} which is the official color
+of Sapienza -- University of Rome. It is defined as RGB(130,36,51). \textcolor{sapred}{This text is written with the color \textsf{sapred}.}
+
+In the following dummy text you can observe the usage of \texttt{\bs mnote} command which typesets fancy margin notes.
+
+\textcolor{gray}{\lipsum}
+\marginpar{This is a fancy margin note!}
+\textcolor{gray}{\lipsum}
+
+\backmatter
+% bibliography
+%\cleardoublepage
+%\phantomsection
+%\bibliographystyle{sapthesis} % BibTeX style
+%\bibliography{bibliography} % BibTeX database without .bib extension
+
+\end{document}
diff --git a/macros/latex/contrib/sapthesis/examples/Laurea_ita.tex b/macros/latex/contrib/sapthesis/examples/Laurea_ita.tex
new file mode 100644
index 0000000000..851ae6b35f
--- /dev/null
+++ b/macros/latex/contrib/sapthesis/examples/Laurea_ita.tex
@@ -0,0 +1,218 @@
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = it_IT
+
+\documentclass[Lau,binding=0.6cm]{sapthesis}
+
+\usepackage{microtype}
+\usepackage[italian]{babel}
+\usepackage[utf8]{inputenx}
+
+\usepackage{hyperref}
+\hypersetup{pdftitle={Sapthesis class example},pdfauthor={Francesco Biccari}}
+
+% Remove in a normal thesis
+\usepackage{lipsum}
+\usepackage{curve2e}
+\definecolor{gray}{gray}{0.4}
+\newcommand{\bs}{\textbackslash}
+
+% Commands for the titlepage
+\title{Esempio d'uso della classe Sapthesis\\ per una tesi di Laurea}
+\author{Francesco Biccari}
+\IDnumber{1234567}
+\course{Fisica}
+\courseorganizer{Facoltà di Scienze Matematiche, Fisiche e Naturali}
+\AcademicYear{2012/2013}
+\copyyear{2013}
+\advisor{Prof. Nome Cognome}
+\advisor{Dr. Nome Cognome}
+\coadvisor{Dr. Nome Cognome}
+\authoremail{biccari@email.com}
+
+\examdate{16 April 2013}
+\examiner{Prof. Nome Cognome}
+\examiner{Prof. Nome Cognome}
+\examiner{Dr. Nome Cognome}
+\versiondate{\today}
+
+
+
+\begin{document}
+
+\frontmatter
+
+\maketitle
+
+\dedication{Dedicato a\\ Donald Knuth}
+
+\begin{abstract}
+This document is an example which shows the main features of
+the \LaTeXe\ class \texttt{sapthesis.cls} developed by Francesco Biccari
+with the help of GuIT (Gruppo Utilizzatori Italiani di \TeX).
+\end{abstract}
+
+\begin{acknowledgments}
+Ho deciso di scrivere i ringraziamenti in italiano
+per dimostrare la mia gratitudine verso i membri
+del GuIT, il Gruppo Utilizzatori Italiani di \TeX, e, in particolare,
+verso il prof. Enrico Gregorio.
+\end{acknowledgments}
+
+\tableofcontents
+
+% Do not use the starred version of the chapter command!
+\chapter{Capitolo non numerato}
+
+In this manual you can skip the gray text because it is just dummy text.%
+\footnote{This is a footnote.}
+
+\textcolor{gray}{\lipsum[1-22]}
+
+
+\section*{Paragrafo non numerato}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum[1-22]}
+
+
+
+
+\mainmatter
+
+\chapter{Style features of \textsf{sapthesis}}
+
+In this chapter I will discuss my stylistic choices of \textsf{sapthesis}.
+I will show the page layout geometry and I will describe the page style.
+
+\section{Page layout}
+
+The page is fixed at the dimensions of an A4 paper, therefore you have to print your thesis on A4 paper to obtain the best results. The font dimension is fixed at 11\, pt. The text column and the margins are chosen to fill to the best an A4 paper while keeping a reasonable line length (396\, pt) for a good readability. The text height and the text width are in golden ratio (\textasciitilde 1.6180) as well as the outer and inner margins in a two-side document after binding margin removal. Also the top margin (excluding the header) and bottom margin are in the golden ratio. In Fig.~\ref{layout} a sketch of the \textsf{sapthesis} page layout is shown.
+
+\begin{figure}[h]
+\centering
+\setlength{\unitlength}{0.27mm}
+\begin{picture}(420,297)(-210,0)
+\polyline(-210,0)(210,0)(210,297)(-210,297)(-210,0)
+\Line(0,0)(0,297)
+\put(27.05,37.4){\polygon(0,0)(139.2,0)(139.2,223.8)(0,223.8)}
+\put(-27.05,37.4){\polygon(0,0)(-139.2,0)(-139.2,223.8)(0,223.8)}
+\put(27.05,268.16){\polygon(0,0)(139.2,0)(139.2,4.22)(0,4.22)}
+\put(-27.05,268.16){\polygon(0,0)(-139.2,0)(-139.2,4.22)(0,4.22)}
+\end{picture}
+\caption{Page layout scheme of \textsf{sapthesis class} using a zero binding margin.}
+\label{layout}
+\end{figure}
+
+
+\section{Page style}
+
+The captions have a smaller font respect to the text and the label is in boldface. The appearance of the margin notes has been improved.
+They have the same font dimension of the footnotes and are typed in italics.
+Moreover I defined a new command to typeset margin note aligned to the left on the right page and vice versa on the left page.
+Notice that if a binding margin greater than 1.5\, cm is used, the dimensions of the margin notes become too small and very ugly.
+Do not use them in this case.
+
+The mathematical objects, figures and tables are numbered within the chapters (e.g. 1.1, 1.2,\ldots for the first chapter, 2.1, 2.2 for the second one and so on\ldots). See for example the number of this simple equation
+\begin{equation}
+x_{1,2}=\frac{-b\pm\sqrt{b^2-4ac}}{2a}
+\end{equation}
+
+
+The title page is automatically composed when the \texttt{\bs maketitle} command is given.
+The parameters needed for the title page, author, title, etc\ldots , are supplied by dedicated commands explained in the next section.
+Two copies of the university logo in \texttt{pdf} format, one for color printing and the other one for black and white printing, are supplied in the \textsf{sapthesis} package. They are shown in Fig.~\ref{fig:largenenough}.
+
+\begin{figure}
+\centering
+\includegraphics[width=0.7\textwidth]{sapienza-MLred-pos}\\[3ex]
+\includegraphics[width=0.7\textwidth]{sapienza-MLblack-pos}
+\caption{Logo of the Sapienza -- University of Rome.}
+\label{fig:largenenough}
+\end{figure}
+
+
+
+\section{About figures and tables}
+
+As regards the image formats, please use vector images as much as possible! Use jpg images only for photographs! pdf\LaTeX\ supports the pdf, jpg and png formats.
+
+A very simple table is show in Tab.~\ref{tab:letters}. Remember to typeset
+always the table caption above the table. Do not use vertical lines.
+
+\begin{table}
+\caption{This is a simple table.}
+\label{tab:letters}
+\centering
+\begin{tabular}{lcc}
+\toprule
+Letter & Test & Test \\
+\midrule
+A & C & E \\
+B & D & F \\
+\bottomrule
+\end{tabular}
+\end{table}
+
+
+\section{A section}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum[1-10]}
+
+
+
+\section{Another section}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum}
+
+
+\appendix
+\chapter{Special commands provided by \textsf{sapthesis}}
+
+\textsf{Sapthesis} provides some special commands, particularly useful for scientific works. You can use for example the roman shape, instead of the italic, for the imaginary unit (\texttt{\bs iu}) and Napier's number (\texttt{\bs eu}):
+\begin{equation}
+\eu^{\iu\pi}+1=0
+\end{equation}
+
+There are also two commands to speed up the writing of derivatives. In the following example we have used the commands \texttt{\bs der} and \texttt{\bs pder}):
+\begin{equation}
+\der{f}{x} \qquad \pder{f}{*{2}{y}}
+\end{equation}
+
+
+\textsf{Sapthesis} provides also 4 commands to improve the writing of subscripts, \texttt{\bs rb} and \texttt{\bs tb}, and superscripts, \texttt{\bs rp} and \texttt{\bs tp}. Two of these commands, \texttt{\bs rb} and \texttt{\bs rp}, can be used both in text and in math mode and compose their argument in roman. The other two, \texttt{\bs tb} and \texttt{\bs tp}, can be used only in text mode and compose their argument as are. Here it is an usage example of \texttt{\bs rb} and \texttt{\bs rp}:
+\[
+a_b \neq a\rb{b}\qquad a^b \neq a\rp{b}
+\]
+And here it is an usage example of \texttt{\bs tb}: \emph{Cu\tb{It} indicates copper bought in Italy}. And a usage example of \texttt{\bs ts}: \emph{Cher G\tp{le} Napol\'eon}.
+
+
+Then several commands for the correct typesetting of unit of measurements are provided. For example the command \texttt{\bs un} typesets its argument in roman and leaves a thin space between the number and the unit: $25\un{m}$, $3.5\un{m/s}$. Other commands are: (\texttt{\bs g}) 45\g, (\texttt{\bs C}) 30\,\C, (\texttt{\bs A}) 12\,\A, (\texttt{\bs micro}) 40\,\micro m, (\texttt{\bs ohm}) 27\,\ohm.
+
+We have also \texttt{\bs x} as abbreviation of \texttt{\bs times}: \texttt{\$7 \bs x 10\^{}5\$} gives $7 \x 10^5$. Then \texttt{\bs di} is the differential symbol which automatically insert the correct spacing.
+\[
+\int x \di x
+\]
+
+Finally we have defined the color \textsf{sapred} which is the official color
+of Sapienza -- University of Rome. It is defined as RGB(130,36,51). \textcolor{sapred}{This text is written with the color \textsf{sapred}.}
+
+In the following dummy text you can observe the usage of \texttt{\bs mnote} command which typesets fancy margin notes.
+
+\textcolor{gray}{\lipsum}
+\marginpar{This is a fancy margin note!}
+\textcolor{gray}{\lipsum}
+
+\backmatter
+% bibliography
+%\cleardoublepage
+%\phantomsection
+%\bibliographystyle{sapthesis} % BibTeX style
+%\bibliography{bibliography} % BibTeX database without .bib extension
+
+\end{document}
diff --git a/macros/latex/contrib/sapthesis/examples/Master.tex b/macros/latex/contrib/sapthesis/examples/Master.tex
new file mode 100644
index 0000000000..c780e79ee8
--- /dev/null
+++ b/macros/latex/contrib/sapthesis/examples/Master.tex
@@ -0,0 +1,219 @@
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = it_IT
+
+\documentclass[MasterS,binding=0.6cm]{sapthesis}
+% use MasterP option, instead of MasterS, for a ``Master di primo livello''
+
+\usepackage{microtype}
+\usepackage[italian]{babel}
+\usepackage[utf8]{inputenx}
+
+\usepackage{hyperref}
+\hypersetup{pdftitle={Esempio d'uso della classe Sapthesis per una tesi di Master},pdfauthor={Francesco Biccari}}
+
+% Remove in a normal thesis
+\usepackage{lipsum}
+\usepackage{curve2e}
+\definecolor{gray}{gray}{0.4}
+\newcommand{\bs}{\textbackslash}
+
+% Commands for the titlepage
+\title{Esempio d'uso della classe Sapthesis\\ per una tesi di Master}
+\author{Francesco Biccari}
+\IDnumber{1234567}
+\course{Fisica}
+\courseorganizer{Facoltà di Scienze Matematiche, Fisiche e Naturali}
+\AcademicYear{2012/2013}
+\copyyear{2013}
+\advisor{Prof. Nome Cognome}
+\advisor{Dr. Nome Cognome}
+\coadvisor{Dr. Nome Cognome}
+\authoremail{biccari@email.com}
+
+\examdate{16 April 2013}
+\examiner{Prof. Nome Cognome}
+\examiner{Prof. Nome Cognome}
+\examiner{Dr. Nome Cognome}
+\versiondate{\today}
+
+
+
+\begin{document}
+
+\frontmatter
+
+\maketitle
+
+\dedication{Dedicato a\\ Donald Knuth}
+
+\begin{abstract}
+This document is an example which shows the main features of
+the \LaTeXe\ class \texttt{sapthesis.cls} developed by Francesco Biccari
+with the help of GuIT (Gruppo Utilizzatori Italiani di \TeX).
+\end{abstract}
+
+\begin{acknowledgments}
+Ho deciso di scrivere i ringraziamenti in italiano
+per dimostrare la mia gratitudine verso i membri
+del GuIT, il Gruppo Utilizzatori Italiani di \TeX, e, in particolare,
+verso il prof. Enrico Gregorio.
+\end{acknowledgments}
+
+\tableofcontents
+
+% Do not use the starred version of the chapter command!
+\chapter{Capitolo non numerato}
+
+In this manual you can skip the gray text because it is just dummy text.%
+\footnote{This is a footnote.}
+
+\textcolor{gray}{\lipsum[1-22]}
+
+
+\section*{Paragrafo non numerato}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum[1-22]}
+
+
+
+
+\mainmatter
+
+\chapter{Style features of \textsf{sapthesis}}
+
+In this chapter I will discuss my stylistic choices of \textsf{sapthesis}.
+I will show the page layout geometry and I will describe the page style.
+
+\section{Page layout}
+
+The page is fixed at the dimensions of an A4 paper, therefore you have to print your thesis on A4 paper to obtain the best results. The font dimension is fixed at 11\, pt. The text column and the margins are chosen to fill to the best an A4 paper while keeping a reasonable line length (396\, pt) for a good readability. The text height and the text width are in golden ratio (\textasciitilde 1.6180) as well as the outer and inner margins in a two-side document after binding margin removal. Also the top margin (excluding the header) and bottom margin are in the golden ratio. In Fig.~\ref{layout} a sketch of the \textsf{sapthesis} page layout is shown.
+
+\begin{figure}[h]
+\centering
+\setlength{\unitlength}{0.27mm}
+\begin{picture}(420,297)(-210,0)
+\polyline(-210,0)(210,0)(210,297)(-210,297)(-210,0)
+\Line(0,0)(0,297)
+\put(27.05,37.4){\polygon(0,0)(139.2,0)(139.2,223.8)(0,223.8)}
+\put(-27.05,37.4){\polygon(0,0)(-139.2,0)(-139.2,223.8)(0,223.8)}
+\put(27.05,268.16){\polygon(0,0)(139.2,0)(139.2,4.22)(0,4.22)}
+\put(-27.05,268.16){\polygon(0,0)(-139.2,0)(-139.2,4.22)(0,4.22)}
+\end{picture}
+\caption{Page layout scheme of \textsf{sapthesis class} using a zero binding margin.}
+\label{layout}
+\end{figure}
+
+
+\section{Page style}
+
+The captions have a smaller font respect to the text and the label is in boldface. The appearance of the margin notes has been improved.
+They have the same font dimension of the footnotes and are typed in italics.
+Moreover I defined a new command to typeset margin note aligned to the left on the right page and vice versa on the left page.
+Notice that if a binding margin greater than 1.5\, cm is used, the dimensions of the margin notes become too small and very ugly.
+Do not use them in this case.
+
+The mathematical objects, figures and tables are numbered within the chapters (e.g. 1.1, 1.2,\ldots for the first chapter, 2.1, 2.2 for the second one and so on\ldots). See for example the number of this simple equation
+\begin{equation}
+x_{1,2}=\frac{-b\pm\sqrt{b^2-4ac}}{2a}
+\end{equation}
+
+
+The title page is automatically composed when the \texttt{\bs maketitle} command is given.
+The parameters needed for the title page, author, title, etc\ldots , are supplied by dedicated commands explained in the next section.
+Two copies of the university logo in \texttt{pdf} format, one for color printing and the other one for black and white printing, are supplied in the \textsf{sapthesis} package. They are shown in Fig.~\ref{fig:largenenough}.
+
+\begin{figure}
+\centering
+\includegraphics[width=0.7\textwidth]{sapienza-MLred-pos}\\[3ex]
+\includegraphics[width=0.7\textwidth]{sapienza-MLblack-pos}
+\caption{Logo of the Sapienza -- University of Rome.}
+\label{fig:largenenough}
+\end{figure}
+
+
+
+\section{About figures and tables}
+
+As regards the image formats, please use vector images as much as possible! Use jpg images only for photographs! pdf\LaTeX\ supports the pdf, jpg and png formats.
+
+A very simple table is show in Tab.~\ref{tab:letters}. Remember to typeset
+always the table caption above the table. Do not use vertical lines.
+
+\begin{table}
+\caption{This is a simple table.}
+\label{tab:letters}
+\centering
+\begin{tabular}{lcc}
+\toprule
+Letter & Test & Test \\
+\midrule
+A & C & E \\
+B & D & F \\
+\bottomrule
+\end{tabular}
+\end{table}
+
+
+\section{A section}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum[1-10]}
+
+
+
+\section{Another section}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum}
+
+
+\appendix
+\chapter{Special commands provided by \textsf{sapthesis}}
+
+\textsf{Sapthesis} provides some special commands, particularly useful for scientific works. You can use for example the roman shape, instead of the italic, for the imaginary unit (\texttt{\bs iu}) and Napier's number (\texttt{\bs eu}):
+\begin{equation}
+\eu^{\iu\pi}+1=0
+\end{equation}
+
+There are also two commands to speed up the writing of derivatives. In the following example we have used the commands \texttt{\bs der} and \texttt{\bs pder}):
+\begin{equation}
+\der{f}{x} \qquad \pder{f}{*{2}{y}}
+\end{equation}
+
+
+\textsf{Sapthesis} provides also 4 commands to improve the writing of subscripts, \texttt{\bs rb} and \texttt{\bs tb}, and superscripts, \texttt{\bs rp} and \texttt{\bs tp}. Two of these commands, \texttt{\bs rb} and \texttt{\bs rp}, can be used both in text and in math mode and compose their argument in roman. The other two, \texttt{\bs tb} and \texttt{\bs tp}, can be used only in text mode and compose their argument as are. Here it is an usage example of \texttt{\bs rb} and \texttt{\bs rp}:
+\[
+a_b \neq a\rb{b}\qquad a^b \neq a\rp{b}
+\]
+And here it is an usage example of \texttt{\bs tb}: \emph{Cu\tb{It} indicates copper bought in Italy}. And a usage example of \texttt{\bs ts}: \emph{Cher G\tp{le} Napol\'eon}.
+
+
+Then several commands for the correct typesetting of unit of measurements are provided. For example the command \texttt{\bs un} typesets its argument in roman and leaves a thin space between the number and the unit: $25\un{m}$, $3.5\un{m/s}$. Other commands are: (\texttt{\bs g}) 45\g, (\texttt{\bs C}) 30\,\C, (\texttt{\bs A}) 12\,\A, (\texttt{\bs micro}) 40\,\micro m, (\texttt{\bs ohm}) 27\,\ohm.
+
+We have also \texttt{\bs x} as abbreviation of \texttt{\bs times}: \texttt{\$7 \bs x 10\^{}5\$} gives $7 \x 10^5$. Then \texttt{\bs di} is the differential symbol which automatically insert the correct spacing.
+\[
+\int x \di x
+\]
+
+Finally we have defined the color \textsf{sapred} which is the official color
+of Sapienza -- University of Rome. It is defined as RGB(130,36,51). \textcolor{sapred}{This text is written with the color \textsf{sapred}.}
+
+In the following dummy text you can observe the usage of \texttt{\bs mnote} command which typesets fancy margin notes.
+
+\textcolor{gray}{\lipsum}
+\marginpar{This is a fancy margin note!}
+\textcolor{gray}{\lipsum}
+
+\backmatter
+% bibliography
+%\cleardoublepage
+%\phantomsection
+%\bibliographystyle{sapthesis} % BibTeX style
+%\bibliography{bibliography} % BibTeX database without .bib extension
+
+\end{document}
diff --git a/macros/latex/contrib/sapthesis/examples/PhD.tex b/macros/latex/contrib/sapthesis/examples/PhD.tex
new file mode 100644
index 0000000000..20dadb8c81
--- /dev/null
+++ b/macros/latex/contrib/sapthesis/examples/PhD.tex
@@ -0,0 +1,221 @@
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = en_US
+
+\documentclass[PhD,binding=0.6cm]{../sapthesis}
+
+\usepackage{microtype}
+% if you write in italian:
+%\usepackage[italian]{babel}
+\usepackage[utf8]{inputenx}
+
+\usepackage{hyperref}
+\hypersetup{pdftitle={Usage example of the Sapthesis class for a PhD thesis},pdfauthor={Francesco Biccari}}
+
+% Remove in a normal thesis
+\usepackage{lipsum}
+\usepackage{curve2e}
+\definecolor{gray}{gray}{0.4}
+\newcommand{\bs}{\textbackslash}
+
+% Commands for the titlepage
+\title{Usage example of the Sapthesis class\\ for a PhD thesis}
+\author{Francesco Biccari}
+\IDnumber{1234567}
+\course[Physics]{Fisica}
+\courseorganizer{Scuola di dottorato Vito Volterra}
+\cycle{XXV}
+\submitdate{April 2013}
+\copyyear{2013}
+\advisor{Prof. Nome Cognome}
+\advisor{Dr. Nome Cognome}
+\coadvisor{Dr. Nome Cognome}
+\authoremail{biccari@email.com}
+
+\examdate{16 April 2013}
+\examiner{Prof. Nome Cognome}
+\examiner{Prof. Nome Cognome}
+\examiner{Dr. Nome Cognome}
+\versiondate{\today}
+\ISBN{000000000-0}
+
+
+
+\begin{document}
+
+\frontmatter
+
+\maketitle
+
+\dedication{Dedicated to\\ Donald Knuth}
+
+\begin{abstract}
+This document is an example which shows the main features of
+the \LaTeXe\ class \texttt{sapthesis.cls} developed by Francesco Biccari
+with the help of GuIT (Gruppo Utilizzatori Italiani di \TeX).
+\end{abstract}
+
+\begin{acknowledgments}[Ringraziamenti]
+Ho deciso di scrivere i ringraziamenti in italiano
+per dimostrare la mia gratitudine verso i membri
+del GuIT, il Gruppo Utilizzatori Italiani di \TeX, e, in particolare,
+verso il prof. Enrico Gregorio.
+\end{acknowledgments}
+
+\tableofcontents
+
+% Do not use the starred version of the chapter command!
+\chapter{Non numbered chapter}
+
+In this manual you can skip the gray text because it is just dummy text.%
+\footnote{This is a footnote.}
+
+\textcolor{gray}{\lipsum[1-22]}
+
+
+\section*{Non numbered section}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum[1-22]}
+
+
+
+
+\mainmatter
+
+\chapter{Style features of \textsf{sapthesis}}
+
+In this chapter I will discuss my stylistic choices of \textsf{sapthesis}.
+I will show the page layout geometry and I will describe the page style.
+
+\section{Page layout}
+
+The page is fixed at the dimensions of an A4 paper, therefore you have to print your thesis on A4 paper to obtain the best results. The font dimension is fixed at 11\, pt. The text column and the margins are chosen to fill to the best an A4 paper while keeping a reasonable line length (396\, pt) for a good readability. The text height and the text width are in golden ratio (\textasciitilde 1.6180) as well as the outer and inner margins in a two-side document after binding margin removal. Also the top margin (excluding the header) and bottom margin are in the golden ratio. In Fig.~\ref{layout} a sketch of the \textsf{sapthesis} page layout is shown.
+
+\begin{figure}[h]
+\centering
+\setlength{\unitlength}{0.27mm}
+\begin{picture}(420,297)(-210,0)
+\polyline(-210,0)(210,0)(210,297)(-210,297)(-210,0)
+\Line(0,0)(0,297)
+\put(27.05,37.4){\polygon(0,0)(139.2,0)(139.2,223.8)(0,223.8)}
+\put(-27.05,37.4){\polygon(0,0)(-139.2,0)(-139.2,223.8)(0,223.8)}
+\put(27.05,268.16){\polygon(0,0)(139.2,0)(139.2,4.22)(0,4.22)}
+\put(-27.05,268.16){\polygon(0,0)(-139.2,0)(-139.2,4.22)(0,4.22)}
+\end{picture}
+\caption{Page layout scheme of \textsf{sapthesis class} using a zero binding margin.}
+\label{layout}
+\end{figure}
+
+
+\section{Page style}
+
+The captions have a smaller font respect to the text and the label is in boldface. The appearance of the margin notes has been improved.
+They have the same font dimension of the footnotes and are typed in italics.
+Moreover I defined a new command to typeset margin note aligned to the left on the right page and vice versa on the left page.
+Notice that if a binding margin greater than 1.5\, cm is used, the dimensions of the margin notes become too small and very ugly.
+Do not use them in this case.
+
+The mathematical objects, figures and tables are numbered within the chapters (e.g. 1.1, 1.2,\ldots for the first chapter, 2.1, 2.2 for the second one and so on\ldots). See for example the number of this simple equation
+\begin{equation}
+x_{1,2}=\frac{-b\pm\sqrt{b^2-4ac}}{2a}
+\end{equation}
+
+
+The title page is automatically composed when the \texttt{\bs maketitle} command is given.
+The parameters needed for the title page, author, title, etc\ldots , are supplied by dedicated commands explained in the next section.
+Two copies of the university logo in \texttt{pdf} format, one for color printing and the other one for black and white printing, are supplied in the \textsf{sapthesis} package. They are shown in Fig.~\ref{fig:largenenough}.
+
+\begin{figure}
+\centering
+\includegraphics[width=0.7\textwidth]{sapienza-MLred-pos}\\[3ex]
+\includegraphics[width=0.7\textwidth]{sapienza-MLblack-pos}
+\caption{Logo of the Sapienza -- University of Rome.}
+\label{fig:largenenough}
+\end{figure}
+
+
+
+\section{About figures and tables}
+
+As regards the image formats, please use vector images as much as possible! Use jpg images only for photographs! pdf\LaTeX\ supports the pdf, jpg and png formats.
+
+A very simple table is show in Tab.~\ref{tab:letters}. Remember to typeset
+always the table caption above the table. Do not use vertical lines.
+
+\begin{table}
+\caption{This is a simple table.}
+\label{tab:letters}
+\centering
+\begin{tabular}{lcc}
+\toprule
+Letter & Test & Test \\
+\midrule
+A & C & E \\
+B & D & F \\
+\bottomrule
+\end{tabular}
+\end{table}
+
+
+\section{A section}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum[1-10]}
+
+
+
+\section{Another section}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum}
+
+
+\appendix
+\chapter{Special commands provided by \textsf{sapthesis}}
+
+\textsf{Sapthesis} provides some special commands, particularly useful for scientific works. You can use for example the roman shape, instead of the italic, for the imaginary unit (\texttt{\bs iu}) and Napier's number (\texttt{\bs eu}):
+\begin{equation}
+\eu^{\iu\pi}+1=0
+\end{equation}
+
+There are also two commands to speed up the writing of derivatives. In the following example we have used the commands \texttt{\bs der} and \texttt{\bs pder}):
+\begin{equation}
+\der{f}{x} \qquad \pder{f}{*{2}{y}}
+\end{equation}
+
+
+\textsf{Sapthesis} provides also 4 commands to improve the writing of subscripts, \texttt{\bs rb} and \texttt{\bs tb}, and superscripts, \texttt{\bs rp} and \texttt{\bs tp}. Two of these commands, \texttt{\bs rb} and \texttt{\bs rp}, can be used both in text and in math mode and compose their argument in roman. The other two, \texttt{\bs tb} and \texttt{\bs tp}, can be used only in text mode and compose their argument as are. Here it is an usage example of \texttt{\bs rb} and \texttt{\bs rp}:
+\[
+a_b \neq a\rb{b}\qquad a^b \neq a\rp{b}
+\]
+And here it is an usage example of \texttt{\bs tb}: \emph{Cu\tb{It} indicates copper bought in Italy}. And a usage example of \texttt{\bs ts}: \emph{Cher G\tp{le} Napol\'eon}.
+
+
+Then several commands for the correct typesetting of unit of measurements are provided. For example the command \texttt{\bs un} typesets its argument in roman and leaves a thin space between the number and the unit: $25\un{m}$, $3.5\un{m/s}$. Other commands are: (\texttt{\bs g}) 45\g, (\texttt{\bs C}) 30\,\C, (\texttt{\bs A}) 12\,\A, (\texttt{\bs micro}) 40\,\micro m, (\texttt{\bs ohm}) 27\,\ohm.
+
+We have also \texttt{\bs x} as abbreviation of \texttt{\bs times}: \texttt{\$7 \bs x 10\^{}5\$} gives $7 \x 10^5$. Then \texttt{\bs di} is the differential symbol which automatically insert the correct spacing.
+\[
+\int x \di x
+\]
+
+Finally we have defined the color \textsf{sapred} which is the official color
+of Sapienza -- University of Rome. It is defined as RGB(130,36,51). \textcolor{sapred}{This text is written with the color \textsf{sapred}.}
+
+In the following dummy text you can observe the usage of \texttt{\bs mnote} command which typesets fancy margin notes.
+
+\textcolor{gray}{\lipsum}
+\marginpar{This is a fancy margin note!}
+\textcolor{gray}{\lipsum}
+
+\backmatter
+% bibliography
+%\cleardoublepage
+%\phantomsection
+%\bibliographystyle{sapthesis} % BibTeX style
+%\bibliography{bibliography} % BibTeX database without .bib extension
+
+\end{document}
diff --git a/macros/latex/contrib/sapthesis/examples/Specialization.tex b/macros/latex/contrib/sapthesis/examples/Specialization.tex
new file mode 100644
index 0000000000..db99767f6b
--- /dev/null
+++ b/macros/latex/contrib/sapthesis/examples/Specialization.tex
@@ -0,0 +1,220 @@
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = en_US
+
+\documentclass[Specialization,binding=0.6cm]{sapthesis}
+
+\usepackage{microtype}
+\usepackage[utf8]{inputenx}
+
+\usepackage{hyperref}
+\hypersetup{pdftitle={Usage example of Sapthesis class for Specialization thesis},pdfauthor={Francesco Biccari}}
+
+% Remove in a normal thesis
+\usepackage{lipsum}
+\usepackage{curve2e}
+\definecolor{gray}{gray}{0.4}
+\newcommand{\bs}{\textbackslash}
+
+% Commands for the titlepage
+\title{Usage example of Sapthesis class for\\ Specialization thesis}
+\author{Francesco Biccari}
+\IDnumber{1234567}
+\course{Fisica Medica}
+\courseorganizer{Facoltà di Medicina e Chirurgia}
+\AcademicYear{2012/2013}
+\copyyear{2013}
+\advisor{Prof. Nome Cognome}
+\advisor{Dr. Nome Cognome}
+\coadvisor{Dr. Nome Cognome}
+\director{Prof. Nome Cognome}
+\authoremail{biccari@email.com}
+
+\examdate{16 April 2013}
+\examiner{Prof. Nome Cognome}
+\examiner{Prof. Nome Cognome}
+\examiner{Dr. Nome Cognome}
+\versiondate{\today}
+\website{biccari.altervista.org}
+\ISBN{000000000-0}
+
+
+
+\begin{document}
+
+\frontmatter
+
+\maketitle
+
+\dedication{Dedicated to\\ Donald Knuth}
+
+\begin{abstract}
+This document is an example which shows the main features of
+the \LaTeXe\ class \texttt{sapthesis.cls} developed by Francesco Biccari
+with the help of GuIT (Gruppo Utilizzatori Italiani di \TeX).
+\end{abstract}
+
+\begin{acknowledgments}[Ringraziamenti]
+Ho deciso di scrivere i ringraziamenti in italiano
+per dimostrare la mia gratitudine verso i membri
+del GuIT, il Gruppo Utilizzatori Italiani di \TeX, e, in particolare,
+verso il prof. Enrico Gregorio.
+\end{acknowledgments}
+
+\tableofcontents
+
+% Do not use the starred version of the chapter command!
+\chapter{Non numbered chapter}
+
+In this manual you can skip the gray text because it is just dummy text.%
+\footnote{This is a footnote.}
+
+\textcolor{gray}{\lipsum[1-22]}
+
+
+\section*{Non numbered section}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum[1-22]}
+
+
+
+
+\mainmatter
+
+\chapter{Style features of \textsf{sapthesis}}
+
+In this chapter I will discuss my stylistic choices of \textsf{sapthesis}.
+I will show the page layout geometry and I will describe the page style.
+
+\section{Page layout}
+
+The page is fixed at the dimensions of an A4 paper, therefore you have to print your thesis on A4 paper to obtain the best results. The font dimension is fixed at 11\, pt. The text column and the margins are chosen to fill to the best an A4 paper while keeping a reasonable line length (396\, pt) for a good readability. The text height and the text width are in golden ratio (\textasciitilde 1.6180) as well as the outer and inner margins in a two-side document after binding margin removal. Also the top margin (excluding the header) and bottom margin are in the golden ratio. In Fig.~\ref{layout} a sketch of the \textsf{sapthesis} page layout is shown.
+
+\begin{figure}[h]
+\centering
+\setlength{\unitlength}{0.27mm}
+\begin{picture}(420,297)(-210,0)
+\polyline(-210,0)(210,0)(210,297)(-210,297)(-210,0)
+\Line(0,0)(0,297)
+\put(27.05,37.4){\polygon(0,0)(139.2,0)(139.2,223.8)(0,223.8)}
+\put(-27.05,37.4){\polygon(0,0)(-139.2,0)(-139.2,223.8)(0,223.8)}
+\put(27.05,268.16){\polygon(0,0)(139.2,0)(139.2,4.22)(0,4.22)}
+\put(-27.05,268.16){\polygon(0,0)(-139.2,0)(-139.2,4.22)(0,4.22)}
+\end{picture}
+\caption{Page layout scheme of \textsf{sapthesis class} using a zero binding margin.}
+\label{layout}
+\end{figure}
+
+
+\section{Page style}
+
+The captions have a smaller font respect to the text and the label is in boldface. The appearance of the margin notes has been improved.
+They have the same font dimension of the footnotes and are typed in italics.
+Moreover I defined a new command to typeset margin note aligned to the left on the right page and vice versa on the left page.
+Notice that if a binding margin greater than 1.5\, cm is used, the dimensions of the margin notes become too small and very ugly.
+Do not use them in this case.
+
+The mathematical objects, figures and tables are numbered within the chapters (e.g. 1.1, 1.2,\ldots for the first chapter, 2.1, 2.2 for the second one and so on\ldots). See for example the number of this simple equation
+\begin{equation}
+x_{1,2}=\frac{-b\pm\sqrt{b^2-4ac}}{2a}
+\end{equation}
+
+
+The title page is automatically composed when the \texttt{\bs maketitle} command is given.
+The parameters needed for the title page, author, title, etc\ldots , are supplied by dedicated commands explained in the next section.
+Two copies of the university logo in \texttt{pdf} format, one for color printing and the other one for black and white printing, are supplied in the \textsf{sapthesis} package. They are shown in Fig.~\ref{fig:largenenough}.
+
+\begin{figure}
+\centering
+\includegraphics[width=0.7\textwidth]{sapienza-MLred-pos}\\[3ex]
+\includegraphics[width=0.7\textwidth]{sapienza-MLblack-pos}
+\caption{Logo of the Sapienza -- University of Rome.}
+\label{fig:largenenough}
+\end{figure}
+
+
+
+\section{About figures and tables}
+
+As regards the image formats, please use vector images as much as possible! Use jpg images only for photographs! pdf\LaTeX\ supports the pdf, jpg and png formats.
+
+A very simple table is show in Tab.~\ref{tab:letters}. Remember to typeset
+always the table caption above the table. Do not use vertical lines.
+
+\begin{table}
+\caption{This is a simple table.}
+\label{tab:letters}
+\centering
+\begin{tabular}{lcc}
+\toprule
+Letter & Test & Test \\
+\midrule
+A & C & E \\
+B & D & F \\
+\bottomrule
+\end{tabular}
+\end{table}
+
+
+\section{A section}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum[1-10]}
+
+
+
+\section{Another section}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum}
+
+
+\appendix
+\chapter{Special commands provided by \textsf{sapthesis}}
+
+\textsf{Sapthesis} provides some special commands, particularly useful for scientific works. You can use for example the roman shape, instead of the italic, for the imaginary unit (\texttt{\bs iu}) and Napier's number (\texttt{\bs eu}):
+\begin{equation}
+\eu^{\iu\pi}+1=0
+\end{equation}
+
+There are also two commands to speed up the writing of derivatives. In the following example we have used the commands \texttt{\bs der} and \texttt{\bs pder}):
+\begin{equation}
+\der{f}{x} \qquad \pder{f}{*{2}{y}}
+\end{equation}
+
+
+\textsf{Sapthesis} provides also 4 commands to improve the writing of subscripts, \texttt{\bs rb} and \texttt{\bs tb}, and superscripts, \texttt{\bs rp} and \texttt{\bs tp}. Two of these commands, \texttt{\bs rb} and \texttt{\bs rp}, can be used both in text and in math mode and compose their argument in roman. The other two, \texttt{\bs tb} and \texttt{\bs tp}, can be used only in text mode and compose their argument as are. Here it is an usage example of \texttt{\bs rb} and \texttt{\bs rp}:
+\[
+a_b \neq a\rb{b}\qquad a^b \neq a\rp{b}
+\]
+And here it is an usage example of \texttt{\bs tb}: \emph{Cu\tb{It} indicates copper bought in Italy}. And a usage example of \texttt{\bs ts}: \emph{Cher G\tp{le} Napol\'eon}.
+
+
+Then several commands for the correct typesetting of unit of measurements are provided. For example the command \texttt{\bs un} typesets its argument in roman and leaves a thin space between the number and the unit: $25\un{m}$, $3.5\un{m/s}$. Other commands are: (\texttt{\bs g}) 45\g, (\texttt{\bs C}) 30\,\C, (\texttt{\bs A}) 12\,\A, (\texttt{\bs micro}) 40\,\micro m, (\texttt{\bs ohm}) 27\,\ohm.
+
+We have also \texttt{\bs x} as abbreviation of \texttt{\bs times}: \texttt{\$7 \bs x 10\^{}5\$} gives $7 \x 10^5$. Then \texttt{\bs di} is the differential symbol which automatically insert the correct spacing.
+\[
+\int x \di x
+\]
+
+Finally we have defined the color \textsf{sapred} which is the official color
+of Sapienza -- University of Rome. It is defined as RGB(130,36,51). \textcolor{sapred}{This text is written with the color \textsf{sapred}.}
+
+In the following dummy text you can observe the usage of \texttt{\bs mnote} command which typesets fancy margin notes.
+
+\textcolor{gray}{\lipsum}
+\marginpar{This is a fancy margin note!}
+\textcolor{gray}{\lipsum}
+
+\backmatter
+% bibliography
+%\cleardoublepage
+%\phantomsection
+%\bibliographystyle{sapthesis} % BibTeX style
+%\bibliography{bibliography} % BibTeX database without .bib extension
+
+\end{document}
diff --git a/macros/latex/contrib/sapthesis/examples/TFA.tex b/macros/latex/contrib/sapthesis/examples/TFA.tex
new file mode 100644
index 0000000000..ddebabbf4d
--- /dev/null
+++ b/macros/latex/contrib/sapthesis/examples/TFA.tex
@@ -0,0 +1,229 @@
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = it_IT
+
+\documentclass[TFA,oneside]{sapthesis}
+
+% READ THE DOCUMENTATION!
+
+\usepackage{microtype}
+\usepackage[italian]{babel}
+\usepackage[utf8]{inputenx}
+
+\usepackage{hyperref}
+\hypersetup{pdftitle={Esempio relazione TFA},pdfauthor={Francesco Biccari}}
+
+% If you need to increase the line spacing (interlinea)
+%\usepackage{setspace}
+%\onehalfspacing
+
+% Remove in a normal thesis
+\usepackage{lipsum}
+\usepackage{curve2e}
+\definecolor{gray}{gray}{0.4}
+\newcommand{\bs}{\textbackslash}
+
+
+% Commands for the titlepage
+\title{Esempio d'uso della classe Sapthesis\\ per la relazione di tirocinio del TFA}
+\author{Francesco Biccari}
+\IDnumber{1234567}
+\course{A027 Matematica e Fisica}
+\courseorganizer{Facoltà di Scienze Matematiche, Fisiche e Naturali}
+\AcademicYear{2012/2013}
+\copyyear{2013}
+\advisor{Prof. Nome Cognome}
+\tutor{Prof.ssa Nome Cognome}
+\tutorcoord{Prof.ssa Nome Cognome}
+\authoremail{biccari@email.com}
+\schoolname{Liceo Scientifico Louis Pasteur}
+\schooladdress{Via G. Barellai 130, 00135 Roma}
+\schoolwebsite{http://www.liceopasteur.it/}
+\schoolprincipal{Prof.ssa Nome Cognome}
+
+\examdate{9 luglio 2013}
+\examiner{Prof. Nome Cognome}
+\examiner{Prof. Nome Cognome}
+\examiner{Prof. Nome Cognome}
+\examiner{Prof. Nome Cognome}
+\examiner{Prof. Nome Cognome (tutor coord.)}
+\examiner{Prof. Nome Cognome (tutor)}
+\examiner{Prof. Nome Cognome (dirigente scolastico nominato dall'USR)}
+\examiner{Prof. Nome Cognome (tutor coord. supplente)}
+
+\versiondate{\today}
+
+
+
+\begin{document}
+
+\frontmatter
+
+\maketitle
+
+\dedication{Dedicato a\\ Donald Knuth}
+
+\begin{acknowledgments}[Ringraziamenti]
+Ho deciso di scrivere i ringraziamenti in italiano
+per dimostrare la mia gratitudine verso i membri
+del GuIT, il Gruppo Utilizzatori Italiani di \TeX, e, in particolare,
+verso il prof. Enrico Gregorio.
+\end{acknowledgments}
+
+\tableofcontents
+
+% Do not use the starred version of the chapter command!
+\chapter{Capitolo non numerato}
+
+In this manual you can skip the gray text because it is just dummy text.%
+\footnote{This is a footnote.}
+
+\textcolor{gray}{\lipsum[1-22]}
+
+
+\section*{Paragrafo non numerato}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum[1-22]}
+
+
+
+
+\mainmatter
+
+\chapter{Style features of \textsf{sapthesis}}
+
+In this chapter I will discuss my stylistic choices of \textsf{sapthesis}.
+I will show the page layout geometry and I will describe the page style.
+
+\section{Page layout}
+
+The page is fixed at the dimensions of an A4 paper, therefore you have to print your thesis on A4 paper to obtain the best results. The font dimension is fixed at 11\, pt. The text column and the margins are chosen to fill to the best an A4 paper while keeping a reasonable line length (396\, pt) for a good readability. The text height and the text width are in golden ratio (\textasciitilde 1.6180) as well as the outer and inner margins in a two-side document after binding margin removal. Also the top margin (excluding the header) and bottom margin are in the golden ratio. In Fig.~\ref{layout} a sketch of the \textsf{sapthesis} page layout is shown.
+
+\begin{figure}[h]
+\centering
+\setlength{\unitlength}{0.27mm}
+\begin{picture}(420,297)(-210,0)
+\polyline(-210,0)(210,0)(210,297)(-210,297)(-210,0)
+\Line(0,0)(0,297)
+\put(27.05,37.4){\polygon(0,0)(139.2,0)(139.2,223.8)(0,223.8)}
+\put(-27.05,37.4){\polygon(0,0)(-139.2,0)(-139.2,223.8)(0,223.8)}
+\put(27.05,268.16){\polygon(0,0)(139.2,0)(139.2,4.22)(0,4.22)}
+\put(-27.05,268.16){\polygon(0,0)(-139.2,0)(-139.2,4.22)(0,4.22)}
+\end{picture}
+\caption{Page layout scheme of \textsf{sapthesis class} using a zero binding margin.}
+\label{layout}
+\end{figure}
+
+
+\section{Page style}
+
+The captions have a smaller font respect to the text and the label is in boldface. The appearance of the margin notes has been improved.
+They have the same font dimension of the footnotes and are typed in italics.
+Moreover I defined a new command to typeset margin note aligned to the left on the right page and vice versa on the left page.
+Notice that if a binding margin greater than 1.5\, cm is used, the dimensions of the margin notes become too small and very ugly.
+Do not use them in this case.
+
+The mathematical objects, figures and tables are numbered within the chapters (e.g. 1.1, 1.2,\ldots for the first chapter, 2.1, 2.2 for the second one and so on\ldots). See for example the number of this simple equation
+\begin{equation}
+x_{1,2}=\frac{-b\pm\sqrt{b^2-4ac}}{2a}
+\end{equation}
+
+
+The title page is automatically composed when the \texttt{\bs maketitle} command is given.
+The parameters needed for the title page, author, title, etc\ldots , are supplied by dedicated commands explained in the next section.
+Two copies of the university logo in \texttt{pdf} format, one for color printing and the other one for black and white printing, are supplied in the \textsf{sapthesis} package. They are shown in Fig.~\ref{fig:largenenough}.
+
+\begin{figure}
+\centering
+\includegraphics[width=0.7\textwidth]{sapienza-MLred-pos}\\[3ex]
+\includegraphics[width=0.7\textwidth]{sapienza-MLblack-pos}
+\caption{Logo of the Sapienza -- University of Rome.}
+\label{fig:largenenough}
+\end{figure}
+
+
+
+\section{About figures and tables}
+
+As regards the image formats, please use vector images as much as possible! Use jpg images only for photographs! pdf\LaTeX\ supports the pdf, jpg and png formats.
+
+A very simple table is show in Tab.~\ref{tab:letters}. Remember to typeset
+always the table caption above the table. Do not use vertical lines.
+
+\begin{table}
+\caption{This is a simple table.}
+\label{tab:letters}
+\centering
+\begin{tabular}{lcc}
+\toprule
+Letter & Test & Test \\
+\midrule
+A & C & E \\
+B & D & F \\
+\bottomrule
+\end{tabular}
+\end{table}
+
+
+\section{A section}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum[1-10]}
+
+
+
+\section{Another section}
+
+In this manual you can skip the gray text because it is just dummy text.
+
+\textcolor{gray}{\lipsum}
+
+
+\appendix
+\chapter{Special commands provided by \textsf{sapthesis}}
+
+\textsf{Sapthesis} provides some special commands, particularly useful for scientific works. You can use for example the roman shape, instead of the italic, for the imaginary unit (\texttt{\bs iu}) and Napier's number (\texttt{\bs eu}):
+\begin{equation}
+\eu^{\iu\pi}+1=0
+\end{equation}
+
+There are also two commands to speed up the writing of derivatives. In the following example we have used the commands \texttt{\bs der} and \texttt{\bs pder}):
+\begin{equation}
+\der{f}{x} \qquad \pder{f}{*{2}{y}}
+\end{equation}
+
+
+\textsf{Sapthesis} provides also 4 commands to improve the writing of subscripts, \texttt{\bs rb} and \texttt{\bs tb}, and superscripts, \texttt{\bs rp} and \texttt{\bs tp}. Two of these commands, \texttt{\bs rb} and \texttt{\bs rp}, can be used both in text and in math mode and compose their argument in roman. The other two, \texttt{\bs tb} and \texttt{\bs tp}, can be used only in text mode and compose their argument as are. Here it is an usage example of \texttt{\bs rb} and \texttt{\bs rp}:
+\[
+a_b \neq a\rb{b}\qquad a^b \neq a\rp{b}
+\]
+And here it is an usage example of \texttt{\bs tb}: \emph{Cu\tb{It} indicates copper bought in Italy}. And a usage example of \texttt{\bs ts}: \emph{Cher G\tp{le} Napol\'eon}.
+
+
+Then several commands for the correct typesetting of unit of measurements are provided. For example the command \texttt{\bs un} typesets its argument in roman and leaves a thin space between the number and the unit: $25\un{m}$, $3.5\un{m/s}$. Other commands are: (\texttt{\bs g}) 45\g, (\texttt{\bs C}) 30\,\C, (\texttt{\bs A}) 12\,\A, (\texttt{\bs micro}) 40\,\micro m, (\texttt{\bs ohm}) 27\,\ohm.
+
+We have also \texttt{\bs x} as abbreviation of \texttt{\bs times}: \texttt{\$7 \bs x 10\^{}5\$} gives $7 \x 10^5$. Then \texttt{\bs di} is the differential symbol which automatically insert the correct spacing.
+\[
+\int x \di x
+\]
+
+Finally we have defined the color \textsf{sapred} which is the official color
+of Sapienza -- University of Rome. It is defined as RGB(130,36,51). \textcolor{sapred}{This text is written with the color \textsf{sapred}.}
+
+In the following dummy text you can observe the usage of \texttt{\bs mnote} command which typesets fancy margin notes.
+
+\textcolor{gray}{\lipsum}
+\marginpar{This is a fancy margin note!}
+\textcolor{gray}{\lipsum}
+
+\backmatter
+% bibliography
+%\cleardoublepage
+%\phantomsection
+%\bibliographystyle{sapthesis} % BibTeX style
+%\bibliography{bibliography} % BibTeX database without .bib extension
+
+\end{document}
diff --git a/macros/latex/contrib/sapthesis/sapienza-MLblack-pos.pdf b/macros/latex/contrib/sapthesis/sapienza-MLblack-pos.pdf
new file mode 100644
index 0000000000..f8b64b193e
--- /dev/null
+++ b/macros/latex/contrib/sapthesis/sapienza-MLblack-pos.pdf
Binary files differ
diff --git a/macros/latex/contrib/sapthesis/sapienza-MLred-pos.pdf b/macros/latex/contrib/sapthesis/sapienza-MLred-pos.pdf
new file mode 100644
index 0000000000..348c7c9c09
--- /dev/null
+++ b/macros/latex/contrib/sapthesis/sapienza-MLred-pos.pdf
Binary files differ
diff --git a/macros/latex/contrib/sapthesis/sapthesis-doc.pdf b/macros/latex/contrib/sapthesis/sapthesis-doc.pdf
new file mode 100644
index 0000000000..80268090c7
--- /dev/null
+++ b/macros/latex/contrib/sapthesis/sapthesis-doc.pdf
Binary files differ
diff --git a/macros/latex/contrib/sapthesis/sapthesis-doc.tex b/macros/latex/contrib/sapthesis/sapthesis-doc.tex
new file mode 100644
index 0000000000..67c736eceb
--- /dev/null
+++ b/macros/latex/contrib/sapthesis/sapthesis-doc.tex
@@ -0,0 +1,649 @@
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = en_US
+
+
+\documentclass[a5paper,11pt]{article}
+
+\usepackage[scale=0.85, footskip=0.8cm,heightrounded]{geometry}
+\usepackage[T1]{fontenc}
+\usepackage[scaled=1]{newtxtext}
+\usepackage{textcomp}
+\usepackage{amsmath}
+\usepackage[varg,cmintegrals,cmbraces]{newtxmath}
+\usepackage{microtype}
+\usepackage{graphicx}
+\usepackage{color}
+\definecolor{gray}{gray}{0.4}
+\definecolor{sfondoblu}{rgb}{0.94,0.97,1}
+\usepackage{listings}
+\lstset{language=[LaTeX]TeX,
+ basicstyle=\scriptsize\ttfamily,
+ keywordstyle=\color{blue}\bfseries,
+ commentstyle=\color{gray},
+ backgroundcolor=\color{sfondoblu},
+ frameround=tttt,
+ frame=tlrb,
+ escapechar=|,
+ morekeywords={submitdate, cycle, courseorganizer, AcademicYear, copyyear, Faculty, course, PhDorganizer, IDnumber, advisor, examdate, examiner, authoremail, frontmatter, mainmatter, maketitle, tableofcontents, chapter, appendix, backmatter, dedication, selectlanguage, tutor, tutorcoord, schoolname, schooladdress, schoolwebsite, schoolprincipal},
+ columns=flexible
+}
+
+\usepackage{multicol}
+
+% eliminate dots in the table of contents
+\makeatletter
+\renewcommand{\@dotsep}{10000}
+\makeatother
+
+\usepackage[bookmarks=false,hyperfootnotes=false]{hyperref}
+\hypersetup{
+ colorlinks=true,
+ linkcolor=blue,
+ anchorcolor=blue,
+ citecolor=blue,
+ urlcolor=blue,
+ pdftitle={sapthesis.cls documentation},
+ pdfauthor={Francesco Biccari}
+}
+
+\newcommand{\bs}{\textbackslash}
+\newcommand{\sq}{\textquotesingle}
+
+\author{\small Francesco Biccari\thanks{\href{mailto:biccari@gmail.com}{biccari@gmail.com}}}
+\title{\small Documentation of the \LaTeX\ class\\
+ \Large \textbf{\texttt{sapthesis.cls}}\\
+ \small \vspace{0.2cm} Version 4.1, 2018-08-07
+}
+\date{}
+
+% degree
+ \providecommand{\degree}{\mbox{\textdegree}}
+ \providecommand{\g}{\degree}
+
+ % gradi Celsius
+ \providecommand{\celsius}{\ensuremath{\textrm{\upshape\textdegree}\kern-\scriptspace\mathrm{C}}}
+ \providecommand{\C}{\celsius}
+
+ % Angstrom
+ \providecommand{\angstrom}{\mbox{\AA}}
+ \providecommand{\A}{\angstrom}
+
+ % micro
+ \providecommand{\micro}{\mbox{\textmu}}
+
+ % Ohm
+ \providecommand{\ohm}{\ensuremath{\mbox{\textohm}}}
+
+ % Napier's number
+ \providecommand{\eu}{\ensuremath{\mathrm{e}}}
+
+ % imaginary unit
+ \providecommand{\iu}{\ensuremath{\mathrm{i}}}
+
+ % roman subscript
+ \providecommand*{\rb}[1]{\ensuremath{_\mathrm{#1}}}
+
+ % roman superscript
+ \providecommand*{\rp}[1]{\ensuremath{^\mathrm{#1}}}
+
+ % differential (only math)
+ \providecommand{\di}{\mathop{}\!d}
+
+ % derivative and partial derivative (only math)
+ \providecommand*{\der}[3][]{\frac{d^{#1}#2}{d #3^{#1}}}
+ \providecommand*{\pder}[3][]{%
+ \frac{\partial^{#1}#2}{\partial #3^{#1}}%
+ }
+
+ % measurement unit
+ \providecommand*{\un}[1]{\ensuremath{\mathrm{\,#1}}}
+
+
+\begin{document}
+\maketitle
+
+\begin{abstract}\noindent
+This document describes how to use \texttt{sapthesis.cls}, a \LaTeX\ document class for the typesetting of the theses of the ``Sapienza -- University of Rome''. The official web page of \textsf{sapthesis} is\\
+{\footnotesize\url{http://biccari.altervista.org/c/informatica/latex/sapthesis.php}}.
+\end{abstract}
+
+\setcounter{tocdepth}{2}
+\renewcommand{\columnseprule}{0.4pt}
+\setlength{\columnsep}{1.5cm}
+
+\addtocontents{toc}{\protect\begin{multicols}{2}}
+{\small
+\tableofcontents}
+
+\clearpage
+
+\section{Introduction}
+
+After several years in my faculty I noticed that usually students spend a lot of time to refine the aesthetic aspect of their \LaTeX\ documents instead of focusing on the content.
+This is against the philosophy of \LaTeX, which was created to relieve the writer from the typesetter's work.
+Apart from the time spent, the resulting documents are obviously all different from each other and good aesthetic results are not always achieved.
+This has a negative impact both on the student's work and on the university.
+Moreover in 2007 the Sapienza university changed completely its
+logo and a lot of strict graphic rules for official documents were introduced.%
+\footnote{A thesis is not an official document and therefore these guidelines can not be applied (private communication with Laura Gobbo, Ufficio Stampa e Comunicazione Sapienza -- Universit\`a di Roma).
+However some Microsoft Word templates, with a completely different style, are provided.
+To give a look to the new Sapienza style see
+\href{https://www.uniroma1.it/it/pagina/marchio-identita-visiva-e-sistema-grafico}{Marchio, identità visiva e sistema grafico} and \href{https://www.uniroma1.it/it/pagina/impaginazione-della-tesi-e-logo}{Template tesi}.}
+
+For these reasons I thought that a \LaTeX\ class for the theses of my
+university would have been a good idea.
+\textsf{Sapthesis} is the result of my work.
+To give a look to a document composed by \textsf{sapthesis} class, compile one of the several examples in the \texttt{examples} directory.
+In those files the page layout and the layout choices are explained.
+\textsf{Sapthesis} is released under the terms of the latest version of the
+\href{http://www.latex-project.org/lppl/}{\LaTeX\ Project Public License}.
+
+I would like to thank the Italian \TeX\ user group (\href{http://www.guitex.org/}{GuIT}) for the help provided, in particular Enrico Gregorio and Claudio Beccari. I would also thank all the users who reported bugs and suggestions.
+
+\section[Requirements\\ and installation]{Requirements and installation}
+\label{requirements_installation}
+
+The simplest way to install \textsf{sapthesis} is by the package manager of
+your \TeX\ distribution (\TeX\ Live or MiK\TeX). For manual installation see
+the \texttt{README} file.
+
+The \textsf{sapthesis} package provides: the
+\texttt{sapthesis.cls} class file; the documentation
+\texttt{sapthesis-doc.pdf} (this file) and its source code; the logos of
+Sapienza university; several usage examples; an English Bib\TeX\ style, called
+\texttt{sapthesis.bst}, which can be used, obviously, only if you use the
+Bib\TeX\ way to compose your bibliography and if your thesis is written in
+English (its usage is not mandatory).
+
+
+\textsf{Sapthesis} explicitely loads the packages \textsf{xkeyval}, \textsf{etoolbox}, \textsf{geometry}, \textsf{ifxetex}, \textsf{xltxtra}, \textsf{fontenc}, \textsf{textcomp}, \textsf{lmodern}, \textsf{caption}, \textsf{graphicx}, \textsf{color}, \textsf{booktabs}, \textsf{amsmath}, \textsf{fancyhdr}.
+Do \textbf{not} include these packages in the preamble of your document!
+
+
+
+
+
+\section{Usage}
+
+A \LaTeX\ document based on \textsf{sapthesis} can be compiled only by the commands
+\texttt{pdflatex} and \texttt{xelatex}. In this manual only \texttt{pdflatex} will be considered.
+
+
+As usual, in order to use this class, you need to call it by
+\begin{lstlisting}
+\documentclass[|\textit{\texttt{options}}|]{sapthesis}
+\end{lstlisting}
+You have to specify the class options for your case (see Sec.~\ref{class_options}). Then you have to provide some fundamental information (title, author, etc\ldots) by specific commands in the preamble (see Sec.~\ref{commands_titlepage}). Finally, remember to follow a source code structure similar to those of the examples given in App.~\ref{sec:PhDexample} and~\ref{sec:LaMexample}.
+Especially the usage of the commands \texttt{\bs frontmatter}, \texttt{\bs mainmatter} and \texttt{\bs backmatter} is mandatory, otherwise the page style of the document will be wrong!
+
+This class supports, at the moment, two languages: Italian and English. English is the default.
+If your thesis contains only English or very few paragraphs in another language, do not use the \texttt{babel} package because completely useless. Instead, if you write in italian, load the \texttt{babel} package with the
+\texttt{italian} option: \texttt{\bs usepackage[italian]\{babel\}}.
+
+\subsection{Class options}
+\label{class_options}
+The following options can be passed to the \texttt{\bs documentclass} command.
+
+\begin{description}
+\item[\texttt{PhD}] Option to typeset a \textit{Dottorato di Ricerca} (PhD) thesis.
+\item[\texttt{LaM}] Option to typeset a \textit{Laurea Magistrale} (Master's degree) thesis.
+\item[\texttt{Lau}] Option to typeset a \textit{Laurea} (Bachelor's degree) thesis.
+\item[\texttt{MasterP}] Option to typeset a thesis for a \textit{Master di primo livello} (First level master).
+\item[\texttt{MasterS}] Option to typeset a thesis for a \textit{Master di secondo livello} (Second level master).
+\item[\texttt{TFA}] Option to typeset the final report for a \textit{Tirocinio Formativo Attivo}.
+\item[\texttt{Specialization}] Option to typeset a thesis for a \textit{Specializzazione}.
+
+\item[\texttt{draft}] The usual \texttt{draft} option of the \LaTeX\ Standard Classes.
+\item[\texttt{oneside}] The usual \texttt{oneside} option of the \LaTeX\ Standard Classes.
+\item[\texttt{twoside}] (default) The usual \texttt{twoside} option of the \LaTeX\ Standard Classes.
+
+\item[\texttt{bn}] This option typesets the title page in black and white
+(using the b/w logo, \texttt{sapienza-MLblack-pos.pdf}, instead of the colored one) and passes the \texttt{monochrome} option to \textsf{color} and
+\textsf{xcolor} packages.
+
+\item[\texttt{binding=\textsl{length}}] (zero default binding)
+The value of this option is an offset of the text column.
+It is useful to take into account the margin for the binding (ask to your bookbinder for information).
+\item[\texttt{noexaminfo}] Suppress all the final exam informations. Indeed, by default, \textsf{sapthesis} shows some information about the final thesis discussion on the back of the title page. By default it shows the phrase ``Thesis not yet defended''. Otherwise, as explained later, giving the commands
+\texttt{\bs examdate\{\dots\}} and \texttt{\bs examiner\{\dots\}} the date and
+the examiners list are shown.
+\item[\texttt{italian} or \texttt{english}] Explicitly declare the language of
+the title page. Useful when you want to write the title page in a language
+and the thesis in a different language.
+\item[\texttt{nodefaultfont}] Avoid the loading of packages \textsf{fontenc}, \textsf{textcomp} and \textsf{lmodern}.
+\item[\texttt{romandiff}] See App.~\ref{sec:usefulcommands}.
+\item[\texttt{fem}] Use the feminine (only Italian): shows ``candidata'' instead of ``candidato''.
+\end{description}
+
+\subsection[Commands for the\\ title page]{Commands for the title page}
+\label{commands_titlepage}
+
+As usual, the title page is generated by the \texttt{\bs maketitle} command.
+It needs some information that you can supply by the following commands
+in the preamble.
+\begin{description}
+\item[\texttt{\bs title\{\dots\}}] Mandatory. Title.
+
+\item[\texttt{\bs subtitle\{\dots\}}] Optional. Subtitle (try to avoid a subtitle).
+
+\item[\texttt{\bs author\{\dots\}}] Mandatory. Author (student's name).
+
+\item[\texttt{\bs IDnumber\{\dots\}}] Mandatory. ID number (\textit{matricola} in Italian).
+
+\item[\texttt{\bs course[\dots]\{\dots\}}] Mandatory. Use the official Italian name of the course. If the optional argument \texttt{override} is specified, the mandatory argument is used to specify the entire course line in the frontispiece. In this way it is possible to override the behavior of the class (not recommended!).
+
+\item[\texttt{\bs courseorganizer\{\dots\}}] Mandatory. Course organizer.
+
+\item[\texttt{\bs submitdate\{\dots\}}] Mandatory. Use the form \texttt{\bs submitdate\{April 2009\}} for PhD's and the form \texttt{\bs submitdate\{2009/2010\}} for Laurea theses.
+
+\item[\texttt{\bs AcademicYear\{\dots\}}] Alias for \texttt{\bs submitdate}. Academic Year.
+
+\item[\texttt{\bs copyyear\{\dots\}}] Mandatory. Copyright year (usually the
+graduation year).
+
+\item[\texttt{\bs advisor\{\dots\}}] You must specify at least one advisor.
+If you have more than one advisor, put several advisor commands in the correct order:\\
+\texttt{\bs advisor\{Prof.~Pippo\}} \texttt{\bs advisor\{Dr.~Pluto\}}
+
+\item[\texttt{\bs coadvisor[\dots]\{\dots\}}] Optional. Co-advisors of the thesis.
+Same syntax of the \texttt{\bs advisor} command. If the optional argument \texttt{ext} is specified, ``External advisor'' will be printed instead of ``Co-Advisor''.
+
+\item[\texttt{\bs reviewer\{\dots\}}] Optional. Reviewers of the thesis.
+Same syntax of the \texttt{\bs advisor} command. The list of the reviewer is preceded by the a text which can be specified by the \texttt{\bs reviewerlabel\{\dots\}} command.
+
+\item[\texttt{\bs authoremail\{\dots\}}] Mandatory. Email of the thesis author.
+It is automatically hyper-linked if \textsf{hyperref} package is loaded.
+
+\item[\texttt{\bs versiondate\{\dots\}}] Optional. Date version of the thesis.
+
+\item[\texttt{\bs website\{\dots\}}] Optional. Thesis website. Automatically
+hyper-linked if \textsf{hyperref} package is loaded.
+
+\item[\texttt{\bs ISBN\{\dots\}}] Optional. ISBN
+
+\item[\texttt{\bs copyrightstatement\{\dots\}}] Optional. Specify a copyright statement that will be printed in place of the default one.
+
+
+\item[\texttt{\bs examdate\{\dots\}}] Optional. Date of the final exam.\\
+Example: \texttt{\bs examdate\{16 February 2010\}}.
+
+\item[\texttt{\bs examiner[\dots]\{\dots\}}] Optional. Specifies the members of the
+board of examiners of the final exam. Usage similar to \texttt{\bs advisor} command. The optional argument can be used to specify the role of that examiner in the commission.
+
+\item[\texttt{\bs cycle\{\dots\}}] Mandatory only for PhD's. Use the form: \texttt{\bs cycle\{XXII\}}
+
+\item[\texttt{\bs director\{\dots\}}] Only for Specialization. Mandatory.
+
+\item[\texttt{\bs tutor\{\dots\}} and \texttt{\bs tutorcoord\{\dots\}}] Only for TFA. Mandatory.
+
+\item[\texttt{\bs schoolname\{\dots\}}] Only for TFA. Mandatory. Name of the school.
+\item[\texttt{\bs schooladdress\{\dots\}}] Only for TFA. Mandatory. School's address.
+\item[\texttt{\bs schoolwebsite\{\dots\}}] Only for TFA. Optional. School's website.
+\item[\texttt{\bs schoolprincipal\{\dots\}}] Only for TFA. Mandatory. School's principal.
+
+\end{description}
+
+
+
+\subsection[Other commands\\ and environments]{Other commands and environments}
+
+\begin{description}
+
+\item[\texttt{\bs dedication\{\dots\}}] A command to compose the dedication.
+
+\item[\texttt{abstract}] An environment to compose the abstract of your document. This environment has an optional parameter to choose the title of the abstract section.
+If you use a language for the abstract different from that of the thesis, consider the \texttt{\bs selectlanguage\{\dots\}} command provided by the \texttt{babel} package.
+
+\item[\texttt{acknowledgments}] An environment to compose the acknowledgments of your document. This environment has an optional parameter to choose the title of the acknowledgments section.
+If you use a language for the acknowledgments different from that of the thesis, consider the \texttt{\bs selectlanguage\{\dots\}} command provided by the \texttt{babel} package.
+
+
+\end{description}
+
+The \texttt{sapthesis} class defines also the color \texttt{sapred} which is the \emph{Sapienza red}: RGB(130,36,51).
+This color is switched to black if the \texttt{bn} option is in use. Example of usage: \texttt{\ldots \bs textcolor\{sapred\}\{blah blah blah\}\ldots}
+
+
+\section{Recommendations}
+
+\begin{itemize}
+
+\item Do \textbf{not} change the default layout. If you want to change the interline spacing, do not use the \texttt{\bs linespread} command. Load instead the \textsf{setspace} package and use, for example, the \texttt{\bs onehalfspacing} command.
+
+\item Do \textbf{not} load the packages already loaded by \textsf{sapthesis} (see Sec.~\ref{requirements_installation}).
+
+\item As you already should know, \LaTeX\ can process only documents
+in pure ASCII. If you want to insert \emph{directly} other characters, not included in the 128 ASCII characters (for example accented letters), you have to use a particular text encoding for your source file. Then you have to ``tell'' to \LaTeX\ which encoding you have chosen by the packages \texttt{inputenc}. It is always recommended to use UTF-8 character encoding and specify this choice also by the \emph{magic lines} at the beginning of the source code (see the examples in App.~\ref{sec:PhDexample} and~\ref{sec:LaMexample}).
+
+\item Respect the following thesis structure:
+
+\begin{itemize}
+\item Title page (\texttt{\bs maketitle} command)
+\item Dedication (\texttt{\bs dedication} command)
+\item Abstract (\texttt{abstract} environment)
+\item Acknowledgements (\texttt{acknowledgments} environment)
+\item Table of contents (\texttt{\bs tableofcontens} command)
+\item Chapters
+\item Appendices
+\item Bibliography
+\end{itemize}
+
+\item It is recommended to avoid or limit the acknowledgments in a thesis, it
+is not very professional. The dedication should be enough.
+
+\item Do not put any preface in your thesis. The preface should be written only by an eminent expert in the field to comment exceptionally important results of the student.
+
+\item Usually tables and figures are centered. Remember that, according to the typographic rules, the table captions should be placed \textbf{above} the table, whereas the figure caption should be placed \textbf{below} the figure.
+
+\item If the figure has a small width, it is possible to put the figure caption
+aside the figure using the \texttt{sidecap} package (not preloaded by \textsf{sapthesis}).
+
+\item Avoid the use of colors unless really necessary. Remember that the figures should be readable even if they are printed in gray scale!
+
+\item Subscripts and superscripts should be in italic if they represent variable quantities, whereas should be in roman if they are simply labels.
+
+\item The name of operators should be typed in roman. Example: use $\sin$ (\texttt{\$\bs sin\$}) instead of $sin$ (\texttt{\$sin\$}).
+
+\item The margin notes are rarely used in scientific documents and should \textbf{not} be used in a scientific thesis.
+
+\item Do not divide the bibliography per chapter unless it is \textbf{really} necessary.
+This will save you from wasting a lot of time to prepare your \LaTeX\ source code.
+Order your bibliography alphabetically according to the
+first author surname: this order is very useful, contrary to the other typical order, the citation order.
+
+\end{itemize}
+
+
+\appendix
+
+\section{A very brief introduction to the \TeX\ world}
+
+Many people want to (or are compelled to) write in \LaTeX\ without studying
+a basic manual. Here follows a very brief introduction to the \TeX\ world.
+
+\TeX, the document preparation system designed by Donald Knuth in 1978, is a program to typeset documents.
+It is a mark-up language: you write a simple text decorated with \TeX\ commands (source code) which is then compiled to obtain the final product, a document in pdf format.
+\LaTeX\ is just a set of macros, written in \TeX, to simplify the writing of the source code: it can be thought as a simpler programming language with respect to \TeX. A source code written in \LaTeX\ can be compiled by several ``compilers'': \texttt{pdflatex} (the most common), or \texttt{xelatex}, or others.
+
+The following list of \LaTeX\ manuals, may be especially useful for Italian authors.
+
+\begin{itemize}
+\item \href{http://www.lorenzopantieri.net/LaTeX_files/ArteLaTeX.pdf}{\textsc{L.
+Pantieri \& T. Gordini}, \textit{L'arte di scrivere con} \LaTeX, (2017)}
+
+\item \href{http://mirror.ctan.org/info/symbols/comprehensive/symbols-a4.pdf}{\textsc{S. Pakin}, \textit{The comprehensive} \LaTeX\ \textit{symbol list}, (2017)}
+
+\item \href{http://profs.sci.univr.it/~gregorio/breveguida.pdf}{\textsc{E. Gregorio}, \LaTeX\textit{: breve guida ai pacchetti di uso pi\`u comune}, (2010)}
+\end{itemize}
+
+In order to use \LaTeX, you have to install a \TeX\ distribution. It contains the compilers, several fonts and other files needed by the compilers and also many \emph{packages}, which can be thought as libraries or extensions of \LaTeX. The most famous distributions are \href{http://miktex.org/}{MiKTeX} (available only for Windows), \href{http://www.tug.org/texlive/}{TeX Live} (available both for Windows and Linux) and \href{http://www.tug.org/mactex/2011/}{MacTeX} (available only for Mac OS).
+
+Finally we discuss the editor, that is the program used to write your source file. Since a source file written in \LaTeX, like in any other programming language, is a simple text file, you can write your code with any text editor you want (for example Notepad in Windows). However the suggested editors are:
+\begin{itemize}
+\item \href{http://tug.org/texworks/}{TeXworks}. Already installed with any \TeX\ distribution. Very simple and powerful. Use TeXworks if you are not an expert. Enrico Gregorio has written a very good and brief TeXworks manual in Italian, which can be found at: {\small \url{http://profs.sci.univr.it/~gregorio/introtexworks.pdf}}.
+
+\item \href{http://texstudio.sourceforge.net/}{TeXstudio} (cross-platform), \href{http://www.xm1math.net/texmaker/}{TeXmaker} (cross-platform), \href{http://pages.uoregon.edu/koch/texshop/}{TeXshop} (only for Mac), \href{http://kile.sourceforge.net/}{Kile} (only for Linux). Powerful editors.
+
+\item \textbf{Avoid} other editors unless you know what you are doing!
+
+\end{itemize}
+
+Finally we explain how to compile the example documents provided in the \textsf{sapthesis} package. Double click on one of the \texttt{.tex} file in the \texttt{examples} folder.
+TeXworks should start showing the content of that file.
+The \texttt{pdflatex} compiler should be automatically selected thanks to the \emph{magic lines} placed at the beginning of the file.
+Now, in order to compile, press the green button.
+At the end of the compilation the resulting pdf appears in a separate window. Remember to compile at least three times, because \LaTeX\ needs more than one compilation to correctly resolve the internal cross references (for example for the table of contents composition, or when you refer to a figure by the \texttt{\bs label}\,--\,\texttt{\bs ref}\,/\,\texttt{\bs pageref} mechanism).
+
+
+
+\section{Using LyX}
+
+LyX is an advanced \LaTeX\ editor which does not simply show the source code like any text editor, but instead it renders maths, images, tables and some text formatting commands. However this ``layer'' between the writer and the real source code is sometimes frustrating and many authors discourage the usage of LyX.
+
+Using \textsf{sapthesis} with LyX is quite straightforward.
+\begin{itemize}
+\item
+Install \textsf{sapthesis} by the package manager of your \TeX\ distribution or manually.
+
+\item
+Copy the file \texttt{sapthesis.layout} in the directory\\ \texttt{C:\bs Program Files\bs Lyx20\bs Resources\bs layouts\bs}\\ and then, in LyX, click on \textsf{Tools > Reconfigure}. This will add the \textsf{sapthesis} class in the list of LyX available classes.
+
+\item
+In LyX, first of all, go in \textsf{Tools > Preferences > Language Settings > Language} and choose ``none'' in Language package. This step is necessary because LyX not only loads babel with the desired language, but it passes the language also as an option for the class! This triggers an error in many classes.
+
+\item
+Create a new document and go in \textsf{Document > Settings > Document Class}. Here you can choose \textsf{sapthesis} as the class for the document and write the class options.
+
+\item
+Write the preamble in \textsf{Document > Settings > LaTeX Preamble}.
+
+\item Create the titlepage inserting the title by the \textsf{Title} item in the LyX left menu.
+
+\end{itemize}
+
+It is recommended to activate \textsf{View > Source Pane}. This step is not necessary but it is very useful to observe the \LaTeX\ code produced by LyX (on the right choose ``Complete source'' or ``Preamble'').
+
+
+
+
+
+\clearpage
+\section{PhD thesis example}
+\label{sec:PhDexample}
+
+\begin{lstlisting}
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = en_US
+
+\documentclass[binding=0.6cm,PhD]{sapthesis}
+
+\usepackage{microtype}
+\usepackage{hyperref}
+\hypersetup{pdftitle={My thesis},pdfauthor={Francesco Biccari}}
+
+\title{My thesis}
+\author{Francesco Biccari}
+\IDnumber{123456}
+\course[Philology]{Filologia}
+\courseorganizer{Scuola di Dottorato in Scienze Filologiche}
+\cycle{XXII}
+\submitdate{October 2009}
+\copyyear{2009}
+\advisor{Prof. Caio}
+\advisor{Dr. Sempronio}
+\authoremail{pippo@pippo.com}
+
+\begin{document}
+
+\frontmatter
+\maketitle
+\dedication{Dedicated to\\ Donald Knuth}
+
+\begin{abstract}
+This thesis deals with myself.
+\end{abstract}
+
+\tableofcontents
+
+\mainmatter
+\chapter{Introduction}
+...
+
+\backmatter
+\cleardoublepage
+\phantomsection % Give this command only if hyperref is loaded
+\addcontentsline{toc}{chapter}{\bibname}
+% Here put the code for the bibliography. You can use BibTeX or
+% the BibLaTeX package or the simple environment thebibliography.
+
+\end{document}
+\end{lstlisting}
+
+
+\clearpage
+\section[Laurea (Magistrale)\\ thesis example]{Laurea (Magistrale) thesis example}
+\label{sec:LaMexample}
+
+\begin{lstlisting}
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = it_IT
+
+\documentclass[binding=0.6cm,Lau]{sapthesis} % LaM for a Laurea Magistrale
+
+\usepackage{microtype}
+\usepackage[italian]{babel}
+\usepackage[utf8]{inputenc}
+\usepackage{hyperref}
+\hypersetup{pdftitle={La mia tesi},pdfauthor={Francesco Biccari}}
+
+\title{La mia tesi}
+\author{Francesco Biccari}
+\IDnumber{123456}
+\course{Fisica}
+\courseorganizer{Facolt|\`a| di Scienze Matematiche, Fisiche e Naturali}
+\AcademicYear{2011/2012}
+\copyyear{2012}
+\advisor{Prof. Caio}
+\advisor{Dr. Sempronio}
+\authoremail{pippo@pippo.com}
+
+\begin{document}
+
+\frontmatter
+\maketitle
+\dedication{Dedicato a\\ Donald Knuth}
+
+\begin{abstract}
+Questa tesi parla di me.
+\end{abstract}
+
+\tableofcontents
+
+\mainmatter
+\chapter{Introduzione}
+...
+
+\backmatter
+\cleardoublepage
+\phantomsection % Give this command only if hyperref is loaded
+\addcontentsline{toc}{chapter}{\bibname}
+% Here put the code for the bibliography. You can use BibTeX or
+% the BibLaTeX package or the simple environment thebibliography.
+
+\end{document}
+\end{lstlisting}
+
+
+\clearpage
+\section{TFA thesis example}
+\label{sec:TFAexample}
+
+\begin{lstlisting}
+% !TeX encoding = UTF-8
+% !TeX program = pdflatex
+% !TeX spellcheck = it_IT
+
+\documentclass[binding=0.6cm,TFA]{sapthesis}
+
+\usepackage{microtype}
+\usepackage[italian]{babel}
+\usepackage[utf8]{inputenc}
+\usepackage{hyperref}
+\hypersetup{pdftitle={La mia tesi},pdfauthor={Francesco Biccari}}
+
+\title{La mia tesi}
+\author{Francesco Biccari}
+\IDnumber{123456}
+\course{A049 Matematica e Fisica}
+\courseorganizer{Facolt|\`a| di Scienze Matematiche, Fisiche e Naturali}
+\AcademicYear{2012/2013}
+\copyyear{2013}
+\advisor{Prof. Caio}
+\tutor{Dr. Sempronio}
+\tutorcoord{Dr. Sempronio}
+\authoremail{pippo@pippo.com}
+
+\schoolname{Liceo Scientifico Louis Pasteur}
+\schooladdress{Via G. Barellai 130, 00135 Roma}
+\schoolwebsite{http://www.liceopasteur.it/}
+\schoolprincipal{Prof. Diego Armando Maradona}
+
+\begin{document}
+
+\frontmatter
+\maketitle
+\dedication{Dedicato a\\ Donald Knuth}
+
+\tableofcontents
+
+\mainmatter
+\chapter{Introduzione}
+...
+
+\backmatter
+\cleardoublepage
+\phantomsection % Give this command only if hyperref is loaded
+\addcontentsline{toc}{chapter}{\bibname}
+% Here put the code for the bibliography. You can use BibTeX or
+% the BibLaTeX package or the simple environment thebibliography.
+
+\end{document}
+\end{lstlisting}
+
+\clearpage
+\section{Other useful commands}
+\label{sec:usefulcommands}
+
+\begin{description}
+\item[\texttt{\bs eu}] Napier's number, $\mathrm{e}$, in roman.
+
+\item[\texttt{\bs iu}] Imaginary unit, $\mathrm{i}$, in roman.
+
+\item[\texttt{\bs der\{\dots\}\{\dots\}}] Derivative. The first argument represents the function to derive while the second the variables separated by commas. The differential symbol is automatically inserted. Examples:
+\texttt{\bs der\{f\}\{x\}}, \texttt{\bs der\{f\}\{x,y\}}, \texttt{\bs der\{f\}\{*\{3\}\{x\}\}},
+\texttt{\bs der\{f\}\{*\{2\}\{x\},*\{2\}\{y\},z\}}.
+
+\item[\texttt{\bs pder\{\dots\}\{\dots\}}] Partial derivative. Same syntax of the \texttt{\bs der} command.
+
+\item[\texttt{\bs rb\{\dots\}}] Roman suBscript
+
+\item[\texttt{\bs rp\{\dots\}}] Roman suPerscript
+
+\item[\texttt{\bs tb\{\dots\}}] Text suBscript
+
+\item[\texttt{\bs tp\{\dots\}}] Text suPerscript
+
+\item[\texttt{\bs un\{\dots\}}] Useful command to typeset measurement units in the correct way, e.g. \texttt{25\bs un\{m/s\}},
+\texttt{13\bs un\{kg\bs ,cm\^{}\{-3\}\}}. It can be used both inside or outside the math environment.
+For heavy usage of measurement units and to insert numbers in the form
+\texttt{1.4e-5}, the package \textsf{siunitx} is recommended.
+
+\item[\texttt{\bs mnote\{\dots\}}] Fancy margin notes
+
+\item[\texttt{\bs g}] Shortcut for the \texttt{\bs degree} command. Example: \texttt{45\bs g} produces 45\g.
+
+\item[\texttt{\bs C}] Shortcut for the \texttt{\bs celsius} command. Example: \texttt{37\bs ,\bs C} produces 37\,\C. (Not available in math mode compiling with \texttt{xelatex}).
+
+\item[\texttt{\bs A}] Angstrom. Example: \texttt{10\bs ,\bs A} produces 10\,\A.
+
+\item[\texttt{\bs micro}] Micro prefix. Example: \texttt{7\bs ,\bs micro m} produces 7\,\micro m.
+
+\item[\texttt{\bs ohm}] Ohm. Example: \texttt{100\bs ,\bs ohm} produces 100\,\ohm.
+
+\item[\texttt{\bs di}] Differential symbol with automatic spacing.\\ Example:
+\texttt{\$\bs int x \bs di x\$} produces $\int x \di x$. If you prefer the differential symbol in roman ($\mathrm{d}$) you can give the option \texttt{romandiff} in the document class options.
+
+\item[\texttt{\bs x}] Shortcut for the \texttt{\bs times} command. E.g.: \texttt{\$7 \bs x 10\^{}5\$} produces $7 \times 10^5$.
+
+\end{description}
+
+
+
+
+
+
+\addtocontents{toc}{\protect\end{multicols}}
+\end{document}
diff --git a/macros/latex/contrib/sapthesis/sapthesis.bst b/macros/latex/contrib/sapthesis/sapthesis.bst
new file mode 100644
index 0000000000..ddd5ffb93a
--- /dev/null
+++ b/macros/latex/contrib/sapthesis/sapthesis.bst
@@ -0,0 +1,1778 @@
+%%
+%% This is file `sapthesis.bst',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% merlin.mbs (with options: `head,exlang,nm-rev,jnrlst,nmlm,x9,m1,nmft,nmft-sc,yr-par,xmth,vol-bf,vnum-x,volp-com,jdt-vs,jpg-1,num-xser,isbn,edpar,edby-par,english,pp,ed,abr,xedn,nfss,,{}')
+%% english.mbs (with options: `exlang,nm-rev,jnrlst,nmlm,x9,m1,nmft,nmft-sc,yr-par,xmth,vol-bf,vnum-x,volp-com,jdt-vs,jpg-1,num-xser,isbn,edpar,edby-par,english,pp,ed,abr,xedn,nfss,,{}')
+%% merlin.mbs (with options: `tail,exlang,nm-rev,jnrlst,nmlm,x9,m1,nmft,nmft-sc,yr-par,xmth,vol-bf,vnum-x,volp-com,jdt-vs,jpg-1,num-xser,isbn,edpar,edby-par,english,pp,ed,abr,xedn,nfss,,{}')
+%% ----------------------------------------
+%% *** ***
+%%
+%% Copyright 1994-2007 Patrick W Daly
+ % ===============================================================
+ % IMPORTANT NOTICE:
+ % This bibliographic style (bst) file has been generated from one or
+ % more master bibliographic style (mbs) files, listed above.
+ %
+ % This generated file can be redistributed and/or modified under the terms
+ % of the LaTeX Project Public License Distributed from CTAN
+ % archives in directory macros/latex/base/lppl.txt; either
+ % version 1 of the License, or any later version.
+ % ===============================================================
+ % Name and version information of the main mbs file:
+ % \ProvidesFile{merlin.mbs}[2007/04/24 4.20 (PWD, AO, DPC)]
+ % For use with BibTeX version 0.99a or later
+ %-------------------------------------------------------------------
+ % This bibliography style file is intended for texts in
+ % ENGLISH
+ % This is a numerical citation style, and as such is standard LaTeX.
+ % It requires no extra package to interface to the main text.
+ % The form of the \bibitem entries is
+ % \bibitem{key}...
+ % Usage of \cite is as follows:
+ % \cite{key} ==>> [#]
+ % \cite[chap. 2]{key} ==>> [#, chap. 2]
+ % where # is a number determined by the ordering in the reference list.
+ % The order in the reference list is alphabetical by authors.
+ %---------------------------------------------------------------------
+
+ENTRY
+ { address
+ author
+ booktitle
+ chapter
+ edition
+ editor
+ eid
+ howpublished
+ institution
+ isbn
+ journal
+ key
+ month
+ note
+ number
+ organization
+ pages
+ publisher
+ school
+ series
+ title
+ type
+ volume
+ year
+ eprint % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+ doi % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+ pubmed % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+ url % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+ lastchecked % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+ }
+ {}
+ { label }
+INTEGERS { output.state before.all mid.sentence after.sentence after.block }
+STRINGS { urlintro eprinturl eprintprefix doiprefix doiurl pubmedprefix pubmedurl openinlinelink closeinlinelink } % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl...
+INTEGERS { hrefform inlinelinks makeinlinelink addeprints adddoiresolver addpubmedresolver }
+% Following constants may be adjusted by hand, if desired
+FUNCTION {init.urlbst.variables}
+{
+ "Available from: " 'urlintro := % prefix before URL
+ "http://arxiv.org/abs/" 'eprinturl := % prefix to make URL from eprint ref
+ "arXiv:" 'eprintprefix := % text prefix printed before eprint ref
+ "http://dx.doi.org/" 'doiurl := % prefix to make URL from DOI
+ "doi:" 'doiprefix := % text prefix printed before DOI ref
+ "http://www.ncbi.nlm.nih.gov/pubmed/" 'pubmedurl := % prefix to make URL from PUBMED
+ "PMID:" 'pubmedprefix := % text prefix printed before PUBMED ref
+ #1 'addeprints := % 0=no eprints; 1=include eprints
+ #1 'adddoiresolver := % 0=no DOI resolver; 1=include it
+ #0 'addpubmedresolver := % 0=no PUBMED resolver; 1=include it
+ #2 'hrefform := % 0=no crossrefs; 1=hypertex xrefs; 2=hyperref refs
+ #0 'inlinelinks := % 0=URLs explicit; 1=URLs attached to titles
+ % the following are internal state variables, not config constants
+ #0 'makeinlinelink := % state variable managed by setup.inlinelink
+ "" 'openinlinelink := % ditto
+ "" 'closeinlinelink := % ditto
+}
+INTEGERS {
+ bracket.state
+ outside.brackets
+ open.brackets
+ within.brackets
+ close.brackets
+}
+% ...C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl to here
+FUNCTION {init.state.consts}
+{ #0 'outside.brackets := % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+ #1 'open.brackets :=
+ #2 'within.brackets :=
+ #3 'close.brackets :=
+
+ #0 'before.all :=
+ #1 'mid.sentence :=
+ #2 'after.sentence :=
+ #3 'after.block :=
+}
+STRINGS { s t}
+% C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+FUNCTION {output.nonnull.original}
+{ 's :=
+ output.state mid.sentence =
+ { ", " * write$ }
+ { output.state after.block =
+ { add.period$ write$
+ newline$
+ "\newblock " write$
+ }
+ { output.state before.all =
+ 'write$
+ { add.period$ " " * write$ }
+ if$
+ }
+ if$
+ mid.sentence 'output.state :=
+ }
+ if$
+ s
+}
+
+% C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl...
+% The following three functions are for handling inlinelink. They wrap
+% a block of text which is potentially output with write$ by multiple
+% other functions, so we don't know the content a priori.
+% They communicate between each other using the variables makeinlinelink
+% (which is true if a link should be made), and closeinlinelink (which holds
+% the string which should close any current link. They can be called
+% at any time, but start.inlinelink will be a no-op unless something has
+% previously set makeinlinelink true, and the two ...end.inlinelink functions
+% will only do their stuff if start.inlinelink has previously set
+% closeinlinelink to be non-empty.
+FUNCTION {setup.inlinelink}
+{ makeinlinelink
+ { hrefform #1 = % hypertex
+ { "\special {html:<a href=" quote$ * url * quote$ * "> }{" * 'openinlinelink :=
+ "\special {html:</a>}" 'closeinlinelink :=
+ }
+ { hrefform #2 = % hyperref
+ { "\href{" url * "}{" * 'openinlinelink :=
+ "}" 'closeinlinelink :=
+ }
+ 'skip$
+ if$ % hrefform #2 =
+ }
+ if$ % hrefform #1 =
+ #0 'makeinlinelink :=
+ }
+ 'skip$
+ if$ % makeinlinelink
+}
+FUNCTION {add.inlinelink}
+{ openinlinelink empty$
+ 'skip$
+ { openinlinelink swap$ * closeinlinelink *
+ "" 'openinlinelink :=
+ }
+ if$
+}
+FUNCTION {output.nonnull}
+{ % Save the thing we've been asked to output
+ 's :=
+ % If the bracket-state is close.brackets, then add a close-bracket to
+ % what is currently at the top of the stack, and set bracket.state
+ % to outside.brackets
+ bracket.state close.brackets =
+ { "]" *
+ outside.brackets 'bracket.state :=
+ }
+ 'skip$
+ if$
+ bracket.state outside.brackets =
+ { % We're outside all brackets -- this is the normal situation.
+ % Write out what's currently at the top of the stack, using the
+ % original output.nonnull function.
+ s
+ add.inlinelink
+ output.nonnull.original % invoke the original output.nonnull
+ }
+ { % Still in brackets. Add open-bracket or (continuation) comma, add the
+ % new text (in s) to the top of the stack, and move to the close-brackets
+ % state, ready for next time (unless inbrackets resets it). If we come
+ % into this branch, then output.state is carefully undisturbed.
+ bracket.state open.brackets =
+ { " [" * }
+ { ", " * } % bracket.state will be within.brackets
+ if$
+ s *
+ close.brackets 'bracket.state :=
+ }
+ if$
+}
+
+% Call this function just before adding something which should be presented in
+% brackets. bracket.state is handled specially within output.nonnull.
+FUNCTION {inbrackets}
+{ bracket.state close.brackets =
+ { within.brackets 'bracket.state := } % reset the state: not open nor closed
+ { open.brackets 'bracket.state := }
+ if$
+}
+
+FUNCTION {format.lastchecked}
+{ lastchecked empty$
+ { "" }
+ { inbrackets "cited " lastchecked * }
+ if$
+}
+% ...C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl to here
+FUNCTION {output}
+{ duplicate$ empty$
+ 'pop$
+ 'output.nonnull
+ if$
+}
+FUNCTION {output.check}
+{ 't :=
+ duplicate$ empty$
+ { pop$ "empty " t * " in " * cite$ * warning$ }
+ 'output.nonnull
+ if$
+}
+FUNCTION {fin.entry.original}
+{ add.period$
+ write$
+ newline$
+}
+
+FUNCTION {new.block}
+{ output.state before.all =
+ 'skip$
+ { after.block 'output.state := }
+ if$
+}
+FUNCTION {new.sentence}
+{ output.state after.block =
+ 'skip$
+ { output.state before.all =
+ 'skip$
+ { after.sentence 'output.state := }
+ if$
+ }
+ if$
+}
+FUNCTION {add.blank}
+{ " " * before.all 'output.state :=
+}
+
+FUNCTION {date.block}
+{
+ new.block
+}
+
+FUNCTION {not}
+{ { #0 }
+ { #1 }
+ if$
+}
+FUNCTION {and}
+{ 'skip$
+ { pop$ #0 }
+ if$
+}
+FUNCTION {or}
+{ { pop$ #1 }
+ 'skip$
+ if$
+}
+FUNCTION {new.block.checka}
+{ empty$
+ 'skip$
+ 'new.block
+ if$
+}
+FUNCTION {new.block.checkb}
+{ empty$
+ swap$ empty$
+ and
+ 'skip$
+ 'new.block
+ if$
+}
+FUNCTION {new.sentence.checka}
+{ empty$
+ 'skip$
+ 'new.sentence
+ if$
+}
+FUNCTION {new.sentence.checkb}
+{ empty$
+ swap$ empty$
+ and
+ 'skip$
+ 'new.sentence
+ if$
+}
+FUNCTION {field.or.null}
+{ duplicate$ empty$
+ { pop$ "" }
+ 'skip$
+ if$
+}
+FUNCTION {emphasize}
+{ duplicate$ empty$
+ { pop$ "" }
+ { "\emph{" swap$ * "}" * }
+ if$
+}
+FUNCTION {bolden}
+{ duplicate$ empty$
+ { pop$ "" }
+ { "\textbf{" swap$ * "}" * }
+ if$
+}
+FUNCTION {scaps}
+{ duplicate$ empty$
+ { pop$ "" }
+ { "\textsc{" swap$ * "}" * }
+ if$
+}
+FUNCTION {bib.name.font}
+{ scaps }
+FUNCTION {bib.fname.font}
+{ bib.name.font }
+FUNCTION {tie.or.space.prefix}
+{ duplicate$ text.length$ #3 <
+ { "~" }
+ { " " }
+ if$
+ swap$
+}
+
+FUNCTION {capitalize}
+{ "u" change.case$ "t" change.case$ }
+
+FUNCTION {space.word}
+{ " " swap$ * " " * }
+ % Here are the language-specific definitions for explicit words.
+ % Each function has a name bbl.xxx where xxx is the English word.
+ %-------------------------------------------------------------------
+ % Begin module:
+ % \ProvidesFile{english.mbs}[2003/11/06 4.2 (PWD)]
+
+ % The language selected here is ENGLISH
+FUNCTION {bbl.and}
+{ "and"}
+
+FUNCTION {bbl.etal}
+{ "et~al." }
+
+FUNCTION {bbl.editors}
+{ "eds." }
+
+FUNCTION {bbl.editor}
+{ "ed." }
+
+FUNCTION {bbl.edby}
+{ "edited by" }
+
+FUNCTION {bbl.edition}
+{ "edn." }
+
+FUNCTION {bbl.volume}
+{ "vol." }
+
+FUNCTION {bbl.of}
+{ "of" }
+
+FUNCTION {bbl.number}
+{ "no." }
+
+FUNCTION {bbl.nr}
+{ "no." }
+
+FUNCTION {bbl.in}
+{ "in" }
+
+FUNCTION {bbl.pages}
+{ "pp." }
+
+FUNCTION {bbl.page}
+{ "p." }
+
+FUNCTION {bbl.chapter}
+{ "chap." }
+
+FUNCTION {bbl.techrep}
+{ "Tech. Rep." }
+
+FUNCTION {bbl.mthesis}
+{ "Master's thesis" }
+
+FUNCTION {bbl.phdthesis}
+{ "Ph.D. thesis" }
+
+MACRO {jan} {"Jan."}
+
+MACRO {feb} {"Feb."}
+
+MACRO {mar} {"Mar."}
+
+MACRO {apr} {"Apr."}
+
+MACRO {may} {"May"}
+
+MACRO {jun} {"Jun."}
+
+MACRO {jul} {"Jul."}
+
+MACRO {aug} {"Aug."}
+
+MACRO {sep} {"Sep."}
+
+MACRO {oct} {"Oct."}
+
+MACRO {nov} {"Nov."}
+
+MACRO {dec} {"Dec."}
+
+ % End module: english.mbs
+%% Copyright 1994-2007 Patrick W Daly
+MACRO {acmcs} {"ACM Computing Surveys"}
+
+MACRO {acta} {"Acta Informatica"}
+
+MACRO {cacm} {"Communications of the ACM"}
+
+MACRO {ibmjrd} {"IBM Journal of Research and Development"}
+
+MACRO {ibmsj} {"IBM Systems Journal"}
+
+MACRO {ieeese} {"IEEE Transactions on Software Engineering"}
+
+MACRO {ieeetc} {"IEEE Transactions on Computers"}
+
+MACRO {ieeetcad}
+ {"IEEE Transactions on Computer-Aided Design of Integrated Circuits"}
+
+MACRO {ipl} {"Information Processing Letters"}
+
+MACRO {jacm} {"Journal of the ACM"}
+
+MACRO {jcss} {"Journal of Computer and System Sciences"}
+
+MACRO {scp} {"Science of Computer Programming"}
+
+MACRO {sicomp} {"SIAM Journal on Computing"}
+
+MACRO {tocs} {"ACM Transactions on Computer Systems"}
+
+MACRO {tods} {"ACM Transactions on Database Systems"}
+
+MACRO {tog} {"ACM Transactions on Graphics"}
+
+MACRO {toms} {"ACM Transactions on Mathematical Software"}
+
+MACRO {toois} {"ACM Transactions on Office Information Systems"}
+
+MACRO {toplas} {"ACM Transactions on Programming Languages and Systems"}
+
+MACRO {tcs} {"Theoretical Computer Science"}
+FUNCTION {bibinfo.check}
+{ swap$
+ duplicate$ missing$
+ {
+ pop$ pop$
+ ""
+ }
+ { duplicate$ empty$
+ {
+ swap$ pop$
+ }
+ { swap$
+ pop$
+ }
+ if$
+ }
+ if$
+}
+FUNCTION {bibinfo.warn}
+{ swap$
+ duplicate$ missing$
+ {
+ swap$ "missing " swap$ * " in " * cite$ * warning$ pop$
+ ""
+ }
+ { duplicate$ empty$
+ {
+ swap$ "empty " swap$ * " in " * cite$ * warning$
+ }
+ { swap$
+ pop$
+ }
+ if$
+ }
+ if$
+}
+INTEGERS { nameptr namesleft numnames }
+
+
+STRINGS { bibinfo}
+
+FUNCTION {format.names}
+{ 'bibinfo :=
+ duplicate$ empty$ 'skip$ {
+ 's :=
+ "" 't :=
+ #1 'nameptr :=
+ s num.names$ 'numnames :=
+ numnames 'namesleft :=
+ { namesleft #0 > }
+ { s nameptr
+ "{vv~}{ll}{, f.}{, jj}"
+ format.name$
+ bibinfo bibinfo.check
+ 't :=
+ nameptr #1 >
+ {
+ nameptr #1
+ #1 + =
+ numnames #9
+ > and
+ { "others" 't :=
+ #1 'namesleft := }
+ 'skip$
+ if$
+ namesleft #1 >
+ { ", " * t * }
+ {
+ s nameptr "{ll}" format.name$ duplicate$ "others" =
+ { 't := }
+ { pop$ }
+ if$
+ numnames #2 >
+ { "," * }
+ 'skip$
+ if$
+ t "others" =
+ {
+ " " * bbl.etal *
+ bib.name.font
+ }
+ {
+ bbl.and
+ space.word * t *
+ }
+ if$
+ }
+ if$
+ }
+ 't
+ if$
+ nameptr #1 + 'nameptr :=
+ namesleft #1 - 'namesleft :=
+ }
+ while$
+ t "others" =
+ 'skip$
+ { bib.name.font }
+ if$
+ } if$
+}
+FUNCTION {format.names.ed}
+{
+ 'bibinfo :=
+ duplicate$ empty$ 'skip$ {
+ 's :=
+ "" 't :=
+ #1 'nameptr :=
+ s num.names$ 'numnames :=
+ numnames 'namesleft :=
+ { namesleft #0 > }
+ { s nameptr
+ "{f.~}{vv~}{ll}{, jj}"
+ format.name$
+ bibinfo bibinfo.check
+ 't :=
+ nameptr #1 >
+ {
+ namesleft #1 >
+ { ", " * t * }
+ {
+ s nameptr "{ll}" format.name$ duplicate$ "others" =
+ { 't := }
+ { pop$ }
+ if$
+ numnames #2 >
+ { "," * }
+ 'skip$
+ if$
+ t "others" =
+ {
+
+ " " * bbl.etal *
+ }
+ {
+ bbl.and
+ space.word * t *
+ }
+ if$
+ }
+ if$
+ }
+ 't
+ if$
+ nameptr #1 + 'nameptr :=
+ namesleft #1 - 'namesleft :=
+ }
+ while$
+ } if$
+}
+FUNCTION {format.authors}
+{ author "author" format.names
+}
+FUNCTION {get.bbl.editor}
+{ editor num.names$ #1 > 'bbl.editors 'bbl.editor if$ }
+
+FUNCTION {format.editors}
+{ editor "editor" format.names duplicate$ empty$ 'skip$
+ {
+ " " *
+ get.bbl.editor
+ "(" swap$ * ")" *
+ *
+ }
+ if$
+}
+FUNCTION {format.isbn}
+{ isbn "isbn" bibinfo.check
+ duplicate$ empty$ 'skip$
+ {
+ new.block
+ "ISBN " swap$ *
+ }
+ if$
+}
+
+FUNCTION {format.note}
+{
+ note empty$
+ { "" }
+ { note #1 #1 substring$
+ duplicate$ "{" =
+ 'skip$
+ { output.state mid.sentence =
+ { "l" }
+ { "u" }
+ if$
+ change.case$
+ }
+ if$
+ note #2 global.max$ substring$ * "note" bibinfo.check
+ }
+ if$
+}
+
+FUNCTION {format.title}
+{ title
+ duplicate$ empty$ 'skip$
+ { "t" change.case$ }
+ if$
+ "title" bibinfo.check
+}
+FUNCTION {output.bibitem.original}
+{ newline$
+ "\bibitem{" write$
+ cite$ write$
+ "}" write$
+ newline$
+ ""
+ before.all 'output.state :=
+}
+
+FUNCTION {n.dashify}
+{
+ 't :=
+ ""
+ { t empty$ not }
+ { t #1 #1 substring$ "-" =
+ { t #1 #2 substring$ "--" = not
+ { "--" *
+ t #2 global.max$ substring$ 't :=
+ }
+ { { t #1 #1 substring$ "-" = }
+ { "-" *
+ t #2 global.max$ substring$ 't :=
+ }
+ while$
+ }
+ if$
+ }
+ { t #1 #1 substring$ *
+ t #2 global.max$ substring$ 't :=
+ }
+ if$
+ }
+ while$
+}
+
+FUNCTION {word.in}
+{ bbl.in capitalize
+ " " * }
+
+FUNCTION {format.date}
+{
+ ""
+ duplicate$ empty$
+ year "year" bibinfo.check duplicate$ empty$
+ { swap$ 'skip$
+ { "there's a month but no year in " cite$ * warning$ }
+ if$
+ *
+ }
+ { swap$ 'skip$
+ {
+ swap$
+ " " * swap$
+ }
+ if$
+ *
+ }
+ if$
+ duplicate$ empty$
+ 'skip$
+ {
+ before.all 'output.state :=
+ " (" swap$ * ")" *
+ }
+ if$
+}
+FUNCTION{format.year}
+{ year "year" bibinfo.check duplicate$ empty$
+ { "empty year in " cite$ *
+ warning$
+ }
+ {
+ " (" swap$ * ")" *
+ }
+ if$
+}
+FUNCTION {format.btitle}
+{ title "title" bibinfo.check
+ duplicate$ empty$ 'skip$
+ {
+ emphasize
+ }
+ if$
+}
+FUNCTION {either.or.check}
+{ empty$
+ 'pop$
+ { "can't use both " swap$ * " fields in " * cite$ * warning$ }
+ if$
+}
+FUNCTION {format.bvolume}
+{ volume empty$
+ { "" }
+ { bbl.volume volume tie.or.space.prefix
+ "volume" bibinfo.check * *
+ series "series" bibinfo.check
+ duplicate$ empty$ 'pop$
+ { swap$ bbl.of space.word * swap$
+ emphasize * }
+ if$
+ "volume and number" number either.or.check
+ }
+ if$
+}
+FUNCTION {format.number.series}
+{ volume empty$
+ { number empty$
+ { series field.or.null }
+ { series empty$
+ { number "number" bibinfo.check }
+ { output.state mid.sentence =
+ { bbl.number }
+ { bbl.number capitalize }
+ if$
+ number tie.or.space.prefix "number" bibinfo.check * *
+ bbl.in space.word *
+ series "series" bibinfo.check *
+ }
+ if$
+ }
+ if$
+ }
+ { "" }
+ if$
+}
+
+FUNCTION {format.edition}
+{ edition duplicate$ empty$ 'skip$
+ {
+ output.state mid.sentence =
+ { "l" }
+ { "t" }
+ if$ change.case$
+ "edition" bibinfo.check
+ " " * bbl.edition *
+ }
+ if$
+}
+INTEGERS { multiresult }
+FUNCTION {multi.page.check}
+{ 't :=
+ #0 'multiresult :=
+ { multiresult not
+ t empty$ not
+ and
+ }
+ { t #1 #1 substring$
+ duplicate$ "-" =
+ swap$ duplicate$ "," =
+ swap$ "+" =
+ or or
+ { #1 'multiresult := }
+ { t #2 global.max$ substring$ 't := }
+ if$
+ }
+ while$
+ multiresult
+}
+FUNCTION {format.pages}
+{ pages duplicate$ empty$ 'skip$
+ { duplicate$ multi.page.check
+ {
+ bbl.pages swap$
+ n.dashify
+ }
+ {
+ bbl.page swap$
+ }
+ if$
+ tie.or.space.prefix
+ "pages" bibinfo.check
+ * *
+ }
+ if$
+}
+FUNCTION {first.page}
+{ 't :=
+ ""
+ { t empty$ not t #1 #1 substring$ "-" = not and }
+ { t #1 #1 substring$ *
+ t #2 global.max$ substring$ 't :=
+ }
+ while$
+}
+
+FUNCTION {format.journal.pages}
+{ pages duplicate$ empty$ 'pop$
+ { swap$ duplicate$ empty$
+ { pop$ pop$ format.pages }
+ {
+ ", " *
+ swap$
+ first.page
+ "pages" bibinfo.check
+ *
+ }
+ if$
+ }
+ if$
+}
+FUNCTION {format.journal.eid}
+{ eid "eid" bibinfo.check
+ duplicate$ empty$ 'pop$
+ { swap$ duplicate$ empty$ 'skip$
+ {
+ ", " *
+ }
+ if$
+ swap$ *
+ }
+ if$
+}
+FUNCTION {format.vol.num.pages}
+{ volume field.or.null
+ duplicate$ empty$ 'skip$
+ {
+ "volume" bibinfo.check
+ }
+ if$
+ bolden
+ format.year *
+ eid empty$
+ { format.journal.pages }
+ { format.journal.eid }
+ if$
+}
+
+FUNCTION {format.chapter.pages}
+{ chapter empty$
+ 'format.pages
+ { type empty$
+ { bbl.chapter }
+ { type "l" change.case$
+ "type" bibinfo.check
+ }
+ if$
+ chapter tie.or.space.prefix
+ "chapter" bibinfo.check
+ * *
+ pages empty$
+ 'skip$
+ { ", " * format.pages * }
+ if$
+ }
+ if$
+}
+
+FUNCTION {format.booktitle}
+{
+ booktitle "booktitle" bibinfo.check
+ emphasize
+}
+FUNCTION {format.in.ed.booktitle}
+{ format.booktitle duplicate$ empty$ 'skip$
+ {
+ editor "editor" format.names.ed duplicate$ empty$ 'pop$
+ {
+ bbl.edby
+ " " * swap$ *
+ "(" swap$ * ")" *
+ swap$
+ " " * swap$
+ * }
+ if$
+ word.in swap$ *
+ }
+ if$
+}
+FUNCTION {empty.misc.check}
+{ author empty$ title empty$ howpublished empty$
+ month empty$ year empty$ note empty$
+ and and and and and
+ key empty$ not and
+ { "all relevant fields are empty in " cite$ * warning$ }
+ 'skip$
+ if$
+}
+FUNCTION {format.thesis.type}
+{ type duplicate$ empty$
+ 'pop$
+ { swap$ pop$
+ "t" change.case$ "type" bibinfo.check
+ }
+ if$
+}
+FUNCTION {format.tr.number}
+{ number "number" bibinfo.check
+ type duplicate$ empty$
+ { pop$ bbl.techrep }
+ 'skip$
+ if$
+ "type" bibinfo.check
+ swap$ duplicate$ empty$
+ { pop$ "t" change.case$ }
+ { tie.or.space.prefix * * }
+ if$
+}
+FUNCTION {format.article.crossref}
+{
+ key duplicate$ empty$
+ { pop$
+ journal duplicate$ empty$
+ { "need key or journal for " cite$ * " to crossref " * crossref * warning$ }
+ { "journal" bibinfo.check emphasize word.in swap$ * }
+ if$
+ }
+ { word.in swap$ * " " *}
+ if$
+ " \cite{" * crossref * "}" *
+}
+FUNCTION {format.crossref.editor}
+{ editor #1 "{vv~}{ll}" format.name$
+ "editor" bibinfo.check
+ editor num.names$ duplicate$
+ #2 >
+ { pop$
+ "editor" bibinfo.check
+ " " * bbl.etal
+ *
+ }
+ { #2 <
+ 'skip$
+ { editor #2 "{ff }{vv }{ll}{ jj}" format.name$ "others" =
+ {
+ "editor" bibinfo.check
+ " " * bbl.etal
+ *
+ }
+ {
+ bbl.and space.word
+ * editor #2 "{vv~}{ll}" format.name$
+ "editor" bibinfo.check
+ *
+ }
+ if$
+ }
+ if$
+ }
+ if$
+}
+FUNCTION {format.book.crossref}
+{ volume duplicate$ empty$
+ { "empty volume in " cite$ * "'s crossref of " * crossref * warning$
+ pop$ word.in
+ }
+ { bbl.volume
+ capitalize
+ swap$ tie.or.space.prefix "volume" bibinfo.check * * bbl.of space.word *
+ }
+ if$
+ editor empty$
+ editor field.or.null author field.or.null =
+ or
+ { key empty$
+ { series empty$
+ { "need editor, key, or series for " cite$ * " to crossref " *
+ crossref * warning$
+ "" *
+ }
+ { series emphasize * }
+ if$
+ }
+ { key * }
+ if$
+ }
+ { format.crossref.editor * }
+ if$
+ " \cite{" * crossref * "}" *
+}
+FUNCTION {format.incoll.inproc.crossref}
+{
+ editor empty$
+ editor field.or.null author field.or.null =
+ or
+ { key empty$
+ { format.booktitle duplicate$ empty$
+ { "need editor, key, or booktitle for " cite$ * " to crossref " *
+ crossref * warning$
+ }
+ { word.in swap$ * }
+ if$
+ }
+ { word.in key * " " *}
+ if$
+ }
+ { word.in format.crossref.editor * " " *}
+ if$
+ " \cite{" * crossref * "}" *
+}
+FUNCTION {format.org.or.pub}
+{ 't :=
+ ""
+ address empty$ t empty$ and
+ 'skip$
+ {
+ t empty$
+ { address "address" bibinfo.check *
+ }
+ { t *
+ address empty$
+ 'skip$
+ { ", " * address "address" bibinfo.check * }
+ if$
+ }
+ if$
+ }
+ if$
+}
+FUNCTION {format.publisher.address}
+{ publisher "publisher" bibinfo.warn format.org.or.pub
+}
+
+FUNCTION {format.organization.address}
+{ organization "organization" bibinfo.check format.org.or.pub
+}
+
+% C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl...
+% Functions for making hypertext links.
+% In all cases, the stack has (link-text href-url)
+%
+% make 'null' specials
+FUNCTION {make.href.null}
+{
+ pop$
+}
+% make hypertex specials
+FUNCTION {make.href.hypertex}
+{
+ "\special {html:<a href=" quote$ *
+ swap$ * quote$ * "> }" * swap$ *
+ "\special {html:</a>}" *
+}
+% make hyperref specials
+FUNCTION {make.href.hyperref}
+{
+ "\href {" swap$ * "} {\path{" * swap$ * "}}" *
+}
+FUNCTION {make.href}
+{ hrefform #2 =
+ 'make.href.hyperref % hrefform = 2
+ { hrefform #1 =
+ 'make.href.hypertex % hrefform = 1
+ 'make.href.null % hrefform = 0 (or anything else)
+ if$
+ }
+ if$
+}
+
+% If inlinelinks is true, then format.url should be a no-op, since it's
+% (a) redundant, and (b) could end up as a link-within-a-link.
+FUNCTION {format.url}
+{ inlinelinks #1 = url empty$ or
+ { "" }
+ { hrefform #1 =
+ { % special case -- add HyperTeX specials
+ urlintro "\url{" url * "}" * url make.href.hypertex * }
+ { urlintro "\url{" * url * "}" * }
+ if$
+ }
+ if$
+}
+
+FUNCTION {format.eprint}
+{ eprint empty$
+ { "" }
+ { eprintprefix eprint * eprinturl eprint * make.href }
+ if$
+}
+
+FUNCTION {format.doi}
+{ doi empty$
+ { "" }
+ { doiprefix doi * doiurl doi * make.href }
+ if$
+}
+
+FUNCTION {format.pubmed}
+{ pubmed empty$
+ { "" }
+ { pubmedprefix pubmed * pubmedurl pubmed * make.href }
+ if$
+}
+
+% Output a URL. We can't use the more normal idiom (something like
+% `format.url output'), because the `inbrackets' within
+% format.lastchecked applies to everything between calls to `output',
+% so that `format.url format.lastchecked * output' ends up with both
+% the URL and the lastchecked in brackets.
+FUNCTION {output.url}
+{ url empty$
+ 'skip$
+ { new.block
+ format.url output
+ format.lastchecked output
+ }
+ if$
+}
+
+FUNCTION {output.web.refs}
+{
+ new.block
+ output.url
+ addeprints eprint empty$ not and
+ { format.eprint output.nonnull }
+ 'skip$
+ if$
+ adddoiresolver doi empty$ not and
+ { format.doi output.nonnull }
+ 'skip$
+ if$
+ addpubmedresolver pubmed empty$ not and
+ { format.pubmed output.nonnull }
+ 'skip$
+ if$
+}
+
+% Wrapper for output.bibitem.original.
+% If the URL field is not empty, set makeinlinelink to be true,
+% so that an inline link will be started at the next opportunity
+FUNCTION {output.bibitem}
+{ outside.brackets 'bracket.state :=
+ output.bibitem.original
+ inlinelinks url empty$ not and
+ { #1 'makeinlinelink := }
+ { #0 'makeinlinelink := }
+ if$
+}
+
+% Wrapper for fin.entry.original
+FUNCTION {fin.entry}
+{ output.web.refs % urlbst
+ makeinlinelink % ooops, it appears we didn't have a title for inlinelink
+ { setup.inlinelink % add some artificial link text here, as a fallback
+ "[link]" output.nonnull }
+ 'skip$
+ if$
+ bracket.state close.brackets = % urlbst
+ { "]" * }
+ 'skip$
+ if$
+ fin.entry.original
+}
+
+% Webpage entry type.
+% Title and url fields required;
+% author, note, year, month, and lastchecked fields optional
+% See references
+% ISO 690-2 http://www.nlc-bnc.ca/iso/tc46sc9/standard/690-2e.htm
+% http://www.classroom.net/classroom/CitingNetResources.html
+% http://neal.ctstateu.edu/history/cite.html
+% http://www.cas.usf.edu/english/walker/mla.html
+% for citation formats for web pages.
+FUNCTION {webpage}
+{ output.bibitem
+ author empty$
+ { editor empty$
+ 'skip$ % author and editor both optional
+ { format.editors output.nonnull }
+ if$
+ }
+ { editor empty$
+ { format.authors output.nonnull }
+ { "can't use both author and editor fields in " cite$ * warning$ }
+ if$
+ }
+ if$
+ new.block
+ title empty$ 'skip$ 'setup.inlinelink if$
+ format.title "title" output.check
+ inbrackets "online" output
+ new.block
+ year empty$
+ 'skip$
+ { format.date "year" output.check }
+ if$
+ % We don't need to output the URL details ('lastchecked' and 'url'),
+ % because fin.entry does that for us, using output.web.refs. The only
+ % reason we would want to put them here is if we were to decide that
+ % they should go in front of the rather miscellaneous information in 'note'.
+ new.block
+ note output
+ fin.entry
+}
+% ...C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl to here
+
+
+FUNCTION {article}
+{ output.bibitem
+ format.authors "author" output.check
+ new.block
+ title empty$ 'skip$ 'setup.inlinelink if$ % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+ format.title "title" output.check
+ new.block
+ crossref missing$
+ {
+ journal
+ "journal" bibinfo.check
+ emphasize
+ "journal" output.check
+ format.vol.num.pages output
+ }
+ { format.article.crossref output.nonnull
+ format.pages output
+ }
+ if$
+ new.block
+ format.note output
+ fin.entry
+}
+FUNCTION {book}
+{ output.bibitem
+ author empty$
+ { format.editors "author and editor" output.check
+ }
+ { format.authors output.nonnull
+ crossref missing$
+ { "author and editor" editor either.or.check }
+ 'skip$
+ if$
+ }
+ if$
+ new.block
+ title empty$ 'skip$ 'setup.inlinelink if$ % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+ format.btitle "title" output.check
+ crossref missing$
+ { format.bvolume output
+ new.block
+ format.number.series output
+ new.sentence
+ format.publisher.address output
+ }
+ {
+ new.block
+ format.book.crossref output.nonnull
+ }
+ if$
+ format.edition output
+ format.date "year" output.check
+ format.isbn output
+ new.block
+ format.note output
+ fin.entry
+}
+FUNCTION {booklet}
+{ output.bibitem
+ format.authors output
+ new.block
+ title empty$ 'skip$ 'setup.inlinelink if$ % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+ format.title "title" output.check
+ new.block
+ howpublished "howpublished" bibinfo.check output
+ address "address" bibinfo.check output
+ format.date output
+ format.isbn output
+ new.block
+ format.note output
+ fin.entry
+}
+
+FUNCTION {inbook}
+{ output.bibitem
+ author empty$
+ { format.editors "author and editor" output.check
+ }
+ { format.authors output.nonnull
+ crossref missing$
+ { "author and editor" editor either.or.check }
+ 'skip$
+ if$
+ }
+ if$
+ new.block
+ title empty$ 'skip$ 'setup.inlinelink if$ % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+ format.btitle "title" output.check
+ crossref missing$
+ {
+ format.bvolume output
+ format.chapter.pages "chapter and pages" output.check
+ new.block
+ format.number.series output
+ new.sentence
+ format.publisher.address output
+ }
+ {
+ format.chapter.pages "chapter and pages" output.check
+ new.block
+ format.book.crossref output.nonnull
+ }
+ if$
+ format.edition output
+ format.date "year" output.check
+ crossref missing$
+ { format.isbn output }
+ 'skip$
+ if$
+ new.block
+ format.note output
+ fin.entry
+}
+
+FUNCTION {incollection}
+{ output.bibitem
+ format.authors "author" output.check
+ new.block
+ title empty$ 'skip$ 'setup.inlinelink if$ % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+ format.title "title" output.check
+ new.block
+ crossref missing$
+ { format.in.ed.booktitle "booktitle" output.check
+ format.bvolume output
+ format.number.series output
+ format.chapter.pages output
+ new.sentence
+ format.publisher.address output
+ format.edition output
+ format.date "year" output.check
+ format.isbn output
+ }
+ { format.incoll.inproc.crossref output.nonnull
+ format.chapter.pages output
+ }
+ if$
+ new.block
+ format.note output
+ fin.entry
+}
+FUNCTION {inproceedings}
+{ output.bibitem
+ format.authors "author" output.check
+ new.block
+ title empty$ 'skip$ 'setup.inlinelink if$ % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+ format.title "title" output.check
+ new.block
+ crossref missing$
+ { format.in.ed.booktitle "booktitle" output.check
+ format.bvolume output
+ format.number.series output
+ format.pages output
+ new.sentence
+ publisher empty$
+ { format.organization.address output }
+ { organization "organization" bibinfo.check output
+ format.publisher.address output
+ }
+ if$
+ format.date "year" output.check
+ format.isbn output
+ }
+ { format.incoll.inproc.crossref output.nonnull
+ format.pages output
+ }
+ if$
+ new.block
+ format.note output
+ fin.entry
+}
+FUNCTION {conference} { inproceedings }
+FUNCTION {manual}
+{ output.bibitem
+ author empty$
+ { organization "organization" bibinfo.check
+ duplicate$ empty$ 'pop$
+ { output
+ address "address" bibinfo.check output
+ }
+ if$
+ }
+ { format.authors output.nonnull }
+ if$
+ new.block
+ title empty$ 'skip$ 'setup.inlinelink if$ % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+ format.btitle "title" output.check
+ author empty$
+ { organization empty$
+ {
+ address new.block.checka
+ address "address" bibinfo.check output
+ }
+ 'skip$
+ if$
+ }
+ {
+ organization address new.block.checkb
+ organization "organization" bibinfo.check output
+ address "address" bibinfo.check output
+ }
+ if$
+ format.edition output
+ format.date output
+ new.block
+ format.note output
+ fin.entry
+}
+
+FUNCTION {mastersthesis}
+{ output.bibitem
+ format.authors "author" output.check
+ new.block
+ title empty$ 'skip$ 'setup.inlinelink if$ % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+ format.btitle
+ "title" output.check
+ new.block
+ bbl.mthesis format.thesis.type output.nonnull
+ school "school" bibinfo.warn output
+ address "address" bibinfo.check output
+ format.date "year" output.check
+ new.block
+ format.note output
+ fin.entry
+}
+
+FUNCTION {misc}
+{ output.bibitem
+ format.authors output
+ title howpublished new.block.checkb
+ title empty$ 'skip$ 'setup.inlinelink if$ % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+ format.title output
+ howpublished new.block.checka
+ howpublished "howpublished" bibinfo.check output
+ format.date output
+ new.block
+ format.note output
+ fin.entry
+ empty.misc.check
+}
+FUNCTION {phdthesis}
+{ output.bibitem
+ format.authors "author" output.check
+ new.block
+ title empty$ 'skip$ 'setup.inlinelink if$ % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+ format.btitle
+ "title" output.check
+ new.block
+ bbl.phdthesis format.thesis.type output.nonnull
+ school "school" bibinfo.warn output
+ address "address" bibinfo.check output
+ format.date "year" output.check
+ new.block
+ format.note output
+ fin.entry
+}
+
+FUNCTION {proceedings}
+{ output.bibitem
+ editor empty$
+ { organization "organization" bibinfo.check output
+ }
+ { format.editors output.nonnull }
+ if$
+ new.block
+ title empty$ 'skip$ 'setup.inlinelink if$ % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+ format.btitle "title" output.check
+ format.bvolume output
+ format.number.series output
+ editor empty$
+ { publisher empty$
+ {
+ new.sentence
+ format.publisher.address output
+ }
+ if$
+ }
+ { publisher empty$
+ {
+ new.sentence
+ format.organization.address output }
+ {
+ new.sentence
+ organization "organization" bibinfo.check output
+ format.publisher.address output
+ }
+ if$
+ }
+ if$
+ format.date "year" output.check
+ format.isbn output
+ new.block
+ format.note output
+ fin.entry
+}
+
+FUNCTION {techreport}
+{ output.bibitem
+ format.authors "author" output.check
+ new.block
+ title empty$ 'skip$ 'setup.inlinelink if$ % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+ format.title
+ "title" output.check
+ new.block
+ format.tr.number output.nonnull
+ institution "institution" bibinfo.warn output
+ address "address" bibinfo.check output
+ format.date "year" output.check
+ new.block
+ format.note output
+ fin.entry
+}
+
+FUNCTION {unpublished}
+{ output.bibitem
+ format.authors "author" output.check
+ new.block
+ title empty$ 'skip$ 'setup.inlinelink if$ % C:\Program Files\MiKTeX 2.8\scripts\urlbst\perl\urlbst.pl
+ format.title "title" output.check
+ format.date output
+ new.block
+ format.note "note" output.check
+ fin.entry
+}
+
+FUNCTION {default.type} { misc }
+READ
+FUNCTION {sortify}
+{ purify$
+ "l" change.case$
+}
+INTEGERS { len }
+FUNCTION {chop.word}
+{ 's :=
+ 'len :=
+ s #1 len substring$ =
+ { s len #1 + global.max$ substring$ }
+ 's
+ if$
+}
+FUNCTION {sort.format.names}
+{ 's :=
+ #1 'nameptr :=
+ ""
+ s num.names$ 'numnames :=
+ numnames 'namesleft :=
+ { namesleft #0 > }
+ { s nameptr
+ "{vv{ } }{ll{ }}{ f{ }}{ jj{ }}"
+ format.name$ 't :=
+ nameptr #1 >
+ {
+ nameptr #1
+ #1 + =
+ numnames #9
+ > and
+ { "others" 't :=
+ #1 'namesleft := }
+ 'skip$
+ if$
+ " " *
+ namesleft #1 = t "others" = and
+ { "zzzzz" * }
+ { t sortify * }
+ if$
+ }
+ { t sortify * }
+ if$
+ nameptr #1 + 'nameptr :=
+ namesleft #1 - 'namesleft :=
+ }
+ while$
+}
+
+FUNCTION {sort.format.title}
+{ 't :=
+ "A " #2
+ "An " #3
+ "The " #4 t chop.word
+ chop.word
+ chop.word
+ sortify
+ #1 global.max$ substring$
+}
+FUNCTION {author.sort}
+{ author empty$
+ { key empty$
+ { "to sort, need author or key in " cite$ * warning$
+ ""
+ }
+ { key sortify }
+ if$
+ }
+ { author sort.format.names }
+ if$
+}
+FUNCTION {author.editor.sort}
+{ author empty$
+ { editor empty$
+ { key empty$
+ { "to sort, need author, editor, or key in " cite$ * warning$
+ ""
+ }
+ { key sortify }
+ if$
+ }
+ { editor sort.format.names }
+ if$
+ }
+ { author sort.format.names }
+ if$
+}
+FUNCTION {author.organization.sort}
+{ author empty$
+ { organization empty$
+ { key empty$
+ { "to sort, need author, organization, or key in " cite$ * warning$
+ ""
+ }
+ { key sortify }
+ if$
+ }
+ { "The " #4 organization chop.word sortify }
+ if$
+ }
+ { author sort.format.names }
+ if$
+}
+FUNCTION {editor.organization.sort}
+{ editor empty$
+ { organization empty$
+ { key empty$
+ { "to sort, need editor, organization, or key in " cite$ * warning$
+ ""
+ }
+ { key sortify }
+ if$
+ }
+ { "The " #4 organization chop.word sortify }
+ if$
+ }
+ { editor sort.format.names }
+ if$
+}
+FUNCTION {presort}
+{ type$ "book" =
+ type$ "inbook" =
+ or
+ 'author.editor.sort
+ { type$ "proceedings" =
+ 'editor.organization.sort
+ { type$ "manual" =
+ 'author.organization.sort
+ 'author.sort
+ if$
+ }
+ if$
+ }
+ if$
+ " "
+ *
+ year field.or.null sortify
+ *
+ " "
+ *
+ title field.or.null
+ sort.format.title
+ *
+ #1 entry.max$ substring$
+ 'sort.key$ :=
+}
+ITERATE {presort}
+SORT
+STRINGS { longest.label }
+INTEGERS { number.label longest.label.width }
+FUNCTION {initialize.longest.label}
+{ "" 'longest.label :=
+ #1 'number.label :=
+ #0 'longest.label.width :=
+}
+FUNCTION {longest.label.pass}
+{ number.label int.to.str$ 'label :=
+ number.label #1 + 'number.label :=
+ label width$ longest.label.width >
+ { label 'longest.label :=
+ label width$ 'longest.label.width :=
+ }
+ 'skip$
+ if$
+}
+EXECUTE {initialize.longest.label}
+ITERATE {longest.label.pass}
+FUNCTION {begin.bib}
+{ preamble$ empty$
+ 'skip$
+ { preamble$ write$ newline$ }
+ if$
+ "\begin{thebibliography}{" longest.label * "}" *
+ write$ newline$
+}
+EXECUTE {begin.bib}
+EXECUTE {init.urlbst.variables}
+EXECUTE {init.state.consts}
+ITERATE {call.type$}
+FUNCTION {end.bib}
+{ newline$
+ "\end{thebibliography}" write$ newline$
+}
+EXECUTE {end.bib}
+%% End of customized bst file
+%%
+%% End of file `sapthesis.bst'.
diff --git a/macros/latex/contrib/sapthesis/sapthesis.cls b/macros/latex/contrib/sapthesis/sapthesis.cls
new file mode 100644
index 0000000000..d420c4a661
--- /dev/null
+++ b/macros/latex/contrib/sapthesis/sapthesis.cls
@@ -0,0 +1,1208 @@
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% sapthesis.cls %%
+%% version 4.1 %%
+%% 2018-08-07 %%
+%% author: Francesco Biccari %%
+%% contact: biccari@gmail.com %%
+%% %%
+%% This file is the LaTeX class for the thesis style %%
+%% of the "Sapienza -- University of Rome" %%
+%% %%
+%% see README for license information and installation %%
+%% see sapthesis-doc.pdf for usage %%
+%% see the examples folder for document examples %%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Identification %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\NeedsTeXFormat{LaTeX2e}[2009/01/01]
+\ProvidesClass{sapthesis}%
+[2018/08/07 Sapienza - University of Rome thesis class]
+
+\def\SAP@classVersion{4.1}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Options %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\RequirePackage{xkeyval}
+\newlength{\SAP@binding}
+\newif\ifSAP@nodefaultfont \SAP@nodefaultfontfalse
+\newif\ifSAP@romandiff \SAP@romandifffalse
+\newif\ifSAP@customlanguage \SAP@customlanguagefalse
+\newif\ifSAP@bn \SAP@bnfalse
+\newif\ifSAP@PhD \SAP@PhDfalse
+\newif\ifSAP@Specialization \SAP@Specializationfalse
+\newif\ifSAP@MasterP \SAP@MasterPfalse
+\newif\ifSAP@MasterS \SAP@MasterSfalse
+\newif\ifSAP@LaM \SAP@LaMfalse
+\newif\ifSAP@Lau \SAP@Laufalse
+\newif\ifSAP@TFA \SAP@TFAfalse
+\newif\ifSAP@noexaminfo \SAP@noexaminfofalse
+\newif\ifSAP@femaleauthor \SAP@femaleauthorfalse
+\newif\ifSAP@overridecourse \SAP@overridecoursefalse
+
+\newcommand{\SAP@customlanguage}{}
+
+\define@key[sap]{}{noexaminfo}[]{\SAP@noexaminfotrue}
+\define@key[sap]{}{fem}[]{\SAP@femaleauthortrue}
+\define@key[sap]{}{nodefaultfont}[]{\SAP@nodefaultfonttrue}
+\define@key[sap]{}{romandiff}[]{\SAP@romandifftrue}
+\define@key[sap]{}{italian}[]{\SAP@customlanguagetrue
+ \renewcommand{\SAP@customlanguage}{\SAP@italian}}
+\define@key[sap]{}{english}[]{\SAP@customlanguagetrue
+ \renewcommand{\SAP@customlanguage}{\SAP@english}}
+\define@key[sap]{}{bn}[]{\SAP@bntrue
+ \PassOptionsToPackage{monochrome}{color}
+ \PassOptionsToPackage{monochrome}{xcolor}}
+\define@key[sap]{}{PhD}[]{\SAP@PhDtrue}
+\define@key[sap]{}{Specialization}[]{\SAP@Specializationtrue}
+\define@key[sap]{}{LaM}[]{\SAP@LaMtrue}
+\define@key[sap]{}{Lau}[]{\SAP@Lautrue}
+\define@key[sap]{}{TFA}[]{\SAP@TFAtrue}
+\define@key[sap]{}{MasterP}[]{\SAP@MasterPtrue\SAP@MasterPtrue}
+\define@key[sap]{}{MasterS}[]{\SAP@MasterStrue\SAP@MasterStrue}
+\define@key[sap]{}{binding}[0pt]{\setlength{\SAP@binding}{#1}}
+\define@key[sap]{}{draft}[]{\PassOptionsToClass{draft}{book}}
+\define@key[sap]{}{oneside}[]{\PassOptionsToClass{oneside}{book}}
+\define@key[sap]{}{twoside}[]{}
+\DeclareOptionX*{\ClassError{sapthesis}{Option '\CurrentOption'%
+ \MessageBreak is not valid}{Remove '\CurrentOption' %
+ from class options}}
+\ProcessOptionsX[sap]<>
+\LoadClass[a4paper,11pt]{book}
+
+
+\ifSAP@PhD\relax\else
+ \ifSAP@Specialization\relax\else
+ \ifSAP@LaM\relax\else
+ \ifSAP@Lau\relax\else
+ \ifSAP@MasterP\relax\else
+ \ifSAP@MasterS\relax\else
+ \ifSAP@TFA\relax\else
+ \ClassError{sapthesis}{You must specify the PhD, LaM, Lau, MasterP, %
+ MasterS, Specialization or TFA option}{}
+ \fi
+ \fi
+ \fi
+ \fi
+ \fi
+ \fi
+\fi
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Page layout %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\RequirePackage[a4paper]{geometry}
+\geometry{textwidth=396pt,
+ textheight=641pt,
+ marginparsep=12pt,
+ bindingoffset=\SAP@binding,
+ vmarginratio=55:89,
+ includehead,
+ marginparwidth=72pt,
+ heightrounded}
+
+\if@twoside\geometry{hmarginratio=55:89}\fi
+
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Some settings%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\RequirePackage{ifxetex}
+\ifxetex
+ \RequirePackage{xltxtra}
+\else
+ \ifSAP@nodefaultfont\relax\else
+ \RequirePackage[T1]{fontenc}
+ \RequirePackage{textcomp}
+ \RequirePackage{lmodern}
+ \fi
+\fi
+\RequirePackage{caption}
+\captionsetup{indention=\parindent,labelfont={small,bf},labelsep=period,%
+ tableposition=top,textfont={small}}
+\RequirePackage{graphicx}
+\RequirePackage{color}
+\RequirePackage{booktabs}
+\RequirePackage{amsmath}
+\RequirePackage{etoolbox}
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Fancy headers %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+%% this two lines remove the headers in the empty pages
+%% (instead of loading the emptypage package)
+\def\cleardoublepage{\clearpage\if@twoside \ifodd\c@page\else
+\thispagestyle{empty}\hbox{}\newpage\fi\fi}
+
+\RequirePackage{fancyhdr}
+
+%% definition of the main page style
+\fancypagestyle{SAP@mainstyle}{%
+\pagestyle{fancy}
+\renewcommand{\chaptermark}[1]{\markboth{\ifnum \c@chapter>0 \thechapter.\ ##1 \else ##1 \fi}{}}
+\renewcommand{\sectionmark}[1]{\markright{\thesection\ ##1}}
+\fancyhf{}
+\fancyhead[OR]{\small\bfseries\thepage}
+\fancyhead[OL]{\small\bfseries\nouppercase{\rightmark}}
+% This check is useful to avoid Warnings with oneside option
+\if@twoside
+\fancyhead[ER]{\small\bfseries\nouppercase{\leftmark}}
+\fancyhead[EL]{\small\bfseries\thepage}
+\fi
+\renewcommand{\headrulewidth}{0.4pt}
+\renewcommand{\footrulewidth}{0pt}}
+
+%% ri-definition of the plain style (first page of the chapters)
+\fancypagestyle{plain}{%
+\renewcommand{\headrulewidth}{0pt}
+\fancyhf{}
+%\fancyfoot[C]{\small\scshape\thepage}
+\fancyhead[OR]{\small\bfseries\thepage}
+% This check is useful to avoid Warnings with oneside option
+\if@twoside
+\fancyhead[EL]{\small\bfseries\thepage}
+\fi
+}
+
+\g@addto@macro\frontmatter{\pagestyle{SAP@mainstyle}}
+\g@addto@macro\mainmatter{\pagestyle{SAP@mainstyle}}
+
+% fancy marginnote
+
+% commands to redefine the marginpar command
+% maybe in future I will remove the mnote command?
+%\def \@marginparreset {%
+% \reset@font
+% \footnotesize
+% \itshape
+% \@setminipage
+%}
+%\long\def\@xmpar[#1]#2{%
+% \@savemarbox\@marbox{\raggedleft #1}%
+% \@savemarbox\@currbox{\raggedright #2}%
+% \@xympar}
+%\long\def\@ympar#1{%
+% \@savemarbox\@marbox{\raggedleft #1}%
+% \@savemarbox\@currbox{\raggedright #1}%
+% \@xympar}
+%
+% simpler version which cannot redefine marginpar. A new command
+% (mnote) is needed
+\g@addto@macro\@marginparreset{\footnotesize\itshape}
+\newcommand{\mnote}[1]{\marginpar[\raggedleft #1]{\raggedright #1}}
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% numbering objects per chapters (e.g. 1.1, 1.2, ...) %%%%%%%%%%%%%%
+
+\numberwithin{equation}{chapter}
+\numberwithin{figure}{chapter}
+\numberwithin{table}{chapter}
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% redefinition of the \maketitle command to generate the titlepage %
+
+%% GENERAL COMMANDS
+
+\def\SAP@subtitle{}
+\def\SAP@courseorganizerLabel{}
+\def\SAP@courseLabel{}
+
+\newcommand{\subtitle}[1]{\def\SAP@subtitle{#1}}
+\newcommand{\courseorganizer}[1]{\def\SAP@courseorganizerLabel{#1}}
+\newcommand{\course}[2][]{%
+ \def\SAP@courseLabel{#2}
+ \ifstrequal{#1}{override}{\SAP@overridecoursetrue}{}}
+
+\def\SAP@copyyear{}
+\newcommand{\copyyear}[1]{\def\SAP@copyyear{#1}}
+
+\def\SAP@cycle{}
+\newcommand{\cycle}[1]{\def\SAP@cycle{#1}}
+
+\def\SAP@submitdate{}
+\newcommand{\submitdate}[1]{\def\SAP@submitdate{#1}}
+\let\AcademicYear\submitdate
+
+\def\SAP@IDnumber{}
+\newcommand{\IDnumber}[1]{\def\SAP@IDnumber{#1}}
+
+%% Advisors
+\newcount\SAP@advisorcount
+\newtoks\SAP@advisortoks
+\newcommand{\advisor}[1]{%
+ \ifnum\SAP@advisorcount=\z@
+ \SAP@advisortoks={#1}%
+ \else
+ \SAP@advisortoks=\expandafter{\the\SAP@advisortoks\\[0.75mm]#1}%
+ \fi
+ \advance\SAP@advisorcount\@ne}
+
+%% Co-Advisors or External Advisor
+\newcount\SAP@coadvisorcount
+\newtoks\SAP@coadvisortoks
+\newif\ifSAP@ext \SAP@extfalse
+\newcommand{\coadvisor}[2][]{%
+ \ifnum\SAP@coadvisorcount=\z@
+ \SAP@coadvisortoks={#2}%
+ \else
+ \SAP@coadvisortoks=\expandafter{\the\SAP@coadvisortoks\\[0.75mm]#2}%
+ \fi
+ \advance\SAP@coadvisorcount\@ne
+ \ifstrequal{#1}{ext}{\SAP@exttrue}{}}
+
+
+
+%% Reviewers
+\def\SAP@ReviewerLabel{}
+\newcommand{\reviewerlabel}[1]{\def\SAP@ReviewerLabel{#1}}
+
+\newcount\SAP@reviewercount
+\newtoks\SAP@reviewertoks
+\newcommand{\reviewer}[1]{%
+ \ifnum\SAP@reviewercount=\z@
+ \SAP@reviewertoks={#1}%
+ \else
+ \SAP@reviewertoks=\expandafter{\the\SAP@reviewertoks\\[0.75mm]#1}%
+ \fi
+ \advance\SAP@reviewercount\@ne}
+
+
+
+%% Directors
+\newcount\SAP@directorcount
+\newtoks\SAP@directortoks
+\newcommand{\director}[1]{%
+ \ifnum\SAP@directorcount=\z@
+ \SAP@directortoks={#1}%
+ \else
+ \SAP@directortoks=\expandafter{\the\SAP@directortoks\\[0.75mm]#1}%
+ \fi
+ \advance\SAP@directorcount\@ne}
+
+%% Tutor (TFA only)
+\newcount\SAP@tutorcount
+\newtoks\SAP@tutortoks
+\newcommand{\tutor}[1]{%
+ \ifnum\SAP@tutorcount=\z@
+ \SAP@tutortoks={#1}%
+ \else
+ \SAP@tutortoks=\expandafter{\the\SAP@tutortoks\\[0.75mm]#1}%
+ \fi
+ \advance\SAP@tutorcount\@ne}
+
+%% Tutor Coordinatori (TFA only)
+\newcount\SAP@tutorcoordcount
+\newtoks\SAP@tutorcoordtoks
+\newcommand{\tutorcoord}[1]{%
+ \ifnum\SAP@tutorcoordcount=\z@
+ \SAP@tutorcoordtoks={#1}%
+ \else
+ \SAP@tutorcoordtoks=\expandafter{\the\SAP@tutorcoordtoks\\[0.75mm]#1}%
+ \fi
+ \advance\SAP@tutorcoordcount\@ne}
+
+%% Examiners
+\newcount\SAP@examinercount
+\newtoks\SAP@examinertoks
+\newcommand{\examiner}[2][]{%
+ \ifnum\SAP@examinercount=\z@
+ \SAP@examinertoks={#2 (\SAP@chairman\if|#1|\relax\else, #1\fi)}%
+ \else
+ \SAP@examinertoks=\expandafter{\the\SAP@examinertoks\\[0.75mm]#2 \if|#1|\relax\else (#1)\fi}%
+ \fi
+ \advance\SAP@examinercount\@ne}
+
+\def\SAP@examdate{}
+\newcommand{\examdate}[1]{\def\SAP@examdate{#1}}
+
+\def\SAP@versiondate{}
+\newcommand{\versiondate}[1]{\def\SAP@versiondate{#1}}
+
+\def\SAP@authoremail{}
+\newcommand{\authoremail}[1]{\def\SAP@authoremail{#1}}
+
+\def\SAP@website{}
+\newcommand{\website}[1]{\def\SAP@website{#1}}
+
+\def\SAP@ISBN{}
+\newcommand{\ISBN}[1]{\def\SAP@ISBN{#1}}
+
+\def\SAP@copyrightstatement{}
+\newcommand{\copyrightstatement}[1]{\def\SAP@copyrightstatement{#1}}
+
+\def\SAP@schoolname{}
+\newcommand{\schoolname}[1]{\def\SAP@schoolname{#1}}
+
+\def\SAP@schooladdress{}
+\newcommand{\schooladdress}[1]{\def\SAP@schooladdress{#1}}
+
+\def\SAP@schoolwebsite{}
+\newcommand{\schoolwebsite}[1]{\def\SAP@schoolwebsite{#1}}
+
+\def\SAP@schoolprincipal{}
+\newcommand{\schoolprincipal}[1]{\def\SAP@schoolprincipal{#1}}
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% PhD maketitle
+
+\newcommand{\SAP@maketitlePhD}{
+
+% Errors:
+
+\if|\SAP@courseorganizerLabel|\ClassError{sapthesis}{You must specify the Ph.D. %
+ organizer}{Example: \protect\courseorganizer{Scuola di dottorato di ...}}\fi
+\if|\SAP@courseLabel|\ClassError{sapthesis}{You must specify the Ph.D. %
+ course}{Example: \protect\course{Physics}}\fi
+\ifSAP@overridecourse\relax\else\if|\SAP@cycle|\ClassError{sapthesis}{You must specify the Ph.D. %
+ cycle (cycle)}{Example: \protect\cycle{XXIII} The Ph.D. cycle must be in the roman numbers}\fi\fi
+\if|\SAP@submitdate|\ClassError{sapthesis}{You must specify the %
+ thesis submission date}{Example: \protect\submitdate{August 2012} The date must be in the form Month(name) Year(number)}\fi
+\if|\SAP@copyyear|\ClassError{sapthesis}{You must specify the %
+ copyright year}{Example: \protect\copyyear{2012}}\fi
+\if|\SAP@IDnumber|\ClassError{sapthesis}{You must specify your %
+ ID number (matricola)}{Example: \protect\IDnumber{123456}}\fi
+\if|\SAP@authoremail|\ClassError{sapthesis}{You must specify the email of the author}{%
+ Example: \protect\authoremail{author@email.com}}\fi
+
+% Titlepage:
+
+ \begin{titlepage}
+
+ \linespread{1}\selectfont
+
+ \newcommand{\SAP@parbox}[2][]{\hspace{1.72cm}\parbox[t][##1][t]{11.9cm}{##2}}
+ \parindent=0pt
+ \sffamily
+
+ \vspace*{-10mm}
+ \ifSAP@bn
+ \includegraphics[width=5cm]{sapienza-MLblack-pos}
+ \else
+ \includegraphics[width=5cm]{sapienza-MLred-pos}
+ \fi
+
+ \nointerlineskip
+ \vspace{\stretch{1}}
+ \nointerlineskip
+
+ \SAP@parbox{\LARGE\textcolor{sapred}{\@title}\par}
+
+ \if|\SAP@subtitle|
+ \relax
+ \else
+ \vspace{0.4cm}
+ \SAP@parbox{\linespread{1.2}\selectfont\textcolor{sapred}{\large\SAP@subtitle}\par}
+ \fi
+
+ \vspace{\stretch{1}}
+
+ \SAP@parbox[3cm]{%
+ \textcolor{sapred}{\SAP@courseorganizerLabel\\[2mm]
+ \ifSAP@overridecourse\SAP@courseLabel\else Dottorato di Ricerca in \SAP@courseLabel\ -- \SAP@cycle\ Ciclo\fi}}
+
+ \SAP@parbox[3cm]{%
+ \ifSAP@femaleauthor
+ \SAP@CandidateLabelFemale\\[2mm]
+ \else
+ \SAP@CandidateLabel\\[2mm]
+ \fi
+ \@author\\[0.75mm]
+ \SAP@IDnumberLabel\ \SAP@IDnumber}
+
+
+
+
+ \SAP@parbox[4.5cm]{%
+ \makebox[11.9cm][l]{%
+ \parbox[t]{5.9cm}{%
+ \ifcase\SAP@advisorcount
+ \ClassError{sapthesis}{You must specify at least one advisor in the preamble}%
+ {E.g. \protect\advisor{Prof. Name Surname}}
+ \or
+ \SAP@ThesisAdvisorLabel\\[2mm]
+ \else
+ \SAP@ThesisAdvisorsLabel\\[2mm]
+ \fi
+ \the\SAP@advisortoks}
+ \hspace{1.5cm}
+ \parbox[t]{5.9cm}{%
+ \ifcase\SAP@coadvisorcount
+ \relax
+ \or
+ \ifSAP@ext\SAP@ThesisExtAdvisorLabel\else\SAP@ThesisCoAdvisorLabel\fi\\[2mm]
+ \else
+ \ifSAP@ext\SAP@ThesisExtAdvisorsLabel\else\SAP@ThesisCoAdvisorsLabel\fi\\[2mm]
+ \fi
+ \the\SAP@coadvisortoks}
+ }}
+
+ \SAP@parbox{\SAP@submitdate}
+
+ \end{titlepage}
+\clearpage
+\SAP@composebacktitlepage
+}
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Specialization maketitle
+
+\newcommand{\SAP@maketitleSpecialization}{
+
+% Errors:
+
+\if|\SAP@courseorganizerLabel|\ClassError{sapthesis}{You must specify the Specialization course %
+ organizer}{Example: \protect\courseorganizer{Faculty of ...}}\fi
+\if|\SAP@courseLabel|\ClassError{sapthesis}{You must specify the %
+ course}{Example: \protect\course{Fisica}}\fi
+\if|\SAP@submitdate|\ClassError{sapthesis}{You must specify the Academic %
+ Year}{Example: \protect\submitdate{2011/2012}}\fi
+\if|\SAP@IDnumber|\ClassError{sapthesis}{You must specify your %
+ ID number (matricola)}{E.g. 123456}\fi
+\if|\SAP@copyyear|\ClassError{sapthesis}{You must specify the %
+ copyright year}{Example: \protect\copyyear{2012}}\fi
+\if|\SAP@authoremail|\ClassError{sapthesis}{You must specify the email of the author}{%
+ Example: \protect\authoremail{author@email.com}}\fi
+
+% Titlepage:
+
+ \begin{titlepage}
+
+ \linespread{1}\selectfont
+
+ \newcommand{\SAP@parbox}[2][]{\hspace{1.72cm}\parbox[t][##1][t]{11.9cm}{##2}}
+ \parindent=0pt
+ \sffamily
+
+ \vspace*{-10mm}
+ \ifSAP@bn
+ \includegraphics[width=5cm]{sapienza-MLblack-pos}
+ \else
+ \includegraphics[width=5cm]{sapienza-MLred-pos}
+ \fi
+
+ \nointerlineskip
+ \vspace{\stretch{0.9}}
+ \nointerlineskip
+
+ \SAP@parbox{\LARGE\textcolor{sapred}{\@title}\par}
+
+ \if|\SAP@subtitle|
+ \relax
+ \else
+ \vspace{0.4cm}
+ \SAP@parbox{\linespread{1.2}\selectfont\textcolor{sapred}{\large\SAP@subtitle}\par}
+ \fi
+
+ \vspace{\stretch{0.9}}
+
+ \SAP@parbox[3cm]{%
+ \textcolor{sapred}{\SAP@courseorganizerLabel\\[2mm]
+ \ifSAP@overridecourse\SAP@courseLabel\else Corso di specializzazione in \SAP@courseLabel\fi}}
+
+ \SAP@parbox[3cm]{%
+ \ifSAP@femaleauthor
+ \SAP@CandidateLabelFemale\\[2mm]
+ \else
+ \SAP@CandidateLabel\\[2mm]
+ \fi
+ \@author\\[0.75mm]
+ \SAP@IDnumberLabel\ \SAP@IDnumber}
+
+ \SAP@parbox[4.5cm]{%
+ \makebox[11.9cm][l]{%
+ \parbox[t]{5.9cm}{%
+ \ifcase\SAP@advisorcount
+ \ClassError{sapthesis}{You must specify at least one advisor in the preamble}%
+ {E.g. \protect\advisor{Prof. Name Surname}}
+ \or
+ \SAP@ThesisAdvisorLabel\\[2mm]
+ \else
+ \SAP@ThesisAdvisorsLabel\\[2mm]
+ \fi
+ \the\SAP@advisortoks}
+ \hspace{1.5cm}
+ \parbox[t]{5.9cm}{%
+ \ifcase\SAP@directorcount
+ \relax
+ \or
+ \SAP@ThesisDirectorLabel\\[2mm]
+ \else
+ \SAP@ThesisDirectorsLabel\\[2mm]
+ \fi
+ \the\SAP@directortoks}
+ }
+
+ \vspace{1cm}
+
+ \makebox[11.9cm][l]{%
+ \parbox[t]{5.9cm}{%
+ \ifcase\SAP@coadvisorcount
+ \or
+ \ifSAP@ext\SAP@ThesisExtAdvisorLabel\else\SAP@ThesisCoAdvisorLabel\fi\\[2mm]
+ \else
+ \ifSAP@ext\SAP@ThesisExtAdvisorsLabel\else\SAP@ThesisCoAdvisorsLabel\fi\\[2mm]
+ \fi
+ \the\SAP@coadvisortoks}
+ }}
+
+ \SAP@parbox{\SAP@AcademicYearLabel\ \SAP@submitdate}
+
+ \end{titlepage}
+\clearpage
+\SAP@composebacktitlepage
+}
+%% Laurea and Laurea Magistrale maketitle
+
+\newcommand{\SAP@maketitleLaurea}{
+
+% Errors:
+
+\if|\SAP@courseorganizerLabel|\ClassError{sapthesis}{You must specify the degree %
+ organizer}{Example: \protect\courseorganizer{Faculty of ...}}\fi
+\if|\SAP@courseLabel|\ClassError{sapthesis}{You must specify the %
+ course}{Example: \protect\course{Fisica}}\fi
+\if|\SAP@submitdate|\ClassError{sapthesis}{You must specify the Academic %
+ Year}{Example: \protect\submitdate{2011/2012}}\fi
+\if|\SAP@IDnumber|\ClassError{sapthesis}{You must specify your %
+ ID number (matricola)}{E.g. 123456}\fi
+\if|\SAP@copyyear|\ClassError{sapthesis}{You must specify the %
+ copyright year}{Example: \protect\copyyear{2012}}\fi
+\if|\SAP@authoremail|\ClassError{sapthesis}{You must specify the email of the author}{%
+ Example: \protect\authoremail{author@email.com}}\fi
+
+% Titlepage:
+
+ \begin{titlepage}
+
+ \linespread{1}\selectfont
+
+ \newcommand{\SAP@parbox}[2][]{\hspace{1.72cm}\parbox[t][##1][t]{11.9cm}{##2}}
+ \parindent=0pt
+ \sffamily
+
+ \vspace*{-10mm}
+ \ifSAP@bn
+ \includegraphics[width=5cm]{sapienza-MLblack-pos}
+ \else
+ \includegraphics[width=5cm]{sapienza-MLred-pos}
+ \fi
+
+ \nointerlineskip
+ \vspace{\stretch{0.9}}
+ \nointerlineskip
+
+ \SAP@parbox{\LARGE\textcolor{sapred}{\@title}\par}
+
+ \if|\SAP@subtitle|
+ \relax
+ \else
+ \vspace{0.4cm}
+ \SAP@parbox{\linespread{1.2}\selectfont\textcolor{sapred}{\large\SAP@subtitle}\par}
+ \fi
+
+ \vspace{\stretch{0.9}}
+
+ \SAP@parbox[3cm]{%
+ \textcolor{sapred}{\SAP@courseorganizerLabel\\[2mm]
+ \ifSAP@overridecourse\SAP@courseLabel\else Corso di Laurea \ifSAP@LaM Magistrale \fi in \SAP@courseLabel\fi}}
+
+ \SAP@parbox[3cm]{%
+ \ifSAP@femaleauthor
+ \SAP@CandidateLabelFemale\\[2mm]
+ \else
+ \SAP@CandidateLabel\\[2mm]
+ \fi
+ \@author\\[0.75mm]
+ \SAP@IDnumberLabel\ \SAP@IDnumber}
+
+ \SAP@parbox[4.5cm]{%
+ \makebox[11.9cm][l]{%
+ \parbox[t]{5.9cm}{%
+ \ifcase\SAP@advisorcount
+ \ClassError{sapthesis}{You must specify at least one advisor in the preamble}%
+ {E.g. \protect\advisor{Prof. Name Surname}}
+ \or
+ \SAP@ThesisAdvisorLabel\\[2mm]
+ \else
+ \SAP@ThesisAdvisorsLabel\\[2mm]
+ \fi
+ \the\SAP@advisortoks}
+ \hspace{1.5cm}
+ \parbox[t]{5.9cm}{%
+ \ifcase\SAP@coadvisorcount
+ \relax
+ \or
+ \ifSAP@ext\SAP@ThesisExtAdvisorLabel\else\SAP@ThesisCoAdvisorLabel\fi\\[2mm]
+ \else
+ \ifSAP@ext\SAP@ThesisExtAdvisorsLabel\else\SAP@ThesisCoAdvisorsLabel\fi\\[2mm]
+ \fi
+ \the\SAP@coadvisortoks}
+ }}
+
+ \SAP@parbox{\SAP@AcademicYearLabel\ \SAP@submitdate}
+
+ \end{titlepage}
+\clearpage
+\SAP@composebacktitlepage
+}
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Master di primo livello and
+%% Master di secondo livello maketitle
+
+\newcommand{\SAP@maketitleMaster}{
+
+% Errors:
+
+\if|\SAP@courseorganizerLabel|\ClassError{sapthesis}{You must specify the degree %
+ organizer}{Example: \protect\courseorganizer{Faculty of ...}}\fi
+\if|\SAP@courseLabel|\ClassError{sapthesis}{You must specify the %
+ course}{Example: \protect\course{Fisica}}\fi
+\if|\SAP@submitdate|\ClassError{sapthesis}{You must specify the Academic %
+ Year}{Example: \protect\submitdate{2011/2012}}\fi
+\if|\SAP@IDnumber|\ClassError{sapthesis}{You must specify your %
+ ID number (matricola)}{E.g. 123456}\fi
+\if|\SAP@copyyear|\ClassError{sapthesis}{You must specify the %
+ copyright year}{Example: \protect\copyyear{2012}}\fi
+\if|\SAP@authoremail|\ClassError{sapthesis}{You must specify the email of the author}{%
+ Example: \protect\authoremail{author@email.com}}\fi
+
+% Titlepage:
+
+ \begin{titlepage}
+
+ \linespread{1}\selectfont
+
+ \newcommand{\SAP@parbox}[2][]{\hspace{1.72cm}\parbox[t][##1][t]{11.9cm}{##2}}
+ \parindent=0pt
+ \sffamily
+
+ \vspace*{-10mm}
+ \ifSAP@bn
+ \includegraphics[width=5cm]{sapienza-MLblack-pos}
+ \else
+ \includegraphics[width=5cm]{sapienza-MLred-pos}
+ \fi
+
+ \nointerlineskip
+ \vspace{\stretch{0.9}}
+ \nointerlineskip
+
+ \SAP@parbox{\LARGE\textcolor{sapred}{\@title}\par}
+
+ \if|\SAP@subtitle|
+ \relax
+ \else
+ \vspace{0.4cm}
+ \SAP@parbox{\linespread{1.2}\selectfont\textcolor{sapred}{\large\SAP@subtitle}\par}
+ \fi
+
+ \vspace{\stretch{0.9}}
+
+ \SAP@parbox[3cm]{%
+ \textcolor{sapred}{\SAP@courseorganizerLabel\\[2mm]
+ \ifSAP@overridecourse\SAP@courseLabel\else Master di \ifSAP@MasterP primo \fi \ifSAP@MasterS secondo \fi livello in \SAP@courseLabel\fi}}
+
+ \SAP@parbox[3cm]{%
+ \ifSAP@femaleauthor
+ \SAP@CandidateLabelFemale\\[2mm]
+ \else
+ \SAP@CandidateLabel\\[2mm]
+ \fi
+ \@author\\[0.75mm]
+ \SAP@IDnumberLabel\ \SAP@IDnumber}
+
+ \SAP@parbox[4.5cm]{%
+ \makebox[11.9cm][l]{%
+ \parbox[t]{5.9cm}{%
+ \ifcase\SAP@advisorcount
+ \ClassError{sapthesis}{You must specify at least one advisor in the preamble}%
+ {E.g. \protect\advisor{Prof. Name Surname}}
+ \or
+ \SAP@ThesisAdvisorLabel\\[2mm]
+ \else
+ \SAP@ThesisAdvisorsLabel\\[2mm]
+ \fi
+ \the\SAP@advisortoks}
+ \hspace{1.5cm}
+ \parbox[t]{5.9cm}{%
+ \ifcase\SAP@coadvisorcount
+ \relax
+ \or
+ \ifSAP@ext\SAP@ThesisExtAdvisorLabel\else\SAP@ThesisCoAdvisorLabel\fi\\[2mm]
+ \else
+ \ifSAP@ext\SAP@ThesisExtAdvisorsLabel\else\SAP@ThesisCoAdvisorsLabel\fi\\[2mm]
+ \fi
+ \the\SAP@coadvisortoks}
+ }}
+
+ \SAP@parbox{\SAP@AcademicYearLabel\ \SAP@submitdate}
+
+ \end{titlepage}
+\clearpage
+\SAP@composebacktitlepage
+}
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Tirocinio Formativo Attivo (TFA) maketitle
+
+\newcommand{\SAP@maketitleTFA}{
+
+% Errors:
+
+\if|\SAP@courseorganizerLabel|\ClassError{sapthesis}{You must specify the degree %
+ organizer}{Example: \protect\courseorganizer{Faculty of ...}}\fi
+\if|\SAP@submitdate|\ClassError{sapthesis}{You must specify the Academic %
+ Year}{Example: \protect\submitdate{2011/2012}}\fi
+\if|\SAP@IDnumber|\ClassError{sapthesis}{You must specify your %
+ ID number (matricola)}{E.g. 123456}\fi
+\if|\SAP@copyyear|\ClassError{sapthesis}{You must specify the %
+ copyright year}{Example: \protect\copyyear{2012}}\fi
+\if|\SAP@authoremail|\ClassError{sapthesis}{You must specify the email of the author}{%
+ Example: \protect\authoremail{author@email.com}}\fi
+
+% Titlepage:
+
+ \begin{titlepage}
+
+ \linespread{1}\selectfont
+
+ \newcommand{\SAP@parbox}[2][]{\hspace{1.72cm}\parbox[t][##1][t]{11.9cm}{##2}}
+ \parindent=0pt
+ \sffamily
+
+ \vspace*{-10mm}
+ \ifSAP@bn
+ \includegraphics[width=5cm]{sapienza-MLblack-pos}
+ \else
+ \includegraphics[width=5cm]{sapienza-MLred-pos}
+ \fi
+
+ \nointerlineskip
+ \vspace{\stretch{0.9}}
+ \nointerlineskip
+
+ \SAP@parbox{\LARGE\textcolor{sapred}{\@title}\par}
+
+ \if|\SAP@subtitle|
+ \relax
+ \else
+ \vspace{0.4cm}
+ \SAP@parbox{\linespread{1.2}\selectfont\textcolor{sapred}{\large\SAP@subtitle}\par}
+ \fi
+
+ \vspace{\stretch{0.9}}
+
+ \SAP@parbox[3cm]{%
+ \textcolor{sapred}{\SAP@courseorganizerLabel\\[2mm]
+ Tirocinio Formativo Attivo\\[2mm]
+ \ifSAP@overridecourse\SAP@courseLabel\else Classe \SAP@courseLabel\fi}}
+
+ \SAP@parbox[3cm]{%
+ \ifSAP@femaleauthor
+ \SAP@CandidateLabelFemale\\[2mm]
+ \else
+ \SAP@CandidateLabel\\[2mm]
+ \fi
+ \@author\\[0.75mm]
+ \SAP@IDnumberLabel\ \SAP@IDnumber}
+
+ \SAP@parbox[4.5cm]{%
+ \makebox[11.9cm][l]{%
+ \parbox[t]{5.9cm}{%
+ \ifcase\SAP@advisorcount
+ \ClassError{sapthesis}{You must specify at least one advisor in the preamble}%
+ {E.g. \protect\advisor{Prof. Name Surname}}
+ \or
+ \SAP@ThesisAdvisorLabel\\[2mm]
+ \else
+ \SAP@ThesisAdvisorsLabel\\[2mm]
+ \fi
+ \the\SAP@advisortoks}
+ \hspace{1.5cm}
+ \parbox[t]{5.9cm}{%
+ \ifcase\SAP@coadvisorcount
+ \relax
+ \or
+ \ifSAP@ext\SAP@ThesisExtAdvisorLabel\else\SAP@ThesisCoAdvisorLabel\fi\\[2mm]
+ \else
+ \ifSAP@ext\SAP@ThesisExtAdvisorsLabel\else\SAP@ThesisCoAdvisorsLabel\fi\\[2mm]
+ \fi
+ \the\SAP@coadvisortoks}
+ }
+
+ \vspace{1cm}
+
+ \makebox[11.9cm][l]{%
+ \parbox[t]{5.9cm}{%
+ \ifcase\SAP@tutorcount
+ \ClassError{sapthesis}{You must specify at least one tutor in the preamble}%
+ {E.g. \protect\tutor{Prof. Name Surname}}
+ \or
+ \SAP@ThesisTutorLabel\\[2mm]
+ \else
+ \SAP@ThesisTutorsLabel\\[2mm]
+ \fi
+ \the\SAP@tutortoks}
+ \hspace{1.5cm}
+ \parbox[t]{5.9cm}{%
+ \ifcase\SAP@tutorcoordcount
+ \ClassError{sapthesis}{You must specify at least one tutor coordinatore in the preamble}%
+ {E.g. \protect\tutorcoord{Prof. Name Surname}}
+ \or
+ \SAP@ThesisTutorCoordLabel\\[2mm]
+ \else
+ \SAP@ThesisTutorCoordsLabel\\[2mm]
+ \fi
+ \the\SAP@tutorcoordtoks}
+ }}
+
+ \SAP@parbox{\SAP@AcademicYearLabel\ \SAP@submitdate}
+
+ \end{titlepage}
+\clearpage
+\SAP@composebacktitlepage
+}
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Macro for the back of the title page %%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\def\SAP@composebacktitlepage{%
+
+{\thispagestyle{empty}
+\linespread{1}\selectfont
+\setlength{\parindent}{0pt}
+
+\null
+\vspace*{1cm}
+\ifSAP@TFA
+\SAP@TFAschoolHeadLabel\\[2mm]
+\SAP@schoolname\\[0.1cm]
+\SAP@schooladdress\\[0.1cm]
+\@ifundefined{href}{\SAP@schoolwebsite}{\href{\SAP@schoolwebsite}{\SAP@schoolwebsite}}\\[0.1cm]
+\SAP@TFAschoolPrincipalLabel: \SAP@schoolprincipal
+\vspace*{1.5cm}
+\fi
+
+\ifSAP@noexaminfo\relax
+\else
+\if?\SAP@examdate?
+ \ifcase\SAP@examinercount
+ \SAP@ThesisNotDefensedLabel%
+ \else
+ \ClassError{sapthesis}{You have specified one or more examiners but not
+ the date of the final exam}{E.g. \protect\examdate{17 July 2015}}
+ \fi
+\else
+ \ifcase\SAP@examinercount
+ \ClassError{sapthesis}{You have specified the final exam date but no examiner}{E.g. \protect\examiner{Prof. Giulio Cesare}}
+ \else
+ \SAP@ThesisDefensedLabelA\ \SAP@examdate\\
+ \SAP@ThesisDefensedLabelB:\\[2mm]
+ \the\SAP@examinertoks%
+ \fi
+\fi
+\fi
+
+\vspace{1cm}
+
+\ifcase\SAP@reviewercount
+ \relax
+\else
+ \SAP@ReviewerLabel:\\[2mm]
+ \the\SAP@reviewertoks%
+\fi
+
+\vfill
+
+\hrulefill
+\vspace{2mm}
+
+\small
+\textbf{\def\\{}\def\newline{}\@title} \\[0.75mm]
+\ifSAP@PhD\SAP@PhDthesistype\fi
+\ifSAP@Specialization\SAP@Specializationthesistype\fi
+\ifSAP@LaM\SAP@LaMthesistype\fi
+\ifSAP@Lau\SAP@Lauthesistype\fi
+\ifSAP@MasterS\SAP@MasterSthesistype\fi
+\ifSAP@MasterP\SAP@MasterPthesistype\fi
+\ifSAP@TFA\SAP@TFAthesistype\fi
+. \SAP@sapienzaname \\[0.75mm]
+\if|\SAP@ISBN|\relax\else ISBN: \SAP@ISBN\fi\\[0.75mm]
+\if|\SAP@copyrightstatement|\copyright\ \SAP@copyyear\ \@author. \SAP@allRightsReservedLabel\else\SAP@copyrightstatement\fi\\[1.5mm]
+
+%Material for which the author is the copyright owner cannot be
+%used without the written permission of the author.
+%The permission to reproduce copyright protected material does not extend
+%to any material that is copyright of a third party; authorization to
+%reproduce such material must be obtained from the copyright owners concerned.
+%If you believe that a copyright infringement is present in this thesis,
+%please contact the author, providing your name, contact details, full
+%details of the copyright infringement and advise whether you are the copyright
+%owner or a representative of the copyright owner.\\
+
+\SAP@sapthesisInformationLabel.\\
+
+\if|\SAP@versiondate|
+ \relax%
+\else
+ \SAP@versionLabel: \SAP@versiondate \\[2mm]%
+\fi
+\if|\SAP@website|
+ \relax%
+\else
+ \SAP@websiteLabel: \@ifundefined{href}{\SAP@website}{\href{\SAP@website}{\SAP@website}} \\[2mm]%
+\fi
+\SAP@emailLabel: \@ifundefined{href}{\SAP@authoremail}{\href{mailto:\SAP@authoremail}{\SAP@authoremail}}\par
+
+}
+\cleardoublepage
+}
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Choosing the right \maketitle according to the thesis type %%%%%%%
+
+\renewcommand{\maketitle}{%
+ \ifSAP@PhD\SAP@maketitlePhD\fi
+ \ifSAP@Specialization\SAP@maketitleSpecialization\fi
+ \ifSAP@LaM\SAP@maketitleLaurea\fi
+ \ifSAP@Lau\SAP@maketitleLaurea\fi
+ \ifSAP@MasterS\SAP@maketitleMaster\fi
+ \ifSAP@MasterP\SAP@maketitleMaster\fi
+ \ifSAP@TFA\SAP@maketitleTFA\fi}
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% DEDICATION COMMAND %%
+\providecommand*{\dedication}[1]{%
+\cleardoublepage
+\thispagestyle{empty}
+\null\vspace{\stretch{0.26}}
+\begin{flushright}
+\textit{#1}
+\end{flushright}
+\vspace{\stretch{0.74}}\null}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% ABSTRACT ENVIRONMENT %%
+\newenvironment{abstract}[1][\SAP@AbstractLabel]
+{\cleardoublepage\thispagestyle{plain}
+\noindent{\Large\bfseries #1}\par\vspace{0.5cm}\noindent\ignorespaces}
+{\null\ignorespacesafterend}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% ACKNOWLEDGMENTS ENVIRONMENT %%
+\newenvironment{acknowledgments}[1][\SAP@AcknowledgmentsLabel]
+{\cleardoublepage\thispagestyle{plain}
+\noindent{\Large\bfseries #1}\par\vspace{0.5cm}\itshape\noindent\ignorespaces}
+{\null\ignorespacesafterend}
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% LANGUAGE COMMANDS %%
+
+\newcommand{\SAP@english}{%
+ \newcommand{\SAP@CandidateLabel}{Candidate}
+ \newcommand{\SAP@CandidateLabelFemale}{Candidate}
+ \newcommand{\SAP@IDnumberLabel}{ID number}
+ \newcommand{\SAP@ThesisAdvisorLabel}{Thesis Advisor}
+ \newcommand{\SAP@ThesisAdvisorsLabel}{Thesis Advisors}
+ \newcommand{\SAP@ThesisCoAdvisorLabel}{Co-Advisor}
+ \newcommand{\SAP@ThesisCoAdvisorsLabel}{Co-Advisors}
+ \newcommand{\SAP@ThesisExtAdvisorLabel}{External Advisor}
+ \newcommand{\SAP@ThesisExtAdvisorsLabel}{External Advisors}
+ \newcommand{\SAP@ThesisDirectorLabel}{Director}
+ \newcommand{\SAP@ThesisDirectorsLabel}{Directors}
+ \newcommand{\SAP@ThesisTutorLabel}{Trainee's Tutor}
+ \newcommand{\SAP@ThesisTutorsLabel}{Trainee's Tutors}
+ \newcommand{\SAP@ThesisTutorCoordLabel}{Coordinating Tutor}
+ \newcommand{\SAP@ThesisTutorCoordsLabel}{Coordinating Tutors}
+ \newcommand{\SAP@TFAschoolHeadLabel}{Training done at:}
+ \newcommand{\SAP@TFAschoolPrincipalLabel}{Principal}
+ \newcommand{\SAP@ThesisNotDefensedLabel}{Thesis not yet defended}
+ \newcommand{\SAP@ThesisDefensedLabelA}{Thesis defended on}
+ \newcommand{\SAP@ThesisDefensedLabelB}{in front of a Board of Examiners composed by}
+ \newcommand{\SAP@chairman}{chairman}
+ \newcommand{\SAP@PhDthesistype}{Ph.D. thesis}
+ \newcommand{\SAP@Specializationthesistype}{Specialization thesis}
+ \newcommand{\SAP@LaMthesistype}{Master's thesis}
+ \newcommand{\SAP@Lauthesistype}{Bachelor's thesis}
+ \newcommand{\SAP@MasterPthesistype}{First level master's thesis}
+ \newcommand{\SAP@MasterSthesistype}{Second level master's thesis}
+ \newcommand{\SAP@TFAthesistype}{TFA report}
+ \newcommand{\SAP@sapienzaname}{Sapienza -- University of Rome}
+ \newcommand{\SAP@versionLabel}{Version}
+ \newcommand{\SAP@websiteLabel}{Website}
+ \newcommand{\SAP@AcknowledgmentsLabel}{Acknowledgments}
+ \newcommand{\SAP@AbstractLabel}{Abstract}
+ \newcommand{\SAP@AcademicYearLabel}{Academic Year}
+ \newcommand{\SAP@allRightsReservedLabel}{All rights reserved}
+ \newcommand{\SAP@sapthesisInformationLabel}{This thesis has been typeset by \LaTeX\ and the Sapthesis class}
+ \newcommand{\SAP@emailLabel}{Author's email}}
+
+\newcommand{\SAP@italian}{%
+ \newcommand{\SAP@CandidateLabel}{Candidato}
+ \newcommand{\SAP@CandidateLabelFemale}{Candidata}
+ \newcommand{\SAP@IDnumberLabel}{Matricola}
+ \newcommand{\SAP@ThesisAdvisorLabel}{Relatore}
+ \newcommand{\SAP@ThesisAdvisorsLabel}{Relatori}
+ \newcommand{\SAP@ThesisCoAdvisorLabel}{Correlatore}
+ \newcommand{\SAP@ThesisCoAdvisorsLabel}{Correlatori}
+ \newcommand{\SAP@ThesisExtAdvisorLabel}{Relatore esterno}
+ \newcommand{\SAP@ThesisExtAdvisorsLabel}{Relatori esterni}
+ \newcommand{\SAP@ThesisDirectorLabel}{Direttore}
+ \newcommand{\SAP@ThesisDirectorsLabel}{Direttori}
+ \newcommand{\SAP@ThesisTutorLabel}{Tutor del Tirocinante}
+ \newcommand{\SAP@ThesisTutorsLabel}{Tutor del Tirocinante}
+ \newcommand{\SAP@ThesisTutorCoordLabel}{Tutor Coordinatore}
+ \newcommand{\SAP@ThesisTutorCoordsLabel}{Tutor Coordinatori}
+ \newcommand{\SAP@TFAschoolHeadLabel}{Tirocinio svolto presso:}
+ \newcommand{\SAP@TFAschoolPrincipalLabel}{Dirigente scolastico}
+ \newcommand{\SAP@ThesisNotDefensedLabel}{Tesi non ancora discussa}
+ \newcommand{\SAP@ThesisDefensedLabelA}{Tesi discussa il}
+ \newcommand{\SAP@ThesisDefensedLabelB}{di fronte a una commissione esaminatrice composta da}
+ \newcommand{\SAP@chairman}{presidente}
+ \newcommand{\SAP@PhDthesistype}{Tesi di dottorato}
+ \newcommand{\SAP@Specializationthesistype}{Tesi di Specializzazione}
+ \newcommand{\SAP@LaMthesistype}{Tesi di Laurea Magistrale}
+ \newcommand{\SAP@Lauthesistype}{Tesi di Laurea}
+ \newcommand{\SAP@MasterPthesistype}{Tesi di Master di primo livello}
+ \newcommand{\SAP@MasterSthesistype}{Tesi di Master di secondo livello}
+ \newcommand{\SAP@TFAthesistype}{TFA. Relazione di tirocinio}
+ \newcommand{\SAP@sapienzaname}{Sapienza -- Universit\`a di Roma}
+ \newcommand{\SAP@versionLabel}{Versione}
+ \newcommand{\SAP@websiteLabel}{Sito web}
+ \newcommand{\SAP@AcknowledgmentsLabel}{Ringraziamenti}
+ \newcommand{\SAP@AbstractLabel}{Sommario}
+ \newcommand{\SAP@AcademicYearLabel}{Anno Accademico}
+ \newcommand{\SAP@allRightsReservedLabel}{Tutti i diritti riservati}
+ \newcommand{\SAP@sapthesisInformationLabel}{Questa tesi \`e stata composta con \LaTeX\ e la classe Sapthesis}
+ \newcommand{\SAP@emailLabel}{Email dell'autore}}
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% USEFUL COMMANDS %%
+
+\newcommand*{\SAP@upbox}[1]{\textrm{\upshape#1}}
+\AtBeginDocument{
+
+ \definecolor{sapred}{rgb}{0.5098039,0.1411765,0.2}
+
+ % scritte in funzione della lingua del documento. Default inglese.
+ \ifSAP@customlanguage
+ \SAP@customlanguage
+ \else
+ \@ifpackageloaded{babel}{\csname SAP@\languagename\endcsname}{%
+ \@ifpackageloaded{polyglossia}{\csname SAP@\languagename\endcsname}{\SAP@english}}
+ \fi
+
+ % degree
+ \providecommand{\degree}{\SAP@upbox{\textdegree}}
+ \providecommand{\g}{\degree}
+
+ % gradi Celsius
+ \providecommand{\celsius}{\ensuremath{\SAP@upbox{\textdegree}\kern-\scriptspace\mathrm{C}}}
+ \ifxetex
+ \ProvideTextCommandDefault{\C}{\celsius}
+ \else
+
+ \providecommand{\C}{\celsius}
+ \fi
+
+ % Angstrom
+ \providecommand{\angstrom}{\SAP@upbox{\AA}}
+ \providecommand{\A}{\angstrom}
+
+ % micro
+ \providecommand{\micro}{\SAP@upbox{\textmu}}
+
+ % Ohm
+ \providecommand{\ohm}{\SAP@upbox{\textohm}}
+
+ % times (only math)
+ \providecommand{\x}{\times}
+
+ % measurement unit
+ \providecommand*{\un}[1]{\ensuremath{\mathrm{\,#1}}}
+
+ % Napier's number
+ \providecommand{\eu}{\ensuremath{\mathrm{e}}}
+
+ % imaginary unit
+ \providecommand{\iu}{\ensuremath{\mathrm{i}}}
+
+ % roman subscript
+ \providecommand*{\rb}[1]{\ensuremath{_\mathrm{#1}}}
+
+ % roman superscript
+ \providecommand*{\rp}[1]{\ensuremath{^\mathrm{#1}}}
+
+ % differential (only math)
+ \ifSAP@romandiff
+ \providecommand{\di}{\mathop{}\!\mathrm{d}}
+ \else
+ \providecommand{\di}{\mathop{}\!d}
+ \fi
+
+ % derivative and partial derivative (only math)
+ % see http://www.guit.sssup.it/phpbb/viewtopic.php?p=42199#42199
+ \providecommand{\der}[2]{\begingroup
+ \@tempswafalse\toks@={}\count@=\z@
+ \@for\next:=#2\do
+ {\expandafter\check@var\next\@nil
+ \advance\count@\der@exp
+ \if@tempswa
+ \toks@=\expandafter{\the\toks@\,}%
+ \else
+ \@tempswatrue
+ \fi
+ \toks@=\expandafter{\the\expandafter\toks@\expandafter\partial\der@var}}%
+ \frac{\partial\ifnum\count@=\@ne\else^{\number\count@}\fi#1}{\the\toks@}%
+ \endgroup}
+ \def\check@var{\@ifstar{\mult@var}{\one@var}}
+ \def\mult@var#1#2\@nil{\def\der@var{#2^{#1}}\def\der@exp{#1}}
+ \def\one@var#1\@nil{\def\der@var{#1}\chardef\der@exp\@ne}
+
+ \providecommand{\pder}[2]{\begingroup
+ \@tempswafalse\toks@={}\count@=\z@
+ \@for\next:=#2\do
+ {\expandafter\check@var\next\@nil
+ \advance\count@\der@exp
+ \if@tempswa
+ \toks@=\expandafter{\the\toks@\,}%
+ \else
+ \@tempswatrue
+ \fi
+ \toks@=\expandafter{\the\expandafter\toks@\expandafter\partial\der@var}}%
+ \frac{\partial\ifnum\count@=\@ne\else^{\number\count@}\fi#1}{\the\toks@}%
+ \endgroup}
+ \def\check@var{\@ifstar{\mult@var}{\one@var}}
+ \def\mult@var#1#2\@nil{\def\der@var{#2^{#1}}\def\der@exp{#1}}
+ \def\one@var#1\@nil{\def\der@var{#1}\chardef\der@exp\@ne}
+
+ % subscript and superscript in text mode
+ \DeclareRobustCommand*\textsubscript[1]{\@textsubscript{\selectfont#1}}
+ \def\@textsubscript#1{{\m@th\ensuremath{_{\mbox{\fontsize\sf@size\z@#1}}}}}
+ \providecommand*{\tb}[1]{\textsubscript{#1}}
+ \providecommand*{\tp}[1]{\textsuperscript{#1}}
+} \ No newline at end of file
diff --git a/macros/latex/contrib/sapthesis/sapthesis.layout b/macros/latex/contrib/sapthesis/sapthesis.layout
new file mode 100644
index 0000000000..38df02417e
--- /dev/null
+++ b/macros/latex/contrib/sapthesis/sapthesis.layout
@@ -0,0 +1,7 @@
+#\DeclareLaTeXClass[sapthesis]{book (sapthesis)}
+Input stdclass.inc
+
+#% Copy this file in Lyx20\Resources\layouts\ folder
+# In LyX, do: Tools > Reconfigure ; Restart Lyx.
+# Choose the file class inside the Document properties
+# and customize the preamble \ No newline at end of file