ChordPro

Die ChordPro-lêerindeling is 'n algemene indeling wat in ander softwaretoepassings gebruik word. OnSong verstaan hierdie indeling naties. OnSong herken lêers met die volgende lêer-uitbreidings: .chordpro, .chopro, .cho, .crd, .pro

Die ChordPro-indeling laat toe dat liedinligting in etikette uitgedruk word wat deur krulhaakies afgebaken word. Hierdie inligting kan logies in metagegeewsetikette en inlynse etikette verdeel word.

Metagegeewsetikette

Dit is ChordPro-etikette wat u in die metagegeewsgedeelte van die lied sou gebruik. In die volgende etikette verteenwoordig drie punte (...) die teks wat u verskaf, wat tussen die dubbelpunt en die sluitende krulhakie gaan. Byvoorbeeld:

{title: Amazing Grace}
{key: G}

OnSong ondersteun die volgende ChordPro-etikette:

• {title: ...} of {t: ...} Die titel van die lied.
• {subtitle: ...}, {st: ...} of {su: ...} Die kunstenaarsnaam of enige ander bylininligting. U kan verskeie kunstenaars spesifiseer deur name met 'n kommapunt te skei. - Kim Walker-Smith; Chris Quilala
• {album: ...} Die naam van die album waar die lied geleë is.
• {artist: ...} of {a: ...} Die kunstenaarsnaam of enige ander bylininligting. U kan verskeie kunstenaars spesifiseer deur name met 'n kommapunt te skei. - Kim Walker-Smith; Chris Quilala
• {author: ...} Die naam van die persoon wat die akkoordkaart geskep het. Dit word onderaan die akkoordkaart en in lyriekprojeksie vertoon.
• {key: ...} of {k: ...} of {ok: ...} Die toonsoort van die lied geskryf as 'n toonsoort met enharmonies voorkeur en 'n opsionele "m" om minor aan te dui. - alfabeties, bv. Bb of Em
• {capo: ...} Die kapo om in te stel as aantal frets - numeries
• {tempo: ...} Die slae per minuut (BPM) - numeries
• {time: ...} Die tydmaat - numeries slag oor maat bv. 3/4
• {duration: ...} Die liedduur vir outomatiese blaai - sekondes of mm:ss
• {book: ...} Die naam van die boek of boeke om die lied in te plaas. Dit is 'n kommagescheiden lys van boeknome waarin die lied geplaas sal word. Indien die boek nie bestaan nie, sal dit outomaties geskep word.
• {number: ...} Die nommer van die lied - numeries, gebruik vir himnes, jare, ens. U kan liedere volgens die nommer sorteer vir verwysing.
• {flow: ...} Die rangskikking van afdelings - lys van afdelingsetikette. Sien Vloei vir besonderhede oor die rangskikking van die vloei van 'n lied.
• {midi: ...} Die MIDI-bevele om te stuur wanneer die lied bekyk word. Sien MIDI-sintaksis vir hoe om MIDI-bevele as teks in OnSong uit te druk.
• {midi-index: ...} Die MIDI-bevele wat hierdie lied sal oopmaak in die Liedkyk. Sien MIDI-sintaksis vir hoe om MIDI-bevele as teks in OnSong uit te druk.
• {pitch: ...} Die note om te speel wanneer die Toonhoogte-pyp funksie gebruik word.
• {keywords: ...} of {topic: ...} Die lys van etikette wat met onderwerpsoeke gebruik word. Sien Onderwerpe vir meer inligting oor blaai volgens onderwerp.
• {copyright: ...} of {footer: ...} Spesifiseer kopiereg-voetersteks wat onderaan die bladsy of lyriekprojeksie verskyn.
• {ccli: ...} Die CCLI-nommer van die lied.
• {restrictions: ...} Die regtebeheer vir die kommagescheiden lys van beperkings van die lied. Sien Beperkings vir besonderhede oor die instelling van beperkings vir u lied.

Inlynse etikette

Hierdie etikette word binne die inhoud van die lied gebruik en kan gebruik word om óf afdelings te definieer óf dele van die lied op te maak.

• {define: ...} word gebruik om pasgemaakte akkoorddiagramme te definieer. Sien Akkoorde definieer vir meer inligting.
• {comment: ...} of {c: ...} Definieer 'n opmerking en verskyn as 'n musikale instruksie.
• {comment_bold: ...} of {cb: ...} Definieer teks om vet te verskyn.
• {comment_italic: ...} of {ci: ...} Definieer teks om skuins te verskyn.
• {guitar_comment: ...} of {gc: ...} Definieer 'n opmerking wat as 'n musikale instruksie verskyn.
• {start_of_verse: ..} of {sov} Verklaar die begin van 'n versafdeling met 'n opsionele afdelingstitel.
• {end_of_verse} of {eov} Verklaar die einde van 'n versafdeling.
• {start_of_chorus: ...} of {soc} Verklaar die begin van 'n refreinafdeling met 'n opsionele afdelingstitel.
• {end_of_chorus} of {eoc} Verklaar die einde van 'n refreinafdeling.
• {start_of_bridge: ...} of {sob} Verklaar die begin van 'n bruafdeling met 'n opsionele afdelingstitel.
• {end_of_bridge} of {eob} Verklaar die einde van 'n bruafdeling.
• {start_of_part: ..} of {sop} Verklaar die begin van 'n deel met 'n opsionele afdelingstitel.
• {end_of_part} of {eop} Verklaar die einde van 'n deel.
• {start_of_tab} of {sot} Verklaar die begin van tabulering wat OnSong in 'n vastewydte-font voorstel.
• {end_of_tab} of {eot} Verklaar die einde van 'n tabelleringsgedeelte.
• {new_page} of {np} Dit word gebruik om 'n nuwe bladsy te verklaar.
• {new_physical_page} of {npp} Dit word gebruik om 'n nuwe bladsy te verklaar.

Opmaaksetikette

Die volgende etikette word gebruik om die verseksterfont en -grootte vir lirieken en akkoorde in die akkoordkaart te definieer.

• {textsize: ...} Definieer die grootte van die lirieken as 'n numeriese waarde in punte.
• {textfont: ...} Definieer die naam van die font wat vir lirieken gebruik moet word. Moet op die platform ondersteun word.
• {chordsize: ...} Definieer die grootte van die akkoorde as 'n numeriese waarde in punte.
• {chordfont: ...} Definieer die naam van die font wat vir akkoorde gebruik moet word. Moet op die platform ondersteun word.

Ondersteunde lêer-uitbreidings

Die ChordPro-lêerindeling is uniek daarin dat dit 'n algemeen aanvaarde sintaksis is, maar nie 'n standaardindeling nie. Dit beteken dat verskeie verskaffers dit op verskillende maniere en met verskillende lêer-uitbreidings kan implementeer. OnSong ondersteun die volgende lêer-uitbreidings wanneer ChordPro-geformateerde lêers ingevoer word:

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