Parametri di configurazione¶

La configurazione di pTabs2 è controllata da una serie di parametri. Tutti i parametri hanno già un valore di default che può essere sufficiente per i casi più comuni. E’ possibile modificare i file di configurazione oltre che modificare i vari parametri all’interno dello script.

La modifica dei parametri relativi al calcolo e al layout delle tabelle hanno effetto solo sulle tabelle successive.

I parametri logici (true|false), vengono attivati e disattivati negli script con la sintassi: parametro! e parametro_. Per i restanti parametri, si passa l’argomento dopo il nome del parametro.

parametro? stampa e restituisce il valore correntemente impostato del parametro.

 rowpct!           # attiva la visualizzazione delle percentuali di riga
 stdev_            # disattiva la visualizzazione della deviazione standard
 frm_mean {:p=>3}  # imposta tre decimali nel formato delle medie
 net_pos?          # stampa nel log il valore del parametro 'net_pos'

Configurazione¶

Parametro Tipo Default Descrizione

locale Symbol :it Lingua interfaccia

themename Symbol :ptabs2 Tema di default

script_encoding String "iso-8859-1" Codifica script

csv_encoding String "iso-8859-15" Codifica CSV

spss_encoding String "iso-8859-1" Codifica SPSS

spss_max_string_size Integer 2500 Lunghezza massima stringhe SPSS

html_pretty Boolean false Formatta il codice HTML

direct_call_var Symbol :warn Comportamento in caso di chiamata diretta di una variabile: :none, :warn, :error

underscore_to_dot Boolean true Nei nomi delle variabili converte il punto in underscore (solo nel file di configurazione)

warn_varname Boolean true Visualizza i warning per le variabili con nomi con validi (solo nel file di configurazione)

empty_string_as_blank Boolean false In lettura converte le stringhe vuote in valori mancanti

email_user String nil User email

email_psw String nil Password email

dialog_error Boolean true Attiva o meno la finestra di dialogo con l’errore

beep_error Array [500, "A3", "C#4", "F4", "G#4"] Beep sugli errori: false|[time, notes]

beep_warn Boolean false Beep sui warning: false|[time, notes]

beep_end Array [300, "E5"] Beep alla fine dell’esecuzione: false|[time, notes]

Report¶

Parametro Tipo Default Descrizione

img String nil Nome o indirizzo file immagine per prima pagina; formati: gif, jpeg, png, jpg

img_link String nil Indirizzo link immagine

img_encode Boolean false Immagine incorporata nell’HTML

img_foot String nil Nome o indirizzo file immagine per footer; formati: gif, jpeg, png, jpg

img_foot_link String nil Indirizzo link immagine per footer

img_foot_encode Boolean false Immagine incorporata nell’HTML

footer String nil Testo footer

html_index Boolean true Genera l’indice nell’output HTML

html_index_link Boolean true Genera il link all’indice dopo la tavola nell’output HTML

Tabelle¶

Parametro Tipo Default Descrizione

stat_by_side_freq Boolean true Statistiche nelle colonne per le tabelle con solo totale (anche by_stat)

value_by_side_freq Boolean false Valori nelle colonne per le tabelle con solo totale (anche by_value)

header_break_word Boolean true E’ possibile spezzare le parole nelle intestazioni di colonna

corner_frame Boolean true Corner con bordo o senza

max_items_show Integer 100 Massimo numero di items

num_of_tails Integer 5 Numero degli item da mostrare in coda

smart_rowlabel Boolean false Evita ripetizioni di etichette

hide_same_text Boolean true Nelle tabelle nasconde la parte iniziale di testo uguale in un set di label

total_after Boolean false

rtotals Symbol :all :one|:all

show_missing_levels Boolean false Visualizzazione categorie missing

all_bold Boolean true Stile bold totale citazioni

all_italic Boolean false Stile italic totale citazioni

na_bold Boolean false Stile bold valori mancanti

na_italic Boolean true Stile italic valori mancanti

rowlabel Boolean false Stampa l’etichetta della variabile di riga

join_row_labels Boolean true Unisce le righe sotto un’unica etichetta quando variabili consecutive hanno la stessa etichetta

data_alt_color Boolean false Attiva il colore alternativo per le celle della tabella

Pannelli¶

Parametro Tipo Default Descrizione

join_col_labels Boolean true Unisce le colonne sotto un’unica etichetta quando variabili consecutive hanno la stessa etichetta

weights_vars_action Symbol :message Comportamento in caso di non corrispondenza dei pesi: :error, :message, :none

var_alt_color Boolean false Attiva il colore alternativo per etichette delle variabili di pannello

val_alt_color Boolean false Attiva il colore alternativo per etichette degli item delle variabili di pannello

Etichette¶

Parametro Tipo Default Descrizione

language Array [:it, :en] Lingua etichette

missing_translation Symbol :warn Azione se non viene trovata una traduzione: :none|:warn|:err

title_pos Symbol :caption Posizione titolo tabella: :caption|:banner

repeat_title Boolean false Ripete il titolo nelle tabelle dei pannelli successivi

convert_case Boolean false Converte le etichette di riga e di colonna: :titleize, :capitalize, :upcase, :downcase

show_row_codes Boolean false Mostra codici riga

show_col_codes Boolean false Mostra codici colonna

clean_labels_file String "cleanlabels.txt" Nome del file con le parole da eliminare nelle etichette

xtab_label_size Integer 50 Numero massimo di carateri nelle etichette di xtab; nil = nessuna limitazione

Zero e basse numerosita’¶

Parametro Tipo Default Descrizione

empty_table Symbol :message Comportamento per tabelle con 0 casi: :print, :message, :none

no_number String "-"

zero String "-"

drop_zero_if_more_rows Integer 0 Nasconde le righe della tabella con zero casi: 0=non elimina nulla; n=elimina se item>n; -1=elimina sempre

drop_zero_if_more_cols Integer 0 Nasconde le colonne della tabella con zero casi: 0=non elimina nulla; n=elimina se item>n; -1=elimina sempre

low_values Symbol :weight Considera il numero di casi ponderati (:weight) o grezzi (:raw)

low_table Symbol :print Comportamento per tabelle con numero basso di casi: :print, :message, :none

low_table_count Integer 0 Numero di casi per considerare una tabella come tabella con numero basso di casi

low_cell Symbol :print Comportamento per celle con numero basso di casi: print, :hide

low_cell_count Integer 0 Numero di casi per considerare una cella come cella con numero basso di casi

missing_weights Symbol :error Comportamento in caso di valori nulli nella variabile di ponderazione: :none, :warn, :error

Statistiche¶

Parametro Tipo Default Descrizione

rtotal Boolean true La riga del totale

ctotal Boolean true La colonna del totale

tcount_u Boolean false Totale valori assoluti non ponderati

tcount Boolean true Totale valori assoluti

tcolpct Boolean false Totale percentuali riga

trowpct Boolean true Totale percentuali colonna

count_u Boolean false Valori assoluti non ponderati

count Boolean true Valori assoluti

rowpct Boolean false Percentuali riga

colpct Boolean true Percentuali colonna

totpct Boolean false Percentuali totale

cumpct Boolean false Percentuali colonna cumulate

base_u Boolean false Base non pesata

base Boolean true Base

mean Boolean true Media

stdev Boolean true Deviazione standard

serr Boolean false Errore standard della media

min Boolean false Minimo

max Boolean false Massimo

limits Boolean false “min-max”

median Boolean false Mediana (non pesata)

mode Boolean false Moda (non pesata)

qtiles Boolean false Quantili (non pesati)

range Boolean false Range, campo di variazione

tsum Boolean false Totale della somma

sum Boolean false Somma

sumpct Boolean false Percentuale della somma

mresp Boolean false Numero medio risposte multiple

nresp Boolean false Numero totale risposte multiple

nvals Boolean false Numero valori

miss Boolean false Risposte mancanti (blank)

miss_u Boolean false Risposte mancanti (blank non pesati)

misspct Boolean false Risposte mancanti percentuali (blank)

misspct_u Boolean false Risposte mancanti percentuali (blank non pesati)

i_conc Boolean false Indice concentrazione

serr_base Symbol :weight Base per il calcolo dello standard error: :raw|:weight|:expansion

Formati¶

Parametro Tipo Default Descrizione

dec_sep String "," Separatore decimali

ths_sep String "." Separatore migliaia (nil per nessun separatore)

frm_count Hash {:p=>0} Formato valori assoluti

frm_pct Hash {:p=>1} Formato percentuali

frm_i_conc Hash {:p=>1} Formato indice concentrazione

frm_base Hash {:p=>0} Formato base

frm_mean Hash {:p=>2} Formato media

frm_stdev Hash {:p=>2} Formato deviazione standard

frm_serr Hash {:p=>2} Formato errore standard della media

frm_min Hash {:p=>1} Formato minimo

frm_max Hash {:p=>1} Formato massimo

frm_limits Hash {:p=>1} Formato limits

frm_qtiles Hash {:p=>1} Formato quantili

frm_median Hash {:p=>0} Formato mediana

frm_mode Hash {:p=>0} Formato moda

frm_range Hash {:p=>1} Formato range

frm_nvals Hash {:p=>0} Formato numero valori

frm_tsum Hash {:p=>2} Formato totale somma

frm_sum Hash {:p=>2} Formato somma

frm_ic Hash {:p=>2} Formato intervallo confidenza

frm_mresp Hash {:p=>1} Formato numero medio risposte multiple

frm_nresp Hash {:p=>0} Formato numero totale risposte multiple

frm_coord Hash {:p=>6} Formato coordinate

frm_miss Hash {:p=>0} Formato risposte mancanti

frm_miss_u Hash {:p=>0} Formato risposte mancanti

frm_datetime Hash {:t=>"%H:%M:%S", :d=>"%d-%m-%Y", :dt=>"%d-%m-%Y %H:%M:%S"} Formato data e tempo (https://ruby-doc.org/core-2.2.0/Time.html#method-i-strftime)

default_format Hash {:type=>:integer, :size=>1, :ndec=>0} Formato di default per le variabili

Net¶

Parametro Tipo Default Descrizione

net_pos Symbol :before Posizione net: :before, :after, :top, :bottom

net_computed_pos Symbol :after Posizione net calcolati: :before, :after, :top, :bottom

netonly Boolean false Stampa solo i net

netstyle Boolean true Distingue graficamente i net dagli altri item

save_sng_net Boolean false Salva come variabili i net singoli

Multiple¶

Parametro Tipo Default Descrizione

md_true_value Integer 1 Valore da contare nelle multidicotomy (“citato”)

md_false_value Integer 0 Valore “non citato” nelle multidicotomy

md_label_on_code Boolean false Etichetta item nell’etichette del codice (true) o nell’etichetta della variabile (false)

mc_has_same_labels Boolean true Le variabili di un set di multicategory devono avere le stesse etichette

Basi¶

Parametro Tipo Default Descrizione

base_tcount Symbol :table Metodo di calcolo del totale: :table, :all

base_colpct Symbol :table Metodo di calcolo delle percentuali di colonna: :table, :all

base_rowpct Symbol :table Metodo di calcolo delle percentuali di riga: :table sui marginali della variabile di fiancata, :var[iable] sui marginali di ciascuna variabile di pannello :all se e’ attivo un filtro, calcola per percentuali sul totale della variabile di fiancata (solo per cat, ord, md e tbox)

base_multi Symbol :cases Metodo di calcolo delle percentuali di colonna nelle tabelle md: :cases, :resp, :all, :var

base_tbox Symbol :table Metodo di calcolo delle percentuali di colonna per le tabelle tbox: :table, :var

Filtri¶

Parametro Tipo Default Descrizione

save_filter Boolean false Salva come variabili i filtri

filter_prefix String "f_" Prefisso variabili filtro

Scale¶

Parametro Tipo Default Descrizione

scale_style Symbol :compact :compact, :long

scale_total Boolean false Mostra una riga con la base ()

scale_label String nil :stat stampa l’etichetta della statitica; :var stampa l’etichetta della variabile; nil comportamento deciso da pTabs

base_sumpct Symbol :sum :sum, :count

Pesi¶

Parametro Tipo Default Descrizione

wlegend Boolean true Mostra la legenda dei pesi utilizzati

wtemplate String nil Template per mostrare i pesi con le etichette

wlog Boolean true Stampa nel log il risultato dei comandi w e weights

wcomplete Boolean false Aggiunge i pesi dei livelli non spoecificati nei comandi w e weights

Intervalli di confidenza¶

Parametro Tipo Default Descrizione

cim_sig Float 0.05 Livello di significativita’ intervallo di confidenza medie

cim_l Boolean false Intervallo di confidenza medie limite inferiore

cim_s Boolean false Intervallo di confidenza medie limite superiore

cim_e Boolean false Intervallo di confidenza medie errore

cip_sig Float 0.05 Livello di significativita’ intervallo di confidenza proporzioni

cip_l Boolean false Intervallo di confidenza proporzioni limite inferiore

cip_u Boolean false Intervallo di confidenza proporzioni limite superiore

cip_e Boolean false Intervallo di confidenza proporzioni errore

ci_note Boolean true Attiva/disattiva le note

Test¶

Parametro Tipo Default Descrizione

pc_pairs Symbol :var Confronti all’interno delle variabile (:var), tra tutte le colonne (:all), specifiche coppie di colonne (un pannello: ‘2,4;2,5;1,7,6,8’, piu’ pannelli: [‘2,4;2,5’, ‘4,8;4,9;4,11’])

pc_test_level Symbol :conf :conf => nota con livello di confidenza; :sig => nota con livello di significativita’

pc_note_comp Boolean false Nota confronti effettuati

pcm Boolean false Attiva/disattiva il Pairwise Comparisons test sulle medie

pcm_sig Float 0.05 Livello di significativita’ t-test

pcm_adj Symbol :none Metodo di correzione p-value: :bonf, :none

pcm_minbase Integer 0 Numero minimo di casi per eseguire il test

pcm_note Boolean true Attiva/disattiva le note

pcm_print Boolean false Stampa p-value nel log

pcp Boolean false Attiva/disattiva il Pairwise Comparisons test sulle percentuali

pcp_sig Float 0.05 Livello di significativita’ t-test

pcp_minbase Integer 0 Numero minimo di casi per eseguire il test

pcp_note Boolean true Attiva/disattiva le note

pcp_print Boolean false Stampa p-value nel log

pcp_yates_correction Boolean false Correzione di Yates

pcp_yates_n Integer 100 Numero di casi totali al di sotto dei quali si applica la correzione di Yates

Ponderazione¶

Parametro Tipo Default Descrizione

rake_varname String "ipf" Nome predefinito variabile di ponderazione

rake_maxit Integer 100 Massimo numero di iterazioni

rake_delta Float 0.01 Scarto massimo ideale/risultato

rake_stop_on_failure Boolean true Comportamento in caso di non convergenza: errore (true), continua con un warning ma genera comunque le variabili di ponderazione (false)

XLSX¶

Parametro Tipo Default Descrizione

xls_percent Symbol :pct100 Formato percentuali: numero senza simboli (:number), formato percentuale base 100 (:pct100), formato percentuale base 0 (:pct0)

xls_round Boolean true Valori arrotondati o con tutti i decimali

xls_zero String "-" Formato per zero

xhp1 String nil Altezza (in punti) prima riga pannello

xhp2 String nil Altezza (in punti) seconda riga pannello

xhnote String nil Altezza (in punti) riga note

xlsx_index Boolean true Genera l’indice

xlsx_index_link Boolean true Genera il link all’indice dopo la tavola nell’output xlsx

xlsx_header String nil Header file xlsx

xlsx_footer String nil Footer file xlsx

xlsx2_sheet1_name String "%" Nome foglio 1

xlsx2_sheet2_name String "VA" Nome foglio 2

xlsx2_sheet1_stats Array [:tcount, :trowpct, :tcolpct, :rowpct, :colpct, :cumpct, :totpct, :mresp, :base, :mean, :sum, :stdev, :i_conc, :cip_l, :cip_u, :cip_e, :cim_l, :cim_u, :cim_e] Statistiche foglio 1

xlsx2_sheet2_stats Array [:tcount, :trowpct, :tcolpct, :count, :nresp, :mresp, :base, :mean] Statistiche foglio 2

xlsx3_sheet1_name String "VA %" Nome foglio 1

xlsx3_sheet2_name String "%" Nome foglio 2

xlsx3_sheet3_name String "VA" Nome foglio 3

xlsx3_sheet1_stats Array [:all] Statistiche foglio 1

xlsx3_sheet2_stats Array [:tcount, :trowpct, :tcolpct, :rowpct, :colpct, :cumpct, :totpct, :mresp, :base, :mean, :sum, :stdev, :i_conc, :cip_l, :cip_u, :cip_e, :cim_l, :cim_u, :cim_e] Statistiche foglio 2

xlsx3_sheet3_stats Array [:tcount, :trowpct, :tcolpct, :count, :nresp, :mresp, :base, :mean] Statistiche foglio 3

xlsx4_sheet1_name String "VA %" Nome foglio 1

xlsx4_sheet2_name String "%" Nome foglio 2

xlsx4_sheet3_name String "VA" Nome foglio 3

xlsx4_sheet4_name String "Sign" Nome foglio 4

xlsx4_sheet1_stats Array [:all] Statistiche foglio 1

xlsx4_sheet2_stats Array [:tcount, :trowpct, :tcolpct, :rowpct, :colpct, :cumpct, :totpct, :mresp, :base, :mean, :sum, :stdev, :i_conc] Statistiche foglio 2

xlsx4_sheet3_stats Array [:tcount, :trowpct, :tcolpct, :count, :nresp, :mresp, :base, :mean] Statistiche foglio 3

xlsx4_sheet4_stats Array [:tcount, :trowpct, :tcolpct, :count, :mresp, :base, :mean, :stdev, :sterr, :i_conc, :pcp, :pcm, :cip_l, :cip_u, :cip_e, :cim_l, :cim_u, :cim_e] Statistiche foglio 4

PDF¶

Parametro Tipo Default Descrizione

wkhtmltopdf String "C:/Program Files/wkhtmltopdf/bin/wkhtmltopdf.exe" Percorso e nome dell’eseguibile wkhtmltopdf

pdf_encoding String "UTF-8" Encoding pagina

pdf_zoom Float 0.9 Zoom pagina

pdf_page_size String "A4" Formato pagina: A4/A3/Letter/Legal...

pdf_landscape Boolean true Orientamento pagina: Landscape (true), Portrait (false)

pdf_gray Boolean false Scala di grigi (true), colori (false)

pdf_footer_positions Array [:img, :footer, :pages] Ordine degli elementi del footer: :img, :footer, :page|:pages

pdf_margins Array ["1cm", "1cm", "1.5cm", "1cm"] Margini: top, right, bottom, left

pdf_section_page Boolean true Titolo della sezione in una pagina separata

pdf_panel_new_page Boolean false Pannelli in pagine diverse (true) o nella stessa pagina (false)

Triple-S¶

Parametro Tipo Default Descrizione

sss_xml_version Float 3.0 Versione Triple-S XML nella generazione dei file

Accentuazioni¶

Parametro Tipo Default Descrizione

phl Boolean false Attiva/disattiva accentuazioni su percentuali colonna o indice di concentrazione

phl_ic Boolean false Calcola accentuazioni in base all’indice di concentrazione e non alle percentuali di colonna

phl_lev Array [10, 20, 30] Vettore con limiti intervalli accentuazioni (max 3)

phl_min Integer 0 Numero minimo di casi nella cella

phl_minus Boolean true Calcola accentuazioni anche su scostamenti negativi

mhl Boolean false Attiva/disattiva accentuazioni medie

mhl_lev Symbol :auto Vettore con limiti intervalli accentuazioni medie (max 3); se :auto utilizza 1/3 sdev, 1/2 sdev, 1 sdev

mhl_min Integer 0 Numero minimo di casi nella cella

mhl_minus Boolean true Calcola accentuazioni medie anche su scostamenti negativi

Autotab¶

Parametro Tipo Default Descrizione

group_delimiter String "_." Separatori nome-progressivo

autotab_max_items Integer 30 Massimo numero di items

autotab_by_val Symbol :sets Tavole orizzontali per: :none, :sets, :all

autotab_scale_summary Boolean false Per le batterie di ord produce anche una tabella riassuntiva di scale true|false

autotab_sng_cat Boolean false Non tabula mai le singole come ordinali true|false

autotab_stat_scale Array [:base, :mean, :stdev, :sum, :min, :max, :median, :mode, :range, :nvals, :miss] Default statistiche per scale

autotab_stat_ord Array [:tcount, :trowpct, :count, :colpct, :base, :mean, :stdev, :miss] Default statistiche per ord

autotab_stat_cat Array [:tcount, :trowpct, :count, :colpct, :miss] Default statistiche per cat

autotab_stat_md Array [:tcount, :trowpct, :count, :colpct, :nresp, :mresp, :miss] Default statistiche per md

autotab_stat_mc Array [:tcount, :trowpct, :count, :colpct, :nresp, :mresp, :miss] Default statistiche per mc

autotab_stat_alpha Array [:tcount, :trowpct, :count, :colpct, :nvals, :min, :max, :mode, :miss] Default statistiche per alpha

autotab_layout Symbol :banner Layout del report: :normal|:banner|:compact|:table|nil

PowerPoint¶

Parametro Tipo Default Descrizione

pptx_server_name String "PowerPoint.Application" Nome del server PowerPoint

pptx_chart_template String "charts_template" Template (potx) per presentazione grafici

Charts¶

Parametro Tipo Default Descrizione

R¶

Parametro Tipo Default Descrizione

r_path String nil Percorso R

r_platform String nil Piattaforma R (:i386|:x64) se specificato anche :r_path

r_library_add_folders String nil Cartelle aggiuntive librerie

r_print Boolean false Stampa le istruzioni R

r_render Symbol :both Dove devono essere indirizzati gli output di R: :log|:report|:both

r_plot_w Integer 800 Ampiezza grafico in px

r_plot_h Integer 600 Altezza grafico in px

r_theme Symbol :gray Tema grafici ggplot

params?¶

params? stampa nell’output l’elenco dei parametri con i relativi valori e la descrizione.

Suggerimento

Per la configurazione delle etichette vedi il paragrafo Etichette standard in Internazionalizzazione.

Formati date e tempo¶

Oltre al parametro frm_datetime che imposta i formati di tempo, data e data+tempo, sono disponibili i metodi frm_t, frm_d e frm_dt per impostare i formati singolarmente.

frm_t accetta inoltre il flag %D per il numero di giorni. Se non presente, i secondi eccedenti le ventiquattro ore verranno conteggiati inle ore

 frm_datetime :t=>"%H:%M:%S", :d=>"%d/%m/%Y", :dt=>"%d/%m/%Y %H:%M:%S"

 frm_d "%d %b %Y"

Layout¶

layout permette di impostare velocemente lo stile di visualizzione del report. Agisce modificando congiuntamente alcuni parametri di configurazione.

Argomenti:

:normal: visualizzazione normale
:banner: visualizzazione con il titolo della tavola inserito nella tabella
:compact: visualizzazione con il titolo della tavola inserito nella tabella, senza i link all’indice e senza pié di pagina
:table: come :compact, ma senza l’indice

Definizione dei formati numerici¶

I formati sono definiti attraverso un hash dove possono essere specificati i seguenti elementi:

:f: formato attivo: :n (numerico), :d (data), :t (tempo), :dt (data/tempo)

:h: carattere di separazione delle migliaia (per nessun separatore usare nil). Se presente, sovrascrive ths_sep

:s carattere di separazione dei decimali (per esempio: ,). Se presente, sovrascrive dec_sep

:p numero di decimali

:d formato data

:t formato tempo

:dt formato data/tempo

Per una statistica possono essere definiti contemporaneamente i formati numerici e quelli di data e tempo. Il parametro :f definisce qual è il formato attivo.

frm_descr imposta contemporaneamente i formati per media, somma, deviazione standard e errore standard della media.

 frm_pct :p => 1
 frm_pct p:1
 frm_count p:0
 frm_mean p:2

 frm_mean t: '%H:%M' # cambia il formato tempo della media
 frm_mean f: :t      # attiva il formato tempo per la media

 frm_descr :f => :d  # attiva il formato data per media, somma,
                     # deviazione standard e errore standard della media

Le sintassi f: :t e :f => :t sono equivalenti. Attenzione, in p: 2 lo spazio è facoltativo (p:2), ma in f: :t è obbligatorio.

Temi¶

I colori e le dimensioni dei caratteri dei report HTML, PDF e Excel sono specificati nel file theme_base.yml. Ulteriori file theme_<nome>.yml (dove nome è il numero o il nome specificato nel parametro di configurazione theme) permettono di modificare anche solo parzialmente i colori. Con l’installazione di pTabs sono inclusi vari temi nella cartella ...\pTabs2\lib\resources (sea, sky, pink e b&w).

Per utilizzare un tema, modificare il parametro theme nel file di configurazione, oppure specificare direttamente nello script:

1	theme :sea

E’ possibile creare dei propri temi creando dei nuovi file, per esempio theme_cliente.yml, e specificando :cliente o "cliente" nel parametro di configurazione theme oppure theme :cliente direttamente nello script.

I nuovi file possono essere collocati o nella cartella di lavoro o nella cartella dell’utente, per es. c:\stat\user2.

Inoltre è possibile modificare i colori direttamente nello script:

color_report_title '#AA00FF'
color_table_alt_bg '#FFFFD4'

config.pth¶

Nella cartella pTabs-user è possibile creare un file di testo nominato config.pth con un percorso per ciascuna riga. Tali percorsi verranno aggiunti ai percorsi di ricerca dei file di configurazione e di risorse.

config.pth può essere utile per definire percorsi di rete in cui inserire file di configurazione e di risorse comuni a un gruppo di lavoro. Per non provocare rallentamenti nell’esecuzione di pTabs, assicurarsi che gli eventuali percorsi di rete inseriti siano velocemente accessibili.

ptabs2.yml¶

Tutti i parametri hanno dei valori di default specificati nel file ptabs2.yml [1].

E’ possibile utilizzare un proprio file ptabs2.yml anche con parametri parziali. Più file di configurazione vengono letti in sequenza dalle seguenti posizioni:

dalla cartella di installazione di pTabs2
dalle cartelle indicate in config.pth
dalla cartella pTabs-user
dalle cartelle genitori della cartella di lavoro
dalla cartella di lavoro

Le configurazioni presenti nei file nelle posizioni più basse della lista precedente hanno il sopravvento.

ptabs_init.pt2¶

All’avvio, pTabs2 carica tutti i file ptabs_init.pt2 che trova nei seguenti percorsi e in questo ordine:

dalla cartella di installazione di pTabs2
dalle cartelle indicate in config.pth
dalla cartella pTabs-user
dalle cartelle genitori della cartella di lavoro
dalla cartella di lavoro

Il file può contenere qualsiasi istruzione valida pTabs2 che verrà eseguita prima di qualsiasi istruzione presente dello script. Il percorso di lavoro è lo stesso dello script anche se il file ptabs_init.pt2 si trova altrove.

Tutti i file ptabs_init.pt2 trovati vengono eseguiti, quindi è necessario considerare l’eventuale sovrapporsi delle istruzioni contenute nei diversi file.

Il file può essere utile, per esempio, per:

inserire le proprie configurazioni invece di utilizzare un file ptabs2.yml personale

inserire le configurazioni comuni di un progetto

definire dati e funzioni di uso comune

Note

[1]	Il file è in formato YAML.