Benutzerhandbuch
ChordPro
Das ChordPro-Dateiformat ist ein häufig verwendetes Format in anderen Softwareanwendungen. OnSong versteht dieses Format nativ. OnSong erkennt Dateien mit den folgenden Dateiendungen: .chordpro, .chopro, .cho, .crd, .pro
Das ChordPro-Format ermöglicht es, Songinformationen in Tags auszudrücken, die durch geschweifte Klammern begrenzt sind. Diese Informationen können logisch in Metadaten-Tags und Inline-Tags unterteilt werden.
Metadaten-Tags
Dies sind ChordPro-Tags, die Sie im Metadatenabschnitt des Songs verwenden würden. In den folgenden Tags stellen drei Punkte (...) den Text dar, den Sie eingeben, der zwischen dem Doppelpunkt und der schließenden geschwungenen Klammer steht. Zum Beispiel:
{title: Amazing Grace}
{key: G}
OnSong unterstützt die folgenden ChordPro-Tags:
- {title: ...} oder {t: ...} Der Titel des Songs.
- {subtitle: ...}, {st: ...} oder {su: ...} Der Künstlername oder andere Zusatzinformationen. Sie können mehrere Künstler angeben, indem Sie Namen mit einem Semikolon trennen. - Kim Walker-Smith; Chris Quilala
- {album: ...} Der Name des Albums, in dem sich der Song befindet.
- {artist: ...} oder {a: ...} Der Künstlername oder andere Zusatzinformationen. Sie können mehrere Künstler angeben, indem Sie Namen mit einem Semikolon trennen. - Kim Walker-Smith; Chris Quilala
- {author: ...} Der Name der Person, die das Akkorddiagramm erstellt hat. Dies wird am unteren Rand des Akkorddiagramms und in der Liedtext-Projektion angezeigt.
- {key: ...} oder {k: ...} oder {ok: ...} Die Tonart des Songs geschrieben als Tonart mit enharmonischer Voreinstellung und einem optionalen „m" zur Angabe von Moll. - alphabetisch, z. B. Bb oder Em
- {capo: ...} Der Kapodaster als Anzahl der Bünde - numerisch
- {tempo: ...} Die Schläge pro Minute (BPM) - numerisch
- {time: ...} Das Taktmaß - numerischer Schlag über Takt, z. B. 3/4
- {duration: ...} Die Songlänge für automatisches Scrollen - Sekunden oder mm:ss
- {book: ...} Der Name des Buches oder der Bücher, in das der Song eingefügt werden soll. Dies ist eine durch Kommas begrenzte Liste von Buchnamen, in die der Song eingefügt wird. Wenn das Buch nicht vorhanden ist, wird es automatisch erstellt.
- {number: ...} Die Nummer des Songs - numerisch, verwenden Sie es für Hymnen, Jahre usw. Sie können Songs nach der Nummer sortieren.
- {flow: ...} Die Anordnung von Abschnitten - Liste von Abschnittsetiketten. Siehe Flow für Details zur Anordnung des Song-Flusses.
- {midi: ...} Die MIDI-Befehle, die beim Anzeigen des Songs gesendet werden sollen. Siehe MIDI-Syntax für Informationen zum Ausdrücken von MIDI-Befehlen als Text in OnSong.
- {midi-index: ...} Die MIDI-Befehle, die diesen Song im Song-Viewer öffnen. Siehe MIDI-Syntax für Informationen zum Ausdrücken von MIDI-Befehlen als Text in OnSong.
- {pitch: ...} Die Noten, die bei Verwendung der Funktion Stimmgabel gespielt werden sollen.
- {keywords: ...} oder {topic: ...} Die Liste der Tags für die Themensuche. Siehe Themen für weitere Informationen zum Durchsuchen nach Themen.
- {copyright: ...} oder {footer: ...} oder {f: ...} Gibt den Copyright-Fußzeilentext an, der am unteren Rand der Seite oder der Liedtext-Projektion angezeigt wird.
- {ccli: ...} Die CCLI-Nummer des Songs.
- {restrictions: ...} Die Rechteverwaltung für die durch Kommas begrenzte Liste der Einschränkungen des Songs. Siehe „Restrictions" für Details zum Festlegen von Einschränkungen für Ihren Song.
- {composer: ...} Die Personen, die die Musik zum Song geschrieben haben. Diese Liste sollte mit Semikolons für separate Werte getrennt werden.
- {lyricist: ...} Die Personen, die die Texte des Songs geschrieben haben. Diese Liste sollte mit Semikolons für separate Werte getrennt werden.
Inline-Tags
Diese Tags werden innerhalb des Inhalts des Songs verwendet und können entweder zum Definieren von Abschnitten oder zum Formatieren von Teilen des Songs verwendet werden.
- {define: ...} wird verwendet, um benutzerdefinierte Akkorddiagramme zu definieren. Siehe Akkorde definieren für weitere Informationen.
- {comment: ...} oder {c: ...} Definiert einen Kommentar und wird als musikalische Anweisung angezeigt.
- {comment_bold: ...} oder {cb: ...} Definiert Text, der fett angezeigt werden soll.
- {comment_italic: ...} oder {ci: ...} Definiert Text, der kursiv angezeigt werden soll.
- {guitar_comment: ...} oder {gc: ...} Definiert einen Kommentar, der als musikalische Anweisung angezeigt wird.
- {start_of_verse: ...} oder {sov} Deklariert den Anfang eines Vers-Abschnitts mit einem optionalen Abschnittsetikett.
- {end_of_verse} oder {eov} Deklariert das Ende eines Vers-Abschnitts.
- {start_of_chorus: ...} oder {soc} Deklariert den Anfang eines Refrain-Abschnitts mit einem optionalen Abschnittsetikett.
- {end_of_chorus} oder {eoc} Deklariert das Ende eines Refrain-Abschnitts.
- {start_of_bridge: ...} oder {sob} Deklariert den Anfang eines Bridge-Abschnitts mit einem optionalen Abschnittsetikett.
- {end_of_bridge} oder {eob} Deklariert das Ende eines Bridge-Abschnitts.
- {start_of_part: ...} oder {sop} Deklariert den Anfang eines Teils mit einem optionalen Abschnittsetikett.
- {end_of_part} oder {eop} Deklariert das Ende eines Teils.
- {start_of_tab} oder {sot} Deklariert den Anfang einer Tabulatur, die OnSong in einer Monospaced-Schrift rendert.
- {end_of_tab} oder {eot} Deklariert das Ende eines Tabulatur-Abschnitts.
- {new_page} oder {np} Dies wird verwendet, um eine neue Seite zu deklarieren.
- {new_physical_page} oder {npp} Dies wird verwendet, um eine neue Seite zu deklarieren.
Formatierungs-Tags
Die folgenden Tags werden verwendet, um die Standardschriftart und -größe für Liedtexte und Akkorde im Akkorddiagramm zu definieren.
- {textsize: ...} Definiert die Größe der Liedtexte als numerischer Wert in Punkten.
- {textfont: ...} Definiert den Namen der Schriftart für Liedtexte. Muss auf der Plattform unterstützt werden.
- {chordsize: ...} Definiert die Größe der Akkorde als numerischer Wert in Punkten.
- {chordfont: ...} Definiert den Namen der Schriftart für Akkorde. Muss auf der Plattform unterstützt werden.
Unterstützte Dateierweiterungen
Das ChordPro-Dateiformat ist insofern einzigartig, als es eine allgemein vereinbarte Syntax, aber kein Standardformat ist. Dies bedeutet, dass verschiedene Anbieter es auf unterschiedliche Weise und mit unterschiedlichen Dateierweiterungen implementieren können. OnSong unterstützt die folgenden Dateierweiterungen beim Importieren von ChordPro-formatierten Dateien:
- .chopro
- .cho
- .chordpro
- .crd
- .pro
- .cpm