Metadata

Metatags jsou způsob, jak poskytnout informace o písni a jsou vyjádřeny v sekci metadat. Metadata se vyskytují v první sekci písně před prvním prázdným řádkem nebo dokud se nesetkáte s dalšími metatagů. Metatags jsou páry název/hodnota, kde je název vlevo a hodnota vpravo oddělené dvojtečkou. Na jednom řádku se může vyskytovat pouze jeden metatag. Podrobnosti o tom, jak vyjádřit metadata ve formátu ChordPro, naleznete v dokumentaci Formát 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 je druhý řádek považován za umělce/podpis písně, pokud není definován metatag. Následuje příklad typické sekce metadat písně, která nastavuje název a umělce jako první a druhý řádek, stejně jako tóninu a tempo.

Amazing Grace
Daniel Thomas
Key: D
Tempo: 76

Lyrics and chords start here...

Tagy metadat

Následující tagy jsou podporovány aplikací OnSong:

• Title: Název písně. Lze jej také vyjádřit na prvním řádku obsahu písně.
• Artist: Jméno umělce nebo jakékoli další informace o podpisu. Lze jej také vyjádřit na druhém řádku obsahu písně. Více umělců lze zadat oddělením jejich jmen středníkem. - Kim Walker-Smith; Chris Quilala
• Author: Jméno osoby, která vytvořila tabulaturu akordů. Zobrazuje se v dolní části tabulatury akordů a v projekci textů.
• Key: Tónina písně zapsaná jako tónina s enharmonickou preferencí a volitelným „m" označujícím moll. - abecední, např. Bb nebo Em
• TransposedKey: Požadovaná tónina, ve které má být píseň hrána, což se může lišit od tóniny, ve které je píseň napsána. - abecední, např. Bb nebo Em
• In: je synonymem pro tag metadat transponované tóniny.
• Capo: Kapo nastavené jako počet pražců. Obvykle se jedná o kladné celé číslo (1 až 11), ale lze jej také nastavit na záporné celé číslo. - číselné
• Tempo: Tempu v údajích za minutu (BPM). - číselné
• Time: Taktový údaj. - číselné, čitatel/jmenovatel, např. 3/4
• Duration: Délka písně pro automatické posunutí. - sekundy nebo mm:ss
• Book: Název knihy nebo knih, do kterých má být píseň vložena. Jedná se o seznam názvů knih oddělený čárkami, do kterých bude píseň vložena. Pokud kniha neexistuje, bude automaticky vytvořena.
• Number: Číslo písně - číselné. Použijte pro hymny, roky atd. Písně můžete řadit podle čísla pro orientaci.
• Flow: Uspořádání sekcí. - seznam jmenovek sekcí. Podrobnosti o uspořádání toku písně naleznete v sekci Flow.
• MIDI: Příkazy MIDI, které se mají odeslat, když je píseň zobrazena. Informace o tom, jak vyjádřit příkazy MIDI jako text v OnSong, naleznete v sekci MIDI Syntax.
• 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 sekci MIDI Syntax.
• Keywords: nebo Topic: Seznam jmenovek, které se mají použít při hledání podle tématu. Další informace o procházení podle tématu naleznete v sekci Topics.
• Copyright: nebo Footer: nebo f: Informace o autorských právech k písni. 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ů.
• Restrictions: Jedná se o omezení, která brání určitým akcím v rámci písně. Podrobnosti o nastavení omezení pro vaši píseň naleznete v sekci Restrictions.
• Pitch: Nota nebo noty, které mají být přehrány při použití funkce Pitch Pipe. Definuje se jako seznam not oddělených mezerami s volitelným oktávovým číslem. - např. A3 C#4 E5
• Subdivision: nebo Beat: umožňuje vybrat rozdělení pro píseň. Může to být hodnota zahrnující: whole, half, quarter, eighth, shuffle nebo sixteenth. Alternativně můžete použít celé číslo jako 1, 2, 4, 8 nebo 16.
• Transpose: Počet půltónů, o které mají být transponovány noty v písni. Používá se uprostřed písně k modulaci písně nahoru nebo dolů a přizpůsobuje se tónině nastavené v posuvnících transpozice. Toto číslo musí být kladné nebo záporné celé číslo.
• Tuning: Ladění nástroje, které se má přiřadit k písni. Ty jsou specifické pro nástroj a v současné době jsou podporovány pouze pro kytaru 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.
• Scene: Scéna, která se má přehrát při 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í transpozice uprostřed písně. Patří sem:

• Capo: lze použít k aplikaci kapo uprostřed písně, aby se modulovala dolů a poskytla akordy, které se mají hrát s aplikovaným kapo. Směr modulace můžete upravit v sekci Capo Settings. Obvykle se jedná o kladné celé číslo (1 až 11), ale lze jej také nastavit na záporné celé číslo pro odstranění předchozího kapo. - číselné
• Key: pro explicitní nastavení tóniny v písni. Pokud obklopíte hodnotu hranatými závorkami při použití hranatých akordů, výsledná tónina bude také transponována. - abecední, např. Bb nebo Em
• Transpose: transponuje píseň o požadovaný počet půltónů. Jedná se o kladné nebo záporné celé číslo. Pokud chcete například transponovat píseň nahoru o celočíslený tón, použijte 2 nebo +2, nebo použijte -3 pro transponování dolů o tři půltóny. - číselné

Tagy sekcí

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

• MIDI: Příkazy MIDI, které se mají odeslat, když je sekce vybrána. Informace o tom, jak vyjádřit příkazy MIDI jako text v OnSong, naleznete v sekci MIDI Syntax.
• Scene: 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 nerozlišují velikost písmen