ChordPro

Format pliku 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 utworze w tagach wyznaczonych nawiasami klamrowymi. Informacje te można logicznie podzielić na tagi metadanych i tagi wbudowane.

Tagi metadanych

Są to tagi ChordPro, które byś użył w sekcji metadanych utworu. W poniższych tagach trzy kropki (...) reprezentują tekst, który dostarczasz, 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ł utworu.
• {subtitle: ...}, {st: ...} lub {su: ...} Nazwa artysty lub inne informacje nagłówkowe. Możesz określić wielu artystów, oddzielając nazwy średnikiem. - Kim Walker-Smith; Chris Quilala
• {album: ...} Nazwa albumu, w którym znajduje się utwór.
• {artist: ...} lub {a: ...} Nazwa artysty lub inne informacje nagłówkowe. Możesz określić wielu artystów, oddzielając nazwy średnikiem. - Kim Walker-Smith; Chris Quilala
• {author: ...} Imię i nazwisko osoby, która utworzyła diagram akordów. Jest wyświetlany na dole diagramu akordów i w projekcji tekstów.
• {key: ...} lub {k: ...} lub {ok: ...} Tonacja utworu zapisana jako tonacja z preferencją enharmoniczną i opcjonalnym „m" wskazującym tonację molową. - alfabetycznie, np. Bb lub Em
• {capo: ...} Kapodastr ustawiony jako liczba progów - numerycznie
• {tempo: ...} Liczba uderzeń na minutę (BPM) - numerycznie
• {time: ...} Metrum taktu - numerycznie, licznik nad mianownikiem, np. 3/4
• {duration: ...} Długość utworu do autoscrolowania - sekundy lub mm:ss
• {book: ...} Nazwa książki lub książek, w których umieścić utwór. Jest to oddzielona przecinkami lista nazw książek, do których utwór zostanie umieszczony. Jeśli książka nie istnieje, zostanie automatycznie utworzona.
• {number: ...} Numer utworu - numerycznie, użyj dla hymnów, lat itp. Możesz sortować utwory według numeru dla odniesienia.
• {flow: ...} Układ sekcji - lista etykiet sekcji. Patrz Przepływ, aby uzyskać szczegóły na temat aranżacji przepływu utworu.
• {midi: ...} Polecenia MIDI do wysłania, gdy utwór jest wyświetlany. Patrz Składnia MIDI, aby dowiedzieć się, jak wyrazić polecenia MIDI jako tekst w OnSong.
• {midi-index: ...} Polecenia MIDI, które wyzwolą otwarcie tego utworu w Przeglądarce utworów. Patrz Składnia MIDI, aby dowiedzieć się, jak wyrazić polecenia MIDI jako tekst w OnSong.
• {pitch: ...} Nuty do grania przy używaniu funkcji Rurka tonacyjna.
• {keywords: ...} lub {topic: ...} Lista tagów do używania z wyszukiwaniem tematów. Patrz Tematy, aby uzyskać więcej informacji na temat przeglądania według tematów.
• {copyright: ...} lub {footer: ...} Określa tekst stopki praw autorskich, który pojawi się na dole strony lub w projekcji tekstów.
• {ccli: ...} Numer CCLI utworu.
• {restrictions: ...} Zarządzanie prawami dla utworu - oddzielona przecinkami lista ograniczeń. Patrz Ograniczenia, aby uzyskać szczegóły na temat ustawiania ograniczeń dla Twojego utworu.

Tagi wbudowane

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

• {define: ...} jest używany do definiowania niestandardowych diagramów akordów. Patrz Definiowanie akordów, 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 pojawić się w pogrubeniu.
• {comment_italic: ...} lub {ci: ...} Definiuje tekst, który ma pojawić się jako kursywa.
• {guitar_comment: ...} lub {gc: ...} Definiuje komentarz, który pojawia 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żywany do deklaracji nowej strony.
• {new_physical_page} lub {npp} Jest używany do deklaracji nowej strony.

Tagi formatowania

Następujące 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życia dla tekstu. Musi być obsługiwana na platformie.
• {chordsize: ...} Definiuje rozmiar akordów jako wartość numeryczną w punktach.
• {chordfont: ...} Definiuje nazwę czcionki do użycia dla akordów. Musi być obsługiwana na platformie.

Obsługiwane rozszerzenia plików

Format pliku ChordPro jest wyjątkowy w tym sensie, że jest powszechnie uznaną składnią, ale nie standardowym formatem. Oznacza to, że różni dostawcy mogą wdrażać 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