Metadata

Metatags jsou způsob, jak poskytnout informace o písni, a jsou vyjádřeny v sekci metadat. Metadata jsou vyjádřena v první sekci písně před prvním prázdným řádkem nebo dokud nejsou nalezeny žádné další metatags. Metatags jsou páry název/hodnota, kde je název vlevo a hodnota vpravo oddělena dvojtečkou. Na jeden řádek může být uveden pouze jeden metatag. Podrobnosti o tom, jak vyjádřit metadata ve formátu ChordPro, naleznete v Formátu souboru ChordPro.

OnSong automaticky přiřadí první řádek textového souboru jako název písně, pokud není ve formátu metatagu. Kromě toho se druhý řádek považuje za interpreta/podtitul písně, pokud není definován metatag. Následující příklad ukazuje typickou sekci metadat písně, která nastavuje název a interpreta jako první a druhý řádek, stejně jako tóninu a tempo.

Amazing Grace
Daniel Thomas
Key: D
Tempo: 76

Lyrics and chords start here...

Metatags

OnSong podporuje následující metatags:

• Název: Název písně. Lze jej také vyjádřit na prvním řádku obsahu písně.
• Interpret: Jméno interpreta nebo jakýchkoli dalších informací o podtitulu. Lze jej také vyjádřit na druhém řádku obsahu písně. Můžete zadat více interpretů oddělením jmen středníkem. - Kim Walker-Smith; Chris Quilala
• Autor: Jméno osoby, která vytvořila tabulaturu akordů. Zobrazuje se v dolní části tabulatury akordů a v projekci textů.
• Tónina: Tónina písně zapsaná jako tónina s enharmonickou preferencí a volitelným "m" pro označení moll. - abecední, např. Bb nebo Em
• TransposedKey: Požadovaná tónina, ve které by měla být píseň hraná, která se může lišit od tóniny, ve které je píseň napsána. - abecední, např. Bb nebo Em
• In: je synonymem pro metatag transponované tóniny.
• Capo: Capo nastavený jako počet pražců. Toto je obvykle kladné celé číslo (1 až 11), ale může být také záporné celé číslo. - numerické
• Tempo: Úder za minutu (BPM). - numerické
• Takt: Označení taktu. - numerické, údaj nad taktem, např. 3/4
• Trvání: Délka písně pro automatické posunutí. - sekundy nebo mm:ss
• Kniha: Název knihy nebo knih, do kterých má být píseň zařazena. Jedná se o seznam oddělený čárkami, do kterého bude píseň zařazena. Pokud kniha neexistuje, bude automaticky vytvořena.
• Číslo: Číslo písně - numerické. Používejte pro hymny, roky atd. Písně můžete seřadit podle čísla jako referenci.
• Tok: Uspořádání sekcí. - seznam štítků sekcí. Podrobnosti o uspořádání toku písně najdete v Tok.
• MIDI: Příkazy MIDI, které se mají odeslat při zobrazení písně. Informace o tom, jak vyjádřit příkazy MIDI jako text v OnSong, naleznete v MIDI Syntaxi.
• MIDI-Index: Příkazy MIDI, které otevřou tuto píseň v Prohlížeči písní. Informace o tom, jak vyjádřit příkazy MIDI jako text v OnSong, naleznete v MIDI Syntaxi.
• Klíčová slova: nebo Téma: Seznam štítků pro vyhledávání podle tématu. Další informace o procházení podle tématu najdete v Témata.
• Copyright: nebo Zápatí: nebo f: Informace o copyrightu písně. Bude se zobrazovat v dolní části tabulatury akordů a projekce textů.
• CCLI: Číslo CCLI písně. Bude se zobrazovat v dolní části tabulatury akordů a projekce textů.
• Omezení: Jedná se o omezení, která zabraňují určitým akcím v rámci písně. Podrobnosti o nastavení omezení pro vaši píseň najdete v Omezení.
• Výška tónu: Nota nebo noty, které se budou přehrávat při použití funkce Ladička. Definuje se jako seznam not oddělených mezerou s volitelnými oktávami. - např. A3 C#4 E5
• Rozdělení: nebo Tah: vám umožňuje zvolit rozdělení pro píseň. Může to být hodnota včetně: whole, half, quarter, eighth, shuffle, nebo sixteenth. Alternativně můžete použít celé číslo jako 1, 2, 4, 8, nebo 16.
• Transponovat: Počet půltónů, o které se má píseň transponovat. Používá se uprostřed písně k modulaci písně nahoru nebo dolů a přizpůsobuje se tónině nastavené v posuvníkech transponování. Toto číslo musí být kladné nebo záporné celé číslo.
• Ladění: Ladění nástroje, které se má přiřadit k písni. Jsou specifické pro nástroj a v současné době je podporována pouze kytara s těmito hodnotami: Standard, Celtic, Drop D, Drop DD, Drop C, Drop B, Drop A, Open C, Open D, Open G, nebo Open E.
• Scéna: Scéna, která se má přehrát po načtení písně. Lze ji nastavit zadáním názvu scény za dvojtečkou.

Vložené tagy

Některé tagy lze použít v rámci písně k ovlivnění transponování uprostřed písně. Patří mezi ně:

• Capo: lze použít k aplikaci capo uprostřed písně, k modulaci písně dolů a zajištění akordů k hraní s aplikovaným capem. Směr modulace můžete upravit v Nastavení Capo. Toto je obvykle kladné celé číslo (1 až 11), ale může být také záporné celé číslo pro odebrání předchozího capo. - numerické
• Tónina: explicitní nastavení tóniny v písni. Pokud obklopíte hodnotu hranatými závorkami při použití akordů v závorkách, bude výsledná tónina také transponována. - abecední, např. Bb nebo Em
• Transponovat: transponuje píseň o požadovaný počet půltónů. Toto je kladné nebo záporné celé číslo. Například použijte 2 nebo +2 k transponování písně o celý tón nahoru, nebo použijte -3 k transponování o tři půltóny dolů. - numerické

Štítky sekcí

Některé tagy lze použít k poskytnutí informací o každé sekci písně. Patří mezi ně:

• MIDI: Příkazy MIDI, které se mají odeslat při výběru sekce. Informace o tom, jak vyjádřit příkazy MIDI jako text v OnSong, naleznete v MIDI Syntaxi.
• Scéna: Scéna, která se má přehrát při výběru sekce. Lze ji nastavit zadáním názvu scény za dvojtečkou.

Poznámka: Metatags nejsou citlivé na velikost písmen