summaryrefslogtreecommitdiff
path: root/Master/texmf-dist
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-05-28 22:05:36 +0000
committerKarl Berry <karl@freefriends.org>2006-05-28 22:05:36 +0000
commitc3c87346c0cbca209e6fb9ed6084b95f274edcb9 (patch)
tree087b9009fe07fa2dabd93dbc3b256c9bdf62ce67 /Master/texmf-dist
parent93ce74b7c7168e00ab65c8543563fa0188deebf5 (diff)
guit update
git-svn-id: svn://tug.org/texlive/trunk@1606 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist')
-rw-r--r--Master/texmf-dist/doc/latex/GuIT/README35
-rw-r--r--Master/texmf-dist/doc/latex/GuIT/guit.pdfbin161156 -> 223691 bytes
-rw-r--r--Master/texmf-dist/doc/latex/GuIT/guittest.pdfbin91661 -> 109530 bytes
-rw-r--r--Master/texmf-dist/doc/latex/GuIT/guittest.tex32
-rw-r--r--Master/texmf-dist/source/latex/GuIT/guit.dtx1192
-rw-r--r--Master/texmf-dist/source/latex/GuIT/guit.ins8
-rw-r--r--Master/texmf-dist/tex/latex/GuIT/guit.cfg12
-rw-r--r--Master/texmf-dist/tex/latex/GuIT/guit.sty326
-rw-r--r--Master/texmf-dist/tpm/GuIT.tpm8
9 files changed, 1148 insertions, 465 deletions
diff --git a/Master/texmf-dist/doc/latex/GuIT/README b/Master/texmf-dist/doc/latex/GuIT/README
index a96f7d0ad94..715d7193187 100644
--- a/Master/texmf-dist/doc/latex/GuIT/README
+++ b/Master/texmf-dist/doc/latex/GuIT/README
@@ -7,10 +7,10 @@ colore di default del testo oppure un colore qualunque selezionabile
dall'utente, secondo lo schema del logo presente sul sito del Gruppo
(http://www.guit.sssup.it). 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 e del logo del convegno
-GuITmeeting. Opzionalmente, tramite l'uso di hyperref, i prodotti dei
-comandi appena citati possono diventare collegamenti ipertestuali al sito
-del Gruppo (http://www.guit.sssup.it).
+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 (http://www.guit.sssup.it).
[ The guit.sty package provides some commands useful to correctly write the
logo of "Gruppo Utilizzatori Italiani di TeX" (Italian TeX User Group),
@@ -18,13 +18,26 @@ del Gruppo (http://www.guit.sssup.it).
choose, in conformity with logo's scheme as seen on the Group site
(http://www.guit.sssup.it). 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 and the meeting GuITmeeting's
- logo. Optionally, using hyperref, the outputs of the above cited commands
- can become hyperlinks to Group's site (http://www.guit.sssup.it).
+ 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
+ (http://www.guit.sssup.it).
Documentation available in Italian only.]
+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
@@ -108,7 +121,7 @@ o Prima release del pacchetto
This work has the LPPL maintenance status "author-maintained".
This work consists of the files: README, guit.dtx, guit.ins and the
- derived files guit.sty, guit.cfg and guittext.tex
+ derived files guit.sty, guit.cfg and guittest.tex
-------------------------------------------------------------------
@@ -120,8 +133,8 @@ guittest.pdf File di test precompilato in PDF
Per installare il pacchetto:
-o eseguite: latex guit.ins (genererà guit.sty, guit.cfg ed il file di test)
-
+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
@@ -139,6 +152,6 @@ geometry, guit e rotating, oltre alla dotazione standard di font Type1
fornita dal bundle PSNFSS.
-8 aprile 2005
+24 maggio 2006
Emanuele Vicentini
(emanuelevicentini at yahoo dot it)
diff --git a/Master/texmf-dist/doc/latex/GuIT/guit.pdf b/Master/texmf-dist/doc/latex/GuIT/guit.pdf
index 26e09c0d7e4..ef923a2be4e 100644
--- a/Master/texmf-dist/doc/latex/GuIT/guit.pdf
+++ b/Master/texmf-dist/doc/latex/GuIT/guit.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/GuIT/guittest.pdf b/Master/texmf-dist/doc/latex/GuIT/guittest.pdf
index 28128401313..ee6816e1a17 100644
--- a/Master/texmf-dist/doc/latex/GuIT/guittest.pdf
+++ b/Master/texmf-dist/doc/latex/GuIT/guittest.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/GuIT/guittest.tex b/Master/texmf-dist/doc/latex/GuIT/guittest.tex
index ee167ccb92b..42ebe84e51c 100644
--- a/Master/texmf-dist/doc/latex/GuIT/guittest.tex
+++ b/Master/texmf-dist/doc/latex/GuIT/guittest.tex
@@ -6,7 +6,7 @@
%%
%% guit.dtx (with options: `test')
%%
-%% Copyright 2003, 2004, 2005 Gruppo Utilizzatori Italiani di TeX
+%% Copyright 2003, 2004, 2005, 2006 Gruppo Utilizzatori Italiani di TeX
%%
%% This work may be distributed and/or modified under the
%% conditions of the LaTeX Project Public License, either
@@ -21,19 +21,21 @@
%% This work has the LPPL maintenance status "author-maintained".
%%
%% This work consists of the files: README, guit.dtx, guit.ins and the
-%% derived files guit.sty, guit.cfg and guittext.tex
+%% derived files guit.sty, guit.cfg and guittest.tex
%%
\documentclass[12pt, a4paper]{article}
\usepackage[margin=1in, noheadfoot]{geometry}
\usepackage{booktabs, guit, rotating}
+
\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
+con qualche cosa\footnote{Un ultima nota: Copyright 2003, 2004, 2005, 2006
\guittext} di ``strambo'':
\begin{center}
@@ -44,7 +46,8 @@ $==$\\
Una piccola ``spirale'' colorata e divertente:
-\swapGuITcommands
+\begingroup
+\setupGuIT[color=yes]
\GuITcolor[rgb]{1, 0, 0}
\newcount\wang
\newsavebox{\wangtext}
@@ -66,7 +69,7 @@ Una piccola ``spirale'' colorata e divertente:
\guitcolor*{coloredelGuIT!90!green}%
\repeat}}
\wheel{\guit}
-\swapGuITcommands
+\endgroup
Ed ora una tabella riepilogativa parziale dei font supportati dalla versione
attuale.
@@ -76,12 +79,12 @@ attuale.
\toprule
Font & Logo \\
\midrule
-Computer Modern Roman & \guit \\
-Times New Roman & \guit[ptm] \\
-Palatino & \guit[ppl] \\
-NewCentury Schoolbook & \guit[pnc] \\
-Charter & \guit[bch] \\
-Bookman & \guit[pbk] \\
+Computer Modern Roman & \guit[family=cmr] \\
+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}
@@ -93,14 +96,15 @@ Per finire, un sfilza di \guit:
\makeatletter
\@tfor\famiglia:={cmr}{ptm}{ppl}{pnc}{bch}{pbk}\do{%
\noindent
+ \setupGuIT[family=\famiglia]
\@tfor\dimensione:=\tiny\scriptsize\footnotesize\small\normalsize
\large\Large\LARGE\huge\do{%
- \dimensione\guit[\famiglia]~}%
- \Huge\guit[\famiglia]\pippo}%
+ \dimensione\guit~}%
+ \Huge\guit\pippo}%
\endgroup
\begin{center}
-\Huge Venite tutti al prossimo \guitmeeting*
+\Huge Venite tutti al prossimo \guitmeeting[color]
\end{center}
\end{document}
diff --git a/Master/texmf-dist/source/latex/GuIT/guit.dtx b/Master/texmf-dist/source/latex/GuIT/guit.dtx
index e22ee392f15..49ca66ae11b 100644
--- a/Master/texmf-dist/source/latex/GuIT/guit.dtx
+++ b/Master/texmf-dist/source/latex/GuIT/guit.dtx
@@ -1,7 +1,7 @@
% \iffalse
%
% guit.dtx
-% Copyright 2003, 2004, 2005 Gruppo Utilizzatori Italiani di TeX
+% Copyright 2003, 2004, 2005, 2006 Gruppo Utilizzatori Italiani di TeX
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either
@@ -16,12 +16,16 @@
% This work has the LPPL maintenance status "author-maintained".
%
% This work consists of the files: README, guit.dtx, guit.ins and the
-% derived files guit.sty, guit.cfg and guittext.tex
+% derived files guit.sty, guit.cfg and guittest.tex
%
%<*driver>
-\documentclass[10pt, a4paper, draft]{ltxdoc}
+\documentclass[10pt, a4paper]{ltxdoc}
\usepackage[italian]{babel}
-\usepackage{guit}
+\usepackage{booktabs, guit, subfig, tabularx}
+% We must absolutely load footnote after hyperref, which is implicitely
+% loaded by guit.
+\usepackage{footnote}
+\makesavenoteenv{table}
\EnableCrossrefs
\CodelineIndex
\RecordChanges
@@ -35,14 +39,16 @@
\documentclass[12pt, a4paper]{article}
\usepackage[margin=1in, noheadfoot]{geometry}
\usepackage{booktabs, guit, rotating}
+
\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
+con qualche cosa\footnote{Un ultima nota: Copyright 2003, 2004, 2005, 2006
\guittext} di ``strambo'':
\begin{center}
@@ -53,7 +59,8 @@ $==$\\
Una piccola ``spirale'' colorata e divertente:
-\swapGuITcommands
+\begingroup
+\setupGuIT[color=yes]
\GuITcolor[rgb]{1, 0, 0}
\newcount\wang
\newsavebox{\wangtext}
@@ -75,7 +82,7 @@ Una piccola ``spirale'' colorata e divertente:
\guitcolor*{coloredelGuIT!90!green}%
\repeat}}
\wheel{\guit}
-\swapGuITcommands
+\endgroup
Ed ora una tabella riepilogativa parziale dei font supportati dalla versione
attuale.
@@ -85,12 +92,12 @@ attuale.
\toprule
Font & Logo \\
\midrule
-Computer Modern Roman & \guit \\
-Times New Roman & \guit[ptm] \\
-Palatino & \guit[ppl] \\
-NewCentury Schoolbook & \guit[pnc] \\
-Charter & \guit[bch] \\
-Bookman & \guit[pbk] \\
+Computer Modern Roman & \guit[family=cmr] \\
+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}
@@ -102,14 +109,15 @@ Per finire, un sfilza di \guit:
\makeatletter
\@tfor\famiglia:={cmr}{ptm}{ppl}{pnc}{bch}{pbk}\do{%
\noindent
+ \setupGuIT[family=\famiglia]
\@tfor\dimensione:=\tiny\scriptsize\footnotesize\small\normalsize
\large\Large\LARGE\huge\do{%
- \dimensione\guit[\famiglia]~}%
- \Huge\guit[\famiglia]\pippo}%
+ \dimensione\guit~}%
+ \Huge\guit\pippo}%
\endgroup
\begin{center}
-\Huge Venite tutti al prossimo \guitmeeting*
+\Huge Venite tutti al prossimo \guitmeeting[color]
\end{center}
\end{document}
@@ -118,7 +126,7 @@ Per finire, un sfilza di \guit:
%
%
%
-% \CheckSum{286}
+% \CheckSum{532}
%
% \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
@@ -163,6 +171,15 @@ Per finire, un sfilza di \guit:
% \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}}
%
%
%
@@ -177,8 +194,9 @@ Per finire, un sfilza di \guit:
% \maketitle
% \begin{abstract}
% Questo piccolissimo pacchetto permette di riprodurre il logo del
-% \emph{\guittext} in maniera sufficientemente indipendente dal font
-% utilizzato, cercando di mantenerne l'aspetto originale.
+% \emph{\guittext} (\emph{\guittexten}) in maniera sufficientemente
+% indipendente dal font utilizzato, cercando di mantenerne l'aspetto
+% originale.
% \end{abstract}
% \tableofcontents
% \clearpage
@@ -192,87 +210,137 @@ Per finire, un sfilza di \guit:
%
%
%
-% \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, quindi, per evitare
-% spiacevoli effetti dovuti a combinazioni dei parametri \emph{NFSS2}
-% indicanti font inesistenti nella famiglia Computer Modern originale
-% (esempio: OT1/cmr/bx/sc non esiste e viene sostituito automaticamente con
-% OT1/cmr/bx/n) il logo viene sempre composto con \meta{enc}/\meta{fam}/m/sc
-% dove \meta{enc}, con un'unica eccezione, pu\`o assumere qualunque valore
-% mentre \meta{fam} pu\`o variare a scelta tra:
+% \iffalse\section{I logo}\fi
%
-% \begin{enumerate}
-% \item Computer Modern Roman;
-% \item Times;
-% \item Palatino;
-% \item NewCentury Schoolbook;
-% \item Utopia\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.};
-% \item Charter;
-% \item Bookman.
-% \end{enumerate}
%
-% Ho volutamente tralasciato i font Sans Serif perch\'e credo abbiano una
-% resa qualitativamente inferiore per il nostro progetto.
%
-% Se a qualcuno venisse in mente di tirare in ballo l'encoding T1 perch\'e
-% esiste il font T1/cmr/bx/sc, mi permetto di dissentire preventivamente:
-% \`e vero che tutti i font della lista precedente si possono utilizzare
-% anche con quell'encoding, ma considerate che per usare la famiglia
-% Computer Modern in formato Type1 (necessario per i \textsc{pdf} di \guit,
-% altrimenti si hanno i notissimi problemi di visualizzazione con l'Acrobat
-% Reader) con l'encoding T1 \`e necessario scaricare ed utilizzare la
-% collezioni \altro{cm-super} oppure \altro{lmodern}, che non sono ancora
-% componenti standard delle pi\`u comuni distribuzioni di \LaTeX~e sono di
-% dimensioni ragguardevoli, oppure ricorrere a pacchetti come
-% \pacchetto{ae}, tanto per citarne solo uno.
+% \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 \\
+% 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. Per quanto riguarda la famiglia
+% Latin Modern, non vi sar\`a alcun supporto per il suo utilizzo fino a
+% quando non avr\`a raggiunto la completa stabilit\`a, ma, se siete disposti
+% a correre qualche rischio, potete aggiungere la dichiarazione appropriata
+% per la famiglia \altro{lmr} nel file di configurazione del pacchetto
+% (vedere \S\ref{sec:config}) utilizzando i parametri impiegati per i font
+% Computer Modern.
%
%
%
% \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 secondo meeting svoltosi a Pisa il 10
-% ottobre 2004.
+% del \guittext\ usato a partire dal meeting svoltosi a Pisa il 10 ottobre
+% 2004.
%
-% Il logo producibile da questo pacchetto, esemplificato in figura
-% \ref{fig:guitmeeting}, \`e il risultato di un gran numero di tentativi di
-% riprodurre correttamente quello originariamente utilizzato per il
-% poster-programma della seconda edizione del meeting. Per questa ragione,
-% il logo viene sempre composto usando la famiglia Computer Modern,
-% indipendentemente dalla famiglia principale usata dall'utente.
+% 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}[!t]
+% \begin{figure}
% \centering
-% \Huge\guitmeeting
-% \caption{Logo del convegno periodico}
+% \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=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}
+% \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}\newline
-% \DescribeMacro{\GuIT*}\oarg{famiglia}\newline
-% \DescribeMacro{\guit}\oarg{famiglia}\newline
-% \DescribeMacro{\guit*}\oarg{famiglia}\newline
+% \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
@@ -287,51 +355,59 @@ Per finire, un sfilza di \guit:
% ``sbavature''. Questi difetti non sono eliminabili, ma \`e stato fatto il
% possibile per minimizzarli.
%
-% Il font utilizzato di default \`e il font attivo nel punto di invocazione
-% del comando (se presente nella lista di quelli supportati dal pacchetto),
-% ma \`e possibile indicarne uno diverso utilizzando l'argomento opzionale e
-% scegliendo come \meta{famiglia} una di quelle supportate.
+% 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:
%
-% \DescribeMacro{\swapGuITcommands}
-% \`E possibile scambiare il significato attribuito a \cs{GuIT} e \cs{GuIT*}
-% in qualunque momento, in modo da ottenere sempre il logo di \guit~a colori
-% pur continuando ad utilizzare semplicemente il comando \cs{GuIT}, oppure
-% ritornare al comportamento originale\footnote{A causa della modifica alla
-% semantica dell'opzione \altro{color}, questo comando \`e decisamente
-% superfluo e verr\`a probabilmente rimosso in futuro.}. Ci\`o pu\`o
-% rivelarsi utile durante la preparazione delle bozze di un qualunque
-% documento, per le quali l'uso del colore fin dalle prime fasi potrebbe
-% essere considerato uno spreco: utilizzando \cs{swapGuITcommands} non \`e
-% pi\`u necessario trasformare tutte le occorrenze di \cs{GuIT} in
-% \cs{GuIT*}. Tenete presente che gli effetti del comando si applicano a
-% livello globale.
+% \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
-% \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 \texttt{coloredelGuIT}.
+% con il nome \altro{coloredelGuIT}.
+%
+% \medskip
%
% \noindent\DescribeMacro{\GuITcolor*}\oarg{modello}\marg{espressione xcolor}\newline
-% \noindent\DescribeMacro{\guitcolor*}\oarg{modello}\marg{espressione xcolor}\newline
-% Se il sistema dell'utente dispone del pacchetto
-% \pacchetto{xcolor}~\cite{Kern05}, il comando \cs{GuITcolor*} 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 in questione. Se
-% \pacchetto{xcolor} non \`e disponibile allora \cs{GuITcolor*} non sortisce
-% alcun effetto. \cs{GuITcolor*} agisce implicitamente su
-% \texttt{coloredelGuIT}, quindi \`e essenzialmente equivalente a
+% \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 \texttt{coloredelGuIT}.
+% 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
@@ -340,10 +416,10 @@ Per finire, un sfilza di \guit:
%
%
% \subsection{Dicitura completa del Gruppo}
-% \DescribeMacro{\GuITtext}
-% \DescribeMacro{\guittext}
% \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
@@ -352,11 +428,26 @@ Per finire, un sfilza di \guit:
% \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}
-% \DescribeMacro{\guiturl}
+% \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}
@@ -364,20 +455,35 @@ Per finire, un sfilza di \guit:
% \TeX\,/\LaTeX. Come per il comando \cs{GuIT} anche in questo caso si pu\`o
% utilizzare l'equivalente forma \cs{guiturl}.
%
-% \DescribeMacro{\GuITforum}
-% \DescribeMacro{\guitforum}
+% \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}
-% \DescribeMacro{\GuITmeeting*}
-% \DescribeMacro{\guitmeeting}
-% \DescribeMacro{\guitmeeting*}
+% \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
@@ -387,22 +493,165 @@ Per finire, un sfilza di \guit:
% 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}; 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}
%
-% \subsection{Creare nuove realizzazioni del logo}
-% \noindent\DescribeMacro{\DeclareGuITLogoCommand}\marg{famiglia}\marg{u-h}\marg{u-v}\marg{i-h}\marg{t-h}\newline
+% 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}.
%
-% I cinque parametri rappresentano:
+% 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\footnote{In questa sede ci si
-% riferisce all'accezione del termine \meta{famiglia} tipica del
-% sistema \emph{NFSS2}.};
+% \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};
@@ -414,31 +663,58 @@ Per finire, un sfilza di \guit:
% 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.
+% 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}
-% Il pacchetto \`e corredato di un piccolo file di configurazione chiamato
-% \altro{guit.cfg} nel quale l'utente pu\`o impostare un colore di default
+% \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 esistente.
+% 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:
+% 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 e dall'uso di
-% \cs{swapGuITcommands}; \emph{prestate bene attenzione al fatto che
-% il significato di quest'opzione \`e radicalmente cambiato rispetto
-% alle versioni precedenti alla 0.7};
+% 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;
+% 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} 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
@@ -446,19 +722,56 @@ Per finire, un sfilza di \guit:
% utilizzare \pacchetto{hyperref} con opzioni particolari dovete
% caricarlo prima di \pacchetto{guit}; inoltre, come effetto
% collaterale dell'uso di \pacchetto{hyperref}, \cs{GuITurl} diventa
-% automaticamente un link al sito internet di \guit.
+% 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}
+%
+% Tutti questi 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.02, 2005/03/24
+% 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},
@@ -471,38 +784,81 @@ Per finire, un sfilza di \guit:
% \section{Il codice}
%
%
+%
% \subsection{Il pacchetto}
% \changes{v0.2}{2003/02/17}{Corretti un paio di errori nel codice}
-% Richiediamo espressamente l'uso di \LaTeXe~e ci annunciamo al mondo.
+% \changes{v0.9}{2005/11/19}{I pacchetti \pacchetto{xcolor} e
+% \pacchetto{hyperref} vengono ora caricati di default; \pacchetto{color}
+% \`e stato definitivamente rimosso}
+% Richiediamo espressamente l'uso di \LaTeXe, ci annunciamo al mondo e
+% carichiamo tutti i pacchetti necessari.
% \begin{macrocode}
%<*style>
\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{guit}[2005/04/08 v0.8.2 Logo del GuIT]
-\RequirePackage{url}
+\ProvidesPackage{guit}[2006/05/24 v0.9 Logo del GuIT]
+\RequirePackage{hyperref, graphics, url}
+\RequirePackage{xcolor}[2004/07/04]
+\RequirePackage{xkeyval}[2005/05/07]
% \end{macrocode}
%
-% \changes{v0.7}{2003/10/17}{Modificata la semantica di \texttt{color}: ora
+% \changes{v0.7}{2003/10/17}{Modificata la semantica di \altro{color}: ora
% forza la colorazione di tutte le occorrenze del logo}
-% Dichiariamo le uniche tre opzioni supportate dal pacchetto, usate per
-% forzare la colorazione di tutte le occorrenze del logo, per escludere
-% completamente il supporto per il colore e per abilitare l'integrazione con
-% il pacchetto \pacchetto{hyperref}.
+% \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
-\@guit@colorizedtrue
-\newif\if@guit@always@colorized
-\newif\if@guit@xcolorized
\newif\if@guit@link
-\DeclareOption{color}{%
- \@guit@colorizedtrue
- \@guit@always@colorizedtrue}
-\DeclareOption{nocolor}{%
- \@guit@colorizedfalse
- \@guit@always@colorizedfalse}
-\DeclareOption{link}{\@guit@linktrue}
+\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}
+% \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=http://www.guit.sssup.it, 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}
+%
% \begin{macro}{\GuITcolor}
% \changes{v0.6}{2003/09/16}{Esteso con una versione ``stellata'' che
% beneficia delle funzionalit\`a di \pacchetto{xcolor}}
@@ -510,81 +866,94 @@ Per finire, un sfilza di \guit:
% culpa)}
% \changes{v0.8.2}{2005/04/08}{Modificata la dichiarazione del colore di
% default}
-% Condizionatamente alle impostazioni attivate, 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.
+% \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}
-\if@guit@colorized
- \IfFileExists{xcolor.sty}%
- {\RequirePackage{xcolor}\@guit@xcolorizedtrue}%
- {\RequirePackage{color}\@guit@xcolorizedfalse}
-% \end{macrocode}
-% Teniamo conto della presenza o meno delle estensioni fornite dal pacchetto
-% \pacchetto{xcolor} e realizziamo due diverse implementazioni dei comandi
-% utilizzati da \cs{GuITcolor}\footnote{In realt\`a \cs{@guit@color@imp}
-% potrebbe essere definito una sola volta se la versione di
-% \pacchetto{xcolor} fosse la 2.00 o superiore; per ora lasciamo le cose
-% come stanno.}.
-% \begin{macrocode}
- \if@guit@xcolorized
- \newcommand*{\@guit@color@imp}[2][cmyk]{%
- \xdefinecolor{coloredelGuIT}{#1}{#2}}
- \newcommand*{\x@guit@color@imp}[2][\@empty]{%
- \ifx\@empty#1%
- \colorlet{coloredelGuIT}{#2}%
- \else
- \colorlet{coloredelGuIT}[#1]{#2}%
- \fi}
+% \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
- \newcommand*{\@guit@color@imp}[2][cmyk]{%
- \definecolor{coloredelGuIT}{#1}{#2}}
- \newcommand*{\x@guit@color@imp}[2][]{\relax}
- \fi
- \GuITcolor{1, 0, 1, 0.6}
-% \end{macrocode}
-% Se l'utente ha escluso volontariamente l'uso del colore, il tutto si
-% risolve con due \cs{relax}.
-% \begin{macrocode}
-\else
- \newcommand*{\@guit@color@imp}[2][]{\relax}
- \newcommand*{\x@guit@color@imp}[2][]{\relax}
-\fi
+ \colorlet{coloredelGuIT}[#1]{#2}%
+ \fi}
+\GuITcolor{1, 0, 1, 0.6}
\let\guitcolor\GuITcolor
% \end{macrocode}
% \end{macro}
+% \end{macro}
%
% \begin{macro}{\@guit@url}
-% Definiamo in un unico punto ed una volta per tutte l'indirizzo del sito
-% internet di \guit~in modo da evitare ripetizioni prone all'errore.
+% \changes{v0.9}{2005/12/26}{Trasformata in una ``chiave'' creata tramite
+% \altro{xkeyval}}
+% L'impostazione dell'indirizzo avviene tramite \cs{setupGuIT} prima
+% dell'inizio del documento.
% \begin{macrocode}
-\def\@guit@url{http://www.guit.sssup.it}
+\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 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.
-% \begin{macrocode}
-\if@guit@link
- \RequirePackage{hyperref}
- \def\@guitimp#1{%
- \begingroup
+% 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
\Hy@colorlinksfalse
\def\@pdfborder{0 0 0}%
- \href{\@guit@url}{\@@guitimp{#1}}%
- \endgroup}
-\else
- \def\@guitimp#1{\@@guitimp{#1}}
-\fi
+ \href{\@guit@url}{\@@guitimp{\@guit@family\@guit@series}}%
+ \else
+ \@@guitimp{\@guit@family\@guit@series}%
+ \fi
+ \endgroup}
% \end{macrocode}
% \end{macro}
%
@@ -608,38 +977,69 @@ Per finire, un sfilza di \guit:
% \end{macrocode}
% \end{macro}
%
-% \begin{macro}{\@gen@guit@fntcmd}
+% \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 in maniera corretta a seconda
-% del font in uso. I cinque parametri rappresentano:
+% 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{enumerate}
-% \item il nome della famiglia di font;
-% \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}
+% \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}
-\def\@gen@guit@fntcmd#1#2#3#4#5{%
- \@namedef{@guit#1}{%
- \fontfamily{#1}\mdseries\scshape
- \@colorize@guit g\kern #2\lower #3\hbox{u}%
- \@decolorize@guit\kern #4 I\@colorize@guit\kern #5 t}}
+\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}{\@guitcmr}
+% \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
@@ -649,61 +1049,87 @@ Per finire, un sfilza di \guit:
% supportati dal pacchetto. \emph{Non \`e possibile creare questa macro con
% \cs{@gen@guit@fntcmd}}.
% \begin{macrocode}
-\def\@guitcmr{%
- \fontencoding{OT1}\fontfamily{cmr}\mdseries\scshape
+\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}{\@guitptm}
+% \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}{\@guitppl}
+% \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}{\@guitpnc}
+% \begin{macro}{\@guitpncm}
% \changes{v0.7.3}{2004/10/11}{Minimi aggiustamenti ai coefficienti di
% traslazione orizzontale e verticale della ``u''}
-% Se il font attualmente in uso \`e il NewCentury Schoolbook verr\`a usata
+% \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}{\@guitput}
+% \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}{\@guitbch}
+% \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}{\@guitpbk}
+% \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
@@ -714,9 +1140,7 @@ Per finire, un sfilza di \guit:
% si utilizza la macro appropriata.
% \begin{macrocode}
\def\@@guitimp#1{%
- \begingroup
- \@ifundefined{@guit#1}{\@guitcmr}{\@nameuse{@guit#1}}%
- \endgroup}
+ \@ifundefined{@guit#1}{\@guitcmrm}{\@nameuse{@guit#1}}}
% \end{macrocode}
% \end{macro}
%
@@ -724,39 +1148,25 @@ Per finire, un sfilza di \guit:
% \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, condizionatamente alle impostazioni generali stabilite con le
-% opzioni del pacchetto. Per scrivere la lettera ``non colorata'' del logo
-% viene riattivato il colore di default rappresentato da \cs{normalcolor}.
+% del logo in seguito alla presenza del carattere \altro{*}.
% \begin{macrocode}
-\if@guit@colorized
- \newcommand*{\@guit@color@on}[1][\f@family]{%
- \def\@colorize@guit{\color{coloredelGuIT}}%
- \def\@decolorize@guit{\normalcolor}%
- \@guitimp{#1}\ignorespaces}
-\else
- \newcommand*{\@guit@color@on}[1][\f@family]{%
- \def\@colorize@guit{\normalcolor}%
- \def\@decolorize@guit{\normalcolor}%
- \@guitimp{#1}\ignorespaces}
-\fi
+\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}
-% La porzione dell'implementazione di \cs{GuIT} che disattiva la colorazione
-% del logo. Se \`e stata precedentemente specificata l'opzione |color| il
-% tutto si riduce ad eguagliare questo comando al precedente.
+% \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}
-\if@guit@always@colorized
- \let\@guit@color@off\@guit@color@on
-\else
- \newcommand*{\@guit@color@off}[1][\f@family]{%
- \def\@colorize@guit{\normalcolor}%
- \def\@decolorize@guit{\normalcolor}%
- \@guitimp{#1}\ignorespaces}
-\fi
+\newcommand*{\@guit@color@off}[1][]{%
+ \@guitimp{#1}\ignorespaces}
% \end{macrocode}
% \end{macro}
%
@@ -779,47 +1189,26 @@ Per finire, un sfilza di \guit:
% \end{macrocode}
% \end{macro}
%
-% \begin{macro}{\swapGuITcommands}
-% \changes{v0.6}{2003/09/16}{Aggiunto questo comando per scambiare \cs{GuIT}
-% con \cs{GuIT*}}
-% \changes{v0.7}{2003/09/26}{Trasformato in un comando \emph{robusto} (mea
-% culpa)}
-% Scambiare il significato di \cs{GuIT*} e \cs{GuIT} si riduce a scambiare
-% tra loro le implementazioni di \cs{guit@color@on} e \cs{guit@color@off},
-% ma se il colore \`e stato intenzionalmente escluso, questa macro non
-% esegue alcuna operazione. Per evitare grattacapi, l'utente viene avvertito
-% dello scambio appena effettuato.
-% \begin{macrocode}
-\if@guit@colorized
- \DeclareRobustCommand*{\swapGuITcommands}{%
- \begingroup
- \let\reserved@a\@guit@color@on
- \global\let\@guit@color@on\@guit@color@off
- \global\let\@guit@color@off\reserved@a
- \endgroup
- \PackageWarning{guit}{Swapping \string\GuIT* and \string\GuIT}}
-\else
- \let\swapGuITcommands\relax
-\fi
-% \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}}
-% Il comando per indicare la denominazione completa e corretta del Gruppo
-% ha una doppia implementazione, a seconda che sia stata specificata o meno
-% l'opzione |link|.
+% \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}
-\if@guit@link
- \DeclareRobustCommand*{\GuITtext}{%
- \href{\@guit@url}{Gruppo Utilizzatori Italiani di \TeX}}
-\else
- \DeclareRobustCommand*{\GuITtext}{%
- Gruppo Utilizzatori Italiani di \TeX}
-\fi
+\DeclareRobustCommand*{\GuITtext}[1][]{%
+ \begingroup
+ \setkeys*{guit}{#1}%
+ \if@guit@link
+ \href{\@guit@url}{Gruppo Utilizzatori Italiani di \TeX}%
+ \else
+ Gruppo Utilizzatori Italiani di \TeX
+ \fi
+ \endgroup
+ \ignorespaces}
% \end{macrocode}
% \end{macro}
%
@@ -831,20 +1220,64 @@ Per finire, un sfilza di \guit:
% \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
+ \href{\@guit@url}{Italian \TeX\ User Group}%
+ \else
+ Italian \TeX\ User Group%
+ \fi
+ \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~ha, implicitamente, una definizione dal duplice comportamento: se
-% l'opzione |link| non \`e stata specificata (e \pacchetto{hyperref} non \`e
-% stato caricato per altri motivi) \cs{GuITurl} si limita a scrivere
-% l'indirizzo del sito; se \pacchetto{hyperref} \`e stato caricato (come
-% effetto dell'opzione |link| o per altri motivi), il comando scrive
-% l'indirizzo del sito come collegamento al sito stesso a causa della
-% ridefinizione di \cs{url} operata da \pacchetto{hyperref}.
+% \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}{%
- \expandafter\url\expandafter{\@guit@url}}
+\DeclareRobustCommand*{\GuITurl}[1][]{%
+ \begingroup
+ \setkeys*{guit}{#1}%
+ \if@guit@link
+ \let\@guit@url@imp\url
+ \else
+ \let\@guit@url@imp\@guit@url@nolink
+ \fi
+ \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}
%
@@ -859,10 +1292,13 @@ Per finire, un sfilza di \guit:
% \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}
% Quanto detto per \cs{GuITurl} vale anche per questo comando.
% \begin{macrocode}
-\DeclareRobustCommand*{\GuITforum}{%
- \expandafter\url\expandafter{\@guit@url /phpbb}}
+\DeclareRobustCommand*{\GuITforum}[1][]{%
+ \guiturl[#1, document=forum]}
% \end{macrocode}
% \end{macro}
%
@@ -884,6 +1320,8 @@ Per finire, un sfilza di \guit:
% 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}
@@ -891,34 +1329,96 @@ Per finire, un sfilza di \guit:
% l'ultima volta)}
% \changes{v0.8.1}{2004/11/15}{Aggiunta l'indicazione dell'encoding da
% usare}
-% \begin{macro}{\@guit@meeting@part}
+% \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. 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}).
+% realizzare una versione a colori duplicando poco codice.
% \begin{macrocode}
\DeclareRobustCommand*{\GuITmeeting}{%
\@ifstar\@guit@meeting@color@on\@guit@meeting@color@off}
-\def\@guit@meeting@color@on{%
- \begingroup
- \fontencoding{OT1}\fontfamily{cmr}\fontseries{m}\selectfont
- \guit*\@guit@meeting@part
- \endgroup
- \ignorespaces}
-\def\@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\@guit@meeting@part
+ \guit#1
+ \if@guit@inline
+ \@guit@meeting@part\@guit@meeting@year
+ \else
+ \@guit@meeting@year\@guit@meeting@part
+ \fi
\endgroup
\ignorespaces}
-\def\@guit@meeting@part{%
- \kern -2.02ex\lower 1.25ex\hbox{\textit{meeting}}}
% \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}
%
@@ -930,6 +1430,46 @@ Per finire, un sfilza di \guit:
% \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}
@@ -944,20 +1484,26 @@ Per finire, un sfilza di \guit:
% \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 nel file di configurazione per
-% diminuire il rischio che l'utente le modifichi o le rimuova
+% 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}[2005/04/08 v0.8.2 File di configurazione di guit.sty]
+\ProvidesFile{guit.cfg}[2006/05/24 v0.9 File di configurazione di guit.sty]
%% Esempi:
%% \GuITcolor{1, 0, 1, 0.6}
%% \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}
%</cfg>
% \end{macrocode}
%
diff --git a/Master/texmf-dist/source/latex/GuIT/guit.ins b/Master/texmf-dist/source/latex/GuIT/guit.ins
index fdf70cd6bff..162998a76ef 100644
--- a/Master/texmf-dist/source/latex/GuIT/guit.ins
+++ b/Master/texmf-dist/source/latex/GuIT/guit.ins
@@ -1,6 +1,6 @@
%%
%% guit.ins
-%% Copyright 2003, 2004, 2005 Gruppo Utilizzatori Italiani di TeX
+%% Copyright 2003, 2004, 2005, 2006 Gruppo Utilizzatori Italiani di TeX
%%
%% This work may be distributed and/or modified under the
%% conditions of the LaTeX Project Public License, either
@@ -15,7 +15,7 @@
%% This work has the LPPL maintenance status "author-maintained".
%%
%% This work consists of the files: README, guit.dtx, guit.ins and the
-%% derived files guit.sty, guit.cfg and guittext.tex
+%% 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
@@ -26,7 +26,7 @@
\input docstrip
\preamble
- Copyright 2003, 2004, 2005 Gruppo Utilizzatori Italiani di TeX
+ Copyright 2003, 2004, 2005, 2006 Gruppo Utilizzatori Italiani di TeX
This work may be distributed and/or modified under the
conditions of the LaTeX Project Public License, either
@@ -41,7 +41,7 @@
This work has the LPPL maintenance status "author-maintained".
This work consists of the files: README, guit.dtx, guit.ins and the
- derived files guit.sty, guit.cfg and guittext.tex
+ derived files guit.sty, guit.cfg and guittest.tex
\endpreamble
diff --git a/Master/texmf-dist/tex/latex/GuIT/guit.cfg b/Master/texmf-dist/tex/latex/GuIT/guit.cfg
index cb4472a9e95..5466564e239 100644
--- a/Master/texmf-dist/tex/latex/GuIT/guit.cfg
+++ b/Master/texmf-dist/tex/latex/GuIT/guit.cfg
@@ -6,7 +6,7 @@
%%
%% guit.dtx (with options: `cfg')
%%
-%% Copyright 2003, 2004, 2005 Gruppo Utilizzatori Italiani di TeX
+%% Copyright 2003, 2004, 2005, 2006 Gruppo Utilizzatori Italiani di TeX
%%
%% This work may be distributed and/or modified under the
%% conditions of the LaTeX Project Public License, either
@@ -21,17 +21,23 @@
%% This work has the LPPL maintenance status "author-maintained".
%%
%% This work consists of the files: README, guit.dtx, guit.ins and the
-%% derived files guit.sty, guit.cfg and guittext.tex
+%% derived files guit.sty, guit.cfg and guittest.tex
%%
-\ProvidesFile{guit.cfg}[2005/04/08 v0.8.2 File di configurazione di guit.sty]
+\ProvidesFile{guit.cfg}[2006/05/24 v0.9 File di configurazione di guit.sty]
%% Esempi:
%% \GuITcolor{1, 0, 1, 0.6}
%% \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}
\endinput
%%
%% End of file `guit.cfg'.
diff --git a/Master/texmf-dist/tex/latex/GuIT/guit.sty b/Master/texmf-dist/tex/latex/GuIT/guit.sty
index a2e30095b0a..9adfe9c944f 100644
--- a/Master/texmf-dist/tex/latex/GuIT/guit.sty
+++ b/Master/texmf-dist/tex/latex/GuIT/guit.sty
@@ -6,7 +6,7 @@
%%
%% guit.dtx (with options: `style')
%%
-%% Copyright 2003, 2004, 2005 Gruppo Utilizzatori Italiani di TeX
+%% Copyright 2003, 2004, 2005, 2006 Gruppo Utilizzatori Italiani di TeX
%%
%% This work may be distributed and/or modified under the
%% conditions of the LaTeX Project Public License, either
@@ -21,148 +21,262 @@
%% This work has the LPPL maintenance status "author-maintained".
%%
%% This work consists of the files: README, guit.dtx, guit.ins and the
-%% derived files guit.sty, guit.cfg and guittext.tex
+%% derived files guit.sty, guit.cfg and guittest.tex
%%
\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{guit}[2005/04/08 v0.8.2 Logo del GuIT]
-\RequirePackage{url}
+\ProvidesPackage{guit}[2006/05/24 v0.9 Logo del GuIT]
+\RequirePackage{hyperref, graphics, url}
+\RequirePackage{xcolor}[2004/07/04]
+\RequirePackage{xkeyval}[2005/05/07]
\newif\if@guit@colorized
-\@guit@colorizedtrue
-\newif\if@guit@always@colorized
-\newif\if@guit@xcolorized
\newif\if@guit@link
-\DeclareOption{color}{%
- \@guit@colorizedtrue
- \@guit@always@colorizedtrue}
-\DeclareOption{nocolor}{%
- \@guit@colorizedfalse
- \@guit@always@colorizedfalse}
-\DeclareOption{link}{\@guit@linktrue}
+\DeclareOption{color}{\AtEndOfPackage{\setupGuIT[color=yes]}}
+\DeclareOption{nocolor}{\AtEndOfPackage{\setupGuIT[color=no]}}
+\DeclareOption{link}{\AtEndOfPackage{\setupGuIT[link=yes]}}
\ProcessOptions\relax
+\DeclareRobustCommand{\setupGuIT}[1][color=no, link=no, family=, series=, url=http://www.guit.sssup.it, document=, year=, style=display]{%
+ \setkeys*{guit}{#1}%
+ \ignorespaces}
+\let\setupguit\setupGuIT
+\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}}
\DeclareRobustCommand*{\GuITcolor}{%
\@ifstar\x@guit@color@imp\@guit@color@imp}
-\if@guit@colorized
- \IfFileExists{xcolor.sty}%
- {\RequirePackage{xcolor}\@guit@xcolorizedtrue}%
- {\RequirePackage{color}\@guit@xcolorizedfalse}
- \if@guit@xcolorized
- \newcommand*{\@guit@color@imp}[2][cmyk]{%
- \xdefinecolor{coloredelGuIT}{#1}{#2}}
- \newcommand*{\x@guit@color@imp}[2][\@empty]{%
- \ifx\@empty#1%
- \colorlet{coloredelGuIT}{#2}%
- \else
- \colorlet{coloredelGuIT}[#1]{#2}%
- \fi}
+\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
- \newcommand*{\@guit@color@imp}[2][cmyk]{%
- \definecolor{coloredelGuIT}{#1}{#2}}
- \newcommand*{\x@guit@color@imp}[2][]{\relax}
- \fi
- \GuITcolor{1, 0, 1, 0.6}
-\else
- \newcommand*{\@guit@color@imp}[2][]{\relax}
- \newcommand*{\x@guit@color@imp}[2][]{\relax}
-\fi
+ \colorlet{coloredelGuIT}[#1]{#2}%
+ \fi}
+\GuITcolor{1, 0, 1, 0.6}
\let\guitcolor\GuITcolor
-\def\@guit@url{http://www.guit.sssup.it}
-\if@guit@link
- \RequirePackage{hyperref}
- \def\@guitimp#1{%
- \begingroup
+\define@cmdkey{guit}[@guit@]{url}{\relax}
+\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
\Hy@colorlinksfalse
\def\@pdfborder{0 0 0}%
- \href{\@guit@url}{\@@guitimp{#1}}%
- \endgroup}
-\else
- \def\@guitimp#1{\@@guitimp{#1}}
-\fi
+ \href{\@guit@url}{\@@guitimp{\@guit@family\@guit@series}}%
+ \else
+ \@@guitimp{\@guit@family\@guit@series}%
+ \fi
+ \endgroup}
\DeclareRobustCommand*{\DeclareGuITLogoCommand}{%
\@gen@guit@fntcmd}
\@onlypreamble\DeclareGuITLogoCommand
-\def\@gen@guit@fntcmd#1#2#3#4#5{%
- \@namedef{@guit#1}{%
- \fontfamily{#1}\mdseries\scshape
- \@colorize@guit g\kern #2\lower #3\hbox{u}%
- \@decolorize@guit\kern #4 I\@colorize@guit\kern #5 t}}
-\def\@guitcmr{%
- \fontencoding{OT1}\fontfamily{cmr}\mdseries\scshape
+\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}}
+\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
+\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}}
\@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}
\@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}
\@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}
\@gen@guit@fntcmd{put}{-0.285em}{0.61ex}{-0.125em}{-0.125em}
+\AliasGuITLogoCommand{put}{bx}{put}{m}
\@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}
\@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}
\def\@@guitimp#1{%
- \begingroup
- \@ifundefined{@guit#1}{\@guitcmr}{\@nameuse{@guit#1}}%
- \endgroup}
-\if@guit@colorized
- \newcommand*{\@guit@color@on}[1][\f@family]{%
- \def\@colorize@guit{\color{coloredelGuIT}}%
- \def\@decolorize@guit{\normalcolor}%
- \@guitimp{#1}\ignorespaces}
-\else
- \newcommand*{\@guit@color@on}[1][\f@family]{%
- \def\@colorize@guit{\normalcolor}%
- \def\@decolorize@guit{\normalcolor}%
- \@guitimp{#1}\ignorespaces}
-\fi
-\if@guit@always@colorized
- \let\@guit@color@off\@guit@color@on
-\else
- \newcommand*{\@guit@color@off}[1][\f@family]{%
- \def\@colorize@guit{\normalcolor}%
- \def\@decolorize@guit{\normalcolor}%
- \@guitimp{#1}\ignorespaces}
-\fi
+ \@ifundefined{@guit#1}{\@guitcmrm}{\@nameuse{@guit#1}}}
+\newcommand*{\@guit@color@on}[1][]{%
+ \@guitimp{color, #1}\ignorespaces}
+\newcommand*{\@guit@color@off}[1][]{%
+ \@guitimp{#1}\ignorespaces}
\DeclareRobustCommand*{\GuIT}{%
\@ifstar\@guit@color@on\@guit@color@off}
\let\guit\GuIT
-\if@guit@colorized
- \DeclareRobustCommand*{\swapGuITcommands}{%
- \begingroup
- \let\reserved@a\@guit@color@on
- \global\let\@guit@color@on\@guit@color@off
- \global\let\@guit@color@off\reserved@a
- \endgroup
- \PackageWarning{guit}{Swapping \string\GuIT* and \string\GuIT}}
-\else
- \let\swapGuITcommands\relax
-\fi
-\if@guit@link
- \DeclareRobustCommand*{\GuITtext}{%
- \href{\@guit@url}{Gruppo Utilizzatori Italiani di \TeX}}
-\else
- \DeclareRobustCommand*{\GuITtext}{%
- Gruppo Utilizzatori Italiani di \TeX}
-\fi
+\DeclareRobustCommand*{\GuITtext}[1][]{%
+ \begingroup
+ \setkeys*{guit}{#1}%
+ \if@guit@link
+ \href{\@guit@url}{Gruppo Utilizzatori Italiani di \TeX}%
+ \else
+ Gruppo Utilizzatori Italiani di \TeX
+ \fi
+ \endgroup
+ \ignorespaces}
\let\guittext\GuITtext
-\DeclareRobustCommand*{\GuITurl}{%
- \expandafter\url\expandafter{\@guit@url}}
+\DeclareRobustCommand*{\GuITtextEn}[1][]{%
+ \begingroup
+ \setkeys*{guit}{#1}%
+ \if@guit@link
+ \href{\@guit@url}{Italian \TeX\ User Group}%
+ \else
+ Italian \TeX\ User Group%
+ \fi
+ \endgroup
+ \ignorespaces}
+\let\guittexten\GuITtextEn
+\DeclareRobustCommand*{\GuITurl}[1][]{%
+ \begingroup
+ \setkeys*{guit}{#1}%
+ \if@guit@link
+ \let\@guit@url@imp\url
+ \else
+ \let\@guit@url@imp\@guit@url@nolink
+ \fi
+ \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}
\let\guiturl\GuITurl
-\DeclareRobustCommand*{\GuITforum}{%
- \expandafter\url\expandafter{\@guit@url /phpbb}}
+\DeclareRobustCommand*{\GuITforum}[1][]{%
+ \guiturl[#1, document=forum]}
\let\guitforum\GuITforum
\DeclareRobustCommand*{\GuITmeeting}{%
\@ifstar\@guit@meeting@color@on\@guit@meeting@color@off}
-\def\@guit@meeting@color@on{%
+\newcommand*{\@guit@meeting@color@on}[1][]{%
+ \@guit@meeting@imp{*}{#1}}
+\newcommand*{\@guit@meeting@color@off}[1][]{%
+ \@guit@meeting@imp{}{#1}}
+\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}
+\def\@guit@meeting@imp#1#2{%
\begingroup
+ \setkeys*{guit}{#2}%
\fontencoding{OT1}\fontfamily{cmr}\fontseries{m}\selectfont
- \guit*\@guit@meeting@part
- \endgroup
- \ignorespaces}
-\def\@guit@meeting@color@off{%
- \begingroup
- \fontencoding{OT1}\fontfamily{cmr}\fontseries{m}\selectfont
- \guit\@guit@meeting@part
+ \guit#1
+ \if@guit@inline
+ \@guit@meeting@part\@guit@meeting@year
+ \else
+ \@guit@meeting@year\@guit@meeting@part
+ \fi
\endgroup
\ignorespaces}
\def\@guit@meeting@part{%
- \kern -2.02ex\lower 1.25ex\hbox{\textit{meeting}}}
+ \if@guit@inline
+ \textit{meeting}%
+ \else
+ \kern -2.02ex\lower 1.25ex\hbox{\textit{meeting}}%
+ \fi}
+\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}
\let\guitmeeting\GuITmeeting
+\setupGuIT
+\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}}
\InputIfFileExists{guit.cfg}%
{\relax}%
{\PackageWarning{guit}{Configuration file not found}}
diff --git a/Master/texmf-dist/tpm/GuIT.tpm b/Master/texmf-dist/tpm/GuIT.tpm
index d6d542b09d0..44f48b873a3 100644
--- a/Master/texmf-dist/tpm/GuIT.tpm
+++ b/Master/texmf-dist/tpm/GuIT.tpm
@@ -3,7 +3,7 @@
<rdf:Description about="http://texlive.dante.de/texlive/Package/GuIT.zip">
<TPM:Name>GuIT</TPM:Name>
<TPM:Type>Package</TPM:Type>
- <TPM:Date>2006/01/11 23:49:49</TPM:Date>
+ <TPM:Date>2006/05/28 22:04:52</TPM:Date>
<TPM:Version>2005/04/08 v0.8.2</TPM:Version>
<TPM:Creator>rahtz</TPM:Creator>
<TPM:Title>The GuIT package.</TPM:Title>
@@ -11,18 +11,18 @@
<TPM:Author></TPM:Author>
<TPM:Size>310081</TPM:Size>
<TPM:Build/>
- <TPM:RunFiles size="8009">
+ <TPM:RunFiles size="12192">
texmf-dist/tex/latex/GuIT/guit.cfg
texmf-dist/tex/latex/GuIT/guit.sty
texmf-dist/tpm/GuIT.tpm
</TPM:RunFiles>
- <TPM:DocFiles size="261344">
+ <TPM:DocFiles size="342396">
texmf-dist/doc/latex/GuIT/README
texmf-dist/doc/latex/GuIT/guit.pdf
texmf-dist/doc/latex/GuIT/guittest.pdf
texmf-dist/doc/latex/GuIT/guittest.tex
</TPM:DocFiles>
- <TPM:SourceFiles size="40728">
+ <TPM:SourceFiles size="64426">
texmf-dist/source/latex/GuIT/guit.dtx
texmf-dist/source/latex/GuIT/guit.ins
</TPM:SourceFiles>