Manuale ☛   Cap prec ☛

Manuale di cantoeprego

7. Documentazione

Questo capitolo, nella documentazione di cantoeprego, risponde alle domande:
  • da cosa è fatto (Componenti)?
  • cosa bisogna fare come preparazione al funzionamento (Preparazione)?
pertanto è indirizzato alla Redazione di CeP.

Si sviluppa nei seguenti paragrafi:
  • tutti gli argomenti - in ordine alfabetico (leggi ☛)
  • alcuni aspetti specifici - (leggi ☛)
  • le Strutture fisiche: - cartelle, tabelle (leggi ☛)
  • i Criteri - espone i criteri usati nel Manuale (leggi ☛)

Argomenti

  Aiuto -   Amici -   Canti -   Canzoni -   Home page -   Musica -   Novità -   Poesie -   Scaletta -   Comunicare

Ogni argomento ha una breve descrizione e rimanda al proprio elenco files e programmi, ed alle tabelle.
Per vedere i tre aspetti in successione e svincolati dagli argomenti: Descrizione - Files e programmi - Tabelle

Descrizione

Aiuto
 scopo: manuale di CeP, per utente e per Redazione
 cartella: /aiuto
 programmi e files:  leggi ☛ 
 tabella DB: -
 percorso uso:  > Aiuto 
 descrizione in manuale:  leggi ☛ 
Amici
 scopo: gestione Amici di CeP
 cartella: /oppure
 programmi e files:  leggi ☛ 
 tabella DB: cant_amici    vedi ☛
 percorso uso:  > altro > amici
 descrizione in manuale:  leggi ☛ 
 
Canti
 scopo: canti
    cartella: /canto
    programmi e files:  leggi ☛ 
    tabella DB: canti_titoli    vedi ☛
    tabella DB: canti_informazioni    vedi ☛
    percorso uso:  > Canti 
    descrizione in manuale:  leggi ☛ 
     
Canzoni
 scopo: canzoni
 cartella: /canzoni
 programmi e files:  leggi ☛ 
    tabella DB: cant_canzoni    vedi ☛
    percorso uso:  > altro > parte privata > canzoni
    descrizione in manuale:  leggi ☛   
Comunicare
    cartella: oppure
 programmi e files:  leggi ☛ 
    tabella DB: cant_segnalare    vedi ☛
    percorso uso:  > altro > comunicare 
    descrizione in manuale:  leggi ☛   
Home page
 scopo: home page di CeP
 cartella: /sito.cantoeprego || www.cantoeprego.it
 programmi e files:  leggi ☛ 
 tabella DB: -
 percorso uso:  > Aiuto 
 descrizione in manuale:  leggi ☛ 
Musica
   cartella: musica/
   percorso uso:  > cantoeprego.it > musica  vai ⇨ 
   descrizione in manuale:  leggi ☛    

  imparare la musica ☛ -   creare gli spartiti ☛ -   la musica in CeP ☛ -   sottocartelle

Novità
 scopo: novità in home page
 cartella: /programmi
 programmi e files:  leggi ☛ 
 tabella DB: cant_tab_novita  vedi ☛
 percorso uso:  > www.cantoeprego.it
 descrizione in manuale:  descrizione in manuale:  leggi ☛ 
Poesie
    cartella: oppure
 programmi e files:  leggi ☛ 
    tabella DB: tab_poesie    vedi ☛
    percorso uso:  > altro > parte privata > poesie
    descrizione in manuale:  leggi ☛   
Scaletta
 cartella: /oppure
 programmi e files:  leggi ☛ 
    tabella DB: cant_scaletta    vedi ☛
    percorso gestione:  > altro > scaletta
    percorso uso:  > liturgia > calendario > clic su scaletta nel giorno

    descrizione in manuale:  leggi ☛  

Programmi

• Viene presentato l'elenco dei programmi (eventualmente suddivisi) ed alcuni file collegati.
Home page
index.php
home.config.php
home.select.php
home.intestazione.php
programmi/canti.elenco.liturgia.php
programmi/canti.vedo.php
home.intestazione.php
home.footer.php
Aiuto
0.coper.htm
1.intro.htm
2.canti.htm
3.litur.htm
4.music.htm
5.altro.htm
6.appen.htm
7.docum.htm
css.css
w3.css
ico. ... tutte le icone
00.admin.htm pannello verso Provider + poche altre cose
Amici
cant.oppure.amici.home.php - Home page
cant.oppure.amici.elenco.php - elenco degli amici in ordine di numero/cognome/nome
cant.oppure.amici.ricerca.php - cerca parola in cognome/nome/città/provincia/nickname/attività
cant.oppure.amici.nickname.php - elenca Amici per numero con nickname e data iscrizione
cant.oppure.amici.cercare.admin.php
cant.oppure.amici.compleanni.php
cant.oppure.amici.controllo.admin.php
geografia
cant.oppure.amici.nazioni.elenco.php
cant.oppure.amici.nazioni.mappa.php
cant.oppure.amici.regioni.elenco.php
cant.oppure.amici.regioni.mappa.php
cant.oppure.amici.citta.elenco.php
cant.oppure.amici.citta.mappa.php
statistiche
cant.oppure.amici.attivita.php
cant.oppure.amici.eta.php
cant.oppure.amici.stat.province.php
cant.oppure.amici.stat.sesso.php
per la Redazione
cant.oppure.amici.admin.php
Canti
canti.elenco.liturgia.php
canti.elenco.gregoriano.php
canti.elenco.repertorio.php
canti.elenco.semplici.php
canti.elenco.tag.php
canti.elenco.tutti.php
Ricerca
canti.ricerca.alfabeto.php
canti.ricerca.momento.php
canti.ricerca.parola.php
canti.ricerca.tag.php
canti.ricerca.titolo.php
canti.ricerca.toni.e.tempi.php
canti.vedo.php
Canzoni
cant.oppure.canzoni.elenco.php
cant.oppure.canzoni.ricerca.php
cant.oppure.canzoni.vedo.php
Musica
I files segnati con asterisco , devono essere
compilati perché contengono frammenti di musica:
• da terminale dare questi comandi: cd sito.cantoeprego/musica lilypond-book -outd -o ut <nome-file>.html • trasferire sul web: il sorgente <nome-file.html> i files generati nelle cartella: /out
   tenere presente questa tabella per i nome dei files:
   musi.1.  teoria
   musi.2.  leggere
   musi.3.  suonare
   musi.4.  accompagnare
   musi.5.  gregoriano
   musi.15.  Lilypond
   musi.16.  Frescobaldi
   musi.17.  Lilypond-book
   musi.18.  Gimp
   musi.19.  Gregorio
   musi.20. (canti) (canzoni) (frammenti)?
   
musi.0.home.htm - vedi ☛
musi.0.glossario.html
imparare la musica musi.1.note.html
musi.1.scrivere.html
musi.1.forma.html vedere dove inserirlo il suono musi.1.suono.html
la melodia musi.1.home.htm - menu - vedi ☛
l'armonia
il gregoriano
leggere musi.2.home.htm - menu - vedi ☛
musi.2.moderno.html
suonare musi.3.home.htm - menu - vedi ☛
musi.3.ese.1.html
musi.3.ese.2.html
musi.3.ese.3.html
4 accompagnare musi.4.home.htm - menu - vedi ☛
musi.4.teoria.html
musi.4.come-fare.html
musi.4.manuale.3.html
musi.4.manuale.4.html
musi.4.glossario.html vedere ?

tonalità
   24.10.2022
   nuovo programma: musi.creo.tonalità.php
   • viene lanciato da: > Manuale di base > Pannello gestione > crea segmenti musica per tonalità ⇒
   - crea i frammenti usati da: musi.21.tonalita.php
   - creare la shell musi.21.tonalita.sh (comandi per eseguire Lilypond e compilare tutti frammenti)
   • si esegue da Terminale: ./musi.21.tonalita.sh - dare invio
   
   • correggere musi.creo.tonalità.php
   • ftp => frammenti: musi.creo.tonalità.php
   • lanciare da: > Manuale di base > Pannello gestione > crea segmenti musica per tonalità ⇒
   • ftp <= frammenti: musi.21.tonalita.sh, fra.mag.do.ly ... (tutta: \frammenti)
   • da Terminale:
      cd sito.cantoeprego/musica/frammenti
      ./musi.21.tonalita.sh
   (se errore: Permesso negato  :: sudo chmod 777 musi.21.tonalita.sh
   • con Gimp: convertire tutti .pdf ed esportare come .png
   • ftp => frammenti: ...png
   
musi.21.creo.tonalità
5 gregoriano musi.5.home.htm - menu - vedi ☛
programmi per scrivere la musica
15 lilypond musi.15.lilypond.html
16 frescobaldi musi.16.frescobaldi.htm
17 lilypond musi.17.lily-book.html
18 gimp musi.18.gimp.htm
19 gregorio musi.19.gregorio.htm
20 creare lo spartito
musi.20.home.htm
21 la musica in CeP
musi.21.home.htm ? musi.21.canti.forma.htm ? musi.21.canzoni.htm ? musi.21.metronomo.htm elenchi programmi/musi.21.semplici.php
programmi/musi.21.link.php
programmi/musi.21.tag.php
programmi/musi.21.pagine.php
tonalità programmi/musi.21.toni.stat.php
programmi/musi.21.toni.cerca.php
programmi/musi.21.toni.sapere.php strumenti musi.23.frammenti.htm
sottocartelle
/frammenti contiene sorgenti ly ed immagini .png per immagini fisse che possono essere incluse nei vari manuali.
In particolare il programma musi.21.toni.sapere.php usa questa famiglia: arm.00.mag.tt.png
con i significati: /ut di transito: contiene l'uscita dell'ultima compilazione lilypond /out output dei sorgenti .html compilati (vengono lanciati da qui)
da sistemare
css.css
cant.greg.a.ly.php
cant.musica.accompagno.accordi.html
cant.musica.accompagno.home.php
cant.musica.accompagno.intro.html
cant.musica.appunti.accordi.html
cant.musica.appunti.accordi.pdf
cant.musica.glossario.html
cant.musica.home.php
cant.musica.iostrumenti.metronomo.htm
cant.musica.ricerca.tonalita (copia).php
cant.musica.ricerca.tonalita.php
cant.musica.test.html
cant.musi.creo.10.gregorio.htm
cant.musi.creo.2.descrizione.htm
cant.musi.creo.4.gregoriano.htm
cant.musi.creo.5.canzoni.htm
cant.musi.creo.6.frammenti.htm
cant.musi.creo.css
cant.musi.creo.home.php
cant.musi.css
cant.musi.suonare.html
cant.musi.teoria.tutta.html
Novità
cant.novita.php
cant.novita.tutti.php
Poesie
poesie.elenco.php
poesie.vedo.php
Scaletta  
cant.oppure.scaletta.admin.php
cant.oppure.scaletta.creare.chiedo.php
cant.oppure.scaletta.creare.eseguo.php
cant.oppure.scaletta.elenco.php - gestione singolo elemento
cant.oppure.scaletta.home.php
cant.oppure.scaletta.vedere.php
Comunicare
cant.oppure.comunicare.home.php
cant.oppure.comunicare.admin.php
cant.oppure.comunicare.nuovo.php
cant.oppure.comunicare.errore.php
cant.oppure.segnalare.accordi.php
cant.oppure.segnalare.varie.php

Tabelle

  Amici -   Canzoni -   Chiese -   Scaletta -   Comunicare -   Autori -   Novità   canti_titoli   canti_informazioni   Autori -   Momento -   Poesie
cant_amici
nome         varchar  120
cognome      varchar  120
amici_num_id int      11
amici_nick   varchar  160
amici_link   varchar  200
amici_titolo varchar  320
citta        varchar  120
prov         varchar  120
amici_regi_cod char    20
amici_regi_nom varchar 100
amici_regi_ord char    8
amici_nazi_cod char    12
amici_nazi_nom varchar 160
data_n         date    10
apprezzo       varchar 16384
nota           varchar 16384
d              12      19
email          varchar 120
telefono       varchar 120
pub            varchar 20
amici_foto     varchar 240
accetto        varchar 40
sex            varchar 16384
seguo          varchar 40
amici_valido   char    4
amici_pwd
   
cant_canzoni
numero   char  16
bis      char  8
titolo   varchar 240
area     varchar 120
ter      varchar 80
tag      varchar 320
nome_file     varchar 240
sw_autore     char    4
autore_musica varchar 480
autore_testo  varchar 480
anno          varchar 48
testo         text    262140
cip           int     11
nota          varchar 4800
nota_int      varchar 240
data_ins      date  10
d             timestamp 19 
cant_chiese
chiese_nip     int   11
chiese_luogo   varchar  240
chiese_nome    varchar  240
chiese_foto_1  varchar  320
chiese_foto_2  varchar  320
chiese_foto_3  varchar  320
chiese_foto_4  varchar  320
chiese_foto_5  varchar  320
chiese_desc_1  varchar  320
chiese_desc_2  varchar  320
chiese_desc_3  varchar  320
chiese_desc_4  varchar  320
chiese_desc_5  varchar  320
chiese_auter_nome    varchar  120
chiese_auter_cognome varchar  120
chiese_d 12 19
chiese_descriz
cant_proposte
cant_prop_num_id  int   11
cant_prop_amico   int   4
cant_prop_data date  10
cant_prop_cognome varchar  120
cant_prop_nome    varchar  120
cant_prop_link    varchar  200
cant_prop_titolo_1  varchar  240
cant_prop_titolo_2  varchar  240
m_1   char  12
c_1   varchar  320
m_2   char  12
c_2   varchar  320
m_3   char  12
c_3   varchar  320
m_4   char  12
c_4   varchar  320
m_5   char  12
c_5   varchar  320
m_6   char  12
c_6   varchar  320
m_7   char  12
c_7   varchar  320
m_8   char  12
c_8   varchar  320
m_9   char  12
c_9   varchar  320
m_10  char  12
c_10  varchar  320

m_11  char  12
c_11  varchar  320
m_12  char  12
c_12  varchar  320
m_13  char  12
c_13  varchar  320
m_14  char  12
c_14  varchar  320
m_15  char  12
c_15  varchar  320
m_16  char  12
c_16  varchar  320
m_17  char  12
c_17  varchar  320
m_18  char  12
c_18  varchar  320
m_19  char  12
c_19  varchar  320
m_20  char  12
c_20  varchar  320

m_21  char  12
c_21  varchar  320
m_22  char  12
c_22  varchar  320
m_23  char  12
c_23  varchar  320
m_24  char  12
c_24  varchar  320
m_25  char  12
c_25  varchar  320
m_26  char  12
c_26  varchar  320
m_27  char  12
c_27  varchar  320
m_28  char  12
c_28  varchar  320
m_29  char  12
c_29  varchar  320
m_30  char  12
c_30  varchar  320

m_31  char  12
c_31  varchar  320
m_32  char  12
c_32  varchar  320
m_33  char  12
c_33  varchar  320
m_34  char  12
c_34  varchar  320
m_35  char  12
c_35  varchar  320
m_36  char  12
c_36  varchar  320
m_37  char  12
c_37  varchar  320
m_38  char  12
c_38  varchar  320
m_39  char  12
c_39  varchar  320
m_40  char  12
c_40  varchar  320

m_41  char  12
c_41  varchar  320
m_42  char  12
c_42  varchar  320
m_43  char  12
c_43  varchar  320
m_44  char  12
c_44  varchar  320
m_45  char  12
c_45  varchar  320
m_46  char  12
c_46  varchar  320
m_47  char  12
c_47  varchar  320
m_48  char  12
c_48  varchar  320
m_49  char  12
c_49  varchar  320
m_50  char  12
c_50  varchar  320
d     12    19
cant_segnalare

cant_segn_nip  int      11
cant_segn_tipo          char  28
cant_segn_titolo        varchar  200
cant_segn_foto_spartito varchar  320
cant_segn_foto_audio    varchar  320
cant_segn_foto_sorgente varchar  320
cant_segn_valido      char  4
cant_segn_curatore    varchar  120
cant_segn_esito       varchar  240
cant_segn_segnalatore varchar  120
cant_segn_autore      varchar  320
cant_segn_descrizione varchar  16384
cant_segn_data       12 19
cant_segn_data_ins   12 19
cant_segn_canto char  28
cant_segn_nota  varchar  16384 
cant_tab_autori
id        int      11
area      varchar  120
cognome   varchar  120
nome      varchar  120
noto_come varchar  120
nato_a    varchar  240
nato_il   date     10
morto_a   varchar  240
morto_il  date     10
note      varchar  12000
sex       char     12
vivente   char     44
qualifica varchar  120
nascosto
cant_tab_novita
nov_valido  char  4
nov_id   int   11
nov_tipo char  72
nov_data 12 19
nov_titolo  varchar  1000
nov_messaggio
canti_titoli
num      varchar  16
titolo   varchar  240
id       int      11
d        timestamp 19
classe   char      4
tipo     varchar   16
nascosto varchar   40
chiave_ordinario  var char 30
cant_tito_note varchar  1000
data_ins       datetime
classe
c = canti per la Liturgia
g = canti in gregoriano
r = canti a carattere religioso, ma non per la Liturgia
tipo
tito = Titolo del canto
capo = alias del Titolo (altro nome o parole ritornello ...)
link = non è un canto, ma il titolo di un momento dell'Ordinario
nascosto
nascosto = non viene mostrato nell'elenco, ma solo se richiesto il link
chiave_ordinario
verranno mostrati i canti che hanno questa chiave, e non in base al Titolo
al momento Agnus Dei potranno essere associati: Agnus, Agnus Dei, Agnello di Dio ...
canti_informazioni
num       char  16
sottonumero char 8
melodia   char  4
penta     char  12
accordi   char  20
mp3       char  4
pagine    char  4
forme     char  4
nome_file varchar  240
tempo     varchar  20
chiave    varchar  20
momento   varchar  160
testo     text  262140
testo2    text  262140
cant_info_note    varchar  1000
cant_info_inter   varchar  1000
autori   varchar  1000
origine  varchar  1000
id       int      11
d
geografia
nazi_cod char     12
nazi_nom varchar  160
regi_cod char     20
regi_nom varchar  160
regi_ord char     8
prov_cod char     8
prov_nom varchar  160
nip   int   11 
momento
id        int   5
num       2  4
codice    char  12
titolo    varchar  200
sw_minimo char  4
tipo
tab_poesie
titolo   varchar  240
anno     char     20
numero   char     16
autore   varchar  120
area     varchar  120
lettera  char     4
pip      int      11
poesia   text     262140
nato_il  varchar  48
nato_a   varchar  200
morto_il varchar  48
morto_a  varchar  200
nota     varchar  19200
d        timestamp   19 

Aspetti specifici

Canti dell'Ordinario

(Questo aspetto è valido soltanto per l'Elenco dei canti per la Liturgia, non per l'Elenco di tutti i canti). vedi ☞ Ordinarium canti dell'Ordinario
   Kyrie
   Gloria
   Credo
   Sanctus
   Agnus Dei
   (Salmo)
   (Alleluia)
   (Pater noster)    
I canti dell'Ordinario sono molto numerosi, quindi per non avere in elenco (al 24.11.2022) 22 Alleluia, 50 Salmi, 30 Santo ... viene riportato il Titolo dell'Ordinario

Libro dei canti

programmi /
libro.home.php               pagina iniziale
libro.carat.impos.php        imposta le caratteristiche  (ex /libro_imp_car.a.php car.b )
libro.carat.vedo.php         mostra le caratteristiche   (ex /libro_ved_car.php)
libro.carat.modif.php        modifica le caratteristiche   (ex /libro_mod_car.a.php car.b)
libro.coper.modif.php        modifica la copertina   (ex /libro_mod_cop.a.php cop.)
libro.canti.modif.elen.php   modifica elenco con lista    (ex /libro_home.page.inc)
libro.canti.modif.a.mano.php modifica elenco con copy   (ex /libro_home.page.inc)
libro.stampa.tutto.php       stampa libro formato A4   (ex /libro_sta.t.php)
libro_elencocanti.xml

Home vai ⇨

Strutture fisiche

  Cartelle -   Database e Tabelle -

cartelle

Cep ha le proprie informazioni (programmi e dati) distribuite in queste cartelle:

aiuto
bibbia
calendario
cant.lily
canto
canzoni
concilio
gregoriano
impariamo
liturgia
musica
oppure
programmi
salmi

Database

CeP ha un unico Database:   par37266_cantoeprego, che contiene queste Tabelle:
bibliografia - (non più usata)
cant_amici ☛
cant_canzoni ☛
cant_chiese ☛
cant_proposte ☛
cant_segnalare ☛
cant_tab_autori ☛
cant_tab_novita ☛
canti_informazioni ☛
canti_titoli ☛
geografia ☛ - (ancora non usata)
momento ☛
tab_poesie ☛
tab_salmi ☛

Criteri

Indica i criteri utilizzati sia nel Manuale che nel sito:
Simboli e colori ☛ - Link ☛ - Visione logica ☛

Simboli e colori

Questi sono i simboli usati all'interno di questo Manuale
simbolo descrizione Entity Dec Code Unicode da tastiera
leggi in questo manuale &#9755;
vedi definizione in Appendice &#9758;
vai al sito cantoeprego.it &#8680;
leggi documentazione per la Redazione &rBarr; &#10511; U+290F
nei menu: vai &rArr;&#8658;
< minore &lt; &#60;
> maggiore &gt; &#62;
punto nero &bull;&#8226;
@ chiocciola - &#64;
" apici &quot;&#34
  spazio &nbsp;&#160;
& e commerc&amp; &#38;
# cancelletto - &#35;
bemolle (flat) &flat; &#9837; U+266DCtrl+Shift+ U266d
diesis (sharp) &sharp; &#9839; U+266F Ctrl+Shift+U266f

Questi sono i colori usati all'interno di questo Manuale
manuale   h1 manw3-light-greyF1F1F1center
capitolo   h2 capw3-dark-grey616161center
         
paragrafo   h3 parw3-grey 9E9E9Ecenter
sottopar   h4 sotw3-orangeFF9800center
bis     h5 bisw3-amber FFC107 -
         
ter     h6 terw3-yellowFFEB3B -
qua     h7 quaw3-khaki F0E68C -
qui     h8 quiw3-sand FDF5E6 -
over     - w3-limeCDDC39  


I link sono i collegamenti ad altre pagine che permettono la navigazione ipertestuale del web.

Usiamo queste forme per indicare la navigazione:
> link > link > link (significa: vai a ... poi vai a ... poi vai a ...)
    link può essere il nome di un sito, una voce di menu, una parola evidenziata, se cliccato collega con un'altra informazione

: significa vai a leggere (all'interno di questo Manuale)
: significa vai a consultare l'Appendice
: significa vai al sito www.cantoeprego.it (per vedere oppure eseguire)

espande testo su richiesta
Titolo cliccabile Descrizione espansa
      <details>
      <summary>Titolo cliccabile</summary>
      Descrizione espansa
      </details>
      
3 bottoni
Permette la visione di una classe o l'altra (o entrambe).
es.: Glossario di Appendice - leggi ☛
pannello sulla pagine
Apre un pannelino autonomo sulla pagina in visione.
es.: clic su info quando sono in visione di un canto - vai ⇨

Visione logica

Ogni sezione o argomento deve avere sviluppati questi paragrafi:
Descrizione - (cosa è )
Uso - (come si adopera)
Componenti - (da cosa è fatto)
Preparazione - (come si   Poesie - prepara)

  Manuale ☛   Cap prec ☛