diff options
Diffstat (limited to 'Master')
| -rw-r--r-- | Master/texmf-dist/doc/latex/sapthesis/README | 2 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.pdf | bin | 142993 -> 154966 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.tex | 66 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.pdf | bin | 386653 -> 425700 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.tex | 50 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/sapthesis/sapthesis.layout | 7 | ||||
| -rw-r--r-- | Master/texmf-dist/tex/latex/sapthesis/sapthesis.cls | 43 |
7 files changed, 103 insertions, 65 deletions
diff --git a/Master/texmf-dist/doc/latex/sapthesis/README b/Master/texmf-dist/doc/latex/sapthesis/README index debf41690e5..28105857797 100644 --- a/Master/texmf-dist/doc/latex/sapthesis/README +++ b/Master/texmf-dist/doc/latex/sapthesis/README @@ -73,6 +73,7 @@ 7. sapienza-MLred-pos.pdf (red university logo) 8. sapienza-MLblack-pos.pdf (black university logo) 9. sapthesis.bst (an english BibTeX style) + 10. sapthesis.layout (sapthesis layout file for LyX) The following files should end up in your texmf tree (or your localtexmf tree) at these locations: @@ -86,6 +87,7 @@ <texmf>/doc/latex/sapthesis/sapthesis-example.tex <texmf>/doc/latex/sapthesis/README <texmf>/bibtex/bst/sapthesis/sapthesis.bst + <texmf>/doc/latex/sapthesis/sapthesis.layout Then, you need to update the file database. diff --git a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.pdf b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.pdf Binary files differindex 729bedeb62b..9ead6e8b431 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 c76b1de0123..c6164d6830d 100644 --- a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.tex +++ b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-doc.tex @@ -6,12 +6,7 @@ \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} @@ -55,7 +50,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.1.1, 2012-03-02 + \small \vspace{0.2cm} Version 3.2, 2012-08-15 } \date{} @@ -212,6 +207,7 @@ the title page. Useful when you want to write the title page in a language and the thesis in a different language. \item[\texttt{nodefaultfont}] Avoid the loading of packages \textsf{fontenc}, \textsf{textcomp} and \textsf{lmodern}. \item[\texttt{romandiff}] See App.~\ref{sec:usefulcommands}. +\item[\texttt{fem}] Use the feminine (only Italian): ``candidata'' instead of ``candidato''. \end{description} \subsection[Commands for the\\ title page]{Commands for the title page} @@ -236,7 +232,7 @@ in the preamble of the document. \item[\texttt{\bs submitdate\{\dots\}}] Mandatory. Use the form \texttt{\bs submitdate\{April 2009\}} for PhD's and the form \texttt{\bs submitdate\{2009/2010\}} for Laurea theses. \item[\texttt{\bs copyyear\{\dots\}}] Mandatory. Copyright year (usually the -year of your graduation). +graduation year). \item[\texttt{\bs advisor\{\dots\}}] You must specify at least one advisor. If you have more than one advisor, put several advisor commands in the correct order:\\ @@ -508,5 +504,61 @@ For heavy usage of measurement units and to insert numbers in the form \end{description} + +\section{A very brief introduction to the \TeX\ world} + +\TeX, the document preparation system designed by Donald Knuth in 1978, is a program to typeset documents. It is a mark-up macro language: you write a source code decorated with \TeX\ commands, which is then compiled to obtain the final product, a document in pdf format in our case. \LaTeX\ is just a set of macros written in \TeX\ to simplify the writing of the source code: you can think about it as a simpler programming language with respect to \TeX. A source code written in \LaTeX\ can be compiled by several ``compilers': \texttt{pdflatex} (the most common), or \texttt{xelatex}, or others. The following list of \LaTeX\ manuals, may be especially useful for Italian authors. + +\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)} + +\item \href{http://www.ctan.org/tex-archive/info/symbols/comprehensive/symbols-a4.pdf}{\textsc{S. Pakin}, \textit{The comprehensive \LaTeX\ symbol list}, (2009)} + +\item \href{http://profs.sci.univr.it/~gregorio/breveguida.pdf}{\textsc{E. Gregorio}, \textit{\LaTeX: breve guida ai pacchetti di uso pi\`u comune}, (2010)} +\end{itemize} + +In order to use \LaTeX, you have to install a \TeX\ distribution. It contains the compilers, several fonts and other files needed by the compilers and also many \emph{packages}, which can be thought as libraries or extensions of \LaTeX. The most famous distributions are \href{http://miktex.org/}{MiKTeX} (available only for Windows), \href{http://www.tug.org/texlive/}{TeX Live} (available both for Windows and Linux) and \href{http://www.tug.org/mactex/2011/}{MacTeX} (available only for Mac OS). + +Finally we will discuss about the editor, that is the program used to write your source code. Since a source code written in \LaTeX, like in any other programming language, is a simple text file, you can write your code with any text editor you want (for example Notepad in Windows). However the suggested editors are: +\begin{itemize} +\item \href{http://tug.org/texworks/}{TeXworks}. Already installed with any \TeX\ distribution. Very simple and powerful. Use TeXworks if you are not an expert. Enrico Gregorio has written a very good and brief TeXworks manual in Italian, which can be found at this page: {\small \url{http://profs.sci.univr.it/~gregorio/egtex.html}}. + +\item \href{http://texstudio.sourceforge.net/}{TeXstudio} (cross-platform), \href{http://www.xm1math.net/texmaker/}{TeXmaker} (cross-platform), \href{http://pages.uoregon.edu/koch/texshop/}{TeXshop} (only for Mac), \href{http://kile.sourceforge.net/}{Kile} (only for Linux). Powerful editors. Not for beginners. + +\item \textbf{Avoid} other editors unless you know what you are doing! (For example do not use TeXnicCenter!) + +\end{itemize} + +Now we will explain how to compile the example document provided in the \textsf{sapthesis} package. Double click on the file \texttt{sapthesis-example.tex}. TeXworks should start showing the source code. The \texttt{pdflatex} compiler should be automatically selected thanks to the \emph{magic lines} placed at the beginning of the file. Now in order to compile press the green button. +At the end of the compilation the resulting pdf appears in a separate window. Remember to compile at least three times, because \LaTeX\ needs more than one compilation to correctly resolve the internal cross references (for example for the table of contents composition, or when you refer to a figure by the \texttt{\bs label} \texttt{\bs ref} mechanism). + + + +\section{Using LyX} + +LyX is an advanced \LaTeX\ editor which does not simply show the source code like any text editor, but instead it renders maths, images, tables and some text formatting commands. However this ``layer'' between the writer and the real source code is sometimes frustrating and many authors discourage the usage of LyX. + +Using \textsf{sapthesis} with LyX is quite straightforward. +\begin{itemize} +\item +Install \textsf{sapthesis} by the package manager of your \TeX\ distribution or manually. + +\item +First of all go in \textsf{Tools > Preferences > Language Settings > Language} and choose "none" in Language package. This step is necessary because LyX not only loads babel with the desired language, but it passes the language also as an option for the class! This triggers an error in many classes. + +\item +Go in \textsf{View > View Source}. This step is not necessary but it is very useful to observe the \LaTeX\ code produced by LyX (on the right choose ``Complete source''). + +\item +Copy the file \texttt{sapthesis.layout} in the directory\\ \texttt{C:\bs Program Files\bs Lyx20\bs Resources\bs layouts\bs}\\ and then click on \textsf{Tools > Reconfigure}. +\end{itemize} + +Now you are ready to use \textsf{sapthesis}. +Create a new document and go in \textsf{Document > Settings > Document Class}. Here you can choose \textsf{sapthesis} as the class for the document and write the class options. Then you have to write the preamble of the document in \textsf{Document > Settings > LaTeX Preamble}. + + + + \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 Binary files differindex 988a6f17090..34c8544a906 100644 --- a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.pdf +++ b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.pdf diff --git a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.tex b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.tex index cf9cae0620a..5afd4533c0e 100644 --- a/Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.tex +++ b/Master/texmf-dist/doc/latex/sapthesis/sapthesis-example.tex @@ -4,54 +4,13 @@ \documentclass[PhD,binding=0.6cm]{sapthesis} -% MAIN CLASS OPTIONS -% -% PhD: generic PhD -% PhDA: PhD in physics -% PhDB: PhD in mathematics -% LaM: Laurea Magistrale -% Lau: Laurea -% MasterP: Master di primo livello -% MasterS: Master di secondo livello -% -% draft -% oneside/twoside -% bn -% binding=length -% 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 - +% READ THE DOCUMENTATION! % if pdfLaTeX is used load also: \usepackage{microtype} % if you write in italian: -% \usepackage[italian]{babel} -% \usepackage[utf8]{inputenx} +%\usepackage[italian]{babel} +%\usepackage[utf8]{inputenx} \usepackage{hyperref} \hypersetup{colorlinks=true, @@ -121,7 +80,8 @@ verso il prof. Enrico Gregorio. % Do not use the starred version of the chapter command! \chapter{Non numbered chapter} -In this manual you can skip the gray text because it is just dummy text. +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]} diff --git a/Master/texmf-dist/doc/latex/sapthesis/sapthesis.layout b/Master/texmf-dist/doc/latex/sapthesis/sapthesis.layout new file mode 100644 index 00000000000..38df02417e8 --- /dev/null +++ b/Master/texmf-dist/doc/latex/sapthesis/sapthesis.layout @@ -0,0 +1,7 @@ +#\DeclareLaTeXClass[sapthesis]{book (sapthesis)} +Input stdclass.inc + +#% Copy this file in Lyx20\Resources\layouts\ folder +# In LyX, do: Tools > Reconfigure ; Restart Lyx. +# Choose the file class inside the Document properties +# and customize the preamble
\ No newline at end of file diff --git a/Master/texmf-dist/tex/latex/sapthesis/sapthesis.cls b/Master/texmf-dist/tex/latex/sapthesis/sapthesis.cls index 4ccd8b1945d..6046c0e7469 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.1.1 %% -%% 2012-03-02 %% +%% version 3.2 %% +%% 2012-08-15 %% %% author: Francesco Biccari %% %% contact: biccari@gmail.com %% %% %% @@ -18,11 +18,11 @@ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %% Identification %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\NeedsTeXFormat{LaTeX2e} +\NeedsTeXFormat{LaTeX2e}[2009/01/01] \ProvidesClass{sapthesis}% -[2012/03/02 Sapienza - University of Rome thesis class] - +[2012/08/15 Sapienza - University of Rome thesis class] +\def\SAP@classVersion{3.2} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %% Options %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -39,9 +39,12 @@ \newif\ifSAP@LaM \SAP@LaMfalse \newif\ifSAP@Lau \SAP@Laufalse \newif\ifSAP@noexaminfo \SAP@noexaminfofalse +\newif\ifSAP@femaleauthor \SAP@femaleauthorfalse + \newcommand{\SAP@customlanguage}{} \define@key[sap]{}{noexaminfo}[]{\SAP@noexaminfotrue} +\define@key[sap]{}{fem}[]{\SAP@femaleauthortrue} \define@key[sap]{}{nodefaultfont}[]{\SAP@nodefaultfonttrue} \define@key[sap]{}{romandiff}[]{\SAP@romandifftrue} \define@key[sap]{}{italian}[]{\SAP@customlanguagetrue @@ -72,7 +75,7 @@ \ifSAP@Lau\relax\else \ifSAP@MasterP\relax\else \ifSAP@MasterS\relax\else - \ClassError{sapthesis}{You must specify the PhD, LaM, Lau, MasterP or% + \ClassError{sapthesis}{You must specify the PhD, LaM, Lau, MasterP or % MasterS option}{} \fi \fi @@ -276,15 +279,15 @@ \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 + course}{Example: \protect\course[Fisica]{Physics}}\fi \if|\SAP@cycle|\ClassError{sapthesis}{You must specify the Ph.D. % - cycle (cycle)}{The Ph.D. cycle must be in the roman numbers}\fi + cycle (cycle)}{Example: \protect\cycle{XXIII} The Ph.D. cycle must be in the roman numbers}\fi \if|\SAP@submitdate|\ClassError{sapthesis}{You must specify the % - thesis submission date}{The date must be in the form Month(name) Year(number)}\fi + thesis submission date}{Example: \protect\submitdate{August 2012} The date must be in the form Month(name) Year(number)}\fi \if|\SAP@copyyear|\ClassError{sapthesis}{You must specify the % copyright year}{Example: \protect\copyyear{2012}}\fi \if|\SAP@IDnumber|\ClassError{sapthesis}{You must specify your % - ID number (matricola)}{E.g. 123456}\fi + ID number (matricola)}{Example: \protect\IDnumber{123456}}\fi \if|\SAP@authoremail|\ClassError{sapthesis}{You must specify the email of the author}{% Example: \protect\authoremail{author@email.com}}\fi @@ -316,7 +319,11 @@ Dottorato di Ricerca in \SAP@courseLabel\ -- \SAP@cycle\ Ciclo}} \SAP@parbox[3cm]{% - \SAP@CandidateLabel\\[2mm] + \ifSAP@femaleauthor + \SAP@CandidateLabelFemale\\[2mm] + \else + \SAP@CandidateLabel\\[2mm] + \fi \@author\\[0.75mm] \SAP@IDnumberLabel\ \SAP@IDnumber} @@ -402,7 +409,11 @@ Corso di Laurea \ifSAP@LaM Magistrale \fi in \SAP@courseLabel}} \SAP@parbox[3cm]{% - \SAP@CandidateLabel\\[2mm] + \ifSAP@femaleauthor + \SAP@CandidateLabelFemale\\[2mm] + \else + \SAP@CandidateLabel\\[2mm] + \fi \@author\\[0.75mm] \SAP@IDnumberLabel\ \SAP@IDnumber} @@ -485,7 +496,11 @@ Master di \ifSAP@MasterP primo \fi \ifSAP@MasterS secondo \fi livello in \SAP@courseLabel}} \SAP@parbox[3cm]{% - \SAP@CandidateLabel\\[2mm] + \ifSAP@femaleauthor + \SAP@CandidateLabelFemale\\[2mm] + \else + \SAP@CandidateLabel\\[2mm] + \fi \@author\\[0.75mm] \SAP@IDnumberLabel\ \SAP@IDnumber} @@ -631,6 +646,7 @@ \newcommand{\SAP@english}{% \newcommand{\SAP@CandidateLabel}{Candidate} + \newcommand{\SAP@CandidateLabelFemale}{Candidate} \newcommand{\SAP@IDnumberLabel}{ID number} \newcommand{\SAP@ThesisAdvisorLabel}{Thesis Advisor} \newcommand{\SAP@ThesisAdvisorsLabel}{Thesis Advisors} @@ -660,6 +676,7 @@ \newcommand{\SAP@italian}{% \newcommand{\SAP@CandidateLabel}{Candidato} + \newcommand{\SAP@CandidateLabelFemale}{Candidata} \newcommand{\SAP@IDnumberLabel}{Matricola} \newcommand{\SAP@ThesisAdvisorLabel}{Relatore} \newcommand{\SAP@ThesisAdvisorsLabel}{Relatori} |