ChordPro

A ChordPro fájlformátum egy közös formátum, amelyet más szoftveralkalmazások is használnak. Az OnSong natívan megérti ezt a formátumot. Az OnSong felismeri a következő fájlkiterjesztéseket tartalmazó fájlokat: .chordpro, .chopro, .cho, .crd, .pro

A ChordPro formátum lehetővé teszi a dalok adatainak kapcsos zárójelekkel tagolt címkékben való kifejezését. Ezek az információk logikailag feloszthatók metaadatok és beágyazott címkékre.

Metaadatok címkéi

Ezek a ChordPro címkék, amelyeket a dal metaadatok részében használnál. A következő címkékben három pont (...) az általad megadott szöveget jelöli, amely a kettőspont és a záró kapcsos zárójel között helyezkedik el. Például:

{title: Amazing Grace}
{key: G}

Az OnSong a következő ChordPro címkéket támogatja:

• {title: ...} vagy {t: ...} A dal címe.
• {subtitle: ...}, {st: ...} vagy {su: ...} Az előadó neve vagy egyéb alcím információ. Több előadót is megadhatsz, ha a neveket pontosvesszővel választod el. - Kim Walker-Smith; Chris Quilala
• {album: ...} Annak az albumnak a neve, ahol a dal található.
• {artist: ...} vagy {a: ...} Az előadó neve vagy egyéb alcím információ. Több előadót is megadhatsz, ha a neveket pontosvesszővel választod el. - Kim Walker-Smith; Chris Quilala
• {author: ...} A dallamvázlat készítőjének neve. Ez a dallamvázlat alján és a dalszöveg vetítésekor jelenik meg.
• {key: ...} vagy {k: ...} vagy {ok: ...} A dal hangnemét egy hangnemi előjelezettséggel és egy opcionális „m" betűvel jelöli a mollhoz. - alfabetikus, például Bb vagy Em
• {capo: ...} A kapo beállítása a véggel számított értékben - numerikus
• {tempo: ...} Az ütempercek száma (BPM) - numerikus
• {time: ...} Az ütemjelzés - numerikus ütem ütemenként, például 3/4
• {duration: ...} A dal hossza az autoscrollhoz - másodperc vagy mm:ss
• {book: ...} Annak a könyvnek vagy könyveknek a neve, amelyekbe a dalt be szeretnéd helyezni. Ez egy vesszővel elválasztott lista azokból a könyvnevekből, amelyekbe a dal kerülni fog. Ha a könyv nem létezik, automatikusan létrejön.
• {number: ...} A dal száma - numerikus, himnuszokhoz, évszámokhoz stb. való felhasználásra. Dalsorszám szerint rendezhetsz énekeket referenciaként.
• {flow: ...} A szakaszok elrendezése - szakaszcímkék listája. A dal áramlásának elrendezésről részletekért lásd: Flow.
• {midi: ...} Az elküldendő MIDI parancsok a dal megtekintésekor. A MIDI parancsok OnSongban szövegként történő kifejezéséről lásd: MIDI Syntax.
• {midi-index: ...} Az a MIDI parancs, amely ennek a dalnak a megnyitásához vezet a Song Viewer ablakban. A MIDI parancsok OnSongban szövegként történő kifejezéséről lásd: MIDI Syntax.
• {pitch: ...} A lejátszandó hangok a Pitch Pipe funkció használatakor.
• {keywords: ...} vagy {topic: ...} A témakeresésnél használható címkék listája. A témakör szerinti böngészésről további információkat lásd: Topics.
• {copyright: ...} vagy {footer: ...} vagy {f: ...} Az oldal alján vagy a dalszöveg vetítésekor megjelenő szerzői jogi lábléc szövegét határozza meg.
• {ccli: ...} A dal CCLI száma.
• {restrictions: ...} A dal jogkezelése – vesszővel elválasztott korlátozások listája. A dal korlátozásainak beállításáról részletekért lásd: Restrictions.
• {composer: ...} Az egyének, akik a dal zenéjét írták. Ez a lista pontosvesszővel elválasztott értékekre osztható.
• {lyricist: ...} Az egyének, akik a dal szövegét írták. Ez a lista pontosvesszővel elválasztott értékekre osztható.

Beágyazott címkék

Ezek a címkék a dal tartalmában használatosak, és a szakaszok meghatározására vagy a dal részeinek formázására használhatók.

• {define: ...} egyéni akkorddiagramok meghatározására szolgál. További információkat lásd: Defining Chords.
• {comment: ...} vagy {c: ...} Megjegyzést határozz meg, amely zenei utasításként jelenik meg.
• {comment_bold: ...} vagy {cb: ...} Félkövér szöveg megjelenítésére határozz meg.
• {comment_italic: ...} vagy {ci: ...} Dőlt szöveg megjelenítésére határozz meg.
• {guitar_comment: ...} vagy {gc: ...} Egy megjegyzést határozz meg, amely zenei utasításként jelenik meg.
• {start_of_verse: ...} vagy {sov} A vers szakasz kezdetét nyilvánítja ki, opcionálisan egy szakaszcímkével.
• {end_of_verse} vagy {eov} A vers szakasz végét nyilvánítja ki.
• {start_of_chorus: ...} vagy {soc} A refrén szakasz kezdetét nyilvánítja ki, opcionálisan egy szakaszcímkével.
• {end_of_chorus} vagy {eoc} A refrén szakasz végét nyilvánítja ki.
• {start_of_bridge: ...} vagy {sob} A híd szakasz kezdetét nyilvánítja ki, opcionálisan egy szakaszcímkével.
• {end_of_bridge} vagy {eob} A híd szakasz végét nyilvánítja ki.
• {start_of_part: ...} vagy {sop} Egy rész kezdetét nyilvánítja ki, opcionálisan egy szakaszcímkével.
• {end_of_part} vagy {eop} Egy rész végét nyilvánítja ki.
• {start_of_tab} vagy {sot} A tablatura kezdetét nyilvánítja ki, amelyet az OnSong monospaced betűtípusban jelenít meg.
• {end_of_tab} vagy {eot} A tablatura szakasz végét nyilvánítja ki.
• {new_page} vagy {np} Ez új oldal deklarálására szolgál.
• {new_physical_page} vagy {npp} Ez új oldal deklarálására szolgál.

Formázási címkék

A következő címkék a dalszövegek és akkordok alapértelmezett betűtípusának és méretének meghatározására használatosak a dallamvázlatban.

• {textsize: ...} A dalszövegek méretét pontban numerikus értékként határozza meg.
• {textfont: ...} A dalszövegekhez használandó betűtípus nevét határozza meg. A platformon támogatottnak kell lennie.
• {chordsize: ...} Az akkordok méretét pontban numerikus értékként határozza meg.
• {chordfont: ...} Az akkordokhoz használandó betűtípus nevét határozza meg. A platformon támogatottnak kell lennie.

Támogatott fájlkiterjesztések

A ChordPro fájlformátum abban az értelemben egyedi, hogy általánosan elfogadott szintaxis, de nem szabványos formátum. Ez azt jelenti, hogy a különféle szállítók különféleképpen és különféle fájlkiterjesztésekkel valósíthatják meg. Az OnSong a ChordPro formátumú fájlok importálásakor a következő fájlkiterjesztéseket támogatja:

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