Dokumentace programovacího jazyka K

K je moderní, super-lehký programovací jazyk navržený pro rychlé psaní skriptů, programů a moderních interaktivních webových aplikací.

Jak začít programovat v K (Krok za krokem)

Programování je jen psaní instrukcí do textového souboru, které počítač následně provede. Zde je návod, jak napsat a spustit svůj úplně první program v jazyce K:

Otevřete textový editor: Můžete použít jakýkoliv editor kódu (např. VS Code) nebo obyčejný Poznámkový blok.
Vytvořte nový soubor: Uložte soubor s názvem muj_program.k (důležitá je koncovka .k).
Napište svůj první příkaz: Do souboru napište tento jednoduchý text:
```
say "Ahoj, toto je muj prvni program v K!"
```
Spusťte program: Otevřete terminál (příkazovou řádku), přejděte do složky s programem a napište:
```
node cli.js run muj_program.k
```
Sledujte výsledek: Počítač přečte instrukci say a vypíše do terminálu text: Ahoj, toto je muj prvni program v K!

Gratulujeme! Právě jste napsali a spustili svůj první program. Níže naleznete popis všech dalších příkazů, kterými můžete počítači dávat složitější úkoly.

1. Úvod

Jazyk K vznikl s cílem zkombinovat jednoduchost skriptování s moderní tvorbou uživatelských rozhraní. Odstraňuje zbytečnou syntaxi (jako povinné středníky na konci každého řádku) a přináší:

Skriptovací režim: Klasické programování (proměnné, cykly, funkce, matematika) běžící v Node.js.
Webový režim: Psaní celých stránek bez nutnosti míchat HTML tagy s Javascriptem. Vše píšete v jednotném, přehledném formátu.

2. Proměnné a datové typy

Proměnné se deklarují klíčovými slovy let (měnitelné) nebo const (neměnné). K podporuje textové řetězce, čísla i logické hodnoty.

// Deklarace proměnných
let uzivatel = "Martin"
const maxSkore = 100

// Změna hodnoty
uzivatel = "Petr"

Tip: Středníky na konci řádku jsou v K nepovinné. Compiler je automaticky doplní za vás.

3. Operace a Výpisy

Pro výpis do konzole slouží zjednodušené klíčové slovo say (nebo klasické print). Kulaté závorky kolem vypisovaného textu či hodnoty jsou zcela nepovinné.

let x = 15
let y = 10

// Matematika
let soucet = x + y
let rozdil = x - y

say "Součet je: " + soucet
say rozdil

4. Podmínky a Smyčky

Podmínky a cykly se zapisují stejně jako v jazycích C, C++ nebo PHP, ale bez nutnosti kulatých závorek kolem podmínek.

Podmínky (If / Else)

let vek = 20

if vek == 18 {
    say "Právě jsi dospělý!"
} else if vek > 18 {
    say "Jsi dospělý."
} else {
    say "Jsi nezletilý."
}

Smyčky (While)

let i = 1
while i != 4 {
    say "Opakování: " + i
    i = i + 1
}

5. Funkce

Funkce se definují pomocí klíčového slova fn, mohou přijímat parametry a vracet hodnoty pomocí return.

// Definice funkce
fn pozdrav(jmeno) {
    return "Ahoj, " + jmeno + "!"
}

// Volání funkce
let zprava = pozdrav("Jano")
say zprava

6. Tvorba Webu

Chcete-li postavit web, vytvoříte blok page. V něm definujete proměnnou title a strukturu HTML elementů, které se zapisují jako bloky s vlnitými závorkami {}. Události (např. onclick) se píší do kulatých závorek elementu.

page MojeStranka {
    let title = "Můj první K Web"

    div {
        h1 { "Vítejte v K" }
        p { "Tento web byl vygenerován z čistého K kódu." }
        button(onclick: klik) { "Klikni na mě" }
    }

    // Funkce běžící přímo v prohlížeči
    fn klik() {
        alert("Ahoj z webového prohlížeče!")
    }
}

Automatický Design: K-compiler při sestavení webu automaticky vloží moderní tmavý design, prémiové písmo Plus Jakarta Sans, stíny a plynulé přechody, takže váš web vypadá skvěle bez nutnosti psát CSS!

7. Jak spouštět a používat CLI

Používejte soubor cli.js ve svém terminálu:

Spuštění skriptu

node cli.js run jmeno_souboru.k

Sestavení webu do HTML

node cli.js build jmeno_souboru.k