Alíkov značkovací jazyk

Na zapisovanie vecí sa na mnohých miestach v Alíkovi používa od júna 2020 druh zápisu, pomocou ktorého sa dajú vkladať zložitejšie veci.

Základná myšlienka tohto jazyka je, že všetky príkazy píšete do obyčajných zátvoriek, po slovensky, akoby ste niekomu diktovali pokyny len tak medzi rečou.

Štýlovanie textu

Každý príkaz na štýlovanie zruší všetko predchádzajúce štýlovanie. Koniec riadku tiež zruší všetko štýlovanie.

Čo všetko sa dá prikázať:

Tučné písmo (tučne).
Kurzíva (kurzívou).
Preškrtnutie (preškrtnute).
Indexy (horný index), (dolný index).
Farbičky: (červeno), (zeleno), (modro), (žlto), (modrozeleno), (fialovo), (ružovo), (hnedo), (oranžovo), (sivo), (dúhovo).
Podfarbenie/zvýraznenie (podfarbenie), rôzne farebné ↑.
Typ písma (strojovo), (kapitálkami), (písacím).
K obyčajnému štýlu sa dá vrátiť príkazom (obyčajne) alebo (normálne)…

Fungujú aj kombinácie, napríklad (oranžovou preškrtnutou kurzívou). Slová na štýlovanie sa dajú kombinovať aj s ostatnými príkazmi spomenutými nižšie.

Medzi rozpoznávanými farbičkami sú aj biela a čierna, ale na mnohých miestach nerobia nič, pretože čierna býva predvolená farba a biela by nebola viditeľná.

Základné možnosti

Odkazy: Bežne napísaná adresa v texte sa zmení na odkaz. Alebo je možné použiť príkaz (odkaz na https://www.alik.sk) nejaký text (koniec odkazu) (alebo len (koniec), ktorý vie ukončiť všetko).
Zoznamy: Bežne napísané odrážky sa zmenia na zoznam, ale okrem toho sa dá výslovne začať (zoznam) a potom ho ukončiť (koniec). Môže to byť aj (zoznam číslovaný) alebo (zoznam kladov a záporov) a pod., výslovne začaté zoznamy sa dajú tiež ľubovoľne vnárať do seba.
Nadpis: Kdekoľvek v rámci riadku môžete z daného riadku urobiť nadpis príkazom (nadpis). Nadpis sa vytvorí z celého riadku. Kto potrebuje viac úrovní nadpisov, môže použiť aj (malý nadpis).
Zarovnanie na stred a doprava: Kdekoľvek v rámci odseku môžete daný odsek (zarovnať doprava) alebo (na stred).
Obrázok: Každý obrázok má sedempísmenový kód, ktorý môžete vidieť v adrese, keď mu upravujete vlastnosti. Môžete teda vložiť napríklad (obrázok IEZKIYM), ak obrázok spĺňa podmienky pre dané miesto (schválenie, správna veľkosť, autorské práva).
Boxíky: Boxík sa píše medzi (boxík) a (koniec boxíka). Môže byť aj obtekaný (boxík vpravo) (ako je tu) alebo vľavo, podporuje aj farby.
Citácie: Citácia sa píše medzi (citácia) a (koniec citácie), k príkazu sa dá uviesť aj odkaz na zdroj alebo prezývka autora.
Oddeľovač: Vodorovná čiara je (oddeľovač). Funguje aj (malý oddeľovač) pre kratšiu čiaru.
Dážďovky: Ukazovateľ nejakého podielu, typicky napríklad počtu bodov, pozri napríklad počty kostí a bodiek v článku o Alíkovom vysvedčení. Zápis (dážďovka 25 %) alebo (dážďovka 1 / 4) zobrazí dážďovku vyplnenú do štvrtiny. Podporuje aj všetky farbičky. Ak je uvedené len samotné číslo, automaticky sa nájde maximum pre zadanú farbu, takže ak sú vedľa seba napríklad (modrá dážďovka 8) a (modrá dážďovka 16), tá prvá je vyplnená do polovice.
Emoji: V textoch sa bežne nahrádzajú znaky emoji obrázkami zo základnej sady, ktorú si môžete zmeniť v nastaveniach. Príkazmi (emoji microsoft), (emoji facebook), (emoji google), (emoji twitter) a (emoji apple) sa dá medzi sadami obrázkov prepínať.
Zátvorka: Keby ste potrebovali napísať príkaz tak, aby sa nespracoval, môžete jeho zátvorku napísať ako (zátvorka). Dá sa tiež obaliť kus textu medzi (prosto) a (azj); tým sa v ňom vypnú všetky AZJ náhrady a bude sa brať ako prostý text.

Interaktívne možnosti

Vyzradenie (teda spoiler): Skrytý text, ktorý sa dá zviditeľniť, sa napíše medzi (spoiler) a (koniec).
Odpočet do určitého času: Príkazom (odpočet do 1. 9. 2025 8:00) môžete vložiť živý odpočet času do konca letných prázdnin. Podobne funguje aj odpočet od nejakého času. Bežne sa vypisujú len čísla, ale od leta 2025 existuje aj variant (odpočet slovne). Podporuje aj všelijaké štýly textu.
Kvízy: Medzi značkami (kvíz) a (koniec kvízu) môžete definovať podobný interaktívny kvíz, aký má Alík vo svojom narodeninovom článku. Pri každej otázke musíte uviesť možnosti odsadené pomlčkou a nasledované počtom bodov, napríklad (3 b.). Na záver potom uvediete bloky v tvare (výsledok pre 8 až 10 b.). Ukážku celého zápisu predviedol v nástenke Tobias7, veľmi pekný návod spísal aj lékařský. Počty bodov musia byť celé čísla (ak cítite potrebu dávať polbody, vynásobte všetko dvomi), môžu byť aj záporné.
Tajničky: Medzi značkami (tajnička) a (koniec tajničky) môžete definovať podobnú interaktívnu tajničku, akú má Alík vo svojom narodeninovom článku. Na každý riadok musíte uviesť číslo riadku a slovo. Na záver potom uvediete blok v tvare (výsledok pre „riešenie“). Ukážku celého zápisu predviedla majdula2000.

Množstvo príkazov postupne rastie.

Chceme, aby bolo používanie čo najintuitívnejšie. Ak si všimneme, že sa niečo pokúšate nejako použiť a nefunguje vám to, premýšľame nad tým, či by to fungovať mohlo.

Ankety

Ankety je možné vytvárať príkazom (anketa) a musia byť ukončené príkazom (koniec). Prvé riadky v ankete neodsadené pomlčkou sú otázka, ďalšie riadky odsadené pomlčkou sú možnosti.

Každá vytvorená anketa môže mať niekoľko vlastností, ktoré sa dajú kombinovať:

(anonymná anketa): Nezobrazuje sa, kto ako hlasoval. Ak anketa nie je anonymná, pod každou možnosťou sa zobrazujú ikonky hlasujúcich.
(zdieľaná anketa): Anketu je možné vložiť aj na iné miesta. Potom ju môže vložiť ktokoľvek kamkoľvek. Preto je vhodné, aby v nej bola otázka dobre a úplne vyjadrená (nezávislá od okolia). Anketa bude mať priradený sedempísmenový kód podobný tomu, aký majú obrázky, potom sa dá vložiť príkazom (vložiť anketu ZCDLBLN).
(anketa do 24. 12. 2020): Čas konca ankety; po ňom už nejde hlasovať.
(objektívna anketa): Možnosti sú náhodne premiešané a nie je vidieť aktuálny stav hlasov, takže sa ľudia navzájom neovplyvňujú. Skutočný stav hlasov je odhalený až po skončení, ak existuje dátum konca ankety.; Pokiaľ nie je žiadny dátum konca, stav sa človeku ukáže po zahlasovaní av takom prípade nemôže hlas dodatočne zmeniť. Dôrazne odporúčame, aby existovala nejaká úniková možnosť typu „nechcem hlasovať“ pre ľudí, ktorých zaujíma stav, ale nechcú vyjadriť žiadny názor.

Keďže každá anketa funguje ako samostatný AZJ text, nie je dovolené vynechať príkaz (koniec) a je v nej zakázaný príkaz (dážďovka) (pretože dážďovky by sa mohli navzájom ovplyvňovať).

Celý zápis ankety môže vyzerať napríklad takto:

(anonymná objektivná anketa do 1. 7. 2026)
Ktoré Alíkovo pexeso by vám urobilo najväčšiu radosť?
- Mývalie.
- Vydrie.
- Ťavie.
(koniec)

Ak má anketa jedinú možnosť, môžu hlasujúci svoj hlas odvolať.

Ankety boli dlho vo vývoji. Ak vám pripadá, že niektoré stavy a možnosti ankiet nie sú úplne dotiahnuté, hláste, prosím, čokoľvek, čo vás prekvapí alebo zarazí, do technickej poradne.

Príkazy pre vizitky

Experimentálne sa dá AZJ používať aj v novom formáte vizitiek, na ktorý postupne prejdeme – tam existuje aj pár špeciálnych príkazov na výpisy rôznych zoznamov:

(vložiť napísané články): Vloží články napísané majiteľom vizitky. Ak tam niekto nechce staršie články, môže obmedziť aj obdobie, napríklad (vložiť články napísané po 1. 1. 2025).
(vložiť moderované nástenky) / (vložiť založené nástenky) / (vložiť obľúbené nástenky): Vloží nástenky moderované/založené/obľúbené majiteľom vizitky.
(vložiť obľúbené hry) / (vložiť vyrobené hry): Vloží hry obľúbené/vyrobené majiteľom vizitky.
(vložiť zúčastnené stretnutia) / (vložiť organizované stretnutia): Vloží stretnutia zúčastnené/organizované majiteľom vizitky.
(vložiť napísané vtipy) / (vložiť obľúbené vtipy): Vloží vtipy napísané/obľúbené majiteľom vizitky. Obľúbené vtipy sa dajú zapnúť v nastaveniach.
(vložiť želané darčeky) / (vložiť objednané darčeky): Vloží darčeky želané/objednané majiteľom vizitky. (Používateľ si môže pri darčeku hviezdičkou poznačiť, že si naň šetrí.)
(vložiť kamarátov): Vloží zoznam kamarátov majiteľa vizitky.
(vložiť Alíka): Vloží ilustračný obrázok Alíka, vhodný napríklad na jasnejšie oddelenie blokov.

Bloky je možné aj viackrát zopakovať, ak majiteľ vizitky chce dlhší zoznam. Okrem veľkých blokov sa dajú vkladať aj automaticky dopĺňané texty:

(vložiť počet kamarátov): Vloží buď samotný počet kamarátov, alebo aj odkaz na zoznam kamarátov, ak je verejný.
(vložiť počet kačiek): Vloží počet kačiek.
(vložiť počet zobákov): Vloží počet zobákov.

Ak je na vizitke vypísaný počet kačiek aj želané darčeky, na ich cenovke sa zobrazuje, koľko kačiek chýba (pretože by si to aj tak každý vedel spočítať).

Otázky a odpovede

Kde sa môžem s AZJ hrať, aby som príliš neobťažoval?
V skúšobnej nástenke.

Kde všade to funguje?
V Alíkovinách a ich diskusiách, v nástenkách, v listoch, vo vtipoch, v poradniach, v novom formáte vizitiek a aj na miestach, ktoré môžu meniť iba správcovia (hry, súťaže, darčeky, stretnutia, aukcie). V novej klubovni s AZJ počítame tiež.

Kde to nefunguje?
V starom formáte vizitiek, v starej klubovni… a v nadpisoch/popisoch vecí – v názve Alíkovín, nástenky, obrázka atď. – vo všeobecnosti platí, že ak vypĺňate jednoriadkové políčko, patrí tam obyčajný neformátovaný text. Keď prerobíme klubovňu, bude sa dať AZJ používať aj tam.

Môžem nejako zistiť, ako niekto iný vytvoril určitý efekt v príspevku?
Skúste na stránke hľadať mráčik, ten vám odkryje AZJ zdroje.
Ak patríte medzi technicky šikovnejších používateľov, možno viete, že všetky webové stránky sa posielajú do prehliadača vo formáte HTML, ktorý používa špicaté zátvorky. AZJ sa síce u Alíka prevádza na HTML (teda z (tučne) sa robí „<b>“ a pod.), ale zároveň sa celý AZJ zápis ukladá aj do komentára, takže je súčasťou zdrojového HTML kódu. Ak si zobrazíte zdrojový kód stránky (na počítači zvyčajne klávesovou skratkou Ctrl+U), môžete v ňom nájsť príslušný AZJ zápis… zvyčajne bude na začiatku <!--AZJ.

Prečo občas vidím pri príkazoch zámok s nejakým kódom?
Kontrolný kód pri zámku stráži, či zostal obsah značky rovnaký. Vďaka zámkom je možné, že napríklad správca vloží do textu niečo špeciálne, čo by bežný používateľ vložiť nemohol, ale bežný používateľ môže text okolo stále neškodne upravovať – ak nezasiahne do toho, čo je zamknuté, bude daná špecialita stále funkčná. Nanajvýš ju môže zmazať alebo presunúť na iné miesto v tom istom texte.

Prečo má Alík vlastný formát a nie napríklad BBCode alebo Markdown?
Iné formáty sa nepohodlne píšu na slovenskej klávesnici. Hranaté zátvorky, mriežky… brr…

Z čoho vychádza implementácia náhrad emoji?
To je zaujímavá otázka, ktorá iste trápi veľa ľudí. Preto tu verejne ďakujeme správcom repozitára emoji-data na GitHube za kompletné balíky – za obrázky aj mapovanie.

Kto určuje, aké príkazy fungujú?
–MM–. Ak máš nejaký zaujímavý nápad, čo pridať, môžeš sa rozrozprávať na nástenke.

Pýtajú sa ľudia na veci ohľadom AZJ aj v technickej poradni?
Áno.