ChordPro

Format pliku ChordPro to powszechny format używany w innych aplikacjach. OnSong rozumie ten format natywnie. OnSong rozpoznaje pliki z następującymi rozszerzeniami: .chordpro, .chopro, .cho, .crd, .pro

Format ChordPro pozwala na wyrażenie informacji o piosence w tagach wyznaczonych klamrami. Informacje te można logicznie podzielić na tagi metadanych i tagi wbudowane.

Tagi metadanych

To tagi ChordPro, które byś używał w części metadanych piosenki. W poniższych tagach trzy kropki (...) reprezentują tekst, który dostarczasz, który pojawia się między dwukropkiem a zamykającą klamrą. Na przykład:

{title: Amazing Grace}
{key: G}

OnSong obsługuje następujące tagi ChordPro:

• {title: ...} lub {t: ...} Tytuł piosenki.
• {subtitle: ...}, {st: ...} lub {su: ...} Nazwa artysty lub inne informacje w podtytule. Możesz określić wielu artystów, oddzielając ich nazwiska średnikami. - Kim Walker-Smith; Chris Quilala
• {album: ...} Nazwa albumu, na którym znajduje się piosenka.
• {artist: ...} lub {a: ...} Nazwa artysty lub inne informacje w podtytule. Możesz określić wielu artystów, oddzielając ich nazwiska średnikami. - Kim Walker-Smith; Chris Quilala
• {author: ...} Nazwa osoby, która stworzyła diagram akordów. Jest wyświetlana u dołu diagramu akordów i w projekcji tekstu.
• {key: ...} lub {k: ...} lub {ok: ...} Tonacja piosenki zapisana jako tonacja z preferencją enharmoniczną i opcjonalnym „m" oznaczającym tonację mollową. - alfabetycznie, np. Bb lub Em
• {capo: ...} Kapo ustawione jako liczba progów - numerycznie
• {tempo: ...} Liczba uderzeń na minutę (BPM) - numerycznie
• {time: ...} Oznaczenie czasu - numerycznie uderzenie na takt, np. 3/4
• {duration: ...} Długość piosenki do autoscroll - sekundy lub mm:ss
• {book: ...} Nazwa książki lub książek, w której umieścić piosenkę. Jest to lista nazw książek oddzielona przecinkami, w której umieszczona zostanie piosenka. Jeśli książka nie istnieje, zostanie automatycznie utworzona.
• {number: ...} Numer piosenki - numerycznie, używaj do hymnów, lat itp. Możesz sortować piosenki według numeru w celach informacyjnych.
• {flow: ...} Układ sekcji - lista etykiet sekcji. Przejdź do Flow, aby uzyskać szczegółowe informacje o aranżacji przepływu piosenki.
• {midi: ...} Komendy MIDI do wysłania po wyświetleniu piosenki. Przejdź do MIDI Syntax, aby dowiedzieć się, jak wyrażać komendy MIDI jako tekst w OnSong.
• {midi-index: ...} Komendy MIDI, które spowodują otwarcie tej piosenki w Song Viewer. Przejdź do MIDI Syntax, aby dowiedzieć się, jak wyrażać komendy MIDI jako tekst w OnSong.
• {pitch: ...} Nuty do odtwarzania podczas korzystania z funkcji Pitch Pipe.
• {keywords: ...} lub {topic: ...} Lista tagów do użytku w wyszukiwaniu tematycznym. Przejdź do Topics, aby uzyskać więcej informacji na temat przeglądania według tematu.
• {copyright: ...} lub {footer: ...} lub {f: ...} Określa tekst stopki copyright, który pojawi się u dołu strony lub projekcji tekstu.
• {ccli: ...} Numer CCLI piosenki.
• {restrictions: ...} Zarządzanie prawami dla listy ograniczeń oddzielonej przecinkami piosenki. Przejdź do Restrictions, aby uzyskać szczegółowe informacje na temat ustawiania ograniczeń dla piosenki.
• {composer: ...} Osoby, które napisały muzykę do piosenki. Ta lista powinna być oddzielona średnikami dla poszczególnych wartości.
• {lyricist: ...} Osoby, które napisały tekst piosenki. Ta lista powinna być oddzielona średnikami dla poszczególnych wartości.

Tagi wbudowane

Te tagi są używane w treści piosenki i mogą być używane do definiowania sekcji lub formatowania części piosenki.

• {define: ...} służy do definiowania niestandardowych diagramów akordów. Przejdź do Defining Chords, aby uzyskać więcej informacji.
• {comment: ...} lub {c: ...} Definiuje komentarz i pojawia się jako instrukcja muzyczna.
• {comment_bold: ...} lub {cb: ...} Definiuje tekst, który ma się pojawić pogrubiony.
• {comment_italic: ...} lub {ci: ...} Definiuje tekst, który ma się pojawić kursywą.
• {guitar_comment: ...} lub {gc: ...} Definiuje komentarz, który pojawia się jako instrukcja muzyczna.
• {start_of_verse: ..} lub {sov} Deklaruje początek sekcji zwrotki z opcjonalną etykietą sekcji.
• {end_of_verse} lub {eov} Deklaruje koniec sekcji zwrotki.
• {start_of_chorus: ...} lub {soc} Deklaruje początek sekcji refrenu z opcjonalną etykietą sekcji.
• {end_of_chorus} lub {eoc} Deklaruje koniec sekcji refrenu.
• {start_of_bridge: ...} lub {sob} Deklaruje początek sekcji mostu z opcjonalną etykietą sekcji.
• {end_of_bridge} lub {eob} Deklaruje koniec sekcji mostu.
• {start_of_part: ..} lub {sop} Deklaruje początek części z opcjonalną etykietą sekcji.
• {end_of_part} lub {eop} Deklaruje koniec części.
• {start_of_tab} lub {sot} Deklaruje początek tabulatury, którą OnSong renderuje czcionką o stałej szerokości.
• {end_of_tab} lub {eot} Deklaruje koniec sekcji tabulatury.
• {new_page} lub {np} Służy do deklarowania nowej strony.
• {new_physical_page} lub {npp} Służy do deklarowania nowej strony.

Tagi formatowania

Poniższe tagi są używane do definiowania domyślnej czcionki i rozmiaru tekstu oraz akordów w diagramie akordów.

• {textsize: ...} Definiuje rozmiar tekstu jako wartość numeryczną w punktach.
• {textfont: ...} Definiuje nazwę czcionki do użytku dla tekstu. Musi być obsługiwana na platformie.
• {chordsize: ...} Definiuje rozmiar akordów jako wartość numeryczną w punktach.
• {chordfont: ...} Definiuje nazwę czcionki do użytku dla akordów. Musi być obsługiwana na platformie.

Obsługiwane rozszerzenia plików

Format pliku ChordPro jest wyjątkowy tym, że jest powszechnie uzgodnionym rozszerzeniem, ale nie standardowym formatem. Oznacza to, że różni dostawcy mogą implementować go na różne sposoby i z różnymi rozszerzeniami plików. OnSong obsługuje następujące rozszerzenia plików przy importowaniu plików w formacie ChordPro:

• .chopro
• .cho
• .chordpro
• .crd
• .pro
• .cpm