robitex

Ciao a tutti.
I sorgenti della ‘Guida tematica alla riga di comando’ sono disponibili nel repository github del gruppo.

Come promesso, da ora in avanti la guida potrà essere sviluppata in modo collaborativo attraverso il sistema di controllo git che permette di inviare ‘pull request’ all’indirizzo del repository principale.
Veramente interessante non credete?
Roberto

ivan” post=80218Perché non si può usare semplicemente #2 al posto di \l_tmpa_tl?

Perché in realtà l’argomento obbligatorio è un nome di un campo di una variabili proprietà.
Ho adattato il comando. L’argomento #2 può essere utilizzato direttamente.
Un saluto.
R.

egreg9″ post=80203

Ciao,
nel seguente codice LaTeX3 definisco due chiavi, la prima chiamata ‘name’ e la seconda chiamata ‘secname’ (secondo nome).
L’effetto che vorrei ottenere è che se non specifico un valore per la chiave secname, questa assuma il valore della chiave ‘name’.
`
\documentclass{article}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage[italian]{babel}

\usepackage{expl3}
\usepackage{xparse}

\ExplSyntaxOn
\keys_define:nn { gdsfamily }
{
name .tl_set:N = \g_gds_name_tl,
name .default:n = Paperino,

secname .tl_set:N = \g_gds_secname_tl,
secname .default:V = \g_gds_name_tl % non funziona con .default:n si
}

\keys_set:nn { gdsfamily } { name }
\keys_set:nn { gdsfamily } { secname }

\NewDocumentCommand { \name } { }
{
\tl_use:N \g_gds_name_tl
}

\NewDocumentCommand { \secname } { }
{
\tl_use:N \g_gds_secname_tl
}
\ExplSyntaxOff

\begin{document}
Il nome è il seguente: \name{} \secname.
\end{document}`
Il codice non funziona, ma se cambio la funzione da .default:V a .default:n funziona, come mai?
Grazie R.

Con [tt].default:V= \g_gds_name_tl[/tt] imposti il valore di default al valore attuale della variabile che, naturalmente è vuoto perché [tt]name[/tt] non è ancora stata impostata, ma solo definita. Se usi [tt].default:n[/tt] come valore viene presa la variabile [tt]\g_gds_name_tl[/tt]. Se infatti provi senza impostare un valore per [tt]name[/tt] avrai un valore vuoto.

Devi definire la chiave in modo diverso:
`\keys_define:nn { gdsfamily }
{
secname .code:n =
\tl_if_empty:nTF { #1 }
{ \tl_gset:NV \g_gds_secname_tl \g_gds_name_tl }
{ \tl_gset:Nn \g_gds_secname_tl { #1 } }
}`
Tiratina d’orecchie quotidiana. 🙂 Le variabili globali vanno sempre usate globalmente. Quindi [tt]_gset[/tt], non [tt]_set[/tt].

Ciao
Enrico

Questa volta la tiratina d’orecchie, una volta tanto, posso fartela io! 🙂
Infatti ho modificato la definizione delle chiavi con la tua proposta:
`\keys_define:nn { gdsfamily }
{
name .tl_gset:N = \g_gds_name_tl,
name .default:n = Paperino,

secname .code:n =
\tl_if_empty:nTF { #1 }
{\tl_gset:NV \g_gds_secname_tl \g_gds_name_tl}
{\tl_gset:Nn \g_gds_secname_tl { #1 } },
}
\keys_set:nn { gdsfamily } { name }
\keys_set:nn { gdsfamily } { secname }`

Tutto bene, un codice pulito e semplice: quando assegno la chiave ‘secname’ senza valore essa imposterà la sua corrispondente variabile a quello della variabile in cui è salvato il valore della chiave ‘name’, mentre se passo un valore questo diverrà quello salvato.

Se però chiamo assegno solamente la chiave ‘name’ la chiave ‘secname’ non prenderà il nuovo valore se non verrà espressa:
Con questi comandi infatti
`\NewDocumentCommand { \name } { m }
{
\keys_set:nn { gdsfamily } { name = #1 }
\tl_use:N \g_gds_name_tl
}

\NewDocumentCommand { \secname } { }
{
\tl_use:N \g_gds_secname_tl
}`
e questo codice utente:
`Il nome è il seguente: \name{Pluto} \secname.`
Ottengo (ovviamente) non: “Il nome è il seguente: Pluto Pluto.” ma “Il nome è il seguente: Pluto Paperino.”

L’importante è che LaTeX3 sia in grado di creare un ambiente di programmazione pulito.

Illustro adesso un codice che funziona (considera che ho le orecchie già abbastanza tirate…).
Assegno i valori di default con .default:n:
`\documentclass{article}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage[italian]{babel}

\usepackage{expl3}
\usepackage{xparse}

\ExplSyntaxOn
\keys_define:nn { gdsfamily }
{
name .tl_gset:N = \g_gds_name_tl,
name .default:n = Paperino,

secname .tl_gset:N = \g_gds_secname_tl,
secname .default:n = \g_gds_name_tl,
}

\keys_set:nn { gdsfamily } { name , secname }

\NewDocumentCommand { \setnames } { m }
{
\keys_set:nn { gdsfamily } { #1 }
}

\NewDocumentCommand { \getname } { m }
{
\tl_use:c { g_gds_#1_tl }
}
\ExplSyntaxOff

\begin{document}
Se non si impostano le chiavi esse prendono il valore di default: Il nome è il seguente: \getname{name}, il secondo nome è \getname{secname}.

\setnames{ name = Pluto }

Adesso, il nome è \getname{name}, e la chiave dovrebbe essere con lo stesso valore che è appunto: \getname{secname}.

\setnames{secname = Mitico Pippo}
Dopo aver assegnato anche la chiave del secondo nome lo stampiamo: \getname{secname} (il nome principale è rimasto a \getname{name}).

\setnames{name = Topolino}
Se a questo punto modifichiamo anche il primo nome avremo: nome = \getname{name}, secondo nome = \getname{secname}.
\end{document}
`

Alla prossima3.
Ciao e grazie.
R.

A ecco.
Cercavo una funzione del genere nella documentazione interface3 e non ero accorto della funzione alternativa \clist_map_inline:nn.
Questa funzione accetta una lista esplicita come primo argomento ed applica a tutti gli elementi della lista la funzione esplicita del secondo argomento.
L’elemento della lista è rappresentato da ##1 poiché siamo all’interno di un’altra funzione.

Grazie.
R.

Ecco un miglioramento per la funzione interna che salva in una variabile proprietà un valore in virgola mobile. Invece di chiamarla tante volte quante sono le variabili in virgola mobile, è possibile passare l’elenco delle variabili una sola volta come lista di valori.
La funzione diventerebbe quindi questa:
`\cs_new:Nn \gds_save_values:
{
\prop_gput:NnV \g_gds_salval_prop { numsal } \g_gds_numsal_tl
\gds_savein_fpval:n { impsal,
implav,
impsalnetto,
implavnetto,
impsic,
rib
}
}`
mentre la funzione di servizio verrebbe modificata molto poco in questa:
`\cs_new:Nn \gds_savein_fpval:n
{
\clist_set:Nn \l_tmpa_clist { #1 }
\clist_map_inline:Nn \l_tmpa_clist
{
\prop_gput:Nnx \g_gds_salval_prop { ##1 }
{
\fp_use:c { g_gds_##1_fp }
}
}
}`
Buona domenica!
R.

L’idea è quella di inserire con la sintassi chiave valore una serie di dati, elaborarne numericamente alcuni e rendere disponibili i risultati con un altrettanto semplice comando \getdata{}.

Per il primo passo ci pensa l3keys, per il secondo l3fp e per il terzo l3prop:
`\documentclass{article}

\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage[italian]{babel}

\usepackage{siunitx}
\usepackage{eurosym}
\usepackage{booktabs}

\sisetup{output-decimal-marker={,}}

\ExplSyntaxOn
\fp_new:N \g_impsal_fp
\fp_new:N \g_implavnetto_fp
\fp_new:N \g_impsalnetto_fp

\cs_new:Nn \my_process_values:
{
\fp_set:Nn \g_impsal_fp
{
\fp_use:N \g_implav_fp + \fp_use:N \g_impsic_fp
}
\fp_set:Nn \g_implavnetto_fp
{
( 1 – \fp_use:N \g_rib_fp/100 ) * \fp_use:N \g_implav_fp
}
\fp_set:Nn \g_impsalnetto_fp
{
\fp_use:N \g_implavnetto_fp + \fp_use:N \g_impsic_fp
}
}

\prop_new:N \g_salval_prop

\cs_new:Nn \my_save_values:
{
\prop_put:NnV \g_salval_prop { numsal } \g_numsal_tl
\prop_put:Nnn \g_salval_prop { impsal }
{
\fp_use:N \g_impsal_fp
}
\prop_put:Nnn \g_salval_prop { implav }
{
\SI[ round-mode = places ,
round-precision = 2 ]
{ \fp_use:N \g_implav_fp }{ \euro }
}
\prop_put:Nnn \g_salval_prop { impsalnetto }
{
\SI[ round-mode = places ,
round-precision = 2 ]
{ \fp_use:N \g_impsalnetto_fp }{ \euro }
}
\prop_put:Nnn \g_salval_prop { implavnetto }
{
\SI[ round-mode = places ,
round-precision = 2 ]
{ \fp_use:N \g_implavnetto_fp }{ \euro }
}
\prop_put:Nnn \g_salval_prop { impsic }
{
\SI[ round-mode = places ,
round-precision = 2 ]
{ \fp_use:N \g_impsic_fp }{ \euro }
}
\prop_put:Nnn \g_salval_prop { rib }
{
\SI{ \fp_use:N \g_rib_fp }{ \percent }
}

}

\keys_define:nn { salValues }
{
numsal .tl_set:N = \g_numsal_tl,
numsal .default:n = x,

implav .fp_set:N = \g_implav_fp,
impsic .fp_set:N = \g_impsic_fp,
rib .fp_set:N = \g_rib_fp,
}

\NewDocumentCommand { \setdata } { m }
{
\keys_set:nn { salValues }
{ #1 }
\my_process_values:
\my_save_values:
}
\NewDocumentCommand { \getdata } { m }
{
\prop_get:NnN \g_salval_prop { #1 } \l_tmpa_tl
\tl_use:N \l_tmpa_tl
}
\ExplSyntaxOff

\setdata{
numsal = 3,
implav = 12819.01,
impsic = 1.00,
rib = 25.151,
}

\begin{document}

% ok
Il numero del sal è \getdata{numsal}.

% ok
Il valore netto dei lavori è \getdata{implavnetto}.

% ok
L'importo del sal numero \getdata{numsal} è \getdata{impsal}~\euro.

% error
%L'importo del sal numero \getdata{numsal} è \SI{\getdata{impsal}}{\euro}.

\end{document}`

Come vedete dal codice che segue la strategia descritta e che funziona abbastanza bene, ci sono un po’ di guai.
Non riesco ad espandere correttamente il numero nel comando \SI (funziona solo se memorizzo nella proprietà l’intera formattazione con siunitx.
Se per caso digito una chiave dalla sintassi sbagliata la compilazione si blocca indefinitivamente (per esempio un \getdata{nonesisto}).
Ho un po’ troppa ridondanza nei nomi tra funzioni e variabili, come si può notare dal codice delle funzioni \my_process_values: e \my_save_values: (la leggibilità non è il massimo)

Ho implementato il tutto anche in LuaTeX incontrando meno problemi. Non ho ancora risolto del tutto l’argomento con LuaTeX perciò non vi riporterò qui il codice.
Grazie per aver seguito fino a qui.
R.