ChordPro

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

A ChordPro formátum lehetővé teszi, hogy a dal információit kapcsos zárójelekre tagolt címkékben fejezzük ki. Ez az információ logikusan felosztható metaadatokra és soron belüli címkékre.

Metaadat-címkék

Ezek a ChordPro-címkék, amelyeket a dal metaadat részében használna. Az alábbi címkékben három pont (...) az Ön által 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 bármilyen egyéb melléknév. Több előadót is megadhat, ha a neveket pontosvesszővel választja el. - 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 melléknév. Több előadót is megadhat, ha a neveket pontosvesszővel választja el. - Kim Walker-Smith; Chris Quilala
• {author: ...} Az akkorddiagram készítőjének neve. Ez megjelenik az akkorddiagram alján és a lyriken-projektálásban.
• {key: ...} vagy {k: ...} vagy {ok: ...} A dal tonalitása, amelyet a tonalitás enharmonikus preferenciaként és egy opcionális „m" betűvel írunk, amely az öt jelzi. - alfabetikus, pl. Bb vagy Em
• {capo: ...} A kapo beállítása a fugarak számában - numerikus
• {tempo: ...} Az ütések száma percenként (BPM) - numerikus
• {time: ...} Az időjel - numerikus lüktetés a sáv felett, pl. 3/4
• {duration: ...} A dal hossza az automatikus görgetéshez - másodperc vagy mm:ss
• {book: ...} Az egy vagy több könyv neve, amelybe a dalt helyezni szeretné. Ez a vesszővel elválasztott könyvnevek listája, amelyekbe a dal be lesz helyezve. Ha a könyv nem létezik, automatikusan létrehozva lesz.
• {number: ...} A dal száma - numerikus, használja himnuszokhoz, évekhez, stb. Rendezheti a dalokat a szám szerint referenciához.
• {flow: ...} A szakaszok elrendezése - a szakasz címkéinek listája. A dal folyamatának rendezésével kapcsolatos részletekért lásd a Folyamat részben.
• {midi: ...} A MIDI-parancsok a dal megtekintésekor küldendők. A MIDI-parancsok szövegként történő OnSong-ban való kifejezésének módját lásd a MIDI szintaxis részben.
• {midi-index: ...} A MIDI-parancsok, amelyek aktiválják ezt a dalt a Dalmegtekintőben. A MIDI-parancsok szövegként történő OnSong-ban való kifejezésének módját lásd a MIDI szintaxis részben.
• {pitch: ...} A lejátszandó hangok az Hangmagasság-cső funkció használatakor.
• {keywords: ...} vagy {topic: ...} A témakörkereséshez használt címkék listája. A témakörök szerinti böngészésről további információért lásd a Témakörök részben.
• {copyright: ...} vagy {footer: ...} A szerzői jog lábléc szövegét határozza meg, amely az oldal alján vagy a lyriken-projektálásban jelenik meg.
• {ccli: ...} A dal CCLI száma.
• {restrictions: ...} A dal jogkezelése a vesszővel elválasztott korlátozások listája. A dal korlátozásainak beállításáról további részletekért lásd a Korlátozások részt.

Soron belüli címkék

Ezek a címkék a dal tartalmában használatosak, és 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ása részben találhat további információt.
• {comment: ...} vagy {c: ...} Egy megjegyzést határoz meg, és zenei utasításként jelenik meg.
• {comment_bold: ...} vagy {cb: ...} Szöveget határoz meg, amely félkövéren jelenik meg.
• {comment_italic: ...} vagy {ci: ...} Szöveget határoz meg, amely dőlt betűvel jelenik meg.
• {guitar_comment: ...} vagy {gc: ...} Egy megjegyzést határoz meg, amely zenei utasításként jelenik meg.
• {start_of_verse: ..} vagy {sov} Egy versszak kezdetét deklarálja egy opcionális szekcióazonosítóval.
• {end_of_verse} vagy {eov} Egy versszak végét deklarálja.
• {start_of_chorus: ...} vagy {soc} Egy refrén kezdetét deklarálja egy opcionális szekcióazonosítóval.
• {end_of_chorus} vagy {eoc} Egy refrén végét deklarálja.
• {start_of_bridge: ...} vagy {sob} Egy híd kezdetét deklarálja egy opcionális szekcióazonosítóval.
• {end_of_bridge} vagy {eob} Egy híd végét deklarálja.
• {start_of_part: ..} vagy {sop} Egy rész kezdetét deklarálja egy opcionális szekcióazonosítóval.
• {end_of_part} vagy {eop} Egy rész végét deklarálja.
• {start_of_tab} vagy {sot} A tabuláció kezdetét deklarálja, amelyet az OnSong egyközépített betűtípusban jelenít meg.
• {end_of_tab} vagy {eot} Egy tabuláció szakaszának végét deklarálja.
• {new_page} vagy {np} Ez az új oldal deklarálására szolgál.
• {new_physical_page} vagy {npp} Ez az új oldal deklarálására szolgál.

Formázási címkék

Az alábbi címkék az akkorddiagramban szereplő lyriken és akkordok alapértelmezett betűtípusának és méretének definiálására szolgálnak.

• {textsize: ...} A lyriken méretét numerikus értékként pontos értékben határozza meg.
• {textfont: ...} A lyriken-hez használandó betűtípus nevét határozza meg. A platformon támogatottnak kell lennie.
• {chordsize: ...} Az akkordok méretét numerikus értékként pontos értékben 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 megállapodott szintaxis, de nem szabványos formátum. Ez azt jelenti, hogy különféle szállítók különböző módokon és különböző fájlkiterjesztésekkel implementálhatják. 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