summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/sapthesis
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-09-13 23:16:05 +0000
committerKarl Berry <karl@freefriends.org>2011-09-13 23:16:05 +0000
commit7acf90d374f147ba3f73726c03c086049648d7a1 (patch)
tree6dcef1908b9c8854db3da93e17f93a660a5cbf99 /Master/texmf-dist/doc/latex/sapthesis
parent1993bf742a4a04e823f0bbe5d8b90a6d103709f2 (diff)
sapthesis (13sep11)
git-svn-id: svn://tug.org/texlive/trunk@23939 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/sapthesis')
-rw-r--r--Master/texmf-dist/doc/latex/sapthesis/README.TEXLIVE8
-rw-r--r--Master/texmf-dist/doc/latex/sapthesis/README.sapthesis95
-rw-r--r--Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.pdfbin0 -> 141964 bytes
-rw-r--r--Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.tex506
-rw-r--r--Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.pdfbin0 -> 386553 bytes
-rw-r--r--Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.tex259
6 files changed, 868 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/sapthesis/README.TEXLIVE b/Master/texmf-dist/doc/latex/sapthesis/README.TEXLIVE
new file mode 100644
index 00000000000..874b450c1cb
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/sapthesis/README.TEXLIVE
@@ -0,0 +1,8 @@
+The following files have been removed in the TeX Live installation of
+the current package, typically due to duplication, lack of space, or
+missing source code. You can find these files on CTAN at
+ http://mirror.ctan.org/macros/latex/contrib/sapthesis
+If questions or concerns, email tex-live@tug.org.
+
+ marchiologo_nero_positivo.pdf
+ marchiologo_rosso_positivo.pdf
diff --git a/Master/texmf-dist/doc/latex/sapthesis/README.sapthesis b/Master/texmf-dist/doc/latex/sapthesis/README.sapthesis
new file mode 100644
index 00000000000..e2b0dfaf86b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/sapthesis/README.sapthesis
@@ -0,0 +1,95 @@
+*********************************************************************
+* 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-2011 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):
+ http://www.uniroma1.it/ufficiostampa/identita.php
+ In particular it can be used in the theses of "Sapienza"
+ university without explicit authorization.
+
+
+
+** 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.
+ It is compatible with two compilation methods:
+ pdflatex and xelatex.
+
+ 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).
+
+ 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. sapthesis-example.pdf (a document example)
+ 5. sapthesis-example.tex (source of the example)
+ 6. README (this file)
+ 7. marchiologo_rosso_positivo.pdf (university logo)
+ 8. marchiologo_nero_positivo.pdf (university logo)
+ 9. sapthesis.bst (an english BibTeX style)
+
+ The following files should end up in your texmf tree
+ (or your localtexmf tree) at these locations:
+
+ <texmf>/tex/latex/sapthesis/sapthesis.cls
+ <texmf>/tex/latex/sapthesis/marchiologo_rosso_positivo.pdf
+ <texmf>/tex/latex/sapthesis/marchiologo_nero_positivo.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/README
+ <texmf>/bibtex/bst/sapthesis/sapthesis.bst
+
+ Then, you need to update the file database.
+
+ Alternatively, you can simply copy sapthesis.cls and sapthesis.bst
+ together with marchiologo_rosso_positivo.pdf and
+ marchiologo_nero_positivo.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/sapthesis-doc.pdf b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.pdf
new file mode 100644
index 00000000000..3fede7fc9c9
--- /dev/null
+++ 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
new file mode 100644
index 00000000000..ef416cff199
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.tex
@@ -0,0 +1,506 @@
+\documentclass[a5paper,11pt]{article}
+
+\usepackage[scale=0.85, footskip=0.8cm,heightrounded]{geometry}
+\usepackage[T1]{fontenc}
+%txfonts 137 kB
+\usepackage{txfonts}
+%mathptmx 169 kB [warn] in textcomp
+%times 203 kB [warn] in textcomp
+%tgtermes 251 kB
+%lmodern 433 kB
+\usepackage[warn]{textcomp}
+\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=\footnotesize\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},
+ 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 2.8, 2011-09-13
+}
+\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{http://www.uniroma1.it/ufficiostampa/identita.php}{Identit\`a visiva}.}
+
+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.
+\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 Prof.~Enrico Gregorio.
+I would thank also Dr.~Gabriele Di Segni and Dr.~Matteo Siccardi.
+
+\section[Requirements\\ and installation]{Requirements and 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; \texttt{sapthesis-example.pdf}, an usage example of
+the class and its source code; 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{geometry}, \textsf{ifxetex}, \textsf{xltxtra}, \textsf{fontenc}, \textsf{textcomp}, \textsf{lmodern}, \textsf{caption}, \textsf{graphicx}, \textsf{color}, \textsf{booktabs}, \textsf{amsmath}, \textsf{fancyhdr}, \textsf{emptypage}.
+It is highly recommended to not include these packages in the preamble of your document because already loaded by \textsf{sapthesis}.
+
+
+
+
+
+\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 correct options for your case (see Sec.~\ref{class_options}). Then you have to provide some fundamental information (title, author, etc\ldots) by specific commands (see Sec.~\ref{commands_titlepage}). Finally remember that it is important to follow a source code structure similar to those of the examples given in Sec.~\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}
+These options can be passed in the documentclass command.
+
+\begin{description}
+\item[\texttt{PhD}, \texttt{PhDA}, \texttt{PhDB}] The last two options are respectively for PhD theses in Physics and Mathematics. If your PhD is not in Physics or Mathematics, use the simple \texttt{PhD} option. (``Dottorato di ricerca'')
+\item[\texttt{LaM}] Option to typeset a Laurea Magistrale thesis. (``Laurea Specialistica'')
+\item[\texttt{Lau}] Option to typeset a Laurea thesis. (``Laurea Triennale'')
+\item[\texttt{MasterP}, \texttt{MasterS}] Options to typeset a thesis for a
+First level master (``Master di primo livello'') and a Second level master (``Master di secondo livello'') respectively.
+\item[\texttt{draft}] This is the usual draft option of the \LaTeX\ Standard Classes
+\item[\texttt{oneside}] The usual oneside option of the \LaTeX\ Standard Classes
+\item[\texttt{twoside}] (default) The usual twoside option of the \LaTeX\ Standard Classes
+
+\item[\texttt{bn}] This option typesets the frontispiece in black and white
+(using the b/w logo, \texttt{marchiologo\_nero\_positivo.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 the text column.
+It is useful to take in account the margin for the binding (ask to your bookbinder for information).
+\item[\texttt{noexaminfo}] Remove the final exam informations.
+\item[\texttt{italian} or \texttt{english}] Explicitly declare the language of
+the frontispiece. Useful when you want to write the frontispiece in a language
+and the thesis in a different language.
+\item[\texttt{nodefaultfont}] To be documented.
+\item[\texttt{romandiff}] See App.~\ref{sec:usefulcommands}.
+\end{description}
+
+\subsection[Commands for the\\ titlepage]{Commands for the titlepage}
+\label{commands_titlepage}
+
+As usual, the titlepage 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.
+\begin{description}
+\item[\texttt{\bs title\{\dots\}}] Mandatory.
+
+\item[\texttt{\bs author\{\dots\}}] Mandatory
+
+\item[\texttt{\bs IDnumber\{\dots\}}] Mandatory. Your ID number (\textit{matricola} in italian)
+
+\item[\texttt{\bs course[\dots]\{\dots\}}] Use Italian. Mandatory except for PhDA and PhDB options. The optional argument specifies the course name in another language, which is needed only in the case of PhD's.
+
+\item[\texttt{\bs courseorganizer\{\dots\}}] Mandatory except for PhDA and PhDB options.
+
+\item[\texttt{\bs cycle\{\dots\}}] Mandatory only for PhD's. Use the form: \texttt{\bs cycle\{XXII\}}
+
+\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 copyyear\{\dots\}}] Mandatory. Copyright year (usually the
+year of your graduation).
+
+\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\}}] Optional. Co-advisors of the thesis.
+Same syntax of the \texttt{\bs advisor} 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 examdate\{\dots\}}] Optional. Date of the final exam.
+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 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
+\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.
+
+\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 and do \textbf{not} use packages which can modify the layout of your thesis.
+
+
+\item As you already should know, \LaTeX\ can process only document
+in pure ASCII. If you want to insert \emph{directly} other characters, non 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} or \texttt{inputenx}.
+
+However, if your thesis is in English, I suggest to avoid the use of a particular text encoding for the source code because you will insert non ASCII characters very seldom. For this reason it is better to write these characters by the usage of the \LaTeX\ commands (for example \texttt{\bs\sq e} for the \'e letter), avoiding to load \texttt{inputenc} or \texttt{inputenx} package. This has another advantage, in fact your source file will be very portable.
+
+\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, \emph{the table captions should be placed above the table}, whereas the figure caption should be placed 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 in \texttt{sapthesis.cls}).
+
+\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 \emph{should not be used in a thesis}.
+
+\item Do not divide the bibliography per chapter unless it is 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. In this regard
+I recommend the usage of the \texttt{backref} package.
+
+\end{itemize}
+
+
+
+% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
+\addcontentsline{toc}{section}{\refname}
+\begin{thebibliography}{9}
+\item[]
+\hskip-\leftmargin
+\begin{minipage}{\textwidth}
+Many people want to (or are compelled to) write in \LaTeX\ without studying
+a basic manual. Here follows a brief list of documents, especially useful for
+italian students.
+\end{minipage}
+\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)}
+
+\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}, (2008)}
+
+\bibitem{Gregorio_Pacchetti}
+\href{http://profs.sci.univr.it/~gregorio/breveguida.pdf}{\textsc{E. Gregorio}, \textit{\LaTeX: breve guida ai pacchetti di uso pi\`u comune}, (2009)}
+\end{thebibliography}
+
+
+\appendix
+
+\clearpage
+\section{PhD thesis example}
+\label{sec:PhDexample}
+
+\begin{lstlisting}
+\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}
+\documentclass[binding=0.6cm,Lau]{sapthesis} % LaM for a Laurea Magistrale
+
+\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{Fisica}
+\courseorganizer{Facolt|\`a| di Scienze Matematiche, Fisiche e Naturali}
+\submitdate{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{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\}\{\dots\}}] Derivative. The optional parameter is the order of the derivative. The following two arguments are the numerator and the denominator. The differential symbol is automatically inserted.
+
+\item[\texttt{\bs pder[\dots]\{\dots\}\{\dots\}}] Partial derivative. Same as above
+
+\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/Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.pdf b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.pdf
new file mode 100644
index 00000000000..59eec4c4e2c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.tex b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.tex
new file mode 100644
index 00000000000..9195d9a3ded
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.tex
@@ -0,0 +1,259 @@
+\documentclass[binding=0.6cm,PhD]{sapthesis}
+
+% CLASS OPTIONS:
+% PhD: generic PhD
+% PhDA: PhD in physics
+% PhDB: PhD in mathematics
+% LaM: Laurea Magistrale
+% Lau: Laurea
+% noexaminfo: no information about the final exam
+
+% REQUIRED COMMANDS
+% title
+% author
+% IDnumber
+% course (not mandatory if you use PhDA or PhDB)
+% courseorganizer (not mandatory if you use PhDA or PhDB)
+% cycle (only for PhD, PhDA, PhDB)
+% submitdate (use month and year for PhD whereas use XXXX/YYYY academic year for Laurea)
+% copyyear
+% advisor (at least one)
+% authoremail
+
+
+
+% OPTIONAL COMMANDS
+% coadvisor
+% examdate
+% examiner
+% versiondate
+% website
+% ISBN
+
+
+
+% if pdfLaTeX is used load also:
+\usepackage{microtype}
+% if you write in italian:
+%\usepackage[italian]{babel}
+% \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
+\usepackage{lipsum}
+
+% custom commands
+\newcommand{\bs}{\textbackslash}
+
+\title{How to waste time}
+\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{Dr. Lorenzo Pantieri}
+\versiondate{1 May 2010}
+\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 ragazzi
+del GuIT, il Gruppo Utilizzatori Italiani di \TeX, e, in particolare,
+verso il Prof. Enrico Gregorio.
+\end{acknowledgments}
+
+\tableofcontents
+
+\chapter{Non numbered chapter}
+
+
+\lipsum[1-10]
+
+\mainmatter
+\chapter{Style features of \textsf{sapthesis} (this is a numbered chapter)}
+
+The page is fixed at the dimensions of an A4 paper. The font dimension is fixed at 11\, pt and 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 heigth and the text width are in golden ratio (\textasciitilde 1.62) as well as the outer and inner margins in a two-side document after binding margin removal.
+The top margin and bottom margin are instead in the ratio $1\colon\sqrt{2}$. Finally the header and the footer style have been modified by the \texttt{fancyhdr} package.
+
+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)
+
+The titlepage is automatically composed when the \texttt{\bs maketitle} command is given.
+The parameters needed for the titlepage, author, title, etc\ldots , are supplied
+by dedicated commands explained in the next section.
+A copy of the logo, in \texttt{pdf} or in \texttt{eps} format, must be present in the root directory of the thesis.
+These files are supplied in the \texttt{sapthesis.zip} archive.
+
+
+%\section{Common problems}
+%
+%\subsection{Compose a system of equation in displaystyle}
+%
+%Using the array environment to typeset a system of equation has the problem that the mathematics is
+%in textstyle. Usually a student wants the displaystyle. Instead of using \texttt{\bs dfrac} and so on\ldots
+%which produce the wrong vertical spacing, I suggest the following environment definition in the
+%preamble of the document:
+%\begin{lstlisting}
+%\usepackage{mathtools}
+%\usepackage{cases}
+%
+%\newenvironment{system*}%
+%{\begin{displaymath}\left\lbrace \begin{lgathered}}%
+%{\end{lgathered} \right. \end{displaymath}\ignorespacesafterend}
+%
+%\newenvironment{system}[1][]%
+%{\begin{equation}#1\left\lbrace \begin{lgathered}}%
+%{\end{lgathered} \right. \end{equation}\ignorespacesafterend}
+%
+%\newenvironment{subsystem}[1][]%
+%{\begin{subnumcases}{#1}}%
+%{\end{subnumcases}\ignorespacesafterend}
+%\end{lstlisting}
+%
+%\texttt{system*} is for unnumbered systems, \texttt{system} for numbered systems with a number
+%for the entire system and \texttt{subsystem} for numbered system with a subnumbered equations
+%(1a, 1b,\ldots). The optional argument is used to attach a label to the system.
+%
+%Example of usage:
+%\begin{lstlisting}
+%\begin{system}[\label{eq:nice_system}]
+% a=b \\
+% c=d
+%\end{system}
+%\end{lstlisting}
+%
+%However if you do not want to load mathtools package you can use the aligned environment
+%of the amsmath package (already loaded in sapthesis). Example:
+%\begin{lstlisting}
+%\begin{equation}
+% \label{eq:nice_system}
+% \left\lbrace
+% \begin{aligned}
+% & a=b \\
+% & c=d
+% \end{aligned}
+% \right.
+%\end{equation}
+%\end{lstlisting}
+%Notice the usage of the ampersand (\&) used to align to the left the content of the system.
+%
+
+
+\section{A section}
+\lipsum[1-10]
+
+\section{Another section}
+\lipsum
+
+\chapter{Some floating objects and some maths}
+
+\begin{figure}
+\centering
+\includegraphics[width=0.8\textwidth]{marchiologo_rosso_positivo}\\[3ex]
+\includegraphics[width=0.8\textwidth]{marchiologo_nero_positivo}
+\caption{Use vector images as much as possible! \LaTeX\ supports the eps vector image format whereas pdf\LaTeX\ supports the pdf format (and the eps by the epstopdf package).}
+\label{fig:largenenough}
+\end{figure}
+
+\lipsum
+
+\begin{table}
+\caption{This is a simple table. Remember to typeset
+always the table caption above the table. Do not use vertical lines.}
+\label{tab:letters}
+\centering
+\begin{tabular}{lcc}
+\toprule
+Letter & Test & Test \\
+\midrule
+A & C & E \\
+B & D & F \\
+\bottomrule
+\end{tabular}
+\end{table}
+
+\lipsum
+
+And now a simple equation. Note the form of the equation number.
+\begin{equation}
+x_{1,2}=\frac{-b\pm\sqrt{b^2-4ac}}{2a}
+\end{equation}
+
+\lipsum
+
+\appendix
+\chapter{Some special commands}
+
+Some important numbers (we have used the commands \texttt{\bs eu} and \texttt{\bs iu}):
+\begin{equation}
+\eu^{\iu\pi}+1=0
+\end{equation}
+
+\noindent Derivatives (we have used the commands \texttt{\bs der} and \texttt{\bs pder}):
+\begin{equation}
+\der{f}{x} \qquad \pder[2]{f}{y}
+\end{equation}
+
+\noindent Subscripts and superscripts (we have used the commands \texttt{\bs rb} and \texttt{\bs rs}):
+\[
+a_b \neq a\rb{b}\qquad a^b \neq a\rp{b}
+\]
+
+\noindent Unit of measurements (we have used the command \texttt{\bs un}): $25\un{m}$, $3.5\un{m/s}$
+
+\noindent Other commands: (\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, (\$7 \bs x 10\^{}5\$) $7 \x 10^5$. And finally (\texttt{\bs di})
+\[
+\int x \di x
+\]
+
+\medskip
+\lipsum
+\mnote{This is a fancy margin note!}
+\lipsum
+
+\backmatter
+% bibliography
+%\cleardoublepage
+%\bibliographystyle{sapthesis} % BibTeX style
+%\bibliography{bibliography} % BibTeX database without .bib extension
+
+\end{document}