diff options
author | Karl Berry <karl@freefriends.org> | 2006-05-28 22:05:36 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2006-05-28 22:05:36 +0000 |
commit | c3c87346c0cbca209e6fb9ed6084b95f274edcb9 (patch) | |
tree | 087b9009fe07fa2dabd93dbc3b256c9bdf62ce67 /Master | |
parent | 93ce74b7c7168e00ab65c8543563fa0188deebf5 (diff) |
guit update
git-svn-id: svn://tug.org/texlive/trunk@1606 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r-- | Master/texmf-dist/doc/latex/GuIT/README | 35 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/GuIT/guit.pdf | bin | 161156 -> 223691 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/GuIT/guittest.pdf | bin | 91661 -> 109530 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/GuIT/guittest.tex | 32 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/GuIT/guit.dtx | 1192 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/GuIT/guit.ins | 8 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/GuIT/guit.cfg | 12 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/GuIT/guit.sty | 326 | ||||
-rw-r--r-- | Master/texmf-dist/tpm/GuIT.tpm | 8 |
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 Binary files differindex 26e09c0d7e4..ef923a2be4e 100644 --- a/Master/texmf-dist/doc/latex/GuIT/guit.pdf +++ b/Master/texmf-dist/doc/latex/GuIT/guit.pdf diff --git a/Master/texmf-dist/doc/latex/GuIT/guittest.pdf b/Master/texmf-dist/doc/latex/GuIT/guittest.pdf Binary files differindex 28128401313..ee6816e1a17 100644 --- a/Master/texmf-dist/doc/latex/GuIT/guittest.pdf +++ b/Master/texmf-dist/doc/latex/GuIT/guittest.pdf 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> |