ChordPro

Format ChordPro jest powszechnym formatem używanym w innych aplikacjach. OnSong rozumie ten format natywnie. OnSong rozpoznaje pliki z następującymi rozszerzeniami: .chordpro, .chopro, .cho, .crd, .pro

Format ChordPro umożliwia wyrażanie informacji o piosence w tagach wyznaczonych nawiasami klamrowymi. Informacje te można logicznie podzielić na tagi metadanych i tagi wstawiane.

Tagi metadanych

To są tagi ChordPro, które będziesz używać w części metadanych piosenki. W poniższych tagach trzy kropki (...) reprezentują tekst, który podajesz, który znajduje się między dwukropkiem a zamykającym nawiasem klamrowym. 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. Możesz określić wielu artystów, oddzielając ich nazwy średnikiem. - Kim Walker-Smith; Chris Quilala
• {album: ...} Nazwa albumu, w którym znajduje się piosenka.
• {artist: ...} lub {a: ...} Nazwa artysty lub inne informacje. Możesz określić wielu artystów, oddzielając ich nazwy średnikiem. - Kim Walker-Smith; Chris Quilala
• {author: ...} Nazwa osoby, która utworzyła tabelę akordów. Jest wyświetlana na dole tabeli akordów i w projekcji tekstów.
• {key: ...} lub {k: ...} lub {ok: ...} Tonacja piosenki zapisana jako tonacja z preferencją enharmoniczną i opcjonalnym „m" wskazującym tonację molową. - alfanumerycznie, np. Bb lub Em
• {capo: ...} Capo ustawione jako liczba progów - numerycznie
• {tempo: ...} Liczba uderzeń na minutę (BPM) - numerycznie
• {time: ...} Metrum - numerycznie uderzenie na takt, np. 3/4
• {duration: ...} Długość piosenki dla autoscrollu - sekundy lub mm:ss
• {book: ...} Nazwa książki lub książek, w których umieścić piosenkę. To jest lista oddzielona przecinkami nazw książek, do których piosenka będzie umieszczona. 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 referencyjnych.
• {flow: ...} Układ sekcji - lista etykiet sekcji. Zapoznaj się z Przepływem, aby uzyskać szczegółowe informacje na temat układu przepływu piosenki.
• {midi: ...} Polecenia MIDI do wysłania po wyświetleniu piosenki. Zapoznaj się z Składnią MIDI, aby dowiedzieć się, jak wyrażać polecenia MIDI jako tekst w OnSong.
• {midi-index: ...} Polecenia MIDI, które wyzwolą otwarcie tej piosenki w Przeglądarce piosenek. Zapoznaj się z Składnią MIDI, aby dowiedzieć się, jak wyrażać polecenia MIDI jako tekst w OnSong.
• {pitch: ...} Nuty do zagrania podczas używania funkcji Kamertonu.
• {keywords: ...} lub {topic: ...} Lista tagów do użytku w wyszukiwaniu tematycznym. Zapoznaj się z Tematami, aby uzyskać więcej informacji na temat przeglądania wg tematu.
• {copyright: ...} lub {footer: ...} lub {f: ...} Określa tekst stopki autorskich do wyświetlenia na dole strony lub w projekcji tekstów.
• {ccli: ...} Numer CCLI piosenki.
• {restrictions: ...} Zarządzanie prawami dla listy ograniczeń oddzielonej przecinkami piosenki. Zapoznaj się z Ograniczeniami, aby uzyskać szczegółowe informacje na temat ustawiania ograniczeń dla Twojej piosenki.
• {composer: ...} Osoby, które napisały muzykę do piosenki. Ta lista powinna być oddzielona średnikami dla oddzielnych wartości.
• {lyricist: ...} Osoby, które napisały tekst piosenki. Ta lista powinna być oddzielona średnikami dla oddzielnych wartości.

Tagi wstawiane

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

• {define: ...} jest używany do definiowania niestandardowych diagramów akordów. Zapoznaj się z Definiowaniem akordów, aby uzyskać więcej informacji.
• {comment: ...} lub {c: ...} Definiuje komentarz i pojawia się jako instrukcja muzyczna.
• {comment_bold: ...} lub {cb: ...} Definiuje tekst pojawiający się w pogrubionej czcionce.
• {comment_italic: ...} lub {ci: ...} Definiuje tekst pojawiający się w kursywie.
• {guitar_comment: ...} lub {gc: ...} Definiuje komentarz pojawiający się jako instrukcja muzyczna.
• {start_of_verse: ..} lub {sov} Deklaruje początek sekcji wersu z opcjonalną etykietą sekcji.
• {end_of_verse} lub {eov} Deklaruje koniec sekcji wersu.
• {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} Jest używane do deklaracji nowej strony.
• {new_physical_page} lub {npp} Jest używane do deklaracji nowej strony.

Tagi formatowania

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

• {textsize: ...} Definiuje rozmiar tekstów jako wartość numeryczną w punktach.
• {textfont: ...} Definiuje nazwę czcionki do użytku dla tekstów. 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 ChordPro jest unikalny tym, że jest powszechnie uzgodnionym formatem, ale nie standardem. Oznacza to, że różni producenci mogą implementować go na różne sposoby i z różnymi rozszerzeniami plików. OnSong obsługuje następujące rozszerzenia plików podczas importowania plików sformatowanych w ChordPro:

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