Metadane

Metaznaczniki to sposób na podanie informacji o utworze i wyrażane są w sekcji metadanych. Metadane wyrażane są w pierwszej sekcji utworu przed pierwszą pustą linią lub dopóki nie napotka się więcej metaznaczników. Metaznaczniki to pary nazwa/wartość, gdzie nazwa znajduje się po lewej stronie, a wartość po prawej stronie, oddzielone dwukropkiem. Na jednej linii może pojawić się tylko jeden metaznacznik. Aby uzyskać szczegóły dotyczące wyrażania metadanych w formacie ChordPro, zapoznaj się z formatem pliku ChordPro.

OnSong automatycznie przypisuje pierwszą linię pliku tekstowego jako tytuł utworu, jeśli nie jest w formacie metaznacznika. Ponadto druga linia uważana jest za artystę/podpis utworu, chyba że zdefiniowany jest metaznacznik. Poniżej znajduje się przykład typowej sekcji metadanych utworu, która ustawia tytuł i artystę jako pierwszą i drugą linię, a także tonację i tempo.

Amazing Grace
Daniel Thomas
Key: D
Tempo: 76

Lyrics and chords start here...

Znaczniki metadanych

Następujące znaczniki są obsługiwane przez OnSong:

• Tytuł: Tytuł utworu. Można to również wyrazić w pierwszej linii zawartości utworu.
• Artysta: Nazwa artysty lub inne informacje o podpisie. Można to również wyrazić w drugiej linii zawartości utworu. Możesz określić wielu artystów, oddzielając ich nazwy średnikiem. - Kim Walker-Smith; Chris Quilala
• Autor: Nazwa osoby, która utworzyła mapę akordów. Jest wyświetlany na dole mapy akordów i w projekcji tekstu.
• Tonacja: Tonacja utworu zapisana jako tonacja z preferencją enharmoniczną i opcjonalnym „m" wskazującym durową. - alfabetycznie, np. Bb lub Em
• TransposedKey: Pożądana tonacja, w której utwór powinien być grany, która może różnić się od tonacji, w której utwór został napisany. - alfabetycznie, np. Bb lub Em
• In: pseudonim dla znacznika metadanych transponowanej tonacji.
• Capo: Kapo do ustawienia jako liczba progów. Jest to zwykle dodatnia liczba całkowita (od 1 do 11), ale może również być ujemną liczbą całkowitą. - numerycznie
• Tempo: Liczba uderzeń na minutę (BPM). - numerycznie
• Metrum: Metrum taktowe. - liczba numeryczna nad taktem, np. 3/4
• Czas trwania: Długość utworu dla autoscrollu. - sekundy lub mm:ss
• Książka: Nazwa książki lub książek, w których ma być umieszczony utwór. Jest to lista oddzielona przecinkami nazw książek, w których utwór zostanie umieszczony. Jeśli książka nie istnieje, zostanie automatycznie utworzona.
• Numer: Numer utworu - numerycznie. Użyj dla hymnów, lat itp. Możesz sortować utwory według numeru do celów referencyjnych.
• Flow: Układ sekcji. - lista etykiet sekcji. Szczegóły na temat aranżacji przepływu utworu znajdują się w Flow.
• MIDI: Polecenia MIDI do wysłania po wyświetleniu utworu. Szczegóły dotyczące wyrażania poleceń MIDI jako tekstu w OnSong znajdują się w składni MIDI.
• MIDI-Index: Polecenia MIDI, które wyzwolą otwarcie tego utworu w przeglądarce utworów. Szczegóły dotyczące wyrażania poleceń MIDI jako tekstu w OnSong znajdują się w składni MIDI.
• Słowa kluczowe: lub Temat: Lista znaczników do użytku przy wyszukiwaniu tematycznym. Więcej informacji na temat przeglądania wg tematu znajduje się w Tematy.
• Prawa autorskie: lub Stopka: lub f: Informacje o prawach autorskich do utworu. Pojawi się to na dole mapy akordów i projekcji tekstu.
• CCLI: Numer CCLI utworu. Pojawi się to na dole mapy akordów i projekcji tekstu.
• Ograniczenia: To są ograniczenia, które zapobiegają wykonywaniu określonych działań w ramach utworu. Szczegóły na temat ustawiania ograniczeń dla Twojego utworu znajdują się w Ograniczeniach.
• Tonacja: Nuta lub nuty do zagrania przy użyciu funkcji Stroik. Definiuje się to jako listę nut oddzielonych spacją z opcjonalnymi oktawami. - np. A3 C#4 E5
• Podział: lub Uderzenie: pozwala wybrać podział dla utworu. Może to być wartość obejmująca: whole, half, quarter, eighth, shuffle lub sixteenth. Alternatywnie możesz użyć liczby całkowitej, takiej jak 1, 2, 4, 8 lub 16.
• Transponuj: Liczba półtonów do transponowania utworu. Jest to używane w środku utworu do modulacji utworu w górę lub w dół i dostosowuje się do tonacji ustawionej w suwakami transponowania. Ta liczba musi być dodatnią lub ujemną liczbą całkowitą.
• Scena: Scena do odtworzenia po załadowaniu utworu. Można to ustawić, wprowadzając nazwę sceny po dwukropku.

Znaczniki wbudowane

Niektóre znaczniki można używać w ramach utworu, aby wpływać na transponowanie w środku utworu. Obejmują:

• Capo: może być używany do zastosowania kapo w środku utworu, modulując utwór w dół, aby zapewnić akordy do grania z zastosowanym kapo. Możesz dostosować kierunek modulacji w Ustawieniach kapo. Jest to zwykle dodatnia liczba całkowita (od 1 do 11), ale może również być ujemną liczbą całkowitą, aby usunąć poprzednie kapo. - numerycznie
• Tonacja: aby wyraźnie ustawić tonację w utworze. Jeśli otoczyć wartość nawiasami przy użyciu nawiasów w akordach, wynikowa tonacja będzie również transponowana. - alfabetycznie, np. Bb lub Em
• Transponuj: transponuje utwór do pożądanej liczby półtonów. To dodatnia lub ujemna liczba całkowita. Na przykład użyj 2 lub +2, aby transponować utwór w górę o cały krok, lub użyj -3, aby transponować w dół o trzy półtony. - numerycznie

Znaczniki sekcji

Niektóre znaczniki mogą być używane do dostarczania informacji o każdej sekcji utworu. Obejmują:

• MIDI: Polecenia MIDI do wysłania po wybraniu sekcji. Szczegóły dotyczące wyrażania poleceń MIDI jako tekstu w OnSong znajdują się w składni MIDI.
• Scena: Scena do odtworzenia po wybraniu sekcji. Można to ustawić, wprowadzając nazwę sceny po dwukropku.

Uwaga: Metaznaczniki nie rozróżniają wielkości liter