Alíkův značkovací jazyk

K zapisování věcí se na mnoha místech v Alíkovi používá od června 2020 druh zápisu, pomocí kterého jde vkládat složitější věci.

Základní idea za tímto jazykem je, že všechny příkazy píšete do obyčejných závorek, česky, jako kdybyste někomu diktovali pokyny jen tak mezi řečí.

Stylování textu

Každý stylovací příkaz ruší veškeré předchozí stylování. Konec řádku také ruší všechno stylování.

Co všechno jde přikázat:

• Tučnost (tučně).
• Kurzíva (kurzívou).
• Přeškrtnutí (škrtnuté).
• Indexy (horní index), (dolní index).
• Barvičky: (červeně), (zeleně), (modře), (žlutě), (modrozeleně), (fialově), (růžově), (hnědě), (oranžově), (šedě), (duhově).
• Podbarvení/zvýraznění (podbarvení), různě barevné ↑.
• Druh písma (strojově), (kapitálkami), (psace).
• K obyčejnému stylu se jde vrátit příkazem (obyčejně) nebo (normálně)…

Fungují i kombinace, třeba (oranžovou škrtnutou kurzívou). Stylovací slova jde kombinovat i s ostatními příkazy zmíněnými níže.

Mezi rozpoznávanými barvičkami jsou už i bílá a černá, ale na mnoha místech nic nedělají, protože černá bývá výchozí barva a bílá by nebyla vidět.

Základní možnosti

Odkazy

Běžně napsaná adresa v textu se přeloží na odkaz. Nebo je možné použít příkaz (odkaz na https://www.alik.cz) nějaký text (konec odkazu) (nebo jen (konec), který umí ukončit všechno).

Seznamy

Běžně napsané odrážky se přeloží na seznam, ale krom toho jde výslovně začít (seznam) a pak ho skončit koncem. Může to být i (seznam číslovaný) nebo (seznam kladů a záporů) apod., výslovně začaté seznamy jde také libovolně zanořovat do sebe.

Nadpis

Kdekoliv uvnitř řádku můžete z daného řádku udělat nadpis příkazem (nadpis). Nadpis se vytvoří z celého řádku. Kdo potřebuje víc úrovní nadpisů, může použít i (malý nadpis).

Zarovnání doprostřed a doprava

Kdekoliv uvnitř odstavce můžete daný odstavec (zarovnat doprava) nebo (doprostřed).

Obrázek

Každý obrázek má sedmipísmenný kód, který můžete potkat v adrese, když mu upravujete vlastnosti. Můžete tedy vložit třeba (obrázek IEZKIYM), pokud obrázek splňuje podmínky pro dané místo (schválení, správná velikost, autorská práva).

Boxíky

Boxík se píše mezi (boxík) a (konec boxíku). Může být i obtékaný (boxík vpravo) (jako je tady) nebo vlevo, podporuje i barvy.

Citace

Citace se píše mezi (citace) a (konec citace), k příkazu lze uvést i odkaz na zdroj nebo přezdívku autora.

Oddělovač

Vodorovná čára je (oddělovač). Funguje i (malý oddělovač) pro menší čáru.

Žížalky

Ukazatel nějakého podílu, typicky třeba počtu bodů, viz třeba počty kostí a puntíků v článku o Alíkově vysvědčení. Zápis (žížalka 25 %) nebo (žížalka 1 / 4) ukáže do čtvrtiny vyplněnou žížalku. Podporuje i všechny barvičky. Pokud je uvedeno jen samotné číslo, samo se najde maximum pro zadanou barvu, takže pokud jsou u sebe třeba (modrá žížalka 8) a (modrá žížalka 16), ta první je vyplněná do poloviny.

Emoji

V textech se běžně nahrazují emoji znaky za obrázky z výchozí sady, kterou si můžete změnit v nastavení. Příkazy (emoji microsoft), (emoji facebook), (emoji google), (emoji twitter) a (emoji apple) jde mezi sadami obrázků přepínat.

Závorka

Kdybyste potřebovali napsat příkaz tak, aby se nezpracoval, můžete jeho závorku napsat jako (závorka). Také je možné obalit kus textu mezi (prostě) a (azj), tím se v něm vyřadí všechny AZJ náhrady a bude se brát jako prostý text.

Interaktivní možnosti

Vyzrazení (neboli spoiler)

Skrytý text, který si jde zviditelnit, se napíše mezi (spoiler) a (konec).

Odpočet určitého času

Příkazem (odpočet do 1. 9. 2025 8:00) můžete vložit živý odpočet času do konce letních prázdnin. Podobně funguje i odpočet od nějaké doby. Běžně se vypisují jen čísla, ale od léta 2025 existuje i varianta (odpočet slovně). Podporuje i všelijaké styly textu.

Kvízy

Mezi značkami (kvíz) a (konec kvízu) můžete definovat podobný interaktivní kvíz, jako má Alík ve svém narozeninovém článku. U každé otázky musíte uvést možnosti odsazené pomlčkou a následované počtem bodů, třeba (3 b.). V závěru pak uvedete bloky ve tvaru (výsledek pro 8 až 10 b.). Ukázku celého zápisu předvedl v nástěnce Tobias7, moc pěkný návod sepsal i lékařský. Počty bodů musí být celé číslo (cítíte-li potřebu dávat půlbody, přenásobte všechno dvěma), můžou být i záporné.

Tajenky

Mezi značkami (tajenka) a (konec tajenky) můžete definovat podobnou interaktivní tajenku, jako má Alík ve svém narozeninovém článku. Na každý řádek musíte uvést číslo řádku a slovo. V závěru pak uvedete blok ve tvaru (výsledek pro „řešení“). Ukázku celého zápisu předvedla majdula2000.

Množství příkazů postupně roste.

Chceme, aby bylo používání maximálně intuitivní. Pokud si všimneme, že něco zkoušíte nějak použít a nefunguje vám to, tak se zamýšlíme nad tím, jestli by to fungovat mohlo.

Ankety

Ankety je možné tvořit příkazem (anketa) a musí být ukončené příkazem (konec). První řádky v anketě neodsazené pomlčkou jsou otázka, další řádky odsazené pomlčkou jsou možnosti.

Každá vytvořená anketa může mít několik vlastností, které je možné kombinovat:

(anonymní anketa)

Nezobrazuje se, kdo jak hlasoval. Není-li anketa anonymní, ukazují se pod každou možností ikonky hlasujících.

(sdílená anketa)

Anketu je možné vložit i na jiná místa. Může ji pak vložit kdokoliv kamkoliv. Proto je vhodné, aby v ní byla dobře a úplně vyjádřená otázka (nezávislá na okolí). Anketa bude mít přiřazený sedmipísmenný kód podobný, jako mají obrázky, potom ji jde vložit příkazem (vložit anketu ZCDLBLN).

(anketa do 24. 12. 2020)

Čas konce ankety, po něm už nejde hlasovat.

(objektivní anketa)

Možnosti jsou náhodně proházené a není vidět aktuální stav hlasů, takže se lidi navzájem neovlivňují. Skutečný stav hlasů je odhalen až po skončení, pokud existuje datum konce ankety.

Pokud není žádné datum konce, stav se člověku ukáže po zahlasování a v takovém případě nemůže hlas dodatečně změnit. Důrazně doporučujeme, aby existovala nějaká úniková možnost typu „nechci hlasovat“ pro lidi, které zajímá stav, ale nechtějí vyjádřit žádný názor.

Jelikož každá anketa funguje jako samostatný AZJ text, není dovolené vynechat příkaz (konec) a je v ní zakázaný příkaz (žížalka) (protože žížalky by se mohly navzájem ovlivňovat).

Celý zápis ankety může vypadat třeba takto:

(anonymní objektivní anketa do 1. 7. 2026)
Jaké Alíkovo pexeso by vám udělalo největší radost?
- Mývalí.
- Vydří.
- Velbloudí.
(konec)

Pokud má anketa jedinou možnost, můžou hlasující svůj hlas odvolat.

Ankety byly dlouho ve vývoji. Pokud vám připadá, že některé stavy a možnosti anket nejsou úplně dořešené, hlaste prosím cokoliv, co vás překvapí nebo zarazí, do technické poradny.

Příkazy pro vizitky

Experimentálně jde AZJ používat i v novém formátu vizitek, na který postupně přejdeme – tam existuje i pár speciálních příkazů na výpisy různých seznamů:

(vložit napsané články)

Vloží články napsané majitelem vizitky. Pokud tam někdo nechce starší články, může i omezit dobu, třeba (vložit články napsané po 1. 1. 2025).

(vložit moderované nástěnky) / (vložit založené nástěnky) / (vložit oblíbené nástěnky)

Vloží nástěnky moderované/založené/oblíbené majitelem vizitky.

(vložit oblíbené hry) / (vložit vyrobené hry)

Vloží hry oblíbené/vyrobené majitelem vizitky.

(vložit zúčastněné srazy) / (vložit organizované srazy)

Vloží srazy zúčastněné/organizované majitelem vizitky.

(vložit napsané vtipy) / (vložit oblíbené vtipy)

Vloží vtipy napsané/oblíbené majitelem vizitky. Oblíbení vtipů si jde zapnout v nastavení.

(vložit chtěné dárky) / (vložit objednané dárky)

Vloží dárky chtěné/objednané majitelem vizitky. (Uživatel si může u dárku hvězdičkou poznačit, že si na něj šetří.)

(vložit kamarády)

Vloží seznam kamarádů majitele vizitky.

(vložit Alíka)

Vloží ilustrační obrázek Alíka, vhodný třeba k jasnějšímu oddělení bloků.

Bloky je možné i víckrát zopakovat, pokud majitel vizitky chce delší seznam. Kromě velkých bloků jde vkládat i automaticky doplňované texty:

(vložit počet kamarádů)

Vloží buď samotný počet kamarádů, nebo i odkaz na seznam kamarádů, pokud je veřejný.

(vložit počet kaček)

Vloží počet kaček.

(vložit počet zobáků)

Vloží počet zobáků.

Pokud je na vizitce vypsaný počet kaček i chtěné dárky, ukazuje se na jejich cenovce, kolik kaček chybí (protože by si to stejně každý mohl spočítat).

Otázky a odpovědi

Kde si můžu s AZJ hrát, aniž bych moc obtěžoval?
Ve zkušební nástěnce.

Kde všude to funguje?
V Alíkovinách a jejich diskuzích, v nástěnkách, v dopisech, ve vtipech, v poradnách, v novém formátu vizitek a také v místech, která mohou měnit jen správci (hry, soutěže, dárky, srazy, aukce). V nové klubovně s AZJ počítáme také.

Kde to nefunguje?
Ve starém formátu vizitek, ve staré klubovně… a v nadpisech/popisech věcí – v názvu Alíkoviny, nástěnky, obrázku atd. – obecně platí, že pokud vyplňujete jednořádkovou kolonku, tak tam patří obyčejný neformátovaný text. Až předěláme klubovnu, půjde AZJ používat i tam.

Mohu nějak zjistit, jak někdo jiný vytvořil určitý efekt v příspěvku?
Zkuste ve stránce hledat mráček, ten vám AZJ zdroje odkryje.
Pokud patříte mezi technicky šikovnější uživatele, možná víte, že všechny webové stránky se posílají do prohlížeče ve formátu HTML, který používá špičaté závorky. AZJ se sice u Alíka převádí na HTML (tedy z (tučně) se dělá „<b>“ apod.), ale zároveň se ten celý AZJ zápis ukládá i do komentáře, takže je součástí zdrojového HTML kódu. Pokud si zobrazíte zdrojový kód stránky (na počítači obvykle klávesovou zkratkou Ctrl+U), můžete v něm najít příslušný AZJ zápis… obvykle bude na začátku <!--AZJ.

Proč občas vidím u příkazů zámeček s nějakým kódem?
Kontrolní kód u zámečku hlídá, jestli zůstal obsah značky stejný. Díky zámečkům je možné, že třeba správce vloží do textu něco speciálního, co by běžný uživatel vložit nemohl, ale běžný uživatel může text okolo pořád neškodně upravovat – pokud nezasáhne do toho, co je zamčené, bude dotyčná specialita pořád funkční. Může ji nanejvýš smazat, nebo ji přesunout na jiné místo v tomtéž textu.

Proč má Alík vlastní formát a ne třeba BBCode nebo Markdown?
Jiné formáty se nepohodlně píší na české klávesnici. Hranaté závorky, mřížky… brr…

Z čeho vychází implementace emoji náhrad?
To je zajímavá otázka, která jistě trápí spoustu lidí. Proto tady veřejně děkujeme správcům repozitáře emoji-data na GitHubu za kompletní balíky – za obrázky i namapování.

Kdo určuje, jaké příkazy fungují?
–MM–. Jestli máš nějaký zajímavý nápad, co přidat, můžeš se rozpovídat na nástěnce.

Ptají se lidi na věci ohledně AZJ i v technické poradně?
Ano.