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í prázdným řádkem nebo dokud nejsou nalezeny žádné další metatags. Metatags jsou páry název/hodnota, kde je název na levé straně a hodnota na pravé straně oddělené dvojtečkou. Na každém řádku se může objevit pouze jeden metatag. Podrobnosti o vyjádření metadat ve formátu ChordPro naleznete v dokumentaci ChordPro File Format.

OnSong automaticky přiřadí první řádek textového souboru jako název písně, pokud není ve formátu metatagu. Navíc druhý řádek se považuje za interpreta/podpis písně, pokud není definován metatag. Následuje příklad typické sekce 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...

Značky metadat

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

• Title: Název písně. To lze také vyjádřit na prvním řádku obsahu písně.
• Artist: Jméno interpreta nebo jakékoli další informace o podpisu. To lze také vyjádřit na druhém řádku obsahu písně. Lze zadat více interpretů oddělením jmen středníkem. - Kim Walker-Smith; Chris Quilala
• Author: Jméno osoby, která vytvořila schéma akordů. Toto je zobrazeno v dolní části schéma 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é by měla být píseň hrána, která se může lišit od tóniny, ve které je píseň napsána. - abecední, např. Bb nebo Em
• In: je synonymum pro značku metadat transponované tóniny.
• Capo: Kapo nastavené jako počet pražců. Obvykle se jedná o kladné celé číslo (1 až 11), ale může být také záporné celé číslo. - číselné
• Tempo: Počet úderů za minutu (BPM). - číselné
• Time: Takt. - číselné údaje nad taktovou čárou, např. 3/4
• Duration: Délka písně pro automatické posunování. - sekundy nebo mm:ss
• Book: Název knihy nebo knih, do kterých má být píseň zařazena. Jedná se o seznam názvů knih oddělených čárkami, do kterých bude píseň zařazena. Pokud kniha neexistuje, bude automaticky vytvořena.
• Number: Číslo písně - číselné. Používá se pro hymny, roky atd. Písně můžete řadit podle čísla pro referenci.
• Flow: Uspořádání sekcí. - seznam názvů sekcí. Podrobnosti o uspořádání průběhu písně naleznete v dokumentaci 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 dokumentaci MIDI Syntax.
• MIDI-Index: MIDI příkazy, které budou vyvolány k otevření této písně v Prohlížeči písní. Podrobnosti o vyjádření MIDI příkazů jako text v OnSong naleznete v dokumentaci MIDI Syntax.
• Keywords: nebo Topic: Seznam značek pro použití při hledání podle tématu. Další informace o procházení podle tématu naleznete v dokumentaci Topics.
• Copyright: nebo Footer: nebo f: Informace o autorských právech písně. Tyto informace se budou zobrazovat v dolní části schéma akordů a projekce textů.
• CCLI: Číslo CCLI písně. Toto se bude zobrazovat v dolní části schéma akordů a projekce textů.
• Restrictions: Jedná se o omezení, která zabraňují určitým akcím v písni. Podrobnosti o nastavení omezení pro vaši píseň naleznete v dokumentaci Restrictions.
• Pitch: Nota nebo noty, které se mají přehrát při používání funkce Pitch Pipe. Toto je definováno jako seznam not oddělených mezerou s volitelnou oktávou. - např. A3 C#4 E5
• Subdivision: nebo Beat: umožňuje zvolit rozdělení pro píseň. Puede ser un valor como: whole, half, quarter, eighth, shuffle, nebo sixteenth. Případně můžete použít celé číslo jako 1, 2, 4, 8 nebo 16.
• Transpose: Počet půltónů pro transpozici písně. 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.
• Scene: Scéna, která se má přehrát při načtení písně. Toto lze nastavit zadáním názvu scény za dvojtečkou.

Vložené značky

Některé značky lze použít v písni k ovlivnění transpozice uprostřed písně. Patří sem:

• Capo: lze použít k aplikaci kapo uprostřed písně, modulaci písně dolů a zajištění akordů k hraní s aplikovaným kapo. Směr modulace si můžete nastavit v Nastavení kapo. Obvykle se jedná o kladné celé číslo (1 až 11), ale může být také záporné celé číslo pro odstranění předchozího kapo. - číselné
• Key: k explicitnímu nastavení tóniny v písni. Pokud obklopíte hodnotu hranatými závorkami při používání hranatých akordů, výsledná tónina bude také transponována. - abecední, např. Bb nebo Em
• Transpose: transponuje píseň požadovaným počtem půltónů. Jedná se o kladné nebo záporné celé číslo. Například použijte 2 nebo +2 pro transpozici písně nahoru o celý tón, nebo použijte -3 pro transpozici dolů o tři půltóny. - číselné

Značky sekcí

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

• MIDI: MIDI příkazy k odeslání při výběru sekce. Podrobnosti o vyjádření MIDI příkazů jako text v OnSong naleznete v dokumentaci MIDI Syntax.
• Scene: Scéna, která se má přehrát při výběru sekce. Toto lze nastavit zadáním názvu scény za dvojtečkou.

Poznámka: Metatags nerozlišují velikost písmen