diff options
Diffstat (limited to 'Master')
12 files changed, 826 insertions, 90 deletions
diff --git a/Master/texmf-dist/doc/latex/sapthesis/README b/Master/texmf-dist/doc/latex/sapthesis/README index 38e07b53b86..a3abe943604 100644 --- a/Master/texmf-dist/doc/latex/sapthesis/README +++ b/Master/texmf-dist/doc/latex/sapthesis/README @@ -10,7 +10,7 @@ ** License ********************************************************** - Copyright (c) 2008-2015 by Francesco Biccari. + Copyright (c) 2008-2018 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/ateneo/chi-siamo/identit%C3%A0-visiva-e-marchio + https://www.uniroma1.it/it/pagina/marchio-identita-visiva-e-sistema-grafico In particular it can be used in the theses of "Sapienza" university without explicit authorization. diff --git a/Master/texmf-dist/doc/latex/sapthesis/examples/LaureaMagistrale.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/LaureaMagistrale.tex index 938f879b62f..425de42d61a 100644 --- a/Master/texmf-dist/doc/latex/sapthesis/examples/LaureaMagistrale.tex +++ b/Master/texmf-dist/doc/latex/sapthesis/examples/LaureaMagistrale.tex @@ -2,11 +2,13 @@ % !TeX program = pdflatex % !TeX spellcheck = it_IT -\documentclass[LaM,binding=0.6cm]{sapthesis} +\documentclass[LaM,binding=0.6cm]{../sapthesis} \usepackage{microtype} \usepackage[italian]{babel} -\usepackage[utf8]{inputenx} +\usepackage[utf8]{inputenc} +%\input{ix-utf8enc.dfu} + \usepackage{hyperref} \hypersetup{pdftitle={Esempio d'uso della classe Sapthesis per una tesi di Laurea Magistrale},pdfauthor={Francesco Biccari}} @@ -18,7 +20,8 @@ \newcommand{\bs}{\textbackslash} % Commands for the titlepage -\title{Esempio d'uso della classe Sapthesis\\ per una tesi di Laurea Magistrale} +\title{Esempio d'uso della classe Sapthesis\\ +per una tesi di Laurea Magistrale} \author{Francesco Biccari} \IDnumber{1234567} \course{Fisica} @@ -181,7 +184,7 @@ In this manual you can skip the gray text because it is just dummy text. 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} +\der{f}{x} \qquad \pder{f}{*{2}{y}} \end{equation} @@ -194,7 +197,7 @@ And here it is an usage example of \texttt{\bs tb}: \emph{Cu\tb{It} indicates co 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. +We have also \texttt{\bs x} as abbreviation of \texttt{\bs times}: \texttt{\$7 \bs x 10\^{}5\$} gives $7 \x 10^5$. Then \texttt{\bs di} is the differential symbol which automatically insert the correct spacing. \[ \int x \di x \] diff --git a/Master/texmf-dist/doc/latex/sapthesis/examples/LaureaMagistrale_eng.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/LaureaMagistrale_eng.tex new file mode 100644 index 00000000000..363702f64e4 --- /dev/null +++ b/Master/texmf-dist/doc/latex/sapthesis/examples/LaureaMagistrale_eng.tex @@ -0,0 +1,216 @@ +% !TeX encoding = UTF-8 +% !TeX program = pdflatex +% !TeX spellcheck = en_US + +\documentclass[LaM,binding=0.6cm]{sapthesis} + +\usepackage{microtype} + +\usepackage{hyperref} +\hypersetup{pdftitle={Usage example of the Sapthesis class for a Laurea Magistrale thesis in English},pdfauthor={Francesco Biccari}} + +% Remove in a normal thesis +\usepackage{lipsum} +\usepackage{curve2e} +\definecolor{gray}{gray}{0.4} +\newcommand{\bs}{\textbackslash} + +% Commands for the titlepage +\title{Usage example of the Sapthesis class\\ for a Laurea Magistrale thesis in English} +\author{Francesco Biccari} +\IDnumber{1234567} +\course{Fisica} +\courseorganizer{Facolt\`{a} di Scienze Matematiche, Fisiche e Naturali} +\AcademicYear{2012/2013} +\copyyear{2013} +\advisor{Prof. Nome Cognome} +\advisor{Dr. Nome Cognome} +\coadvisor{Dr. Nome Cognome} +\authoremail{biccari@email.com} + +\examdate{16 April 2013} +\examiner{Prof. Nome Cognome} +\examiner{Prof. Nome Cognome} +\examiner{Dr. Nome Cognome} +\versiondate{\today} + + + +\begin{document} + +\frontmatter + +\maketitle + +\dedication{Dedicated to\\ Donald Knuth} + +\begin{abstract} +This document is an example which shows the main features of +the \LaTeXe\ class \texttt{sapthesis.cls} developed by Francesco Biccari +with the help of GuIT (Gruppo Utilizzatori Italiani di \TeX). +\end{abstract} + +\begin{acknowledgments} +Ho deciso di scrivere i ringraziamenti in italiano +per dimostrare la mia gratitudine verso i membri +del GuIT, il Gruppo Utilizzatori Italiani di \TeX, e, in particolare, +verso il prof. Enrico Gregorio. +\end{acknowledgments} + +\tableofcontents + +% Do not use the starred version of the chapter command! +\chapter{Capitolo non numerato} + +In this manual you can skip the gray text because it is just dummy text.% +\footnote{This is a footnote.} + +\textcolor{gray}{\lipsum[1-22]} + + +\section*{Paragrafo non numerato} + +In this manual you can skip the gray text because it is just dummy text. + +\textcolor{gray}{\lipsum[1-22]} + + + + +\mainmatter + +\chapter{Style features of \textsf{sapthesis}} + +In this chapter I will discuss my stylistic choices of \textsf{sapthesis}. +I will show the page layout geometry and I will describe the page style. + +\section{Page layout} + +The page is fixed at the dimensions of an A4 paper, therefore you have to print your thesis on A4 paper to obtain the best results. The font dimension is fixed at 11\, pt. The text column and the margins are chosen to fill to the best an A4 paper while keeping a reasonable line length (396\, pt) for a good readability. The text height and the text width are in golden ratio (\textasciitilde 1.6180) as well as the outer and inner margins in a two-side document after binding margin removal. Also the top margin (excluding the header) and bottom margin are in the golden ratio. In Fig.~\ref{layout} a sketch of the \textsf{sapthesis} page layout is shown. + +\begin{figure}[h] +\centering +\setlength{\unitlength}{0.27mm} +\begin{picture}(420,297)(-210,0) +\polyline(-210,0)(210,0)(210,297)(-210,297)(-210,0) +\Line(0,0)(0,297) +\put(27.05,37.4){\polygon(0,0)(139.2,0)(139.2,223.8)(0,223.8)} +\put(-27.05,37.4){\polygon(0,0)(-139.2,0)(-139.2,223.8)(0,223.8)} +\put(27.05,268.16){\polygon(0,0)(139.2,0)(139.2,4.22)(0,4.22)} +\put(-27.05,268.16){\polygon(0,0)(-139.2,0)(-139.2,4.22)(0,4.22)} +\end{picture} +\caption{Page layout scheme of \textsf{sapthesis class} using a zero binding margin.} +\label{layout} +\end{figure} + + +\section{Page style} + +The captions have a smaller font respect to the text and the label is in boldface. The appearance of the margin notes has been improved. +They have the same font dimension of the footnotes and are typed in italics. +Moreover I defined a new command to typeset margin note aligned to the left on the right page and vice versa on the left page. +Notice that if a binding margin greater than 1.5\, cm is used, the dimensions of the margin notes become too small and very ugly. +Do not use them in this case. + +The mathematical objects, figures and tables are numbered within the chapters (e.g. 1.1, 1.2,\ldots for the first chapter, 2.1, 2.2 for the second one and so on\ldots). See for example the number of this simple equation +\begin{equation} +x_{1,2}=\frac{-b\pm\sqrt{b^2-4ac}}{2a} +\end{equation} + + +The title page is automatically composed when the \texttt{\bs maketitle} command is given. +The parameters needed for the title page, author, title, etc\ldots , are supplied by dedicated commands explained in the next section. +Two copies of the university logo in \texttt{pdf} format, one for color printing and the other one for black and white printing, are supplied in the \textsf{sapthesis} package. They are shown in Fig.~\ref{fig:largenenough}. + +\begin{figure} +\centering +\includegraphics[width=0.7\textwidth]{sapienza-MLred-pos}\\[3ex] +\includegraphics[width=0.7\textwidth]{sapienza-MLblack-pos} +\caption{Logo of the Sapienza -- University of Rome.} +\label{fig:largenenough} +\end{figure} + + + +\section{About figures and tables} + +As regards the image formats, please use vector images as much as possible! Use jpg images only for photographs! pdf\LaTeX\ supports the pdf, jpg and png formats. + +A very simple table is show in Tab.~\ref{tab:letters}. Remember to typeset +always the table caption above the table. Do not use vertical lines. + +\begin{table} +\caption{This is a simple table.} +\label{tab:letters} +\centering +\begin{tabular}{lcc} +\toprule +Letter & Test & Test \\ +\midrule +A & C & E \\ +B & D & F \\ +\bottomrule +\end{tabular} +\end{table} + + +\section{A section} + +In this manual you can skip the gray text because it is just dummy text. + +\textcolor{gray}{\lipsum[1-10]} + + + +\section{Another section} + +In this manual you can skip the gray text because it is just dummy text. + +\textcolor{gray}{\lipsum} + + +\appendix +\chapter{Special commands provided by \textsf{sapthesis}} + +\textsf{Sapthesis} provides some special commands, particularly useful for scientific works. You can use for example the roman shape, instead of the italic, for the imaginary unit (\texttt{\bs iu}) and Napier's number (\texttt{\bs eu}): +\begin{equation} +\eu^{\iu\pi}+1=0 +\end{equation} + +There are also two commands to speed up the writing of derivatives. In the following example we have used the commands \texttt{\bs der} and \texttt{\bs pder}): +\begin{equation} +\der{f}{x} \qquad \pder{f}{*{2}{y}} +\end{equation} + + +\textsf{Sapthesis} provides also 4 commands to improve the writing of subscripts, \texttt{\bs rb} and \texttt{\bs tb}, and superscripts, \texttt{\bs rp} and \texttt{\bs tp}. Two of these commands, \texttt{\bs rb} and \texttt{\bs rp}, can be used both in text and in math mode and compose their argument in roman. The other two, \texttt{\bs tb} and \texttt{\bs tp}, can be used only in text mode and compose their argument as are. Here it is an usage example of \texttt{\bs rb} and \texttt{\bs rp}: +\[ +a_b \neq a\rb{b}\qquad a^b \neq a\rp{b} +\] +And here it is an usage example of \texttt{\bs tb}: \emph{Cu\tb{It} indicates copper bought in Italy}. And a usage example of \texttt{\bs ts}: \emph{Cher G\tp{le} Napol\'eon}. + + +Then several commands for the correct typesetting of unit of measurements are provided. For example the command \texttt{\bs un} typesets its argument in roman and leaves a thin space between the number and the unit: $25\un{m}$, $3.5\un{m/s}$. Other commands are: (\texttt{\bs g}) 45\g, (\texttt{\bs C}) 30\,\C, (\texttt{\bs A}) 12\,\A, (\texttt{\bs micro}) 40\,\micro m, (\texttt{\bs ohm}) 27\,\ohm. + +We have also \texttt{\bs x} as abbreviation of \texttt{\bs times}: \texttt{\$7 \bs x 10\^{}5\$} gives $7 \x 10^5$. Then \texttt{\bs di} is the differential symbol which automatically insert the correct spacing. +\[ +\int x \di x +\] + +Finally we have defined the color \textsf{sapred} which is the official color +of Sapienza -- University of Rome. It is defined as RGB(130,36,51). \textcolor{sapred}{This text is written with the color \textsf{sapred}.} + +In the following dummy text you can observe the usage of \texttt{\bs mnote} command which typesets fancy margin notes. + +\textcolor{gray}{\lipsum} +\marginpar{This is a fancy margin note!} +\textcolor{gray}{\lipsum} + +\backmatter +% bibliography +%\cleardoublepage +%\phantomsection +%\bibliographystyle{sapthesis} % BibTeX style +%\bibliography{bibliography} % BibTeX database without .bib extension + +\end{document} diff --git a/Master/texmf-dist/doc/latex/sapthesis/examples/LaureaMagistrale_ita.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/LaureaMagistrale_ita.tex new file mode 100644 index 00000000000..425de42d61a --- /dev/null +++ b/Master/texmf-dist/doc/latex/sapthesis/examples/LaureaMagistrale_ita.tex @@ -0,0 +1,221 @@ +% !TeX encoding = UTF-8 +% !TeX program = pdflatex +% !TeX spellcheck = it_IT + +\documentclass[LaM,binding=0.6cm]{../sapthesis} + +\usepackage{microtype} +\usepackage[italian]{babel} +\usepackage[utf8]{inputenc} +%\input{ix-utf8enc.dfu} + + +\usepackage{hyperref} +\hypersetup{pdftitle={Esempio d'uso della classe Sapthesis per una tesi di Laurea Magistrale},pdfauthor={Francesco Biccari}} + +% Remove in a normal thesis +\usepackage{lipsum} +\usepackage{curve2e} +\definecolor{gray}{gray}{0.4} +\newcommand{\bs}{\textbackslash} + +% Commands for the titlepage +\title{Esempio d'uso della classe Sapthesis\\ +per una tesi di Laurea Magistrale} +\author{Francesco Biccari} +\IDnumber{1234567} +\course{Fisica} +\courseorganizer{Facoltà di Scienze Matematiche, Fisiche e Naturali} +\AcademicYear{2012/2013} +\copyyear{2013} +\advisor{Prof. Nome Cognome} +\advisor{Dr. Nome Cognome} +\coadvisor{Dr. Nome Cognome} +\authoremail{biccari@email.com} + +\examdate{16 April 2013} +\examiner{Prof. Nome Cognome} +\examiner{Prof. Nome Cognome} +\examiner{Dr. Nome Cognome} +\versiondate{\today} + + + +\begin{document} + +\frontmatter + +\maketitle + +\dedication{Dedicato a\\ Donald Knuth} + +\begin{abstract} +This document is an example which shows the main features of +the \LaTeXe\ class \texttt{sapthesis.cls} developed by Francesco Biccari +with the help of GuIT (Gruppo Utilizzatori Italiani di \TeX). +\end{abstract} + +\begin{acknowledgments} +Ho deciso di scrivere i ringraziamenti in italiano +per dimostrare la mia gratitudine verso i membri +del GuIT, il Gruppo Utilizzatori Italiani di \TeX, e, in particolare, +verso il prof. Enrico Gregorio. +\end{acknowledgments} + +\tableofcontents + +% Do not use the starred version of the chapter command! +\chapter{Capitolo non numerato} + +In this manual you can skip the gray text because it is just dummy text.% +\footnote{This is a footnote.} + +\textcolor{gray}{\lipsum[1-22]} + + +\section*{Paragrafo non numerato} + +In this manual you can skip the gray text because it is just dummy text. + +\textcolor{gray}{\lipsum[1-22]} + + + + +\mainmatter + +\chapter{Style features of \textsf{sapthesis}} + +In this chapter I will discuss my stylistic choices of \textsf{sapthesis}. +I will show the page layout geometry and I will describe the page style. + +\section{Page layout} + +The page is fixed at the dimensions of an A4 paper, therefore you have to print your thesis on A4 paper to obtain the best results. The font dimension is fixed at 11\, pt. The text column and the margins are chosen to fill to the best an A4 paper while keeping a reasonable line length (396\, pt) for a good readability. The text height and the text width are in golden ratio (\textasciitilde 1.6180) as well as the outer and inner margins in a two-side document after binding margin removal. Also the top margin (excluding the header) and bottom margin are in the golden ratio. In Fig.~\ref{layout} a sketch of the \textsf{sapthesis} page layout is shown. + +\begin{figure}[h] +\centering +\setlength{\unitlength}{0.27mm} +\begin{picture}(420,297)(-210,0) +\polyline(-210,0)(210,0)(210,297)(-210,297)(-210,0) +\Line(0,0)(0,297) +\put(27.05,37.4){\polygon(0,0)(139.2,0)(139.2,223.8)(0,223.8)} +\put(-27.05,37.4){\polygon(0,0)(-139.2,0)(-139.2,223.8)(0,223.8)} +\put(27.05,268.16){\polygon(0,0)(139.2,0)(139.2,4.22)(0,4.22)} +\put(-27.05,268.16){\polygon(0,0)(-139.2,0)(-139.2,4.22)(0,4.22)} +\end{picture} +\caption{Page layout scheme of \textsf{sapthesis class} using a zero binding margin.} +\label{layout} +\end{figure} + + +\section{Page style} + +The captions have a smaller font respect to the text and the label is in boldface. The appearance of the margin notes has been improved. +They have the same font dimension of the footnotes and are typed in italics. +Moreover I defined a new command to typeset margin note aligned to the left on the right page and vice versa on the left page. +Notice that if a binding margin greater than 1.5\, cm is used, the dimensions of the margin notes become too small and very ugly. +Do not use them in this case. + +The mathematical objects, figures and tables are numbered within the chapters (e.g. 1.1, 1.2,\ldots for the first chapter, 2.1, 2.2 for the second one and so on\ldots). See for example the number of this simple equation +\begin{equation} +x_{1,2}=\frac{-b\pm\sqrt{b^2-4ac}}{2a} +\end{equation} + + +The title page is automatically composed when the \texttt{\bs maketitle} command is given. +The parameters needed for the title page, author, title, etc\ldots , are supplied by dedicated commands explained in the next section. +Two copies of the university logo in \texttt{pdf} format, one for color printing and the other one for black and white printing, are supplied in the \textsf{sapthesis} package. They are shown in Fig.~\ref{fig:largenenough}. + +\begin{figure} +\centering +\includegraphics[width=0.7\textwidth]{sapienza-MLred-pos}\\[3ex] +\includegraphics[width=0.7\textwidth]{sapienza-MLblack-pos} +\caption{Logo of the Sapienza -- University of Rome.} +\label{fig:largenenough} +\end{figure} + + + +\section{About figures and tables} + +As regards the image formats, please use vector images as much as possible! Use jpg images only for photographs! pdf\LaTeX\ supports the pdf, jpg and png formats. + +A very simple table is show in Tab.~\ref{tab:letters}. Remember to typeset +always the table caption above the table. Do not use vertical lines. + +\begin{table} +\caption{This is a simple table.} +\label{tab:letters} +\centering +\begin{tabular}{lcc} +\toprule +Letter & Test & Test \\ +\midrule +A & C & E \\ +B & D & F \\ +\bottomrule +\end{tabular} +\end{table} + + +\section{A section} + +In this manual you can skip the gray text because it is just dummy text. + +\textcolor{gray}{\lipsum[1-10]} + + + +\section{Another section} + +In this manual you can skip the gray text because it is just dummy text. + +\textcolor{gray}{\lipsum} + + +\appendix +\chapter{Special commands provided by \textsf{sapthesis}} + +\textsf{Sapthesis} provides some special commands, particularly useful for scientific works. You can use for example the roman shape, instead of the italic, for the imaginary unit (\texttt{\bs iu}) and Napier's number (\texttt{\bs eu}): +\begin{equation} +\eu^{\iu\pi}+1=0 +\end{equation} + +There are also two commands to speed up the writing of derivatives. In the following example we have used the commands \texttt{\bs der} and \texttt{\bs pder}): +\begin{equation} +\der{f}{x} \qquad \pder{f}{*{2}{y}} +\end{equation} + + +\textsf{Sapthesis} provides also 4 commands to improve the writing of subscripts, \texttt{\bs rb} and \texttt{\bs tb}, and superscripts, \texttt{\bs rp} and \texttt{\bs tp}. Two of these commands, \texttt{\bs rb} and \texttt{\bs rp}, can be used both in text and in math mode and compose their argument in roman. The other two, \texttt{\bs tb} and \texttt{\bs tp}, can be used only in text mode and compose their argument as are. Here it is an usage example of \texttt{\bs rb} and \texttt{\bs rp}: +\[ +a_b \neq a\rb{b}\qquad a^b \neq a\rp{b} +\] +And here it is an usage example of \texttt{\bs tb}: \emph{Cu\tb{It} indicates copper bought in Italy}. And a usage example of \texttt{\bs ts}: \emph{Cher G\tp{le} Napol\'eon}. + + +Then several commands for the correct typesetting of unit of measurements are provided. For example the command \texttt{\bs un} typesets its argument in roman and leaves a thin space between the number and the unit: $25\un{m}$, $3.5\un{m/s}$. Other commands are: (\texttt{\bs g}) 45\g, (\texttt{\bs C}) 30\,\C, (\texttt{\bs A}) 12\,\A, (\texttt{\bs micro}) 40\,\micro m, (\texttt{\bs ohm}) 27\,\ohm. + +We have also \texttt{\bs x} as abbreviation of \texttt{\bs times}: \texttt{\$7 \bs x 10\^{}5\$} gives $7 \x 10^5$. Then \texttt{\bs di} is the differential symbol which automatically insert the correct spacing. +\[ +\int x \di x +\] + +Finally we have defined the color \textsf{sapred} which is the official color +of Sapienza -- University of Rome. It is defined as RGB(130,36,51). \textcolor{sapred}{This text is written with the color \textsf{sapred}.} + +In the following dummy text you can observe the usage of \texttt{\bs mnote} command which typesets fancy margin notes. + +\textcolor{gray}{\lipsum} +\marginpar{This is a fancy margin note!} +\textcolor{gray}{\lipsum} + +\backmatter +% bibliography +%\cleardoublepage +%\phantomsection +%\bibliographystyle{sapthesis} % BibTeX style +%\bibliography{bibliography} % BibTeX database without .bib extension + +\end{document} diff --git a/Master/texmf-dist/doc/latex/sapthesis/examples/Laurea_ita.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/Laurea_ita.tex new file mode 100644 index 00000000000..851ae6b35fb --- /dev/null +++ b/Master/texmf-dist/doc/latex/sapthesis/examples/Laurea_ita.tex @@ -0,0 +1,218 @@ +% !TeX encoding = UTF-8 +% !TeX program = pdflatex +% !TeX spellcheck = it_IT + +\documentclass[Lau,binding=0.6cm]{sapthesis} + +\usepackage{microtype} +\usepackage[italian]{babel} +\usepackage[utf8]{inputenx} + +\usepackage{hyperref} +\hypersetup{pdftitle={Sapthesis class example},pdfauthor={Francesco Biccari}} + +% Remove in a normal thesis +\usepackage{lipsum} +\usepackage{curve2e} +\definecolor{gray}{gray}{0.4} +\newcommand{\bs}{\textbackslash} + +% Commands for the titlepage +\title{Esempio d'uso della classe Sapthesis\\ per una tesi di Laurea} +\author{Francesco Biccari} +\IDnumber{1234567} +\course{Fisica} +\courseorganizer{Facoltà di Scienze Matematiche, Fisiche e Naturali} +\AcademicYear{2012/2013} +\copyyear{2013} +\advisor{Prof. Nome Cognome} +\advisor{Dr. Nome Cognome} +\coadvisor{Dr. Nome Cognome} +\authoremail{biccari@email.com} + +\examdate{16 April 2013} +\examiner{Prof. Nome Cognome} +\examiner{Prof. Nome Cognome} +\examiner{Dr. Nome Cognome} +\versiondate{\today} + + + +\begin{document} + +\frontmatter + +\maketitle + +\dedication{Dedicato a\\ Donald Knuth} + +\begin{abstract} +This document is an example which shows the main features of +the \LaTeXe\ class \texttt{sapthesis.cls} developed by Francesco Biccari +with the help of GuIT (Gruppo Utilizzatori Italiani di \TeX). +\end{abstract} + +\begin{acknowledgments} +Ho deciso di scrivere i ringraziamenti in italiano +per dimostrare la mia gratitudine verso i membri +del GuIT, il Gruppo Utilizzatori Italiani di \TeX, e, in particolare, +verso il prof. Enrico Gregorio. +\end{acknowledgments} + +\tableofcontents + +% Do not use the starred version of the chapter command! +\chapter{Capitolo non numerato} + +In this manual you can skip the gray text because it is just dummy text.% +\footnote{This is a footnote.} + +\textcolor{gray}{\lipsum[1-22]} + + +\section*{Paragrafo non numerato} + +In this manual you can skip the gray text because it is just dummy text. + +\textcolor{gray}{\lipsum[1-22]} + + + + +\mainmatter + +\chapter{Style features of \textsf{sapthesis}} + +In this chapter I will discuss my stylistic choices of \textsf{sapthesis}. +I will show the page layout geometry and I will describe the page style. + +\section{Page layout} + +The page is fixed at the dimensions of an A4 paper, therefore you have to print your thesis on A4 paper to obtain the best results. The font dimension is fixed at 11\, pt. The text column and the margins are chosen to fill to the best an A4 paper while keeping a reasonable line length (396\, pt) for a good readability. The text height and the text width are in golden ratio (\textasciitilde 1.6180) as well as the outer and inner margins in a two-side document after binding margin removal. Also the top margin (excluding the header) and bottom margin are in the golden ratio. In Fig.~\ref{layout} a sketch of the \textsf{sapthesis} page layout is shown. + +\begin{figure}[h] +\centering +\setlength{\unitlength}{0.27mm} +\begin{picture}(420,297)(-210,0) +\polyline(-210,0)(210,0)(210,297)(-210,297)(-210,0) +\Line(0,0)(0,297) +\put(27.05,37.4){\polygon(0,0)(139.2,0)(139.2,223.8)(0,223.8)} +\put(-27.05,37.4){\polygon(0,0)(-139.2,0)(-139.2,223.8)(0,223.8)} +\put(27.05,268.16){\polygon(0,0)(139.2,0)(139.2,4.22)(0,4.22)} +\put(-27.05,268.16){\polygon(0,0)(-139.2,0)(-139.2,4.22)(0,4.22)} +\end{picture} +\caption{Page layout scheme of \textsf{sapthesis class} using a zero binding margin.} +\label{layout} +\end{figure} + + +\section{Page style} + +The captions have a smaller font respect to the text and the label is in boldface. The appearance of the margin notes has been improved. +They have the same font dimension of the footnotes and are typed in italics. +Moreover I defined a new command to typeset margin note aligned to the left on the right page and vice versa on the left page. +Notice that if a binding margin greater than 1.5\, cm is used, the dimensions of the margin notes become too small and very ugly. +Do not use them in this case. + +The mathematical objects, figures and tables are numbered within the chapters (e.g. 1.1, 1.2,\ldots for the first chapter, 2.1, 2.2 for the second one and so on\ldots). See for example the number of this simple equation +\begin{equation} +x_{1,2}=\frac{-b\pm\sqrt{b^2-4ac}}{2a} +\end{equation} + + +The title page is automatically composed when the \texttt{\bs maketitle} command is given. +The parameters needed for the title page, author, title, etc\ldots , are supplied by dedicated commands explained in the next section. +Two copies of the university logo in \texttt{pdf} format, one for color printing and the other one for black and white printing, are supplied in the \textsf{sapthesis} package. They are shown in Fig.~\ref{fig:largenenough}. + +\begin{figure} +\centering +\includegraphics[width=0.7\textwidth]{sapienza-MLred-pos}\\[3ex] +\includegraphics[width=0.7\textwidth]{sapienza-MLblack-pos} +\caption{Logo of the Sapienza -- University of Rome.} +\label{fig:largenenough} +\end{figure} + + + +\section{About figures and tables} + +As regards the image formats, please use vector images as much as possible! Use jpg images only for photographs! pdf\LaTeX\ supports the pdf, jpg and png formats. + +A very simple table is show in Tab.~\ref{tab:letters}. Remember to typeset +always the table caption above the table. Do not use vertical lines. + +\begin{table} +\caption{This is a simple table.} +\label{tab:letters} +\centering +\begin{tabular}{lcc} +\toprule +Letter & Test & Test \\ +\midrule +A & C & E \\ +B & D & F \\ +\bottomrule +\end{tabular} +\end{table} + + +\section{A section} + +In this manual you can skip the gray text because it is just dummy text. + +\textcolor{gray}{\lipsum[1-10]} + + + +\section{Another section} + +In this manual you can skip the gray text because it is just dummy text. + +\textcolor{gray}{\lipsum} + + +\appendix +\chapter{Special commands provided by \textsf{sapthesis}} + +\textsf{Sapthesis} provides some special commands, particularly useful for scientific works. You can use for example the roman shape, instead of the italic, for the imaginary unit (\texttt{\bs iu}) and Napier's number (\texttt{\bs eu}): +\begin{equation} +\eu^{\iu\pi}+1=0 +\end{equation} + +There are also two commands to speed up the writing of derivatives. In the following example we have used the commands \texttt{\bs der} and \texttt{\bs pder}): +\begin{equation} +\der{f}{x} \qquad \pder{f}{*{2}{y}} +\end{equation} + + +\textsf{Sapthesis} provides also 4 commands to improve the writing of subscripts, \texttt{\bs rb} and \texttt{\bs tb}, and superscripts, \texttt{\bs rp} and \texttt{\bs tp}. Two of these commands, \texttt{\bs rb} and \texttt{\bs rp}, can be used both in text and in math mode and compose their argument in roman. The other two, \texttt{\bs tb} and \texttt{\bs tp}, can be used only in text mode and compose their argument as are. Here it is an usage example of \texttt{\bs rb} and \texttt{\bs rp}: +\[ +a_b \neq a\rb{b}\qquad a^b \neq a\rp{b} +\] +And here it is an usage example of \texttt{\bs tb}: \emph{Cu\tb{It} indicates copper bought in Italy}. And a usage example of \texttt{\bs ts}: \emph{Cher G\tp{le} Napol\'eon}. + + +Then several commands for the correct typesetting of unit of measurements are provided. For example the command \texttt{\bs un} typesets its argument in roman and leaves a thin space between the number and the unit: $25\un{m}$, $3.5\un{m/s}$. Other commands are: (\texttt{\bs g}) 45\g, (\texttt{\bs C}) 30\,\C, (\texttt{\bs A}) 12\,\A, (\texttt{\bs micro}) 40\,\micro m, (\texttt{\bs ohm}) 27\,\ohm. + +We have also \texttt{\bs x} as abbreviation of \texttt{\bs times}: \texttt{\$7 \bs x 10\^{}5\$} gives $7 \x 10^5$. Then \texttt{\bs di} is the differential symbol which automatically insert the correct spacing. +\[ +\int x \di x +\] + +Finally we have defined the color \textsf{sapred} which is the official color +of Sapienza -- University of Rome. It is defined as RGB(130,36,51). \textcolor{sapred}{This text is written with the color \textsf{sapred}.} + +In the following dummy text you can observe the usage of \texttt{\bs mnote} command which typesets fancy margin notes. + +\textcolor{gray}{\lipsum} +\marginpar{This is a fancy margin note!} +\textcolor{gray}{\lipsum} + +\backmatter +% bibliography +%\cleardoublepage +%\phantomsection +%\bibliographystyle{sapthesis} % BibTeX style +%\bibliography{bibliography} % BibTeX database without .bib extension + +\end{document} diff --git a/Master/texmf-dist/doc/latex/sapthesis/examples/Master.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/Master.tex index b615b1a10f7..c780e79ee82 100644 --- a/Master/texmf-dist/doc/latex/sapthesis/examples/Master.tex +++ b/Master/texmf-dist/doc/latex/sapthesis/examples/Master.tex @@ -182,7 +182,7 @@ In this manual you can skip the gray text because it is just dummy text. 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} +\der{f}{x} \qquad \pder{f}{*{2}{y}} \end{equation} @@ -195,7 +195,7 @@ And here it is an usage example of \texttt{\bs tb}: \emph{Cu\tb{It} indicates co 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. +We have also \texttt{\bs x} as abbreviation of \texttt{\bs times}: \texttt{\$7 \bs x 10\^{}5\$} gives $7 \x 10^5$. Then \texttt{\bs di} is the differential symbol which automatically insert the correct spacing. \[ \int x \di x \] diff --git a/Master/texmf-dist/doc/latex/sapthesis/examples/PhD.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/PhD.tex index cb7d76dd961..20dadb8c815 100644 --- a/Master/texmf-dist/doc/latex/sapthesis/examples/PhD.tex +++ b/Master/texmf-dist/doc/latex/sapthesis/examples/PhD.tex @@ -2,7 +2,7 @@ % !TeX program = pdflatex % !TeX spellcheck = en_US -\documentclass[PhD,binding=0.6cm]{sapthesis} +\documentclass[PhD,binding=0.6cm]{../sapthesis} \usepackage{microtype} % if you write in italian: @@ -184,7 +184,7 @@ In this manual you can skip the gray text because it is just dummy text. There are also two commands to speed up the writing of derivatives. In the following example we have used the commands \texttt{\bs der} and \texttt{\bs pder}): \begin{equation} -\der{f}{x} \qquad \pder{f}{*{2}{x},y} +\der{f}{x} \qquad \pder{f}{*{2}{y}} \end{equation} @@ -197,7 +197,7 @@ And here it is an usage example of \texttt{\bs tb}: \emph{Cu\tb{It} indicates co 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. +We have also \texttt{\bs x} as abbreviation of \texttt{\bs times}: \texttt{\$7 \bs x 10\^{}5\$} gives $7 \x 10^5$. Then \texttt{\bs di} is the differential symbol which automatically insert the correct spacing. \[ \int x \di x \] diff --git a/Master/texmf-dist/doc/latex/sapthesis/examples/Specialization.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/Specialization.tex index 0a9fb6c318a..db99767f6bb 100644 --- a/Master/texmf-dist/doc/latex/sapthesis/examples/Specialization.tex +++ b/Master/texmf-dist/doc/latex/sapthesis/examples/Specialization.tex @@ -183,7 +183,7 @@ In this manual you can skip the gray text because it is just dummy text. 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} +\der{f}{x} \qquad \pder{f}{*{2}{y}} \end{equation} @@ -196,7 +196,7 @@ And here it is an usage example of \texttt{\bs tb}: \emph{Cu\tb{It} indicates co 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. +We have also \texttt{\bs x} as abbreviation of \texttt{\bs times}: \texttt{\$7 \bs x 10\^{}5\$} gives $7 \x 10^5$. Then \texttt{\bs di} is the differential symbol which automatically insert the correct spacing. \[ \int x \di x \] diff --git a/Master/texmf-dist/doc/latex/sapthesis/examples/TFA.tex b/Master/texmf-dist/doc/latex/sapthesis/examples/TFA.tex index ec0a1bb4799..ddebabbf4da 100644 --- a/Master/texmf-dist/doc/latex/sapthesis/examples/TFA.tex +++ b/Master/texmf-dist/doc/latex/sapthesis/examples/TFA.tex @@ -28,7 +28,7 @@ \title{Esempio d'uso della classe Sapthesis\\ per la relazione di tirocinio del TFA} \author{Francesco Biccari} \IDnumber{1234567} -\course{A049 Matematica e Fisica} +\course{A027 Matematica e Fisica} \courseorganizer{Facoltà di Scienze Matematiche, Fisiche e Naturali} \AcademicYear{2012/2013} \copyyear{2013} @@ -192,7 +192,7 @@ In this manual you can skip the gray text because it is just dummy text. 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} +\der{f}{x} \qquad \pder{f}{*{2}{y}} \end{equation} @@ -205,7 +205,7 @@ And here it is an usage example of \texttt{\bs tb}: \emph{Cu\tb{It} indicates co 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. +We have also \texttt{\bs x} as abbreviation of \texttt{\bs times}: \texttt{\$7 \bs x 10\^{}5\$} gives $7 \x 10^5$. Then \texttt{\bs di} is the differential symbol which automatically insert the correct spacing. \[ \int x \di x \] diff --git a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.pdf b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.pdf Binary files differindex 0994b27bc66..80268090c7f 100644 --- a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.pdf +++ b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.pdf diff --git a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.tex b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.tex index 9afe86e72c7..67c736eceb6 100644 --- a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.tex +++ b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.tex @@ -53,7 +53,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.8, 2015-12-04 + \small \vspace{0.2cm} Version 4.1, 2018-08-07 } \date{} @@ -129,7 +129,7 @@ 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/ateneo/chi-siamo/identit\%C3\%A0-visiva-e-marchio}{Identit\`a visiva e marchio} and \href{http://www.uniroma1.it/logotesi}{Template tesi}.} +\href{https://www.uniroma1.it/it/pagina/marchio-identita-visiva-e-sistema-grafico}{Marchio, identità visiva e sistema grafico} and \href{https://www.uniroma1.it/it/pagina/impaginazione-della-tesi-e-logo}{Template tesi}.} For these reasons I thought that a \LaTeX\ class for the theses of my university would have been a good idea. @@ -157,7 +157,7 @@ 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{Sapthesis} explicitely loads the packages \textsf{xkeyval}, \textsf{etoolbox}, \textsf{geometry}, \textsf{ifxetex}, \textsf{xltxtra}, \textsf{fontenc}, \textsf{textcomp}, \textsf{lmodern}, \textsf{caption}, \textsf{graphicx}, \textsf{color}, \textsf{booktabs}, \textsf{amsmath}, \textsf{fancyhdr}. Do \textbf{not} include these packages in the preamble of your document! @@ -223,19 +223,21 @@ As usual, the title page is generated by the \texttt{\bs maketitle} command. It needs some information that you can supply by the following commands in the preamble. \begin{description} -\item[\texttt{\bs title\{\dots\}}] Mandatory. +\item[\texttt{\bs title\{\dots\}}] Mandatory. Title. -\item[\texttt{\bs author\{\dots\}}] Mandatory +\item[\texttt{\bs subtitle\{\dots\}}] Optional. Subtitle (try to avoid a subtitle). -\item[\texttt{\bs IDnumber\{\dots\}}] Mandatory. Your ID number (\textit{matricola} in Italian) +\item[\texttt{\bs author\{\dots\}}] Mandatory. Author (student's name). -\item[\texttt{\bs course[\dots]\{\dots\}}] Mandatory. Use the official Italian name of the course. The optional argument specifies the course name in another language, which is needed in the case of PhD's theses because of the ``requirements'' declaration. +\item[\texttt{\bs IDnumber\{\dots\}}] Mandatory. ID number (\textit{matricola} in Italian). -\item[\texttt{\bs courseorganizer\{\dots\}}] Mandatory. +\item[\texttt{\bs course[\dots]\{\dots\}}] Mandatory. Use the official Italian name of the course. If the optional argument \texttt{override} is specified, the mandatory argument is used to specify the entire course line in the frontispiece. In this way it is possible to override the behavior of the class (not recommended!). + +\item[\texttt{\bs courseorganizer\{\dots\}}] Mandatory. Course organizer. \item[\texttt{\bs submitdate\{\dots\}}] Mandatory. Use the form \texttt{\bs submitdate\{April 2009\}} for PhD's and the form \texttt{\bs submitdate\{2009/2010\}} for Laurea theses. -\item[\texttt{\bs AcademicYear\{\dots\}}] Alias for \texttt{\bs submitdate}. +\item[\texttt{\bs AcademicYear\{\dots\}}] Alias for \texttt{\bs submitdate}. Academic Year. \item[\texttt{\bs copyyear\{\dots\}}] Mandatory. Copyright year (usually the graduation year). @@ -244,8 +246,11 @@ graduation year). 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 coadvisor[\dots]\{\dots\}}] Optional. Co-advisors of the thesis. +Same syntax of the \texttt{\bs advisor} command. If the optional argument \texttt{ext} is specified, ``External advisor'' will be printed instead of ``Co-Advisor''. + +\item[\texttt{\bs reviewer\{\dots\}}] Optional. Reviewers of the thesis. +Same syntax of the \texttt{\bs advisor} command. The list of the reviewer is preceded by the a text which can be specified by the \texttt{\bs reviewerlabel\{\dots\}} command. \item[\texttt{\bs authoremail\{\dots\}}] Mandatory. Email of the thesis author. It is automatically hyper-linked if \textsf{hyperref} package is loaded. @@ -257,11 +262,14 @@ hyper-linked if \textsf{hyperref} package is loaded. \item[\texttt{\bs ISBN\{\dots\}}] Optional. ISBN +\item[\texttt{\bs copyrightstatement\{\dots\}}] Optional. Specify a copyright statement that will be printed in place of the default one. + + \item[\texttt{\bs examdate\{\dots\}}] Optional. Date of the final exam.\\ Example: \texttt{\bs examdate\{16 February 2010\}}. -\item[\texttt{\bs examiner\{\dots\}}] Optional. Specifies the members of the -board of examiners of the final exam. Usage similar to \texttt{\bs advisor} command. +\item[\texttt{\bs examiner[\dots]\{\dots\}}] Optional. Specifies the members of the +board of examiners of the final exam. Usage similar to \texttt{\bs advisor} command. The optional argument can be used to specify the role of that examiner in the commission. \item[\texttt{\bs cycle\{\dots\}}] Mandatory only for PhD's. Use the form: \texttt{\bs cycle\{XXII\}} @@ -301,15 +309,12 @@ 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. 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} change the default layout. If you want to change the interline spacing, do not use the \texttt{\bs linespread} command. Load instead the \textsf{setspace} package and use, for example, the \texttt{\bs onehalfspacing} command. \item Do \textbf{not} load the packages already loaded by \textsf{sapthesis} (see Sec.~\ref{requirements_installation}). \item As you already should know, \LaTeX\ can process only documents -in pure ASCII. If you want to insert \emph{directly} other characters, not included in the 128 ASCII -characters (for example accented letters), you have to use a particular text encoding for your source file. Then you have to ``tell'' to \LaTeX\ which encoding you have chosen by the packages \texttt{inputenc} 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. +in pure ASCII. If you want to insert \emph{directly} other characters, not included in the 128 ASCII characters (for example accented letters), you have to use a particular text encoding for your source file. Then you have to ``tell'' to \LaTeX\ which encoding you have chosen by the packages \texttt{inputenc}. It is always recommended to use UTF-8 character encoding and specify this choice also by the \emph{magic lines} at the beginning of the source code (see the examples in App.~\ref{sec:PhDexample} and~\ref{sec:LaMexample}). \item Respect the following thesis structure: @@ -365,9 +370,9 @@ The following list of \LaTeX\ manuals, may be especially useful for Italian auth \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, (2017)} -\item \href{http://www.ctan.org/tex-archive/info/symbols/comprehensive/symbols-a4.pdf}{\textsc{S. Pakin}, \textit{The comprehensive} \LaTeX\ \textit{symbol list}, (2015)} +\item \href{http://mirror.ctan.org/info/symbols/comprehensive/symbols-a4.pdf}{\textsc{S. Pakin}, \textit{The comprehensive} \LaTeX\ \textit{symbol list}, (2017)} \item \href{http://profs.sci.univr.it/~gregorio/breveguida.pdf}{\textsc{E. Gregorio}, \LaTeX\textit{: breve guida ai pacchetti di uso pi\`u comune}, (2010)} \end{itemize} @@ -376,7 +381,7 @@ In order to use \LaTeX, you have to install a \TeX\ distribution. It contains th Finally we discuss the editor, that is the program used to write your source file. Since a source file written in \LaTeX, like in any other programming language, is a simple text file, you can write your code with any text editor you want (for example Notepad in Windows). However the suggested editors are: \begin{itemize} -\item \href{http://tug.org/texworks/}{TeXworks}. Already installed with any \TeX\ distribution. Very simple and powerful. Use TeXworks if you are not an expert. Enrico Gregorio has written a very good and brief TeXworks manual in Italian, which can be found at: {\small \url{http://profs.sci.univr.it/~gregorio/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/introtexworks.pdf}}. \item \href{http://texstudio.sourceforge.net/}{TeXstudio} (cross-platform), \href{http://www.xm1math.net/texmaker/}{TeXmaker} (cross-platform), \href{http://pages.uoregon.edu/koch/texshop/}{TeXshop} (only for Mac), \href{http://kile.sourceforge.net/}{Kile} (only for Linux). Powerful editors. @@ -490,7 +495,7 @@ This thesis deals with myself. \usepackage{microtype} \usepackage[italian]{babel} -\usepackage[utf8]{inputenx} +\usepackage[utf8]{inputenc} \usepackage{hyperref} \hypersetup{pdftitle={La mia tesi},pdfauthor={Francesco Biccari}} @@ -545,7 +550,7 @@ Questa tesi parla di me. \usepackage{microtype} \usepackage[italian]{babel} -\usepackage[utf8]{inputenx} +\usepackage[utf8]{inputenc} \usepackage{hyperref} \hypersetup{pdftitle={La mia tesi},pdfauthor={Francesco Biccari}} diff --git a/Master/texmf-dist/tex/latex/sapthesis/sapthesis.cls b/Master/texmf-dist/tex/latex/sapthesis/sapthesis.cls index d776340f628..d420c4a6617 100644 --- a/Master/texmf-dist/tex/latex/sapthesis/sapthesis.cls +++ b/Master/texmf-dist/tex/latex/sapthesis/sapthesis.cls @@ -1,7 +1,7 @@ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %% sapthesis.cls %% -%% version 3.8 %% -%% 2015-12-04 %% +%% version 4.1 %% +%% 2018-08-07 %% %% author: Francesco Biccari %% %% contact: biccari@gmail.com %% %% %% @@ -20,9 +20,9 @@ \NeedsTeXFormat{LaTeX2e}[2009/01/01] \ProvidesClass{sapthesis}% -[2015/12/04 Sapienza - University of Rome thesis class] +[2018/08/07 Sapienza - University of Rome thesis class] -\def\SAP@classVersion{3.8} +\def\SAP@classVersion{4.1} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %% Options %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -42,6 +42,7 @@ \newif\ifSAP@TFA \SAP@TFAfalse \newif\ifSAP@noexaminfo \SAP@noexaminfofalse \newif\ifSAP@femaleauthor \SAP@femaleauthorfalse +\newif\ifSAP@overridecourse \SAP@overridecoursefalse \newcommand{\SAP@customlanguage}{} @@ -130,6 +131,7 @@ \RequirePackage{color} \RequirePackage{booktabs} \RequirePackage{amsmath} +\RequirePackage{etoolbox} @@ -214,14 +216,15 @@ %% GENERAL COMMANDS +\def\SAP@subtitle{} \def\SAP@courseorganizerLabel{} \def\SAP@courseLabel{} -\def\SAP@PhDcourseDeclarationLabel{} +\newcommand{\subtitle}[1]{\def\SAP@subtitle{#1}} \newcommand{\courseorganizer}[1]{\def\SAP@courseorganizerLabel{#1}} \newcommand{\course}[2][]{% \def\SAP@courseLabel{#2} - \def\SAP@PhDcourseDeclarationLabel{\if?#1?\SAP@courseLabel\else#1\fi}} + \ifstrequal{#1}{override}{\SAP@overridecoursetrue}{}} \def\SAP@copyyear{} \newcommand{\copyyear}[1]{\def\SAP@copyyear{#1}} @@ -247,17 +250,37 @@ \fi \advance\SAP@advisorcount\@ne} -%% Co-Advisors +%% Co-Advisors or External Advisor \newcount\SAP@coadvisorcount \newtoks\SAP@coadvisortoks -\newcommand{\coadvisor}[1]{% +\newif\ifSAP@ext \SAP@extfalse +\newcommand{\coadvisor}[2][]{% \ifnum\SAP@coadvisorcount=\z@ - \SAP@coadvisortoks={#1}% + \SAP@coadvisortoks={#2}% \else - \SAP@coadvisortoks=\expandafter{\the\SAP@coadvisortoks\\[0.75mm]#1}% + \SAP@coadvisortoks=\expandafter{\the\SAP@coadvisortoks\\[0.75mm]#2}% \fi - \advance\SAP@coadvisorcount\@ne} + \advance\SAP@coadvisorcount\@ne + \ifstrequal{#1}{ext}{\SAP@exttrue}{}} + + +%% Reviewers +\def\SAP@ReviewerLabel{} +\newcommand{\reviewerlabel}[1]{\def\SAP@ReviewerLabel{#1}} + +\newcount\SAP@reviewercount +\newtoks\SAP@reviewertoks +\newcommand{\reviewer}[1]{% + \ifnum\SAP@reviewercount=\z@ + \SAP@reviewertoks={#1}% + \else + \SAP@reviewertoks=\expandafter{\the\SAP@reviewertoks\\[0.75mm]#1}% + \fi + \advance\SAP@reviewercount\@ne} + + + %% Directors \newcount\SAP@directorcount \newtoks\SAP@directortoks @@ -294,11 +317,11 @@ %% Examiners \newcount\SAP@examinercount \newtoks\SAP@examinertoks -\newcommand{\examiner}[1]{% +\newcommand{\examiner}[2][]{% \ifnum\SAP@examinercount=\z@ - \SAP@examinertoks={#1 (\SAP@chairman)}% + \SAP@examinertoks={#2 (\SAP@chairman\if|#1|\relax\else, #1\fi)}% \else - \SAP@examinertoks=\expandafter{\the\SAP@examinertoks\\[0.75mm]#1}% + \SAP@examinertoks=\expandafter{\the\SAP@examinertoks\\[0.75mm]#2 \if|#1|\relax\else (#1)\fi}% \fi \advance\SAP@examinercount\@ne} @@ -317,6 +340,9 @@ \def\SAP@ISBN{} \newcommand{\ISBN}[1]{\def\SAP@ISBN{#1}} +\def\SAP@copyrightstatement{} +\newcommand{\copyrightstatement}[1]{\def\SAP@copyrightstatement{#1}} + \def\SAP@schoolname{} \newcommand{\schoolname}[1]{\def\SAP@schoolname{#1}} @@ -340,9 +366,9 @@ \if|\SAP@courseorganizerLabel|\ClassError{sapthesis}{You must specify the Ph.D. % organizer}{Example: \protect\courseorganizer{Scuola di dottorato di ...}}\fi \if|\SAP@courseLabel|\ClassError{sapthesis}{You must specify the Ph.D. % - course}{Example: \protect\course[Fisica]{Physics}}\fi -\if|\SAP@cycle|\ClassError{sapthesis}{You must specify the Ph.D. % - cycle (cycle)}{Example: \protect\cycle{XXIII} The Ph.D. cycle must be in the roman numbers}\fi + course}{Example: \protect\course{Physics}}\fi +\ifSAP@overridecourse\relax\else\if|\SAP@cycle|\ClassError{sapthesis}{You must specify the Ph.D. % + cycle (cycle)}{Example: \protect\cycle{XXIII} The Ph.D. cycle must be in the roman numbers}\fi\fi \if|\SAP@submitdate|\ClassError{sapthesis}{You must specify the % thesis submission date}{Example: \protect\submitdate{August 2012} The date must be in the form Month(name) Year(number)}\fi \if|\SAP@copyyear|\ClassError{sapthesis}{You must specify the % @@ -374,12 +400,19 @@ \nointerlineskip \SAP@parbox{\LARGE\textcolor{sapred}{\@title}\par} + + \if|\SAP@subtitle| + \relax + \else + \vspace{0.4cm} + \SAP@parbox{\linespread{1.2}\selectfont\textcolor{sapred}{\large\SAP@subtitle}\par} + \fi \vspace{\stretch{1}} \SAP@parbox[3cm]{% \textcolor{sapred}{\SAP@courseorganizerLabel\\[2mm] - Dottorato di Ricerca in \SAP@courseLabel\ -- \SAP@cycle\ Ciclo}} + \ifSAP@overridecourse\SAP@courseLabel\else Dottorato di Ricerca in \SAP@courseLabel\ -- \SAP@cycle\ Ciclo\fi}} \SAP@parbox[3cm]{% \ifSAP@femaleauthor @@ -410,15 +443,14 @@ \ifcase\SAP@coadvisorcount \relax \or - \SAP@ThesisCoAdvisorLabel\\[2mm] + \ifSAP@ext\SAP@ThesisExtAdvisorLabel\else\SAP@ThesisCoAdvisorLabel\fi\\[2mm] \else - \SAP@ThesisCoAdvisorsLabel\\[2mm] + \ifSAP@ext\SAP@ThesisExtAdvisorsLabel\else\SAP@ThesisCoAdvisorsLabel\fi\\[2mm] \fi \the\SAP@coadvisortoks} }} - \SAP@parbox{\SAP@DeclarationLabel\ \SAP@PhDcourseDeclarationLabel\\[2mm] - \SAP@submitdate} + \SAP@parbox{\SAP@submitdate} \end{titlepage} \clearpage @@ -435,6 +467,8 @@ \if|\SAP@courseorganizerLabel|\ClassError{sapthesis}{You must specify the Specialization course % organizer}{Example: \protect\courseorganizer{Faculty of ...}}\fi +\if|\SAP@courseLabel|\ClassError{sapthesis}{You must specify the % + course}{Example: \protect\course{Fisica}}\fi \if|\SAP@submitdate|\ClassError{sapthesis}{You must specify the Academic % Year}{Example: \protect\submitdate{2011/2012}}\fi \if|\SAP@IDnumber|\ClassError{sapthesis}{You must specify your % @@ -466,12 +500,19 @@ \nointerlineskip \SAP@parbox{\LARGE\textcolor{sapred}{\@title}\par} - + + \if|\SAP@subtitle| + \relax + \else + \vspace{0.4cm} + \SAP@parbox{\linespread{1.2}\selectfont\textcolor{sapred}{\large\SAP@subtitle}\par} + \fi + \vspace{\stretch{0.9}} \SAP@parbox[3cm]{% \textcolor{sapred}{\SAP@courseorganizerLabel\\[2mm] - Corso di specializzazione in \SAP@courseLabel}} + \ifSAP@overridecourse\SAP@courseLabel\else Corso di specializzazione in \SAP@courseLabel\fi}} \SAP@parbox[3cm]{% \ifSAP@femaleauthor @@ -512,9 +553,9 @@ \parbox[t]{5.9cm}{% \ifcase\SAP@coadvisorcount \or - \SAP@ThesisCoAdvisorLabel\\[2mm] - \else - \SAP@ThesisCoAdvisorsLabel\\[2mm] + \ifSAP@ext\SAP@ThesisExtAdvisorLabel\else\SAP@ThesisCoAdvisorLabel\fi\\[2mm] + \else + \ifSAP@ext\SAP@ThesisExtAdvisorsLabel\else\SAP@ThesisCoAdvisorsLabel\fi\\[2mm] \fi \the\SAP@coadvisortoks} }} @@ -533,6 +574,8 @@ \if|\SAP@courseorganizerLabel|\ClassError{sapthesis}{You must specify the degree % organizer}{Example: \protect\courseorganizer{Faculty of ...}}\fi +\if|\SAP@courseLabel|\ClassError{sapthesis}{You must specify the % + course}{Example: \protect\course{Fisica}}\fi \if|\SAP@submitdate|\ClassError{sapthesis}{You must specify the Academic % Year}{Example: \protect\submitdate{2011/2012}}\fi \if|\SAP@IDnumber|\ClassError{sapthesis}{You must specify your % @@ -564,12 +607,19 @@ \nointerlineskip \SAP@parbox{\LARGE\textcolor{sapred}{\@title}\par} - + + \if|\SAP@subtitle| + \relax + \else + \vspace{0.4cm} + \SAP@parbox{\linespread{1.2}\selectfont\textcolor{sapred}{\large\SAP@subtitle}\par} + \fi + \vspace{\stretch{0.9}} \SAP@parbox[3cm]{% \textcolor{sapred}{\SAP@courseorganizerLabel\\[2mm] - Corso di Laurea \ifSAP@LaM Magistrale \fi in \SAP@courseLabel}} + \ifSAP@overridecourse\SAP@courseLabel\else Corso di Laurea \ifSAP@LaM Magistrale \fi in \SAP@courseLabel\fi}} \SAP@parbox[3cm]{% \ifSAP@femaleauthor @@ -597,9 +647,9 @@ \ifcase\SAP@coadvisorcount \relax \or - \SAP@ThesisCoAdvisorLabel\\[2mm] + \ifSAP@ext\SAP@ThesisExtAdvisorLabel\else\SAP@ThesisCoAdvisorLabel\fi\\[2mm] \else - \SAP@ThesisCoAdvisorsLabel\\[2mm] + \ifSAP@ext\SAP@ThesisExtAdvisorsLabel\else\SAP@ThesisCoAdvisorsLabel\fi\\[2mm] \fi \the\SAP@coadvisortoks} }} @@ -622,6 +672,8 @@ \if|\SAP@courseorganizerLabel|\ClassError{sapthesis}{You must specify the degree % organizer}{Example: \protect\courseorganizer{Faculty of ...}}\fi +\if|\SAP@courseLabel|\ClassError{sapthesis}{You must specify the % + course}{Example: \protect\course{Fisica}}\fi \if|\SAP@submitdate|\ClassError{sapthesis}{You must specify the Academic % Year}{Example: \protect\submitdate{2011/2012}}\fi \if|\SAP@IDnumber|\ClassError{sapthesis}{You must specify your % @@ -653,12 +705,19 @@ \nointerlineskip \SAP@parbox{\LARGE\textcolor{sapred}{\@title}\par} - + + \if|\SAP@subtitle| + \relax + \else + \vspace{0.4cm} + \SAP@parbox{\linespread{1.2}\selectfont\textcolor{sapred}{\large\SAP@subtitle}\par} + \fi + \vspace{\stretch{0.9}} \SAP@parbox[3cm]{% \textcolor{sapred}{\SAP@courseorganizerLabel\\[2mm] - Master di \ifSAP@MasterP primo \fi \ifSAP@MasterS secondo \fi livello in \SAP@courseLabel}} + \ifSAP@overridecourse\SAP@courseLabel\else Master di \ifSAP@MasterP primo \fi \ifSAP@MasterS secondo \fi livello in \SAP@courseLabel\fi}} \SAP@parbox[3cm]{% \ifSAP@femaleauthor @@ -686,9 +745,9 @@ \ifcase\SAP@coadvisorcount \relax \or - \SAP@ThesisCoAdvisorLabel\\[2mm] + \ifSAP@ext\SAP@ThesisExtAdvisorLabel\else\SAP@ThesisCoAdvisorLabel\fi\\[2mm] \else - \SAP@ThesisCoAdvisorsLabel\\[2mm] + \ifSAP@ext\SAP@ThesisExtAdvisorsLabel\else\SAP@ThesisCoAdvisorsLabel\fi\\[2mm] \fi \the\SAP@coadvisortoks} }} @@ -741,13 +800,20 @@ \nointerlineskip \SAP@parbox{\LARGE\textcolor{sapred}{\@title}\par} - + + \if|\SAP@subtitle| + \relax + \else + \vspace{0.4cm} + \SAP@parbox{\linespread{1.2}\selectfont\textcolor{sapred}{\large\SAP@subtitle}\par} + \fi + \vspace{\stretch{0.9}} \SAP@parbox[3cm]{% \textcolor{sapred}{\SAP@courseorganizerLabel\\[2mm] Tirocinio Formativo Attivo\\[2mm] - Classe \SAP@courseLabel}} + \ifSAP@overridecourse\SAP@courseLabel\else Classe \SAP@courseLabel\fi}} \SAP@parbox[3cm]{% \ifSAP@femaleauthor @@ -775,9 +841,9 @@ \ifcase\SAP@coadvisorcount \relax \or - \SAP@ThesisCoAdvisorLabel\\[2mm] + \ifSAP@ext\SAP@ThesisExtAdvisorLabel\else\SAP@ThesisCoAdvisorLabel\fi\\[2mm] \else - \SAP@ThesisCoAdvisorsLabel\\[2mm] + \ifSAP@ext\SAP@ThesisExtAdvisorsLabel\else\SAP@ThesisCoAdvisorsLabel\fi\\[2mm] \fi \the\SAP@coadvisortoks} } @@ -856,6 +922,15 @@ \fi \fi +\vspace{1cm} + +\ifcase\SAP@reviewercount + \relax +\else + \SAP@ReviewerLabel:\\[2mm] + \the\SAP@reviewertoks% +\fi + \vfill \hrulefill @@ -872,7 +947,7 @@ \ifSAP@TFA\SAP@TFAthesistype\fi . \SAP@sapienzaname \\[0.75mm] \if|\SAP@ISBN|\relax\else ISBN: \SAP@ISBN\fi\\[0.75mm] -\copyright\ \SAP@copyyear\ \@author. \SAP@allRightsReservedLabel\\[1.5mm] +\if|\SAP@copyrightstatement|\copyright\ \SAP@copyyear\ \@author. \SAP@allRightsReservedLabel\else\SAP@copyrightstatement\fi\\[1.5mm] %Material for which the author is the copyright owner cannot be %used without the written permission of the author. @@ -954,6 +1029,8 @@ \newcommand{\SAP@ThesisAdvisorsLabel}{Thesis Advisors} \newcommand{\SAP@ThesisCoAdvisorLabel}{Co-Advisor} \newcommand{\SAP@ThesisCoAdvisorsLabel}{Co-Advisors} + \newcommand{\SAP@ThesisExtAdvisorLabel}{External Advisor} + \newcommand{\SAP@ThesisExtAdvisorsLabel}{External Advisors} \newcommand{\SAP@ThesisDirectorLabel}{Director} \newcommand{\SAP@ThesisDirectorsLabel}{Directors} \newcommand{\SAP@ThesisTutorLabel}{Trainee's Tutor} @@ -962,19 +1039,16 @@ \newcommand{\SAP@ThesisTutorCoordsLabel}{Coordinating Tutors} \newcommand{\SAP@TFAschoolHeadLabel}{Training done at:} \newcommand{\SAP@TFAschoolPrincipalLabel}{Principal} - \newcommand{\SAP@DeclarationLabel}{A thesis - submitted in partial fulfillment of the requirements\\ - for the degree of Doctor of Philosophy in} \newcommand{\SAP@ThesisNotDefensedLabel}{Thesis not yet defended} \newcommand{\SAP@ThesisDefensedLabelA}{Thesis defended on} \newcommand{\SAP@ThesisDefensedLabelB}{in front of a Board of Examiners composed by} \newcommand{\SAP@chairman}{chairman} \newcommand{\SAP@PhDthesistype}{Ph.D. thesis} \newcommand{\SAP@Specializationthesistype}{Specialization thesis} - \newcommand{\SAP@LaMthesistype}{Master thesis} - \newcommand{\SAP@Lauthesistype}{Bachelor thesis} - \newcommand{\SAP@MasterPthesistype}{First level master thesis} - \newcommand{\SAP@MasterSthesistype}{Second level master thesis} + \newcommand{\SAP@LaMthesistype}{Master's thesis} + \newcommand{\SAP@Lauthesistype}{Bachelor's thesis} + \newcommand{\SAP@MasterPthesistype}{First level master's thesis} + \newcommand{\SAP@MasterSthesistype}{Second level master's thesis} \newcommand{\SAP@TFAthesistype}{TFA report} \newcommand{\SAP@sapienzaname}{Sapienza -- University of Rome} \newcommand{\SAP@versionLabel}{Version} @@ -994,6 +1068,8 @@ \newcommand{\SAP@ThesisAdvisorsLabel}{Relatori} \newcommand{\SAP@ThesisCoAdvisorLabel}{Correlatore} \newcommand{\SAP@ThesisCoAdvisorsLabel}{Correlatori} + \newcommand{\SAP@ThesisExtAdvisorLabel}{Relatore esterno} + \newcommand{\SAP@ThesisExtAdvisorsLabel}{Relatori esterni} \newcommand{\SAP@ThesisDirectorLabel}{Direttore} \newcommand{\SAP@ThesisDirectorsLabel}{Direttori} \newcommand{\SAP@ThesisTutorLabel}{Tutor del Tirocinante} @@ -1002,9 +1078,6 @@ \newcommand{\SAP@ThesisTutorCoordsLabel}{Tutor Coordinatori} \newcommand{\SAP@TFAschoolHeadLabel}{Tirocinio svolto presso:} \newcommand{\SAP@TFAschoolPrincipalLabel}{Dirigente scolastico} - \newcommand{\SAP@DeclarationLabel}{Tesi presentata - in parziale adempimento dei requisiti necessari\\ - per conseguire il titolo di Dottore di Ricerca in} \newcommand{\SAP@ThesisNotDefensedLabel}{Tesi non ancora discussa} \newcommand{\SAP@ThesisDefensedLabelA}{Tesi discussa il} \newcommand{\SAP@ThesisDefensedLabelB}{di fronte a una commissione esaminatrice composta da} |