ChordPro

Das ChordPro-Dateiformat ist ein verbreitetes Format, das auch in anderen Softwareanwendungen verwendet wird. OnSong versteht dieses Format nativ. OnSong erkennt Dateien mit den folgenden Dateierweiterungen: .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 Metadaten-Bereich des Songs verwenden würden. Bei den folgenden Tags stellen drei Punkte (...) den Text dar, den Sie angeben und der zwischen dem Doppelpunkt und der schließenden geschweiften 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 Untertitelinformationen. Sie können mehrere Künstler angeben, indem Sie die Namen mit einem Semikolon trennen. - Kim Walker-Smith; Chris Quilala
• {album: ...} Der Name des Albums, auf dem sich der Song befindet.
• {artist: ...} oder {a: ...} Der Künstlername oder andere Untertitelinformationen. Sie können mehrere Künstler angeben, indem Sie die Namen mit einem Semikolon trennen. - Kim Walker-Smith; Chris Quilala
• {author: ...} Der Name der Person, die das Akkorddiagramm erstellt hat. Dies wird am unteren Ende des Akkorddiagramms und in der Lyriken-Projektion angezeigt.
• {key: ...} oder {k: ...} oder {ok: ...} Der Tonart des Songs geschrieben als Tonart mit enharmonischer Präferenz und einem optionalen „m" zur Angabe von Moll. - alphabetisch, z.B. Bb oder Em
• {capo: ...} Der Kapodaster als Bundanzahl - 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/die der Song eingefügt werden soll. Dies ist eine durch Kommas getrennte Liste von Buchnamen, in die der Song eingefügt wird. Wenn das Buch nicht existiert, wird es automatisch erstellt.
• {number: ...} Die Nummer des Songs - numerisch, verwenden Sie dies für Choräle, Jahre usw. Sie können Songs nach der Nummer zur Referenz sortieren.
• {flow: ...} Die Anordnung von Abschnitten – Liste von Abschnittsbeschriftungen. Weitere Informationen zum Anordnen des Songablaufs finden Sie unter Flow.
• {midi: ...} Die MIDI-Befehle, die gesendet werden, wenn der Song angezeigt wird. Unter MIDI-Syntax finden Sie Informationen zum Ausdrücken von MIDI-Befehlen als Text in OnSong.
• {midi-index: ...} Die MIDI-Befehle, die diesen Song in den Song-Betrachter öffnen. Unter MIDI-Syntax finden Sie Informationen zum Ausdrücken von MIDI-Befehlen als Text in OnSong.
• {pitch: ...} Die Noten, die bei Verwendung der Stimmfeife-Funktion gespielt werden.
• {keywords: ...} oder {topic: ...} Die Liste der Tags für die Themensuche. Weitere Informationen zum Durchsuchen nach Thema finden Sie unter Themen.
• {copyright: ...} oder {footer: ...} oder {f: ...} Gibt Copyrightfußzeilentext an, der am unteren Ende der Seite oder in der Lyriken-Projektion angezeigt wird.
• {ccli: ...} Die CCLI-Nummer des Songs.
• {restrictions: ...} Das Rechtemanagement für die durch Kommas getrennte Liste von Einschränkungen des Songs. Weitere Informationen zum Festlegen von Einschränkungen für Ihren Song finden Sie unter Restrictions.
• {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 Lyriken 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 zum Definieren von benutzerdefinierten Akkorddiagrammen verwendet. Weitere Informationen finden Sie unter Akkorde definieren.
• {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 Verse-Abschnitts mit einer optionalen Abschnittsbeschriftung.
• {end_of_verse} oder {eov} Deklariert das Ende eines Verse-Abschnitts.
• {start_of_chorus: ...} oder {soc} Deklariert den Anfang eines Chorus-Abschnitts mit einer optionalen Abschnittsbeschriftung.
• {end_of_chorus} oder {eoc} Deklariert das Ende eines Chorus-Abschnitts.
• {start_of_bridge: ...} oder {sob} Deklariert den Anfang eines Bridge-Abschnitts mit einer optionalen Abschnittsbeschriftung.
• {end_of_bridge} oder {eob} Deklariert das Ende eines Bridge-Abschnitts.
• {start_of_part: ..} oder {sop} Deklariert den Anfang eines Teils mit einer optionalen Abschnittsbeschriftung.
• {end_of_part} oder {eop} Deklariert das Ende eines Teils.
• {start_of_tab} oder {sot} Deklariert den Anfang einer Tabulatur, die OnSong in einer Monospace-Schriftart 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 Lyriken und Akkorde im Akkorddiagramm zu definieren.

• {textsize: ...} Definiert die Größe der Lyriken als numerischen Wert in Punkten.
• {textfont: ...} Definiert den Namen der Schriftart, die für Lyriken verwendet werden soll. Muss auf der Plattform unterstützt werden.
• {chordsize: ...} Definiert die Größe der Akkorde als numerischen Wert in Punkten.
• {chordfont: ...} Definiert den Namen der Schriftart, die für Akkorde verwendet werden soll. Muss auf der Plattform unterstützt werden.

Unterstützte Dateierweiterungen

Das ChordPro-Dateiformat ist insofern einzigartig, als es eine allgemein vereinbarte Syntax, aber kein Standard-Format 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