summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/sapthesis
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-08-21 22:07:40 +0000
committerKarl Berry <karl@freefriends.org>2013-08-21 22:07:40 +0000
commit60db445b187defd29b9b812162d897c90425b092 (patch)
tree1c7f653011a8356138ee6584d36ab93bb45f2268 /Master/texmf-dist/doc/latex/sapthesis
parent74d27605eb40aa659c59e19d5dbee6bc13935397 (diff)
sapthesis (21aug13)
git-svn-id: svn://tug.org/texlive/trunk@31487 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/sapthesis')
-rw-r--r--Master/texmf-dist/doc/latex/sapthesis/README66
-rw-r--r--Master/texmf-dist/doc/latex/sapthesis/examples/Laurea.tex218
-rw-r--r--Master/texmf-dist/doc/latex/sapthesis/examples/LaureaMagistrale.tex218
-rw-r--r--Master/texmf-dist/doc/latex/sapthesis/examples/Master.tex219
-rw-r--r--Master/texmf-dist/doc/latex/sapthesis/examples/PhD.tex (renamed from Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.tex)57
-rw-r--r--Master/texmf-dist/doc/latex/sapthesis/examples/Specialization.tex220
-rw-r--r--Master/texmf-dist/doc/latex/sapthesis/examples/TFA.tex229
-rw-r--r--Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.pdfbin154966 -> 179500 bytes
-rw-r--r--Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.tex147
-rw-r--r--Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.pdfbin425700 -> 0 bytes
10 files changed, 1276 insertions, 98 deletions
diff --git a/Master/texmf-dist/doc/latex/sapthesis/README b/Master/texmf-dist/doc/latex/sapthesis/README
index 28105857797..3e38b95ae67 100644
--- a/Master/texmf-dist/doc/latex/sapthesis/README
+++ b/Master/texmf-dist/doc/latex/sapthesis/README
@@ -5,12 +5,12 @@
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-2012 by Francesco Biccari.
+ Copyright (c) 2008-2013 by Francesco Biccari.
This work (specified below) may be distributed and/or
modified under the conditions of the
@@ -30,7 +30,7 @@
marchio/logotipo e del sistema di identitŕ visiva della
Sapienza" document available, with other information,
at the following link (in italian):
- http://www.uniroma1.it/ufficiostampa/identita.php
+ http://www.uniroma1.it/ateneo/chi-siamo/identit%C3%A0-visiva-e-marchio
In particular it can be used in the theses of "Sapienza"
university without explicit authorization.
@@ -38,26 +38,31 @@
** Class information ************************************************
- Sapthesis is a LaTeX class to typeset PhD, Master and Bachelor
- theses that adhere to "Sapienza - University of Rome"'s
- guidelines for publishing.
+ 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.
-
- The documentation is provided in the file sapthesis-doc.pdf.
-
-
-
+
+
+
** Installation instruction *****************************************
- The simplest way to install sapthesis is by the package manager
- of your TeX distribution (TeX Live or MiKTeX).
+ 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).
- Instead, if you want to install sapthesis manually, you have to
+ 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
@@ -67,15 +72,20 @@
1. sapthesis.cls (main file)
2. sapthesis-doc.pdf (manual of sapthesis.cls)
3. sapthesis-doc.tex (source of the manual)
- 4. sapthesis-example.pdf (a document example)
- 5. sapthesis-example.tex (source of the example)
- 6. README (this file)
- 7. sapienza-MLred-pos.pdf (red university logo)
- 8. sapienza-MLblack-pos.pdf (black university logo)
- 9. sapthesis.bst (an english BibTeX style)
- 10. sapthesis.layout (sapthesis layout file for LyX)
-
- The following files should end up in your texmf tree
+ 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
@@ -83,15 +93,9 @@
<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/sapthesis-example.pdf
- <texmf>/doc/latex/sapthesis/sapthesis-example.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.
-
- Alternatively, 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. \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/sapthesis/examples/Laurea.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/Laurea.tex
new file mode 100644
index 00000000000..edbf2252da5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/sapthesis/examples/Laurea.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[2]{f}{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}: \$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/Master/texmf-dist/doc/latex/sapthesis/examples/LaureaMagistrale.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/LaureaMagistrale.tex
new file mode 100644
index 00000000000..4be77e41543
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/sapthesis/examples/LaureaMagistrale.tex
@@ -0,0 +1,218 @@
+% !TEX encoding = UTF-8
+% !TEX program = pdflatex
+% !TEX spellcheck = it_IT
+
+\documentclass[LaM,binding=0.6cm]{sapthesis}
+
+\usepackage{microtype}
+\usepackage[italian]{babel}
+\usepackage[utf8]{inputenx}
+
+\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[2]{f}{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}: \$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/Master/texmf-dist/doc/latex/sapthesis/examples/Master.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/Master.tex
new file mode 100644
index 00000000000..1b1a3f04723
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/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[2]{f}{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}: \$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/Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/PhD.tex
index 5afd4533c0e..6a62de2f6f8 100644
--- a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.tex
+++ b/Master/texmf-dist/doc/latex/sapthesis/examples/PhD.tex
@@ -4,52 +4,39 @@
\documentclass[PhD,binding=0.6cm]{sapthesis}
-% READ THE DOCUMENTATION!
-
-% if pdfLaTeX is used load also:
\usepackage{microtype}
% if you write in italian:
%\usepackage[italian]{babel}
-%\usepackage[utf8]{inputenx}
+\usepackage[utf8]{inputenx}
\usepackage{hyperref}
-\hypersetup{colorlinks=true,
- linkcolor=blue,
- anchorcolor=blue,
- citecolor=blue,
- urlcolor=blue,
- pdftitle={Sapthesis class example},
- pdfauthor={Francesco Biccari}}
-
-% dummy text (remove in a normal thesis)
+\hypersetup{pdftitle={Usage example of the Sapthesis class for a PhD thesis},pdfauthor={Francesco Biccari}}
+
+% Remove in a normal thesis
\usepackage{lipsum}
-% draw (remove in a normal thesis unless necessary)
\usepackage{curve2e}
-% definition of gray
\definecolor{gray}{gray}{0.4}
-
-% custom commands
\newcommand{\bs}{\textbackslash}
-\title{How to waste time}
+% Commands for the titlepage
+\title{Usage example of the Sapthesis class\\ for a PhD thesis}
\author{Francesco Biccari}
-\IDnumber{123456}
-\course[Physics]{Fisica} % only one argument for Laurea and Laurea Magistrale
-\courseorganizer{Scuola di dottorato in Scienze Avanzatissime}
-\cycle{XXII}
-\submitdate{April 2010}
-\copyyear{2010}
-\advisor{Prof. Caio Rossi}
-\advisor{Dr. Sempronio Rossi}
-\coadvisor{Dr. Lampa Dina}
-\authoremail{pippo@pippo.com}
-
-\examdate{16 April 2010}
-\examiner{Prof. Enrico Gregorio}
-\examiner{Prof. Claudio Beccari}
-\examiner{Dr. Lorenzo Pantieri}
-\versiondate{1 May 2010}
-\website{biccari.altervista.org}
+\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}
diff --git a/Master/texmf-dist/doc/latex/sapthesis/examples/Specialization.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/Specialization.tex
new file mode 100644
index 00000000000..f80f90ec4ce
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/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[2]{f}{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}: \$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/Master/texmf-dist/doc/latex/sapthesis/examples/TFA.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/TFA.tex
new file mode 100644
index 00000000000..9892edbd2cc
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/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{A049 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[2]{f}{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}: \$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/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.pdf b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.pdf
index 9ead6e8b431..0729b6b9913 100644
--- a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.pdf
+++ b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.tex b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.tex
index c6164d6830d..d5e21735c79 100644
--- a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.tex
+++ b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.tex
@@ -6,8 +6,10 @@
\usepackage[scale=0.85, footskip=0.8cm,heightrounded]{geometry}
\usepackage[T1]{fontenc}
-\usepackage{txfonts}
-\usepackage[warn]{textcomp}
+\usepackage[scaled=1]{newtxtext}
+\usepackage{textcomp}
+\usepackage{amsmath}
+\usepackage[varg,cmintegrals,cmbraces]{newtxmath}
\usepackage{microtype}
\usepackage{graphicx}
\usepackage{color}
@@ -15,14 +17,14 @@
\definecolor{sfondoblu}{rgb}{0.94,0.97,1}
\usepackage{listings}
\lstset{language=[LaTeX]TeX,
- basicstyle=\footnotesize\ttfamily,
+ 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},
+ 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
}
@@ -50,7 +52,7 @@
\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 3.2, 2012-08-15
+ \small \vspace{0.2cm} Version 3.7, 2013-07-20
}
\date{}
@@ -126,19 +128,17 @@ 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{http://www.uniroma1.it/ufficiostampa/identita.php}{Identit\`a visiva}.}
+\href{http://www.uniroma1.it/ateneo/chi-siamo/identit\%C3\%A0-visiva-e-marchio}{Identit\`a visiva e marchio} and \href{http://www.uniroma1.it/logotesi}{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 see the file
-\texttt{sapthesis-example.pdf}.
-In that file the page layout and the layout choices are explained.
+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 thank the Italian \TeX\ user group (\href{http://www.guitex.org/}{GuIT}) for the help provided, in particular Enrico Gregorio.
-I would thank also (alphabetically) Claudio Beccari, Davide Di Bucchianico, Gabriele Di Segni, Matteo Ipri, Giovanni Nuccetelli, Davide Paltrinieri, Francesco Pannarale and Matteo Siccardi.
+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}
@@ -149,8 +149,7 @@ 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; \texttt{sapthesis-example.pdf}, an usage example of
-the class and its source code; an English Bib\TeX\ style, called
+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).
@@ -182,7 +181,7 @@ If your thesis contains only English or very few paragraphs in another language,
\subsection{Class options}
\label{class_options}
-The following options can be passed in the documentclass command.
+The following options can be passed to the documentclass command.
\begin{description}
\item[\texttt{PhD}] Option to typeset a \textit{Dottorato di Ricerca} (PhD) thesis.
@@ -190,6 +189,9 @@ The following options can be passed in the documentclass command.
\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.
@@ -215,7 +217,7 @@ and the thesis in a different language.
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 of the document.
+in the preamble.
\begin{description}
\item[\texttt{\bs title\{\dots\}}] Mandatory.
@@ -231,6 +233,8 @@ in the preamble of the document.
\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}.
+
\item[\texttt{\bs copyyear\{\dots\}}] Mandatory. Copyright year (usually the
graduation year).
@@ -241,6 +245,10 @@ If you have more than one advisor, put several advisor commands in the correct o
\item[\texttt{\bs coadvisor\{\dots\}}] Optional. Co-advisors of the thesis.
Same syntax of the \texttt{\bs advisor} command.
+\item[\texttt{\bs tutor\{\dots\}} and \texttt{\bs tutorcoord\{\dots\}}] Only for TFA. Mandatory.
+
+\item[\texttt{\bs director\{\dots\}}] Only for Specialization. Mandatory.
+
\item[\texttt{\bs authoremail\{\dots\}}] Mandatory. Email of the thesis author.
It is automatically hyper-linked if \textsf{hyperref} package is loaded.
@@ -250,6 +258,11 @@ Use the form\\ \texttt{\bs examdate\{16 February 2010\}}.
\item[\texttt{\bs examiner\{\dots\}}] Optional. Specifies the members of the
board of examiners of the final exam. Usage similar to \texttt{\bs advisor} command.
+\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.
+
\item[\texttt{\bs versiondate\{\dots\}}] Optional. Date version of the thesis.
\item[\texttt{\bs website\{\dots\}}] Optional. Thesis website. Automatically
@@ -283,7 +296,7 @@ This color is switched to black if the \texttt{bn} option is in use. Example of
\begin{itemize}
-\item Do \textbf{not} change the default layout and do \textbf{not} use packages which can modify the layout of your thesis.
+\item Do \textbf{not} change the default layout and do \textbf{not} use packages which can modify the layout of your thesis. However if you want to change the interline spacing, do not use the \texttt{\bs linespread} command. Load instead the \textsf{setspace} package and use the \texttt{\bs onehalfspacing} command.
\item Do \textbf{not} load the following packages in the preamble of your document because already loaded by \textsf{sapthesis}: \textsf{xkeyval}, \textsf{geometry}, \textsf{ifxetex}, \textsf{xltxtra}, \textsf{fontenc}, \textsf{textcomp}, \textsf{lmodern}, \textsf{caption}, \textsf{graphicx}, \textsf{color}, \textsf{booktabs}, \textsf{amsmath}, \textsf{fancyhdr}.
@@ -347,7 +360,7 @@ italian students.
\medskip
\bibitem{Pantieri_Arte}
\href{http://www.lorenzopantieri.net/LaTeX_files/ArteLaTeX.pdf}{\textsc{L.
-Pantieri \& T. Gordini}, \textit{L'arte di scrivere con \LaTeX}, (2011)}
+Pantieri \& T. Gordini}, \textit{L'arte di scrivere con \LaTeX}, (2012)}
\bibitem{Pakin_Symbol}
\href{http://www.ctan.org/tex-archive/info/symbols/comprehensive/symbols-a4.pdf}{\textsc{S. Pakin}, \textit{The comprehensive \LaTeX\ symbol list}, (2009)}
@@ -364,6 +377,10 @@ Pantieri \& T. Gordini}, \textit{L'arte di scrivere con \LaTeX}, (2011)}
\label{sec:PhDexample}
\begin{lstlisting}
+% !TEX encoding = UTF-8
+% !TEX program = pdflatex
+% !TEX spellcheck = en_US
+
\documentclass[binding=0.6cm,PhD]{sapthesis}
\usepackage{microtype}
@@ -414,6 +431,10 @@ This thesis deals with myself.
\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}
@@ -427,7 +448,7 @@ This thesis deals with myself.
\IDnumber{123456}
\course{Fisica}
\courseorganizer{Facolt|\`a| di Scienze Matematiche, Fisiche e Naturali}
-\submitdate{2011/2012}
+\AcademicYear{2011/2012}
\copyyear{2012}
\advisor{Prof. Caio}
\advisor{Dr. Sempronio}
@@ -459,6 +480,63 @@ Questa tesi parla di me.
\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]{inputenx}
+\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}
@@ -507,31 +585,36 @@ For heavy usage of measurement units and to insert numbers in the form
\section{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 macro language: you write a source code decorated with \TeX\ commands, which is then compiled to obtain the final product, a document in pdf format in our case. \LaTeX\ is just a set of macros written in \TeX\ to simplify the writing of the source code: you can think about it 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.
+\TeX, the document preparation system designed by Donald Knuth in 1978, is a program to typeset documents.
+It is a mark-up macro language: you write a source text decorated with \TeX\ commands, which is then compiled to obtain the final product, a document in pdf format in our case.
+\LaTeX\ is just a set of macros written in \TeX\ to simplify the writing of the source text: you can think about it 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}, (2012)}
+Pantieri \& T. Gordini}, \textit{L'arte di scrivere con} \LaTeX, (2012)}
-\item \href{http://www.ctan.org/tex-archive/info/symbols/comprehensive/symbols-a4.pdf}{\textsc{S. Pakin}, \textit{The comprehensive \LaTeX\ symbol list}, (2009)}
+\item \href{http://www.ctan.org/tex-archive/info/symbols/comprehensive/symbols-a4.pdf}{\textsc{S. Pakin}, \textit{The comprehensive} \LaTeX\ \textit{symbol list}, (2009)}
-\item \href{http://profs.sci.univr.it/~gregorio/breveguida.pdf}{\textsc{E. Gregorio}, \textit{\LaTeX: breve guida ai pacchetti di uso pi\`u comune}, (2010)}
+\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 will discuss about the editor, that is the program used to write your source code. Since a source code 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:
+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 this page: {\small \url{http://profs.sci.univr.it/~gregorio/egtex.html}}.
+\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/egtex.html}}.
-\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. Not for beginners.
+\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! (For example do not use TeXnicCenter!)
+\item \textbf{Avoid} other editors unless you know what you are doing!
\end{itemize}
-Now we will explain how to compile the example document provided in the \textsf{sapthesis} package. Double click on the file \texttt{sapthesis-example.tex}. TeXworks should start showing the source code. 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} mechanism).
+Finally we explain how to compile the example document provided in the \textsf{sapthesis} package. Double click on the file \texttt{sapthesis-example.tex}.
+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).
@@ -545,16 +628,16 @@ Using \textsf{sapthesis} with LyX is quite straightforward.
Install \textsf{sapthesis} by the package manager of your \TeX\ distribution or manually.
\item
-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.
+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
-Go in \textsf{View > View Source}. This step is not necessary but it is very useful to observe the \LaTeX\ code produced by LyX (on the right choose ``Complete source'').
+In LyX, go in \textsf{View > View Source}. This step is not necessary but it is very useful to observe the \LaTeX\ code produced by LyX (on the right choose ``Complete source'').
\item
-Copy the file \texttt{sapthesis.layout} in the directory\\ \texttt{C:\bs Program Files\bs Lyx20\bs Resources\bs layouts\bs}\\ and then click on \textsf{Tools > Reconfigure}.
+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}.
\end{itemize}
-Now you are ready to use \textsf{sapthesis}.
+Now you are ready to use \textsf{sapthesis} in LyX.
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. Then you have to write the preamble of the document in \textsf{Document > Settings > LaTeX Preamble}.
diff --git a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.pdf b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.pdf
deleted file mode 100644
index 34c8544a906..00000000000
--- a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.pdf
+++ /dev/null
Binary files differ