Dokumentacja

Spis treści


Format i wygląd tekstu 🎨

Utwory są zapisywane w prymitywnym języku znaczników, dzięki czemu nie musisz zajmować się formatowaniem tekstu, wariacjami kolorystycznymi, czcionką, dostosowywaniem rozmiaru i innymi rzeczami 🙂.

Wynikowy format jest sprawdzony w praktyce na setkach wydarzeń muzycznych i wielu urządzeniach – czy to na komputerach stacjonarnych 💻, telefonach 🤳, tabletach 🪟 czy projektorach 📽️. Nie bez znaczenia jest również fakt, że śpiewnik Kytario jest przeznaczony do użycia również w drukowanej formie A5.

Koloru, typu czcionki ani żadnych innych atrybutów tekstu nie można zmieniać. Jeśli mimo to potrzebujesz graficznie rozróżnić określone części tekstu, rozważ użycie jednego z wielu symboli UTF-8 lub emoji 😅. Nie ma granic dla kreatywności.


Typy układu

Śpiewnik Kytario jest dostosowany zarówno do urządzeń mobilnych, jak i komputerów stacjonarnych oraz projektorów. Dzięki temu możesz wybrać, czy chcesz widzieć cały utwór (kosztem mniejszego tekstu), czy powiększony (kosztem konieczności ręcznego przewijania utworu). 💡

Tryb układu można przełączać po rozwinięciu dolnego menu, które wyświetla się przy śpiewnikach i utworach.


Układ dwukolumnowy 💻

Układ dwukolumnowy, czyli "desktopowy", jest domyślnym układem, który umożliwia czytanie całego utworu bez konieczności przewijania. Ten układ jest również używany do drukowania śpiewnika do PDF 🖨️.

Zakładając, że jest to zapisane w utworze, w układzie dwukolumnowym niektóre elementy utworu są ukryte, dzięki czemu można wyświetlić cały utwór na jednej stronie. Przykładem jest utwor Snow - Red Hot Chili Peppers, który zawiera wiele powtarzających się akordów i sekcji. Te, choć są zapisane w utworze, są w tym układzie ukryte 👻.

Układ dwukolumnowy wyświetla się automatycznie, gdy urządzenie wyświetlające śpiewnik jest obrócone "na szerokość" (górna strona wyświetlacza jest jego dłuższym bokiem) i nie jest urządzeniem mobilnym.


Układ jednokolumnowy 📱

Układ jednokolumnowy, czyli "mobilny", jest przeznaczony przede wszystkim do sytuacji, gdy potrzebna jest lepsza czytelność tekstu. Chociaż ten układ często nazywamy "mobilnym", zalecamy go używać również podczas projekcji - nawet zwykły projektor z mniejszym ekranem pozwoli przy tym układzie czytać tekst osobom siedzącym daleko od ekranu. 👁️

W tym układzie zawsze wyświetlane są wszystkie części utworu, a wszystkie powtarzające się części utworu są w pełni wyrenderowane w tekście. W przypadku utworu Snow - Red Hot Chili Peppers są to np. części Ref1 - Brid. - Ref2 - Ref3.

Układ jednokolumnowy wyświetla się automatycznie na urządzeniach mobilnych lub gdy urządzenie jest obrócone "na wysokość" (górna strona wyświetlacza jest jego krótszym bokiem).

przykład projekcji


Tryb LIVE 🎥

Kluczową właściwością śpiewnika Kytario jest możliwość centralnego sterowania wyświetlanym utworem na wszystkich innych urządzeniach. Ten tryb umożliwia wybranie wyświetlanego utworu, transponowanie go, przewijanie (scroll) i ewentualne wyświetlenie wyskakującego okna z wiadomością. 📢

Aby móc sterować śpiewnikiem, musisz należeć do projektu, do którego masz uprawnienia edytorskie lub administracyjne. Jeśli chcesz sterować śpiewnikiem, który nie jest twój, możesz łatwo go skopiować przyciskiem w rozwijanym menu na liście śpiewników, a następnie sterować tą nowo utworzoną kopią.

💡 Jeśli organizujesz większe wydarzenie, warto udostępnić ludziom kod QR śpiewnika (można go wyświetlić przyciskiem w rozwijanym menu na liście śpiewników). To najprostszy sposób, w jaki ludzie mogą dostać się do śpiewnika, ponieważ nie będą musieli ręcznie szukać śpiewnika na całej liście, gdzie może łatwo dojść do pomyłki.


Tryb podstawowy (wybór utworu) 🚦

Organizujesz małe wydarzenie z przyjaciółmi lub grasz tam, gdzie masz duży ekran projekcyjny, na który zmieści się cały utwór? Tutaj wystarczy ci "podstawowy tryb live" - w nim możesz łatwo wybrać utwór, który następnie wyświetli się na wszystkich podłączonych urządzeniach. 💪

Wystarczy tylko otworzyć swój śpiewnik, wyświetlić dowolny utwór i kliknąć przycisk "Nastavit live". W ten sposób ten utwór wyświetli się również na wszystkich innych urządzeniach. Jeśli przejdziesz do innego utworu, musisz ponownie nacisnąć przycisk "Nastavit live", aby ten utwór znów wyświetlić innym. 🎉

Jeśli będziesz chciał wyłączyć tryb live i tym samym umożliwić ludziom łatwiejsze przeglądanie śpiewnika, wystarczy wyświetlić listę utworów i kliknąć przycisk "Vypnout live režim". Wyłączenie nastąpi również automatycznie po 8 godzinach od ostatniej aktywności. 💤

Jeśli tryb live jest już włączony, a ktoś inny wyświetli taki śpiewnik, jego urządzenie automatycznie będzie podążać za wybranym utworem. Naciśnięcie czerwonego przycisku Live 🔴 spowoduje "odłączenie" od tego trybu i umożliwi swobodne przeglądanie śpiewnika.

Możesz również transponować utwór za pomocą przycisków w dolnym menu i tę transpozycję ponownie za pomocą przycisku "Nastavit live" potwierdzić, aby wyświetlić innym. 🔝


Tryb zaawansowany (przewijanie utworu) ⏬

Chcesz wydobyć z Kytario maksimum i ułatwić współgraczom i wokalistom orientację w tekstach? Kytario oferuje możliwość zdalnego przewijania (scrollu) wyświetlanego utworu! To przewijanie jest kontrolowane przez jednego z graczy i pozwala innym wyświetlić śpiewnik w układzie jednokolumnowym tak, że całkowicie odpada dla nich konieczność ręcznego przewijania ekranu. To funkcjonalność, którą ludzie w twoim otoczeniu na pewno pokochają ❤️

Przewijanie można kontrolować na trzy sposoby:

  1. Za pomocą strzałek w górę i w dół w prawym dolnym rogu ekranu,
  2. za pomocą fizycznych klawiszy strzałek w górę/w dół na klawiaturze twojego laptopa/PC, lub
  3. za pomocą dowolnego urządzenia, które emuluje klawisze strzałek w górę i w dół.

Aby przewijać, śpiewnik (wszystkich użytkowników) musi być wyświetlony w układzie jednokolumnowym (zobacz Typy układu), musi być włączony tryb live i wybrany jakiś utwór (zobacz Tryb podstawowy (wybór utworu)). Ponadto na urządzeniu, które kontroluje śpiewnik, należy włączyć "tryb przewijania" za pomocą zielonego przycisku "Zapnout režim posuvu" 🟩 w rozwijanym menu śpiewnika.

Jeśli to jest spełnione, kliknięciem strzałki w dół na wyświetlaczu, na klawiaturze lub urządzeniu zewnętrznym podświetli się pierwsza sekcja utworu, a każdym kolejnym kliknięciem podświetli się następna sekcja. Strzałka w górę ma odwrotny efekt. 🤖

Jeśli masz wybrany jakiś playlist (w rozwijanym dolnym menu), na końcu utworu wyświetlą się przyciski dla następnego utworu z playlisty. Ten przycisk może być podświetlony tak samo jak inne sekcje, a kolejnym naciśnięciem strzałki w dół nastąpi przełączenie wyświetlanego utworu. Z playlistą więc podczas całego wydarzenia tylko naciskasz strzałkę w dół i nie musisz się martwić o nic innego 😉.

"Przełącznik" M-VAVE Cube Turner

Ze wszystkich urządzeń do kontrolowania przewijania utworów najbardziej sprawdził się nam M-VAVE Cube Turner, które jest urządzeniem na zasadzie bezprzewodowej klawiatury Bluetooth, którą można podłączyć do laptopa, tabletu lub telefonu. Wbudowana bateria wytrzymuje ponad 10 godzin, ładowanie przez USB-C, metalowa obudowa. Przyciski mają silną mechaniczną i dźwiękową odpowiedź, co zapewnia pewność przełączania. Wszystko to za około 500 Kč z Aliexpress lub podobnych sklepów.

M-VAVE Cube Turner

Pytania, które możesz mieć:


Wyskakujące okno z wiadomością 💬

Chcesz zagrać z ludźmi piosenkę z obcego śpiewnika lub innej strony internetowej, albo po prostu tylko powiedzieć im, co o nich myślisz? 😆 Tryb live oferuje możliwość wyświetlenia wiadomości w wyskakującym oknie. Po prostu wpisz tę wiadomość w polu w rozwijanym dolnym menu śpiewnika i potwierdź (enterem lub zielonym przyciskiem 🟩). Wiadomość wyświetli się na wszystkich urządzeniach. Czerwonym krzyżykiem ❌ następnie tę wiadomość ukryjesz wszystkim.

Do wiadomości możesz wstawiać również linki do innych stron, co przydaje się głównie do grania utworów poza Kytario. Już nie musisz mówić ludziom, żeby ręcznie szukali utworu 🙂 (zawsze znajdzie się przynajmniej jeden ekspert, który otworzy inną wersję tego samego utworu 🤣).


Zapis utworów 📝

Zapis utworów podlega kilku zasadom, które należy przestrzegać, aby tekst był poprawnie wyrenderowany. Zapis składa się z kilku części:

Jeśli szukasz inspiracji, jak efektywnie zapisywać utwory, zajrzyj do śpiewnika KytarovkyBrno, z którego powstała cała ta platforma 🙂.


Akordy

Formatowanie akordów

Akordy są zapisywane w nawiasach klamrowych, np. {C}, {Em} lub {C#m7}. Oznaczenie tonu akordu (pierwszy znak) musi być zawsze wielką literą. Akordy mogą być również złożone, np. {F#m7/G#}, przy czym ton za ukośnikiem oznacza ton basowy.

Nomenklatura akordów, którą wybierzesz, zależy wyłącznie od ciebie. Możesz zapisywać w formie "amerykańskiej" (np. {Emi} - e minor) lub łacińskiej ({Em} - e moll). Ze względu na niespójności akordów z różnych źródeł jednak zalecamy nomenklaturę łacińską.

💡 W prostocie jest siła – jeśli zapisujesz utwory dla szerokiej publiczności i nie chodzi o taki, który jest zbudowany na skomplikowanych akordach, zalecamy uprościć akordy tak bardzo, jak to możliwe.

Pozycja akordów

Akordy powinny być w zapisie pozycjonowane tak, że poprzedzają słowo (lub głoskę), do której należą, np.: {A}Na našem {Amaj}rybníku, tam v {A7}ráji řas a vodníků.

Jeśli konieczne jest zapisanie kilku akordów w ramach jednego słowa, możesz podzielić słowo jednym lub kilkoma myślnikami, np.: {Em}Má - {G}á - {D}á.

Jeśli akord jest grany w części, gdzie nie ma żadnego tekstu, można go oddzielić spacją z obu stron. To spowoduje rozciągnięcie tekstu w jego otoczeniu, np.: {E}Zdá se {F#m}mi, {G#m} je to {F#m}moc let,. Bez tego odstępu akord {G#m} zostałby wyrenderowany nad słowem je.


Stałe spacje

Jeśli zaistnieje sytuacja, gdy trzeba odsunąć część tekstu, w której nie ma żadnego akordu, można wstawić do tekstu stałą spację. Istnieją 3 różne szerokości tej spacji, ewentualnie można je również łączyć:

  • krótka: {-}
  • średnia: {--}
  • długa: {---}

💡 Stałych spacji używaj tylko w wyjątkowych przypadkach. W idealnym przypadku spacje w tekście tworzą się same przez to, że wpiszesz w nim akord owinięty zwykłymi spacjami.


Sekcje

Utwory składają się z sekcji – zwrotek, refrenów, przegiętów i innych.

Nazwane sekcje

Każda sekcja, która zawiera śpiewany tekst, musi być jakoś nazwana – liczbą lub słownie. Nazwy nie powinny być dłuższe niż 4 znaki i zawsze muszą zaczynać się od znaku minus (- Ref1) lub plus (+ Ref2).

Różnica między tymi dwoma wariantami polega na tym, że sekcje wprowadzone symbolem minus wyświetlają akordy zawsze – w układzie desktopowym, w druku i na telefonach. Sekcje wprowadzone symbolem plus wyświetlają akordy tylko w układzie mobilnym (jednokolumnowym).

Nazwy mogą być dowolne, jednak zalecamy używać następujących konwencji:

  • Zwrotki: - 1., - 2., - 3., itd.
  • Refreny: - Ref. (pojedynczy refren) lub - Ref1, - Ref2 (gdy refreny mają różne teksty)
  • Pre-refren: - Pre. lub - Pre1, - Pre2
  • Bridge: - Brid.
  • Intro: - Int. (lub pozostaw nienazwane dla wstępów złożonych tylko z akordów)
  • Outro: - Out.
  • Instrumentalna część: pozostaw nienazwane

💡 Używaj wariantów numerowanych (Ref1, Ref2) tylko wtedy, gdy sekcje mają różną zawartość. Jeśli refren powtarza się identycznie, zapisz go raz jako - Ref. i odnoś się do niego przez [Ref.].

Nienazwane sekcje

Jeśli sekcja nie ma żadnej nazwy, nie jest wyświetlany jej tekst, ale tylko akordy. Taka sekcja może dodatkowo jeszcze zawierać odniesienia do innych sekcji lub repetycję, np.: |: [Ref.][1.][2.] :|

Nienazwane sekcje mogą mieć kilka linii i mogą łączyć akordy, np.:

|: [Ref.][1.][2.] :|
[Solo]
|: {C}{D}{Em} :|
[Ref.]

Wszystkie elementy nienazwanych sekcji są dla zwiększenia czytelności automatycznie przeplatane myślnikami. Powyższy przykład zostanie więc wyrenderowany jako:

|: Ref. - 1. - 2. :|
Solo
|: C - D - Em :|
Ref.

💡 W przypadku przegrywek, solówek, wstępów i zakończeń zalecamy pozostawić sekcję nienazwaną. Z kontekstu jest ludziom jasne, że prawdopodobnie chodzi o solo, gdy w połowie utworu jest kilka akordów bez tekstu. Zmniejszy to objętość informacji na stronie. 💡 W nienazwanej sekcji renderowane są tylko akordy i odniesienia do sekcji.


Odniesienia do sekcji

Jeśli utwór jest zbyt długi lub sekcje w nim (np. refreny) często się powtarzają, warto sekcję w pełni zapisać tylko raz, a kolejne wystąpienia tylko odnieść.

Odniesienia do sekcji zapisuje się w nawiasach kwadratowych i muszą zawierać pełną nazwę sekcji bez znaku wprowadzającego (plus/minus), np. [Ref.].

Jeśli mamy sekcję:

- Ref.
|: Ja som {F#m}malá Žužu{D}žu, toto {E}je môj mikro{C#m}fón.
Ak mi {F#m}dáte svoj do{D}lár, ja vám {E}zaspievam svoj {C#m}song. :|

możemy więc do niej w dowolnej nienazwanej sekcji odnieść się za pomocą [Ref.].

Te odniesienia możemy owinąć w repetycję i dowolnie łączyć, np.: |: [Ref.][1.][2.] :|. W układzie desktopowym i druku odniesienia (i akordy) będą przeplatane myślnikami dla lepszej czytelności i zostaną wyrenderowane jako |: Ref. - 1. - 2. :|. W układzie mobilnym odniesienia do sekcji są "rozwinięte" i zamiast odniesienia renderowana jest cała zawartość danej sekcji. Dzięki temu nie trzeba ręcznie przewijać wyświetlacza i szukać, jak gra się ta czy owa sekcja.


Repetycje

Repetycję można zapisać za pomocą znaków |: i :|. Repetycje mogą rozciągać się na kilka linii tekstu, jednak zawsze muszą trzymać się w ramach jednej sekcji.

Jeśli liczba powtórzeń nie jest podana, fragment powtarza się raz (gra się łącznie dwa razy). Aby powtórzyć więcej razy, dodaj liczbę bezpośrednio po znaczniku zamykającym:

  • |: La la la :| — gra się łącznie 2 razy (domyślnie)
  • |: La la la :| 3x — gra się łącznie 3 razy
  • |: La la la :| 4x — gra się łącznie 4 razy

Przykład: |: {Am}{F}{C}{G} :| 4x tworzy 4-taktową progresję graną 4 razy.

Jakikolwiek inny zapis, choć może graficznie wyglądać podobnie (np. użycie ukośników / i \), nie jest obsługiwany przez system i repetycje nie będą poprawnie rozwinięte.

Jeśli repetycja zawiera odniesienie do innej sekcji, a śpiewnik jest wyświetlany w układzie mobilnym, zawartość tej sekcji będzie wyrenderowana jedna pod drugą. Te zapisy są więc sobie równoważne: |: [Ref.][1.][2.] :| [Ref.][1.][2.] [Ref.][1.][2.].

💡 Powtarzające się części piosenek często zawierają tylko drobne zmiany - zmiana jednego słowa lub zmieniona frazowanie. Jeśli chcesz uprościć piosenkę, zamiast dwóch różnych wersji tej części zapisz tylko jedną i daj ją w repetycję. 😉


Dodatkowe teksty w nawiasach

Możesz dodawać adnotacje w nawiasach dla chórków, echa lub uwag dotyczących wykonania:

- Ref.
Baby {F#m}I don't need {D}dollar bills to have {A}fun tonight. (I {E}love cheap thrills.)

Lub dla wzorców pytanie-odpowiedź:

- 6.
B{Am}rácho, (b{F}rácho)! B{C}rácho, (b{E}rácho)!

Te adnotacje są renderowane jako zwykły tekst z akordami. Używaj ich oszczędnie do oznaczania chórków, udziału publiczności lub echa.


FAQ