Come si usa il pachetto xkeyval

Voglio imparare ad usare il pacchetto xkeyval. Mettiamo che io abbia questo ambiente un po’ stupido:
`
\usepackage{xkeyval,xcolor}
\newenvironment{scatola}[2][black]{\par\color{#1}\hrule\vskip3pt\textcolor{#2}\bgroup}{\egroup\vskip3pt\hrule\par}
\begin{document}
\begin{scatola}[blue]{red}
testo
\end{scatola}
\end{document} `

Io con xkeyval voglio poter scrivere
`
\begin{scatola}[colorrule=black,colortext=green]
testo
\end{scatola}
`

per avere i rulli neri e il testo verde, o
`
\begin{scatola}
testo
\end{scatola}`

per avere, di default, i rulli blu e il testo rosso.

Così il codice è più comprensibile. Ho letto la documentazione di xkeyval ma non ci ho capito un tubo. Ho visto anche il topic
http://www.guit.sssup.it/phpbb/viewtopic.php?t=3316&highlight=longmedal
dell’ambiente di Agostino, ma per ora è un po’ troppo complesso per me.

`\makeatletter
\newenvironment{scatola}[1][]
{\setkeys{scatola}{#1}%
\par\scatola@rulecolor%
\hrule\vskip3pt\begingroup\scatola@textcolor}
{\endgroup\vskip3pt\hrule}
\define@key{scatola}{rulecolor}{\def\scatola@rulecolor{\color{#1}}}
\define@key{scatola}{textcolor}{\def\scatola@textcolor{\color{#1}}}
\def\scatola@rulecolor{\color{black}}
\def\scatola@textcolor{\color{black}}
\makeatother`
Vediamo una prova:
`\begin{scatola}
testo nero righe nere
\end{scatola}
\medskip
\begin{scatola}[textcolor=green]
testo verde righe nere
\end{scatola}
\medskip
\begin{scatola}[rulecolor=red]
testo nero righe rosse
\end{scatola}
\medskip
\begin{scatola}[textcolor=blue,rulecolor=red]
testo blu righe rosse
\end{scatola}`
Passi l’argomento opzionale, dove stabilisci i valori, a \setkeys; il primo argomento serve per poter avere chiavi con lo stesso nome anche con impieghi diversi.

Con \define@key dici come usare il valore. Siccome ci sono questioni di gruppi, do anche un valore di default ai comandi usati per i colori, in modo che questi comandi abbiano sempre una definizione.

Ciao
Enrico

Ora mi puoi spiegare brevemente l’ambito di utilizzo della command key, sez. 3.2
` \define@cmdkey[]{}[]{}[]{} `

Molto spesso l’uso di \define@key si riduce a
`\define@key{famiglia}{chiave}{\def\famiglia@chiave{#1}}`
Se questo accade per tutte le chiavi, puoi usare
`\define@cmdkey{famiglia}{chiave}`
e questo equivale a
`\define@key{famiglia}{chiave}{\def\cmdKV@famiglia@chiave{#1}}`
Basta quindi sostituire \cmdKV@famiglia@chiave al comando \famiglia@chiave e si ha un piccolo risparmio di token. Ma la lista di “chiavi=valore” va passata a \define@cmdkeys invece che a \setkeys.

Poi ci sono gli argomenti opzionali che talvolta possono diventare utili.

Almeno così è come lo capisco io. Nell’esempio “scatola” non si può usare, perché il valore va dato come argomento a \color.

Ciao
Enrico

Prof scusa se ti rompo le scatole amche di domenica,

dato
` \define@key[]{}{}[]{}`

Ho provato a scrivere
`\define@key{scatola}{rulecolor}[black]{\def\scatola@rulecolor{\color{#1}}}
\define@key{scatola}{textcolor}[black]{\def\scatola@textcolor{\color{#1}}}`

al posto di
`\define@key{scatola}{rulecolor}{\def\scatola@rulecolor{\color{#1}}}
\define@key{scatola}{textcolor}{\def\scatola@textcolor{\color{#1}}}
\setkeys{scatola}{textcolor=black,rulecolor=black}%al posto delle due successive
%\def\scatola@rulecolor{\color{black}}
%\def\scatola@textcolor{\color{black}}`

ma dà errore. Quale è il ruolo di []? Serve a tutt’altro?

Serve ad assegnare un valore se si specifica solo la chiave senza il valore. Di solito si usa con true e false, ma non solo. Quindi puoi scrivere
`\newenvironment{scatola}[1][]
{\setkeys{scatola}{textcolor,rulecolor,#1}%
\par\scatola@rulecolor%
\hrule\vskip3pt\begingroup\scatola@textcolor}
{\endgroup\vskip3pt\hrule}
\define@key{scatola}{rulecolor}[black]{\def\scatola@rulecolor{\color{#1}}}
\define@key{scatola}{textcolor}[black]{\def\scatola@textcolor{\color{#1}}}`
che ti dà il vantaggio di avere il default in un posto ben determinato.

Ciao
Enrico