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.
E' composto da questi paragrafi:
• i Criteri: espone i criteri usati nel Manuale ( vai ☛ )
• le Strutture fisiche: (cartelle, tabelle) ( vai ☛ )
• gli Argomenti: tutta la documentazione in ordine di argomento ( vai ☛ )

Criteri

Indica i criteri utilizzati sia nel Manuale che nel sito:
Colori ☛ - Link ☛ - Visione logica ☛

Colori

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  


simbolo descrizione Decimal Code Hex Code
vedi in questo manuale ☛ ☛
vedi definizione in Appendice ☞ ☞
vai al sito cantoeprego.it ⇨ ⇨

altri caratteri
simbolo descrizione Entity Decimal Hex
< minore &lt; &#60;
> maggiore &gt; &#62;
punto nero &bull;&#8226;
@ chiocciola - &#64;
freccia &rArr;&#8658;
" apici &quot;&"8658;
  spazio &nbsp;&#160;
& e commerc&amp; &#38;
# diesis - &#35;
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 - vai ☛
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)

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 tutte le 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 ☛

Argomenti

Ogni argomento è naturalmente composto da una logica (programma) che agisce sulle informazioni (file o tabelle).
Qui sono elencati separatamente:

  I Programmi -   Le Tabelle

Programmi

• Viene presentato l'elenco dei programmi (eventualmente suddivisi) ed alcuni file collegati.
• Ogni elenco è preceduto da uno specchietto che rimanda ai punti fondamentali di ogni argomento.

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

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
contiene i file che costituiscono il Manuale CeP:
La cartella: 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
    cartella: oppure
    tabella DB: cant_amici    vedi ☛
    percorso uso:  > altro > amici
    descrizione in manuale:  leggi ☛   
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 gli Amici in ordine di numero evidenziando nickname e data di 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
    cartella: oppure
    tabella DB: cant_poesie    vedi ☛
    tabella DB: canti_informazioni    vedi ☛

    percorso uso:  > altro > parte privata > poesie
    descrizione in manuale:  leggi ☛   
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
    cartella: oppure
    tabella DB: cant_canzoni    vedi ☛
    percorso uso:  > altro > parte privata > poesie
    descrizione in manuale:  leggi ☛   
cant.oppure.canzoni.elenco.php
cant.oppure.canzoni.ricerca.php
cant.oppure.canzoni.vedo.php
Musica
   cartella: musica/
   percorso uso:  > cantoeprego.it > musica  vai ☛ 
   descrizione in manuale:  leggi ☛    

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

I files segnati con asterisco , devono essere
compilati perché contengono frammenti di musica:
• da terminale dare questi comandi: cd sito.cantoeprego/musica lilypond-book --o out <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.6.  Lilypond
   musi.7.  Frescobaldi
   musi.8.  Gimp
   musi.9.  Gregorio
   musi.10. (canti) (canzoni) (frammenti)?
   
musi.0.home.htm - vedi ☛
imparare la musica
teoria musi.1.home.htm - vedi ☛
musi.1.suono.html
musi.1.note.html
musi.1.scrivere.html
musi.1.forma.html vedere dove inserirlo
leggere musi.2.home.htm - vedi ☛
musi.2.moderno.html
suonare musi.3.home.htm - vedi ☛
musi.3.ese.1.html
musi.3.ese.2.html
musi.3.ese.3.html
4 accompagnare musi.4.home.htm - vedi ☛
musi.4.manuale.1.html
musi.4.manuale.2.html
musi.4.manuale.3.html
musi.4.glossario.html vedere ?
musi.4.docum.htm vedere ?
5 gregoriano musi.5.home.htm - vedi ☛
creare gli spartiti
6 lilypond musi.6.lilypond.html
7 frescobaldi musi.7.frescobaldi.htm
8 gimp musi.8.gimp.htm
9 gregorio musi.9.gregorio.htm
la musica in CeP
elenchi programmi/musi.10.semplici.php
programmi/musi.10.link.php
programmi/musi.10.tag.php
programmi/musi.10.pagine.php
tonalità programmi/musi.10.toni.stat.php
programmi/musi.10.toni.cerca.php
strumenti musi.23.frammenti.htm
sottocartelle
/fisso immagini fisse e sorgenti ly per armonia /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à
    cartella: programmi
    tabella DB: cant_tab_novita  vedi ☛
    percorso uso:  > www.cantoeprego.it
    descrizione in manuale:  leggi ☛   
cant.novita.php
cant.novita.tutti.php
Poesie
    cartella: oppure
    tabella DB: tab_poesie    vedi ☛
    percorso uso:  > altro > parte privata > poesie
    descrizione in manuale:  leggi ☛   
poesie.elenco.php
poesie.vedo.php
Scaletta  
cartella: oppure
    prefisso programmi: cant.oppure.scaletta.
    tabella DB: cant_scaletta    vedi ☛
    percorso gestione:  > altro > scaletta
    percorso uso:  > liturgia > calendario > clic su scaletta nel giorno
    descrizione in manuale:  leggi ☛  
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
    cartella: oppure
    tabella DB: cant_segnalare    vedi ☛
    percorso uso:  > altro > comunicare 
    descrizione in manuale:  leggi ☛   
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à
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_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
canti_titoli
num      varchar  16
titolo   varchar  240
id       int      11
d        timestamp 19
classe   char      4
tipo     varchar   16
nascosto varchar   40
cant_tito_note varchar  1000 
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 
  Manuale ☛   Cap prec ☛