Benutzerhandbuch
Metadaten
Metatags sind eine Möglichkeit, Informationen über einen Song bereitzustellen und werden in einem Metadaten-Bereich ausgedrückt. Metadaten werden im ersten Bereich des Songs vor der ersten Leerzeile oder bis keine weiteren Metatags mehr gefunden werden ausgedrückt. Metatags sind Name/Wert-Paare, wobei der Name auf der linken Seite und der Wert auf der rechten Seite durch einen Doppelpunkt getrennt sind. Pro Zeile kann nur ein Metatag erscheinen. Bitte beachten Sie die ChordPro-Dateiformat für Details zur Ausdrucksweise von Metadaten im ChordPro-Format.
OnSong weist automatisch die erste Zeile einer Textdatei als Songtitel zu, wenn sie nicht im Metatag-Format vorliegt. Darüber hinaus wird die zweite Zeile als Künstler/Byline des Songs betrachtet, es sei denn, es ist ein Metatag definiert. Das folgende Beispiel zeigt einen typischen Song-Metadaten-Bereich, der den Titel und den Künstler in der ersten und zweiten Zeile sowie die Tonart und das Tempo festlegt.
Amazing Grace
Daniel Thomas
Key: D
Tempo: 76
Lyrics and chords start here...
Metadaten-Tags
Die folgenden Tags werden von OnSong unterstützt:
- Titel: Der Titel des Songs. Dies kann auch in der ersten Zeile des Songinhalts ausgedrückt werden.
- Künstler: Der Künstlername oder andere Byline-Informationen. Dies kann auch in der zweiten Zeile des Songinhalts ausgedrückt werden. Sie können mehrere Künstler angeben, indem Sie Namen mit einem Semikolon trennen. - Kim Walker-Smith; Chris Quilala
- Autor: Der Name der Person, die das Akkorddiagramm erstellt hat. Dies wird unten im Akkorddiagramm und in der Liedtext-Projektion angezeigt.
- Tonart: Die Tonart des Songs, geschrieben als Tonart mit enharmonischer Präferenz und einem optionalen „m" zur Angabe von Moll. - alphabetisch, z. B. Bb oder Em
- TransposedKey: Die gewünschte Tonart, in der der Song gespielt werden soll, die sich von der Tonart unterscheiden kann, in der der Song geschrieben ist. - alphabetisch, z. B. Bb oder Em
- In: ist ein Synonym für das Metadaten-Tag der transponierten Tonart.
- Capo: Das Capo, das als Anzahl der Bünde eingestellt werden soll. Dies ist typischerweise eine positive ganze Zahl (1 bis 11), kann aber auch eine negative ganze Zahl sein. - numerisch
- Tempo: Die Schläge pro Minute (BPM). - numerisch
- Zeit: Die Taktart. - numerischer Schlag über Takt, z. B. 3/4
- Dauer: Die Songlänge für das automatische Scrollen. - Sekunden oder mm:ss
- Buch: Der Name des Buchs oder der Bücher, in die der Song eingeordnet werden soll. Dies ist eine durch Kommas getrennte Liste von Büchnamen, in die der Song eingefügt wird. Wenn das Buch nicht existiert, wird es automatisch erstellt.
- Nummer: Die Nummer des Songs - numerisch. Verwenden Sie diese für Hymnen, Jahre usw. Sie können Songs nach der Nummer sortieren.
- Ablauf: Die Anordnung der Abschnitte. - Liste von Abschnittsetiketten. Siehe Ablauf für Details zur Anordnung des Ablaufs eines Songs.
- MIDI: Die MIDI-Befehle, die gesendet werden, wenn der Song angezeigt wird. Siehe MIDI-Syntax für Informationen zum Ausdrücken von MIDI-Befehlen als Text in OnSong.
- MIDI-Index: Die MIDI-Befehle, die das Öffnen dieses Songs im Song-Viewer auslösen. Siehe MIDI-Syntax für Informationen zum Ausdrücken von MIDI-Befehlen als Text in OnSong.
- Stichwörter: oder Thema: Die Liste der Tags zur Verwendung mit der Themensuche. Siehe Themen für weitere Informationen zum Durchsuchen nach Thema.
- Urheberrecht: oder Fußzeile: oder f: Die Urheberrechtsinformationen des Songs. Diese werden unten im Akkorddiagramm und in der Liedtext-Projektion angezeigt.
- CCLI: Die CCLI-Nummer des Songs. Diese wird unten im Akkorddiagramm und in der Liedtext-Projektion angezeigt.
- Einschränkungen: Dies sind Einschränkungen, die verhindern, dass bestimmte Aktionen innerhalb eines Songs stattfinden. Siehe Einschränkungen für Details zum Festlegen von Einschränkungen für Ihren Song.
- Tonhöhe: Die Note oder Noten, die bei Verwendung der Pitch Pipe-Funktion gespielt werden sollen. Dies wird als eine Leerzeichen-getrennte Liste von Noten mit optionalen Oktaven definiert. - z. B. A3 C#4 E5
- Unterteilung: oder Schlag: können Sie die Unterteilung für den Song wählen. Dies kann ein Wert sein, einschließlich: ganz, halb, viertel, achtel, shuffle oder sechzehntel. Alternativ können Sie eine ganze Zahl wie 1, 2, 4, 8 oder 16 verwenden.
- Transponieren: Die Anzahl der Halbtöne zum Transponieren des Songs. Dies wird verwendet, um den Song während des Songs zu modulieren und passt sich an die Tonart an, die in den Transpositionsreglern festgelegt ist. Diese Zahl muss eine positive oder negative ganze Zahl sein.
- Stimmung: Die Instrumentenstimmung, die dem Song zugewiesen werden soll. Diese sind instrumentenspezifisch und derzeit wird nur Gitarre mit diesen Werten unterstützt: Standard, Keltisch, Drop D, Drop DD, Drop C, Drop B, Drop A, Open C, Open D, Open G oder Open E.
- Szene: Die Szene, die beim Laden des Songs abgespielt werden soll. Dies kann durch Eingabe des Szennamens nach dem Doppelpunkt eingestellt werden.
Inline-Tags
Einige Tags können innerhalb eines Songs verwendet werden, um die Transposition während des Songs zu beeinflussen. Diese beinhalten:
- Capo: kann verwendet werden, um ein Capo während des Songs anzubringen und den Song zu modulieren, um Akkorde mit dem angebrachten Capo zu spielen. Sie können die Modulationsrichtung in den Capo-Einstellungen anpassen. Dies ist typischerweise eine positive ganze Zahl (1 bis 11), kann aber auch eine negative ganze Zahl sein, um ein vorheriges Capo zu entfernen. - numerisch
- Tonart: um die Tonart explizit im Song festzulegen. Wenn Sie den Wert mit Klammern umgeben, wenn Sie eingeklammerte Akkorde verwenden, wird die resultierende Tonart ebenfalls transponiert. - alphabetisch, z. B. Bb oder Em
- Transponieren: transponiert den Song um die gewünschte Anzahl von Halbtönen. Dies ist eine positive oder negative ganze Zahl. Verwenden Sie beispielsweise 2 oder +2, um den Song um einen ganzen Schritt nach oben zu transponieren, oder verwenden Sie -3, um drei Halbtöne nach unten zu transponieren. - numerisch
Abschnitt-Tags
Einige Tags können verwendet werden, um Informationen zu den einzelnen Abschnitten eines Songs bereitzustellen. Diese beinhalten:
- MIDI: Die MIDI-Befehle, die gesendet werden, wenn der Abschnitt ausgewählt wird. Siehe MIDI-Syntax für Informationen zum Ausdrücken von MIDI-Befehlen als Text in OnSong.
- Szene: Die Szene, die abgespielt werden soll, wenn der Abschnitt ausgewählt wird. Dies kann durch Eingabe des Szennamens nach dem Doppelpunkt eingestellt werden.
Hinweis: Metatags sind nicht case-sensitiv