La Scaletta è l'elenco dei canti per una Celebrazione liturgica
- indica quale canto eseguire per ogni momento liturgico
- permette di visualizzarne lo spartito e/o il testo del canto
- viene riportata nel Calendario liturgico nella data della Celebrazione
- tutti i visitatori del sito cantoeprego.it la possono vedere.
- può raccogliere i canti:
• di una singola Celebrazione (es.: Messa domenicale)
• di un periodo dell'Anno liturgico (es.: Tempo di Avvento e Natale)
• tutti i canti che costituiscono Il Libro dei canti della Parrocchia.
(leggi Libro parrocchiale ☛).
Descrizione tecnica
Ogni Scaletta è memorizzata in due Tabelle separate, anche se correlate tra loro:
• scalette - contiene informazioni di carattere generale per la Scaletta stessa, tra le altre:
- codice, nome e cognome del proprietario
- data della Celebrazione e dicitura di collegamento che appare nel Calendario liturgico
- informazioni relative all'eventuale Libro (formato della carta, Indice, Copertina)
- contenuto della Copertina
• scalette_canti - contiene informazioni relative ai canti:
- momento liturgico
- numero del canto o Titolo, se non presente in CeP
- pagina del Libretto parrocchiale, se si vuole farci riferimento
- eventuali note per l'esecuzione
- eventuale file immagine del canto non CeP
Anche per gli utenti registrati sono usate due Tabelle:
• amici - con le informazioni fornite al momento della Registrazione
• amici_scaletta - con le informazioni relative alle Scalette
- contiene indicativamente le stesse informazioni della Tabella "scalette", ma:
. le informazioni di "scalette" sono relative ad una specifica Scaletta
. le informazioni di "amici_scaletta" sono utilizzate come base proposta
al momento della creazione di una nuova Scaletta.
Nascono in modo automatico con valori generici, senza che l'utente intervenga.
L'utente può modificarle in un secondo momento.
Libro dei canti
Il Libro dei canti è la stampa dei canti di una Scaletta
- la stampa viene organizzata in:
• Copertina,
• Indice
• Spartiti e/o testo dei canti indicati in una Scaletta.
- può essere stampato:
• su carta
• su file PDF,
- può raccogliere i canti:
• di una singola Celebrazione (es.: Messa domenicale)
• di un periodo dell'Anno liturgico (es.: Tempo di Avvento e Natale)
• tutti i canti che costituiscono Il Libro dei canti della Parrocchia
(leggi Libro parrocchiale ☛).
Utilizzo delle Scalette
Dove sono
Le Scalette create dagli utenti
>
> 2 LITURGIA
>
- ogni giorno riporta, nell'ultima colonna a destra, il riferimento ad ogni scaletta creata: numero della scaletta e dicitura identificativa.
- Facendo clic su numero e/o dicitura, viene presentata la pagina con l'elenco dei titoli dei canti.
- è possibile scorrere il Calendario: mese precedente / mese successivo
- dalla visione è possibile richiede:
• stampare la scaletta
• creare un Libro
oppure andare a Calendario od a Altro
Le Scalette predisposte da Cantoeprego
Cantoeprego ha preparato una serie di Scalette che indicano i canti più usati: ad es. per i Defunti
Facendo clic sul titolo dei una Scaletta, questa viene visualizzata.
Vedere la Scaletta
(Vedere una Scaletta, significa vedere l'Elenco dei canti per una Celebrazione).
per ogni canto vengono riportati i seguenti campi:
#
numero progressivo del canto
momento
momento della Liturgia
canto
Titolo del canto
pag
nn :: pagina del Libro parrocchiale [21] :: pagina di Cantoeprego con il solo testo
num
numero del canto in CeP
nota
foto
tipo
Cosa fare con la Scaletta
Quindi una Scaletta viene visualizzata:
- o dal Calendario
- o dall'Elenco delle Scalette di Cantoeprego vedere la Scaletta:
Creazione di una Scaletta
Questa funzione servata agli utenti registrati.
Per creare la scaletta seguire il percorso:
>
> 4 Altro
>
>
> cantoeprego.it > 4 Altro
> nuova scaletta
indicare i canti, seguendo le istruzioni:
Ogni canto viene indicato da: momento e descrizione, secondo queste forme:
mmm nnnn.fp [descrizione] oppure mmm titolo
• canti presenti in CeP (preferibilmente): per inserirli dovrà essere indicato il Momento della Celebrazione ed il numero del canto (es: ing 0001, off 0002)
• canti non presenti in CeP: per inserirli dovrà essere indicato il Momento, il Titolo ed eventualmente l'immagine dello sparito o testo corrispondente
In entrambi i casi è possibile indicare anche:
- una annotazione (ad es.: cantare solo la 2. strofa)
- il numero del canto riportato nel Libretto parrocchiale, usato da:
. chi lo annuncia all'Assemblea per chi non segue la Scaletta
. chi segue la Scaletta, ma vuole avere il riferimento al Libretto parrocchiale.
• nuova scaletta
per creare una scaletta nuova
prima prepara l'elenco dei canti che vuoi inserire e per ciascuno segna il numero che lo identifica in CeP
(il numero, che ha la forma: nnnn.fp, lo trovi a fianco al Titolo quando vedi una pagina con il canto oppure dopo il Titolo in ogni elenco dei canti)
mmm
sigla del momento (quelle utilizzate da cantoeprego in 'indice tema')
deve essere indicata secondo la tabella a sinistra (non ha importanza se indicata in maiuscolo e/o minuscolo)
questa codifica è soltanto per dare uniformità alla dicitura e risparmiare spazio negli archivi
l'uso delle sigle non determina l'ordine dei canti, che vengono messi in ordine di inserimento.
nnnn.fp
numero del canto di cantoeprego
se indicato in questa forma, il canto verrà collegato al proprio spartito in cep
descrizione = (facoltativo) eventuali annotazioni sull'esecuzione del canto o altro
Gestione di Scalette esistenti
Funzione riservata agli utenti registrati: naturalmente ogni utente può vedere e gestire soltanto le proprie scalette.
- viene presentato l'elenco di tutte le sue scalette
Una volta che una Scaletta è stata creata, la puoi trovare tra le scalette esistenti e da qui può:
- essere stampata come elenco dei canti
- essere stampata come Libro dei canti in formato A4, con Copertina ed Indice.
- essere modificata, cancellata, ...
- per modificare una scaletta (oppure cancellarla, duplicarla o vedere la scaletta completa)
modificare una scaletta
Per modificare la scaletta: seguire il percorso: > www.cantoeprego.it > Altro > scaletta > scalette esistenti
• i valori predefiniti
Alcune informazioni: relative alla Scalette (numero di righe per l'introduzione dei canti, dicitura da inserire nel Calendario, Copertina ...) sono state assunte alla registrazione di ogni utente.
Sono usate soltanto per le nuove Scalette. Questa funzione permette di vederli e modificarli.
• scalette di CeP
- presenta l'elenco delle scalette create da Cantoeprego (Messa dei Defunti, Ordinario della Messa: Santo ...)
Libro parrocchiale
Intro
• Con il termine Libro parrocchiale intendiamo un libro contenente più di 30 canti,
per il quale la preparazione manuale della Scaletta risulta poco agevole.
• (tendenzialmente) avrà un numero da 1-100)
• La preparazione della Scaletta deve seguire questa procedura:
Utente
- chiede alla Redazione l'assegnazione di un numero di Scaletta che dovrà essere usato come valore di xx, in questa procedura
- prepara un Foglio di Calcolo .xlsx oppure .ods
- lo invia alla Redazione
Redazione
. con LibreOffice Calc legge il file .xlsx
. lo controlla e modifica
. lo salva come file libro.sxx.input.csv
. il programma libro.vedere.csv.php lo visualizza
. il programma libro.da.csv.a.scaletta.php crea la scaletta (prima di usarlo, modificare i valori interni al programma)
. il programma libro.da.scaletta.a.csv.php crea il file libro.sxx.output.csv, che invia all'utente
il Foglio di Calcolo
Si ricorda che possono essere indicati:
canti presenti in CeP (cep) e canti non presenti in cep (non)
Il Foglio di Calcolo avrà una prima riga con il titolo delle colonne: | pag | num | titolo | foto | alias |
e a seguire una riga per ogni canto, che conterrà:
se cep:
pag = numero progressivo dei canti 1 ... n
num = numero del canto di CeP
titolo = non viene usato; serve soltanto per indicare il canto a che sta preparando l'elenco
se non:
pag = numero progressivo dei canti 1 ... n
titolo = Titolo del canto
foto = indica il file che contiene l'immagine .png/.jpg od il testo .txt (leggi: Nome dei file ☛ ) in questa forma:
sxx.nn.nome-del-file.png
xx = numero della scaletta assegnato
nn = numero pag corrispondente
alias = altro titolo che verrà messo a fianco del titolo
libro.sxx.input.cvs = derivato da Foglio di Calcolo
libro.vedere.csv.php = prg - visualizza in chiaro il file libro.elenco.cvs
libro.da.csv.a.scaletta.php = prg - crea la Scaletta leggendo file libro.elenco.cvs
libro.da.scaletta.a.csv.php = prg - crea libro.output.cvs leggendo la Scaletta
Funzioni di prossimo sviluppo
Per il proprietario
• Modificare la Tabella scalette_canti (l'elenco dei canti di una Scaletta)
• Modificare la Tabella scalette (gli aspetti general di una Scaletta)
• Modificare la Tabella amici_scaletta (gli aspetti generali per le nuove scalette).
Viene presentato l'elenco di tutte le scalette inserite, in ordine decrescente di numero (prima le più recenti).
Sono visibili solo alcuni elementi atti ad identificare ogni scaletta, per ciascuna puoi:
• clic su per vedere la scaletta completa di tutte le informazioni
• clic su per modificarla
• clic su per cancellarla
• clic su per duplicarla
Anziché scrivere completamente una nuova scaletta, è possibile utilizzare una scaletta già pubblicata:
• duplicare una scaletta esistente - verrà creata una nuova (con altro numero, ma con le stesse informazioni)
• modificare la nuova scaletta.
-->
Scaletta e Libro dei canti
Scaletta dei canti e Libro dei canti sono trattati come unico argomento, in quanto strettamente connessi:
• una Scaletta può essere stampata:
- (oltre che come "Elenco" dei momenti liturgici e Titolo del canto corrispondente)
- anche come: "Libro" con lo spartito dei canti
• viceversa, per creare un Libro dei canti è necessario indicare i canti in una Scaletta.
Nomi dei file da inviare a CeP
Nel preparare una Scaletta od un Libro parrocchiale se in canto non è presente in CeP, si deve indicare il file che contiene o l'immagine dello Spartito od il Testo del canto.
I nomi dei files hanno due scopi:
- renderli individui: non possono esistere due files con lo stesso nome (nella stessa cartella)
- indicarne il contenuto (preferibilmente)
Per ragione di compatibilità tra i vari Sistemi operativi (CeP usa Linux, tu forse Windows ... ) i nomi dei files devono seguire questi criteri:
• composto da parole di sole lettere e minuscole
• non può contenere: apice singolo, apice doppio, apostrofo, lettere accentate, virgolette ...
• le parole possono essere separate da . (punto)
• pertanto non è necessario che siano lunghissimi.
NOTA: se si intende anche stampare il Libro dei canti da una Scaletta, non indicare un file pdf come contente l'immagine dello spartito,che non potrà essere incluso nella stampa.
Eventualmente traformare il pdf in un file .png o jpg.
>
> 
Una volta che una Scaletta è stata creata, la puoi trovare tra le scalette esistenti e da qui può:
- essere stampata come elenco dei canti
- essere stampata come Libro dei canti in formato A4, con Copertina ed Indice.
- essere modificata, cancellata, ...
- per modificare una scaletta (oppure cancellarla, duplicarla o vedere la scaletta completa)
per cancellarla 
per duplicarla