summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/bookest
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/bookest
Initial commit
Diffstat (limited to 'macros/latex/contrib/bookest')
-rw-r--r--macros/latex/contrib/bookest/README74
-rw-r--r--macros/latex/contrib/bookest/bookest.cls641
-rw-r--r--macros/latex/contrib/bookest/bookestdoc-en.pdfbin0 -> 140842 bytes
-rw-r--r--macros/latex/contrib/bookest/bookestdoc-en.tex205
-rw-r--r--macros/latex/contrib/bookest/bookestdoc-it.pdfbin0 -> 126864 bytes
-rw-r--r--macros/latex/contrib/bookest/bookestdoc-it.tex208
6 files changed, 1128 insertions, 0 deletions
diff --git a/macros/latex/contrib/bookest/README b/macros/latex/contrib/bookest/README
new file mode 100644
index 0000000000..600cc93f1f
--- /dev/null
+++ b/macros/latex/contrib/bookest/README
@@ -0,0 +1,74 @@
+La classe bookest e' un'estensione della classe standard book, classe alla
+quale si appoggia e che viene caricata con le opzioni di default.
+
+Le estensioni fornite dalla classe riguardano:
+1. colori;
+2. layout del documento;
+3. testatine e pie' di pagina;
+4. layout della copertina;
+5. ...
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+The bookest class in an extension of the standard book class, which it relies
+on and that is loaded with the default options.
+
+The extensions provided by the class involve:
+1. colors;
+2. document layout;
+3. headings and footers;
+4. title page layout;
+5. ...
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+Version 1.1 - 2008/03/20
+# Added "logo-toplcr" and "logo-toplcr-nofooter" options
+# Added "article" option and "\notinarticle" command
+# Added "\art*" aliases for sectioning commands
+# Added "noepigraph" option and "\noepigraph" command
+# Added "nomatter" option and "\nomatter" command
+# "pdfcolmk" is not a required package anymore
+
+Version 1.0.4 - 2007/05/22
+# Added "abstract" environment
+
+Version 1.0.3 - 2007/05/13
+# Unused options are passed to the book class
+
+Version 1.0.2 - 2007/05/12
+# Added "\shipouttext" and "\shipoutimage" commands
+
+Version 1.0.1 - 2007/04/27
+# Added "logo-topc" and "logo-topc-nofooter" options
+
+Version 1.0 - 2007/04/12
+# First public release
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ %% %%
+ %% Package name: bookest %%
+ %% Author: Riccardo Bresciani - bresciani(at)sssup.it %%
+ %% Web: http://tex.boris-web.net/bookest %%
+ %% %%
+ %% Description: This package provides an extension to the %%
+ %% book class %%
+ %% %%
+ %% Copyright 2007-2008 Riccardo Bresciani %%
+ %% %%
+ %% This work may be distributed and/or modified under the %%
+ %% conditions of the LaTeX Project Public License, either %%
+ %% version 1.3c of this license or (at your option) any %%
+ %% later version. %%
+ %% The latest version of the license is in %%
+ %% http://www.latex-project.org/lppl.txt %%
+ %% and version 1.3c or later is part of all distributions of LaTeX %%
+ %% version 2005/12/01 or later. %%
+ %% %%
+ %% This work has the LPPL maintenance status "author-maintained". %%
+ %% %%
+ %% This work consists of the files: README, bookest.cls, %%
+ %% bookestdoc-it.tex, bookestdoc-it.pdf, bookestdoc-en.tex, %%
+ %% bookestdoc-en.pdf %%
+ %% %%
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
diff --git a/macros/latex/contrib/bookest/bookest.cls b/macros/latex/contrib/bookest/bookest.cls
new file mode 100644
index 0000000000..ac97687e16
--- /dev/null
+++ b/macros/latex/contrib/bookest/bookest.cls
@@ -0,0 +1,641 @@
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% %%
+%% Package name: bookest %%
+%% Author: Riccardo Bresciani - bresciani(at)sssup.it %%
+%% Web: http://tex.boris-web.net/bookest %%
+%% %%
+%% Description: This package provides an extension to the %%
+%% book class %%
+%% %%
+%% Copyright 2007-2008 Riccardo Bresciani %%
+%% %%
+%% This work may be distributed and/or modified under the %%
+%% conditions of the LaTeX Project Public License, either %%
+%% version 1.3c of this license or (at your option) any %%
+%% later version. %%
+%% The latest version of the license is in %%
+%% http://www.latex-project.org/lppl.txt %%
+%% and version 1.3c or later is part of all distributions of LaTeX %%
+%% version 2005/12/01 or later. %%
+%% %%
+%% This work has the LPPL maintenance status "author-maintained". %%
+%% %%
+%% This work consists of the files: README, bookest.cls, %%
+%% bookestdoc-it.tex, bookestdoc-it.pdf, bookestdoc-en.tex, %%
+%% bookestdoc-en.pdf %%
+%% %%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesClass{bookest}[2008/03/20 v1.1 Extension for the book class]
+
+\DeclareOption*{\PassOptionsToClass{\CurrentOption}{book}}
+\ProcessOptions
+\LoadClass{book}
+\RequirePackage{color}
+\RequirePackage{setspace}
+\RequirePackage{graphicx}
+\RequirePackage{hyperref}
+\RequirePackage{eso-pic}
+\RequirePackage{geometry}
+\RequirePackage{everyshi}
+
+\makeatletter
+
+%% Filigrana
+\newcommand{\shipoutimage}[2]{\EveryShipout{\AddToShipoutPicture*{\AtPageCenter{\makebox(0,0){\includegraphics[#1]{#2}}}}}}
+
+\newcommand{\shipouttext}[3]{\EveryShipout{\AddToShipoutPicture*{\AtPageCenter{\makebox(0,0){\rotatebox{#1}{\scalebox{#2}{{\color[rgb]{.95,.95,.95}\normalfont\normalsize #3}}}}}}}}
+
+%% Rinomina la bibliografia
+\newcommand{\setbibname}[1]{\def\bibname{#1}}
+\newcommand{\setcontentsname}[1]{\def\contentsname{#1}}
+
+%% Paragrafo
+\newcommand{\ppar}{\vspace{1.5ex}}
+
+%% Ambiente dimst - per dimostrazioni
+\newcommand{\dimstleftskip}{\setlength{\leftskip}{1cm}}
+\newenvironment{dimst}{
+ \dimstleftskip
+ \ppar
+ \slshape
+}
+
+%% Ambiente abstract
+\newenvironment{abstract}[1]{
+\begin{center}
+\begin{minipage}{0.8\textwidth}
+\textbf{#1}\hspace{3ex}}
+{\end{minipage}
+\end{center}
+\vspace{1ex}
+}
+
+%% Colora il righello di footnote
+\renewcommand{\footnoterule}{%
+ {\colorB\kern-3\p@
+ \hrule width .4\columnwidth
+ \kern 2.6\p@}}
+
+%% Layout di pagina
+\if@compatibility\else
+\DeclareOption{oneside}{\@twosidefalse}
+\fi
+\DeclareOption{twoside}{\@twosidetrue}
+\DeclareOption{centered}{
+ \geometry{
+ hmargin=2.5cm,
+ vmargin={3cm,3cm},
+ bindingoffset=0mm,
+ columnsep=20pt
+ }
+}
+\DeclareOption{left5mm}{
+ \geometry{
+ lmargin=2.5cm,
+ rmargin=2cm,
+ vmargin={3cm,3cm},
+ bindingoffset=5mm,
+ columnsep=20pt
+ }
+}
+\DeclareOption{left8mm}{
+ \geometry{
+ lmargin=2.5cm,
+ rmargin=1.7cm,
+ vmargin={3cm,3cm},
+ bindingoffset=8mm,
+ columnsep=20pt
+ }
+}
+
+%% Colori
+\newcommand{\black}{\color{black}}
+\newcommand{\colorA}{}
+\newcommand{\setcolorA}[1]{\renewcommand{\colorA}{\color[rgb]{#1}}}
+\newcommand{\SETcolorA}[1]{\renewcommand{\colorA}{#1}}
+\newcommand{\colorB}{}
+\newcommand{\setcolorB}[1]{\renewcommand{\colorB}{\color[rgb]{#1}}}
+\newcommand{\SETcolorB}[1]{\renewcommand{\colorB}{#1}}
+\DeclareOption{blue}{
+ \renewcommand{\colorA}{\color[rgb]{0.3,0.5,1}}
+ \renewcommand{\colorB}{\color[rgb]{0.2,0.2,0.6}}
+ \hypersetup{linkbordercolor={0.3 0.5 1},citebordercolor={0.2 0.2 0.6},urlbordercolor={0.3 0.5 1}}}
+\DeclareOption{green}{
+ \renewcommand{\colorA}{\color[rgb]{0.2,0.5,0.2}}
+ \renewcommand{\colorB}{\color[rgb]{0,0.3,0}}
+ \hypersetup{linkbordercolor={0.2 0.5 0.2},citebordercolor={0 0.3 0},urlbordercolor={0.2 0.5 0.2}}}
+\DeclareOption{red}{
+ \renewcommand{\colorA}{\color[rgb]{1,0.3,0.2}}
+ \renewcommand{\colorB}{\color[rgb]{1,0.5,0}}
+ \hypersetup{linkbordercolor={1 0.3 0.2},citebordercolor={1 0.5 0},urlbordercolor={1 0.3 0.2}}}
+\DeclareOption{sssupcolor1}{
+ \renewcommand{\colorB}{\color[rgb]{0.7,0.36,0.19}}
+ \renewcommand{\colorA}{\color[rgb]{0.66,0.55,0.51}}
+ \hypersetup{linkbordercolor={0.7 0.36 0.19},citebordercolor={0.66 0.55 0.51},urlbordercolor={0.7 0.36 0.19}}}
+\DeclareOption{sssupcolor2}{
+ \renewcommand{\colorA}{\color[rgb]{0.7,0.36,0.19}}
+ \renewcommand{\colorB}{\color[rgb]{0.66,0.55,0.51}}
+ \hypersetup{linkbordercolor={0.7 0.36 0.19},citebordercolor={0.66 0.55 0.51},urlbordercolor={0.7 0.36 0.19}}}
+\DeclareOption{sssupcolor3}{
+ \renewcommand{\colorA}{\black}
+ \renewcommand{\colorB}{\color[rgb]{0.7,0.36,0.19}}
+ \hypersetup{linkbordercolor={0.7 0.36 0.19},citebordercolor={0.7 0.36 0.19},urlbordercolor={0.7 0.36 0.19}}}
+\DeclareOption{guitgreen}{
+ \renewcommand{\colorA}{\color[rgb]{0.09,0.56,0.07}}
+ \renewcommand{\colorB}{\color[rgb]{0,0.35,0}}
+ \hypersetup{linkbordercolor={0.09 0.56 0.07},citebordercolor={0 0.35 0},urlbordercolor={0.09 0.56 0.07}}}
+\DeclareOption{enscblue}{
+ \renewcommand{\colorA}{\color[rgb]{0,0.52,0.71}}
+ \renewcommand{\colorB}{\color[rgb]{0.05,0.16,0.49}}
+ \hypersetup{linkbordercolor={0 0.52 0.71},citebordercolor={0.05 0.16 0.49},urlbordercolor={0 0.52 0.71}}}
+
+%% Colora gli item dentro itemize, description
+\renewcommand\labelitemi{{\colorA\textbullet}}
+\renewcommand\descriptionlabel[1]{\hspace\labelsep
+ {\colorA\normalfont\bfseries #1}}
+\renewcommand\labelenumi{{\colorA\theenumi.}}
+
+%% Per chi non vuole le liste colorate
+\DeclareOption{noitemcolor}{
+ \renewcommand\labelitemi{\textbullet}
+ \renewcommand\descriptionlabel[1]{\hspace\labelsep\normalfont\bfseries #1}
+ \renewcommand\labelenumi{\theenumi.}
+}
+
+% Titling page
+\newcommand{\inslogo}[1]{\includegraphics[width=0.6\paperwidth]{#1}}
+\newcommand{\setlogooptions}[1]{
+ \renewcommand{\inslogo}{\includegraphics[#1]}}
+\newcommand{\logo}{logo}
+\newcommand{\rightlogo}{\logo}
+\newcommand{\leftlogo}{\logo}
+\newcommand{\setlogo}[1]{
+ \renewcommand{\logo}{#1}}
+\newcommand{\setrightlogo}[1]{
+ \renewcommand{\rightlogo}{#1}}
+\newcommand{\setleftlogo}[1]{
+ \renewcommand{\leftlogo}{#1}}
+\renewcommand{\maketitle}{
+ \begin{center}
+ {\large\@author}\par
+ \vspace{\stretch{1}}
+ {\colorB\Huge\@title}\par
+ \end{center}
+}
+\newcommand{\titlingpagemiddle}{}
+\newcommand{\settitlingpagemiddle}[1]{
+ \renewcommand{\titlingpagemiddle}{#1}}
+\newcommand{\titlingpageprefooter}{}
+\newcommand{\settitlingpageprefooter}[1]{
+ \renewcommand{\titlingpageprefooter}{#1}}
+\newcommand{\titlingpagefooter}{\today}
+\newcommand{\settitlingpagefooter}[1]{
+ \renewcommand{\titlingpagefooter}{#1}}
+\newcommand{\settitlingpagetitle}[1]{
+ \renewcommand{\maketitle}{#1}}
+\newcommand{\titling}{
+ \begin{titlepage}
+ \maketitle
+ \vspace{\stretch{8}}
+ \begin{center}
+ \titlingpageprefooter
+ {\colorB\rule[.5ex]{50ex}{.4pt}}\\
+ \titlingpagefooter
+ \end{center}
+\end{titlepage}}
+
+%% setspace
+\DeclareOption{onehalfspacing}{\onehalfspacing}
+\DeclareOption{doublespacing}{\doublespacing}
+
+%%% Opzioni per i paragrafi
+\DeclareOption{noparindent}{
+ \setlength{\parindent}{0pt}
+}
+\DeclareOption{noparskip}{
+ \setlength{\parskip}{0pt}
+}
+
+%%% Comandi e ambienti per article-like
+\newcommand{\nomatter}{
+ \renewcommand{\frontmatter}{}
+ \renewcommand{\mainmatter}{}
+ \renewcommand{\backmatter}{}
+ }
+\newcommand{\notinarticle}{}
+
+%%% Alias per article-like: non indispensabili, solo per ordine mentale
+\newcommand{\artsection}[1]{\chapter{#1}}
+\newcommand{\artsubsection}[1]{\section{#1}}
+\newcommand{\artsubsubsection}[1]{\subsection{#1}}
+\newcommand{\artparagraph}[1]{\subsubsection{#1}}
+\newcommand{\artsubparagraph}[1]{\paragraph{#1}}
+
+%%% Opzioni per article-like
+\DeclareOption{nomatter}{
+ \nomatter
+}
+\DeclareOption{article}{
+\let\chapter\section
+\let\section\subsection
+\let\subsection\subsubsection
+\let\subsubsection\paragraph
+\let\paragraph\subparagraph
+\makeatletter
+\renewcommand \thesection {\@arabic\c@section}
+\renewcommand{\maketitle}{\thispagestyle{plain}{\centering\LARGE\textbf{\colorB\@title}\Large\\\vspace{1ex}\@author\\\vspace{1ex}\today\\\vspace{3ex}}}
+\makeatother
+\renewcommand{\titling}{
+ \maketitle
+ }
+\let\toctemp\tableofcontents
+\renewcommand{\tableofcontents}{
+ \begin{center}
+ \begin{minipage}{0.9\textwidth}
+ \toctemp
+ \end{minipage}
+ \end{center}
+ \vspace{3ex}
+ }
+\let\include\input
+\setleftmark{\rightmark}
+\renewcommand{\notinarticle}[1]{}
+}
+
+%%% Opzioni per la title page
+\DeclareOption{nofooter}{
+\renewcommand{\titling}{
+ \begin{titlepage}
+ \maketitle
+ \vspace{\stretch{4}}
+ \titlingpagemiddle
+ \vspace{\stretch{4}}
+\end{titlepage}}
+}
+\DeclareOption{logo-bg}{
+\renewcommand{\titling}{
+ \begin{titlepage}
+ \AddToShipoutPicture*{\AtPageCenter{\makebox(0,0){\inslogo{\logo}}}}
+ \maketitle
+ \vspace{\stretch{4}}
+ \titlingpagemiddle
+ \vspace{\stretch{4}}
+ \begin{center}
+ \titlingpageprefooter
+ {\colorB\rule[.5ex]{50ex}{.4pt}}\\
+ \titlingpagefooter
+ \end{center}
+\end{titlepage}}
+}
+\DeclareOption{logo-bg-nofooter}{
+\renewcommand{\titling}{
+ \begin{titlepage}
+ \AddToShipoutPicture*{\AtPageCenter{\makebox(0,0){\inslogo{\logo}}}}
+ \maketitle
+ \vspace{\stretch{4}}
+ \titlingpagemiddle
+ \vspace{\stretch{4}}
+\end{titlepage}}
+}
+\DeclareOption{logo}{
+\renewcommand{\titling}{
+ \begin{titlepage}
+ \maketitle
+ \vspace{\stretch{3}}
+ \begin{center}
+ \inslogo{\logo}
+ \end{center}
+ \vspace{\stretch{3}}
+ \titlingpagemiddle
+ \vspace{\stretch{3}}
+ \begin{center}
+ \titlingpageprefooter
+ {\colorB\rule[.5ex]{50ex}{.4pt}}\\
+ \titlingpagefooter
+ \end{center}
+\end{titlepage}}
+}
+\DeclareOption{logo-nofooter}{
+\renewcommand{\titling}{
+ \begin{titlepage}
+ \maketitle
+ \vspace{\stretch{3}}
+ \begin{center}
+ \inslogo{\logo}
+ \end{center}
+ \vspace{\stretch{1.5}}
+ \titlingpagemiddle
+ \vspace{\stretch{1.5}}
+\end{titlepage}}
+}
+\DeclareOption{logo-topr}{
+\renewcommand{\titling}{
+ \begin{titlepage}
+ \begin{flushright}
+ \setlogooptions{width=0.2\paperwidth}
+ \inslogo{\rightlogo}
+ \end{flushright}
+ \vspace{\stretch{2}}
+ \maketitle
+ \vspace{\stretch{3}}
+ \titlingpagemiddle
+ \vspace{\stretch{3}}
+ \begin{center}
+ \titlingpageprefooter
+ {\colorB\rule[.5ex]{50ex}{.4pt}}\\
+ \titlingpagefooter
+ \end{center}
+\end{titlepage}}
+}
+\DeclareOption{logo-topr-nofooter}{
+\renewcommand{\titling}{
+ \begin{titlepage}
+ \begin{flushright}
+ \setlogooptions{width=0.2\paperwidth}
+ \inslogo{\rightlogo}
+ \end{flushright}
+ \vspace{\stretch{3}}
+ \maketitle
+ \vspace{\stretch{3}}
+ \titlingpagemiddle
+ \vspace{\stretch{3}}
+\end{titlepage}}
+}
+\DeclareOption{logo-topl}{
+\renewcommand{\titling}{
+ \begin{titlepage}
+ \begin{raggedleft}
+ \setlogooptions{width=0.2\paperwidth}
+ \inslogo{\leftlogo}
+ \end{raggedleft}
+ \vspace{\stretch{2}}
+ \maketitle
+ \vspace{\stretch{3}}
+ \titlingpagemiddle
+ \vspace{\stretch{3}}
+ \begin{center}
+ \titlingpageprefooter
+ {\colorB\rule[.5ex]{50ex}{.4pt}}\\
+ \titlingpagefooter
+ \end{center}
+\end{titlepage}}
+}
+\DeclareOption{logo-topl-nofooter}{
+\renewcommand{\titling}{
+ \begin{titlepage}
+ \begin{flushleft}
+ \setlogooptions{width=0.2\paperwidth}
+ \inslogo{\leftlogo}
+ \end{flushleft}
+ \vspace{\stretch{3}}
+ \maketitle
+ \vspace{\stretch{3}}
+ \titlingpagemiddle
+ \vspace{\stretch{3}}
+\end{titlepage}}
+}
+\DeclareOption{logo-toplr}{
+\renewcommand{\titling}{
+ \begin{titlepage}
+ \setlogooptions{width=0.2\paperwidth}
+ \inslogo{\leftlogo}\hfill\inslogo{\rightlogo}
+ \vspace{\stretch{2}}
+ \maketitle
+ \vspace{\stretch{3}}
+ \titlingpagemiddle
+ \vspace{\stretch{3}}
+ \begin{center}
+ \titlingpageprefooter
+ {\colorB\rule[.5ex]{50ex}{.4pt}}\\
+ \titlingpagefooter
+ \end{center}
+\end{titlepage}}
+}
+\DeclareOption{logo-toplr-nofooter}{
+\renewcommand{\titling}{
+ \begin{titlepage}
+ \setlogooptions{width=0.2\paperwidth}
+ \inslogo{\leftlogo}\hfill\inslogo{\rightlogo}
+ \vspace{\stretch{3}}
+ \maketitle
+ \vspace{\stretch{3}}
+ \titlingpagemiddle
+ \vspace{\stretch{3}}
+\end{titlepage}}
+}
+\DeclareOption{logo-topc}{
+\renewcommand{\titling}{
+ \begin{titlepage}
+ \begin{center}
+ \setlogooptions{width=0.2\paperwidth}
+ \inslogo{\logo}
+ \end{center}
+ \vspace{\stretch{2}}
+ \maketitle
+ \vspace{\stretch{3}}
+ \titlingpagemiddle
+ \vspace{\stretch{3}}
+ \begin{center}
+ \titlingpageprefooter
+ {\colorB\rule[.5ex]{50ex}{.4pt}}\\
+ \titlingpagefooter
+ \end{center}
+\end{titlepage}}
+}
+\DeclareOption{logo-topc-nofooter}{
+\renewcommand{\titling}{
+ \begin{titlepage}
+ \begin{center}
+ \setlogooptions{width=0.2\paperwidth}
+ \inslogo{\logo}
+ \end{center}
+ \vspace{\stretch{3}}
+ \maketitle
+ \vspace{\stretch{3}}
+ \titlingpagemiddle
+ \vspace{\stretch{3}}
+\end{titlepage}}
+}
+\DeclareOption{logo-toplcr}{
+\renewcommand{\titling}{
+ \begin{titlepage}
+ \setlogooptions{width=0.1\paperwidth}
+ \inslogo{\leftlogo}\hfill\inslogo{\logo}\hfill\inslogo{\rightlogo}
+ \vspace{\stretch{2}}
+ \maketitle
+ \vspace{\stretch{3}}
+ \titlingpagemiddle
+ \vspace{\stretch{3}}
+ \begin{center}
+ \titlingpageprefooter
+ {\colorB\rule[.5ex]{50ex}{.4pt}}\\
+ \titlingpagefooter
+ \end{center}
+\end{titlepage}}
+}
+\DeclareOption{logo-toplcr-nofooter}{
+\renewcommand{\titling}{
+ \begin{titlepage}
+ \setlogooptions{width=0.1\paperwidth}
+ \inslogo{\leftlogo}\hfill\inslogo{\logo}\hfill\inslogo{\rightlogo}
+ \vspace{\stretch{3}}
+ \maketitle
+ \vspace{\stretch{3}}
+ \titlingpagemiddle
+ \vspace{\stretch{3}}
+\end{titlepage}}
+}
+
+%% Colori di sezioni, sottosezioni, etc.
+\newcommand{\sectionfont}{\normalfont\colorA\Large\bfseries}
+\newcommand{\setsectionfont}[1]{
+ \renewcommand{\sectionfont}{#1}}
+\renewcommand\section{\@startsection {section}{1}{\z@}%
+ {-3.5ex \@plus -1ex \@minus -.2ex}%
+ {2.3ex \@plus.2ex}%
+ {\sectionfont}}
+\newcommand{\subsectionfont}{\normalfont\colorA\large\bfseries}
+\newcommand{\setsubsectionfont}[1]{
+ \renewcommand{\subsectionfont}{#1}}
+\renewcommand\subsection{\@startsection{subsection}{2}{\z@}%
+ {-3.25ex\@plus -1ex \@minus -.2ex}%
+ {1.5ex \@plus .2ex}%
+ {\subsectionfont}}
+\newcommand{\subsubsectionfont}{\normalfont\colorA\normalsize\bfseries}
+\newcommand{\setsubsubsectionfont}[1]{
+ \renewcommand{\subsubsectionfont}{#1}}
+\renewcommand\subsubsection{\@startsection{subsubsection}{3}{\z@}%
+ {-3.25ex\@plus -1ex \@minus -.2ex}%
+ {1.5ex \@plus .2ex}%
+ {\subsubsectionfont}}
+\newcommand{\paragraphfont}{\normalfont\colorA\normalsize\bfseries}
+\newcommand{\setparagraphfont}[1]{
+ \renewcommand{\paragraphfont}{#1}}
+\renewcommand\paragraph{\@startsection{paragraph}{4}{\z@}%
+ {3.25ex \@plus1ex \@minus.2ex}%
+ {-1em}%
+ {\paragraphfont}}
+\newcommand{\subparagraphfont}{\normalfont\colorA\normalsize\bfseries}
+\newcommand{\setsubparagraphfont}[1]{
+ \renewcommand{\subparagraphfont}{#1}}
+\renewcommand\subparagraph{\@startsection{subparagraph}{5}{\parindent}%
+ {3.25ex \@plus1ex \@minus .2ex}%
+ {-1em}%
+ {\subparagraphfont}}
+
+%% Capitoli e parti
+\def\@makechapterhead#1{%
+ \vspace*{20\p@}
+ {\parindent \z@ \raggedright \normalfont
+ \ifnum \c@secnumdepth >\m@ne
+ \if@mainmatter
+ {\colorA\huge\scshape \@chapapp\space \thechapter}
+ \par\nobreak
+ \vskip 10\p@
+ \fi
+ \fi
+ \interlinepenalty\@M
+ {\colorB\hrule}
+ \vskip 15\p@
+ \begin{flushright}
+ {\colorA\Huge \bfseries #1}\par\nobreak
+ \end{flushright}
+ \vskip 5\p@
+ {\colorB\hrule}
+ \vskip 30\p@
+ }}
+\def\@makeschapterhead#1{%
+ \vspace*{20\p@}
+ {\parindent \z@ \raggedright \normalfont
+ {\colorB\hrule}
+ \vskip 15\p@
+ \begin{center}
+ {\colorA\Huge \bfseries #1}\par\nobreak
+ \end{center}
+ \vskip 5\p@
+ {\colorB\hrule}
+ \vskip 30\p@
+ }}
+\def\@part[#1]#2{%
+ \ifnum \c@secnumdepth >-2\relax
+ \refstepcounter{part}%
+ \addcontentsline{toc}{part}{\thepart\hspace{1em}#1}%
+ \else
+ \addcontentsline{toc}{part}{#1}%
+ \fi
+ \markboth{}{}%
+ {\centering
+ \interlinepenalty \@M
+ \normalfont
+ \ifnum \c@secnumdepth >-2\relax
+ \colorA\huge\bfseries \partname\nobreakspace\thepart
+ \par
+ \vskip 20\p@
+ \fi
+ \Huge \bfseries #2\par}%
+ \@endpart}
+\def\@spart#1{%
+ {\centering
+ \interlinepenalty \@M
+ \normalfont
+ \colorA\Huge \bfseries #1\par}%
+ \@endpart}
+
+%Page headings
+\newcommand{\setevenhead}[1]{\def\@evenhead{#1}}
+\newcommand{\setoddhead}[1]{\def\@oddhead{#1}}
+\newcommand{\setevenfoot}[1]{\def\@evenfoot{#1}}
+\newcommand{\setoddfoot}[1]{\def\@oddfoot{#1}}
+\newcommand{\oddheadtext}{{\colorA{\slshape\rightmark}\hfill\thepage}}
+\newcommand{\setoddheadtext}[1]{\renewcommand{\oddheadtext}{#1}}
+\newcommand{\evenheadtext}{\oddheadtext}
+\newcommand{\setevenheadtext}[1]{\renewcommand{\evenheadtext}{#1}}
+\newcommand{\evenfoottext}{}
+\newcommand{\setevenfoottext}[1]{\renewcommand{\evenfoottext}{#1}}
+\newcommand{\oddfoottext}{}
+\newcommand{\setoddfoottext}[1]{\renewcommand{\oddfoottext}{#1}}
+\newcommand{\setleftmark}[1]{\renewcommand{\leftmark}{#1}}
+\newcommand{\setrightmark}[1]{\renewcommand{\rightmark}{#1}}
+\newcommand{\makeheadrule}{{\colorB\hrule\@width\textwidth \@height 0.4pt \vskip-0.4pt}}
+\newcommand{\makefootrule}{\makeheadrule}
+\if@twoside
+ \setevenheadtext{{\colorA\thepage\hfill\slshape\leftmark}}
+\fi
+\setevenhead{\vbox{\evenheadtext \vskip 5\p@ \makeheadrule}}
+\setoddhead{\vbox{\oddheadtext \vskip 5\p@ \makeheadrule}}
+
+%% MakeUppercase fa si' che tutte le intestazioni predefinite siano in maiuscolo:
+%% il comando viene ridefinito come comando vuoto, ma per chi dovesse aver bisogno
+%% di MakeUppercase viene definito \UCase
+\let\UCase\MakeUppercase
+\renewcommand{\MakeUppercase}{}
+
+% Ridefinizione del pagestyle plain per colorare il numero di pagina
+\def\ps@plain{%
+ \def\@oddfoot{{\hfil\colorA\thepage\hfil}}
+ \def\@evenfoot{{\hfil\colorA\thepage\hfil}}
+ \let\@oddhead\@empty
+ \let\@evenhead\@empty
+}
+
+% Epigrafi
+\newcommand{\epigraph}[4]{
+\begin{#3}
+ \begin{minipage}{#4}
+ #1\\
+ {\colorB\rule[.5ex]{#4}{.4pt}}\\
+ #2
+ \end{minipage}
+\end{#3}
+}
+
+\makeatother
+% Rimozione epigrafi (utile per fare diverse versioni di un documento)
+\newcommand{\noepigraph}{\renewcommand{\epigraph}[4]{}}
+\DeclareOption{noepigraph}{
+ \noepigraph
+}
+
+\ProcessOptions \ No newline at end of file
diff --git a/macros/latex/contrib/bookest/bookestdoc-en.pdf b/macros/latex/contrib/bookest/bookestdoc-en.pdf
new file mode 100644
index 0000000000..3c892d93ae
--- /dev/null
+++ b/macros/latex/contrib/bookest/bookestdoc-en.pdf
Binary files differ
diff --git a/macros/latex/contrib/bookest/bookestdoc-en.tex b/macros/latex/contrib/bookest/bookestdoc-en.tex
new file mode 100644
index 0000000000..934ca14e76
--- /dev/null
+++ b/macros/latex/contrib/bookest/bookestdoc-en.tex
@@ -0,0 +1,205 @@
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%% THIS DOCUMENT IS OUT OF DATE, NEWEST FEATURES DOCUMENTED ONLY IN THE ITALIAN VERSION OF THIS DOCUMENT %%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\documentclass[a4paper,oneside,centered,noparindent,noparskip]{bookest}
+
+\usepackage[utf8x]{inputenc}
+%\usepackage[italian]{babel}
+\usepackage{palatino}
+\usepackage{guit}
+
+\hyphenation{Su-pe-rio-re}
+
+\hypersetup{
+pdftitle={The bookest class},
+pdfsubject={An extension for the book class},
+pdfauthor={Riccardo Bresciani},
+pdfkeywords={TeX, LaTeX, pdfLaTeX, book, bookest},
+pdfstartview=FitV,
+%colorlinks
+}
+
+\setoddheadtext{{\colorA The \texttt{bookest} class --- Version 1.0.4\hfill Riccardo Bresciani}}
+\setoddfoot{\hfill{\colorA\thepage}\hfill}
+
+\makeatletter
+\renewcommand \thesection{\@arabic\c@section.}
+\renewcommand\thesubsection{\thesection\@arabic\c@subsection}
+\makeatother
+
+\newcommand{\tA}[1]{\texttt{\colorA #1}}
+
+\shipouttext{60}{15}{\fbox{\itshape \ttfamily out of date}}
+
+\begin{document}
+
+\chapter*{The \texttt{bookest} class\\{\Large Version 1.0.4 --- May 22, 2007}\\{\Large Riccardo Bresciani}}
+
+\textit{\sffamily
+\begin{abstract}{\today: WARNING}
+This document is out of date, the newest features are documented only in the Italian version of this document.
+\end{abstract}
+\vspace{7ex}}
+
+The \texttt{bookest} class in an extension of the standard \texttt{book} class, on which it relies and that is loaded with the default options.
+
+\ppar
+The extensions provided by the class involve:
+\begin{enumerate}
+ \item colors;
+ \item document layout;
+ \item headings and footers;
+ \item title page layout;
+ \item \dots
+\end{enumerate}
+
+The \texttt{bookest} web page is \url{http://tex.boris-web.net/bookest}.
+
+\section{Colors}
+\texttt{bookest} requires the \texttt{color} and the \texttt{pdfcolmk}\footnote{This package, reported by Massimiliano Dominici (\GuIT), allows to bypass some of the limitations that pdf\TeX\ has up to version 1.30, mainly the unsupported \emph{colorstack}. Currently the package is loaded by default, but as soon as the main ditributions (MiK\TeX, te\TeX, \dots) will have pdf\TeX\ versione 1.40 this package will be removed from the class.} packages to provide color support to the document.
+
+\ppar
+Specifically, colors \texttt{A} and \texttt{B} are defined: they will be used in the definition of the sectioning commands and in coloring of some text elements --- e.g. the \texttt{footnote} rules or the list labels in \texttt{itemize}, \texttt{enumerate} e \texttt{description}.
+
+\ppar
+The default document is black and white, the user can anyway define the colors according to his taste by using the commands listed in \ref{coloricomandi}.
+
+\ppar
+\texttt{bookest} provides some preset color combinations that can be activated with the corresponding class options listed in \ref{coloriopzioni}. For these options to be used the \texttt{hyperref} package is required, as link and anchor colors (color \texttt{A}) and citation color (color \texttt{B}) are set.
+
+\subsection{Commands}\label{coloricomandi}
+\begin{description}
+ \item[\texttt{\textbackslash colorA}, \texttt{\textbackslash colorB}, \texttt{\textbackslash black}] declare the colors used by the class (\texttt{A} and \texttt{B} empty by default and user-definable, plus black);
+ \item[\texttt{\textbackslash setcolorA\{\textit{<R> <G> <B>}\}}, \texttt{\textbackslash setcolorB\{\textit{<R> <G> <B>}\}}] specify color \texttt{A} and \texttt{B} in RGB format;
+ \item[\texttt{\textbackslash SETcolorA\{\textit{<command>}\}}, \texttt{\textbackslash SETcolorB\{\textit{<command>}\}}] redefine the commands \texttt{\textbackslash colorA} and \texttt{\textbackslash colorB} in \texttt{\textit{<command>}};
+\end{description}
+
+\subsection{Options}\label{coloriopzioni}
+\begin{description}
+ \item[\texttt{noitemcolor}] cancels the list coloration in \texttt{itemize}, \texttt{enumerate} and \texttt{description};
+\end{description}
+\ppar
+\begin{description}
+ \item[\texttt{blue}, \texttt{green}, \texttt{red}] are generic color themes;
+ \item[\texttt{guitgreen}] is a color theme using the colors of the Gruppo Utilizzatori Italiani di \TeX\ (\GuIT).
+ \item[\texttt{sssupcolor1}, \texttt{sssupcolor2}, \texttt{sssupcolor3}] are color themes using the colors of the Scuola Superiore Sant'Anna logo;
+ \item[\texttt{enscblue}] is a color theme using the colors of the École Normale Supérieure de Cachan logo.
+\end{description}
+
+\section{Document layout}
+\texttt{bookest} provides options to control:
+\begin{itemize}
+ \item doubleside (inherets that ones of \texttt{book});
+ \item margins;
+ \item line spacing;
+ \item paragraph indentation and spacing.
+\end{itemize}
+
+Moreover, \texttt{bookest} provides two commands to insert an image or a text as shipout picture.
+
+\subsection{Options}
+\begin{description}
+ \item[\texttt{oneside}, \texttt{twoside}] toggles duplex options (default: \texttt{twoside});
+\end{description}
+\ppar
+\begin{description}
+ \item[\texttt{centered}] sets page margins (2.5 cm horizontal, 3 cm above and below) --- requires the \texttt{geometry} package;
+ \item[\texttt{left5mm}] sets page margins allowing 5 mm for binding (3 cm left, 2 cm right and 3 cm above and below) requires the \texttt{geometry} package;
+ \item[\texttt{left8mm}] sets page margins allowing 8 mm for binding (3.3 cm left, 1.7 cm right and 3 cm above and below) --- requires the \texttt{geometry} package;
+\end{description}
+\ppar
+\begin{description}
+ \item[\texttt{onehalfspacing}] line spacing to 1.5 --- requires the \texttt{setspace} package;
+ \item[\texttt{doublespacing}] line spacing to 2 --- requires the \texttt{setspace} package;
+\end{description}
+\ppar
+\begin{description}
+ \item[\texttt{noparindent}] sets paragraph indentation to 0;
+ \item[\texttt{noparskip}] sets paragraph spacing to 0.
+\end{description}
+
+\subsection{Commands}
+\begin{description}
+ \item [\texttt{\textbackslash shipouttext\{\textit{<rot>}\}\{\textit{<sc>}\}\{\textit{<text>}\}}] puts in every page the text \texttt{\textit{<text>}} as shipout picture, rotating it counterclockwise by \texttt{\textit{<rot>}} degrees and applying a scale factor \texttt{\textit{<sc>}}. The default color is gray 5\% --- requires the \texttt{setspace} package --- requires the \texttt{everyshi} and \texttt{color} packages;
+ \item [\texttt{\textbackslash shipoutimage\{\textit{<options>}\}\{\textit{<file>}\}}] puts in everypage the image \texttt{\textit{<file>}} as shipout picture, using \texttt{\textit{<options>}} as \texttt{\textbackslash includegraphics} options --- requires the \texttt{everyshi} and \texttt{graphicx} packages.
+\end{description}
+
+\section{Headings and footers}
+\texttt{bookest} provides commands to allow the user to set easily headings and footers. Moreover it provides a default setting that is different from \texttt{book}\footnote{To use the default \texttt{book} styles one has to simply use the command \texttt{\textbackslash pagestyle\{\textit{<style>}\}}.}.
+
+\ppar
+It also redefines chapter headings and the \texttt{plain} style to include colors.
+
+\subsection{Commands}
+\begin{description}
+ \item[\texttt{\textbackslash setoddhead}, \texttt{\textbackslash setevenhead}] define odd and even page headings;
+ \item[\texttt{\textbackslash oddheadtext}] is the text to be used in odd page headings (default: \texttt{\{\textbackslash colorA\{ \textbackslash slshape\textbackslash rightmark\}\textbackslash hfill\textbackslash thepage\}});
+ \item[\texttt{\textbackslash evenheadtext}] is the text to be used in even page headings (default in the \texttt{oneside} case: \texttt{\textbackslash oddheadtext}; in the \texttt{twoside} case: \texttt{\{\textbackslash colorA\textbackslash thepage\textbackslash hfill\textbackslash slshape\textbackslash leftmark\}});
+ \item[\texttt{\textbackslash setoddheadtext}, \texttt{\textbackslash setevenheadtext}] set the text in \texttt{\textbackslash oddheadtext} e \texttt{\textbackslash evenheadtext};
+ \item[\texttt{\textbackslash setoddfoot}, \texttt{\textbackslash setevenfoot}] define odd and even page footers;
+ \item[\texttt{\textbackslash oddfoottext}, \texttt{\textbackslash evenfoottext}] is the text to be used in odd and even page headings (default: (default: empty);
+ \item[\texttt{\textbackslash setoddfoottext}, \texttt{\textbackslash setevenfoottext}] set the text in \texttt{\textbackslash oddfoottext} e \texttt{\textbackslash evenfoottext};
+ \item[\texttt{\textbackslash setleftmark}, \texttt{\textbackslash setrightmark}] sets the text in \texttt{\textbackslash leftmark} e \texttt{\textbackslash rightmark};
+ \item[\texttt{\textbackslash makeheadrule}] defines the horizontal rule in headings (default: \texttt{\{\textbackslash colorB\textbackslash hrule \textbackslash @width \textbackslash textwidth \textbackslash @height 0.4pt \textbackslash vskip-0.4pt\}});
+ \item[\texttt{\textbackslash makefootrule}] defines the horizontal rule in headings (default: \texttt{\textbackslash makeheadrule});
+\end{description}
+
+\section{Title page layout}
+\texttt{bookest} provides commands to allow the user to customize easily the title page of his document, especially starting from preset layouts that can be activated by the options in \ref{copertinaopzioni}.
+
+\ppar
+The default layout has author and title centered at top of the page and to the bottom of the page is a footer made by the content of \texttt{\textbackslash titlingpageprefooter} and of \texttt{\textbackslash titlingpagefooter} divided by a horizontal line. Between title and footer is the content of \texttt{\textbackslash titlingpagemiddle}.
+
+The different options allow to vary the logo position; for each option \texttt{\textit{<optlogo>}} in \ref{copertinaopzioni} there exists a variant \texttt{\textit{<optlogo>}-nofooter} where no footer is present.
+
+\subsection{Commands}
+\begin{description}
+ \item[\texttt{\textbackslash inslogo\{\textit{<file>}\}}] inserts the image \texttt{\textit{<file>}} with \texttt{\textbackslash includegraphics} options previously defined and used for the logo (default: \texttt{width=0.6\textbackslash paperwidth});
+ \item[\texttt{\textbackslash setlogooptions\{\textit{<options>}\}}] defines \texttt{\textit{<options>}} as the \texttt{\textbackslash includegraphics} options to be used by \texttt{\textbackslash inslogo};
+ \item[\texttt{\textbackslash logo}, \texttt{\textbackslash leftlogo}, \texttt{\textbackslash rightlogo}] are the path (relative or absolute) of the image to be used as logo depending on the chosen options (default for \texttt{\textbackslash logo} is the relative path \texttt{logo}, default for the others is \texttt{\textbackslash logo});
+ \item[\texttt{\textbackslash setlogo\{\textit{<path>}\}}, \texttt{\textbackslash setleftlogo\{\textit{<path>}\}}, \texttt{\textbackslash setrightlogo\{\textit{<path>}\}}] set to \texttt{\textit{<path>}} the content of \texttt{\textbackslash logo}, \texttt{\textbackslash leftlogo}, \texttt{\textbackslash rightlogo};
+ \item[\texttt{\textbackslash titlingpagemiddle}] is the text to be put in the middle of the \emph{titling page};
+ \item[\texttt{\textbackslash settitlingpagemiddle}] sets the text in \texttt{\textbackslash titlingpagemiddle};
+ \item[\texttt{\textbackslash titlingpageprefooter}] is the text to be put before the footer in the \emph{titling page};
+ \item[\texttt{\textbackslash settitlingpageprefooter}] sets the text in \texttt{\textbackslash titlingpageprefooter};
+ \item[\texttt{\textbackslash titlingpagefooter}] is the text to be used as footer in the \emph{titling page} (default: \texttt{\textbackslash today});
+ \item[\texttt{\textbackslash settitlingpagefooter}] sets the text in \texttt{\textbackslash titlingpagefooter};
+ \item[\texttt{\textbackslash settitlingpagetitle}] defines the format of the title in the \emph{titling page};
+ \item[\texttt{\textbackslash titling}] inserts the \emph{titling page}.
+\end{description}
+
+\subsection{Options}\label{copertinaopzioni}
+\begin{description}
+ \item[\texttt{nofooter}] variant without footer of the default layout;
+ \item[\texttt{logo}, \texttt{logo-nofooter}] adds to the default layout the logo in \texttt{\textbackslash logo} under the title (and matching \texttt{nofooter} variant) --- requires the \texttt{graphicx} package;
+ \item[\texttt{logo-bg}, \texttt{logo-bg-nofooter}] adds to the default layout the logo in \texttt{\textbackslash logo} in the background (and matching \texttt{nofooter} variant) --- requires the \texttt{graphicx} and the \texttt{eso-pic} packages;
+ \item[\texttt{logo-topl}, \texttt{logo-topl-nofooter}] adds to the default layout the logo in \texttt{\textbackslash leftlogo} at top left of the page before the title (and matching \texttt{nofooter} variant) --- requires the \texttt{graphicx} package;
+ \item[\texttt{logo-topc}, \texttt{logo-topc-nofooter}] adds to the default layout the logo in \texttt{\textbackslash logo} at top center of the page before the title (and matching \texttt{nofooter} variant) --- requires the \texttt{graphicx} package;
+ \item[\texttt{logo-topr}, \texttt{logo-topr-nofooter}] adds to the default layout the logo in \texttt{\textbackslash rightlogo} at top left of the page before the title (and matching \texttt{nofooter} variant) --- requires the \texttt{graphicx} package;
+ \item[\texttt{logo-toplr}, \texttt{logo-toplr-nofooter}] adds to the default layout the logo in \texttt{\textbackslash leftlogo} at top left of the page and \texttt{\textbackslash rightlogo} at top right of the page before the title (and matching \texttt{nofooter} variant) --- requires the \texttt{graphicx} package;
+\end{description}
+
+\section{Miscellanea}
+\texttt{bookest} provides also other little shortcuts, which can be useful when using the class and that are hereby listed:
+
+\subsection{Commands}
+\begin{description}
+ \item[\texttt{\textbackslash setbibname\{\textit{<name>}\}}] renames the bibliography title to \texttt{\textit{<name>}};
+ \item[\texttt{\textbackslash setcontentsname\{\textit{<name>}\}}] renames the contents title to \texttt{\textit{<name>}};
+ \item[\texttt{\textbackslash ppar}] inserts a vertical space of \texttt{1.5ex} --- useful for example with the \texttt{noparskip} option;
+ \item[\texttt{\textbackslash dimstleftskip}] sets \texttt{\textbackslash leftskip} to \texttt{1cm};
+ \item[\texttt{\textbackslash UCase}] provides the command \texttt{\textbackslash MakeUppercase}, that is instead redefined as a null command to make heading and footer commands more flexible;
+ \item[\texttt{\textbackslash epigraph\{\textit{<text1>}\}\{\textit{<text2>}\}\{\textit{<environment>}\}\{\textit{<l>}\}}] makes an epigraph, where \texttt{\textit{<text1>}} is divided from \texttt{\textit{<text2>}} by a horizontal line of color \texttt{B}. The epigraph has length \texttt{\textit{<l>}} and is contained in the environment \texttt{\textit{<environment>}}.
+\end{description}
+
+\subsection{Environments}
+\begin{description}
+ \item[\texttt{abstract}] is an environment of width \texttt{0.9\textbackslash textwidth}, with a parameter \texttt{\textit{<title>}} to be written in bold series before the text contained in the environment;
+ \item[\texttt{dimst}] is an environment where the text is in \texttt{slshape} and with 1 cm extra for the left margin.
+\end{description}
+
+\section{Contacts}
+For comments, suggestions or bug reports, you can contact me at the address \href{mailto:bresciani@sssup.it}{\textit{bresciani@sssup.it}}.
+
+\end{document}
diff --git a/macros/latex/contrib/bookest/bookestdoc-it.pdf b/macros/latex/contrib/bookest/bookestdoc-it.pdf
new file mode 100644
index 0000000000..0194588734
--- /dev/null
+++ b/macros/latex/contrib/bookest/bookestdoc-it.pdf
Binary files differ
diff --git a/macros/latex/contrib/bookest/bookestdoc-it.tex b/macros/latex/contrib/bookest/bookestdoc-it.tex
new file mode 100644
index 0000000000..b2c48170e8
--- /dev/null
+++ b/macros/latex/contrib/bookest/bookestdoc-it.tex
@@ -0,0 +1,208 @@
+\documentclass[a4paper,oneside,centered,noparindent,noparskip]{bookest}
+
+\usepackage[utf8x]{inputenc}
+\usepackage[italian]{babel}
+\usepackage{palatino}
+\usepackage{guit}
+
+\hypersetup{
+pdftitle={The bookest class},
+pdfsubject={Un'estensione per la classe book},
+pdfauthor={Riccardo Bresciani},
+pdfkeywords={TeX, LaTeX, pdfLaTeX, book, bookest},
+pdfstartview=FitV,
+%colorlinks
+}
+
+\setoddheadtext{{\colorA The \texttt{bookest} class --- Versione 1.0.4\hfill Riccardo Bresciani}}
+\setoddfoot{\hfill{\colorA\thepage}\hfill}
+
+\makeatletter
+\renewcommand \thesection{\@arabic\c@section.}
+\renewcommand\thesubsection{\thesection\@arabic\c@subsection}
+\makeatother
+
+\newcommand{\tA}[1]{\texttt{\colorA #1}}
+
+\begin{document}
+ \chapter*{The \texttt{bookest} class\\{\Large Versione 1.1 --- \today}\\{\Large Riccardo Bresciani}}
+La classe \texttt{bookest} è un'estensione della classe standard \texttt{book}, classe alla quale si appoggia e che viene caricata con le opzioni di default.
+
+\ppar
+Le estensioni fornite dalla classe riguardano:
+\begin{enumerate}
+ \item colori;
+ \item layout del documento;
+ \item testatine e pie' di pagina;
+ \item layout della copertina;
+ \item \dots
+\end{enumerate}
+
+La pagina web di \texttt{bookest} è \url{http://tex.boris-web.net/bookest}.
+
+\section{Colori}
+\texttt{bookest} richiede il pacchetto \texttt{color} per fornire il supporto del colore al documento\footnote{Per l'uso con pdf\TeX\ fino alla versione 1.30, l'uso del pacchetto \texttt{pdfcolmk} --- segnalato da Massimiliano Dominici (\GuIT) --- permette di ovviare al mancato supporto di \emph{colorstack} da parte delle versioni più vecchie di pdf\TeX.}.
+
+\ppar
+Vengono definiti in particolare i colori \texttt{A} e \texttt{B}, che vengono utilizzati nella definizione dei comandi di sezionamento e nella colorazione di alcuni elementi del testo --- per esempio i righelli di \texttt{footnote} o le \emph{label} degli elenchi \texttt{itemize}, \texttt{enumerate} e \texttt{description}.
+
+\ppar
+Di default il documento è in bianco e nero, l'utente può però definire i colori a proprio piacimento utilizzando i comandi elencati di seguito in \ref{coloricomandi}.
+
+\ppar
+\texttt{bookest} fornisce delle combinazioni predefinite di colori, attivabili con le relative opzioni della classe elencate in \ref{coloriopzioni}. L'utilizzo di queste opzioni richiede il pacchetto \texttt{hyperref} dal momento che vengono settati i colori per i link ed i riferimenti (colore \texttt{A}) e per le citazioni (colore \texttt{B}).
+
+\subsection{Comandi}\label{coloricomandi}
+\begin{description}
+ \item[\texttt{\textbackslash colorA}, \texttt{\textbackslash colorB}, \texttt{\textbackslash black}] dichiarano i colori utilizzati dalla classe (\texttt{A} e \texttt{B} vuoti di default e definibili dall'utente, più il nero);
+ \item[\texttt{\textbackslash setcolorA\{\textit{<R> <G> <B>}\}}, \texttt{\textbackslash setcolorB\{\textit{<R> <G> <B>}\}}] specificano i colori \texttt{A} e \texttt{B} in formato RGB;
+ \item[\texttt{\textbackslash SETcolorA\{\textit{<comando>}\}}, \texttt{\textbackslash SETcolorB\{\textit{<comando>}\}}] ridefiniscono i comandi \texttt{\textbackslash colorA} e \texttt{\textbackslash colorB} in \texttt{\textit{<comando>}};
+\end{description}
+
+\subsection{Opzioni}\label{coloriopzioni}
+\begin{description}
+ \item[\texttt{noitemcolor}] annulla la colorazione degli elenchi \texttt{itemize}, \texttt{enumerate} e \texttt{description};
+\end{description}
+\ppar
+\begin{description}
+ \item[\texttt{blue}, \texttt{green}, \texttt{red}] sono temi di colore generici;
+ \item[\texttt{guitgreen}] è un tema di colore che riprende i colori del Gruppo Utilizzatori Italiani di \TeX\ (\GuIT).
+ \item[\texttt{sssupcolor1}, \texttt{sssupcolor2}, \texttt{sssupcolor3}] sono temi di colore che riprendono i colori del logo della Scuola Superiore Sant'Anna;
+ \item[\texttt{enscblue}] è un tema di colore che riprende il colore del logo dell'École Normale Supérieure di Cachan.
+\end{description}
+
+\section{Layout del documento}
+\texttt{bookest} fornisce opzioni per controllare:
+\begin{itemize}
+ \item il fronte-retro (eredita quelle di \texttt{book});
+ \item i margini;
+ \item l'interlinea;
+ \item l'indentazione nei paragrafi e la loro spaziatura reciproca;
+ \item la creazione di diverse versioni del documento (libro o articolo).
+\end{itemize}
+
+\texttt{bookest} fornisce inoltre due comandi per inserire un'immagine o una scritta nel documento come filigrana.
+
+\subsection{Opzioni}
+\begin{description}
+ \item[\texttt{oneside}, \texttt{twoside}] abilita o disabilita il fronte-retro (default: \texttt{twoside});
+\end{description}
+\ppar
+\begin{description}
+ \item[\texttt{centered}] imposta i margini della pagina (2.5 cm ai lati, 3 cm sopra e sotto) --- richiede il pacchetto \texttt{geometry};
+ \item[\texttt{left5mm}] imposta i margini della pagina considerando 5 mm per la rilegatura (3 cm a sinistra, 2 cm a destra e 3 cm sopra e sotto) --- richiede il pacchetto \texttt{geometry};
+ \item[\texttt{left8mm}] imposta i margini della pagina considerando 8 mm per la rilegatura (3.3 cm a sinistra, 1.7 cm a destra e 3 cm sopra e sotto) --- richiede il pacchetto \texttt{geometry};
+\end{description}
+\ppar
+\begin{description}
+ \item[\texttt{onehalfspacing}] imposta l'interlinea a 1.5 --- richiede il pacchetto \texttt{setspace};
+ \item[\texttt{doublespacing}] imposta l'interlinea a 2 --- richiede il pacchetto \texttt{setspace};
+\end{description}
+\ppar
+\begin{description}
+ \item[\texttt{noparindent}] annulla l'indentazione dei paragrafi;
+ \item[\texttt{noparskip}] annulla lo spazio verticale tra i paragrafi.
+\end{description}
+\ppar
+\begin{description}
+ \item[\texttt{article}] crea un output ``article-like'';
+ \item[\texttt{nomatter}] annulla le distinzioni tra \textit{front matter}, \textit{main matter} e \textit{back matter}.
+\end{description}
+
+\subsection{Comandi}
+\begin{description}
+ \item [\texttt{\textbackslash shipouttext\{\textit{<rot>}\}\{\textit{<sc>}\}\{\textit{<testo>}\}}] inserisce in ogni pagina il testo \texttt{\textit{<testo>}} come filigrana, ruotandolo di \texttt{\textit{<rot>}} gradi in senso antiorario e applicando un fattore di scala \texttt{\textit{<sc>}}. Il colore di default è grigio al 5\% --- richiede i pacchetti \texttt{everyshi} e \texttt{color};
+ \item [\texttt{\textbackslash shipoutimage\{\textit{<opzioni>}\}\{\textit{<file>}\}}] inserisce in ogni pagina l'immagine \texttt{\textit{<file>}} come filigrana, utilizzando \texttt{\textit{<opzioni>}} come opzioni \texttt{\textbackslash includegraphics} --- richiede i pacchetti \texttt{everyshi} e \texttt{color}.
+\end{description}
+
+\ppar
+\begin{description}
+ \item [\texttt{\textbackslash notinarticle\{\textit{<codice>}\}}] il codice \LaTeX\ \texttt{\textit{<codice>}} non compare nel documento compilato con l'opzione \texttt{article}.
+ \item [\texttt{\textbackslash nomatter}] annulla le distinzioni tra \textit{front matter}, \textit{main matter} e \textit{back matter}.
+\end{description}
+
+\section{Testatine e pie' di pagina}
+\texttt{bookest} fornisce dei comandi per permettere all'utente di impostare agevolmente testatine e pie' di pagina, nonché un'impostazione predefinita diversa da quella di \texttt{book}\footnote{Per utilizzare gli stili predefiniti di \texttt{book} è sufficiente utilizzare il comando \texttt{\textbackslash pagestyle\{\textit{<stile>}\}}.}.
+
+\ppar
+Ridefinisce inoltre l'intestazione dei capitoli e lo stile \texttt{plain} per integrarvi i colori.
+
+\subsection{Comandi}
+\begin{description}
+ \item[\texttt{\textbackslash setoddhead}, \texttt{\textbackslash setevenhead}] definiscono le testatine delle pagine dispari e pari;
+ \item[\texttt{\textbackslash oddheadtext}] è il testo che verrà utilizzato nelle testatine delle pagine dispari (default: \texttt{\{\textbackslash colorA\{ \textbackslash slshape\textbackslash rightmark\}\textbackslash hfill\textbackslash thepage\}});
+ \item[\texttt{\textbackslash evenheadtext}] è il testo che verrà utilizzato nelle testatine delle pagine pari (default nel caso \texttt{oneside}: \texttt{\textbackslash oddheadtext}; nel caso \texttt{twoside}: \texttt{\{\textbackslash colorA\textbackslash thepage\textbackslash hfill\textbackslash slshape\textbackslash leftmark\}});
+ \item[\texttt{\textbackslash setoddheadtext}, \texttt{\textbackslash setevenheadtext}] settano il testo in \texttt{\textbackslash oddheadtext} e \texttt{\textbackslash evenheadtext};
+ \item[\texttt{\textbackslash setoddfoot}, \texttt{\textbackslash setevenfoot}] definiscono i pie' di pagina delle pagine dispari e pari;
+ \item[\texttt{\textbackslash oddfoottext}, \texttt{\textbackslash evenfoottext}] sono i testi che verranno utilizzati nei pie' di pagina dispari e pari (default: vuoto);
+ \item[\texttt{\textbackslash setoddfoottext}, \texttt{\textbackslash setevenfoottext}] settano il testo in \texttt{\textbackslash oddfoottext} e \texttt{\textbackslash evenfoottext};
+ \item[\texttt{\textbackslash setleftmark}, \texttt{\textbackslash setrightmark}] settano il testo in \texttt{\textbackslash leftmark} e \texttt{\textbackslash rightmark};
+ \item[\texttt{\textbackslash makeheadrule}] definisce la linea orizzontale utilizzata nelle testatine (default: \texttt{\{\textbackslash colorB\textbackslash hrule \textbackslash @width \textbackslash textwidth \textbackslash @height 0.4pt \textbackslash vskip-0.4pt\}});
+ \item[\texttt{\textbackslash makefootrule}] definisce la linea orizzontale utilizzata nei pie' di pagina (default: \texttt{\textbackslash makeheadrule});
+\end{description}
+
+\section{Layout della copertina}
+\texttt{bookest} fornisce comandi per permettere all'utente di personalizzare con facilità la copertina del proprio documento, in particolare a partire da layout predefiniti che possono essere attivati con le opzioni in \ref{copertinaopzioni}.
+
+\ppar
+Il layout predefinito ha autore e titolo in alto al centro e a pie' di pagina viene posizionato un \emph{footer} composto dal contenuto di \texttt{\textbackslash titlingpageprefooter} e quello di \texttt{\textbackslash titlingpagefooter} separati da una linea orizzontale. Tra il titolo ed il \emph{footer} viene posizionato il contenuto di \texttt{\textbackslash titlingpagemiddle}.
+
+Le varie opzioni permettono di variare il posizionamento del logo; per ciascuna opzione \texttt{\textit{<optlogo>}} in \ref{copertinaopzioni} esiste una variante \texttt{\textit{<optlogo>}-nofooter} in cui il \emph{footer} non è presente.
+
+\subsection{Comandi}
+\begin{description}
+ \item[\texttt{\textbackslash inslogo\{\textit{<file>}\}}] inserisce l'immagine \texttt{\textit{<file>}} con opzioni \texttt{\textbackslash includegraphics} definite in precedenza e usate per il logo (default: \texttt{width=0.6\textbackslash paperwidth});
+ \item[\texttt{\textbackslash setlogooptions\{\textit{<opzioni>}\}}] definisce \texttt{\textit{<opzioni>}} come le opzioni di \texttt{\textbackslash includegraphics} che verranno usate da \texttt{\textbackslash inslogo};
+ \item[\texttt{\textbackslash logo}, \texttt{\textbackslash leftlogo}, \texttt{\textbackslash rightlogo}] sono il percorso (relativo o assoluto) dell'immagine che verrà utilizzata come logo a seconda delle opzioni scelte (default per \texttt{\textbackslash logo} è il percorso relativo \texttt{logo}, default per gli altri è \texttt{\textbackslash logo});
+ \item[\texttt{\textbackslash setlogo\{\textit{<percorso>}\}}, \texttt{\textbackslash setleftlogo\{\textit{<percorso>}\}}, \texttt{\textbackslash setrightlogo\{\textit{<percorso>}\}}] settano a \texttt{\textit{<percorso>}} il contenuto di \texttt{\textbackslash logo}, \texttt{\textbackslash leftlogo}, \texttt{\textbackslash rightlogo};
+ \item[\texttt{\textbackslash titlingpagemiddle}] è il testo che verrà posizionato a metà della \emph{titling page};
+ \item[\texttt{\textbackslash settitlingpagemiddle}] setta il testo in \texttt{\textbackslash titlingpagemiddle};
+ \item[\texttt{\textbackslash titlingpageprefooter}] è il testo che verrà posizionato prima del \emph{footer} nella \emph{titling page};
+ \item[\texttt{\textbackslash settitlingpageprefooter}] setta il testo in \texttt{\textbackslash titlingpageprefooter};
+ \item[\texttt{\textbackslash titlingpagefooter}] è il testo che verrà utilizzato come \emph{footer} nella \emph{titling page} (default: \texttt{\textbackslash today});
+ \item[\texttt{\textbackslash settitlingpagefooter}] setta il testo in \texttt{\textbackslash titlingpagefooter};
+ \item[\texttt{\textbackslash settitlingpagetitle}] definisce il formato del titolo all'interno della \emph{titling page};
+ \item[\texttt{\textbackslash titling}] inserisce la \emph{titling page}.
+\end{description}
+
+\subsection{Opzioni}\label{copertinaopzioni}
+\begin{description}
+ \item[\texttt{nofooter}] variante senza \emph{footer} del layout predefinito;
+ \item[\texttt{logo}, \texttt{logo-nofooter}] aggiunge al layout predefinito il logo in \texttt{\textbackslash logo} sotto il titolo (e relativa variante \texttt{nofooter}) --- richiede il pacchetto \texttt{graphicx};
+ \item[\texttt{logo-bg}, \texttt{logo-bg-nofooter}] aggiunge al layout predefinito il logo in \texttt{\textbackslash logo} in background (e relativa variante \texttt{nofooter}) --- richiede i pacchetti \texttt{graphicx} ed \texttt{eso-pic};
+ \item[\texttt{logo-topl}, \texttt{logo-topl-nofooter}] aggiunge al layout predefinito il logo in \texttt{\textbackslash leftlogo} prima del titolo in alto a sinistra (e relativa variante \texttt{nofooter}) --- richiede il pacchetto \texttt{graphicx};
+ \item[\texttt{logo-topc}, \texttt{logo-topc-nofooter}] aggiunge al layout predefinito il logo in \texttt{\textbackslash logo} prima del titolo in alto al centro (e relativa variante \texttt{nofooter}) --- richiede il pacchetto \texttt{graphicx};
+ \item[\texttt{logo-topr}, \texttt{logo-topr-nofooter}] aggiunge al layout predefinito il logo in \texttt{\textbackslash rightlogo} prima del titolo in alto a destra (e relativa variante \texttt{nofooter}) --- richiede il pacchetto \texttt{graphicx};
+ \item[\texttt{logo-toplr}, \texttt{logo-toplr-nofooter}] aggiunge al layout predefinito il logo in \texttt{\textbackslash leftlogo} in alto a sinistra ed il logo in \texttt{\textbackslash rightlogo} in alto a destra prima del titolo (e relativa variante \texttt{nofooter}) --- richiede il pacchetto \texttt{graphicx}.
+ \item[\texttt{logo-toplcr}, \texttt{logo-toplcr-nofooter}] aggiunge al layout predefinito il logo in \texttt{\textbackslash leftlogo} in alto a sinistra, il logo in \texttt{\textbackslash logo} in alto al centro ed il logo in \texttt{\textbackslash rightlogo} in alto a destra prima del titolo (e relativa variante \texttt{nofooter}) --- richiede il pacchetto \texttt{graphicx}.
+\end{description}
+
+\section{Miscellanea}
+\texttt{bookest} fornisce anche altre piccole scorciatoie, che possono essere utili nell'utilizzo della classe e che vengono elencate qui di seguito:
+
+\subsection{Opzioni}
+\begin{description}
+ \item[\texttt{noepigraph}] elimina le epigrafi.
+\end{description}
+
+\subsection{Comandi}
+\begin{description}
+ \item[\texttt{\textbackslash setbibname\{\textit{<nome>}\}}] rinomina il titolo della bibliografia in \texttt{\textit{<nome>}};
+ \item[\texttt{\textbackslash setcontentsname\{\textit{<nome>}\}}] rinomina il titolo dell'indice in \texttt{\textit{<nome>}};
+ \item[\texttt{\textbackslash ppar}] inserisce uno spazio verticale di \texttt{1.5ex} --- utile per esempio con l'opzione \texttt{noparskip};
+ \item[\texttt{\textbackslash dimstleftskip}] setta \texttt{\textbackslash leftskip} a \texttt{1cm};
+ \item[\texttt{\textbackslash UCase}] fornisce il comando \texttt{\textbackslash MakeUppercase}, che viene invece ridefinito come comando vuoto per dare maggiore flessibilità ai comandi per testatine e pie' di pagina;
+ \item[\texttt{\textbackslash epigraph\{\textit{<testo1>}\}\{\textit{<testo2>}\}\{\textit{<ambiente>}\}\{\textit{<l>}\}}] crea un epigrafe, in cui \texttt{\textit{<testo1>}} viene separato da \texttt{\textit{<testo2>}} da una linea orizzontale di colore \texttt{B}. Il tutto ha larghezza \texttt{\textit{<l>}} ed è contenuto nell'ambiente \texttt{\textit{<ambiente>}}.
+ \item[\texttt{\textbackslash noepigraph}] elimina le epigrafi;
+\end{description}
+
+\subsection{Ambienti}
+\begin{description}
+ \item[\texttt{abstract}] è un ambiente di larghezza \texttt{0.9\textbackslash textwidth}, con un parametro \texttt{\textit{<titolo>}} che verrà scritto in grassetto prima del testo contenuto nell'ambiente;
+\item[\texttt{dimst}] è un ambiente in cui il testo è in \texttt{slshape} e con il margine sinistro maggiorato di 1 cm.
+\end{description}
+
+\section{Contatti}
+Per commenti, suggerimenti o segnalazione bugs potete contattarmi all'indirizzo \href{mailto:bresciani@sssup.it}{\textit{bresciani@sssup.it}}.
+
+\end{document}