Initial commit

11 files changed, 740 insertions, 0 deletions

diff --git a/macros/latex/contrib/GuIT/guitbeamer/README b/macros/latex/contrib/GuIT/guitbeamer/README
new file mode 100644
index 0000000000..97a762c290
--- /dev/null
+++ b/macros/latex/contrib/GuIT/guitbeamer/README
@@ -0,0 +1,43 @@
+  guitbeamer.cls
+  ========
+
+  The GuITbeamer class provides some commands written purposely
+  in order to make the production of lessons of LaTeX easier. The
+  class is based on the well known class beamer. 
+  
+  Documentation available in German and Italian only.
+
+  German translation of the documentation was provided by
+  Christoph Bier [christoph_bier(at)web.de]. Please, refer
+  directly to him for advices/comments/requests on his own work.
+
+----------------------------------------------------------------------
+  
+  Copyright 2006 GuIT - Gruppo Utilizzatori Italiani di TeX
+			guit(at)sssup.it
+
+  This work is distributed under the conditions of the Creative
+  Commons Public License v2.5, with these License Elements:
+    * Attribution
+    * Non Commercial
+    * Share Alike
+ 
+  The complete text of the license is available at:
+ 
+    http://creativecommons.org/licenses/by-nc-sa/2.5/legalcode
+ 
+  The Licenser is GuIT, Gruppo Utilizzatori Italiani di TeX, the
+  author is Emiliano Vavassori [testina(at)sssup.it], which also
+  mantains this Work.
+
+  The Work consists of subsequent files:
+
+    guitbeamer.cls	Class file for GuITbeamer
+    guitbeamer.pdf	Documentation for GuITbeamer class
+    guitbeamer-de.pdf	Documentation in German
+    guitbeamer.tex	Sources of documentation (Italian only)
+    img/		Graphic files directory
+    README		(this file)
+    README.it		Italian translated version of this file
+
+----------------------------------------------------------------------
diff --git a/macros/latex/contrib/GuIT/guitbeamer/README.it b/macros/latex/contrib/GuIT/guitbeamer/README.it
new file mode 100644
index 0000000000..c88b94de23
--- /dev/null
+++ b/macros/latex/contrib/GuIT/guitbeamer/README.it
@@ -0,0 +1,46 @@
+  guitbeamer.cls
+  ========
+
+  Viene qui presentata l'interfaccia dei comandi della classe
+  guitbeamer, scritta appositamente per rendere più semplice la
+  produzione di diapositive per lezioni di LaTeX tenute da membri
+  del "Gruppo Utilizzatori Italiani di TeX". La classe si basa
+  sulla ben più conosciuta classe beamer.
+
+  La documentazione è disponibile in Italiano e Tedesco.
+
+  La documentazione in tedesco è stata fornita da Christoph Bier
+  [christoph_bier(at)web.de]. Riferite direttamente a lui
+  commenti/richieste/consigli sul suo lavoro.
+
+----------------------------------------------------------------------
+  
+  Copyright 2006 GuIT - Gruppo Utilizzatori Italiani di TeX
+		    guit(at)sssup.it
+
+  Questo lavoro è distribuito sotto le condizioni della licenza
+  Creative Commons Public License v2.5, con i seguenti Elementi:
+    * Attribuzione
+    * Non Commerciale
+    * Condividi allo stesso modo
+ 
+  La versione completa della licenza è disponibile all'URI:
+ 
+    http://creativecommons.org/licenses/by-nc-sa/2.5/legalcode
+ 
+  Il Licenziatore è GuIT, Gruppo Utilizzatori Italiani di TeX e
+  l'autore è Emiliano Vavassori [testina(at)sssup.it], che
+  inoltre mantiene il lavoro.
+
+  Il lavoro consiste dei seguenti file:
+
+    guitbeamer.cls	File di classe di GuITbeamer
+    guitbeamer.pdf	Documentazione della classe GuITBeamer
+    guitbeamer-de.pdf	Documentazione in Tedesco
+    guitbeamer.tex	Sorgenti della documentazione (solo
+			Italiano)
+    img/		Directory di file grafici	
+    README		File README in inglese
+    README.it		(questo file)
+
+----------------------------------------------------------------------
diff --git a/macros/latex/contrib/GuIT/guitbeamer/guitbeamer-de.pdf b/macros/latex/contrib/GuIT/guitbeamer/guitbeamer-de.pdf
new file mode 100644
index 0000000000..754a85cf89
--- /dev/null
+++ b/macros/latex/contrib/GuIT/guitbeamer/guitbeamer-de.pdf
diff --git a/macros/latex/contrib/GuIT/guitbeamer/guitbeamer.cls b/macros/latex/contrib/GuIT/guitbeamer/guitbeamer.cls
new file mode 100644
index 0000000000..974a0b6f19
--- /dev/null
+++ b/macros/latex/contrib/GuIT/guitbeamer/guitbeamer.cls
@@ -0,0 +1,146 @@
+% vim ft=tex
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesClass{guitbeamer}[2006/10/26 v0.4.1 GuIT modified Beamer]
+
+\RequirePackage[svgnames]{xcolor}
+\LoadClassWithOptions{beamer}[2005/06/12]
+\RequirePackageWithOptions{graphicx}
+\hypersetup{colorlinks=false}
+
+\RequirePackage[color]{guit}[2006/05/24]
+\GuITcolor{1,.66,1,0}
+
+%
+% Impostazione del layout grafico
+%
+
+%%% Configurazioni di beamer
+\usetheme{Warsaw}
+\beamertemplatenumberedballsectiontoc
+\usecolortheme[rgb={0,.5,0}]{structure}
+\useoutertheme{split}
+\usefonttheme{default} 
+
+%%% Definisco il cmr per il testo matematico (come da pagina 174 della guida)
+\usefonttheme[onlymath]{serif}
+
+%%% Colori dei blocchi di codice
+\definecolor{LC background}{rgb}{1,.97,.86}
+\colorlet{LC foreground}{DarkBlue}
+\colorlet{LC alerted fg}{DarkRed}
+
+\setbeamercolor{alerted text}{fg=blue}% Il colore degli alert e` blu
+\setbeamercolor{aalerted text}{fg=red}% Il colore degli aalert e` rosso
+\setbeamercolor{LaTeX code}{fg=LC foreground,bg=LC background}
+\setbeamercolor{alerted LaTeX code}{fg=LC alerted fg,bg=LC background}
+
+%%% Ridefinisco la footline
+\setbeamertemplate{footline}{\leavevmode%
+\begin{beamercolorbox}[wd=.33\paperwidth,right,ht=2.25ex,dp=1ex,rightskip=4pt
+  plus 1pt]{subsection in head/foot}
+  \insertshortauthor\ (\insertshortinstitute)
+\end{beamercolorbox}% 
+\begin{beamercolorbox}[wd=.33\paperwidth,center,ht=2.25ex,dp=1ex]{section in head/foot}
+  \usebeamercolor[fg]{section in foot/head}\insertshorttitle
+\end{beamercolorbox}%
+\begin{beamercolorbox}[wd=.34\paperwidth,ht=2.25ex,dp=1ex,leftskip=4pt plus 1pt,rightskip=4pt plus 1pt]{subsection in head/foot}
+  \insertshortdate\hfill\insertframenumber/\inserttotalframenumber
+\end{beamercolorbox}%
+}
+
+%
+% Definizioni utili
+%
+
+%%% Definisco un comando \aalert
+%%% Utilizzo: \aalert{ argomento }
+\newcommand<>{\aalert}[1]{\begin{alertenv}#2\usebeamercolor[fg]{aalerted text}#1\end{alertenv}}
+
+%
+% Comandi per la scrittura del codice LaTeX e del relativo output
+%
+\newcommand{\bs}{{\char'134}}% Backslash
+\newcommand{\lb}{{\char'173}}% Left brackets -> {
+\newcommand{\rb}{{\char'175}}% Right brackets -> }
+\newcommand{\ls}{{\char'133}}% Left brackets -> [
+\newcommand{\rs}{{\char'135}}% Right brackets -> ]
+
+%
+% Comandi per la scrittura di classi, pacchetti, ecc.
+%
+
+%%% Definisco il comando per nominare i pacchetti
+%%% Utilizzo: \Lsty{ nome_classe_o_pacchetto }
+\newcommand<>{\Lsty}[1]{\begin{actionenv}#2\usebeamercolor[fg]{structure}\ttfamily #1\end{actionenv}}
+%%% Definisco \Lcls nella stessa maniera di \Lsty
+\let\Lcls\Lsty
+%%% \Lopt e` un comando per nominare le opzioni delle classi
+\def\Lopt#1{\LCmd[]{#1}}
+%%% \Lenv e` un comando per nominare gli ambienti
+\let\Lenv\Lopt
+
+%%% Ridefinisco il titolo per inserire un controllo
+\def\@inframetitle{}
+\addtobeamertemplate{frametitle}{\def\@inframetitle{pippo}}
+
+%%% LaTeXcode serve per scrivere codice in blocco a se stante ed
+%%% e` basato sul codice di 'semiverbatim', classe beamer.
+%%% Utilizzo: \begin{LaTeXcode}[ eventuale_titolo ]
+%%%             \n \nn \alert{ }
+%%%           \end{LaTeXcode}
+\newenvironment<>{LaTeXcode}[1][]%
+{\begin{actionenv}#2%
+  \def\insertblocktitle{#1}%
+  \setbeamercolor{block body}{fg=LC foreground,bg=LC background}
+  \newcommand{\n}{\newline}% Interruzione di riga singola
+  \newcommand{\nn}{\newline\null\newline}% Interruzione di riga doppia
+  \renewcommand*{\alert}[1]{{\usebeamercolor[fg]{alerted LaTeX code}##1}}% Alert
+  \usebeamertemplate{block begin}\hbadness=10000%
+  \begin{semiverbatim}}%
+  {\end{semiverbatim}%
+  \usebeamertemplate{block end}
+\end{actionenv}}
+
+%%% LaTeXoutput serve per mostrare il risultato del codice.
+%%% Utilizzo: \begin{LaTeXoutput}[ eventuale_titolo ]
+%%%           \end{LaTeXoutput}
+\newenvironment<>{LaTeXoutput}[1][]%
+{\begin{actionenv}#2%
+  \def\insertblocktitle{#1}%
+  \newcommand{\fakeind}{\hspace*{1.5em}}% Simula l'\indent. Va usato a mano
+  \usebeamertemplate{block begin}\setlength{\parindent}{1.5em}\rmfamily}%
+  {\usebeamertemplate{block end}
+\end{actionenv}}
+
+%%% LCmd serve per scrivere un comando all'interno del testo.
+%%% Utilizzo: \LCmd[ carattere_escape ]{ comando \\ \{ \} \ls \rs }
+%%% NEW! Puo` essere usato anche nei titoli :)
+\newcommand{\LCmd}[2][\char'134 ]{\begingroup%
+\let\\\bs\let\{\lb\let\}\rb%
+\ifx\@inframetitle\@empty%
+  \usebeamercolor[fg]{LaTeX code}\ttfamily{#1}{#2}%
+\else%
+  \ttfamily{#1}{#2}%
+\fi%
+\endgroup}
+
+%%% LCmdArg e` simile a LCmd ma mette in evidenza l'argomento.
+%%% Utilizzo: \LCmdArg{ comando }{ argomento_del_comando }
+%%% All'interno di \LCmdArg si possono usare gli stessi simboli di \LCmd.
+\newcommand{\LCmdArg}[2]{\begingroup%
+\let\\\bs\let\{\lb\let\}\rb%
+\color{LaTeX code.fg}\ttfamily\char'134{#1}\char'173{\color{alerted LaTeX code.fg}{#2}}\char'175\endgroup}
+
+%%% Per scrivere correttamente \, {, }, [ e ] nel testo
+\newcommand{\tbs}{\LCmd{}}% Textual BackSlash
+\newcommand{\tlb}{\LCmd[]{\lb}}% Textual Left Bracket
+\newcommand{\trb}{\LCmd[]{\rb}}% Textual Right Bracket
+\newcommand{\tls}{\LCmd[]{\ls}}% Textual Left Square
+\newcommand{\trs}{\LCmd[]{\rs}}% Textual Right Square
+
+%%% Impostiamo istituzione e logo
+\def\ncGuIT{\GuIT[color=no]}
+\institute[\protect\ncGuIT]{\scalebox{2}{\GuIT} --- \large\GuITtext\\\GuITurl}
+\logo{\scalebox{2}{\GuIT}}
+
+\endinput
diff --git a/macros/latex/contrib/GuIT/guitbeamer/guitbeamer.pdf b/macros/latex/contrib/GuIT/guitbeamer/guitbeamer.pdf
new file mode 100644
index 0000000000..5ab8f69889
--- /dev/null
+++ b/macros/latex/contrib/GuIT/guitbeamer/guitbeamer.pdf
diff --git a/macros/latex/contrib/GuIT/guitbeamer/guitbeamer.tex b/macros/latex/contrib/GuIT/guitbeamer/guitbeamer.tex
new file mode 100644
index 0000000000..023e719747
--- /dev/null
+++ b/macros/latex/contrib/GuIT/guitbeamer/guitbeamer.tex
@@ -0,0 +1,505 @@
+% vim:sts=2:sw=2:tw=70
+\documentclass[a4paper,10pt]{article}
+\usepackage[utf8x]{inputenc}
+\usepackage[italian]{babel}
+\usepackage[color]{guit}
+\usepackage{hyperref,indentfirst,fancyvrb,cclicenses,pifont,booktabs,breakurl,graphicx}
+\graphicspath{{img/}}
+\hypersetup{colorlinks=true,urlcolor=blue}
+
+\newcommand{\email}[1]{\href{mailto:#1}{\ttfamily #1}}
+\newcommand{\lcap}{{\fontencoding{T1}\selectfont\guillemotleft}}
+\newcommand{\rcap}{{\fontencoding{T1}\selectfont\guillemotright}}
+\newcommand{\Cap}[1]{\lcap #1\rcap}
+
+\newcommand{\bs}{{\char'134}}% Backslash
+\newcommand{\lb}{{\char'173}}% Left brackets -> {
+\newcommand{\rb}{{\char'175}}% Right brackets -> }
+\newcommand{\ls}{{\char'133}}% Left brackets -> [
+\newcommand{\rs}{{\char'135}}% Right brackets -> ]
+
+\newcommand{\pkg}[1]{\textsf{#1}}
+\let\cls\pkg
+\newcommand{\env}[1]{\texttt{#1}}
+\newcommand{\cmd}[1]{\texttt{\bs #1}}
+\newcommand{\cmdarg}[2]{\texttt{\bs #1\lb #2\rb}}
+
+\title{La classe per presentazioni \pkg{guitbeamer}}
+\author{{\LARGE\GuIT} --- \GuITtext\thanks{\cls{guitbeamer} \`e stata
+scritta da Emiliano Giovanni Vavassori
+(\email{testina@sssup.it}). Si veda
+la sezione \ref{sec:acknow}.}}
+\date{Versione 0.4 --- 11 agosto 2006}
+ 
+\begin{document}
+\maketitle
+
+\begin{abstract}
+Viene qui presentata l'interfaccia dei comandi della classe
+\cls{guitbeamer}, scritta appositamente per rendere più semplice la
+produzione di diapositive per lezioni di \LaTeX. La classe si basa
+sulla ben più conosciuta classe \cls{beamer}.
+\end{abstract}
+
+\tableofcontents
+\newpage
+\section*{Note di \textit{copyright}}
+La classe \cls{guitbeamer} è rilasciata sotto licenza
+$\!$\cc$\!\!\!\!$ Creative Commons 2.5\footnote{Il testo completo
+della licenza è disponibile, in inglese, alla pagina
+\url{http://creativecommons.org/licenses/by-nc-sa/2.5/legalcode}.}.
+
+\noindent\emph{Tu sei libero di:}
+\begin{dinglist}{227}
+    \item di riprodurre, distribuire, comunicare al pubblico, esporre
+	in pubblico, rappresentare, eseguire e recitare quest'opera;
+    \item di modificare quest'opera.
+\end{dinglist}
+
+\noindent\emph{Alle seguenti condizioni:}
+\begin{description}
+    \item[\ccby Attribuzione]Devi attribuire la paternità dell'opera
+	nei modi indicati dall'autore o da chi ti ha dato l'opera in
+	licenza.
+    \item[\ccnc Non commerciale]Non puoi usare
+	quest'opera per fini commerciali.
+    \item[\ \ccsa\ \ $\!\!$Condividi allo stesso modo]Se alteri o
+	trasformi quest'opera, o se la usi per crearne un'altra, puoi
+	distribuire l'opera risultante solo con una licenza identica a
+	questa.
+\end{description}
+
+\begin{dinglist}{52}
+    \item Ogni volta che usi o distribuisci quest'opera, devi farlo
+	secondo i termini di questa licenza, che va comunicata con
+	chiarezza.
+    \item In ogni caso, puoi concordare col titolare dei diritti
+	d'autore utilizzi di quest'opera non consentiti da questa
+	licenza.
+\end{dinglist}
+
+\section{Introduzione}
+L'utilizzo delle diapositive (o, in inglese, \textit{slides}) in
+ambiente didattico risulta essere uno strumento fondamentale per
+catturare l'attenzione del discente; tale attenzione viene infatti
+aumentata con l'utilizzo di particolari effetti grafici e/o colori.
+
+\`E tuttavia necessario far attenzione a non abusare di questi
+espedienti grafici per evitare di ottenere l'effetto diametralmente
+opposto: tipicamente, l'attenzione dell'auditorio verrebbe
+completamente assorbita dagli effetti grafici e sviata dall'oggetto
+della presentazione su qualcosa di molto più frivolo.
+
+Questo è un rischio che può correre anche il docente che \Cap{perde
+energie} per sviluppare una presentazione visivamente molto efficace
+ma con contenuti di qualità sicuramente inferiore.
+
+\cls{beamer} viene incontro alle persone che si trovano a dover
+presentare, spiegare, approfondire un argomento, permettendo loro di
+evitare questi problemi e focalizzando l'attenzione sui contenuti
+della presentazione, in pieno accordo con la filosofia di \LaTeX.
+
+La classe \cls{guitbeamer} aggiunge alla potenza di \cls{beamer} una
+interfaccia di comandi semplificata e ottimizzata per la presentazione
+di argomenti correlati a \LaTeX, oltre che una serie di impostazioni
+grafiche studiate \emph{ad hoc}. Per ottenere tale risultato, sono
+stati posti i seguenti obiettivi: 
+\begin{itemize}
+  \item Razionalizzare i sorgenti delle \emph{slides}, così da evitare
+    che l'occhio di chi presenta si perda nel codice piuttosto che sul
+    contenuto;
+  \item Omogeneizzare il \textit{layout} delle singole \emph{slide}
+    all'interno di una stessa presentazione, per evitare, ad esempio,
+    che una classe venga \Cap{nominata} una volta con un carattere
+    \textit{sans-serif} e una volta con carattere \textit{typewriter}.
+\end{itemize}
+
+La classe \cls{guitbeamer} è stata utilizzata successivamente per le 
+\Cap{Lezioni di \LaTeX} del \GuIT\ \cite{lez-latex05}.
+
+\section{Compatibilità e apparenza}
+\cls{guitbeamer} non è un lavoro a se stante (ovviamente), ma è stata
+realizzata come \textit{collage} di stili predefiniti e di pacchetti
+caricati. Indichiamo in questa sezione le dipendenze della classe da
+eventuali altri pacchetti.
+
+\subsection{Pacchetti caricati}
+La classe \cls{guitbeamer} carica automaticamente la classe
+\cls{beamer} per le presentazioni e restituisce un errore se essa non
+è per lo meno alla versione 3.05 (data di rilascio: 12/06/2005); il
+codice utilizzato nella classe è specifico ed utilizza istruzioni che
+sono rese disponibili solamente a partire da quella versione.
+
+Gli altri pacchetti caricati, le opzioni specifiche utilizzate e
+l'eventuale richiesta di un numero di versione specifico sono tutte
+indicate in tabella~\ref{pacchetti}.
+\begin{table}[b]\centering
+  \caption{Pacchetti caricati nella classe \cls{guitbeamer}, relative
+  versioni richieste e opzioni utilizzate.}\label{pacchetti}
+  \medskip
+  \begin{tabular}{l c l}
+    \toprule
+    \emph{Nome pacchetto} & \emph{Vers. (Data di rilascio)} &
+    \emph{Opzioni utilizzate}\\
+    \midrule
+    \texttt{xcolor} & & \texttt{svgnames}\\
+    \texttt{graphicx} & &\\
+    \texttt{hyperref} & & \texttt{colorlinks=false}\\
+    \texttt{guit} & $\ge\,0.9$ (24/05/2006)& \texttt{color}\\
+    \bottomrule
+  \end{tabular}
+\end{table}
+Va da sé che le dipendenze dei pacchetti utilizzati devono essere, a
+loro volta, contemplate ed esaudite.
+
+\subsection{Layout e grafica della presentazione}
+La classe utilizza il tema \Cap{Warsaw}, ne modifica il colore di
+struttura con quello ufficiale di \GuIT, carica l'\textit{outertheme}
+\Cap{split}, ridefinisce la \textit{footline}, imposta automaticamente
+l'istituzione di riferimento e, infine, carica i font serif solamente
+per la matematica. Se vi è sfuggito qualcosa di quanto appena esposto,
+vi consigliamo di dare una sbirciatina al manuale di \cls{beamer}
+\cite{manbeamer} oppure, a vostra discrezione, utilizzare la
+classe e guardarne l'output \texttt{:)}
+
+\section{Interfaccia utente}
+All'interno della didattica legata a \LaTeX, il docente deve
+relazionare al pubblico non solo dell'utilizzo di un programma, ma
+anche alcune nozioni fondamentali all'intero della filosofia propria
+di \LaTeX; sono state studiate pertanto alcune macro per facilitare
+questo compito al relatore, fornendo un \textit{feedback} visuale alla
+spiegazione orale del docente.
+
+Di seguito verranno descritti i comandi che sono introdotti dalla
+classe e come è possibile utilizzarli.
+
+\subsection{Scrivere pacchetti, classi, ambienti}
+La classe rende disponibile alcuni comandi per evidenziare concetti
+particolari all'interno di \LaTeX:
+\begin{description}
+	\item[\cmd{Lopt}]serve per evidenziare le opzioni che
+		possono essere specificate ad una classe;
+	\item[\cmd{Lsty}]è necessario per scrivere il nome di
+	  pacchetti;
+	\item[\cmd{Lcls}]evidenzia invece il nome delle classi;
+	\item[\cmd{Lenv}]scrive il nome dell'ambiente che è
+		necessario citare.
+\end{description}
+Essi richiedono tutti un argomento obbligatorio, che rappresenta per
+l'appunto il nome dell'oggetto particolare da nominare.
+
+\subsection{Evidenziare}
+Una nota importante, prima di specificare i cambiamenti
+all'evidenziazione attuati nella classe. Esistono molti modi per
+evidenziare una parte di testo: fra tutti i modi che si possono
+scegliere, cambiare il colore del testo è quello, a nostro avviso, più
+\Cap{distruttivo} e fastidioso, anche se è al contempo quello più
+efficace. In \cls{guitbeamer} si fa già ricorso a parecchi colori,
+quindi valutate caso per caso se non convenga evidenziare con
+\verb+\emph+ oppure con \verb+\textbf+. Si ritiene preferibile
+utilizzare il grassetto nelle presentazioni che mutare il colore del
+testo, principalmente per due motivazioni:
+\begin{itemize}
+  \item il principale motivo per cui non si usa normalmente il
+    grassetto all'interno di un normale documento è perché \Cap{rompe
+    il colore del corpo del testo}. Tipicamente in una presentazione
+    si tende, per motivi di concisione, a scrivere brevi frasi e
+    pertanto non esiste un vero e proprio corpo del testo, inteso con
+    i canoni applicati ai documenti normali; è pertanto possibile e
+    non deleterio utilizzare il grassetto;
+  \item il grassetto è spesso utilizzato nel Web, che risulta essere
+    una delle applicazioni che più si avvicinano ad una presentazione
+    elettronica.
+\end{itemize}
+
+Passando dalla teoria alla pratica, il comando \cmd{alert} di
+\cls{beamer} è stato ridefinito perché sia di colore blu; esso è stato
+preferito al colore rosso perché meno appariscente ma altrettanto
+d'effetto. Se necessario, è possibile ricorrere al nuovo comando
+\cmd{aalert} che invece evidenzia il suo argomento in rosso,
+esattamente come fa \verb+\alert+ di \cls{beamer}.
+
+\subsection{Caratteri speciali}\label{sec:sp_char}
+Alcuni comandi della classe richiedono che qualche carattere speciale
+sia scritto in maniera un po' particolare: è il caso di
+tutti i comandi che seguiranno. In essi, sarà possibile (e in alcuni
+casi, necessario) indicare i caratteri speciali di \LaTeX\
+\texttt{\bs}, \texttt{\lb} e \texttt{\rb} come \verb+\\+, \verb+\{+ e
+\verb+\}+. L'eccezione è rappresentata da \verb+[+ e \verb+]+, che
+possono essere lasciate indicate normalmente o, nel caso non
+funzionino, sostituite dai meno diretti \verb+\ls+,
+\textit{left square (parenthesis)} e \verb+\rs+, \textit{right square
+(parenthesis)}. \`E stata scelta questa soluzione sia per ovviare ad un
+piccolo problema di natura estetica, sia perché necessario per alcuni
+comandi.
+
+\subsection{Comandi per gli esempi}
+\subsubsection{Mostrare codice \LaTeX}
+Parlando di \LaTeX\ a qualunque livello, si finirà inevitabilmente,
+prima o poi, con il parlare di codice sorgente. \cls{guitbeamer}
+prevede un ambiente appositamente studiato per mostrare codice,
+\env{LaTeXcode}; esso è derivato da \env{semiverbatim} di \cls{beamer}
+e si consiglia pertanto di rileggere la documentazione di questo
+ambiente \cite{manbeamer} per capirne l'esatto funzionamento.
+
+In questo ambiente è \emph{necessario} utilizzare quei simboli
+speciali definiti in \S~\ref{sec:sp_char}, quando si voglia
+\Cap{mostrare} tali caratteri speciali.
+
+Altri comandi sono disponibili solo ed esclusivamente all'interno di
+questo ambiente:
+\begin{description}
+	\item[\cmd{n}]Che rappresenta una singola interruzione di
+	  riga (\emph{a capo});
+	\item[\cmd{nn}]Che rappresenta una interruzione di riga
+		doppia (quindi, una riga vuota);
+	\item[\cmd{alert}]Per evidenziare parte del contenuto.
+	  Necessita di un argomento obbligatorio, costituito dal testo
+	  da evidenziare.
+\end{description}
+
+\`E inoltre possibile specificare un titolo e un \textit{overlay} per
+l'ambiente \env{LaTeXcode} nello stesso modo in cui si fa con
+\cls{beamer}. Si veda, a tale scopo, il seguente esempio:
+\begin{Verbatim}[gobble=0]
+\begin{LaTeXcode}[Titolo del blocco]<3->
+	ci metto un po' quello che voglio\\dots\n
+	e \alert{apparir\\`a} correttamente\nn
+	ciao a tutti
+\end{LaTeXcode}
+\end{Verbatim}
+ 
+\subsubsection{Mostrare l'output di \LaTeX}
+Dopo aver spiegato il codice, è d'uopo mostrare il suo risultato:
+ anche per questo fine è stato predisposto un ambiente,
+\env{LaTeXoutput}. In questo caso, la sintassi è quella normale di
+\LaTeX\ e non è richiesta nessuna particolare sintassi nella
+composizione della parte, se si fa eccezione per:
+\begin{description}
+  \item[\cmd{noindent}]toglie il rientro (che è stato impostato di
+    \textit{default} dalla classe);
+  \item[\cmd{fakeind}]serve per inserire una falsa indentazione e va
+    usato a mano solo nei casi in cui non si ottiene l'indentazione
+    necessaria.
+\end{description}
+
+Come il suo gemello per il codice, può anch'esso essere fornito di
+titolo e di specificazioni di \emph{overlay}, come mostrato
+nell'esempio:
+\begin{Verbatim}
+\begin{LaTeXoutput}[Titolo del blocco (output)]<4->
+  ci metto un po' quello che voglio\dots e apparir\`a correttamente
+  
+  ciao a tutti
+\end{LaTeXoutput}
+\end{Verbatim}
+
+\subsubsection{Comandi \LaTeX\ nel corpo del testo}
+Sono state definite due macro, \cmd{LCmd} e \cmd{LCmdArg}, che
+permettono di evidenziare il codice all'interno del testo. Queste due
+macro sono comode quando si voglia, ad esempio, citare un comando
+(\verb+\listfiles+) e si voglia evidenziare l'argomento di un comando
+(\verb+\vspace{5em}+), rispettivamente.
+
+La sintassi di \cmd{LCmd} prevede un argomento opzionale e uno
+obbligatorio. L'argomento opzionale (e quindi racchiuso fra le
+parentesi quadre \verb+[ ]+) è il carattere di \emph{inizio comando} o
+\textit{escape}, che di \textit{default} è settato a \verb+\+.
+L'argomento obbligatorio risulta invece essere il nome del comando che
+si vuole mostrare. Il comando \verb+\LCmd+ può inoltre essere inserito
+in un titolo di \textit{slide}: in tal caso perde il suo colore
+normale (blu scuro).
+
+Facendo alcuni esempi, possiamo dire che \verb+\LCmd[]{pippo}+
+produce, nell'output, qualcosa di simile a \texttt{pippo}. \`E
+possibile, inoltre, scrivere un comando fornito di argomenti senza
+evidenziarli, utilizzando i caratteri speciali illustrati in
+\S~\ref{sec:sp_char} e potendo così scrivere
+\verb+\LCmd{documentclass[a4paper]\{article\}}+, che dà luogo a
+qualcosa di simile a \verb+\documentclass[a4paper]{article}+.
+
+Il comando \verb+\LCmdArg+ invece non è utilizzabile nei titoli,
+prevede solamente due argomenti obbligatori ed è
+necessario per evidenziare l'argomento di un comando; ad esempio, per
+citare il caso precedente, si può utilizzare:\\[.5em]
+\verb+\LCmdArg{documentclass[a4paper]}{article}+\\[.5em] ed
+evidenziare così la classe del documento.
+
+In entrambi i casi, ricordiamo nuovamente che possono essere
+utilizzati i caratteri di cui alla sezione \S~\ref{sec:sp_char}.
+
+
+\newpage
+\section{Esempi di \textit{slides}}
+In questa piccolissima sezione, analizzeremo alcune slides e il loro
+output, giusto per dare un'idea al lettore di come possano essere
+utilizzati i comandi della classe.
+
+\subsection*{Esempio 1}\label{ex1}
+
+\begin{Verbatim}[gobble=2]
+  \begin{frame}
+    \frametitle{Scrivere i loghi}
+    Ecco come si scrivono i loghi:
+    \begin{LaTeXcode}
+      \\TeX\n
+      \\LaTeX\n
+      \\LaTeXe
+    \end{LaTeXcode}
+    \medskip
+    \begin{LaTeXoutput}
+      \TeX\\
+      \LaTeX\\
+      \LaTeXe
+    \end{LaTeXoutput}
+  \end{frame}
+\end{Verbatim}
+
+\bigskip
+\begin{center}
+  \fbox{\includegraphics[width=.9\textwidth]{latexsymb}}
+\end{center}
+
+\newpage 
+\subsection*{Esempio 2}\label{ex2}
+
+\begin{Verbatim}[gobble=0]
+\begin{frame}
+  \frametitle{Il modello di un documento}
+  \begin{LaTeXcode}
+    \\documentclass[\alert{<opzioni>}]\{\alert{<classe>}\}\n
+    \onslide<2->
+    \quad\alert{<preambolo>}\nn
+    \onslide<3->
+    \\begin\{document\}\n
+    \onslide<4->
+    \alert{\quad<testo del documento>}\n
+    \onslide<3->
+    \\end\{document\}
+  \end{LaTeXcode}
+\end{frame}
+\end{Verbatim}
+
+\bigskip
+\begin{center}
+  \fbox{\includegraphics[width=.9\textwidth]{docexem}}
+\end{center}
+
+\newpage 
+\subsection*{Esempio 3}\label{ex3}
+\begin{Verbatim}
+\begin{frame}
+  \frametitle{La sintassi di base}
+  \begin{itemize}[<+->]
+    \item tutti i comandi cominciano sempre con un
+      \LCmd\
+    \item spesso il comando è il nome inglese dell'azione
+    \item il comando ``termina'' con uno spazio bianco o con un
+      altro comando:
+    \begin{LaTeXcode}<4->
+      \\comando \alert{<testo>}\n
+      \\comando\\altrocomando
+    \end{LaTeXcode}
+  \end{itemize}
+  \smallskip
+  \begin{block}{Attenzione!}<5->
+    \begin{center}
+      \LaTeX\ è \textit{case sensitive}!\\[.5em]
+      bisogna pertanto stare attenti a distinguere tra\\[.3em]
+      \alert{\large MAIUSCOLO} e \alert{\large minuscolo}
+    \end{center}
+  \end{block}
+\end{frame}
+\end{Verbatim}
+
+\bigskip
+\begin{center}
+  \fbox{\includegraphics[width=.9\textwidth]{cmdexpl}}
+\end{center}
+
+\newpage
+\subsection*{Esempio 4}\label{ex4}
+\begin{Verbatim}
+\begin{frame}
+  \frametitle{Due esempi di pacchetti}
+  \begin{LaTeXcode}
+    \\usepackage\{\alert{graphicx}\}
+  \end{LaTeXcode}
+  \Lsty{graphicx} è un pacchetto che permette di gestire l'inserimento
+  delle immagini, dei colori e di rotazioni
+
+  \bigskip
+  \onslide<2->
+    \begin{LaTeXcode}
+      \\usepackage[\alert{italian}]\{\alert{babel}\}
+    \end{LaTeXcode}
+    \Lsty{babel} permette di sillabare testi scritti in lingue diverse 
+    dall'inglese (default), attivando la sillabazione della lingua
+    selezionata (in questo caso, la nostra: \LCmd[]{italian})
+\end{frame}
+\end{Verbatim}
+
+\bigskip
+\begin{center}
+  \fbox{\includegraphics[width=.9\textwidth]{pkgexem}}
+\end{center}
+
+\newpage
+\subsection*{Esempio 5}\label{ex5}
+\begin{Verbatim}
+\begin{frame}
+  \frametitle{Le classi base di \LaTeX}
+  \begin{LaTeXcode}
+    \\documentclass[<opzioni>]\{\alert{<classe>}\}
+  \end{LaTeXcode}
+  \begin{itemize}
+    \item\Lcls{article}
+    \item\Lcls{report}
+    \item\Lcls{book}
+    \item\Lcls{letter}
+    \item\Lcls{slides}
+    \item\dots
+    \item\Lcls{beamer}
+    \item\dots
+  \end{itemize}
+\end{frame}
+\end{Verbatim}
+
+\bigskip
+\begin{center}
+  \fbox{\includegraphics[width=.9\textwidth]{clsexpl}}
+\end{center}
+
+\newpage
+\section{Ringraziamenti}\label{sec:acknow}
+Si ringraziano Maurizio Himmelmann e Fabiano Busdraghi che hanno fatto
+proposte e richieste precise in merito alla classe (alcune tutt'ora
+insolute, ad onor del vero) e sono stati veri e propri
+\textit{beta-testers} della classe.
+
+Un sentito ringraziamento a Emanuele Vicentini, sempre prezioso e
+disponibile sia sul lato \TeX nico che su quello personale. Emanuele,
+ricorda che tutto ciò che hai dato ti sarà restituito 100 volte
+\texttt{:)}
+
+\section{\textit{Disclaimer}, \textit{feedback} e \textit{bug
+reports}}\label{sec:fb&b}
+La presente classe non è stata scritta da un programmatore \LaTeX\
+professionista ed è pertanto da considerarsi soggetta a
+\textit{bugs}. Si invitano le persone che abbiano utilizzato questa
+classe a far pervenire all'autore, per mezzo della casella di posta
+elettronica \href{mailto:guit@sssup.it?subject=[guitbeamer]
+Feedback}{\texttt{guit@sssup.it}} eventuali richieste, commenti e
+segnalazioni di problemi su \cls{guitbeamer}, aggiungendo all'inizio
+del soggetto della mail la stringa ``\verb+[guitbeamer]+''.
+
+\vfill
+\bibliographystyle{plain}
+\begin{thebibliography}{99}
+  \bibitem{lez-latex05} Maurizio W.~Himmelmann, Emiliano G.~Vavassori,
+    Fabiano Busdraghi; \newblock\emph{Introduzione al mondo di \LaTeX\ ---\
+    Guida al corso}, \newblock 2006, \GuITtext, Pisa.
+  \bibitem{manbeamer} Till Tantau; \newblock\emph{The \cls{beamer}
+    class}, manuale della classe, \newblock 2005.
+\end{thebibliography}
+\end{document}
diff --git a/macros/latex/contrib/GuIT/guitbeamer/img/clsexpl.pdf b/macros/latex/contrib/GuIT/guitbeamer/img/clsexpl.pdf
new file mode 100644
index 0000000000..f51a0d460a
--- /dev/null
+++ b/macros/latex/contrib/GuIT/guitbeamer/img/clsexpl.pdf
diff --git a/macros/latex/contrib/GuIT/guitbeamer/img/cmdexpl.pdf b/macros/latex/contrib/GuIT/guitbeamer/img/cmdexpl.pdf
new file mode 100644
index 0000000000..ff3e9cee98
--- /dev/null
+++ b/macros/latex/contrib/GuIT/guitbeamer/img/cmdexpl.pdf
diff --git a/macros/latex/contrib/GuIT/guitbeamer/img/docexem.pdf b/macros/latex/contrib/GuIT/guitbeamer/img/docexem.pdf
new file mode 100644
index 0000000000..6c2d2d5714
--- /dev/null
+++ b/macros/latex/contrib/GuIT/guitbeamer/img/docexem.pdf
diff --git a/macros/latex/contrib/GuIT/guitbeamer/img/latexsymb.pdf b/macros/latex/contrib/GuIT/guitbeamer/img/latexsymb.pdf
new file mode 100644
index 0000000000..ac92068699
--- /dev/null
+++ b/macros/latex/contrib/GuIT/guitbeamer/img/latexsymb.pdf
diff --git a/macros/latex/contrib/GuIT/guitbeamer/img/pkgexem.pdf b/macros/latex/contrib/GuIT/guitbeamer/img/pkgexem.pdf
new file mode 100644
index 0000000000..d17e5d8e83
--- /dev/null
+++ b/macros/latex/contrib/GuIT/guitbeamer/img/pkgexem.pdf