ChordPro

Formát souboru ChordPro je běžný formát používaný v jiných softwarových aplikacích. OnSong tomuto formátu rozumí nativně. OnSong rozpoznává soubory s následujícími příponami: .chordpro, .chopro, .cho, .crd, .pro

Formát ChordPro umožňuje vyjádřit informace o písni pomocí značek ohraničených složenými závorkami. Tyto informace lze logicky rozdělit na značky metadat a vřazené značky.

Značky metadat

Jedná se o značky ChordPro, které byste použili v části metadat písně. V následujících značkách tři tečky (...) představují text, který poskytnete, který se nachází mezi dvojtečkou a zavírací složenou závorkou. Například:

{title: Amazing Grace}
{key: G}

OnSong podporuje následující značky ChordPro:

• {title: ...} nebo {t: ...} Název písně.
• {subtitle: ...}, {st: ...} nebo {su: ...} Jméno interpreta nebo jakékoli další informace v poutavě. Můžete zadat více interpretů oddělením jmen středníkem. - Kim Walker-Smith; Chris Quilala
• {album: ...} Název alba, ve kterém se píseň nachází.
• {artist: ...} nebo {a: ...} Jméno interpreta nebo jakékoli další informace v poutavě. Můžete zadat více interpretů oddělením jmen středníkem. - Kim Walker-Smith; Chris Quilala
• {author: ...} Jméno osoby, která vytvořila diagram akordů. Zobrazuje se v dolní části diagramu akordů a v projekci textu.
• {key: ...} nebo {k: ...} nebo {ok: ...} Tónina písně zapsaná jako tónina s preferencí enharmonické a volitelné „m" pro označení moll. - abecední, např. Bb nebo Em
• {capo: ...} Kapodaster nastavený jako počet pražců - číselný
• {tempo: ...} Počet úderů za minutu (BPM) - číselný
• {time: ...} Taktový podíl - číselný tah přes takt, např. 3/4
• {duration: ...} Délka písně pro automatické posunutí - sekundy nebo mm:ss
• {book: ...} Název knihy nebo knih, do kterých umístit píseň. Jedná se o seznam názvů knih oddělený čárkami, do kterých bude píseň umístěna. Pokud kniha neexistuje, bude automaticky vytvořena.
• {number: ...} Číslo písně - číselný, použijte pro hymny, roky atd. Písně můžete seřadit podle čísla pro referenci.
• {flow: ...} Uspořádání sekcí - seznam popisků sekcí. Podrobnosti o uspořádání toku písně najdete v Toku.
• {midi: ...} Příkazy MIDI, které se mají odeslat při zobrazení písně. Podrobnosti o vyjádření příkazů MIDI jako textu v OnSong najdete v Syntaxi MIDI.
• {midi-index: ...} Příkazy MIDI, které spustí otevření této písně v Prohlížeči písní. Podrobnosti o vyjádření příkazů MIDI jako textu v OnSong najdete v Syntaxi MIDI.
• {pitch: ...} Noty, které se mají přehrát při použití funkce Ladička.
• {keywords: ...} nebo {topic: ...} Seznam značek pro použití s vyhledáváním témat. Více informací o procházení podle tématu najdete v Tématech.
• {copyright: ...} nebo {footer: ...} Určuje text zápatí autorských práv, který se objeví v dolní části stránky nebo v projekci textu.
• {ccli: ...} Číslo CCLI písně.
• {restrictions: ...} Správa práv pro seznam omezení oddělený čárkami v písni. Podrobnosti o nastavení omezení pro vaši píseň najdete v Omezeních.

Vřazené značky

Tyto značky se používají v obsahu písně a lze je použít k definování sekcí nebo k formátování částí písně.

• {define: ...} se používá k definování vlastních diagramů akordů. Více informací najdete v Definování akordů.
• {comment: ...} nebo {c: ...} Definuje komentář a objevuje se jako hudební instrukce.
• {comment_bold: ...} nebo {cb: ...} Definuje text, který se zobrazí tučně.
• {comment_italic: ...} nebo {ci: ...} Definuje text, který se zobrazí kurzívou.
• {guitar_comment: ...} nebo {gc: ...} Definuje komentář, který se objevuje jako hudební instrukce.
• {start_of_verse: ..} nebo {sov} Deklaruje začátek verše s volitelným popiskem sekce.
• {end_of_verse} nebo {eov} Deklaruje konec verše.
• {start_of_chorus: ...} nebo {soc} Deklaruje začátek refrén sekce s volitelným popiskem sekce.
• {end_of_chorus} nebo {eoc} Deklaruje konec refrén sekce.
• {start_of_bridge: ...} nebo {sob} Deklaruje začátek přemostění sekce s volitelným popiskem sekce.
• {end_of_bridge} nebo {eob} Deklaruje konec přemostění sekce.
• {start_of_part: ..} nebo {sop} Deklaruje začátek části s volitelným popiskem sekce.
• {end_of_part} nebo {eop} Deklaruje konec části.
• {start_of_tab} nebo {sot} Deklaruje začátek tabulatury, kterou OnSong vykresluje v monoprostorkovém písmu.
• {end_of_tab} nebo {eot} Deklaruje konec části tabulatury.
• {new_page} nebo {np} Používá se k deklaraci nové stránky.
• {new_physical_page} nebo {npp} Používá se k deklaraci nové stránky.

Značky formátování

Následující značky se používají k definování výchozího písma a velikosti textu a akordů v diagramu akordů.

• {textsize: ...} Definuje velikost textu jako číselnou hodnotu v bodech.
• {textfont: ...} Definuje název písma, které se má použít pro text. Musí být podporováno na platformě.
• {chordsize: ...} Definuje velikost akordů jako číselnou hodnotu v bodech.
• {chordfont: ...} Definuje název písma, které se má použít pro akordy. Musí být podporováno na platformě.

Podporované přípony souborů

Formát souboru ChordPro je jedinečný v tom, že se jedná o běžně dohodnutou syntaxi, ale ne standardní formát. To znamená, že různí dodavatelé jej mohou implementovat různými způsoby a s různými příponami souborů. OnSong podporuje následující přípony souborů při importu souborů formátovaných ChordPro:

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