From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- macros/latex/contrib/GuIT/GuITlogo/README | 175 +++ macros/latex/contrib/GuIT/GuITlogo/guit.dtx | 1572 ++++++++++++++++++++ macros/latex/contrib/GuIT/GuITlogo/guit.ins | 85 ++ macros/latex/contrib/GuIT/GuITlogo/guit.pdf | Bin 0 -> 316929 bytes macros/latex/contrib/GuIT/GuITlogo/guittest.pdf | Bin 0 -> 161459 bytes macros/latex/contrib/GuIT/guitbeamer/README | 43 + macros/latex/contrib/GuIT/guitbeamer/README.it | 46 + .../contrib/GuIT/guitbeamer/guitbeamer-de.pdf | Bin 0 -> 490706 bytes .../latex/contrib/GuIT/guitbeamer/guitbeamer.cls | 146 ++ .../latex/contrib/GuIT/guitbeamer/guitbeamer.pdf | Bin 0 -> 289419 bytes .../latex/contrib/GuIT/guitbeamer/guitbeamer.tex | 505 +++++++ .../latex/contrib/GuIT/guitbeamer/img/clsexpl.pdf | Bin 0 -> 963175 bytes .../latex/contrib/GuIT/guitbeamer/img/cmdexpl.pdf | Bin 0 -> 962875 bytes .../latex/contrib/GuIT/guitbeamer/img/docexem.pdf | Bin 0 -> 963092 bytes .../contrib/GuIT/guitbeamer/img/latexsymb.pdf | Bin 0 -> 963162 bytes .../latex/contrib/GuIT/guitbeamer/img/pkgexem.pdf | Bin 0 -> 963404 bytes 16 files changed, 2572 insertions(+) create mode 100644 macros/latex/contrib/GuIT/GuITlogo/README create mode 100644 macros/latex/contrib/GuIT/GuITlogo/guit.dtx create mode 100644 macros/latex/contrib/GuIT/GuITlogo/guit.ins create mode 100644 macros/latex/contrib/GuIT/GuITlogo/guit.pdf create mode 100644 macros/latex/contrib/GuIT/GuITlogo/guittest.pdf create mode 100644 macros/latex/contrib/GuIT/guitbeamer/README create mode 100644 macros/latex/contrib/GuIT/guitbeamer/README.it create mode 100644 macros/latex/contrib/GuIT/guitbeamer/guitbeamer-de.pdf create mode 100644 macros/latex/contrib/GuIT/guitbeamer/guitbeamer.cls create mode 100644 macros/latex/contrib/GuIT/guitbeamer/guitbeamer.pdf create mode 100644 macros/latex/contrib/GuIT/guitbeamer/guitbeamer.tex create mode 100644 macros/latex/contrib/GuIT/guitbeamer/img/clsexpl.pdf create mode 100644 macros/latex/contrib/GuIT/guitbeamer/img/cmdexpl.pdf create mode 100644 macros/latex/contrib/GuIT/guitbeamer/img/docexem.pdf create mode 100644 macros/latex/contrib/GuIT/guitbeamer/img/latexsymb.pdf create mode 100644 macros/latex/contrib/GuIT/guitbeamer/img/pkgexem.pdf (limited to 'macros/latex/contrib/GuIT') diff --git a/macros/latex/contrib/GuIT/GuITlogo/README b/macros/latex/contrib/GuIT/GuITlogo/README new file mode 100644 index 0000000000..c6c5954018 --- /dev/null +++ b/macros/latex/contrib/GuIT/GuITlogo/README @@ -0,0 +1,175 @@ +GuIT.sty +======== + +Il pacchetto guit.sty fornisce alcuni comandi utili per scrivere +correttamente il logo del "Gruppo Utilizzatori Italiani di TeX" usando il +colore di default del testo oppure un colore qualunque selezionabile +dall'utente, secondo lo schema del logo presente sul sito del Gruppo +(https://www.guitex.org). Sono altresì presenti comandi che facilitano la +scrittura dell'espansione completa dell'acronimo GuIT, degli indirizzi del +sito internet del Gruppo e del forum pubblico, del logo del convegno +GuITmeeting e della rivista Ars TeXnica. Opzionalmente, tramite l'uso di +hyperref, i prodotti dei comandi appena citati possono diventare +collegamenti ipertestuali al sito del Gruppo (https://www.guitex.org). + +[ The guit.sty package provides some commands useful to correctly write the + logo of "Gruppo Utilizzatori Italiani di TeX" (Italian TeX User Group), + using the default document color or any other color the user may ever + choose, in conformity with logo's scheme as seen on the Group site + (https://www.guitex.org). Likewise, commands are available that simplify + the writing of GuIT acronym's complete expansion, of the addresses of + Group's internet site and public forum, the meeting GuITmeeting and + magazine Ars TeXnica's logo. Optionally, using hyperref, the outputs of + the above cited commands can become hyperlinks to Group's site + (https://www.guitex.org). + + Documentation available in Italian only.] + +Modifiche nella versione 1.0.0-alpha.3 (2019/07/08) +o url viene caricato con l'opzione hyphens + +Modifiche nella versione 1.0.0-alpha.2 (2019/06/27) +o Aggiornato l'indirizzo del sito internet del gruppo + +Modifiche nella versione 1.0.0-alpha.1 (2012/11/03) +o Aggiunto il supporto per Latin Modern + +Modifiche nella versione 0.9.2 (2012/08/17) +o Aggiornato l'indirizzo del sito internet + +Modifiche nella versione 0.9.1 (2009/07/31) +o Disabilitato il caricamento automatico di hyperref (richiesta e codice ad + opera di Enrico Gregorio) + +Modifiche nella versione 0.9 (2006/05/24) +o Molti comandi ora possono usare "chiavi" definite tramite xkeyval (ricorda + molto ConTeXt) e presentano nuove funzionalità +o Nuovo comando: \setupGuIT +o Rimosso \swapGuITcommands +o xcolor è diventato obbligatorio +o Nuovo comando: \GuITtextEn +o Nuovo "stile" di composizione per \GuITmeeting +o \GuIT può essere composto anche con \bfseries per la quasi totalità dei + font supportati +o Incorporati i comandi per il logo di Ars TeXnica + +Modifiche nella versione 0.8.2 (2005/04/08) +o Aggiunto il file di configurazione esterno +o Nuovo comando: \DeclareGuITLogoCommand +o Alterato il colore di default + +Modifiche nella versione 0.8.1 (2004/11/15) +o Aggiunta l'indicazione dell'encoding da utilizzare nelle macro + \@guit@meeting@color@on e \@guit@meeting@color@off per evitare problemi + nel caso sia attivo un encoding diverso da quello di default + +Modifiche nella versione 0.8 (2004/10/28) +o Aggiunto un nuovo parametro opzionale a \GuIT per indicare l'utilizzo di + una famiglia di font diversa da quella corrente + +Modifiche nella versione 0.7.5 (2004/10/17) +o Ri-corrette le macro \@guit@meeting@color@on e \@guit@meeting@color@off + (sperando che questa sia la volta buona!) + +Modifiche nella versione 0.7.4 (2004/10/15) +o Corrette le macro \@guit@meeting@color@on e \@guit@meeting@color@off + +Modifiche nella versione 0.7.3 (2004/10/12) +o Apportati alcuni aggiustamenti ai coefficienti di traslazione delle + componenti del logo +o Nuova macro \GuITmeeting + +Modifiche nella versione 0.7.2 (mai rilasciata) +o Aggiornata la documentazione ed i riferimenti a xcolor +o Nuova macro \GuITforum + +Modifiche nella versione 0.7.1 (mai rilasciata) +o Semplificata la creazione di alcune macro interne + +Modifiche nella versione 0.7 (2003/10/17) +o Rimossi tutti gli usi del font Utopia dal file di test +o Integrato l'uso di hyperref: ora ogni occorrenza del logo può essere un + link a sito di GuIT +o Nuova macro \GuITurl per scrivere correttamente l'indirizzo del sito di + GuIT +o Modificata la semantica dell'opzione color per forzare la colorazione di + ogni occorrenza del logo + +Modifiche nella versione 0.6 (2003/09/16) +o Nel file di test la "rosetta" è stata trasformata in una coloratissima + spirale stiracchiata +o Nuova macro \swapGuITcommands +o Integrato l'uso opzionale di xcolor + +Modifiche nella versione 0.5 (2003/09/04) +o Aggiunta la gestione del colore per il logo + +Modifiche nella versione 0.4 (2003/07/15) +o Aggiunta una "rosetta" di GuIT al file di test +o Corretto il testo prodotto da \GuITtext + +Modifiche nella versione 0.3 (2003/06/12) +o Corretta la macro \@guitcmr + +Modifiche nella versione 0.2 (2003/02/21) +o Trasferito il copyright al Gruppo Utilizzatori Italiani di TeX +o Ampliato il file di test +o Nuova macro \GuITtext +o Corretti alcune stupide sviste + +Modifiche nella versione 0.1 (2003/02/15) +o Prima release del pacchetto + +------------------------------------------------------------------- + Copyright 2003, 2004, 2005, 2006, 2009, 2012, 2019 Gruppo Utilizzatori + Italiani di TeX + + This work may be distributed and/or modified under the + conditions of the LaTeX Project Public License, either + version 1.3a of this license or (at your option) any + later version. + The latest version of the license is in + https://www.latex-project.org/lppl.txt + + Author: Emanuele Vicentini + (emanuelevicentini at yahoo dot it) + + This work has the LPPL maintenance status "maintained". + + The Current Maintainer of this work is Emanuele Vicentini. + + This work consists of the files: README, guit.dtx, guit.ins and the + derived files guit.sty, guit.cfg and guittest.tex +------------------------------------------------------------------- + + + La distribuzione in questo archivio è composta da: +README (questo file) +guit.{dtx,ins} Sorgenti e file di installazione del pacchetto +guit.pdf La documentazione precompilata in PDF +guittest.pdf File di test precompilato in PDF + + + Per installare il pacchetto: +o eseguite: latex guit.ins (genererà guit.sty, guit.cfg ed il sorgente del + file di test) +o spostate guit.sty e guit.cfg dove la vostra installazione di LaTeX possa + trovarli (nel sottoalbero locale potrebbe essere in tex/latex/GuIT/) ed + aggiornate il database o l'analoga struttura dati usata dalla vostra + distribuzione di LaTeX (maggiori informazioni su https://www.guitex.org) + + Per rigenerare la documentazione: +o eseguite: latex guit.dtx (due volte) +o eseguite: makeindex -s gind.ist guit +o eseguite: makeindex -s gglo.ist -o guit.gls guit.glo +o eseguite: latex guit.dtx +o stampate guit.dvi per avere la documentazione del pacchetto + + Per rigenerare il file di test avrete bisogno dei pacchetti booktabs, +geometry, guit e rotating, oltre alla dotazione standard di font Type1 +fornita dal bundle PSNFSS. + + +8 luglio 2019 +Emanuele Vicentini +(emanuelevicentini at yahoo dot it) diff --git a/macros/latex/contrib/GuIT/GuITlogo/guit.dtx b/macros/latex/contrib/GuIT/GuITlogo/guit.dtx new file mode 100644 index 0000000000..91531dfd5b --- /dev/null +++ b/macros/latex/contrib/GuIT/GuITlogo/guit.dtx @@ -0,0 +1,1572 @@ +% \iffalse +% +% guit.dtx +% Copyright 2003, 2004, 2005, 2006, 2009, 2012, 2019 Gruppo Utilizzatori +% Italiani di TeX +% +% This work may be distributed and/or modified under the +% conditions of the LaTeX Project Public License, either +% version 1.3a of this license or (at your option) any +% later version. +% The latest version of the license is in +% https://www.latex-project.org/lppl.txt +% +% Author: Emanuele Vicentini +% (emanuelevicentini at yahoo dot it) +% +% This work has the LPPL maintenance status "maintained". +% +% The Current Maintainer of this work is Emanuele Vicentini. +% +% This work consists of the files: README, guit.dtx, guit.ins and the +% derived files guit.sty, guit.cfg and guittest.tex +% +%<*driver> +\documentclass[10pt, a4paper]{ltxdoc} +\usepackage[italian]{babel} +\usepackage{booktabs, guit, subfig, tabularx, hyperref, footnote} +\makesavenoteenv{table} +\EnableCrossrefs +\CodelineIndex +\RecordChanges +\OnlyDescription +\begin{document} + \DocInput{guit.dtx} +\end{document} +% +% +%<*test> +\documentclass[11pt, a4paper]{article} +\usepackage[margin=1in, noheadfoot]{geometry} +\usepackage{booktabs, guit, rotating, hyperref} + +\pagestyle{empty} +\setupguit[link] + +\begin{document} +\section*{Piccolo test per \guit} +Vediamo un po' come si comporta in una footnote\footnote{\guit~\guit\ldots +direi che \`e passabile, no?}. Diamoci\footnote{Un'altra nota: +\fontfamily{pzc}\fontseries{mb}\fontshape{it}\selectfont\guittext} dentro +con qualche cosa\footnote{Un ultima nota: Copyright 2003, 2004, 2005, 2006, +2009, 2012, 2019 \guittext} di ``strambo'': + +\begin{center} +\itshape\guit~agus \TeX~go br\'ach!\\ +$==$\\ +\rmfamily\bfseries\guit~and \TeX~forever! +\end{center} + +Una piccola ``spirale'' colorata e divertente: + +\begingroup +\setupGuIT[color=yes] +\GuITcolor[rgb]{1, 0, 0} +\newcount\wang +\newsavebox{\wangtext} +\newdimen\wangspace +\def\wheel#1{\savebox{\wangtext}{#1}% + \wangspace\wd\wangtext + \advance\wangspace by 1cm% + \centerline{% + \rule{0pt}{\wangspace}% + \rule[-\wangspace]{0pt}{\wangspace}% + \wang=-180 + \loop + \ifnum\wang<180 + \rlap{\begin{rotate}{\the\wang}% + \rule{0.75cm}{0pt}#1 + \end{rotate}}% + \advance\wang by 20 + \space + \guitcolor*{coloredelGuIT!90!green}% + \repeat}} +\wheel{\guit} +\endgroup + +Ed ora una tabella riepilogativa parziale dei font supportati dalla versione +attuale. + +\begin{center} +\begin{tabular}{lc} +\toprule +Font & Logo \\ +\midrule +Computer Modern Roman & \guit[family=cmr] \\ +Latin Modern & \guit[family=lmr] \\ +Times New Roman & \guit[family=ptm] \\ +Palatino & \guit[family=ppl] \\ +NewCentury Schoolbook & \guit[family=pnc] \\ +Charter & \guit[family=bch] \\ +Bookman & \guit[family=pbk] \\ +\bottomrule +\end{tabular} +\end{center} + +Per finire, un sfilza di \guit: + +\begingroup + \let\pippo\par + \makeatletter + \@tfor\famiglia:={cmr}{lmr}{ptm}{ppl}{pnc}{bch}{pbk}\do{% + \noindent + \setupGuIT[family=\famiglia] + \@tfor\dimensione:=\tiny\scriptsize\footnotesize\small\normalsize + \large\Large\LARGE\huge\do{% + \dimensione\guit~}% + \Huge\guit\pippo}% +\endgroup + +\begin{center} +\Huge Venite tutti al prossimo \guitmeeting[color] +\end{center} + +\end{document} +% +% \fi +% +% +% +% \CheckSum{544} +% +% \CharacterTable +% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z +% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z +% Digits \0\1\2\3\4\5\6\7\8\9 +% Exclamation \! Double quote \" Hash (number) \# +% Dollar \$ Percent \% Ampersand \& +% Acute accent \' Left paren \( Right paren \) +% Asterisk \* Plus \+ Comma \, +% Minus \- Point \. Solidus \/ +% Colon \: Semicolon \; Less than \< +% Equals \= Greater than \> Question mark \? +% Commercial at \@ Left bracket \[ Backslash \\ +% Right bracket \] Circumflex \^ Underscore \_ +% Grave accent \` Left brace \{ Vertical bar \| +% Right brace \} Tilde \~} +% +% +% +% \GetFileInfo{guit.sty} +% +% +% +% \newcommand*{\pacchetto}[1]{\textsf{#1}} +% \newcommand*{\altro}[1]{\texttt{#1}} +% +% +% +% \changes{v0.1}{2003/02/15}{Prima release pubblica del pacchetto} +% \changes{v0.2}{2003/02/21}{Arricchito il file di test del pacchetto} +% \changes{v0.5}{2003/09/04}{Aggiunta tutta la gestione del colore nel logo} +% \changes{v0.6}{2003/09/16}{Effettuate un paio di modifiche al file di +% test} +% \changes{v0.7}{2003/10/10}{Rimossi dal file di test gli usi del font +% Utopia} +% \changes{v0.7}{2003/10/13}{Integrato il pacchetto \pacchetto{hyperref} su +% richiesta di Fabiano Busdraghi} +% \changes{v0.7.2}{2004/09/16}{Aggiornata la documentazione riferentesi a +% \pacchetto{xcolor}} +% \changes{v0.7.2}{2004/09/16}{Personalizzati indice e change history} +% \changes{v0.7.3}{2004/10/11}{Alcune piccole modifiche al file di test} +% \changes{v0.8}{2004/10/28}{Riallineato il file di test all'ultima modifica +% della sintassi di \cs{GuIT}} +% \changes{v0.8.2}{2005/04/08}{Aggiunto il file di configurazione esterno} +% \changes{v0.9}{2005/11/21}{Modificata l'interfaccia in modo da fare ampio +% uso di chiavi definite tramite \pacchetto{xkeyval} (ora ricorda molto lo +% ``stile'' di Con\TeX t); mantenuta la compatibilit\`a quasi totale con +% le versioni precedenti, ma \cs{swapGuITcommands} \`e stato +% definitivamente rimosso} +% \changes{v0.9}{2005/11/27}{Il logo ora pu\`o essere composto anche usando +% la serie \altro{bx}} +% \changes{v0.9}{2005/12/03}{Nel file di test ora viene impostata +% globalmente la chiave \altro{link}} +% \changes{v1.0.0}{2012/11/03}{Aggiunto il supporto per Latin Modern} +% +% +% +% \title{Documentazione del pacchetto \pacchetto{guit}\thanks{Il numero di +% versione di questo file \`e \fileversion; l'ultima revisione \`e avvenuta +% in data \filedate.}} +% \author{Emanuele Vicentini\\(\texttt{emanuelevicentini at yahoo dot it})} +% \date{\filedate} +% +% +% +% \maketitle +% \begin{abstract} +% Questo piccolissimo pacchetto permette di riprodurre il logo del +% \emph{\guittext} (\emph{\guittexten}) in maniera sufficientemente +% indipendente dal font utilizzato, cercando di mantenerne l'aspetto +% originale. +% \end{abstract} +% \tableofcontents +% \clearpage +% +% +% +% \section{Introduzione} +% Questa documentazione \`e stata scritta seguendo le convenzioni +% dell'applicazione \LaTeX~\textsc{docstrip} che permette l'estrazione +% automatica del codice \LaTeX~dal file di documentazione~\cite{GOOSSENS94}. +% +% +% +% \iffalse\section{I logo}\fi +% +% +% +% \section{Il logo del Gruppo} +% Per riprodurre il pi\`u fedelmente possibile il logo del \guit~ho deciso +% che la soluzione migliore per ottenere gli effetti desiderati fosse quella +% di utilizzare solo font con Caps \& Small Caps. I font attualmente +% supportati\footnote{Il font Utopia non \`e presente in tutte le +% distribuzioni di \TeX/\LaTeX~per motivi legali e non \`e pi\`u considerato +% un componente fondamentale, quindi nel file di esempio che accompagna +% questo pacchetto il font Utopia non \`e stato utilizzato. Se qualche +% persona volenterosa potesse controllare i coefficienti utilizzati per +% questo font e volesse contribuire con i coefficienti per usare Utopia con +% la serie \altro{bx}, sarebbe sempre ben accetta.} sono elencati nella +% tabella~\ref{tab:font}. +% +% \begin{table}[!h] +% \centering +% \begin{tabular}{l>{\ttfamily}cc>{\scshape}c} +% \toprule +% \itshape Font & \normalfont\itshape Famiglia & \itshape Bx & \itshape Provenienza \\ +% \midrule +% Computer Modern Roman & cmr & No & \normalfont Standard \\ +% Latin Modern & lmr & S\`\i\footnote{In realt\`a viene usata solo la serie \altro{m}.} & lm \\ +% Times & ptm & S\`\i & psnfss \\ +% Palatino & ppl & S\`\i & psnfss \\ +% New Century Schoolbook & pnc & S\`\i & psnfss \\ +% Utopia & put & S\`\i\footnote{In realt\`a viene usata solo la serie \altro{m}.} & psnfss \\ +% Charter & bch & S\`\i & psnfss \\ +% Bookman & pbk & S\`\i & psnfss \\ +% \bottomrule +% \end{tabular} +% \caption{Font attualmente supportati} +% \label{tab:font} +% \end{table} +% +% Per evitare spiacevoli ed inaspettati effetti dovuti a combinazioni dei +% parametri \textsc{nfss2} indicanti font inesistenti nella famiglia +% Computer Modern originale (esempio: \altro{OT1/cmr/bx/sc} non esiste e +% viene sostituito automaticamente con \altro{OT1/cmr/bx/n}), tutte le +% occorrenze del logo composte con la famiglia Computer Roman usano il font +% \altro{OT1/cmr/m/sc}. Le altre famiglie, laddove esista il font +% appropriato, possono essere utilizzate anche con serie e codifiche +% diverse, ma questo pacchetto fornisce solo le istanze preconfezionate per +% le serie \altro{m} e \altro{bx}. Il pacchetto \`e stato testato solo con +% le codifiche \altro{OT1} e \altro{T1}; conferme riguardanti il corretto +% utilizzo del pacchetto con codifiche diverse saranno sicuramente +% benvenute. +% +% L'idea di utilizzare la codifica \altro{T1} per la famiglia Computer +% Modern (perch\'e esiste il font \altro{T1/cmr/bx/sc}) \`e stata scartata a +% priori perch\'e i font in formato Type1 di tale famiglia non sono ancora, +% a mio parere, sufficientemente diffusi. +% +% +% +% \section{Il logo del convegno} +% Per cercare di alleviare parte del lavoro degli organizzatori, ho cercato +% di riprodurre, per quanto mi \`e possibile, il logo del convegno periodico +% del \guittext\ usato a partire dal meeting svoltosi a Pisa il 10 ottobre +% 2004. +% +% Il logo producibile da questo pacchetto, esemplificato nella +% figura~\ref{fig:guitmeeting}, \`e il risultato di un gran numero di +% tentativi di riprodurre correttamente quello originariamente utilizzato +% per il poster-programma del meeting di quell'anno. Per questa ragione, il +% logo viene sempre composto usando la famiglia Computer Modern, +% indipendentemente dalla famiglia principale usata nel documento. +% +% Come molti processi automatici, anche questo non \`e perfetto. Si +% accettano molto volentieri suggerimenti per migliorarlo (possibilmente in +% forma di codice gi\`a funzionante o patch per l'ultima versione di questo +% pacchetto). +% +% \begin{figure} +% \centering +% \Huge\guitmeeting\qquad\guitmeeting[year=2010]\\[10pt] +% \guitmeeting[style=inline]\quad\guitmeeting[year=2010, style=inline] +% \caption{Visione d'insieme del logo del convegno periodico} +% \label{fig:guitmeeting} +% \end{figure} +% +% +% +% \section{Il logo della rivista} +% A partire dall'aprile del 2006, il \guittext realizza una rivista dedicata +% a \TeX, \LaTeX\ e la tipografia digitale; maggiori informazioni sono +% reperibili nelle pagine dedicate del sito del Gruppo: +% \guiturl[document=home/it/arstexnica]. Nella figura~\ref{fig:arstexnica} sono +% raccolte diverse istanze e varianti del logo di \Ars\ ed i comandi +% correlati, la cui ideazione e realizzazione sono dovute a Massimo +% Caschili. +% +% \makeatletter +% \newcommand*{\loghetto}[2][1]{% +% \subfloat[\cs{#2}]{\scalebox{#1}{\csname #2\endcsname}}} +% \makeatother +% \begin{figure} +% \centering\Huge +% \loghetto[2]{Ars}\qquad +% \loghetto[2]{Arsob}\\ +% \loghetto[2]{ars}\qquad +% \loghetto[2]{tecnica}\\ +% \loghetto[2]{arsta}\qquad +% \loghetto[2]{arstb}\\ +% \loghetto[2]{arstv}\qquad +% \loghetto[2]{arsto}\\ +% \loghetto[2]{Arsto} +% \caption{Il logo della rivista e le sue varianti}\label{fig:arstexnica} +% \end{figure} +% +% +% +% \section{Comandi} +% +% +% +% \subsection{Il logo del Gruppo} +% \changes{v0.8}{2004/10/28}{Ristrutturata l'implementazione di \cs{GuIT} +% per l'aggiunta dell'argomento opzionale per indicare la famiglia di font +% da utilizzare} +% \DescribeMacro{\GuIT}\oarg{famiglia, keywords}\newline +% \DescribeMacro{\GuIT*}\oarg{famiglia, keywords}\newline +% \DescribeMacro{\guit}\oarg{famiglia, keywords}\newline +% \DescribeMacro{\guit*}\oarg{famiglia, keywords}\newline +% Per riprodurre il logo di \guit~l'utente ha a disposizione il comando +% \cs{GuIT} che si prende cura di controllare la famiglia di font utilizzata +% e cerca di produrre il risultato migliore. Anche se \`e tecnicamente +% errato, per comodit\`a l'utente pu\`o usare anche l'equivalente forma +% \cs{guit}. Entrambi i comandi dispongono di una versione ``stellata'' che +% riproduce il logo con uno schema di colori simile a quello usato nel sito +% di \guit~(\guiturl). +% +% Desidero richiamare l'attenzione sul fatto che in molti casi non \`e +% possibile giungere al risultato \emph{perfetto} in quanto le grazie della +% G e della U non sono necessariamente sovrapponibili senza +% ``sbavature''. Questi difetti non sono eliminabili, ma \`e stato fatto il +% possibile per minimizzarli. +% +% Il font utilizzato per comporre il logo \`e, normalmente, il font attivo +% nel punto in cui compare l'occorrenza di \cs{GuIT}, ma pu\`o essere +% modificato utilizzando gli argomenti opzionali nei seguenti modi: +% +% \begin{itemize} +% \item indicando direttamente il nome della famiglia di font da utilizzare +% (esempio: \cs{GuIT[ppl]}); +% \item indicando direttamente il nome della famiglia e della serie da +% utilizzare separati dal carattere ``\altro{/}'' (esempio: +% \cs{GuIT[ppl/bx]}); +% \item assegnando alla chiave |family| (vedere \S\ref{sec:keywords}) il +% nome della famiglia di font da utilizzare (esempio: +% \cs{GuIT[family=ppl]}); +% \item assegnando alla chiave |series| (vedere \S\ref{sec:keywords}) il +% nome di una serie da utilizzare (esempio: \cs{GuIT[series=bx]}). +% \end{itemize} +% +% Ovviamente, in tutti questi casi il font indicato viene utilizzato solo se +% \`e presente nella lista di quelli supportati dal pacchetto, altrimenti si +% ricade sul classico Computer Modern Roman. Gli effetti di queste +% alterazioni sono limitati alla singola occorrenza di \cs{GuIT} nella quale +% compaiono. +% +% +% +% \subsection{Selezione del colore} +% Con entrambi i seguenti comandi \`e possibile usare le espressioni +% ``estese'' fornite dal pacchetto \pacchetto{xcolor}~\cite{Kern05}. +% +% \medskip +% +% \noindent\DescribeMacro{\GuITcolor}\oarg{modello}\marg{dichiarazione}\newline +% \DescribeMacro{\guitcolor}\oarg{modello}\marg{dichiarazione}\newline +% Il colore utilizzato da \cs{GuIT*} e da \cs{guit*} pu\`o essere modificato +% con questo comando. Se l'argomento opzionale viene omesso si assume l'uso +% del modello \emph{cmyk}. Il colore definito in questo modo \`e accessibile +% con il nome \altro{coloredelGuIT}. +% +% \medskip +% +% \noindent\DescribeMacro{\GuITcolor*}\oarg{modello}\marg{espressione xcolor}\newline +% \DescribeMacro{\guitcolor*}\oarg{modello}\marg{espressione xcolor}\newline +% Questo comando permette di operare sul colore utilizzato da \cs{GuIT*} +% utilizzando le espressioni supportate dal comando \cs{colorlet}; per una +% discussione pi\`u ampia e dettagliata si rimanda alla documentazione del +% pacchetto \pacchetto{xcolor}. \cs{GuITcolor*} agisce implicitamente su +% \altro{coloredelGuIT}, quindi \`e essenzialmente equivalente a +% \begin{quote} +% |\colorlet{coloredelGuIT}|\marg{espressione xcolor} +% \end{quote} +% L'argomento opzionale specifica il modello di colore in cui +% \meta{espressione xcolor} deve essere trasformata prima dell'applicazione +% a \altro{coloredelGuIT}. +% +% In entrambi i casi, si sconsiglia l'uso del modello \emph{named}. Come per +% il comando \cs{GuIT} anche in questo caso si possono usare le equivalenti +% forme \cs{guitcolor} e \cs{guitcolor*}. +% +% +% +% \subsection{Dicitura completa del Gruppo} +% \changes{v0.2}{2003/02/17}{Aggiunti due nuovi comandi per indicare la +% denominazione completa del \guittext} +% \DescribeMacro{\GuITtext}\oarg{keywords}\newline +% \DescribeMacro{\guittext}\oarg{keywords}\newline +% Per evitare errori nel riportare la denominazione ufficiale e completa del +% Gruppo (\guittext) l'utente pu\`o utilizzare il comando \cs{GuITtext} che +% fornisce l'espansione corretta dell'acronimo \guit: \guittext. Notate che +% il comando non effettua alcuna modifica al font ed al colore attualmente +% in uso e non assume l'uso di alcun font particolare. Come per il comando +% \cs{GuIT} anche in questo caso si pu\`o usare l'equivalente forma +% \cs{guittext}. +% +% \medskip +% +% \changes{v0.9}{2005/10/29}{Aggiunti due nuovi comandi per indicare la +% denominazione completa anglicizzata del \guittext\ (o \guittexten\ che +% dir si voglia) su espressa richiesta di Gustavo Cevolani} +% \noindent\DescribeMacro{\GuITtextEn}\oarg{keywords}\newline +% \DescribeMacro{\guittexten}\oarg{keywords}\newline +% I comandi appena illustrati hanno la loro controparte in \cs{GuITtextEn} e +% nell'immancabile \cs{guittexten}, i quali si comportano esattamente nello +% stesso modo per quanto riguarda font e colori, ma producono l'equivalente +% inglese di \guittext: \guittexten. +% +% Per quanto riguarda l'argomento opzionale \meta{keywords}, vedere +% \S\ref{sec:keywords}. +% +% +% +% \subsection{Indirizzo del sito internet e del forum pubblico} +% \DescribeMacro{\GuITurl}\oarg{keywords}\newline +% \DescribeMacro{\guiturl}\oarg{keywords}\newline +% Per evitare errori nel riportare l'indirizzo completo del sito internet +% del Gruppo (\guiturl) l'utente pu\`o utilizzare il comando \cs{GuITurl} +% che scrive l'indirizzo corretto sfruttando il pacchetto \pacchetto{url} +% presente nella dotazione standard di qualunque distribuzione di +% \TeX\,/\LaTeX. Come per il comando \cs{GuIT} anche in questo caso si pu\`o +% utilizzare l'equivalente forma \cs{guiturl}. +% +% \medskip +% +% \noindent\DescribeMacro{\GuITforum}\oarg{keywords}\newline +% \DescribeMacro{\guitforum}\oarg{keywords}\newline +% Questo comando permette l'inserimento dell'indirizzo completo del forum +% pubblico (\guitforum), sfruttando nuovamente il pacchetto \pacchetto{url}. +% Come per il comando \cs{GuIT} anche in questo caso si pu\`o utilizzare +% l'equivalente forma \cs{guitforum}. +% +% Desidero richiamare l'attenzione sul comportamento di alcuni programmi di +% visualizzazione di documenti in formato \textsc{pdf}, i quali analizzano +% il testo dei documenti alla ricerca di elementi che rispecchino la +% struttura di un \textsc{url} ed interpretano automaticamente tali elementi +% come link realmente funzionanti. Questo fatto non \`e alterabile tramite +% comandi od altri costrutti di \LaTeX, quindi, se doveste riscontrare +% ``anomalie'' negli effetti dei due comandi appena illustrati, esaminate la +% configurazione del programma che usate ed eventualmente alteratela di +% conseguenza. +% +% Per quanto riguarda l'argomento opzionale \meta{keywords}, vedere +% \S\ref{sec:keywords}. +% +% +% +% \subsection{Il logo del convegno} +% \DescribeMacro{\GuITmeeting}\oarg{keywords}\newline +% \DescribeMacro{\GuITmeeting*}\oarg{keywords}\newline +% \DescribeMacro{\guitmeeting}\oarg{keywords}\newline +% \DescribeMacro{\guitmeeting*}\oarg{keywords}\newline +% Per riprodurre il logo del periodico convegno l'utente ha a disposizione +% il comando \cs{GuITmeeting}; trattandosi di un'entit\`a grafica +% particolare, non \`e possibile alcuna personalizzazione del risultato ad +% eccezione dello schema di colori. Come per gli altri comandi, anche in +% questo caso si pu\`o utilizzare l'equivalente forma \cs{guitmeeting}. +% Entrambi i comandi dispongono di una versione ``stellata'' che +% riproduce il logo a colori con uno schema di colori simile a quello usato +% nel sito di \guit~(\guiturl). +% +% Per quanto riguarda l'argomento opzionale \meta{keywords}, vedere +% \S\ref{sec:keywords}. +% +% +% +% \subsection{Il logo della rivista} +% \changes{v0.9}{2006/05/17}{Inglobati i comandi per generare i logo della +% rivista ideati da Massimo Caschili} +% I comandi per riprodurre le diverse istanze e varianti del logo della +% rivista sono illustrati direttamente nella +% figura~\ref{fig:arstexnica}; questi comandi non hanno alcun +% parametro. L'autore ed ideatore dei comandi, per conto del \guittext, \`e +% Massimo Caschili. +% +% +% +% \subsection{Usare le chiavi}\label{sec:keywords} +% Il pacchetto fa ampio uso di chiavi, definite tramite +% \pacchetto{xkeyval}~\cite{Adriaens05}, in modo da rendere l'utilizzo dei +% vari comandi pi\`u flessibile. Applicare una chiave ad uno dei comandi +% visti in precedenza pu\`o potenzialmente modificare la relativa +% caratteristica \emph{solo ed esclusivamente per quell'istanza del +% comando}. +% +% \begin{table} +% \centering +% \begin{tabularx}{0.91\textwidth}{ll>{\raggedright\arraybackslash}X} +% \toprule +% \itshape Chiave & \itshape Valori & \itshape Applicabilit\`a \\ +% \midrule +% color & \textit{yes}, true, no, false & \cs{GuIT}, \cs{GuITmeeting} \\ +% link & \textit{yes}, true, no, false & \cs{GuIT}, \cs{GuITmeeting}, \cs{GuITtext}, \cs{GuITtextEn}, \cs{GuITurl}, \cs{GuITforum} \\ +% family & \meta{famiglia} & \cs{GuIT} \\ +% series & \meta{serie} & \cs{GuIT} \\ +% url & \meta{indirizzo} & \cs{GuIT}, \cs{GuITmeeting}, \cs{GuITtext}, \cs{GuITtextEn}, \cs{GuITurl}, \cs{GuITforum} \\ +% document & \meta{documento} & \cs{GuITurl} \\ +% year & \meta{anno} & \cs{GuITmeeting} \\ +% style & display, inline & \cs{GuITmeeting} \\ +% \bottomrule +% \end{tabularx} +% \caption{Chiavi definite dal pacchetto \pacchetto{guit}} +% \label{tab:keywords} +% \end{table} +% +% Le chiavi attualmente definite sono riportate nella +% tabella~\ref{tab:keywords} assieme ai valori che possono assumere e ad +% un'indicazione dei comandi sui quali hanno un qualche effetto. I valori in +% corsivo sono i valori di default assegnati implicitamente alle chiavi +% corrispondenti se quest'ultime vengono usate senza indicare esplicitamente +% alcun valore. +% +% Alcune annotazioni sulle chiavi: +% +% \begin{description} +% \item[|color|] permette di controllare l'uso del colore per il logo del +% Gruppo; da notare che sono possibili combinazioni ``strane'' come +% |\GuIT*[color=no]|, la quale, nonostante l'utilizzo della versione +% ``stellata'', produrr\`a un'istanza del logo non colorata; +% \item[|link|] permette di controllare la generazione di un link alla +% pagina principale del sito del \guit\ in corrispondenza di ogni +% occorrenza del logo e dell'espansione della dicitura completa del Gruppo +% tramite l'uso di \pacchetto{hyperref}, \emph{che deve essere caricato +% esplicitamente} nel preambolo del documento; come effetto collaterale, i +% prodotti di \cs{GuITurl} e \cs{GuITforum} diventano automaticamente +% \textsc{url} realmente funzionanti; +% \item[|family|] \`e un modo pi\`u esplicito e prolisso di impostare il +% font con il quale viene composto il logo del Gruppo; assegnare a questa +% chiave un valore nullo fa si che il font utilizzato per comporre il logo +% di \guit\ sia quello attivo nel punto in cui compare il comando +% \cs{GuIT}; +% \item[|series|] permette di impostare la serie con la quale viene composto +% il logo del Gruppo; assegnare a questa chiave un valore nullo fa si che +% la serie utilizzata per comporre il logo sia quella attiva nel punto in +% cui compare il comando \cs{GuIT}; +% \item[|url|] permette di definire od alterare l'indirizzo del sito +% internet del Gruppo usato dai vari comandi che producono testo o link al +% sito stesso; assegnare a questa chiave un valore nullo sopprimer\`a +% l'output di \cs{GuITurl} e disabiliter\`a la creazione di link da parte +% di \pacchetto{hyperref}; +% \item[|document|] permette di indicare pagine o sezioni del sito del +% Gruppo facendo in modo che il risultato si comporti in maniera +% automatica esattamente come \cs{GuITurl} per quanto riguarda +% l'interazione con \pacchetto{hyperref} e la creazione di link; assegnare +% a questa chiave un valore nullo disabilita la visualizzazione di +% quest'estensione dell'indirizzo; +% \item[|year|] permette di impostare l'anno che comparir\`a nel logo del +% convegno periodico in una posizione simile a quella in cui compare nei +% poster, accanto all'illustrazione realizzata per il Gruppo da Duane +% Bibby\footnote{Se gi\`a si poteva sconsigliare l'uso di \cs{GuITmeeting} +% all'interno di un paragrafo o di un qualsiasi altro blocco di testo, +% l'aggiunta dell'anno crea un'entit\`a decisamente ingombrante e porta a +% rafforzare il consiglio: \emph{non usate \cs{GuITmeeting} all'interno di +% un blocco di testo}.}; assegnare a questa chiave un valore nullo +% disabilita la visualizzazione dell'anno; +% \item[|style|] permette di modificare l'aspetto del logo del convegno +% alterando il modo nel quale vengono assemblati i sui componenti: i primi +% due esempi che compaiono in figura~\ref{fig:guitmeeting} sono composti +% con |style=display|, gli ultimi due con +% |style=inline|\footnote{L'aspetto del logo prodotto da |inline| potrebbe +% non essere molto stabile e subire drastiche variazioni nelle prossime +% versioni del pacchetto.}. +% \end{description} +% +% Non \`e strettamente necessario attenersi alle indicazioni d'uso delle +% chiavi riportate nella tabella~\ref{tab:keywords} ed \`e quindi possibile +% utilizzarle liberamente, con l'avvertenza che le chiavi i cui effetti non +% sono applicabili al comando di cui sono argomento non produrranno alcun +% risultato mentre tutte le altre avranno effetto solo su quella particolare +% istanza del comando a cui sono legate. +% +% \medskip +% +% \changes{v0.9}{2005/10/29}{Aggiunto un nuovo comando per gestire in +% maniera ``globale'' le chiavi} +% \noindent\DescribeMacro{\setupGuIT}\oarg{keywords}\newline +% \DescribeMacro{\setupguit}\oarg{keywords}\newline +% Oltre ad essere utilizzabili direttamente nei comandi indicati in +% precedenza, tutte le chiavi appena illustrate possono essere usate come +% argomenti di \cs{setupGuIT}, che provveder\`a ad elaborarle e ad +% applicarne gli effetti \emph{a tutto ci\`o che segue, tenendo conto delle +% normali regole di scoping}. +% +% Utilizzare questo comando senza alcun argomento equivale a disabilitare +% l'utilizzo del colore e la generazione dei link, ad impostare il font +% usato per il logo a quello attivo in quel punto del documento, ad +% impostare l'indirizzo del sito internet del Gruppo a quello attuale, a +% disabilitare la visualizzazione del documento che estente \cs{GuITurl} e +% dell'anno e ad impostare lo stile |display| per \cs{GuITmeeting}. +% +% Giova rimarcare la differenza tra l'applicazione delle chiavi a +% \cs{setupGuIT} ed agli altri comandi: +% +% \begin{itemize} +% \item l'esecuzione di un'istanza di \cs{setupGuIT} ha effetto \emph{su +% tutti i comandi di questo pacchetto fino al termine del documento o del +% pi\`u piccolo gruppo che lo contiene}; +% \item applicare una chiave ad un qualsiasi altro comando di questo +% pacchetto pu\`o potenzialmente produrre un qualche effetto +% \emph{solamente su quella particolare istanza di quel particolare +% comando}. +% \end{itemize} +% +% +% +% \subsection{Creare nuove realizzazioni del logo del Gruppo} +% \DescribeMacro{\DeclareGuITLogoCommand}\marg{famiglia}\oarg{serie}\marg{u-h}\marg{u-v}\marg{i-h}\marg{t-h}\newline +% Il numero di font supportati da questa versione del pacchetto non \`e +% molto alto; per gli utenti desiderosi di usare font non previsti +% dall'autore, \`e disponibile il comando \cs{DeclareGuITLogoCommand}, +% utilizzabile solo nel preambolo del documento o nel file di configurazione +% \altro{guit.cfg}. +% +% Tenendo ben presente che sia la \meta{famiglia} tanto quanto la +% \meta{serie} sono da considerarsi nell'accezione tipica dei termini del +% sistema \emph{NFSS2}, i sei parametri rappresentano: +% +% \begin{enumerate} +% \item il nome della famiglia di font; +% \item la serie (valore di default: \altro{m}, cio\`e il tradizionale +% valore di \cs{mddefault}); +% \item lo scartamento orizzontale della \emph{u}; +% \item lo scartamento verticale della \emph{u}; +% \item lo scartamento orizzontale della \emph{i}; +% \item lo scartamento orizzontale della \emph{t}. +% \end{enumerate} +% +% Valori negativi degli ultimi quattro parametri indicano spostamenti verso +% sinistra o, dove applicabile, verso l'alto; valori positivi indicano, +% ovviamente, spostamenti nelle direzioni opposte. Usando +% \cs{DeclareGuITLogoCommand} \`e possibile ridefinire le realizzazioni del +% logo fornite dalla versione attuale del pacchetto, con l'unica eccezione +% del logo composto con la famiglia Computer Modern\footnote{Un eventuale +% tentativo di ridefinizione avrebbe conseguenze deleterie sul risultato +% finale.}. +% +% \medskip +% +% \noindent\DescribeMacro{\AliasGuITLogoCommand}\marg{fam1}\marg{ser1}\marg{fam2}\marg{ser2}\newline +% Per evitare che il pacchetto utilizzi il font Computer Modern Roman in +% sostituzione di un font non supportato, \`e possibile creare un alias per +% la particolare combinazione inesistente di famiglia e serie. I primi due +% argomenti rappresentano la famiglia e la serie che devono essere +% rappresentate dal font identificato dagli ultimi due parametri e per il +% quale \emph{deve} essere gi\`a stata creata un'istanza del logo (tramite +% \cs{DeclareGuITLogoCommand} oppure tramite un altro alias). +% +% A titolo d'esempio, la definizione per il font Utopia, serie \altro{bx}, +% \`e attualmente un alias creato in questo modo: +% \begin{quote} +% |\AliasGuITLogoCommand{put}{bx}{put}{m}| +% \end{quote} +% +% +% +% \section{Configurazione}\label{sec:config} +% Il pacchetto \`e corredato di un piccolo file di configurazione, +% \altro{guit.cfg}, nel quale l'utente pu\`o impostare un colore di default +% per il logo diverso dall'originale, definire nuove realizzazioni del logo +% o ridefinire quelle esistenti. +% +% Il file cos\`{\i} come viene distribuito \`e praticamente vuoto, in quanto +% tutte le dichiarazioni utili sono state commentate perch\'e riprendono +% semplicemente quanto gi\`a definito nel codice del pacchetto e servono +% unicamente da esempio. +% +% +% +% \section{Opzioni} +% Il pacchetto ha tre opzioni, ma il loro uso \`e sconsigliato a favore del +% comando \cs{setupGuIT}, che permette una maggiore flessibilit\`a: +% +% \begin{description} +% \item[color] forza la colorazione di tutte le occorrenze del logo, +% indipendentemente dalla forma del comando usata; \emph{prestate bene +% attenzione al fatto che il significato di quest'opzione \`e +% radicalmente cambiato rispetto alle versioni precedenti alla 0.7 e +% che l'uso di \cs{setupGuIT} pu\`o annullarne l'effetto}; +% \item[nocolor] disattiva il supporto del colore; quando viene specificata +% quest'opzione \cs{GuIT*} e \cs{guit*} producono gli stessi risultati +% di \cs{GuIT}, cio\`e il colore del logo non viene alterato in alcun +% modo; \emph{prestate bene attenzione al fatto che a partire dalla +% versione 0.9 l'uso di \cs{setupGuIT} pu\`o annullare l'effetto di +% quest'opzione}; +% \item[link] abilita l'uso di \pacchetto{hyperref}, \emph{che deve essere +% caricato esplicitamente} nel preambolo del documento) per trasformare ogni +% occorrenza del logo del Gruppo e dell'espansione della dicitura +% completa in un link al sito di \guit; prestate attenzione al fatto +% che l'aspetto del logo \emph{non muta} minimamente; inoltre, come effetto +% collaterale dell'uso di \pacchetto{hyperref}, \cs{GuITurl} diventa +% automaticamente un link al sito internet di \guit; \emph{prestate +% bene attenzione al fatto che a partire dalla versione 0.9 l'uso di +% \cs{setupGuIT} pu\`o annullare l'effetto di quest'opzione}. +% \end{description} +% +% +% +% \section{Dipendenze da altri pacchetti} +% La lista dei pacchetti da cui questo codice dipende \`e, per ora, molto +% breve e si tratta di pacchetti fondamentali oppure estremamente comuni: +% +% \begin{itemize} +% \item \pacchetto{hyperref}; +% \item \pacchetto{graphics}; +% \item \pacchetto{url}; +% \item \pacchetto{xcolor}, versione 2.00 o successive; +% \item \pacchetto{xkeyval}, versione 2.5 o successive. +% \end{itemize} +% +% \pacchetto{hyperref} non viene pi\`u caricato automaticamente a partire +% dalla versione 0.9.1. +% +% Ad accezione di \pacchetto{url}, tutti gli altri pacchetti vengono +% caricati senza indicare esplicitamente alcuna opzione, ma questo non +% significa che ci\`o non possa causarvi problemi: laddove \`e perfettamente +% lecito tentare di caricare due o pi\`u volte lo stesso pacchetto \emph{con +% le stesse opzioni}, non \`e possibile farlo cambiando le opzioni, quindi +% il codice seguente \`e errato: +% +% \begin{verbatim} +% % ... +% \usepackage{graphics} +% \usepackage[draft]{graphics} +% % ... +% \end{verbatim} +% +% Per semplificare al massimo il problema, se doveste incontrare messaggi +% d'errore che menzionano i pacchetti elencati in precedenza alterate +% l'ordine di caricamento dei pacchetti nel vostro documento in modo che +% questo pacchetto si trovi dopo quello indicato dai messaggi. +% +% +% +% \StopEventually{% +% \bibliographystyle{alpha} +% \begin{thebibliography}{GMS94} +% \addcontentsline{toc}{section}{\refname} +% \bibitem[Adr05]{Adriaens05} Hendri Adriaens, \emph{The +% \pacchetto{xkeyval} package}, v2.5e, 2005/11/25 (disponibile presso +% \textsc{ctan} in \url{macros/latex/contrib/xkeyval}). +% \bibitem[GMS94]{GOOSSENS94} Michel Goossens, Frank Mittelbach e Alexander +% Samarin. \emph{The \LaTeX\ Companion}. Addison-Wesley Company, 1994. +% \bibitem[Ker05]{Kern05} Dr.~Uwe Kern, \emph{Extending \LaTeX's color +% facilities: the \pacchetto{xcolor} package}, v2.09, 2005/12/21 +% (disponibile presso \textsc{ctan} in +% \url{macros/latex/contrib/xcolor}). +% \bibitem[Knu86]{CMT} Donal E. Knuth. \emph{Computer Modern Typefaces}, +% volume E di \emph{Computer \& Typesetting}. Addison-Wesley +% Publishing, 1986. +% \end{thebibliography}} +% +% +% +% \section{Il codice} +% +% +% +% \subsection{Il pacchetto} +% \changes{v0.2}{2003/02/17}{Corretti un paio di errori nel codice} +% \changes{v0.9}{2005/11/19}{I pacchetti \pacchetto{xcolor} e +% \pacchetto{hyperref} vengono ora caricati di default; \pacchetto{color} +% \`e stato definitivamente rimosso} +% \changes{v0.9.1}{2009/07/31}{\pacchetto{hyperref} non viene pi\`u caricato +% automaticamente; suggerimento e codice di Enrico Gregorio} +% \changes{v1.0.0}{2019/07/08}{\pacchetto{url} viene caricato con l'opzione +% \altro{hyphens}} +% Richiediamo espressamente l'uso di \LaTeXe, ci annunciamo al mondo e +% carichiamo tutti i pacchetti necessari. +% \begin{macrocode} +%<*style> +\NeedsTeXFormat{LaTeX2e} +\ProvidesPackage{guit}[2019/07/08 v1.0.0-alpha.3 Logo del GuIT] +\RequirePackage{graphics} +\RequirePackage[hyphens]{url} +\RequirePackage{xcolor}[2004/07/04] +\RequirePackage{xkeyval}[2005/05/07] +% \end{macrocode} +% +% \changes{v0.7}{2003/10/17}{Modificata la semantica di \altro{color}: ora +% forza la colorazione di tutte le occorrenze del logo} +% \changes{v0.9}{2005/11/21}{Semplificata la gestione delle opzioni} +% Le tre opzioni che il pacchetto presentava fino alla versione 0.8.2 sono +% da considerarsi obsolete, ma il loro effetto \`e, almeno parzialmente, +% ancora onorato. +% \begin{macrocode} +\newif\if@guit@colorized +\newif\if@guit@link +\DeclareOption{color}{\AtEndOfPackage{\setupGuIT[color=yes]}} +\DeclareOption{nocolor}{\AtEndOfPackage{\setupGuIT[color=no]}} +\DeclareOption{link}{\AtEndOfPackage{\setupGuIT[link=yes]}} +\ProcessOptions\relax +% \end{macrocode} +% +% \begin{macro}{\setupGuIT} +% \changes{v0.9.2}{2012/08/17}{Aggiornato l'indirizzo del sito internet} +% \changes{v1.0.0}{2012/08/17}{Aggiornato l'indirizzo del sito internet} +% \begin{macro}{\setupguit} +% Il comando per gestire le varie chiavi \`e un semplice wrapper alla macro +% \cs{setkeys*} (ho optato per usare questa macro in quanto non genera alcun +% messaggio d'errore se le chiavi che riceve in input non esistono nella +% famiglia sotto esame). +% \begin{macrocode} +\DeclareRobustCommand{\setupGuIT}[1][color=no, link=no, family=, series=, url=https://www.guitex.org, document=, year=, style=display]{% + \setkeys*{guit}{#1}% + \ignorespaces} +\let\setupguit\setupGuIT +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% Alcune delle chiavi usate nel codice vengono definite qui, altre sono +% definite durante la generazione delle macro interne che si occupano di +% comporre il logo (vedere pagina~\pageref{p:fntcmd}). +% \begin{macrocode} +\define@choicekey*{guit}{color}[\val\nr]{yes,true,no,false}[yes]{% + \ifcase\nr\relax + \@guit@colorizedtrue + \or + \@guit@colorizedtrue + \or + \@guit@colorizedfalse + \or + \@guit@colorizedfalse + \fi} +\define@choicekey*{guit}{link}[\val\nr]{yes,true,no,false}[yes]{% + \ifcase\nr\relax + \@guit@linktrue + \or + \@guit@linktrue + \or + \@guit@linkfalse + \or + \@guit@linkfalse + \fi} +\define@key{guit}{family}{\def\@guit@family{#1}} +\define@key{guit}{series}{\def\@guit@series{#1}} +% \end{macrocode} +% +% Il caricamento automatico di \pacchetto{hyperref} ha causato qualche +% problema, quindi a partire dalla versione 0.9.1 \`e stato rimosso. Di +% seguito viene effettuato il controllo sul fatto che il pacchetto sia stato +% caricato esplicitamente dall'utente. +% \begin{macrocode} +\def\@if@guit@link@or@hyperref#1#2{% + \if@guit@link + \@if@guit@hyperrefloaded{#1}{#2}% + \else + #2% + \fi} +\AtBeginDocument{% + \@ifpackageloaded{hyperref} + {\let\@if@guit@hyperrefloaded\@firstoftwo} + {\let\@if@guit@hyperrefloaded\@secondoftwo}} +% \end{macrocode} +% +% \begin{macro}{\GuITcolor} +% \changes{v0.6}{2003/09/16}{Esteso con una versione ``stellata'' che +% beneficia delle funzionalit\`a di \pacchetto{xcolor}} +% \changes{v0.7}{2003/09/26}{Trasformato in un comando \emph{robusto} (mea +% culpa)} +% \changes{v0.8.2}{2005/04/08}{Modificata la dichiarazione del colore di +% default} +% \changes{v0.9}{2005/11/19}{Eliminate le definizioni riguardanti +% esclusivamente \pacchetto{color}} +% \begin{macro}{\guitcolor} +% Procediamo alla definizione di un nuovo comando per alterare il colore +% utilizzato da \cs{GuIT*} e \cs{guit*}. Definiamo anche il colore +% utilizzato di default. +% \begin{macrocode} +\DeclareRobustCommand*{\GuITcolor}{% + \@ifstar\x@guit@color@imp\@guit@color@imp} +% \end{macrocode} +% Teniamo conto della presenza delle estensioni fornite dal pacchetto +% \pacchetto{xcolor} e realizziamo le implementazioni del comando +% precedente\footnote{In realt\`a, quel \cs{definecolor} proviene da +% \pacchetto{xcolor}, versione 2.00 o successiva}. +% \begin{macrocode} +\newcommand*{\@guit@color@imp}[2][cmyk]{% + \definecolor{coloredelGuIT}{#1}{#2}} +\newcommand*{\x@guit@color@imp}[2][\@empty]{% + \edef\@tempa{#1}% + \ifx\@empty\@tempa + \colorlet{coloredelGuIT}{#2}% + \else + \colorlet{coloredelGuIT}[#1]{#2}% + \fi} +\GuITcolor{1, 0, 1, 0.6} +\let\guitcolor\GuITcolor +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\@guit@url} +% \changes{v0.9}{2005/12/26}{Trasformata in una ``chiave'' creata tramite +% \pacchetto{xkeyval}} +% L'impostazione dell'indirizzo avviene tramite \cs{setupGuIT} prima +% dell'inizio del documento. +% \begin{macrocode} +\define@cmdkey{guit}[@guit@]{url}{\relax} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@guitimp} +% \changes{v0.8}{2004/10/28}{Aggiunto un argomento} +% \changes{v0.9}{2005/11/21}{Spostato in questa macro il controllo sul +% colore a causa delle modifiche imposte dall'uso delle chiavi} +% \changes{v0.9}{2006/05/03}{Sostituiti i due \cs{normalcolor} con il nulla +% quando il logo non deve essere colorato} +% Questa macro fornisce un primo livello di astrazione dalla vera +% implementazione del logo, permettendo di attivare opzionalmente la +% colorazione ed il meccanismo che trasforma ogni logo in un link al sito di +% \guit. Volendo evitare intromissioni di \pacchetto{hyperref} nell'aspetto +% del logo si \`e disabilitata la colorazione dei link (anche se +% \pacchetto{hyperref} venisse caricato con l'opzione |colorlinks=true|) e +% la creazione del box che \altro{Acrobat Reader} e qualche altro previewer +% visualizzano attorno ai link. +% +% Al livello inferiore dell'implementazione viene passato come unico +% argomento la giustapposizione di \cs{@guit@family}, che contiene il nome +% della famiglia di font attualmente in uso oppure di quella scelta +% dall'utente tramite la chiave |family| oppure tramite l'uso diretto della +% chiavi implicitamente associate ad ogni famiglia, e \cs{@guit@series}, +% l'analogo di \cs{@guit@family} per ci\`o che riguarda le serie. +% \begin{macrocode} +\def\@guitimp#1{% + \begingroup + \setkeys*{guit}{#1}% + \if@guit@colorized + \def\@colorize@guit{\color{coloredelGuIT}}% + \def\@decolorize@guit{\normalcolor}% + \else + \def\@colorize@guit{}% + \def\@decolorize@guit{}% + \fi + \edef\@tempa{\@guit@family}% + \ifx\@empty\@tempa + \let\@guit@family\f@family + \fi + \edef\@tempa{\@guit@series}% + \ifx\@empty\@tempa + \let\@guit@series\f@series + \fi + \@if@guit@link@or@hyperref + {\Hy@colorlinksfalse + \def\@pdfborder{0 0 0}% + \href{\@guit@url}{\@@guitimp{\@guit@family\@guit@series}}} + {\@@guitimp{\@guit@family\@guit@series}}% + \endgroup} +% \end{macrocode} +% \end{macro} +% +% Iniziamo ora a preparare i comandi da utilizzarsi in combinazione con i +% font attualmente supportati. Il codice poteva probabilmente essere scritto +% in maniera diversa e maggiormente compatta, ma ho preferito adottare un +% approccio modulare e pi\`u semplice. +% +% \begin{macro}{\DeclareGuITLogoCommand} +% \changes{v0.8.2}{2005/04/08}{Nuovo comando per l'utente finale per creare +% nuove realizzazioni del logo} +% Il lavoro necessario alla creazione delle diverse realizzazioni del logo +% viene interamente demandato ad una macro interna. Per mantenere un minimo +% di coerenza, quanto meno all'interno del singolo documento, permettiamo +% l'uso di questo comando solo nel preambolo e, di conseguenza, anche nel +% file di configurazione esterno. +% \begin{macrocode} +\DeclareRobustCommand*{\DeclareGuITLogoCommand}{% + \@gen@guit@fntcmd} +\@onlypreamble\DeclareGuITLogoCommand +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@gen@guit@fntcmd}\label{p:fntcmd} +% \changes{v0.7.1}{2004/02/28}{Aggiunta questa macro per generare le macro +% interne per i vari font; semplificate le macro dei font (con l'eccezione +% di quella per il Computer Modern Roman)} +% \changes{v0.8}{2004/10/28}{Alterata la selezione del font da usare} +% \changes{v0.9}{2005/11/21}{Aggiunta la definizione contestuale di una +% chiave con lo stesso nome della famiglia di font} +% \changes{v0.9}{2005/11/27}{Riscritta per gestire come secondo argomento +% opzionale la serie} +% \begin{macro}{\@gen@guit@fntcmd@imp} +% Nell'ottica di voler semplificare il codice del pacchetto viene fatto +% largo uso di questa macro per generare ``automaticamente'' le macro +% interne che si occupano di comporre il logo nella maniera pi\`u corretta +% possibile a seconda del font in uso. +% +% Vengono anche create due chiavi: una con il nome uguale al nome della +% famiglia, che ignora qualunque valore eventualmente assegnatole ed imposta +% \cs{@guit@family} in modo che sia utilizzabile in seguito, e la seconda +% con il nome formato dalla giustapposizione del nome della famiglia, del +% carattere \altro{/} e della serie, che ignora qualunque valore +% eventualmente assegnatole ed imposta \cs{@guit@family} e \cs{@guit@series} +% in modo che siano utilizzabili in seguito. +% \begin{macrocode} +\def\@gen@guit@fntcmd#1{% + \@ifnextchar[% + {\@gen@guit@fntcmd@imp#1}% + {\@gen@guit@fntcmd@imp#1[m]}} +\def\@gen@guit@fntcmd@imp#1[#2]#3#4#5#6{% + \define@key{guit}{#1}[#1]{\def\@guit@family{#1}}% + \define@key{guit}{#1/#2}[#1/#2]{% + \def\@guit@family{#1}% + \def\@guit@series{#2}}% + \@namedef{@guit#1#2}{% + \fontfamily{#1}\fontseries{#2}\scshape + \@colorize@guit g\kern #3\lower #4\hbox{u}% + \@decolorize@guit\kern #5 I\@colorize@guit\kern #6 t}} +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\AliasGuITLogoCommand} +% \changes{v0.9}{2005/11/30}{Nuovo comando per l'utente finale per creare +% alias di nuove realizzazioni del logo} +% La creazione di un alias non si discosta molto da quanto appena visto, se +% non fosse per il fatto che l'ultima riga di \cs{AliasGuITLogoCommand} non +% \`e di immediata lettura. +% \begin{macrocode} +\DeclareRobustCommand*{\AliasGuITLogoCommand}[4]{% + \define@key{guit}{#1/#2}[#1/#2]{% + \def\@guit@family{#3}% + \def\@guit@series{#4}}% + \expandafter\let\csname @guit#1#2\expandafter\endcsname\csname @guit#3#4\endcsname} +\@onlypreamble\AliasGuITLogoCommand +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@guitcmrm} +% \changes{v0.3}{2003/06/12}{Aggiunta l'indicazione esplicita della famiglia +% \textsf{cmr}; in precedenza si usava la famiglia di font con grazie +% predefinita, qualunque essa fosse} +% \changes{v0.7.3}{2004/10/11}{Un minimo aggiustamento al coefficiente di +% traslazione orizzontale della ``u''} +% \changes{v0.9}{2005/11/27}{Modificato il nome aggiungendo la serie} +% Se il logo deve essere scritto utilizzando il Computer Modern Roman +% richiediamo espressamente l'uso del font originale di Knuth impostando per +% l'encoding il valore OT1: questo ci permette di produrre documenti in +% formato \textsc{pdf} utilizzando font PostScript\texttrademark~anche senza +% dover usare la collezione \altro{cm-super}. Questo comando viene usanto +% anche quando il font principale usato dall'utente non \`e tra quelli +% supportati dal pacchetto. \emph{Non \`e possibile creare questa macro con +% \cs{@gen@guit@fntcmd}}. +% \begin{macrocode} +\def\@guitcmrm{% + \fontencoding{OT1}\fontfamily{cmr}\fontseries{m}\scshape + \@colorize@guit g\kern -0.26em\lower 0.714ex\hbox{u}% + \@decolorize@guit\kern -0.125em I\@colorize@guit\kern -0.125em t} +\define@key{guit}{cmr}[cmr]{\def\@guit@family{cmr}} +\define@key{guit}{cmr/m}[cmr/m]{% + \def\@guit@family{cmr}% + \def\@guit@series{m}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@guitlmrm} +% Questa macro viene utilizzata se l'utente usa il font Latin Modern. +% \begin{macrocode} +\@gen@guit@fntcmd{lmr}{-0.26em}{0.714ex}{-0.125em}{-0.125em} +\AliasGuITLogoCommand{lmr}{b}{lmr}{m} +\AliasGuITLogoCommand{lmr}{bx}{lmr}{m} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@guitptmm} +% \changes{v0.7.3}{2004/10/11}{Un minimo aggiustamento al coefficiente di +% traslazione orizzontale della ``u''} +% \changes{v0.9}{2005/11/27}{Modificato il nome aggiungendo la serie} +% \begin{macro}{\@guitptmbx} +% Questa macro viene utilizzata se l'utente usa il font Times. +% \begin{macrocode} +\@gen@guit@fntcmd{ptm}{-0.27em}{0.5475ex}{-0.125em}{-0.125em} +\@gen@guit@fntcmd{ptm}[bx]{-0.345em}{0.68ex}{-0.125em}{-0.125em} +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\@guitpplm} +% \changes{v0.7.3}{2004/10/11}{Minimi aggiustamenti ai coefficienti di +% traslazione orizzontale e verticale della ``u''} +% \changes{v0.9}{2005/11/27}{Modificato il nome aggiungendo la serie} +% \begin{macro}{\@guitpplbx} +% Se viene usato Palatino \cs{GuIT} user\`a questo comando. +% \begin{macrocode} +\@gen@guit@fntcmd{ppl}{-0.276em}{0.717ex}{-0.125em}{-0.125em} +\@gen@guit@fntcmd{ppl}[bx]{-0.33em}{0.689ex}{-0.125em}{-0.125em} +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\@guitpncm} +% \changes{v0.7.3}{2004/10/11}{Minimi aggiustamenti ai coefficienti di +% traslazione orizzontale e verticale della ``u''} +% \changes{v0.9}{2005/11/27}{Modificato il nome aggiungendo la serie} +% \begin{macro}{\@guitpncbx} +% Se il font attualmente in uso \`e il New Century Schoolbook verr\`a usata +% questa macro. +% \begin{macrocode} +\@gen@guit@fntcmd{pnc}{-0.322em}{0.678ex}{-0.125em}{-0.125em} +\@gen@guit@fntcmd{pnc}[bx]{-0.36em}{0.656ex}{-0.125em}{-0.125em} +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\@guitputm} +% \changes{v0.9}{2005/11/27}{Modificato il nome aggiungendo la serie} +% Per il font Utopia si usano i valori di questo comando. +% \begin{macrocode} +\@gen@guit@fntcmd{put}{-0.285em}{0.61ex}{-0.125em}{-0.125em} +\AliasGuITLogoCommand{put}{bx}{put}{m} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@guitbchm} +% \changes{v0.9}{2005/11/27}{Modificato il nome aggiungendo la serie} +% \begin{macro}{\@guitbchbx} +% Nel caso si usi il font Charter questa \`e la macro utilizzata. +% \begin{macrocode} +\@gen@guit@fntcmd{bch}{-0.28em}{0.58ex}{-0.125em}{-0.125em} +\@gen@guit@fntcmd{bch}[bx]{-0.31em}{0.56ex}{-0.125em}{-0.125em} +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\@guitpbkm} +% \changes{v0.9}{2005/11/27}{Modificato il nome aggiungendo la serie} +% \begin{macro}{\@guitpbkbx} +% L'ultimo comando ``interno'' viene usato per il font Bookman. +% \begin{macrocode} +\@gen@guit@fntcmd{pbk}{-0.3em}{0.59ex}{-0.125em}{-0.125em} +\@gen@guit@fntcmd{pbk}[bx]{-0.34em}{0.52ex}{-0.125em}{-0.125em} +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\@@guitimp} +% \changes{v0.8}{2004/10/28}{Enormemente semplificata grazie ai preziosi +% suggerimenti del Prof.\ Enrico Gregorio; aggiunto un argomento} +% L'implementazione del comando a disposizione dell'utente \`e molto +% semplice: se non esiste la macro interna associata alla famiglia di font +% selezionata si ricade sull'onnipresente Computer Modern Roman, altrimenti +% si utilizza la macro appropriata. +% \begin{macrocode} +\def\@@guitimp#1{% + \@ifundefined{@guit#1}{\@guitcmrm}{\@nameuse{@guit#1}}} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@guit@color@on} +% \changes{v0.7}{2003/10/17}{Estratto il controllo sul valore di +% \cs{@guit@colorized} in modo da effettuare l'operazione una volta sola} +% \changes{v0.8}{2004/10/28}{Aggiunto un argomento opzionale} +% \changes{v0.9}{2005/11/21}{Eliminati i controlli sull'uso del colore a +% causa delle modifiche imposte dall'uso delle chiavi} +% La porzione dell'implementazione di \cs{GuIT} che attiva la colorazione +% del logo in seguito alla presenza del carattere \altro{*}. +% \begin{macrocode} +\newcommand*{\@guit@color@on}[1][]{% + \@guitimp{color, #1}\ignorespaces} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@guit@color@off} +% \changes{v0.8}{2004/10/28}{Aggiunto un argomento opzionale} +% \changes{v0.9}{2005/11/21}{Eliminati i controlli sull'uso del colore a +% causa delle modifiche imposte dall'uso delle chiavi} +% La porzione dell'implementazione di \cs{GuIT} che potenzialmente non +% altera la colorazione del logo. +% \begin{macrocode} +\newcommand*{\@guit@color@off}[1][]{% + \@guitimp{#1}\ignorespaces} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\GuIT} +% Alla fine, ecco il comando a disposizione dell'utente finale per scrivere +% il logo del \GuIT. L'implementazione gestisce unicamente la presenza +% dell'asterisco, demandando il controllo dell'eventuale argomento opzionale +% allo strato sottostante. +% \begin{macrocode} +\DeclareRobustCommand*{\GuIT}{% + \@ifstar\@guit@color@on\@guit@color@off} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\guit} +% Per semplificarci (o, piuttosto, semplificarmi) la vita ecco la versione +% del comando precedente con il nome completamente in lettere minuscole. +% \begin{macrocode} +\let\guit\GuIT +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\GuITtext} +% \changes{v0.4}{2003/07/15}{Modificato il testo prodotto da questo comando +% per aderire perfettamente alla dizione ufficiale del Gruppo} +% \changes{v0.7}{2003/10/15}{Sdoppiata la definizione per tenere conto +% dell'uso di \pacchetto{hyperref}} +% \changes{v0.9}{2005/11/21}{Unificata la definizione per poter influenzare +% la generazione del link tramite l'uso delle chiavi} +% Il comando per indicare la denominazione completa e corretta del +% Gruppo. L'unica chiave che ha effetto su questo comando \`e |link|. +% \begin{macrocode} +\DeclareRobustCommand*{\GuITtext}[1][]{% + \begingroup + \setkeys*{guit}{#1}% + \@if@guit@link@or@hyperref + {\href{\@guit@url}{Gruppo Utilizzatori Italiani di \TeX}} + {Gruppo Utilizzatori Italiani di \TeX}% + \endgroup + \ignorespaces} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\guittext} +% Come per \cs{GuIT} forniamo la versione con il nome completamente in +% lettere minuscole. +% \begin{macrocode} +\let\guittext\GuITtext +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\GuITtextEn} +% \begin{macro}{\guittexten} +% Per il comando che riporta la denominazione anglicizzata del \guit\ vale +% quanto riportato per \cs{GuITtext} e \cs{guittext}. +% \begin{macrocode} +\DeclareRobustCommand*{\GuITtextEn}[1][]{% + \begingroup + \setkeys*{guit}{#1}% + \@if@guit@link@or@hyperref + {\href{\@guit@url}{Italian \TeX\ User Group}} + {Italian \TeX\ User Group}% + \endgroup + \ignorespaces} +\let\guittexten\GuITtextEn +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\GuITurl} +% \changes{v0.7}{2003/10/15}{Aggiunto questo comando per scrivere +% l'indirizzo del sito internet di \guit~senza troppi errori} +% \changes{v0.9}{2005/11/25}{Aggiunto un argomento opzionale per gestire le +% chiavi} +% Il comando per scrivere automaticamente l'indirizzo del sito internet di +% \guit~``subisce'', implicitamente, l'effetto del caricamente del pacchetto +% \pacchetto{hyperref}, quindi il comando scriverebbe sempre l'indirizzo del +% sito come collegamento al sito stesso: per evitare questo effetto +% collaterale \`e stato realizzato un accrocchio ad hoc. L'argomento +% opzionale viene considerato un'estensione dell'indirizzo (una pagina, una +% sezione, etc.) e composto di conseguenza. +% \begin{macrocode} +\DeclareRobustCommand*{\GuITurl}[1][]{% + \begingroup + \setkeys*{guit}{#1}% + \@if@guit@link@or@hyperref + {\let\@guit@url@imp\url} + {\let\@guit@url@imp\@guit@url@nolink}% + \edef\@tempa{\@guit@url}% + \ifx\@empty\@tempa + \relax + \else + \edef\@tempa{\@guit@document}% + \ifx\@empty\@tempa + \expandafter\@guit@url@imp\expandafter{\@guit@url}% + \else + \expandafter\expandafter\expandafter\@guit@url@imp% + \expandafter\expandafter\expandafter{% + \expandafter\@guit@url\expandafter/\@guit@document}% + \fi + \fi + \endgroup + \ignorespaces} +\DeclareUrlCommand\@guit@url@nolink{} +\define@cmdkey{guit}[@guit@]{document}{\relax} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\guiturl} +% Come per \cs{GuIT} forniamo la versione con il nome completamente in +% lettere minuscole. +% \begin{macrocode} +\let\guiturl\GuITurl +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\GuITforum} +% \changes{v0.7.2}{2004/09/16}{Aggiunto questo comando per scrivere +% l'indirizzo del forum di \guit~senza troppi errori} +% \changes{v0.9}{2005/11/27}{Reimplementato usando \cs{GuITurl} ed il nuovo +% argomento opzionale; modificato l'indirizzo del forum su suggerimento di +% Emiliano Giovanni Vavassori e Maurizio W. Himmelman} +% \changes{v1.0.0}{2012/08/17}{Aggiornato l'URL del forum} +% Quanto detto per \cs{GuITurl} vale anche per questo comando. +% \begin{macrocode} +\DeclareRobustCommand*{\GuITforum}[1][]{% + \guiturl[#1, document=home/it/forum/index]} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\guitforum} +% Come per \cs{GuIT} forniamo la versione con il nome completamente in +% lettere minuscole. +% \begin{macrocode} +\let\guitforum\GuITforum +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\GuITmeeting} +% \changes{v0.7.3}{2004/10/11}{Aggiunto questo comando ed alcune macro +% accessorie per realizzare il logo del convegno periodico} +% \begin{macro}{\@guit@meeting@color@on} +% \changes{v0.7.4}{2004/10/15}{Corretta una svista clamorosa nella selezione +% del font da usare} +% \changes{v0.7.5}{2004/10/17}{Ri-corretta questa macro (si spera per +% l'ultima volta)} +% \changes{v0.8.1}{2004/11/15}{Aggiunta l'indicazione dell'encoding da +% usare} +% \changes{v0.9}{2005/11/21}{Isolato praticamente tutto il codice in +% un'altra macro} +% \begin{macro}{\@guit@meeting@color@off} +% \changes{v0.7.4}{2004/10/15}{Corretta una svista clamorosa nella selezione +% del font da usare} +% \changes{v0.7.5}{2004/10/17}{Ri-corretta questa macro (si spera per +% l'ultima volta)} +% \changes{v0.8.1}{2004/11/15}{Aggiunta l'indicazione dell'encoding da +% usare} +% \changes{v0.9}{2005/11/21}{Isolato praticamente tutto il codice in +% un'altra macro} +% L'implementazione del logo del convegno \`e stata partizionata per +% realizzare una versione a colori duplicando poco codice. +% \begin{macrocode} +\DeclareRobustCommand*{\GuITmeeting}{% + \@ifstar\@guit@meeting@color@on\@guit@meeting@color@off} +\newcommand*{\@guit@meeting@color@on}[1][]{% + \@guit@meeting@imp{*}{#1}} +\newcommand*{\@guit@meeting@color@off}[1][]{% + \@guit@meeting@imp{}{#1}} +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% +% Definiamo due chiavi per gestire l'anno e lo stile del logo. +% \begin{macrocode} +\define@cmdkey{guit}[@guit@]{year}{\relax} +\newif\if@guit@inline +\define@choicekey*{guit}{style}[\val\nr]{inline,display}{% + \ifcase\nr\relax + \@guit@inlinetrue + \or + \@guit@inlinefalse + \fi} +% \end{macrocode} +% +% \begin{macro}{\@guit@meeting@imp} +% In questa macro gestiamo le chiavi (|#2|) e l'asterisco (|#1|), impostiamo +% il font da usare ed ordiniamo la macro con \textit{meeting} e quella che +% si occupa dell'anno in base allo stile di visualizzazione attivo. +% \begin{macrocode} +\def\@guit@meeting@imp#1#2{% + \begingroup + \setkeys*{guit}{#2}% + \fontencoding{OT1}\fontfamily{cmr}\fontseries{m}\selectfont + \guit#1 + \if@guit@inline + \@guit@meeting@part\@guit@meeting@year + \else + \@guit@meeting@year\@guit@meeting@part + \fi + \endgroup + \ignorespaces} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@guit@meeting@part} +% \changes{v0.9}{2005/11/21}{Modificata per tenere conto dei due stili del +% logo} +% Se il valore di |style| \`e |display|, allora la parte +% ``\textit{meeting}'' del logo viene traslata usando per entrambe le +% direzioni, come unit\`a di misura, \emph{ex} per cercare di limitare al +% minimo le deformazioni dello spazio dovute alla definizione di \emph{em} +% (che nella famiglia Computer Modern varia in maniera non proporzionale +% alla dimensione nominale del font~\cite{CMT}). +% \begin{macrocode} +\def\@guit@meeting@part{% + \if@guit@inline + \textit{meeting}% + \else + \kern -2.02ex\lower 1.25ex\hbox{\textit{meeting}}% + \fi} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\@guit@meeting@year} +% \changes{v0.9}{2005/11/21}{Aggiunto questo comando per gestire l'anno su +% esplicita richiesta di Maurizio W.~Himmelmann} +% \begin{macro}{\@guit@meeting@year@imp} +% Se il valore di |style| \`e |display|, allora l'anno viene traslato e +% ridimensionato usando \cs{scalebox}. +% \begin{macrocode} +\def\@guit@meeting@year{% + \edef\@tempa{\@guit@year}% + \ifx\@empty\@tempa + \relax + \else + \@guit@meeting@year@imp{\@guit@year}% + \fi} +\def\@guit@meeting@year@imp#1{% + \if@guit@inline + \fontfamily{pzc}\selectfont #1 + \else + \rlap{% + \hskip0.7em\fontfamily{pzc}\selectfont + \raise 0.5ex\hbox{\scalebox{0.85}{#1}}}% + \fi} +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\guitmeeting} +% Come per \cs{GuIT} forniamo la versione con il nome completamente in +% lettere minuscole. +% \begin{macrocode} +\let\guitmeeting\GuITmeeting +% \end{macrocode} +% \end{macro} +% +% +% \`E essenziale che vengano impostate alcune chiavi in modo da creare +% alcune macro d'uso interno prima di proseguire; per fare questo \`e +% sufficiente utilizzare \cs{setupGuIT} con le impostazioni di default. +% \begin{macrocode} +\setupGuIT +% \end{macrocode} +% +% Il codice seguente \`e stato integrato da \pacchetto{arslogo}, v0.1.3, +% scritto da Massimo Caschili, dietro esplicita richiesta del \guittext, +% detentore del copyright. +% \begin{macrocode} +\DeclareRobustCommand*{\Ars}{% + \textsf{\lower -.48ex\hbox{\rotatebox{-20}{A}}\kern -.3em{rs}}% + \kern -.05em\TeX\kern -.17em\lower -.357ex\hbox{nica}} +\DeclareRobustCommand*{\Arsob}{\rotatebox{20}{\Ars}} +\DeclareRobustCommand*{\ars}{% + \textsf{\lower -.48ex\hbox{\rotatebox{-20}{A}}\kern -.3em{rs}}} +\DeclareRobustCommand*{\tecnica}{% + \TeX\kern -.17em\lower -.357ex\hbox{nica}} +\DeclareRobustCommand*{\arsta}{% + \ars \kern -0.65em\lower -1.3ex\hbox{\scalebox{0.18}{\hbox{% + \TeX\kern -.17em\lower -.357ex\hbox{nica}}}}} +\DeclareRobustCommand*{\arstb}{% + \ars \kern -0.65em\lower -1.25ex\hbox{\scalebox{0.34}{\hbox{% + \TeX\kern -.17em\lower -.357ex\hbox{nica}}}}} +\DeclareRobustCommand*{\arstv}{% + \ars \kern -0.05em\lower -1.818ex\hbox{\rotatebox{-90}{\hbox{% + \scalebox{0.225}{\hbox{% + \TeX\kern -.17em\lower -.357ex\hbox{nica}}}}}}} +\DeclareRobustCommand*{\arsto}{% + \rotatebox{49}{\lower -.84ex\hbox{\scalebox{0.214}{\hbox{% + \TeX\kern -.17em\lower -.357ex\hbox{nica}}}}}% + \kern -.74em\hbox{\ars}} +\DeclareRobustCommand*{\Arsto}{% + \rotatebox{49}{\lower -.84ex\hbox{\scalebox{0.214}{\hbox{% + \TeX\kern -.17em\lower -.357ex\hbox{nica}}}}}% + \kern -.74em\hbox{\Ars}} +% \end{macrocode} +% +% Terminiamo leggendo il file di configurazione. Nel caso non si riuscisse a +% trovarlo, ci limitiamo ad avvertire l'utente. +% \begin{macrocode} +\InputIfFileExists{guit.cfg}% + {\relax}% + {\PackageInfo{guit}{Configuration file not found}} +% +% \end{macrocode} +% +% +% +% \subsection{Il file di configurazione} +% Il file di configurazione \`e, in realt\`a, vuoto e fornisce solo qualche +% esempio. La definizione delle realizzazioni del logo e del colore +% predefinito del logo non \`e inserita veramente nel file di configurazione +% per diminuire il rischio che l'utente le modifichi o le rimuova +% accidentalmente. +% \begin{macrocode} +%<*cfg> +\ProvidesFile{guit.cfg}[2019/07/08 v1.0.0-alpha.3 File di configurazione di guit.sty] +%% Esempi: +%% \GuITcolor{1, 0, 1, 0.6} +%% \DeclareGuITLogoCommand{lmr}{-0.26em}{0.714ex}{-0.125em}{-0.125em} +%% \AliasGuITLogoCommand{lmr}{b}{lmr}{m} +%% \AliasGuITLogoCommand{lmr}{bx}{lmr}{m} +%% \DeclareGuITLogoCommand{ptm}{-0.27em}{0.5475ex}{-0.125em}{-0.125em} +%% \DeclareGuITLogoCommand{ptm}[bx]{-0.345em}{0.68ex}{-0.125em}{-0.125em} +%% \DeclareGuITLogoCommand{ppl}{-0.276em}{0.717ex}{-0.125em}{-0.125em} +%% \DeclareGuITLogoCommand{ppl}[bx]{-0.33em}{0.689ex}{-0.125em}{-0.125em} +%% \DeclareGuITLogoCommand{pnc}{-0.322em}{0.678ex}{-0.125em}{-0.125em} +%% \DeclareGuITLogoCommand{pnc}[bx]{-0.36em}{0.656ex}{-0.125em}{-0.125em} +%% \DeclareGuITLogoCommand{put}{-0.285em}{0.61ex}{-0.125em}{-0.125em} +%% \AliasGuITLogoCommand{put}{bx}{put}{m} +%% \DeclareGuITLogoCommand{bch}{-0.28em}{0.58ex}{-0.125em}{-0.125em} +%% \DeclareGuITLogoCommand{bch}[bx]{-0.31em}{0.56ex}{-0.125em}{-0.125em} +%% \DeclareGuITLogoCommand{pbk}{-0.3em}{0.59ex}{-0.125em}{-0.125em} +%% \DeclareGuITLogoCommand{pbk}[bx]{-0.34em}{0.52ex}{-0.125em}{-0.125em} +% +% \end{macrocode} +% +% +% +% \makeatletter +% \c@IndexColumns=2 +% \c@GlossaryColumns=2 +% \def\index@prologue{\section*{Indice}% +% \markboth{Indice}{Indice}% +% I numeri scritti in corsivo si riferiscono alla pagina in cui la voce +% corrispondente viene descritta; i numeri sottolineati si riferiscono +% alla +% \ifcodeline@index +% linea di codice della +% \fi +% definizione; i numeri in carattere tondo si riferiscono alle +% \ifcodeline@index +% linee di codice +% \else +% pagine +% \fi +% in cui la voce viene usata.}% +% \def\glossary@prologue{\section*{{Storico dei cambiamenti}}% +% \markboth{{Storico dei cambiamenti}}{{Storico dei cambiamenti}}}% +% \makeatother +% \clearpage +% \Finale +% \clearpage +% \PrintIndex +% \clearpage +% \PrintChanges +% +% +% +\endinput diff --git a/macros/latex/contrib/GuIT/GuITlogo/guit.ins b/macros/latex/contrib/GuIT/GuITlogo/guit.ins new file mode 100644 index 0000000000..04f754069a --- /dev/null +++ b/macros/latex/contrib/GuIT/GuITlogo/guit.ins @@ -0,0 +1,85 @@ +%% +%% guit.ins +%% Copyright 2003, 2004, 2005, 2006, 2009, 2012, 2019 Gruppo Utilizzatori +%% Italiani di TeX +%% +%% This work may be distributed and/or modified under the +%% conditions of the LaTeX Project Public License, either +%% version 1.3a of this license or (at your option) any +%% later version. +%% The latest version of the license is in +%% https://www.latex-project.org/lppl.txt +%% +%% Author: Emanuele Vicentini +%% (emanuelevicentini at yahoo dot it) +%% +%% This work has the LPPL maintenance status "maintained". +%% +%% The Current Maintainer of this work is Emanuele Vicentini. +%% +%% This work consists of the files: README, guit.dtx, guit.ins and the +%% derived files guit.sty, guit.cfg and guittest.tex +%% +%% This file will generate fast loadable files and documentation +%% driver files from the doc files in this package when run through +%% LaTeX or TeX. +%% +%% --------------- start of docstrip commands ------------------ +%% +\input docstrip +\preamble + + Copyright 2003, 2004, 2005, 2006, 2009, 2012, 2019 Gruppo Utilizzatori + Italiani di TeX + + This work may be distributed and/or modified under the + conditions of the LaTeX Project Public License, either + version 1.3a of this license or (at your option) any + later version. + The latest version of the license is in + https://www.latex-project.org/lppl.txt + + Author: Emanuele Vicentini + (emanuelevicentini at yahoo dot it) + + This work has the LPPL maintenance status "maintained". + + The Current Maintainer of this work is Emanuele Vicentini. + + This work consists of the files: README, guit.dtx, guit.ins and the + derived files guit.sty, guit.cfg and guittest.tex + +\endpreamble + +\keepsilent +\askforoverwritefalse + +\Msg{*** Generating the package files ***} +\generate{\file{guit.sty}{\from{guit.dtx}{style}}% + \file{guit.cfg}{\from{guit.dtx}{cfg}}% + \nopostamble + \file{guittest.tex}{\from{guit.dtx}{test}}} + +\Msg{***********************************************************} +\Msg{*} +\Msg{* To finish the installation you have to move the following} +\Msg{* files into a directory searched by TeX:} +\Msg{*} +\Msg{* \space\space guit.sty} +\Msg{* \space\space guit.cfg} +\Msg{*} +\Msg{*} +\Msg{* To produce the documentation on guit's code run the} +\Msg{* file ending with `.dtx' through (pdf)LaTeX.} +\Msg{* Process the file guit.idx by:} +\Msg{* \space\space\space\space makeindex -s gind.ist guit} +\Msg{* Process the file guit.glo by:} +\Msg{* \space\space\space\space makeindex -s gglo.ist -o guit.gls guit.glo} +\Msg{*} +\Msg{* To produce the test file run guittest.tex through (pdf)LaTeX} +\Msg{* and check the results} +\Msg{*} +\Msg{* Happy TeXing} +\Msg{***********************************************************} + +\endbatchfile diff --git a/macros/latex/contrib/GuIT/GuITlogo/guit.pdf b/macros/latex/contrib/GuIT/GuITlogo/guit.pdf new file mode 100644 index 0000000000..78ccfb3846 Binary files /dev/null and b/macros/latex/contrib/GuIT/GuITlogo/guit.pdf differ diff --git a/macros/latex/contrib/GuIT/GuITlogo/guittest.pdf b/macros/latex/contrib/GuIT/GuITlogo/guittest.pdf new file mode 100644 index 0000000000..3967b916e6 Binary files /dev/null and b/macros/latex/contrib/GuIT/GuITlogo/guittest.pdf differ 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 Binary files /dev/null and b/macros/latex/contrib/GuIT/guitbeamer/guitbeamer-de.pdf differ 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 Binary files /dev/null and b/macros/latex/contrib/GuIT/guitbeamer/guitbeamer.pdf differ 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{}]\{\alert{}\}\n + \onslide<2-> + \quad\alert{}\nn + \onslide<3-> + \\begin\{document\}\n + \onslide<4-> + \alert{\quad}\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{}\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[]\{\alert{}\} + \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 Binary files /dev/null and b/macros/latex/contrib/GuIT/guitbeamer/img/clsexpl.pdf differ 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 Binary files /dev/null and b/macros/latex/contrib/GuIT/guitbeamer/img/cmdexpl.pdf differ 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 Binary files /dev/null and b/macros/latex/contrib/GuIT/guitbeamer/img/docexem.pdf differ 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 Binary files /dev/null and b/macros/latex/contrib/GuIT/guitbeamer/img/latexsymb.pdf differ 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 Binary files /dev/null and b/macros/latex/contrib/GuIT/guitbeamer/img/pkgexem.pdf differ -- cgit v1.2.3