ChordPro

Formát souboru ChordPro je běžný formát používaný v jiných softwarových aplikacích. OnSong pochopí tento formát 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 tazích oddělených složenými závorkami. Tyto informace lze logicky rozdělit na značky metadat a inline 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ý 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í značky ChordPro:

• {title: ...} nebo {t: ...} Název písně.
• {subtitle: ...}, {st: ...} nebo {su: ...} Jméno umělce nebo jakékoli jiné informace o podtitulku. Můžete zadat více umělců 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 umělce nebo jakékoli jiné informace o podtitulku. Můžete zadat více umělců oddělením jmen středníkem. - Kim Walker-Smith; Chris Quilala
• {author: ...} Jméno osoby, která vytvořila akordický diagram. To se zobrazuje v dolní části akordického diagramu a v projekci textů písní.
• {key: ...} nebo {k: ...} nebo {ok: ...} Tónina písně zapsaná jako tónina s enharmonickou preferencí a volitelným „m" pro označení mollu. - abecední, např. Bb nebo Em
• {capo: ...}} Kapo nastavit jako počet pražců - numerické
• {tempo: ...} Počet úderů za minutu (BPM) - numerické
• {time: ...} Taktové označení - numerický takt nad taktem, např. 3/4
• {duration: ...} Délka písně pro automatické posouvání - sekundy nebo mm:ss
• {book: ...} Název knihy nebo knih, do kterých má být píseň umístěna. Jedná se o seznam názvů knih oddělených čárkami, do kterých bude píseň umístěna. Pokud kniha neexistuje, bude vytvořena automaticky.
• {number: ...} Číslo písně - numerické, použijte pro hymny, roky atd. Písně můžete seřadit podle čísla jako referenci.
• {flow: ...} Uspořádání sekcí - seznam popisů sekcí. Viz Tok pro podrobnosti o uspořádání toku písně.
• {midi: ...} Příkazy MIDI k odeslání při zobrazení písně. Viz Syntaxe MIDI pro způsob vyjádření příkazů MIDI jako text v OnSong.
• {midi-index: ...} Příkazy MIDI, které aktivují otevření této písně v Prohlížeči písní. Viz Syntaxe MIDI pro způsob vyjádření příkazů MIDI jako text v OnSong.
• {pitch: ...} Noty k přehrání při použití funkce Pitch Pipe.
• {keywords: ...} nebo {topic: ...} Seznam značek pro použití s vyhledáváním podle tématu. Viz Témata pro více informací o procházení podle tématu.
• {copyright: ...} nebo {footer: ...} nebo {f: ...} Určuje text zápatí autorských práv, který se zobrazí v dolní části stránky nebo projekce textů písní.
• {ccli: ...} Číslo CCLI písně.
• {restrictions: ...} Správa práv pro seznam omezení oddělený čárkami. Viz Omezení pro podrobnosti o nastavení omezení pro vaši píseň.
• {composer: ...} Jednotlivci, kteří napsali hudbu k písni. Tento seznam by měl být oddělen středníky pro jednotlivé hodnoty.
• {lyricist: ...} Jednotlivci, kteří napsali text písně. Tento seznam by měl být oddělen středníky pro jednotlivé hodnoty.

Inline 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 akordických diagramů. Viz Definování akordů pro více informací.
• {comment: ...} nebo {c: ...}} Definuje komentář a zobrazuje se jako hudební pokyn.
• {comment_bold: ...} nebo {cb: ...}} Definuje text, který se zobrazí tučně.
• {comment_italic: ...} nebo {ci: ...}} Definuje text, který se zobrazí jako kurzíva.
• {guitar_comment: ...} nebo {gc: ...}} Definuje komentář, který se zobrazí jako hudební pokyn.
• {start_of_verse: ..}} nebo {sov}} Deklaruje začátek sekce verše s volitelným popisem sekce.
• {end_of_verse}} nebo {eov}} Deklaruje konec sekce verše.
• {start_of_chorus: ...}} nebo {soc}} Deklaruje začátek sekce chóru s volitelným popisem sekce.
• {end_of_chorus}} nebo {eoc}} Deklaruje konec sekce chóru.
• {start_of_bridge: ...}} nebo {sob}} Deklaruje začátek sekce mostu s volitelným popisem sekce.
• {end_of_bridge}} nebo {eob}} Deklaruje konec sekce mostu.
• {start_of_part: ..}} nebo {sop}} Deklaruje začátek části s volitelným popisem sekce.
• {end_of_part}} nebo {eop}} Deklaruje konec části.
• {start_of_tab}} nebo {sot}} Deklaruje začátek tabulatury, kterou OnSong vykresluje monospaced fontem.
• {end_of_tab}} nebo {eot}} Deklaruje konec sekce tabulatury.
• {new_page}} nebo {np}} Toto se používá k deklaraci nové stránky.
• {new_physical_page}} nebo {npp}} Toto se používá 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 pro texty písní a akordy v akordickém diagramu.

• {textsize: ...} Definuje velikost textů písní jako číselnou hodnotu v bodech.
• {textfont: ...} Definuje název písma pro použití pro texty písní. Musí být na platformě podporován.
• {chordsize: ...} Definuje velikost akordů jako číselnou hodnotu v bodech.
• {chordfont: ...} Definuje název písma pro použití pro akordy. Musí být na platformě podporován.

Podporované příponky souborů

Formát souboru ChordPro je jedinečný v tom, že je běžně dohodnutou syntaxí, ale nikoli standardním formátem. To znamená, že různí výrobci 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ů v chordpro formátu:

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