ChordPro

A ChordPro fájlformátum egy gyakran használt formátum más szoftveralkalmazásokban. Az OnSong natívan megérti ezt a formátumot. Az OnSong felismeri a következő fájlkiterjesztésekkel rendelkező fájlokat: .chordpro, .chopro, .cho, .crd, .pro

A ChordPro formátum lehetővé teszi, hogy a dalinformációk kapcsos zárójelek által határolt címkékben legyenek kifejezve. Ez az információ logikailag metaadatok címkékre és beágyazott címkékre osztható.

Metaadatok címkéi

Ezek a ChordPro címkék, amelyeket a dal metaadat részében használnál. A következő címkékben három pont (...) a szöveget képviseli, 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 bármilyen egyéb sorinformáció. Több előadót is megadhat úgy, hogy a neveket pontosvesszővel elválasztja. - Kim Walker-Smith; Chris Quilala
• {album: ...} Az album neve, ahol a dal található.
• {artist: ...} vagy {a: ...} Az előadó neve vagy bármilyen egyéb sorinformáció. Több előadót is megadhat úgy, hogy a neveket pontosvesszővel elválasztja. - Kim Walker-Smith; Chris Quilala
• {author: ...} Az akkorddiagram létrehozójának neve. Ez megjelenik az akkorddiagram alján és a lyriken-projekcióban.
• {key: ...} vagy {k: ...} vagy {ok: ...} A dal tonalitása a tonalitásként írva az enharmonikus preferenciával és egy opcionális „m" karakterrel a mollot jelezve. - alfabetikus, pl. Bb vagy Em
• {capo: ...} A kapo a fretszik számaként - numerikus
• {tempo: ...} Az ütések száma percenként (BPM) - numerikus
• {time: ...} Az időjel - numerikus ütés sávonként, pl. 3/4
• {duration: ...} A dal hossza az automatikus görgetéshez - másodperc vagy mm:ss
• {book: ...} A könyv vagy könyvek neve, amelyekbe a dalt elhelyezni szeretnéd. Ez egy vesszővel tagolt lista a könyvnevekből, amelyekbe a dal be lesz helyezve. Ha a könyv nem létezik, automatikusan létrejön.
• {number: ...} A dal száma - numerikus, énekeskönyvek, évszámok stb. használatához. A dalokat a szám szerint rendezheted hivatkozásként.
• {flow: ...} A szakaszok elrendezése - a szekció címkéinek listája. A dal áramlásának elrendezéséről a Áramlás részben találsz részleteket.
• {midi: ...}} A MIDI-parancsok, amelyeket el kell küldeni a dal megtekintésekor. A MIDI-parancsok szövegként való kifejezéséről az OnSongban a MIDI-szintaxis részben találsz információt.
• {midi-index: ...} A MIDI-parancsok, amelyek ezt a dalt a Dalmegtekintőben megnyitják. A MIDI-parancsok szövegként való kifejezéséről az OnSongban a MIDI-szintaxis részben találsz információt.
• {pitch: ...} A megjátszandó hangok a Hangolócső funkció használatakor.
• {keywords: ...} vagy {topic: ...} A témakeresésnél használandó címkék listája. A témakörönkénti böngészésről a Témák részben találsz további információt.
• {copyright: ...} vagy {footer: ...} vagy {f: ...} A szerzői jogok lábléctextjét határozza meg, amely az oldal alján vagy a lyriken-projekcióban jelenik meg.
• {ccli: ...} A dal CCLI-száma.
• {restrictions: ...} A dal jogkezelésének vesszővel tagolt korlátozásainak listája. A dal korlátozásainak beállításáról a Korlátozások részben találsz részleteket.
• {composer: ...} Az egyének, akik a dal zenéjét írták. Ez a lista pontosvesszővel elválasztott értékekhez szükséges.
• {lyricist: ...} Az egyének, akik a dal szövegét írták. Ez a lista pontosvesszővel elválasztott értékekhez szükséges.

Beágyazott címkék

Ezek a címkék a dal tartalmán belül használatosak, és vagy szekciók definiálásához, vagy a dal részeinek formázásához használhatók.

• {define: ...} egyéni akkorddiagramok definiálásához használatos. Az akkordok definiálásáról a Akkordok definiálása részben találsz további információt.
• {comment: ...} vagy {c: ...}} Megjegyzést definiál, és zenei utasításként jelenik meg.
• {comment_bold: ...} vagy {cb: ...} Félkövéren megjelenő szöveget definiál.
• {comment_italic: ...} vagy {ci: ...} Dőlten megjelenő szöveget definiál.
• {guitar_comment: ...} vagy {gc: ...} Megjegyzést definiál, amely zenei utasításként jelenik meg.
• {start_of_verse: ..} vagy {sov} Egy verze szakasz kezdetét deklarálja egy opcionális szekció címkével.
• {end_of_verse} vagy {eov} Egy verze szakasz végét deklarálja.
• {start_of_chorus: ...} vagy {soc} Egy énekelt rész szakasz kezdetét deklarálja egy opcionális szekció címkével.
• {end_of_chorus} vagy {eoc} Egy énekelt rész szakasz végét deklarálja.
• {start_of_bridge: ...} vagy {sob} Egy hidak szakasz kezdetét deklarálja egy opcionális szekció címkével.
• {end_of_bridge} vagy {eob} Egy hidak szakasz végét deklarálja.
• {start_of_part: ..} vagy {sop} Egy rész kezdetét deklarálja egy opcionális szekció címkével.
• {end_of_part} vagy {eop} Egy rész végét deklarálja.
• {start_of_tab} vagy {sot} A tabulatúra kezdetét deklarálja, amelyet az OnSong monospace betűtípusban jelenít meg.
• {end_of_tab} vagy {eot} Egy tabulatúra szakasz végét deklarálja.
• {new_page} vagy {np} Ezt egy új oldal deklarálásához használod.
• {new_physical_page} vagy {npp} Ezt egy új oldal deklarálásához használod.

Formázási címkék

A következő címkéket az alapértelmezett betűtípus és méret definiálásához használják a lyriken és akkordokhoz az akkorddiagramban.

• {textsize: ...} A lyriken méretét határozza meg numerikus értékként pontban.
• {textfont: ...} A lyriken betűtípusának nevét határozza meg. A platformon támogatottnak kell lennie.
• {chordsize: ...} Az akkordok méretét határozza meg numerikus értékként pontban.
• {chordfont: ...} Az akkordok betűtípusának nevét határozza meg. A platformon támogatottnak kell lennie.

Támogatott fájlkiterjesztések

A ChordPro fájlformátum abban egyedi, hogy általánosan elfogadott szintaxis, de nem szabvány formátum. Ez azt jelenti, hogy a különböző gyártók különböző módon és különböző fájlkiterjesztésekkel valósíthatják meg. Az OnSong a következő fájlkiterjesztéseket támogatja a ChordPro formátumú fájlok importálásakor:

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