ChordPro

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

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

Značky metadat

Jedná se o ChordPro značky, 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ý zadáte, který se nachází mezi dvojtečkou a uzavírací složenou závorkou. Například:

{title: Amazing Grace}
{key: G}

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

• {title: ...} nebo {t: ...} Název písně.
• {subtitle: ...}, {st: ...} nebo {su: ...} Jméno interpreta nebo jakékoli jiné informace v titulku. Můžete zadat více interpretů oddělením jmen středníkem. - Kim Walker-Smith; Chris Quilala
• {album: ...} Název alba, kde se píseň nachází.
• {artist: ...} nebo {a: ...} Jméno interpreta nebo jakékoli jiné informace v titulku. 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ů. Toto se zobrazuje v dolní části diagramu akordů a v projekci textů.
• {key: ...} nebo {k: ...} nebo {ok: ...} Tónina písně zapsaná jako tónina s preference enharmonie a volitelné „m" označující minor. - abecedně, např. Bb nebo Em
• {capo: ...} Capo nastavit jako počet pražců - číselný
• {tempo: ...} Počet úderů za minutu (BPM) - číselný
• {time: ...} Taktový podíl - číselný takt na takt, např. 3/4
• {duration: ...} Délka písně pro automatické posunování - sekundy nebo mm:ss
• {book: ...} Jméno knihy nebo knih, do kterých umístit píseň. Toto je seznam názvů knih oddělených čá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 hymnusy, roky atd. Můžete řadit písně podle čísla jako referenci.
• {flow: ...} Uspořádání sekcí - seznam názvů sekcí. Podrobnosti o uspořádání toku písně naleznete v Flow.
• {midi: ...} MIDI příkazy k odeslání při zobrazení písně. Podrobnosti o vyjádření MIDI příkazů jako text v OnSong naleznete v MIDI Syntax.
• {midi-index: ...} MIDI příkazy, které spustí otevření této písně v Song Viewer. Podrobnosti o vyjádření MIDI příkazů jako text v OnSong naleznete v MIDI Syntax.
• {pitch: ...} Noty, které se mají přehrát při použití funkce Pitch Pipe.
• {keywords: ...} nebo {topic: ...} Seznam značek pro použití při hledání podle tématu. Více informací o procházení podle tématu naleznete v Topics.
• {copyright: ...} nebo {footer: ...} nebo {f: ...} Určuje text zápatí autorských práv, který se zobrazí v dolní části stránky nebo projekci textů.
• {ccli: ...} CCLI číslo 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ň naleznete v Restrictions.
• {composer: ...} Osoby, které napsaly hudbu k písni. Tento seznam by měl být oddělen středníky pro oddělené hodnoty.
• {lyricist: ...} Osoby, které napsaly text písně. Tento seznam by měl být oddělen středníky pro oddělené hodnoty.

Vložené značky

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

• {define: ...} se používá k definování vlastních diagramů akordů. Více informací naleznete v Defining Chords.
• {comment: ...} nebo {c: ...} Definuje komentář a zobrazí se jako hudební instrukce.
• {comment_bold: ...} nebo {cb: ...} Definuje text, který se má zobrazit tučně.
• {comment_italic: ...} nebo {ci: ...} Definuje text, který se má zobrazit kurzívou.
• {guitar_comment: ...} nebo {gc: ...} Definuje komentář, který se zobrazí jako hudební instrukce.
• {start_of_verse: ..} nebo {sov} Deklaruje začátek sekce verše s volitelným názvem sekce.
• {end_of_verse} nebo {eov} Deklaruje konec sekce verše.
• {start_of_chorus: ...} nebo {soc} Deklaruje začátek sekce refrénu s volitelným názvem sekce.
• {end_of_chorus} nebo {eoc} Deklaruje konec sekce refrénu.
• {start_of_bridge: ...} nebo {sob} Deklaruje začátek sekce můstku s volitelným názvem sekce.
• {end_of_bridge} nebo {eob} Deklaruje konec sekce můstku.
• {start_of_part: ..} nebo {sop} Deklaruje začátek části s volitelným názvem sekce.
• {end_of_part} nebo {eop} Deklaruje konec části.
• {start_of_tab} nebo {sot} Deklaruje začátek tabulatury, kterou OnSong vykresluje monospaced písmem.
• {end_of_tab} nebo {eot} Deklaruje konec sekce tabulatury.
• {new_page} nebo {np} Toto se používá k deklarování nové stránky.
• {new_physical_page} nebo {npp} Toto se používá k deklarování 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 pro texty a akordy v diagramu akordů.

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

Podporované přípon 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 jej různí dodavatelé 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ů ve formátu ChordPro:

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