1. Zadání melodie
Tři způsoby:
- Otevři píseň z Knihovny — při prvním načtení se automaticky otevře píseň #1; jakoukoli jinou vybereš v Knihovně písní kliknutím na název (nebo odkazem
?pisen=N). - Napiš/přepiš text do pole (formát níže).
- Nahraj soubor: .txt / .abc (text), .mid / .midi (MIDI — noty se rozpoznají a vloží do pole; doladit ručně) nebo .xls / .xlsx (notovací tabulka: slabiky, německá notace b/es/as, sloupec Tlak/Tah, B-řádky s basy; tónina podle názvu listu, např. „B-Es-As“ = B dur).
Akordy: hmaty akordů (C, Cm, F…) najdeš v Akordové tabulce.
2. Tónina a transpozice
Vyber tóninu v rozbalovacím seznamu — celá tabulatura se přepočítá do dané tóniny (čísla tlačítek i basy). F a C jsou hlavní heligonkové tóniny (2řadá C/F), ostatní jsou orientační.
3. Generování a export
Vygenerovat tabulaturu — vykreslí sloupce z aktuálního vstupu.
Tisk / PDF — otevře tisk (doporučené: formát A4 na výšku).
Kopírovat HTML — zkopíruje HTML tabulatury do schránky (pro vložení na web).
4. Nástroje pro skladbu melodie
- 🔀 Alternativy — přepínač, který pod každou notu vypíše alternativní knoflíky se stejným tónem (jiná řada/pozice). Orientační — vychází z ověřených map F/C.
- ⌨️ Hmatník — klikací hmatník: rozklikni, vyber směr měchu (Tlak → / Tah ←) a klikej na knoflíky — noty se skládají do editoru a tabulatura se překresluje. Basová klávesnice dole přidává basové doby.
- 🎼 Osnova — notová osnova: vykreslí melodii v notách (houslový klíč) pod tabulaturou. Skluzovky jako osminy, držení jako pomlky.
- 🎻 Můj nástroj — nastavíš svůj layout (počet řad, knoflíků na řadu, ladění). Přihlášení uživatelé mají uloženo v profilu, jinak v prohlížeči. Ovlivňuje klikací hmatník.
5. Formát zápisu — Grid-Text
Nový formát (řádky začínají |) — každý sloupec = jedna doba:
| Zápis | Význam |
|---|---|
title: / key: | název písně / tónina (F, C, G, A, D, B) |
|>II:6,5;F >>II:5,4;f | | hudební řádek: sloupce mezerou, takty |, směr před notou |
> / >> | nový tlak (šipka →) / prodloužení šipky přes další doby |
< / << | nový tah (šipka ←) / prodloužení |
II:6,5 | dva knoflíky současně (čísla se zobrazí nad sebou) |
II:5+I:8 | akord přes obě řady současně |
II:5~ | oblouček (legato) na další notu — dlouhé mělké údolí v tabulatuře |
-;f / . | držení (bas zní) / zcela prázdná doba |
;F / ;f / ;Ff | basy za středníkem: velké = bas, malé = akord, obojí najednou |
|: … :| | repetice (opakování úseku), vykreslí se dvojitá čára s tečkami |
[1] / [2] | volta — 1. / 2. případ při repríze (malé číslo s linkou nad řádkem) |
TXT: | Na _ _ | | text pod notami: slabika 1:1 na sloupec, _ = prázdný slot, takty i zde |
Starý formát (řádky II:5;F II:6;f bez |, sloky v1:) aplikace stále umí — starší písně v knihovně se vykreslují beze změny.
6. Jak číst tabulaturu
Každý sloupec tabulatury = jedna doba (nota). Řádky shora dolů:
| Řádek | Co znamená |
|---|---|
| II. | vnitřní (druhá) řada knoflíků — číslo = tlačítko, tučně; dvě čísla nad sebou (např. 6/5) = skluz na jiné tlačítko |
| I. | vnější (první) řada knoflíků — číslo = tlačítko |
| B | basové tlačítko — velké písmeno = stlačené (Tlak), malé = tažené (Tah): F/f, B/b, C/c…; – = držení bez nové noty |
| M | směr měchu: → = stlačuji (Tlak), ← = táhnu (Tah); u skluzovek šipka směru skluzu |
| text | slabika zpěvu pod danou dobou (sloka 1); ostatní sloky jsou vypsány pod tabulaturou v závorce |
Značky v buňkách: ⌒ = oblouček (legato) na další notu · číslo nad číslem = skluz tlačítek · – = pauza/držení (bas může znít dál).
7. Struktura aplikace (horní menu)
- 🎹 Tabulátor (index) — zadání melodie (i klikacím hmatníkem), importy (MIDI/XLS/text), generování tabulatury, alternativy hmatů, notová osnova, export XLS/MIDI, tisk/PDF, uložení do knihovny.
- 📚 Knihovna — všechny písně: hledání, filtr jazyka, řazení kliknutím na záhlaví, stránkování, hodnocení, kopírování k sobě, „Jen moje“.
- 👥 Uživatelé — správa uživatelů (jen admin): schvalování registrací, role, blokování, reset hesel; řazení a stránkování.
- 🎼 Akordy — akordová tabulka (hmaty).
- 🖨️ Předloha — prázdná tisková předloha A4 (volitelný počet řádků/sloupců, předvyplnitelný název a tónina, tisk/PDF).
- 👤 Můj účet — přihlášení/registrace (nepřihlášení) nebo nastavení: heslo, nástroj, jazyky, bio, statistiky, smazání účtu.
- ❓ Nápověda — tato stránka.
Menu je k dispozici v češtině i angličtině — jazyk UI přepneš v Mém účtu.
8. Knihovna písní
- Hledat — textové pole nad tabulkou (název / autor / tónina); funguje bez diakritiky a bez ohledu na velikost písmen („věč“ najde „Včera“).
- Filtr jazyka — rozbalovák (Všechny / 🇨🇿 CZ / 🇸🇰 SK / …) se kombinuje s hledáním.
- Jen moje — zaškrtnutím zobrazíš jen vlastní písně (jen přihlášení).
- Řadit — klikni na záhlaví sloupce (Název / Tónina / Jazyk / Autor / Hodnocení / Úplnost / Upraveno); opakované kliknutí = sestupně.
- Stránkování — 20 písní na stránku.
- Sloupec Úplnost — říká, co píseň obsahuje: II. (druhá řada), I. (první řada), B (basy), M (směr měchu), T (text); „II./B/M/T“ = vše kromě řady I.
- Otevřít píseň — kliknutím na název se načte do tabulátoru (název lze pak upravit v poli Název).
- Hodnotit — 1–5 ★ (přepisuje se; jen přihlášení).
- 📄 Kopírovat — vytvoří vlastní kopii cizí písně k úpravám (jen Editor).
- ➕ Nová píseň — založí píseň s dotazem na název a otevře ji k editaci (Editor/Admin).
- 📊 Export XLS / 🎵 Export MIDI — v tabulátoru vyexportuje píseň jako notovací tabulku (.xls) nebo MIDI soubor (.mid).
- Ukládat/exportovat mohou jen Editoři; Admin spravuje vše.
- Odkaz na píseň — po otevření se URL změní na
?pisen=N; share tlačítka (FB/BS/X/WA/E-mail) pod tabulaturou.
9. Účty a role
Nepřihlášený vs. přihlášený — přehled funkcí:
| Funkce | Nepřihlášený | Přihlášený (Čtenář) | Editor | Admin |
|---|---|---|---|---|
| Prohlížet písně z knihovny | ✅ | ✅ | ✅ | ✅ |
| Hledat a řadit v knihovně | ✅ | ✅ | ✅ | ✅ |
| Vygenerovat tabulaturu / tisk / PDF | ✅ | ✅ | ✅ | ✅ |
| Import souboru (.txt/.mid/.xls) | — | ✅ | ✅ | ✅ |
| Hodnocení písní ★ | — | ✅ | ✅ | ✅ |
| Export XLS / MIDI | — | ✅ | ✅ | ✅ |
| Zakládat / upravovat / mazat VLASTNÍ písně | — | — | ✅ | ✅ |
| Kopírovat cizí píseň k sobě (📄) | — | — | ✅ | ✅ |
| Mazat libovolnou píseň | — | — | — | ✅ |
| Můj účet (nástroj, jazyky, bio, statistiky, smazání účtu) | — | ✅ | ✅ | ✅ |
| Správa uživatelů (schvalování, role, reset hesla) | — | — | — | ✅ |
👤 Můj účet — přihlášení/registrace i všechna nastavení na jednom místě:
- 📊 Statistiky — počet tvých písní a nejlépe hodnocená píseň; odkaz na Moje knihovnu.
- 🔐 Změna hesla — staré + nové (nové min. 6 znaků).
- 🎻 Můj nástroj — počet řad, knoflíků na řadu a ladění tvé heligonky; ovlivňuje klikací hmatník.
- Výchozí jazyk nových písní — 16 jazyků s vlaječkami (CZ, SK, UA, PL, GE, HU, RO, SI, EN, FR, SP, PT, NO, SE, FI, IT).
- 🌐 Jazyk rozhraní — CZ / EN (přeloží celé UI).
- 📝 Bio — krátký text o tobě (bez HTML, max 500 znaků).
- 🗑️ Smazání účtu — dvojité potvrzení; písně zůstávají v knihovně (bez autora).
Role:
| Role | Může |
|---|---|
| Čtenář | číst, hledat, hodnotit ★ |
| Editor | + zakládat, editovat a mazat VLASTNÍ písně (každá editace = nová verze, historie se ukládá) |
| Admin | + správa uživatelů (schvalování registrací, role, blokování, reset hesla), mazání libovolné písně |
Registrace: jméno + heslo → čeká na schválení admina. Admin: Vilda.
Tipy
- Skluzovky (obloučky) a přesahy se kreslí i v tisku — PDF vypadá jako předloha z zpěvníku.
- Pro přehlednější tisk zvětší zoom prohlížeče (Ctrl+/-) před printem — velikost se přenese.
- Nemáš heligonku C/F? Napiš adminovi (Vilda) — mapy tlačítek se doplní dle tvého ladění.
- Chyby hlaste v issues GitHub repa.