ChordPro

Die ChordPro-lêerformaat is 'n algemene formaat wat in ander sagtewaretoepassings gebruik word. OnSong verstaan hierdie formaat natuurlik. OnSong herken lêers met die volgende lêeruitbreidings: .chordpro, .chopro, .cho, .crd, .pro

Die ChordPro-formaat laat toe dat liedinligting in etikette wat deur krullebraces begrens word, uitgedruk kan word. Hierdie inligting kan logiese verdeel word in metagegewens-etikette en intydelike etikette.

Metagegewens-etikette

Dit is ChordPro-etikette wat u in die metagegewens-gedeelte van die liedjie sou gebruik. In die volgende etikette stel drie punte (...) die teks voor wat u verskaf, wat tussen die dubbelpunt en die sluitende krullebrace gaan. Byvoorbeeld:

{title: Amazing Grace}
{key: G}

OnSong ondersteun die volgende ChordPro-etikette:

• {title: ...} of {t: ...} Die titel van die liedjie.
• {subtitle: ...}, {st: ...} of {su: ...} Die kunstenaarsnaam of enige ander bylyn-inligting. U kan verskeie kunstenaars spesifiseer deur name met 'n semikolon te skei. - Kim Walker-Smith; Chris Quilala
• {album: ...} Die naam van die album waar die liedjie geleë is.
• {artist: ...} of {a: ...} Die kunstenaarsnaam of enige ander bylyn-inligting. U kan verskeie kunstenaars spesifiseer deur name met 'n semikolon te skei. - Kim Walker-Smith; Chris Quilala
• {author: ...} Die naam van die persoon wat die akkoordiagram geskep het. Dit word aan die onderkant van die akkoordiagram en in lyriekprojeksie vertoon.
• {key: ...} of {k: ...} of {ok: ...} Die sleutel van die liedjie wat as 'n sleutel met enharmoniese voorkeur en 'n opsionele "m" om mineur aan te dui, geskryf is. - alfabeties, bv. Bb of Em
• {capo: ...} Die kapo om in te stel as aantal frette - numeries
• {tempo: ...} Die slae per minuut (BPM) - numeries
• {time: ...} Die tydteken - numeriese slag oor maat bv. 3/4
• {duration: ...} Die liedjie se lengte vir outo-rol - sekondes of mm:ss
• {book: ...} Die naam van die boek of boeke om die liedjie in te plaas. Dit is 'n komma-geskeidenlyste van boeknaam waarin die liedjie geplaas sal word. As die boek nie bestaan nie, sal dit outomaties geskep word.
• {number: ...} Die nommer van die liedjie - numeries, gebruik vir himnes, jare, ensovoorts. U kan liedjies volgens die nommer sorteer vir verwysing.
• {flow: ...} Die rangskikking van afdeling - lyste van afdeling-etikette. Sien Flow vir besonderhede oor die rangskikking van die vloei van 'n liedjie.
• {midi: ...} Die MIDI-bevele om te stuur wanneer die liedjie gesien word. Sien MIDI-sintaksis vir hoe om MIDI-bevele as teks in OnSong uit te druk.
• {midi-index: ...} Die MIDI-bevele wat hierdie liedjie sal oopmaak in die Liedjievertooner. Sien MIDI-sintaksis vir hoe om MIDI-bevele as teks in OnSong uit te druk.
• {pitch: ...} Die note om af te speel wanneer u die Toonhoogte-pyp-funksie gebruik.
• {keywords: ...} of {topic: ...} Die lyste van etikette wat vir onderwerp-soektog gebruik moet word. Sien Onderwerpe vir meer inligting oor bladerwerk volgens onderwerp.
• {copyright: ...} of {footer: ...} of {f: ...} Spesifiseer kopiereg-voetteksteks om aan die onderkant van die bladsy of lyriekprojeksie te verskyn.
• {ccli: ...} Die CCLI-nommer van die liedjie.
• {restrictions: ...} Die regteverwaltung vir die liedjie se komma-geskeidenlyste van beperkinge. Sien Beperkinge vir besonderhede oor die stelling van beperkinge vir u liedjie.
• {composer: ...} Die individue wat die musiek van die liedjie geskryf het. Hierdie lyste moet met semikolons vir afsonderlike waardes geskei word.
• {lyricist: ...} Die individue wat die lirieke van die liedjie geskryf het. Hierdie lyste moet met semikolons vir afsonderlike waardes geskei word.

Intydelike etikette

Hierdie etikette word in die inhoud van die liedjie gebruik en kan gebruik word om afdeling te definieer of om dele van die liedjie 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 voor te kom.
• {comment_italic: ...} of {ci: ...} Definieer teks om as kursief voor te kom.
• {guitar_comment: ...} of {gc: ...} Definieer 'n opmerking wat as 'n musikale instruksie verskyn.
• {start_of_verse: ..} of {sov} Verklaar die begin van 'n vers-afdeling met 'n opsionele afdeling-etiket.
• {end_of_verse} of {eov} Verklaar die einde van 'n vers-afdeling.
• {start_of_chorus: ...} of {soc} Verklaar die begin van 'n refrein-afdeling met 'n opsionele afdeling-etiket.
• {end_of_chorus} of {eoc} Verklaar die einde van 'n refrein-afdeling.
• {start_of_bridge: ...} of {sob} Verklaar die begin van 'n brug-afdeling met 'n opsionele afdeling-etiket.
• {end_of_bridge} of {eob} Verklaar die einde van 'n brug-afdeling.
• {start_of_part: ..} of {sop} Verklaar die begin van 'n gedeelte met 'n opsionele afdeling-etiket.
• {end_of_part} of {eop} Verklaar die einde van 'n gedeelte.
• {start_of_tab} of {sot} Verklaar die begin van 'n tabulatuur wat OnSong in 'n monospasiale font uitvoer.
• {end_of_tab} of {eot} Verklaar die einde van 'n tabulatuur-afdeling.
• {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.

Opmaak-etikette

Die volgende etikette word gebruik om die verstekslettersoort en -grootte vir lirieke en akkoorde in die akkoordiagram te definieer.

• {textsize: ...} Definieer die grootte van die lirieke as 'n numeriese waarde in punte.
• {textfont: ...} Definieer die naam van die lettertipe om vir lirieke te gebruik. 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 lettertipe om vir akkoorde te gebruik. Moet op die platform ondersteun word.

Ondersteunde lêeruitbreidings

Die ChordPro-lêerformaat is uniek in die sin dat dit 'n algemeen ooreengekome sintaksis is, maar nie 'n standaardformaat nie. Dit beteken dat verskeie verskaffer dit op verskillende maniere en met ander lêeruitbreidings kan implementeer. OnSong ondersteun die volgende lêeruitbreidings wanneer ChordPro-geformatteerde lêers ingevoer word:

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