MusicXII

Manuale Tecnico

v. 1.0

Sia i moduli che gli oggetti sono accompagnati da un file descrittivo inserito nel manuale di riferimento. Il file, in formato solo testo, contiene in sequenza dei tag all'interno dei quali deve essere collocato il testo. In questa pagina sono elencati i tag base. Nulla vieta, tuttavia e se necessario, di inserirne di nuovi.

Questo l'elenco con la descrizione:

<codice>
Marker MOD- o OGG- seguito dal nome del modulo/oggetto (es.: MOD-CPOLI) in caratteri maiuscolo
</codice>

<denominazione>
Nome abbreviato che appare evidenziato in giallo nella pagina del manuale (es. cpoli)
</denominazione>

<autore>
Nome e cognome dell'autore (o pseudonimo)
</autore>

<copyright>
Indicazioni di copyright
</copyright>

<data>
Data di realizzazione dello script (giorno mese anno)
</data>

<tipo>
Tipo dello script (ad es. Modulo det+)
</tipo>

<formula>
Sintesi astratta letterale del codice (es.: mod:cpoli-a,[b],[c],d)
</formula>

<script>
Codici dello script riportato in forma integrale
</script>

<posizione>
Tipo di file operativo (ad es. Flusso)
</posizione>

<definizione>
Definizione generica dello script [ad es.:<b>CPOLI (Generatore di accordi polifonici su pattern dinamici)<br><br>
mod: cpoli-canale, pattern intervallico, pattern dinamico, durata]
</definizione>

<descrizione>
Descrizione delle funzionalità [ad es.: Il modulo determina la generazione di accordi sulla base di pattern dinamici e valore unico di durata. Il codice è costituito dal tag /mod:/ seguito da: (a) canale di destinazione, (b) pattern armonico tra parentesi quadre con indicazione letterale delle note (notazione anglosassone+stato, es. Cn) separate da una diagonale, (c) pattern dinamico costituito da serie di valori (letterali o numerici) separati da "/" e racchiusi tra parentesi quadre, (d) valore di durata alfanumerico o numerico. Può essere ripetuto ed inserito in qualsiasi sequenza di flusso.]
</descrizione>

<esempi>
Serie di esempi, numerati datati e commentati (in formato Finale, Logic o Cubase). Eventuale partitura (in formato pdf)
</esempi>

<note>
Eventuali note.
</note>

Il file descrittivo, in html, deve accompagnare qualsiasi modulo/oggetto sottoposto ad approvazione. Eventuali tag aggiuntivi devono essere collocati tra i tag "formula" ed "esempi".