Debian Codegraph @

texmf-dist/source/latex/guitlogo/guit.dtx

raw
1 % \iffalse
2 %
3 % guit.dtx
4 % Copyright 2003-2006, 2009, 2012, 2019, 2020 Gruppo Utilizzatori
5 % Italiani di TeX
6 %
7 % This work may be distributed and/or modified under the
8 % conditions of the LaTeX Project Public License, either
9 % version 1.3a of this license or (at your option) any
10 % later version.
11 % The latest version of the license is in
12 % https://www.latex-project.org/lppl.txt
13 %
14 % Author: Emanuele Vicentini
15 % (emanuelevicentini at yahoo dot it)
16 %
17 % This work has the LPPL maintenance status "maintained".
18 %
19 % The Current Maintainer of this work is Emanuele Vicentini.
20 %
21 % This work consists of the files: README, guit.dtx, guit.ins and the
22 % derived files guit.sty, guit.cfg and guittest.tex
23 %
24 %<*driver>
25 \documentclass[10pt, a4paper]{ltxdoc}
26 \usepackage[italian]{babel}
27 \usepackage{booktabs, guit, subfig, tabularx, hyperref, footnote}
28 \makesavenoteenv{table}
29 \EnableCrossrefs
30 \CodelineIndex
31 \RecordChanges
32 \OnlyDescription
33 \begin{document}
34 \DocInput{guit.dtx}
35 \end{document}
36 %</driver>
37 %
38 %<*test>
39 \documentclass[11pt, a4paper]{article}
40 \usepackage[margin=1in, noheadfoot]{geometry}
41 \usepackage{booktabs, guit, rotating, hyperref}
42
43 \pagestyle{empty}
44 \setupguit[link]
45
46 \begin{document}
47 \section*{Piccolo test per \guit}
48 Vediamo un po' come si comporta in una footnote\footnote{\guit~\guit\ldots
49 direi che \`e passabile, no?}. Diamoci\footnote{Un'altra nota:
50 \fontfamily{pzc}\fontseries{mb}\fontshape{it}\selectfont\guittext} dentro
51 con qualche cosa\footnote{Un ultima nota: Copyright 2003-2006, 2009, 2012,
52 2019, 2020 \guittext} di ``strambo'':
53
54 \begin{center}
55 \itshape\guit~agus \TeX~go br\'ach!\\
56 $==$\\
57 \rmfamily\bfseries\guit~and \TeX~forever!
58 \end{center}
59
60 Una piccola ``spirale'' colorata e divertente:
61
62 \begingroup
63 \setupGuIT[color=yes]
64 \GuITcolor[rgb]{1, 0, 0}
65 \newcount\wang
66 \newsavebox{\wangtext}
67 \newdimen\wangspace
68 \def\wheel#1{\savebox{\wangtext}{#1}%
69 \wangspace\wd\wangtext
70 \advance\wangspace by 1cm%
71 \centerline{%
72 \rule{0pt}{\wangspace}%
73 \rule[-\wangspace]{0pt}{\wangspace}%
74 \wang=-180
75 \loop
76 \ifnum\wang<180
77 \rlap{\begin{rotate}{\the\wang}%
78 \rule{0.75cm}{0pt}#1
79 \end{rotate}}%
80 \advance\wang by 20
81 \space
82 \guitcolor*{coloredelGuIT!90!green}%
83 \repeat}}
84 \wheel{\guit}
85 \endgroup
86
87 Ed ora una tabella riepilogativa parziale dei font supportati dalla versione
88 attuale.
89
90 \begin{center}
91 \begin{tabular}{lc}
92 \toprule
93 Font & Logo \\
94 \midrule
95 Computer Modern Roman & \guit[family=cmr] \\
96 Latin Modern & \guit[family=lmr] \\
97 Times New Roman & \guit[family=ptm] \\
98 Palatino & \guit[family=ppl] \\
99 NewCentury Schoolbook & \guit[family=pnc] \\
100 Charter & \guit[family=bch] \\
101 Bookman & \guit[family=pbk] \\
102 \bottomrule
103 \end{tabular}
104 \end{center}
105
106 Per finire, un sfilza di \guit:
107
108 \begingroup
109 \let\pippo\par
110 \makeatletter
111 \@tfor\famiglia:={cmr}{lmr}{ptm}{ppl}{pnc}{bch}{pbk}\do{%
112 \noindent
113 \setupGuIT[family=\famiglia]
114 \@tfor\dimensione:=\tiny\scriptsize\footnotesize\small\normalsize
115 \large\Large\LARGE\huge\do{%
116 \dimensione\guit~}%
117 \Huge\guit\pippo}%
118 \endgroup
119
120 \begin{center}
121 \Huge Venite tutti al prossimo \guitmeeting[color]
122 \end{center}
123
124 \end{document}
125 %</test>
126 % \fi
127 %
128 %
129 %
130 % \CheckSum{546}
131 %
132 % \CharacterTable
133 % {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
134 % Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
135 % Digits \0\1\2\3\4\5\6\7\8\9
136 % Exclamation \! Double quote \" Hash (number) \#
137 % Dollar \$ Percent \% Ampersand \&
138 % Acute accent \' Left paren \( Right paren \)
139 % Asterisk \* Plus \+ Comma \,
140 % Minus \- Point \. Solidus \/
141 % Colon \: Semicolon \; Less than \<
142 % Equals \= Greater than \> Question mark \?
143 % Commercial at \@ Left bracket \[ Backslash \\
144 % Right bracket \] Circumflex \^ Underscore \_
145 % Grave accent \` Left brace \{ Vertical bar \|
146 % Right brace \} Tilde \~}
147 %
148 %
149 %
150 % \GetFileInfo{guit.sty}
151 %
152 %
153 %
154 % \newcommand*{\pacchetto}[1]{\textsf{#1}}
155 % \newcommand*{\altro}[1]{\texttt{#1}}
156 %
157 %
158 %
159 % \changes{v0.1}{2003/02/15}{Prima release pubblica del pacchetto}
160 % \changes{v0.2}{2003/02/21}{Arricchito il file di test del pacchetto}
161 % \changes{v0.5}{2003/09/04}{Aggiunta tutta la gestione del colore nel logo}
162 % \changes{v0.6}{2003/09/16}{Effettuate un paio di modifiche al file di
163 % test}
164 % \changes{v0.7}{2003/10/10}{Rimossi dal file di test gli usi del font
165 % Utopia}
166 % \changes{v0.7}{2003/10/13}{Integrato il pacchetto \pacchetto{hyperref} su
167 % richiesta di Fabiano Busdraghi}
168 % \changes{v0.7.2}{2004/09/16}{Aggiornata la documentazione riferentesi a
169 % \pacchetto{xcolor}}
170 % \changes{v0.7.2}{2004/09/16}{Personalizzati indice e change history}
171 % \changes{v0.7.3}{2004/10/11}{Alcune piccole modifiche al file di test}
172 % \changes{v0.8}{2004/10/28}{Riallineato il file di test all'ultima modifica
173 % della sintassi di \cs{GuIT}}
174 % \changes{v0.8.2}{2005/04/08}{Aggiunto il file di configurazione esterno}
175 % \changes{v0.9}{2005/11/21}{Modificata l'interfaccia in modo da fare ampio
176 % uso di chiavi definite tramite \pacchetto{xkeyval} (ora ricorda molto lo
177 % ``stile'' di Con\TeX t); mantenuta la compatibilit\`a quasi totale con
178 % le versioni precedenti, ma \cs{swapGuITcommands} \`e stato
179 % definitivamente rimosso}
180 % \changes{v0.9}{2005/11/27}{Il logo ora pu\`o essere composto anche usando
181 % la serie \altro{bx}}
182 % \changes{v0.9}{2005/12/03}{Nel file di test ora viene impostata
183 % globalmente la chiave \altro{link}}
184 % \changes{v1.0.0}{2012/11/03}{Aggiunto il supporto per Latin Modern}
185 %
186 %
187 %
188 % \title{Documentazione del pacchetto \pacchetto{guit}\thanks{Il numero di
189 % versione di questo file \`e \fileversion; l'ultima revisione \`e avvenuta
190 % in data \filedate.}}
191 % \author{Emanuele Vicentini\\(\texttt{emanuelevicentini at yahoo dot it})}
192 % \date{\filedate}
193 %
194 %
195 %
196 % \maketitle
197 % \begin{abstract}
198 % Questo piccolissimo pacchetto permette di riprodurre il logo del
199 % \emph{\guittext} (\emph{\guittexten}) in maniera sufficientemente
200 % indipendente dal font utilizzato, cercando di mantenerne l'aspetto
201 % originale.
202 % \end{abstract}
203 % \tableofcontents
204 % \clearpage
205 %
206 %
207 %
208 % \section{Introduzione}
209 % Questa documentazione \`e stata scritta seguendo le convenzioni
210 % dell'applicazione \LaTeX~\textsc{docstrip} che permette l'estrazione
211 % automatica del codice \LaTeX~dal file di documentazione~\cite{GOOSSENS94}.
212 %
213 %
214 %
215 % \iffalse\section{I logo}\fi
216 %
217 %
218 %
219 % \section{Il logo del Gruppo}
220 % Per riprodurre il pi\`u fedelmente possibile il logo del \guit~ho deciso
221 % che la soluzione migliore per ottenere gli effetti desiderati fosse quella
222 % di utilizzare solo font con Caps \& Small Caps. I font attualmente
223 % supportati\footnote{Il font Utopia non \`e presente in tutte le
224 % distribuzioni di \TeX/\LaTeX~per motivi legali e non \`e pi\`u considerato
225 % un componente fondamentale, quindi nel file di esempio che accompagna
226 % questo pacchetto il font Utopia non \`e stato utilizzato. Se qualche
227 % persona volenterosa potesse controllare i coefficienti utilizzati per
228 % questo font e volesse contribuire con i coefficienti per usare Utopia con
229 % la serie \altro{bx}, sarebbe sempre ben accetta.} sono elencati nella
230 % tabella~\ref{tab:font}.
231 %
232 % \begin{table}[!h]
233 % \centering
234 % \begin{tabular}{l>{\ttfamily}cc>{\scshape}c}
235 % \toprule
236 % \itshape Font & \normalfont\itshape Famiglia & \itshape Bx & \itshape Provenienza \\
237 % \midrule
238 % Computer Modern Roman & cmr & No & \normalfont Standard \\
239 % Latin Modern & lmr & S\`\i\footnote{In realt\`a viene usata solo la serie \altro{m}.} & lm \\
240 % Times & ptm & S\`\i & psnfss \\
241 % Palatino & ppl & S\`\i & psnfss \\
242 % New Century Schoolbook & pnc & S\`\i & psnfss \\
243 % Utopia & put & S\`\i\footnote{In realt\`a viene usata solo la serie \altro{m}.} & psnfss \\
244 % Charter & bch & S\`\i & psnfss \\
245 % Bookman & pbk & S\`\i & psnfss \\
246 % \bottomrule
247 % \end{tabular}
248 % \caption{Font attualmente supportati}
249 % \label{tab:font}
250 % \end{table}
251 %
252 % Per evitare spiacevoli ed inaspettati effetti dovuti a combinazioni dei
253 % parametri \textsc{nfss2} indicanti font inesistenti nella famiglia
254 % Computer Modern originale (esempio: \altro{OT1/cmr/bx/sc} non esiste e
255 % viene sostituito automaticamente con \altro{OT1/cmr/bx/n}), tutte le
256 % occorrenze del logo composte con la famiglia Computer Roman usano il font
257 % \altro{OT1/cmr/m/sc}. Le altre famiglie, laddove esista il font
258 % appropriato, possono essere utilizzate anche con serie e codifiche
259 % diverse, ma questo pacchetto fornisce solo le istanze preconfezionate per
260 % le serie \altro{m} e \altro{bx}. Il pacchetto \`e stato testato solo con
261 % le codifiche \altro{OT1} e \altro{T1}; conferme riguardanti il corretto
262 % utilizzo del pacchetto con codifiche diverse saranno sicuramente
263 % benvenute.
264 %
265 % L'idea di utilizzare la codifica \altro{T1} per la famiglia Computer
266 % Modern (perch\'e esiste il font \altro{T1/cmr/bx/sc}) \`e stata scartata a
267 % priori perch\'e i font in formato Type1 di tale famiglia non sono ancora,
268 % a mio parere, sufficientemente diffusi.
269 %
270 %
271 %
272 % \section{Il logo del convegno}
273 % Per cercare di alleviare parte del lavoro degli organizzatori, ho cercato
274 % di riprodurre, per quanto mi \`e possibile, il logo del convegno periodico
275 % del \guittext\ usato a partire dal meeting svoltosi a Pisa il 10 ottobre
276 % 2004.
277 %
278 % Il logo producibile da questo pacchetto, esemplificato nella
279 % figura~\ref{fig:guitmeeting}, \`e il risultato di un gran numero di
280 % tentativi di riprodurre correttamente quello originariamente utilizzato
281 % per il poster-programma del meeting di quell'anno. Per questa ragione, il
282 % logo viene sempre composto usando la famiglia Computer Modern,
283 % indipendentemente dalla famiglia principale usata nel documento.
284 %
285 % Come molti processi automatici, anche questo non \`e perfetto. Si
286 % accettano molto volentieri suggerimenti per migliorarlo (possibilmente in
287 % forma di codice gi\`a funzionante o patch per l'ultima versione di questo
288 % pacchetto).
289 %
290 % \begin{figure}
291 % \centering
292 % \Huge\guitmeeting\qquad\guitmeeting[year=2010]\\[10pt]
293 % \guitmeeting[style=inline]\quad\guitmeeting[year=2010, style=inline]
294 % \caption{Visione d'insieme del logo del convegno periodico}
295 % \label{fig:guitmeeting}
296 % \end{figure}
297 %
298 %
299 %
300 % \section{Il logo della rivista}
301 % A partire dall'aprile del 2006, il \guittext realizza una rivista dedicata
302 % a \TeX, \LaTeX\ e la tipografia digitale; maggiori informazioni sono
303 % reperibili nelle pagine dedicate del sito del Gruppo:
304 % \guiturl[document=home/it/arstexnica]. Nella figura~\ref{fig:arstexnica} sono
305 % raccolte diverse istanze e varianti del logo di \Ars\ ed i comandi
306 % correlati, la cui ideazione e realizzazione sono dovute a Massimo
307 % Caschili.
308 %
309 % \makeatletter
310 % \newcommand*{\loghetto}[2][1]{%
311 % \subfloat[\cs{#2}]{\scalebox{#1}{\csname #2\endcsname}}}
312 % \makeatother
313 % \begin{figure}
314 % \centering\Huge
315 % \loghetto[2]{Ars}\qquad
316 % \loghetto[2]{Arsob}\\
317 % \loghetto[2]{ars}\qquad
318 % \loghetto[2]{tecnica}\\
319 % \loghetto[2]{arsta}\qquad
320 % \loghetto[2]{arstb}\\
321 % \loghetto[2]{arstv}\qquad
322 % \loghetto[2]{arsto}\\
323 % \loghetto[2]{Arsto}
324 % \caption{Il logo della rivista e le sue varianti}\label{fig:arstexnica}
325 % \end{figure}
326 %
327 %
328 %
329 % \section{Comandi}
330 %
331 %
332 %
333 % \subsection{Il logo del Gruppo}
334 % \changes{v0.8}{2004/10/28}{Ristrutturata l'implementazione di \cs{GuIT}
335 % per l'aggiunta dell'argomento opzionale per indicare la famiglia di font
336 % da utilizzare}
337 % \DescribeMacro{\GuIT}\oarg{famiglia, keywords}\newline
338 % \DescribeMacro{\GuIT*}\oarg{famiglia, keywords}\newline
339 % \DescribeMacro{\guit}\oarg{famiglia, keywords}\newline
340 % \DescribeMacro{\guit*}\oarg{famiglia, keywords}\newline
341 % Per riprodurre il logo di \guit~l'utente ha a disposizione il comando
342 % \cs{GuIT} che si prende cura di controllare la famiglia di font utilizzata
343 % e cerca di produrre il risultato migliore. Anche se \`e tecnicamente
344 % errato, per comodit\`a l'utente pu\`o usare anche l'equivalente forma
345 % \cs{guit}. Entrambi i comandi dispongono di una versione ``stellata'' che
346 % riproduce il logo con uno schema di colori simile a quello usato nel sito
347 % di \guit~(\guiturl).
348 %
349 % Desidero richiamare l'attenzione sul fatto che in molti casi non \`e
350 % possibile giungere al risultato \emph{perfetto} in quanto le grazie della
351 % G e della U non sono necessariamente sovrapponibili senza
352 % ``sbavature''. Questi difetti non sono eliminabili, ma \`e stato fatto il
353 % possibile per minimizzarli.
354 %
355 % Il font utilizzato per comporre il logo \`e, normalmente, il font attivo
356 % nel punto in cui compare l'occorrenza di \cs{GuIT}, ma pu\`o essere
357 % modificato utilizzando gli argomenti opzionali nei seguenti modi:
358 %
359 % \begin{itemize}
360 % \item indicando direttamente il nome della famiglia di font da utilizzare
361 % (esempio: \cs{GuIT[ppl]});
362 % \item indicando direttamente il nome della famiglia e della serie da
363 % utilizzare separati dal carattere ``\altro{/}'' (esempio:
364 % \cs{GuIT[ppl/bx]});
365 % \item assegnando alla chiave |family| (vedere \S\ref{sec:keywords}) il
366 % nome della famiglia di font da utilizzare (esempio:
367 % \cs{GuIT[family=ppl]});
368 % \item assegnando alla chiave |series| (vedere \S\ref{sec:keywords}) il
369 % nome di una serie da utilizzare (esempio: \cs{GuIT[series=bx]}).
370 % \end{itemize}
371 %
372 % Ovviamente, in tutti questi casi il font indicato viene utilizzato solo se
373 % \`e presente nella lista di quelli supportati dal pacchetto, altrimenti si
374 % ricade sul classico Computer Modern Roman. Gli effetti di queste
375 % alterazioni sono limitati alla singola occorrenza di \cs{GuIT} nella quale
376 % compaiono.
377 %
378 %
379 %
380 % \subsection{Selezione del colore}
381 % Con entrambi i seguenti comandi \`e possibile usare le espressioni
382 % ``estese'' fornite dal pacchetto \pacchetto{xcolor}~\cite{Kern05}.
383 %
384 % \medskip
385 %
386 % \noindent\DescribeMacro{\GuITcolor}\oarg{modello}\marg{dichiarazione}\newline
387 % \DescribeMacro{\guitcolor}\oarg{modello}\marg{dichiarazione}\newline
388 % Il colore utilizzato da \cs{GuIT*} e da \cs{guit*} pu\`o essere modificato
389 % con questo comando. Se l'argomento opzionale viene omesso si assume l'uso
390 % del modello \emph{cmyk}. Il colore definito in questo modo \`e accessibile
391 % con il nome \altro{coloredelGuIT}.
392 %
393 % \medskip
394 %
395 % \noindent\DescribeMacro{\GuITcolor*}\oarg{modello}\marg{espressione xcolor}\newline
396 % \DescribeMacro{\guitcolor*}\oarg{modello}\marg{espressione xcolor}\newline
397 % Questo comando permette di operare sul colore utilizzato da \cs{GuIT*}
398 % utilizzando le espressioni supportate dal comando \cs{colorlet}; per una
399 % discussione pi\`u ampia e dettagliata si rimanda alla documentazione del
400 % pacchetto \pacchetto{xcolor}. \cs{GuITcolor*} agisce implicitamente su
401 % \altro{coloredelGuIT}, quindi \`e essenzialmente equivalente a
402 % \begin{quote}
403 % |\colorlet{coloredelGuIT}|\marg{espressione xcolor}
404 % \end{quote}
405 % L'argomento opzionale specifica il modello di colore in cui
406 % \meta{espressione xcolor} deve essere trasformata prima dell'applicazione
407 % a \altro{coloredelGuIT}.
408 %
409 % In entrambi i casi, si sconsiglia l'uso del modello \emph{named}. Come per
410 % il comando \cs{GuIT} anche in questo caso si possono usare le equivalenti
411 % forme \cs{guitcolor} e \cs{guitcolor*}.
412 %
413 %
414 %
415 % \subsection{Dicitura completa del Gruppo}
416 % \changes{v0.2}{2003/02/17}{Aggiunti due nuovi comandi per indicare la
417 % denominazione completa del \guittext}
418 % \DescribeMacro{\GuITtext}\oarg{keywords}\newline
419 % \DescribeMacro{\guittext}\oarg{keywords}\newline
420 % Per evitare errori nel riportare la denominazione ufficiale e completa del
421 % Gruppo (\guittext) l'utente pu\`o utilizzare il comando \cs{GuITtext} che
422 % fornisce l'espansione corretta dell'acronimo \guit: \guittext. Notate che
423 % il comando non effettua alcuna modifica al font ed al colore attualmente
424 % in uso e non assume l'uso di alcun font particolare. Come per il comando
425 % \cs{GuIT} anche in questo caso si pu\`o usare l'equivalente forma
426 % \cs{guittext}.
427 %
428 % \medskip
429 %
430 % \changes{v0.9}{2005/10/29}{Aggiunti due nuovi comandi per indicare la
431 % denominazione completa anglicizzata del \guittext\ (o \guittexten\ che
432 % dir si voglia) su espressa richiesta di Gustavo Cevolani}
433 % \noindent\DescribeMacro{\GuITtextEn}\oarg{keywords}\newline
434 % \DescribeMacro{\guittexten}\oarg{keywords}\newline
435 % I comandi appena illustrati hanno la loro controparte in \cs{GuITtextEn} e
436 % nell'immancabile \cs{guittexten}, i quali si comportano esattamente nello
437 % stesso modo per quanto riguarda font e colori, ma producono l'equivalente
438 % inglese di \guittext: \guittexten.
439 %
440 % Per quanto riguarda l'argomento opzionale \meta{keywords}, vedere
441 % \S\ref{sec:keywords}.
442 %
443 %
444 %
445 % \subsection{Indirizzo del sito internet e del forum pubblico}
446 % \DescribeMacro{\GuITurl}\oarg{keywords}\newline
447 % \DescribeMacro{\guiturl}\oarg{keywords}\newline
448 % Per evitare errori nel riportare l'indirizzo completo del sito internet
449 % del Gruppo (\guiturl) l'utente pu\`o utilizzare il comando \cs{GuITurl}
450 % che scrive l'indirizzo corretto sfruttando il pacchetto \pacchetto{url}
451 % presente nella dotazione standard di qualunque distribuzione di
452 % \TeX\,/\LaTeX. Come per il comando \cs{GuIT} anche in questo caso si pu\`o
453 % utilizzare l'equivalente forma \cs{guiturl}.
454 %
455 % \medskip
456 %
457 % \noindent\DescribeMacro{\GuITforum}\oarg{keywords}\newline
458 % \DescribeMacro{\guitforum}\oarg{keywords}\newline
459 % Questo comando permette l'inserimento dell'indirizzo completo del forum
460 % pubblico (\guitforum), sfruttando nuovamente il pacchetto \pacchetto{url}.
461 % Come per il comando \cs{GuIT} anche in questo caso si pu\`o utilizzare
462 % l'equivalente forma \cs{guitforum}.
463 %
464 % Desidero richiamare l'attenzione sul comportamento di alcuni programmi di
465 % visualizzazione di documenti in formato \textsc{pdf}, i quali analizzano
466 % il testo dei documenti alla ricerca di elementi che rispecchino la
467 % struttura di un \textsc{url} ed interpretano automaticamente tali elementi
468 % come link realmente funzionanti. Questo fatto non \`e alterabile tramite
469 % comandi od altri costrutti di \LaTeX, quindi, se doveste riscontrare
470 % ``anomalie'' negli effetti dei due comandi appena illustrati, esaminate la
471 % configurazione del programma che usate ed eventualmente alteratela di
472 % conseguenza.
473 %
474 % Per quanto riguarda l'argomento opzionale \meta{keywords}, vedere
475 % \S\ref{sec:keywords}.
476 %
477 %
478 %
479 % \subsection{Il logo del convegno}
480 % \DescribeMacro{\GuITmeeting}\oarg{keywords}\newline
481 % \DescribeMacro{\GuITmeeting*}\oarg{keywords}\newline
482 % \DescribeMacro{\guitmeeting}\oarg{keywords}\newline
483 % \DescribeMacro{\guitmeeting*}\oarg{keywords}\newline
484 % Per riprodurre il logo del periodico convegno l'utente ha a disposizione
485 % il comando \cs{GuITmeeting}; trattandosi di un'entit\`a grafica
486 % particolare, non \`e possibile alcuna personalizzazione del risultato ad
487 % eccezione dello schema di colori. Come per gli altri comandi, anche in
488 % questo caso si pu\`o utilizzare l'equivalente forma \cs{guitmeeting}.
489 % Entrambi i comandi dispongono di una versione ``stellata'' che
490 % riproduce il logo a colori con uno schema di colori simile a quello usato
491 % nel sito di \guit~(\guiturl).
492 %
493 % Per quanto riguarda l'argomento opzionale \meta{keywords}, vedere
494 % \S\ref{sec:keywords}.
495 %
496 %
497 %
498 % \subsection{Il logo della rivista}
499 % \changes{v0.9}{2006/05/17}{Inglobati i comandi per generare i logo della
500 % rivista ideati da Massimo Caschili}
501 % I comandi per riprodurre le diverse istanze e varianti del logo della
502 % rivista sono illustrati direttamente nella
503 % figura~\ref{fig:arstexnica}; questi comandi non hanno alcun
504 % parametro. L'autore ed ideatore dei comandi, per conto del \guittext, \`e
505 % Massimo Caschili.
506 %
507 %
508 %
509 % \subsection{Usare le chiavi}\label{sec:keywords}
510 % Il pacchetto fa ampio uso di chiavi, definite tramite
511 % \pacchetto{xkeyval}~\cite{Adriaens05}, in modo da rendere l'utilizzo dei
512 % vari comandi pi\`u flessibile. Applicare una chiave ad uno dei comandi
513 % visti in precedenza pu\`o potenzialmente modificare la relativa
514 % caratteristica \emph{solo ed esclusivamente per quell'istanza del
515 % comando}.
516 %
517 % \begin{table}
518 % \centering
519 % \begin{tabularx}{0.91\textwidth}{ll>{\raggedright\arraybackslash}X}
520 % \toprule
521 % \itshape Chiave & \itshape Valori & \itshape Applicabilit\`a \\
522 % \midrule
523 % color & \textit{yes}, true, no, false & \cs{GuIT}, \cs{GuITmeeting} \\
524 % link & \textit{yes}, true, no, false & \cs{GuIT}, \cs{GuITmeeting}, \cs{GuITtext}, \cs{GuITtextEn}, \cs{GuITurl}, \cs{GuITforum} \\
525 % family & \meta{famiglia} & \cs{GuIT} \\
526 % series & \meta{serie} & \cs{GuIT} \\
527 % url & \meta{indirizzo} & \cs{GuIT}, \cs{GuITmeeting}, \cs{GuITtext}, \cs{GuITtextEn}, \cs{GuITurl}, \cs{GuITforum} \\
528 % document & \meta{documento} & \cs{GuITurl} \\
529 % year & \meta{anno} & \cs{GuITmeeting} \\
530 % style & display, inline & \cs{GuITmeeting} \\
531 % \bottomrule
532 % \end{tabularx}
533 % \caption{Chiavi definite dal pacchetto \pacchetto{guit}}
534 % \label{tab:keywords}
535 % \end{table}
536 %
537 % Le chiavi attualmente definite sono riportate nella
538 % tabella~\ref{tab:keywords} assieme ai valori che possono assumere e ad
539 % un'indicazione dei comandi sui quali hanno un qualche effetto. I valori in
540 % corsivo sono i valori di default assegnati implicitamente alle chiavi
541 % corrispondenti se quest'ultime vengono usate senza indicare esplicitamente
542 % alcun valore.
543 %
544 % Alcune annotazioni sulle chiavi:
545 %
546 % \begin{description}
547 % \item[|color|] permette di controllare l'uso del colore per il logo del
548 % Gruppo; da notare che sono possibili combinazioni ``strane'' come
549 % |\GuIT*[color=no]|, la quale, nonostante l'utilizzo della versione
550 % ``stellata'', produrr\`a un'istanza del logo non colorata;
551 % \item[|link|] permette di controllare la generazione di un link alla
552 % pagina principale del sito del \guit\ in corrispondenza di ogni
553 % occorrenza del logo e dell'espansione della dicitura completa del Gruppo
554 % tramite l'uso di \pacchetto{hyperref}, \emph{che deve essere caricato
555 % esplicitamente} nel preambolo del documento; come effetto collaterale, i
556 % prodotti di \cs{GuITurl} e \cs{GuITforum} diventano automaticamente
557 % \textsc{url} realmente funzionanti;
558 % \item[|family|] \`e un modo pi\`u esplicito e prolisso di impostare il
559 % font con il quale viene composto il logo del Gruppo; assegnare a questa
560 % chiave un valore nullo fa si che il font utilizzato per comporre il logo
561 % di \guit\ sia quello attivo nel punto in cui compare il comando
562 % \cs{GuIT};
563 % \item[|series|] permette di impostare la serie con la quale viene composto
564 % il logo del Gruppo; assegnare a questa chiave un valore nullo fa si che
565 % la serie utilizzata per comporre il logo sia quella attiva nel punto in
566 % cui compare il comando \cs{GuIT};
567 % \item[|url|] permette di definire od alterare l'indirizzo del sito
568 % internet del Gruppo usato dai vari comandi che producono testo o link al
569 % sito stesso; assegnare a questa chiave un valore nullo sopprimer\`a
570 % l'output di \cs{GuITurl} e disabiliter\`a la creazione di link da parte
571 % di \pacchetto{hyperref};
572 % \item[|document|] permette di indicare pagine o sezioni del sito del
573 % Gruppo facendo in modo che il risultato si comporti in maniera
574 % automatica esattamente come \cs{GuITurl} per quanto riguarda
575 % l'interazione con \pacchetto{hyperref} e la creazione di link; assegnare
576 % a questa chiave un valore nullo disabilita la visualizzazione di
577 % quest'estensione dell'indirizzo;
578 % \item[|year|] permette di impostare l'anno che comparir\`a nel logo del
579 % convegno periodico in una posizione simile a quella in cui compare nei
580 % poster, accanto all'illustrazione realizzata per il Gruppo da Duane
581 % Bibby\footnote{Se gi\`a si poteva sconsigliare l'uso di \cs{GuITmeeting}
582 % all'interno di un paragrafo o di un qualsiasi altro blocco di testo,
583 % l'aggiunta dell'anno crea un'entit\`a decisamente ingombrante e porta a
584 % rafforzare il consiglio: \emph{non usate \cs{GuITmeeting} all'interno di
585 % un blocco di testo}.}; assegnare a questa chiave un valore nullo
586 % disabilita la visualizzazione dell'anno;
587 % \item[|style|] permette di modificare l'aspetto del logo del convegno
588 % alterando il modo nel quale vengono assemblati i sui componenti: i primi
589 % due esempi che compaiono in figura~\ref{fig:guitmeeting} sono composti
590 % con |style=display|, gli ultimi due con
591 % |style=inline|\footnote{L'aspetto del logo prodotto da |inline| potrebbe
592 % non essere molto stabile e subire drastiche variazioni nelle prossime
593 % versioni del pacchetto.}.
594 % \end{description}
595 %
596 % Non \`e strettamente necessario attenersi alle indicazioni d'uso delle
597 % chiavi riportate nella tabella~\ref{tab:keywords} ed \`e quindi possibile
598 % utilizzarle liberamente, con l'avvertenza che le chiavi i cui effetti non
599 % sono applicabili al comando di cui sono argomento non produrranno alcun
600 % risultato mentre tutte le altre avranno effetto solo su quella particolare
601 % istanza del comando a cui sono legate.
602 %
603 % \medskip
604 %
605 % \changes{v0.9}{2005/10/29}{Aggiunto un nuovo comando per gestire in
606 % maniera ``globale'' le chiavi}
607 % \noindent\DescribeMacro{\setupGuIT}\oarg{keywords}\newline
608 % \DescribeMacro{\setupguit}\oarg{keywords}\newline
609 % Oltre ad essere utilizzabili direttamente nei comandi indicati in
610 % precedenza, tutte le chiavi appena illustrate possono essere usate come
611 % argomenti di \cs{setupGuIT}, che provveder\`a ad elaborarle e ad
612 % applicarne gli effetti \emph{a tutto ci\`o che segue, tenendo conto delle
613 % normali regole di scoping}.
614 %
615 % Utilizzare questo comando senza alcun argomento equivale a disabilitare
616 % l'utilizzo del colore e la generazione dei link, ad impostare il font
617 % usato per il logo a quello attivo in quel punto del documento, ad
618 % impostare l'indirizzo del sito internet del Gruppo a quello attuale, a
619 % disabilitare la visualizzazione del documento che estente \cs{GuITurl} e
620 % dell'anno e ad impostare lo stile |display| per \cs{GuITmeeting}.
621 %
622 % Giova rimarcare la differenza tra l'applicazione delle chiavi a
623 % \cs{setupGuIT} ed agli altri comandi:
624 %
625 % \begin{itemize}
626 % \item l'esecuzione di un'istanza di \cs{setupGuIT} ha effetto \emph{su
627 % tutti i comandi di questo pacchetto fino al termine del documento o del
628 % pi\`u piccolo gruppo che lo contiene};
629 % \item applicare una chiave ad un qualsiasi altro comando di questo
630 % pacchetto pu\`o potenzialmente produrre un qualche effetto
631 % \emph{solamente su quella particolare istanza di quel particolare
632 % comando}.
633 % \end{itemize}
634 %
635 %
636 %
637 % \subsection{Creare nuove realizzazioni del logo del Gruppo}
638 % \DescribeMacro{\DeclareGuITLogoCommand}\marg{famiglia}\oarg{serie}\marg{u-h}\marg{u-v}\marg{i-h}\marg{t-h}\newline
639 % Il numero di font supportati da questa versione del pacchetto non \`e
640 % molto alto; per gli utenti desiderosi di usare font non previsti
641 % dall'autore, \`e disponibile il comando \cs{DeclareGuITLogoCommand},
642 % utilizzabile solo nel preambolo del documento o nel file di configurazione
643 % \altro{guit.cfg}.
644 %
645 % Tenendo ben presente che sia la \meta{famiglia} tanto quanto la
646 % \meta{serie} sono da considerarsi nell'accezione tipica dei termini del
647 % sistema \emph{NFSS2}, i sei parametri rappresentano:
648 %
649 % \begin{enumerate}
650 % \item il nome della famiglia di font;
651 % \item la serie (valore di default: \altro{m}, cio\`e il tradizionale
652 % valore di \cs{mddefault});
653 % \item lo scartamento orizzontale della \emph{u};
654 % \item lo scartamento verticale della \emph{u};
655 % \item lo scartamento orizzontale della \emph{i};
656 % \item lo scartamento orizzontale della \emph{t}.
657 % \end{enumerate}
658 %
659 % Valori negativi degli ultimi quattro parametri indicano spostamenti verso
660 % sinistra o, dove applicabile, verso l'alto; valori positivi indicano,
661 % ovviamente, spostamenti nelle direzioni opposte. Usando
662 % \cs{DeclareGuITLogoCommand} \`e possibile ridefinire le realizzazioni del
663 % logo fornite dalla versione attuale del pacchetto, con l'unica eccezione
664 % del logo composto con la famiglia Computer Modern\footnote{Un eventuale
665 % tentativo di ridefinizione avrebbe conseguenze deleterie sul risultato
666 % finale.}.
667 %
668 % \medskip
669 %
670 % \noindent\DescribeMacro{\AliasGuITLogoCommand}\marg{fam1}\marg{ser1}\marg{fam2}\marg{ser2}\newline
671 % Per evitare che il pacchetto utilizzi il font Computer Modern Roman in
672 % sostituzione di un font non supportato, \`e possibile creare un alias per
673 % la particolare combinazione inesistente di famiglia e serie. I primi due
674 % argomenti rappresentano la famiglia e la serie che devono essere
675 % rappresentate dal font identificato dagli ultimi due parametri e per il
676 % quale \emph{deve} essere gi\`a stata creata un'istanza del logo (tramite
677 % \cs{DeclareGuITLogoCommand} oppure tramite un altro alias).
678 %
679 % A titolo d'esempio, la definizione per il font Utopia, serie \altro{bx},
680 % \`e attualmente un alias creato in questo modo:
681 % \begin{quote}
682 % |\AliasGuITLogoCommand{put}{bx}{put}{m}|
683 % \end{quote}
684 %
685 %
686 %
687 % \section{Configurazione}\label{sec:config}
688 % Il pacchetto \`e corredato di un piccolo file di configurazione,
689 % \altro{guit.cfg}, nel quale l'utente pu\`o impostare un colore di default
690 % per il logo diverso dall'originale, definire nuove realizzazioni del logo
691 % o ridefinire quelle esistenti.
692 %
693 % Il file cos\`{\i} come viene distribuito \`e praticamente vuoto, in quanto
694 % tutte le dichiarazioni utili sono state commentate perch\'e riprendono
695 % semplicemente quanto gi\`a definito nel codice del pacchetto e servono
696 % unicamente da esempio.
697 %
698 %
699 %
700 % \section{Opzioni}
701 % Il pacchetto ha tre opzioni, ma il loro uso \`e sconsigliato a favore del
702 % comando \cs{setupGuIT}, che permette una maggiore flessibilit\`a:
703 %
704 % \begin{description}
705 % \item[color] forza la colorazione di tutte le occorrenze del logo,
706 % indipendentemente dalla forma del comando usata; \emph{prestate bene
707 % attenzione al fatto che il significato di quest'opzione \`e
708 % radicalmente cambiato rispetto alle versioni precedenti alla 0.7 e
709 % che l'uso di \cs{setupGuIT} pu\`o annullarne l'effetto};
710 % \item[nocolor] disattiva il supporto del colore; quando viene specificata
711 % quest'opzione \cs{GuIT*} e \cs{guit*} producono gli stessi risultati
712 % di \cs{GuIT}, cio\`e il colore del logo non viene alterato in alcun
713 % modo; \emph{prestate bene attenzione al fatto che a partire dalla
714 % versione 0.9 l'uso di \cs{setupGuIT} pu\`o annullare l'effetto di
715 % quest'opzione};
716 % \item[link] abilita l'uso di \pacchetto{hyperref}, \emph{che deve essere
717 % caricato esplicitamente} nel preambolo del documento) per trasformare ogni
718 % occorrenza del logo del Gruppo e dell'espansione della dicitura
719 % completa in un link al sito di \guit; prestate attenzione al fatto
720 % che l'aspetto del logo \emph{non muta} minimamente; inoltre, come effetto
721 % collaterale dell'uso di \pacchetto{hyperref}, \cs{GuITurl} diventa
722 % automaticamente un link al sito internet di \guit; \emph{prestate
723 % bene attenzione al fatto che a partire dalla versione 0.9 l'uso di
724 % \cs{setupGuIT} pu\`o annullare l'effetto di quest'opzione}.
725 % \end{description}
726 %
727 %
728 %
729 % \section{Dipendenze da altri pacchetti}
730 % La lista dei pacchetti da cui questo codice dipende \`e, per ora, molto
731 % breve e si tratta di pacchetti fondamentali oppure estremamente comuni:
732 %
733 % \begin{itemize}
734 % \item \pacchetto{hyperref};
735 % \item \pacchetto{graphics};
736 % \item \pacchetto{url};
737 % \item \pacchetto{xcolor}, versione 2.00 o successive;
738 % \item \pacchetto{xkeyval}, versione 2.5 o successive.
739 % \end{itemize}
740 %
741 % \pacchetto{hyperref} non viene pi\`u caricato automaticamente a partire
742 % dalla versione 0.9.1.
743 %
744 % Ad accezione di \pacchetto{url}, tutti gli altri pacchetti vengono
745 % caricati senza indicare esplicitamente alcuna opzione, ma questo non
746 % significa che ci\`o non possa causarvi problemi: laddove \`e perfettamente
747 % lecito tentare di caricare due o pi\`u volte lo stesso pacchetto \emph{con
748 % le stesse opzioni}, non \`e possibile farlo cambiando le opzioni, quindi
749 % il codice seguente \`e errato:
750 %
751 % \begin{verbatim}
752 % % ...
753 % \usepackage{graphics}
754 % \usepackage[draft]{graphics}
755 % % ...
756 % \end{verbatim}
757 %
758 % Per semplificare al massimo il problema, se doveste incontrare messaggi
759 % d'errore che menzionano i pacchetti elencati in precedenza alterate
760 % l'ordine di caricamento dei pacchetti nel vostro documento in modo che
761 % questo pacchetto si trovi dopo quello indicato dai messaggi.
762 %
763 %
764 %
765 % \StopEventually{%
766 % \bibliographystyle{alpha}
767 % \begin{thebibliography}{GMS94}
768 % \addcontentsline{toc}{section}{\refname}
769 % \bibitem[Adr05]{Adriaens05} Hendri Adriaens, \emph{The
770 % \pacchetto{xkeyval} package}, v2.5e, 2005/11/25 (disponibile presso
771 % \textsc{ctan} in \url{macros/latex/contrib/xkeyval}).
772 % \bibitem[GMS94]{GOOSSENS94} Michel Goossens, Frank Mittelbach e Alexander
773 % Samarin. \emph{The \LaTeX\ Companion}. Addison-Wesley Company, 1994.
774 % \bibitem[Ker05]{Kern05} Dr.~Uwe Kern, \emph{Extending \LaTeX's color
775 % facilities: the \pacchetto{xcolor} package}, v2.09, 2005/12/21
776 % (disponibile presso \textsc{ctan} in
777 % \url{macros/latex/contrib/xcolor}).
778 % \bibitem[Knu86]{CMT} Donal E. Knuth. \emph{Computer Modern Typefaces},
779 % volume E di \emph{Computer \& Typesetting}. Addison-Wesley
780 % Publishing, 1986.
781 % \end{thebibliography}}
782 %
783 %
784 %
785 % \section{Il codice}
786 %
787 %
788 %
789 % \subsection{Il pacchetto}
790 % \changes{v0.2}{2003/02/17}{Corretti un paio di errori nel codice}
791 % \changes{v0.9}{2005/11/19}{I pacchetti \pacchetto{xcolor} e
792 % \pacchetto{hyperref} vengono ora caricati di default; \pacchetto{color}
793 % \`e stato definitivamente rimosso}
794 % \changes{v0.9.1}{2009/07/31}{\pacchetto{hyperref} non viene pi\`u caricato
795 % automaticamente; suggerimento e codice di Enrico Gregorio}
796 % \changes{v1.0.0}{2019/07/08}{\pacchetto{url} viene caricato con l'opzione
797 % \altro{hyphens}}
798 % \changes{v1.0.0}{2020/07/03}{\pacchetto{url} viene caricato solo se non
799 % \`e gi\`a stato fatto}
800 % Richiediamo espressamente l'uso di \LaTeXe, ci annunciamo al mondo e
801 % carichiamo tutti i pacchetti necessari.
802 % \begin{macrocode}
803 %<*style>
804 \NeedsTeXFormat{LaTeX2e}
805 \ProvidesPackage{guit}[2020/07/03 v1.0.0-alpha.4 Logo del GuIT]
806 \RequirePackage{graphics}
807 \@ifpackageloaded{url}{}{\RequirePackage[hyphens]{url}}
808 \RequirePackage{xcolor}[2004/07/04]
809 \RequirePackage{xkeyval}[2005/05/07]
810 % \end{macrocode}
811 %
812 % \changes{v0.7}{2003/10/17}{Modificata la semantica di \altro{color}: ora
813 % forza la colorazione di tutte le occorrenze del logo}
814 % \changes{v0.9}{2005/11/21}{Semplificata la gestione delle opzioni}
815 % Le tre opzioni che il pacchetto presentava fino alla versione 0.8.2 sono
816 % da considerarsi obsolete, ma il loro effetto \`e, almeno parzialmente,
817 % ancora onorato.
818 % \begin{macrocode}
819 \newif\if@guit@colorized
820 \newif\if@guit@link
821 \DeclareOption{color}{\AtEndOfPackage{\setupGuIT[color=yes]}}
822 \DeclareOption{nocolor}{\AtEndOfPackage{\setupGuIT[color=no]}}
823 \DeclareOption{link}{\AtEndOfPackage{\setupGuIT[link=yes]}}
824 \ProcessOptions\relax
825 % \end{macrocode}
826 %
827 % \begin{macro}{\setupGuIT}
828 % \changes{v0.9.2}{2012/08/17}{Aggiornato l'indirizzo del sito internet}
829 % \changes{v1.0.0}{2012/08/17}{Aggiornato l'indirizzo del sito internet}
830 % \begin{macro}{\setupguit}
831 % Il comando per gestire le varie chiavi \`e un semplice wrapper alla macro
832 % \cs{setkeys*} (ho optato per usare questa macro in quanto non genera alcun
833 % messaggio d'errore se le chiavi che riceve in input non esistono nella
834 % famiglia sotto esame).
835 % \begin{macrocode}
836 \DeclareRobustCommand{\setupGuIT}[1][color=no, link=no, family=, series=, url=https://www.guitex.org, document=, year=, style=display]{%
837 \setkeys*{guit}{#1}%
838 \ignorespaces}
839 \let\setupguit\setupGuIT
840 % \end{macrocode}
841 % \end{macro}
842 % \end{macro}
843 %
844 % Alcune delle chiavi usate nel codice vengono definite qui, altre sono
845 % definite durante la generazione delle macro interne che si occupano di
846 % comporre il logo (vedere pagina~\pageref{p:fntcmd}).
847 % \begin{macrocode}
848 \define@choicekey*{guit}{color}[\val\nr]{yes,true,no,false}[yes]{%
849 \ifcase\nr\relax
850 \@guit@colorizedtrue
851 \or
852 \@guit@colorizedtrue
853 \or
854 \@guit@colorizedfalse
855 \or
856 \@guit@colorizedfalse
857 \fi}
858 \define@choicekey*{guit}{link}[\val\nr]{yes,true,no,false}[yes]{%
859 \ifcase\nr\relax
860 \@guit@linktrue
861 \or
862 \@guit@linktrue
863 \or
864 \@guit@linkfalse
865 \or
866 \@guit@linkfalse
867 \fi}
868 \define@key{guit}{family}{\def\@guit@family{#1}}
869 \define@key{guit}{series}{\def\@guit@series{#1}}
870 % \end{macrocode}
871 %
872 % Il caricamento automatico di \pacchetto{hyperref} ha causato qualche
873 % problema, quindi a partire dalla versione 0.9.1 \`e stato rimosso. Di
874 % seguito viene effettuato il controllo sul fatto che il pacchetto sia stato
875 % caricato esplicitamente dall'utente.
876 % \begin{macrocode}
877 \def\@if@guit@link@or@hyperref#1#2{%
878 \if@guit@link
879 \@if@guit@hyperrefloaded{#1}{#2}%
880 \else
881 #2%
882 \fi}
883 \AtBeginDocument{%
884 \@ifpackageloaded{hyperref}
885 {\let\@if@guit@hyperrefloaded\@firstoftwo}
886 {\let\@if@guit@hyperrefloaded\@secondoftwo}}
887 % \end{macrocode}
888 %
889 % \begin{macro}{\GuITcolor}
890 % \changes{v0.6}{2003/09/16}{Esteso con una versione ``stellata'' che
891 % beneficia delle funzionalit\`a di \pacchetto{xcolor}}
892 % \changes{v0.7}{2003/09/26}{Trasformato in un comando \emph{robusto} (mea
893 % culpa)}
894 % \changes{v0.8.2}{2005/04/08}{Modificata la dichiarazione del colore di
895 % default}
896 % \changes{v0.9}{2005/11/19}{Eliminate le definizioni riguardanti
897 % esclusivamente \pacchetto{color}}
898 % \begin{macro}{\guitcolor}
899 % Procediamo alla definizione di un nuovo comando per alterare il colore
900 % utilizzato da \cs{GuIT*} e \cs{guit*}. Definiamo anche il colore
901 % utilizzato di default.
902 % \begin{macrocode}
903 \DeclareRobustCommand*{\GuITcolor}{%
904 \@ifstar\x@guit@color@imp\@guit@color@imp}
905 % \end{macrocode}
906 % Teniamo conto della presenza delle estensioni fornite dal pacchetto
907 % \pacchetto{xcolor} e realizziamo le implementazioni del comando
908 % precedente\footnote{In realt\`a, quel \cs{definecolor} proviene da
909 % \pacchetto{xcolor}, versione 2.00 o successiva}.
910 % \begin{macrocode}
911 \newcommand*{\@guit@color@imp}[2][cmyk]{%
912 \definecolor{coloredelGuIT}{#1}{#2}}
913 \newcommand*{\x@guit@color@imp}[2][\@empty]{%
914 \edef\@tempa{#1}%
915 \ifx\@empty\@tempa
916 \colorlet{coloredelGuIT}{#2}%
917 \else
918 \colorlet{coloredelGuIT}[#1]{#2}%
919 \fi}
920 \GuITcolor{1, 0, 1, 0.6}
921 \let\guitcolor\GuITcolor
922 % \end{macrocode}
923 % \end{macro}
924 % \end{macro}
925 %
926 % \begin{macro}{\@guit@url}
927 % \changes{v0.9}{2005/12/26}{Trasformata in una ``chiave'' creata tramite
928 % \pacchetto{xkeyval}}
929 % L'impostazione dell'indirizzo avviene tramite \cs{setupGuIT} prima
930 % dell'inizio del documento.
931 % \begin{macrocode}
932 \define@cmdkey{guit}[@guit@]{url}{\relax}
933 % \end{macrocode}
934 % \end{macro}
935 %
936 % \begin{macro}{\@guitimp}
937 % \changes{v0.8}{2004/10/28}{Aggiunto un argomento}
938 % \changes{v0.9}{2005/11/21}{Spostato in questa macro il controllo sul
939 % colore a causa delle modifiche imposte dall'uso delle chiavi}
940 % \changes{v0.9}{2006/05/03}{Sostituiti i due \cs{normalcolor} con il nulla
941 % quando il logo non deve essere colorato}
942 % Questa macro fornisce un primo livello di astrazione dalla vera
943 % implementazione del logo, permettendo di attivare opzionalmente la
944 % colorazione ed il meccanismo che trasforma ogni logo in un link al sito di
945 % \guit. Volendo evitare intromissioni di \pacchetto{hyperref} nell'aspetto
946 % del logo si \`e disabilitata la colorazione dei link (anche se
947 % \pacchetto{hyperref} venisse caricato con l'opzione |colorlinks=true|) e
948 % la creazione del box che \altro{Acrobat Reader} e qualche altro previewer
949 % visualizzano attorno ai link.
950 %
951 % Al livello inferiore dell'implementazione viene passato come unico
952 % argomento la giustapposizione di \cs{@guit@family}, che contiene il nome
953 % della famiglia di font attualmente in uso oppure di quella scelta
954 % dall'utente tramite la chiave |family| oppure tramite l'uso diretto della
955 % chiavi implicitamente associate ad ogni famiglia, e \cs{@guit@series},
956 % l'analogo di \cs{@guit@family} per ci\`o che riguarda le serie.
957 % \begin{macrocode}
958 \def\@guitimp#1{%
959 \begingroup
960 \setkeys*{guit}{#1}%
961 \if@guit@colorized
962 \def\@colorize@guit{\color{coloredelGuIT}}%
963 \def\@decolorize@guit{\normalcolor}%
964 \else
965 \def\@colorize@guit{}%
966 \def\@decolorize@guit{}%
967 \fi
968 \edef\@tempa{\@guit@family}%
969 \ifx\@empty\@tempa
970 \let\@guit@family\f@family
971 \fi
972 \edef\@tempa{\@guit@series}%
973 \ifx\@empty\@tempa
974 \let\@guit@series\f@series
975 \fi
976 \@if@guit@link@or@hyperref
977 {\Hy@colorlinksfalse
978 \def\@pdfborder{0 0 0}%
979 \href{\@guit@url}{\@@guitimp{\@guit@family\@guit@series}}}
980 {\@@guitimp{\@guit@family\@guit@series}}%
981 \endgroup}
982 % \end{macrocode}
983 % \end{macro}
984 %
985 % Iniziamo ora a preparare i comandi da utilizzarsi in combinazione con i
986 % font attualmente supportati. Il codice poteva probabilmente essere scritto
987 % in maniera diversa e maggiormente compatta, ma ho preferito adottare un
988 % approccio modulare e pi\`u semplice.
989 %
990 % \begin{macro}{\DeclareGuITLogoCommand}
991 % \changes{v0.8.2}{2005/04/08}{Nuovo comando per l'utente finale per creare
992 % nuove realizzazioni del logo}
993 % Il lavoro necessario alla creazione delle diverse realizzazioni del logo
994 % viene interamente demandato ad una macro interna. Per mantenere un minimo
995 % di coerenza, quanto meno all'interno del singolo documento, permettiamo
996 % l'uso di questo comando solo nel preambolo e, di conseguenza, anche nel
997 % file di configurazione esterno.
998 % \begin{macrocode}
999 \DeclareRobustCommand*{\DeclareGuITLogoCommand}{%
1000 \@gen@guit@fntcmd}
1001 \@onlypreamble\DeclareGuITLogoCommand
1002 % \end{macrocode}
1003 % \end{macro}
1004 %
1005 % \begin{macro}{\@gen@guit@fntcmd}\label{p:fntcmd}
1006 % \changes{v0.7.1}{2004/02/28}{Aggiunta questa macro per generare le macro
1007 % interne per i vari font; semplificate le macro dei font (con l'eccezione
1008 % di quella per il Computer Modern Roman)}
1009 % \changes{v0.8}{2004/10/28}{Alterata la selezione del font da usare}
1010 % \changes{v0.9}{2005/11/21}{Aggiunta la definizione contestuale di una
1011 % chiave con lo stesso nome della famiglia di font}
1012 % \changes{v0.9}{2005/11/27}{Riscritta per gestire come secondo argomento
1013 % opzionale la serie}
1014 % \begin{macro}{\@gen@guit@fntcmd@imp}
1015 % Nell'ottica di voler semplificare il codice del pacchetto viene fatto
1016 % largo uso di questa macro per generare ``automaticamente'' le macro
1017 % interne che si occupano di comporre il logo nella maniera pi\`u corretta
1018 % possibile a seconda del font in uso.
1019 %
1020 % Vengono anche create due chiavi: una con il nome uguale al nome della
1021 % famiglia, che ignora qualunque valore eventualmente assegnatole ed imposta
1022 % \cs{@guit@family} in modo che sia utilizzabile in seguito, e la seconda
1023 % con il nome formato dalla giustapposizione del nome della famiglia, del
1024 % carattere \altro{/} e della serie, che ignora qualunque valore
1025 % eventualmente assegnatole ed imposta \cs{@guit@family} e \cs{@guit@series}
1026 % in modo che siano utilizzabili in seguito.
1027 % \begin{macrocode}
1028 \def\@gen@guit@fntcmd#1{%
1029 \@ifnextchar[%
1030 {\@gen@guit@fntcmd@imp#1}%
1031 {\@gen@guit@fntcmd@imp#1[m]}}
1032 \def\@gen@guit@fntcmd@imp#1[#2]#3#4#5#6{%
1033 \define@key{guit}{#1}[#1]{\def\@guit@family{#1}}%
1034 \define@key{guit}{#1/#2}[#1/#2]{%
1035 \def\@guit@family{#1}%
1036 \def\@guit@series{#2}}%
1037 \@namedef{@guit#1#2}{%
1038 \fontfamily{#1}\fontseries{#2}\scshape
1039 \@colorize@guit g\kern #3\lower #4\hbox{u}%
1040 \@decolorize@guit\kern #5 I\@colorize@guit\kern #6 t}}
1041 % \end{macrocode}
1042 % \end{macro}
1043 % \end{macro}
1044 %
1045 % \begin{macro}{\AliasGuITLogoCommand}
1046 % \changes{v0.9}{2005/11/30}{Nuovo comando per l'utente finale per creare
1047 % alias di nuove realizzazioni del logo}
1048 % La creazione di un alias non si discosta molto da quanto appena visto, se
1049 % non fosse per il fatto che l'ultima riga di \cs{AliasGuITLogoCommand} non
1050 % \`e di immediata lettura.
1051 % \begin{macrocode}
1052 \DeclareRobustCommand*{\AliasGuITLogoCommand}[4]{%
1053 \define@key{guit}{#1/#2}[#1/#2]{%
1054 \def\@guit@family{#3}%
1055 \def\@guit@series{#4}}%
1056 \expandafter\let\csname @guit#1#2\expandafter\endcsname\csname @guit#3#4\endcsname}
1057 \@onlypreamble\AliasGuITLogoCommand
1058 % \end{macrocode}
1059 % \end{macro}
1060 %
1061 % \begin{macro}{\@guitcmrm}
1062 % \changes{v0.3}{2003/06/12}{Aggiunta l'indicazione esplicita della famiglia
1063 % \textsf{cmr}; in precedenza si usava la famiglia di font con grazie
1064 % predefinita, qualunque essa fosse}
1065 % \changes{v0.7.3}{2004/10/11}{Un minimo aggiustamento al coefficiente di
1066 % traslazione orizzontale della ``u''}
1067 % \changes{v0.9}{2005/11/27}{Modificato il nome aggiungendo la serie}
1068 % Se il logo deve essere scritto utilizzando il Computer Modern Roman
1069 % richiediamo espressamente l'uso del font originale di Knuth impostando per
1070 % l'encoding il valore OT1: questo ci permette di produrre documenti in
1071 % formato \textsc{pdf} utilizzando font PostScript\texttrademark~anche senza
1072 % dover usare la collezione \altro{cm-super}. Questo comando viene usanto
1073 % anche quando il font principale usato dall'utente non \`e tra quelli
1074 % supportati dal pacchetto. \emph{Non \`e possibile creare questa macro con
1075 % \cs{@gen@guit@fntcmd}}.
1076 % \begin{macrocode}
1077 \def\@guitcmrm{%
1078 \fontencoding{OT1}\fontfamily{cmr}\fontseries{m}\scshape
1079 \@colorize@guit g\kern -0.26em\lower 0.714ex\hbox{u}%
1080 \@decolorize@guit\kern -0.125em I\@colorize@guit\kern -0.125em t}
1081 \define@key{guit}{cmr}[cmr]{\def\@guit@family{cmr}}
1082 \define@key{guit}{cmr/m}[cmr/m]{%
1083 \def\@guit@family{cmr}%
1084 \def\@guit@series{m}}
1085 % \end{macrocode}
1086 % \end{macro}
1087 %
1088 % \begin{macro}{\@guitlmrm}
1089 % Questa macro viene utilizzata se l'utente usa il font Latin Modern.
1090 % \begin{macrocode}
1091 \@gen@guit@fntcmd{lmr}{-0.26em}{0.714ex}{-0.125em}{-0.125em}
1092 \AliasGuITLogoCommand{lmr}{b}{lmr}{m}
1093 \AliasGuITLogoCommand{lmr}{bx}{lmr}{m}
1094 % \end{macrocode}
1095 % \end{macro}
1096 %
1097 % \begin{macro}{\@guitptmm}
1098 % \changes{v0.7.3}{2004/10/11}{Un minimo aggiustamento al coefficiente di
1099 % traslazione orizzontale della ``u''}
1100 % \changes{v0.9}{2005/11/27}{Modificato il nome aggiungendo la serie}
1101 % \begin{macro}{\@guitptmbx}
1102 % Questa macro viene utilizzata se l'utente usa il font Times.
1103 % \begin{macrocode}
1104 \@gen@guit@fntcmd{ptm}{-0.27em}{0.5475ex}{-0.125em}{-0.125em}
1105 \@gen@guit@fntcmd{ptm}[bx]{-0.345em}{0.68ex}{-0.125em}{-0.125em}
1106 % \end{macrocode}
1107 % \end{macro}
1108 % \end{macro}
1109 %
1110 % \begin{macro}{\@guitpplm}
1111 % \changes{v0.7.3}{2004/10/11}{Minimi aggiustamenti ai coefficienti di
1112 % traslazione orizzontale e verticale della ``u''}
1113 % \changes{v0.9}{2005/11/27}{Modificato il nome aggiungendo la serie}
1114 % \begin{macro}{\@guitpplbx}
1115 % Se viene usato Palatino \cs{GuIT} user\`a questo comando.
1116 % \begin{macrocode}
1117 \@gen@guit@fntcmd{ppl}{-0.276em}{0.717ex}{-0.125em}{-0.125em}
1118 \@gen@guit@fntcmd{ppl}[bx]{-0.33em}{0.689ex}{-0.125em}{-0.125em}
1119 % \end{macrocode}
1120 % \end{macro}
1121 % \end{macro}
1122 %
1123 % \begin{macro}{\@guitpncm}
1124 % \changes{v0.7.3}{2004/10/11}{Minimi aggiustamenti ai coefficienti di
1125 % traslazione orizzontale e verticale della ``u''}
1126 % \changes{v0.9}{2005/11/27}{Modificato il nome aggiungendo la serie}
1127 % \begin{macro}{\@guitpncbx}
1128 % Se il font attualmente in uso \`e il New Century Schoolbook verr\`a usata
1129 % questa macro.
1130 % \begin{macrocode}
1131 \@gen@guit@fntcmd{pnc}{-0.322em}{0.678ex}{-0.125em}{-0.125em}
1132 \@gen@guit@fntcmd{pnc}[bx]{-0.36em}{0.656ex}{-0.125em}{-0.125em}
1133 % \end{macrocode}
1134 % \end{macro}
1135 % \end{macro}
1136 %
1137 % \begin{macro}{\@guitputm}
1138 % \changes{v0.9}{2005/11/27}{Modificato il nome aggiungendo la serie}
1139 % Per il font Utopia si usano i valori di questo comando.
1140 % \begin{macrocode}
1141 \@gen@guit@fntcmd{put}{-0.285em}{0.61ex}{-0.125em}{-0.125em}
1142 \AliasGuITLogoCommand{put}{bx}{put}{m}
1143 % \end{macrocode}
1144 % \end{macro}
1145 %
1146 % \begin{macro}{\@guitbchm}
1147 % \changes{v0.9}{2005/11/27}{Modificato il nome aggiungendo la serie}
1148 % \begin{macro}{\@guitbchbx}
1149 % Nel caso si usi il font Charter questa \`e la macro utilizzata.
1150 % \begin{macrocode}
1151 \@gen@guit@fntcmd{bch}{-0.28em}{0.58ex}{-0.125em}{-0.125em}
1152 \@gen@guit@fntcmd{bch}[bx]{-0.31em}{0.56ex}{-0.125em}{-0.125em}
1153 % \end{macrocode}
1154 % \end{macro}
1155 % \end{macro}
1156 %
1157 % \begin{macro}{\@guitpbkm}
1158 % \changes{v0.9}{2005/11/27}{Modificato il nome aggiungendo la serie}
1159 % \begin{macro}{\@guitpbkbx}
1160 % L'ultimo comando ``interno'' viene usato per il font Bookman.
1161 % \begin{macrocode}
1162 \@gen@guit@fntcmd{pbk}{-0.3em}{0.59ex}{-0.125em}{-0.125em}
1163 \@gen@guit@fntcmd{pbk}[bx]{-0.34em}{0.52ex}{-0.125em}{-0.125em}
1164 % \end{macrocode}
1165 % \end{macro}
1166 % \end{macro}
1167 %
1168 % \begin{macro}{\@@guitimp}
1169 % \changes{v0.8}{2004/10/28}{Enormemente semplificata grazie ai preziosi
1170 % suggerimenti del Prof.\ Enrico Gregorio; aggiunto un argomento}
1171 % L'implementazione del comando a disposizione dell'utente \`e molto
1172 % semplice: se non esiste la macro interna associata alla famiglia di font
1173 % selezionata si ricade sull'onnipresente Computer Modern Roman, altrimenti
1174 % si utilizza la macro appropriata.
1175 % \begin{macrocode}
1176 \def\@@guitimp#1{%
1177 \@ifundefined{@guit#1}{\@guitcmrm}{\@nameuse{@guit#1}}}
1178 % \end{macrocode}
1179 % \end{macro}
1180 %
1181 % \begin{macro}{\@guit@color@on}
1182 % \changes{v0.7}{2003/10/17}{Estratto il controllo sul valore di
1183 % \cs{@guit@colorized} in modo da effettuare l'operazione una volta sola}
1184 % \changes{v0.8}{2004/10/28}{Aggiunto un argomento opzionale}
1185 % \changes{v0.9}{2005/11/21}{Eliminati i controlli sull'uso del colore a
1186 % causa delle modifiche imposte dall'uso delle chiavi}
1187 % La porzione dell'implementazione di \cs{GuIT} che attiva la colorazione
1188 % del logo in seguito alla presenza del carattere \altro{*}.
1189 % \begin{macrocode}
1190 \newcommand*{\@guit@color@on}[1][]{%
1191 \@guitimp{color, #1}\ignorespaces}
1192 % \end{macrocode}
1193 % \end{macro}
1194 %
1195 % \begin{macro}{\@guit@color@off}
1196 % \changes{v0.8}{2004/10/28}{Aggiunto un argomento opzionale}
1197 % \changes{v0.9}{2005/11/21}{Eliminati i controlli sull'uso del colore a
1198 % causa delle modifiche imposte dall'uso delle chiavi}
1199 % La porzione dell'implementazione di \cs{GuIT} che potenzialmente non
1200 % altera la colorazione del logo.
1201 % \begin{macrocode}
1202 \newcommand*{\@guit@color@off}[1][]{%
1203 \@guitimp{#1}\ignorespaces}
1204 % \end{macrocode}
1205 % \end{macro}
1206 %
1207 % \begin{macro}{\GuIT}
1208 % Alla fine, ecco il comando a disposizione dell'utente finale per scrivere
1209 % il logo del \GuIT. L'implementazione gestisce unicamente la presenza
1210 % dell'asterisco, demandando il controllo dell'eventuale argomento opzionale
1211 % allo strato sottostante.
1212 % \begin{macrocode}
1213 \DeclareRobustCommand*{\GuIT}{%
1214 \@ifstar\@guit@color@on\@guit@color@off}
1215 % \end{macrocode}
1216 % \end{macro}
1217 %
1218 % \begin{macro}{\guit}
1219 % Per semplificarci (o, piuttosto, semplificarmi) la vita ecco la versione
1220 % del comando precedente con il nome completamente in lettere minuscole.
1221 % \begin{macrocode}
1222 \let\guit\GuIT
1223 % \end{macrocode}
1224 % \end{macro}
1225 %
1226 % \begin{macro}{\GuITtext}
1227 % \changes{v0.4}{2003/07/15}{Modificato il testo prodotto da questo comando
1228 % per aderire perfettamente alla dizione ufficiale del Gruppo}
1229 % \changes{v0.7}{2003/10/15}{Sdoppiata la definizione per tenere conto
1230 % dell'uso di \pacchetto{hyperref}}
1231 % \changes{v0.9}{2005/11/21}{Unificata la definizione per poter influenzare
1232 % la generazione del link tramite l'uso delle chiavi}
1233 % Il comando per indicare la denominazione completa e corretta del
1234 % Gruppo. L'unica chiave che ha effetto su questo comando \`e |link|.
1235 % \begin{macrocode}
1236 \DeclareRobustCommand*{\GuITtext}[1][]{%
1237 \begingroup
1238 \setkeys*{guit}{#1}%
1239 \@if@guit@link@or@hyperref
1240 {\href{\@guit@url}{Gruppo Utilizzatori Italiani di \TeX}}
1241 {Gruppo Utilizzatori Italiani di \TeX}%
1242 \endgroup
1243 \ignorespaces}
1244 % \end{macrocode}
1245 % \end{macro}
1246 %
1247 % \begin{macro}{\guittext}
1248 % Come per \cs{GuIT} forniamo la versione con il nome completamente in
1249 % lettere minuscole.
1250 % \begin{macrocode}
1251 \let\guittext\GuITtext
1252 % \end{macrocode}
1253 % \end{macro}
1254 %
1255 % \begin{macro}{\GuITtextEn}
1256 % \begin{macro}{\guittexten}
1257 % Per il comando che riporta la denominazione anglicizzata del \guit\ vale
1258 % quanto riportato per \cs{GuITtext} e \cs{guittext}.
1259 % \begin{macrocode}
1260 \DeclareRobustCommand*{\GuITtextEn}[1][]{%
1261 \begingroup
1262 \setkeys*{guit}{#1}%
1263 \@if@guit@link@or@hyperref
1264 {\href{\@guit@url}{Italian \TeX\ User Group}}
1265 {Italian \TeX\ User Group}%
1266 \endgroup
1267 \ignorespaces}
1268 \let\guittexten\GuITtextEn
1269 % \end{macrocode}
1270 % \end{macro}
1271 % \end{macro}
1272 %
1273 % \begin{macro}{\GuITurl}
1274 % \changes{v0.7}{2003/10/15}{Aggiunto questo comando per scrivere
1275 % l'indirizzo del sito internet di \guit~senza troppi errori}
1276 % \changes{v0.9}{2005/11/25}{Aggiunto un argomento opzionale per gestire le
1277 % chiavi}
1278 % Il comando per scrivere automaticamente l'indirizzo del sito internet di
1279 % \guit~``subisce'', implicitamente, l'effetto del caricamente del pacchetto
1280 % \pacchetto{hyperref}, quindi il comando scriverebbe sempre l'indirizzo del
1281 % sito come collegamento al sito stesso: per evitare questo effetto
1282 % collaterale \`e stato realizzato un accrocchio ad hoc. L'argomento
1283 % opzionale viene considerato un'estensione dell'indirizzo (una pagina, una
1284 % sezione, etc.) e composto di conseguenza.
1285 % \begin{macrocode}
1286 \DeclareRobustCommand*{\GuITurl}[1][]{%
1287 \begingroup
1288 \setkeys*{guit}{#1}%
1289 \@if@guit@link@or@hyperref
1290 {\let\@guit@url@imp\url}
1291 {\let\@guit@url@imp\@guit@url@nolink}%
1292 \edef\@tempa{\@guit@url}%
1293 \ifx\@empty\@tempa
1294 \relax
1295 \else
1296 \edef\@tempa{\@guit@document}%
1297 \ifx\@empty\@tempa
1298 \expandafter\@guit@url@imp\expandafter{\@guit@url}%
1299 \else
1300 \expandafter\expandafter\expandafter\@guit@url@imp%
1301 \expandafter\expandafter\expandafter{%
1302 \expandafter\@guit@url\expandafter/\@guit@document}%
1303 \fi
1304 \fi
1305 \endgroup
1306 \ignorespaces}
1307 \DeclareUrlCommand\@guit@url@nolink{}
1308 \define@cmdkey{guit}[@guit@]{document}{\relax}
1309 % \end{macrocode}
1310 % \end{macro}
1311 %
1312 % \begin{macro}{\guiturl}
1313 % Come per \cs{GuIT} forniamo la versione con il nome completamente in
1314 % lettere minuscole.
1315 % \begin{macrocode}
1316 \let\guiturl\GuITurl
1317 % \end{macrocode}
1318 % \end{macro}
1319 %
1320 % \begin{macro}{\GuITforum}
1321 % \changes{v0.7.2}{2004/09/16}{Aggiunto questo comando per scrivere
1322 % l'indirizzo del forum di \guit~senza troppi errori}
1323 % \changes{v0.9}{2005/11/27}{Reimplementato usando \cs{GuITurl} ed il nuovo
1324 % argomento opzionale; modificato l'indirizzo del forum su suggerimento di
1325 % Emiliano Giovanni Vavassori e Maurizio W. Himmelman}
1326 % \changes{v1.0.0}{2012/08/17}{Aggiornato l'URL del forum}
1327 % Quanto detto per \cs{GuITurl} vale anche per questo comando.
1328 % \begin{macrocode}
1329 \DeclareRobustCommand*{\GuITforum}[1][]{%
1330 \guiturl[#1, document=home/it/forum/index]}
1331 % \end{macrocode}
1332 % \end{macro}
1333 %
1334 % \begin{macro}{\guitforum}
1335 % Come per \cs{GuIT} forniamo la versione con il nome completamente in
1336 % lettere minuscole.
1337 % \begin{macrocode}
1338 \let\guitforum\GuITforum
1339 % \end{macrocode}
1340 % \end{macro}
1341 %
1342 % \begin{macro}{\GuITmeeting}
1343 % \changes{v0.7.3}{2004/10/11}{Aggiunto questo comando ed alcune macro
1344 % accessorie per realizzare il logo del convegno periodico}
1345 % \begin{macro}{\@guit@meeting@color@on}
1346 % \changes{v0.7.4}{2004/10/15}{Corretta una svista clamorosa nella selezione
1347 % del font da usare}
1348 % \changes{v0.7.5}{2004/10/17}{Ri-corretta questa macro (si spera per
1349 % l'ultima volta)}
1350 % \changes{v0.8.1}{2004/11/15}{Aggiunta l'indicazione dell'encoding da
1351 % usare}
1352 % \changes{v0.9}{2005/11/21}{Isolato praticamente tutto il codice in
1353 % un'altra macro}
1354 % \begin{macro}{\@guit@meeting@color@off}
1355 % \changes{v0.7.4}{2004/10/15}{Corretta una svista clamorosa nella selezione
1356 % del font da usare}
1357 % \changes{v0.7.5}{2004/10/17}{Ri-corretta questa macro (si spera per
1358 % l'ultima volta)}
1359 % \changes{v0.8.1}{2004/11/15}{Aggiunta l'indicazione dell'encoding da
1360 % usare}
1361 % \changes{v0.9}{2005/11/21}{Isolato praticamente tutto il codice in
1362 % un'altra macro}
1363 % L'implementazione del logo del convegno \`e stata partizionata per
1364 % realizzare una versione a colori duplicando poco codice.
1365 % \begin{macrocode}
1366 \DeclareRobustCommand*{\GuITmeeting}{%
1367 \@ifstar\@guit@meeting@color@on\@guit@meeting@color@off}
1368 \newcommand*{\@guit@meeting@color@on}[1][]{%
1369 \@guit@meeting@imp{*}{#1}}
1370 \newcommand*{\@guit@meeting@color@off}[1][]{%
1371 \@guit@meeting@imp{}{#1}}
1372 % \end{macrocode}
1373 % \end{macro}
1374 % \end{macro}
1375 % \end{macro}
1376 %
1377 % Definiamo due chiavi per gestire l'anno e lo stile del logo.
1378 % \begin{macrocode}
1379 \define@cmdkey{guit}[@guit@]{year}{\relax}
1380 \newif\if@guit@inline
1381 \define@choicekey*{guit}{style}[\val\nr]{inline,display}{%
1382 \ifcase\nr\relax
1383 \@guit@inlinetrue
1384 \or
1385 \@guit@inlinefalse
1386 \fi}
1387 % \end{macrocode}
1388 %
1389 % \begin{macro}{\@guit@meeting@imp}
1390 % In questa macro gestiamo le chiavi (|#2|) e l'asterisco (|#1|), impostiamo
1391 % il font da usare ed ordiniamo la macro con \textit{meeting} e quella che
1392 % si occupa dell'anno in base allo stile di visualizzazione attivo.
1393 % \begin{macrocode}
1394 \def\@guit@meeting@imp#1#2{%
1395 \begingroup
1396 \setkeys*{guit}{#2}%
1397 \fontencoding{OT1}\fontfamily{cmr}\fontseries{m}\selectfont
1398 \guit#1
1399 \if@guit@inline
1400 \@guit@meeting@part\@guit@meeting@year
1401 \else
1402 \@guit@meeting@year\@guit@meeting@part
1403 \fi
1404 \endgroup
1405 \ignorespaces}
1406 % \end{macrocode}
1407 % \end{macro}
1408 %
1409 % \begin{macro}{\@guit@meeting@part}
1410 % \changes{v0.9}{2005/11/21}{Modificata per tenere conto dei due stili del
1411 % logo}
1412 % Se il valore di |style| \`e |display|, allora la parte
1413 % ``\textit{meeting}'' del logo viene traslata usando per entrambe le
1414 % direzioni, come unit\`a di misura, \emph{ex} per cercare di limitare al
1415 % minimo le deformazioni dello spazio dovute alla definizione di \emph{em}
1416 % (che nella famiglia Computer Modern varia in maniera non proporzionale
1417 % alla dimensione nominale del font~\cite{CMT}).
1418 % \begin{macrocode}
1419 \def\@guit@meeting@part{%
1420 \if@guit@inline
1421 \textit{meeting}%
1422 \else
1423 \kern -2.02ex\lower 1.25ex\hbox{\textit{meeting}}%
1424 \fi}
1425 % \end{macrocode}
1426 % \end{macro}
1427 %
1428 % \begin{macro}{\@guit@meeting@year}
1429 % \changes{v0.9}{2005/11/21}{Aggiunto questo comando per gestire l'anno su
1430 % esplicita richiesta di Maurizio W.~Himmelmann}
1431 % \begin{macro}{\@guit@meeting@year@imp}
1432 % Se il valore di |style| \`e |display|, allora l'anno viene traslato e
1433 % ridimensionato usando \cs{scalebox}.
1434 % \begin{macrocode}
1435 \def\@guit@meeting@year{%
1436 \edef\@tempa{\@guit@year}%
1437 \ifx\@empty\@tempa
1438 \relax
1439 \else
1440 \@guit@meeting@year@imp{\@guit@year}%
1441 \fi}
1442 \def\@guit@meeting@year@imp#1{%
1443 \if@guit@inline
1444 \fontfamily{pzc}\selectfont #1
1445 \else
1446 \rlap{%
1447 \hskip0.7em\fontfamily{pzc}\selectfont
1448 \raise 0.5ex\hbox{\scalebox{0.85}{#1}}}%
1449 \fi}
1450 % \end{macrocode}
1451 % \end{macro}
1452 % \end{macro}
1453 %
1454 % \begin{macro}{\guitmeeting}
1455 % Come per \cs{GuIT} forniamo la versione con il nome completamente in
1456 % lettere minuscole.
1457 % \begin{macrocode}
1458 \let\guitmeeting\GuITmeeting
1459 % \end{macrocode}
1460 % \end{macro}
1461 %
1462 %
1463 % \`E essenziale che vengano impostate alcune chiavi in modo da creare
1464 % alcune macro d'uso interno prima di proseguire; per fare questo \`e
1465 % sufficiente utilizzare \cs{setupGuIT} con le impostazioni di default.
1466 % \begin{macrocode}
1467 \setupGuIT
1468 % \end{macrocode}
1469 %
1470 % Il codice seguente \`e stato integrato da \pacchetto{arslogo}, v0.1.3,
1471 % scritto da Massimo Caschili, dietro esplicita richiesta del \guittext,
1472 % detentore del copyright.
1473 % \begin{macrocode}
1474 \DeclareRobustCommand*{\Ars}{%
1475 \textsf{\lower -.48ex\hbox{\rotatebox{-20}{A}}\kern -.3em{rs}}%
1476 \kern -.05em\TeX\kern -.17em\lower -.357ex\hbox{nica}}
1477 \DeclareRobustCommand*{\Arsob}{\rotatebox{20}{\Ars}}
1478 \DeclareRobustCommand*{\ars}{%
1479 \textsf{\lower -.48ex\hbox{\rotatebox{-20}{A}}\kern -.3em{rs}}}
1480 \DeclareRobustCommand*{\tecnica}{%
1481 \TeX\kern -.17em\lower -.357ex\hbox{nica}}
1482 \DeclareRobustCommand*{\arsta}{%
1483 \ars \kern -0.65em\lower -1.3ex\hbox{\scalebox{0.18}{\hbox{%
1484 \TeX\kern -.17em\lower -.357ex\hbox{nica}}}}}
1485 \DeclareRobustCommand*{\arstb}{%
1486 \ars \kern -0.65em\lower -1.25ex\hbox{\scalebox{0.34}{\hbox{%
1487 \TeX\kern -.17em\lower -.357ex\hbox{nica}}}}}
1488 \DeclareRobustCommand*{\arstv}{%
1489 \ars \kern -0.05em\lower -1.818ex\hbox{\rotatebox{-90}{\hbox{%
1490 \scalebox{0.225}{\hbox{%
1491 \TeX\kern -.17em\lower -.357ex\hbox{nica}}}}}}}
1492 \DeclareRobustCommand*{\arsto}{%
1493 \rotatebox{49}{\lower -.84ex\hbox{\scalebox{0.214}{\hbox{%
1494 \TeX\kern -.17em\lower -.357ex\hbox{nica}}}}}%
1495 \kern -.74em\hbox{\ars}}
1496 \DeclareRobustCommand*{\Arsto}{%
1497 \rotatebox{49}{\lower -.84ex\hbox{\scalebox{0.214}{\hbox{%
1498 \TeX\kern -.17em\lower -.357ex\hbox{nica}}}}}%
1499 \kern -.74em\hbox{\Ars}}
1500 % \end{macrocode}
1501 %
1502 % Terminiamo leggendo il file di configurazione. Nel caso non si riuscisse a
1503 % trovarlo, ci limitiamo ad avvertire l'utente.
1504 % \begin{macrocode}
1505 \InputIfFileExists{guit.cfg}%
1506 {\relax}%
1507 {\PackageInfo{guit}{Configuration file not found}}
1508 %</style>
1509 % \end{macrocode}
1510 %
1511 %
1512 %
1513 % \subsection{Il file di configurazione}
1514 % Il file di configurazione \`e, in realt\`a, vuoto e fornisce solo qualche
1515 % esempio. La definizione delle realizzazioni del logo e del colore
1516 % predefinito del logo non \`e inserita veramente nel file di configurazione
1517 % per diminuire il rischio che l'utente le modifichi o le rimuova
1518 % accidentalmente.
1519 % \begin{macrocode}
1520 %<*cfg>
1521 \ProvidesFile{guit.cfg}[2020/07/03 v1.0.0-alpha.4 File di configurazione di guit.sty]
1522 %% Esempi:
1523 %% \GuITcolor{1, 0, 1, 0.6}
1524 %% \DeclareGuITLogoCommand{lmr}{-0.26em}{0.714ex}{-0.125em}{-0.125em}
1525 %% \AliasGuITLogoCommand{lmr}{b}{lmr}{m}
1526 %% \AliasGuITLogoCommand{lmr}{bx}{lmr}{m}
1527 %% \DeclareGuITLogoCommand{ptm}{-0.27em}{0.5475ex}{-0.125em}{-0.125em}
1528 %% \DeclareGuITLogoCommand{ptm}[bx]{-0.345em}{0.68ex}{-0.125em}{-0.125em}
1529 %% \DeclareGuITLogoCommand{ppl}{-0.276em}{0.717ex}{-0.125em}{-0.125em}
1530 %% \DeclareGuITLogoCommand{ppl}[bx]{-0.33em}{0.689ex}{-0.125em}{-0.125em}
1531 %% \DeclareGuITLogoCommand{pnc}{-0.322em}{0.678ex}{-0.125em}{-0.125em}
1532 %% \DeclareGuITLogoCommand{pnc}[bx]{-0.36em}{0.656ex}{-0.125em}{-0.125em}
1533 %% \DeclareGuITLogoCommand{put}{-0.285em}{0.61ex}{-0.125em}{-0.125em}
1534 %% \AliasGuITLogoCommand{put}{bx}{put}{m}
1535 %% \DeclareGuITLogoCommand{bch}{-0.28em}{0.58ex}{-0.125em}{-0.125em}
1536 %% \DeclareGuITLogoCommand{bch}[bx]{-0.31em}{0.56ex}{-0.125em}{-0.125em}
1537 %% \DeclareGuITLogoCommand{pbk}{-0.3em}{0.59ex}{-0.125em}{-0.125em}
1538 %% \DeclareGuITLogoCommand{pbk}[bx]{-0.34em}{0.52ex}{-0.125em}{-0.125em}
1539 %</cfg>
1540 % \end{macrocode}
1541 %
1542 %
1543 %
1544 % \makeatletter
1545 % \c@IndexColumns=2
1546 % \c@GlossaryColumns=2
1547 % \def\index@prologue{\section*{Indice}%
1548 % \markboth{Indice}{Indice}%
1549 % I numeri scritti in corsivo si riferiscono alla pagina in cui la voce
1550 % corrispondente viene descritta; i numeri sottolineati si riferiscono
1551 % alla
1552 % \ifcodeline@index
1553 % linea di codice della
1554 % \fi
1555 % definizione; i numeri in carattere tondo si riferiscono alle
1556 % \ifcodeline@index
1557 % linee di codice
1558 % \else
1559 % pagine
1560 % \fi
1561 % in cui la voce viene usata.}%
1562 % \def\glossary@prologue{\section*{{Storico dei cambiamenti}}%
1563 % \markboth{{Storico dei cambiamenti}}{{Storico dei cambiamenti}}}%
1564 % \makeatother
1565 % \clearpage
1566 % \Finale
1567 % \clearpage
1568 % \PrintIndex
1569 % \clearpage
1570 % \PrintChanges
1571 %
1572 %
1573 %
1574 \endinput