ChordPro

Formatul de fișier ChordPro este un format comun utilizat în alte aplicații software. OnSong înțelege nativ acest format. OnSong recunoaște fișiere cu următoarele extensii de fișier: .chordpro, .chopro, .cho, .crd, .pro

Formatul ChordPro permite exprimarea informațiilor despre cântec în etichete delimitate de acolade. Aceste informații pot fi împărțite logic în etichete de metadate și etichete inline.

Etichete de metadate

Acestea sunt etichete ChordPro pe care le-ați utiliza în porțiunea de metadate a cântecului. În etichetele următoare, trei puncte (...) reprezintă textul pe care îl furnizați, care se situează între colon și acolada de închidere. De exemplu:

{title: Amazing Grace}
{key: G}

OnSong acceptă următoarele etichete ChordPro:

• {title: ...} sau {t: ...} Titlul cântecului.
• {subtitle: ...}, {st: ...} sau {su: ...} Numele artistului sau orice alte informații din subtitlu. Puteți specifica mai mulți artiști separând numele cu punct și virgulă. - Kim Walker-Smith; Chris Quilala
• {album: ...} Numele albumului în care se află cântecul.
• {artist: ...} sau {a: ...} Numele artistului sau orice alte informații din subtitlu. Puteți specifica mai mulți artiști separând numele cu punct și virgulă. - Kim Walker-Smith; Chris Quilala
• {author: ...} Numele persoanei care a creat diagrama acordurilor. Aceasta se afișează în partea de jos a diagramei acordurilor și în proiecția textelor.
• {key: ...} sau {k: ...} sau {ok: ...} Tonalitatea cântecului scrisă ca o tonalitate cu preferință enharmonică și un opțional „m" pentru a indica minor. - alfabetic, de ex. Bb sau Em
• {capo: ...} Capo-ul de setat ca număr de praguri - numeric
• {tempo: ...} Ritmul bătăilor pe minut (BPM) - numeric
• {time: ...} Semnul de măsură - bătaie numerică peste măsură, de ex. 3/4
• {duration: ...} Lungimea cântecului pentru derulare automată - secunde sau mm:ss
• {book: ...} Numele cărții sau cărților în care să plasați cântecul. Aceasta este o listă delimitată prin virgulă de nume de cărți în care va fi plasat cântecul. Dacă cartea nu există, va fi creată automat.
• {number: ...} Numărul cântecului - numeric, utilizați pentru imnuri, ani, etc. Puteți sorta cântecele după număr pentru referință.
• {flow: ...} Aranjamentul secțiunilor - listă de etichete de secțiuni. Consultați Flux pentru detalii privind aranjarea fluxului unui cântec.
• {midi: ...} Comenzile MIDI de trimis atunci când se vizualizează cântecul. Consultați Sintaxa MIDI pentru a afla cum să exprimați comenzile MIDI ca text în OnSong.
• {midi-index: ...} Comenzile MIDI care vor declanșa deschiderea acestui cântec în Vizualizatorul de cântece. Consultați Sintaxa MIDI pentru a afla cum să exprimați comenzile MIDI ca text în OnSong.
• {pitch: ...} Notele de cântat atunci când utilizați funcția Diapason.
• {keywords: ...} sau {topic: ...} Lista de etichete de utilizat cu căutarea de subiecte. Consultați Subiecte pentru mai multe informații despre răsfoirea după subiecte.
• {copyright: ...} sau {footer: ...} Specifică textul de subsol pentru drepturi de autor care să apară în partea de jos a paginii sau în proiecția textelor.
• {ccli: ...} Numărul CCLI al cântecului.
• {restrictions: ...} Managementul drepturilor pentru lista delimitată prin virgulă a cântecului cu restricții. Consultați Restricții pentru detalii privind setarea restricțiilor pentru cântecul dumneavoastră.

Etichete inline

Acestea sunt etichete utilizate în conținutul cântecului și pot fi utilizate pentru a defini secțiuni sau pentru a formata părți ale cântecului.

• {define: ...} este utilizat pentru a defini diagrame de acorduri personalizate. Consultați Definirea acordurilor pentru mai multe informații.
• {comment: ...} sau {c: ...} Definește un comentariu și apare ca o instrucțiune muzicală.
• {comment_bold: ...} sau {cb: ...} Definește textul care va apărea în bold.
• {comment_italic: ...} sau {ci: ...} Definește textul care va apărea ca italic.
• {guitar_comment: ...} sau {gc: ...} Definește un comentariu care apare ca o instrucțiune muzicală.
• {start_of_verse: ..} sau {sov} Declară începutul unei secțiuni versuri cu o etichetă de secțiune opțională.
• {end_of_verse} sau {eov} Declară sfârșitul unei secțiuni versuri.
• {start_of_chorus: ...} sau {soc} Declară începutul unei secțiuni refren cu o etichetă de secțiune opțională.
• {end_of_chorus} sau {eoc} Declară sfârșitul unei secțiuni refren.
• {start_of_bridge: ...} sau {sob} Declară începutul unei secțiuni punte cu o etichetă de secțiune opțională.
• {end_of_bridge} sau {eob} Declară sfârșitul unei secțiuni punte.
• {start_of_part: ..} sau {sop} Declară începutul unei părți cu o etichetă de secțiune opțională.
• {end_of_part} sau {eop} Declară sfârșitul unei părți.
• {start_of_tab} sau {sot} Declară începutul unui tabulatur pe care OnSong îl renderizează într-o font cu spațiere fixă.
• {end_of_tab} sau {eot} Declară sfârșitul unei secțiuni tabulatur.
• {new_page} sau {np} Aceasta este utilizată pentru a declara o pagină nouă.
• {new_physical_page} sau {npp} Aceasta este utilizată pentru a declara o pagină nouă.

Etichete de formatare

Următoarele etichete sunt utilizate pentru a defini fontul și dimensiunea implicite pentru textele și acordurile din diagrama acordurilor.

• {textsize: ...} Definește dimensiunea textelor ca valoare numerică în puncte.
• {textfont: ...} Definește numele fontului care se va utiliza pentru texte. Trebuie să fie acceptat pe platformă.
• {chordsize: ...} Definește dimensiunea acordurilor ca valoare numerică în puncte.
• {chordfont: ...} Definește numele fontului care se va utiliza pentru acorduri. Trebuie să fie acceptat pe platformă.

Extensii de fișier acceptate

Formatul de fișier ChordPro este unic prin faptul că este o sintaxă ușor acceptată, dar nu un format standard. Aceasta înseamnă că diverși furnizori o pot implementa în moduri diferite și cu extensii de fișier diferite. OnSong acceptă următoarele extensii de fișier la importarea fișierelor formatate ChordPro:

• .chopro
• .cho
• .chordpro
• .crd
• .pro
• .cpm