Home /Modules/docs/README.CZ.md

README.CZ.md

docs/i18n/README.CZ.md · 772 line(s) · markdown

<img align="right" src="../../images/sleela/sleela-medium-profile-permanent-icon-002.jpg" width="45" height="45" alt="SLeeLa">

SLeeLa 3.0 — Česká republika (CZ)

<p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela/sleela-wordmark.svg" alt="SLeeLa — The Now. The Ingredient." width="560"></p> <p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela-programming-language-002.jpg" alt="Marketingové logo SLeeLa" width="560"></p>

<p align="center"><strong>Nativní systémový jazyk, překladač, runtime a ekosystém virtuálních strojů.</strong></p> <p align="center"><a href="https://github.com/mearvk/SLeeLa/actions"><img alt="GitHub Actions" src="https://img.shields.io/github/actions/workflow/status/mearvk/SLeeLa/test-suite.yml?branch=main&label=test%20suite"></a> <a href="../../docs/PLATFORM-SUPPORT.md"><img alt="Platform matrix" src="https://img.shields.io/badge/platforms-Linux%20%7C%20macOS%20%7C%20Windows-273238"></a></p>

Mezinárodní národní edice. Tato edice je v češtině. Technické identifikátory, příkazy, ukázky kódu, názvy souborů, cesty a odkazy zůstávají beze změny oproti kanonickému anglickému README.md.

The Now. The Ingredient. Jazyk je víc než syntaxe: je to překladač, runtime, knihovny, nástroje a platformní smlouvy, díky nimž je software použitelný.

Čím se SLeeLa zabývá. SLeeLa se zabývá oblastmi Math, Object, Science a Reach — čtyřmi tvářemi své práce: počitatelným (Math), usazenou věcí stojící v katalogu toho, co jest (Object), kázněným studiem pravdivého (Science) a rozšířením ruky systému k jiným systémům a lidem (Reach). Národní zájmy zůstávají — žádná ze čtyř oblastí je neodsouvá stranou; kde se téma dotýká zájmu některého národa, toto postavení se zachovává (věrně se zaznamenává např. v metadatech každé třídy metaOrigin / metaNationalSchedule) a nikdy se nerozpouští.

I. Začínáme

II. Novinky

Nedávné přírůstky v jazyce, ovladačích a standardní knihovně:

III. Sestavení a testování

Požadavky: toolchain C/C++ (GCC nebo Clang) a GNU Make; Python 3 pro nástroje manifestů a toků; na Linuxu vývojové balíčky X11/Xrandr pro zobrazovací produkty (make deps daného modulu ohlásí/nainstaluje, co potřebuje). Sestavení impl/ je fail-closed vůči důvěryhodnému manifestu SHA-256, na který kořenový Makefile odkazuje automaticky.

Z čistého checkoutu nejrychleji začnete takto:

make                                  # sestaví vše z kořene repozitáře

Nebo sestavte a otestujte pouze nativní jádro:

make -C impl all                      # sestaví pouze jádro překladače/runtime
bash ./test-suites/run-all.sh --all   # spustí celou testovací sadu

Kořenový make sestavuje každý produkt (jádro, VM, kodeky, churn, antivirus, …) a končí sestavením registru a materializací jeho základní tabulky — takže sestavený strom dodává revidovatelný registr rovnou po vybalení. Základní cíle:

make                     # build everything (alias of `make all`; registry runs last)
make all                 # the same full build, named explicitly
sudo make install        # install commands + runtime support (see §IV)
make clean               # remove build outputs from every dispatched build system
make help                # list every target the root Makefile provides

Další užitečné cíle:

make registry            # just the registry: build + materialize the table
./build-registry.sh      # same thing, invoked directly
make tests               # build and run the test suite
make ballum              # build the Ballum display library for this OS (see ballum/)
bin/install-modules      # paced install/build of each module over ~10-20 min (see bin/)

Cíl registry spouští build-registry.sh: sestaví jádro registru, nasází základní tabulku do přenositelného textového úložiště registry/build/sleela.sleelareg a exportuje skript tabulky MySQL registry/build/registry.sql (pomocí sleela registry export). Zkontrolujte jej příkazem sleela registry nebo registry/build/sleela-registry review. Viz příručka Registry a architektura Registry 3.0.

Požadavky a kroky specifické pro platformu najdete v průvodcích sestavením a testováním. Úspěšné sestavení jedné komponenty nedokazuje, že jsou všechny knihovny nebo platformy připraveny k vydání.

IV. Instalace

Po sestavení nativních produktů nainstalujte příkazy a soubory podpory runtime:

sudo make install
make install PREFIX="$HOME/.local"       # user-local install, no sudo
make install DESTDIR="$PWD/package-root" # staged package install
make install-check

Konvenční instalátor ve výchozím stavu používá /usr/local/bin, /usr/local/lib/sleela a /usr/local/share/sleela. Zachovává existující konfiguraci spouštění a odmítá přepsat existující příkazy, které nejsou pod jeho správou. Odinstalace odstraňuje pouze soubory zaznamenané instalátorem a zachovává konfiguraci i nesledovaná data runtime.

Pro cílené, řízené nasazení pouze hlavního balíčku — binárních souborů sleela, sleelvac a nordshrift, standardní knihovny, protokolů a podpůrných modulů — použijte čistý instalátor:

make clean-install       # guided install of the main package only

Činí jedno primární rozhodnutí (nainstalovat hlavní balíček), poté volbu rozsahu a po úspěchu nabídne volitelný výběr z kurátorských rozšiřujících modulů. Interaktivní postup nasazení a všechny možnosti instalace viz Rychlá a bezpečná instalace.

V. Jazyk a runtime

Závaznou gramatikou je SLEELA.syntax. Aktuální repozitář dokumentuje syntaxi 3.0; verze překladače/nástrojů a verze zdrojové syntaxe jsou odlišné pojmy. Povrch 3.0 přidává dokumentové značky pure a gasoline (§30) — dvojici holých, kontextových, čistě deklarativních Preonems, které znamenají téměř totéž a každá označuje postavení dokumentu svou vlastní upřímností. Syntaxe 3.0 sjednocuje jazykový povrch 1.0–2.9 do aktuální normativní edice a zachovává všechny minimální verzní podmínky jednotlivých funkcí. Předchozí povrch 2.9 přidává navazující pole @mix (§28) — třída může deklarovat více instančních polí se stejným názvem, pokud každé nese @mix, chápaných jako jedna indexovaná skupina (shora dolů 1,2,3,… nebo ručně @mix(1,2,3,...), jehož počet indexů musí odpovídat skupině). Přenáší dále dvojkově založené rodiny širokých celých čísel se znaménkem a bez něj int32..int16777216 (§24) a uint32..uint16777216 (§25) nad dřívějšími long/int64/int128 (§21); dokumenty podporující klíčová slova (§22); a Preonems — čistě deklarativní dokumentové značky author/authorial (§18), material/memory (§19–§20), determine (§23), object/field (§26), pure/gasoline (§30) a artifact (§35, postavení legislativní úrovně odstupňované k času a prostoru), souhrnně nazývané Preonems (§26.1). Rozlišení přetížení konstruktorů a delegování this(...)/konstruktoru báze jsou výslovně mimo ověřený kontrakt syntaxe 1.8. Než se na některou funkci spolehnete, prostudujte gramatiku a poznámky k implementaci. Devět zdrojových jednotek SleelaDoc nyní deklaruje #sleela 3.0; sdílená brána překladače přijímá zdrojovou syntaxi 1.0–3.0. Nové sestavení API vzniká příkazem make api-docs.

Repozitář obsahuje nativní implementaci v C/C++, reference generování SLVM, moduly standardní knihovny, testy, příklady a platformní integrace. Stav implementace a validace se u jednotlivých modulů liší; řiďte se jeho specifikací a aktuálními výsledky CI a nepředpokládejte jednotnou úplnost.

VI. Zásady inženýrství

VII. Sestavení a integrita antiviru

Antivirový balíček Sleelavirin obsahuje nativní skener SHA-256, volitelný adaptér ClamAV, manifesty integrity zdrojů/indexů a kontrolní součty platformních balíčků. Balíček sestavte a otestujte z kořene repozitáře:

make antivirus
make antivirus-test
make antivirus-integrity
make antivirus-integrity-check MANIFEST=build/INTEGRITY-MANIFEST.json

Manifest integrity se generuje pod antivirus/build/; pokrývá sledované zdrojové a dokumentační vstupy i chráněné soubory indexu signatur, přičemž vylučuje generovaný výstup a proměnlivou cache ClamAV. Snímky databáze ClamAV mají vlastní manifesty. Vydané archivy ZIP obsahují INTEGRITY-MANIFEST.json, SHA256SUMS a doprovodný soubor .sha256. Hashe stažených archivů ověřujte proti důvěryhodné hodnotě získané nezávisle: kontrolní součet uložený vedle archivu není podpisem vydavatele. Viz příručka Sleelavirin, bezpečnostní kontrolní seznam a workflow sestavení antiviru.

Vydání se nepovažuje za ověřené, dokud příslušné úlohy CI neprojdou na přesném commitu vydání a výsledné artefakty nebyly zkontrolovány.

VIII. Editorová témata SLeeLa — Vim a Emacs

SLeeLa obsahuje koordinovanou sadu profesionálních tmavých barevných schémat pro Vim a Emacs a nativní palettovou utilitu v C/C++. Původní schéma American Professional zůstává výchozí. K dispozici je deset doprovodných palet inspirovaných různými kulturními a institucionálními designovými tradicemi; jde o interpretační designové palety, nikoli o oficiální reprezentaci jakéhokoli národa, kultury, soudu či instituce.

Jedenáct schémat a jejich barvy

SchémaPozadíPopředíKlíčová slovaTypyŘetězceKomentáře
American Professional<span style="display:inline-block;width:1em;height:1em;background:#101820;border:1px solid #888"></span> #101820<span style="display:inline-block;width:1em;height:1em;background:#F4F7FA;border:1px solid #888"></span> #F4F7FA<span style="display:inline-block;width:1em;height:1em;background:#7FB3FF;border:1px solid #888"></span> #7FB3FF<span style="display:inline-block;width:1em;height:1em;background:#73DACA;border:1px solid #888"></span> #73DACA<span style="display:inline-block;width:1em;height:1em;background:#F2C078;border:1px solid #888"></span> #F2C078<span style="display:inline-block;width:1em;height:1em;background:#8A96A3;border:1px solid #888"></span> #8A96A3
Pan-Eurasian<span style="display:inline-block;width:1em;height:1em;background:#111827;border:1px solid #888"></span> #111827<span style="display:inline-block;width:1em;height:1em;background:#F0F2F5;border:1px solid #888"></span> #F0F2F5<span style="display:inline-block;width:1em;height:1em;background:#7AA7E8;border:1px solid #888"></span> #7AA7E8<span style="display:inline-block;width:1em;height:1em;background:#69C9B3;border:1px solid #888"></span> #69C9B3<span style="display:inline-block;width:1em;height:1em;background:#D7B56D;border:1px solid #888"></span> #D7B56D<span style="display:inline-block;width:1em;height:1em;background:#8995A5;border:1px solid #888"></span> #8995A5
Russian and Slavic — Medium<span style="display:inline-block;width:1em;height:1em;background:#202733;border:1px solid #888"></span> #202733<span style="display:inline-block;width:1em;height:1em;background:#E8EAF0;border:1px solid #888"></span> #E8EAF0<span style="display:inline-block;width:1em;height:1em;background:#A9C0DD;border:1px solid #888"></span> #A9C0DD<span style="display:inline-block;width:1em;height:1em;background:#8FC4B2;border:1px solid #888"></span> #8FC4B2<span style="display:inline-block;width:1em;height:1em;background:#D6BD8B;border:1px solid #888"></span> #D6BD8B<span style="display:inline-block;width:1em;height:1em;background:#9AA3AF;border:1px solid #888"></span> #9AA3AF
Central Asian / Silk Road<span style="display:inline-block;width:1em;height:1em;background:#1C2529;border:1px solid #888"></span> #1C2529<span style="display:inline-block;width:1em;height:1em;background:#F5F0E5;border:1px solid #888"></span> #F5F0E5<span style="display:inline-block;width:1em;height:1em;background:#7FADE0;border:1px solid #888"></span> #7FADE0<span style="display:inline-block;width:1em;height:1em;background:#45C6C2;border:1px solid #888"></span> #45C6C2<span style="display:inline-block;width:1em;height:1em;background:#D9B56D;border:1px solid #888"></span> #D9B56D<span style="display:inline-block;width:1em;height:1em;background:#92A3A0;border:1px solid #888"></span> #92A3A0
East Asian<span style="display:inline-block;width:1em;height:1em;background:#171A1C;border:1px solid #888"></span> #171A1C<span style="display:inline-block;width:1em;height:1em;background:#F2EFE7;border:1px solid #888"></span> #F2EFE7<span style="display:inline-block;width:1em;height:1em;background:#D97878;border:1px solid #888"></span> #D97878<span style="display:inline-block;width:1em;height:1em;background:#72C7A5;border:1px solid #888"></span> #72C7A5<span style="display:inline-block;width:1em;height:1em;background:#D8B76A;border:1px solid #888"></span> #D8B76A<span style="display:inline-block;width:1em;height:1em;background:#969F9B;border:1px solid #888"></span> #969F9B
ICC — International Criminal Court<span style="display:inline-block;width:1em;height:1em;background:#0E1A2B;border:1px solid #888"></span> #0E1A2B<span style="display:inline-block;width:1em;height:1em;background:#EAF0F7;border:1px solid #888"></span> #EAF0F7<span style="display:inline-block;width:1em;height:1em;background:#5B8FD6;border:1px solid #888"></span> #5B8FD6<span style="display:inline-block;width:1em;height:1em;background:#7FB7C9;border:1px solid #888"></span> #7FB7C9<span style="display:inline-block;width:1em;height:1em;background:#D9B25A;border:1px solid #888"></span> #D9B25A<span style="display:inline-block;width:1em;height:1em;background:#7E8CA0;border:1px solid #888"></span> #7E8CA0
SCOTUS — U.S. Supreme Court<span style="display:inline-block;width:1em;height:1em;background:#1A1416;border:1px solid #888"></span> #1A1416<span style="display:inline-block;width:1em;height:1em;background:#F3EEE6;border:1px solid #888"></span> #F3EEE6<span style="display:inline-block;width:1em;height:1em;background:#9E2B35;border:1px solid #888"></span> #9E2B35<span style="display:inline-block;width:1em;height:1em;background:#8FA9B8;border:1px solid #888"></span> #8FA9B8<span style="display:inline-block;width:1em;height:1em;background:#C9A24B;border:1px solid #888"></span> #C9A24B<span style="display:inline-block;width:1em;height:1em;background:#8C8178;border:1px solid #888"></span> #8C8178
Greek (Hellenic)<span style="display:inline-block;width:1em;height:1em;background:#0A1A30;border:1px solid #888"></span> #0A1A30<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFF<span style="display:inline-block;width:1em;height:1em;background:#2E7BD6;border:1px solid #888"></span> #2E7BD6<span style="display:inline-block;width:1em;height:1em;background:#5E9FE0;border:1px solid #888"></span> #5E9FE0<span style="display:inline-block;width:1em;height:1em;background:#9FC3EC;border:1px solid #888"></span> #9FC3EC<span style="display:inline-block;width:1em;height:1em;background:#6E86A6;border:1px solid #888"></span> #6E86A6
Turkish (Al Bayrak)<span style="display:inline-block;width:1em;height:1em;background:#2A0609;border:1px solid #888"></span> #2A0609<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFF<span style="display:inline-block;width:1em;height:1em;background:#F23D48;border:1px solid #888"></span> #F23D48<span style="display:inline-block;width:1em;height:1em;background:#F0A9AE;border:1px solid #888"></span> #F0A9AE<span style="display:inline-block;width:1em;height:1em;background:#F0C9A9;border:1px solid #888"></span> #F0C9A9<span style="display:inline-block;width:1em;height:1em;background:#A8767A;border:1px solid #888"></span> #A8767A
Kiro<span style="display:inline-block;width:1em;height:1em;background:#0B0B12;border:1px solid #888"></span> #0B0B12<span style="display:inline-block;width:1em;height:1em;background:#F5F5FA;border:1px solid #888"></span> #F5F5FA<span style="display:inline-block;width:1em;height:1em;background:#A98EDA;border:1px solid #888"></span> #A98EDA<span style="display:inline-block;width:1em;height:1em;background:#6E8BE0;border:1px solid #888"></span> #6E8BE0<span style="display:inline-block;width:1em;height:1em;background:#E8C547;border:1px solid #888"></span> #E8C547<span style="display:inline-block;width:1em;height:1em;background:#6A6482;border:1px solid #888"></span> #6A6482
SLeeLa<span style="display:inline-block;width:1em;height:1em;background:#08080E;border:1px solid #888"></span> #08080E<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFF<span style="display:inline-block;width:1em;height:1em;background:#B07CFF;border:1px solid #888"></span> #B07CFF<span style="display:inline-block;width:1em;height:1em;background:#5A7CFF;border:1px solid #888"></span> #5A7CFF<span style="display:inline-block;width:1em;height:1em;background:#FFD21E;border:1px solid #888"></span> #FFD21E<span style="display:inline-block;width:1em;height:1em;background:#6E5F9E;border:1px solid #888"></span> #6E5F9E

Barvy národních vlajek (zdrojová paleta)

Řecké a turecké schéma jsou odvozena z oficiálních barev národních vlajek obou zemí, zde uvedených s jejich přesnými publikovanými hodnotami hex. Pozadí a akcenty schémat výše jsou ztmavené, pro editor přívětivé interpretace těchto zdrojových barev — tabulka níže je referencí „barev tak, jak jsou národně vystaveny“.

NárodBarvaHexZáklad a význam
ŘeckoModrá<span style="display:inline-block;width:1em;height:1em;background:#0D5EAF;border:1px solid #888"></span> #0D5EAFModř národní vlajky (zákon 851/1978). Nebe a moře; heraldicky blasonována jako azure.
ŘeckoBílá<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFBělost národní vlajky. Čistota boje za nezávislost; kříž označuje východní pravoslavné křesťanství.
TürkiyeČervená (al bayrak)<span style="display:inline-block;width:1em;height:1em;background:#E30A17;border:1px solid #888"></span> #E30A17Červeň národní vlajky (turecký zákon o vlajce). Pole; podle tradice krev mučedníků a osmanská suverenita.
TürkiyeBílá<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFBělost národní vlajky. Půlměsíc a hvězda — mír, čistota a symbol turkického/islámského dědictví.

Schémata ukotvují popředí každého editoru na národní bílé a jeho klíčová slova, kurzor, výběr a stavový řádek na přesné národní modré (#0D5EAF) nebo červené (#E30A17), takže důležité barvy jsou doslova barvami národními. Jde o interpretační designové palety; reference barev vlajek je uvedena kvůli původu a není oficiální reprezentací žádného ze států. Významy barev vycházejí z popisu státních symbolů ministerstva zahraničních věcí Helénské republiky a z tradice tureckého zákona o vlajce.

Tabulka barevných vzorků

Buňky palet níže používají vzorky SVG, takže GitHub vykreslí skutečné barvy místo prázdných buněk HTML. Každý proužek ukazuje šest barev v tomto pořadí: pozadí, popředí, klíčová slova, typy, řetězce a komentáře. Přesné kódy hex jsou uvedeny vedle každého vzorku, ve stejném pořadí schémat jako ve výše uvedené referenční tabulce.

SchémaVykreslené barvy paletyKódy hex (pozadí · popředí · klíčová slova · typy · řetězce · komentáře)
American ProfessionalAmerican Professional palette: background, foreground, keywords, types, strings, comments#101820 · #F4F7FA · #7FB3FF · #73DACA · #F2C078 · #8A96A3
Pan-EurasianPan-Eurasian palette: background, foreground, keywords, types, strings, comments#111827 · #F0F2F5 · #7AA7E8 · #69C9B3 · #D7B56D · #8995A5
Russian and Slavic — MediumRussian and Slavic Medium palette: background, foreground, keywords, types, strings, comments#202733 · #E8EAF0 · #A9C0DD · #8FC4B2 · #D6BD8B · #9AA3AF
Central Asian / Silk RoadCentral Asian Silk Road palette: background, foreground, keywords, types, strings, comments#1C2529 · #F5F0E5 · #7FADE0 · #45C6C2 · #D9B56D · #92A3A0
East AsianEast Asian palette: background, foreground, keywords, types, strings, comments#171A1C · #F2EFE7 · #D97878 · #72C7A5 · #D8B76A · #969F9B
ICC — International Criminal CourtICC palette: background, foreground, keywords, types, strings, comments#0E1A2B · #EAF0F7 · #5B8FD6 · #7FB7C9 · #D9B25A · #7E8CA0
SCOTUS — U.S. Supreme CourtSCOTUS palette: background, foreground, keywords, types, strings, comments#1A1416 · #F3EEE6 · #9E2B35 · #8FA9B8 · #C9A24B · #8C8178
Greek (Hellenic)Greek Hellenic palette: background, foreground, keywords, types, strings, comments#0A1A30 · #FFFFFF · #2E7BD6 · #5E9FE0 · #9FC3EC · #6E86A6
Turkish (Al Bayrak)Turkish Al Bayrak palette: background, foreground, keywords, types, strings, comments#2A0609 · #FFFFFF · #F23D48 · #F0A9AE · #F0C9A9 · #A8767A
KiroKiro palette: background, foreground, keywords, types, strings, comments#0B0B12 · #F5F5FA · #A98EDA · #6E8BE0 · #E8C547 · #6A6482
SLeeLaSLeeLa palette: background, foreground, keywords, types, strings, comments#08080E · #FFFFFF · #B07CFF · #5A7CFF · #FFD21E · #6E5F9E

Další akcentní barvy se používají pro funkce, konstanty, výběry, diagnostiku a direktivy preprocesoru. Ruská a slovanská paleta záměrně používá středně intenzivní břidlicovou, modrou, šalvějovou, rubínovou a starozlatou pro klidnější profesionální vzhled.

Instalace schémat pro Vim

Z kořene repozitáře:

mkdir -p ~/.vim/{syntax,ftdetect,colors}
cp lib/linux-editors/vim/syntax/sleela.vim ~/.vim/syntax/
cp lib/linux-editors/vim/ftdetect/sleela.vim ~/.vim/ftdetect/
cp lib/linux-editors/vim/colors/sleela-*.vim ~/.vim/colors/

Do ~/.vimrc přidejte následující, abyste zapnuli zvýrazňování syntaxe SLeeLa a vybrali schéma:

syntax enable
set background=dark
colorscheme sleela-american

Zvolte přesně jeden z těchto názvů colorscheme:

Například použijte colorscheme sleela-russian-slavic pro střední ruskou a slovanskou paletu, nebo colorscheme sleela-greek / colorscheme sleela-turkish pro palety Hellenic a Al Bayrak. Restartujte Vim nebo načtěte konfiguraci příkazem :source $MYVIMRC.

Instalace schémat pro Emacs

Vytvořte místní adresář témat a zkopírujte soubory režimu a témat z kořene repozitáře:

mkdir -p ~/.emacs.d/sleela
cp lib/linux-editors/emacs/sleela-mode.el ~/.emacs.d/sleela/
cp lib/linux-editors/emacs/sleela-*-theme.el ~/.emacs.d/sleela/

Přidejte toto do ~/.emacs nebo ~/.emacs.d/init.el:

(add-to-list 'load-path (expand-file-name "~/.emacs.d/sleela"))
(add-to-list 'custom-theme-load-path (expand-file-name "~/.emacs.d/sleela"))
(require 'sleela-mode)
(load-theme 'sleela-american t)

Chcete-li vybrat jiné schéma, nahraďte sleela-american hodnotou sleela-eurasia, sleela-russian-slavic, sleela-silk-road, sleela-east-asian, sleela-greek, sleela-turkish, sleela-kiro nebo sleela-sleela. Pokud se Emacs zeptá, zda tématu důvěřovat, před potvrzením zkontrolujte místní soubor tématu.

Náhled nativních palet C/C++

Malá nativní palettová utilita umí vypsat schémata, vytisknout jejich barvy pro terminál a vyhledat jednotlivou barvu:

make -C linux-editors
./linux-editors/build/sleela-editor-theme --themes
./linux-editors/build/sleela-editor-theme --theme eurasia --palette
./linux-editors/build/sleela-editor-theme --theme russian-slavic --hex keyword
make -C linux-editors test

Kvůli zpětné kompatibilitě volby --palette a --hex COLOR bez --theme vybírají American Professional. Výsledky sestavení a testů je třeba ověřit na cílovém systému a v CI; dokumentace příkazu sama o sobě není důkazem, že prošel.

Úplné popisy palet a podrobnosti o utilitě viz průvodce integrací editorů.

IX. Přispívání

  1. Přečtěte si rejstřík dokumentace a zásady testování.
  2. Provádějte cílené změny s pozitivními i negativními testy.
  3. Spusťte cílené testy, poté širokou sadu.
  4. Uveďte podrobnosti o OS a toolchainu; přeskočené kontroly nepopisujte jako úspěšné.

SLeeLa vyvíjí MEARVK LLC. Historický materiál úvodní stránky je zachován v docs/README-LEGACY.md.

X. AE6E66 — Očekávání odvodu z Round Public e-mailu

U iniciativy AE6E66 je deklarovaným očekáváním projektu $300,000,000.00 USD za každý Round Public e-mail jako navrhovaná výše daňového odvodu spojená s každým kvalifikujícím Round Public e-mailem.

Toto prohlášení zaznamenává pouze očekávání projektu. Není to právní daňový výměr, vládní nařízení, soudní rozsudek ani nezávisle stanovená daňová povinnost. Jakýkoli skutečný odvod by vyžadoval příslušný právní podklad, jurisdikci, definice, postup a rozhodnutí příslušného vládního orgánu.

XI. Abeceda a runtime znakových sad

Dokumentace abecedy a nativní znakový runtime SLeeLa jsou udržovány v alphabet/sleela/ a lib/alphabet/native/. Nativní testy v C++17 pokrývají striktní dekódování/kódování skalárních hodnot UTF-8, podpisy kapacity C<n> a ohraničenou příslušnost ke znakové sadě:

make -C lib/alphabet/native test

Experimentální katalog UTF-4088 a jeho vyhledávací adaptér pro SLeeLa jsou zdokumentovány v utf-4088/SLeeLa-ALPHABET-INTEGRATION.md. Identifikátory UTF-4088 tvoří samostatný jmenný prostor, nikoli skalární hodnoty Unicode. Práce na vazbách překladače a SLVM je výslovně sledována odděleně od těchto nativních základů.

XII. AutoCAD Creator™

AutoCAD Creator™ je interaktivní 2D CAD aplikace napsaná celá v SLeeLa. Zatímco sesterský AutoCAD Renderer promění plán ve výkres jedním tahem, Creator vám umožňuje 2D dokument AutoCAD vytvářet a měnit za běhu — přidávat stěny, místnosti, kóty a poznámky, pak umístěné prvky přesouvat, přejmenovávat popisky, přeřazovat do vrstev, mazat a vracet zpět — a výsledek uložit jako skutečný výkres AutoCAD DXF (text R12, otevře se v AutoCADu / LibreCADu).

Jeho grafické rozhraní je postaveno na SleelaUI™, vlastní multiplatformní sadě nástrojů UI SLeeLa (pod lib/user-interface) — nikoli JavaFX — a otevírá skutečné nativní okno na X11 / Cocoa / Win32. Návrh se řídí jediným pravidlem, „SleelaUI zobrazuje; SLeeLa rozhoduje“: GUI nikdy nepočítá geometrii ani nezapisuje DXF. Každý nástroj zasílá záměr vytvořit / změnit / smazat / vrátit / uložit autoritativnímu SLCadCreator, který vlastní editovatelný dokument a vratnou historii příkazů, zatímco plátno pouze zobrazuje náhled geometrie, kterou Creator drží.

Znovupoužitelný editační engine žije v lib/autocad — SLCadEntity, SLCadDocument, SLCadCommand a SLCadCreator — a běží celý bez displeje. Grafický shell a ukázka jsou v autocad/creator:

make creator          # from autocad/: run the Creator demo -> out/altered.dxf

Na displeji se otevře živé editační okno; na hostiteli bez displeje se výkres sestaví v paměti, vypíše se zpráva spolu s DXF a program čistě skončí.

XIII. Řazení vstupní mapy UTF-4088

Specializovaný katalog UTF-4088 definuje průchod svou prostorovou vstupní mapou a abstraktní iterace tlaku v utf-4088/INPUT-MAP-AND-PRESSURE.md. Zásady rejstříku subjektů National Lien jsou v utf-4088/NATIONAL-LIEN-REGISTER.md. Souřadnice mapy, úrovně tlaku (1–50), trvalé identifikátory katalogu a abecední pořadí jsou nezávislá pole; žádné z nich se nesmí potichu zaměňovat za jiné. Tlak je algoritmická iterační úroveň, nikoli fyzikální veličina.

XIV. Nedávný a rozšířený rejstřík balíčků

Tento připojený rejstřík zdůrazňuje nedávno rozšířené balíčky, doménové knihovny a sbírky zdrojů. Položky jsou seskupeny abecedně podle názvu balíčku nebo tématu. Popisy určují umístění v repozitáři; stav implementace a validace je třeba ověřit v dokumentaci a testech jednotlivých balíčků.

A–C

D–G

H–I

O–S

U–W

Údržba rejstříku balíčků

Když je balíček přidán nebo podstatně rozšířen, přidejte jeho položku sem do příslušné abecední skupiny, odkažte na jeho kanonický adresář a README a popište pouze schopnosti podporované vloženými zdroji. Udržujte tento rejstřík přírůstkový: v rámci aktualizací rejstříku balíčků neodstraňujte ani nepřepisujte existující oddíly README.


<img src="https://github.com/mearvk/SLeeLa/blob/master/images/debian-logo.png" width="25" height="25" alt="Debian"> XV. Bitcoin Conjegeum

CremeOak

bc1qs6v4q9zsw70t0umk3m0quhvf9dr6cdeskl28dh :: ⠝⠇⠼⠁⠟⠎⠼⠋⠧⠼⠙⠟⠼⠊⠵⠎⠺⠼⠛⠼⠚⠞⠼⠚⠥⠍⠦⠼⠉⠍⠼⠚⠟⠥⠓⠧⠦⠼⠊⠙⠫⠼⠋⠉⠙⠑⠎⠅⠇⠼⠼⠃⠼⠗⠙⠓

bc1qx33vma553gddsjkq372l3xlm8e8huv2vzad3cc :: ⠃⠉⠼⠁⠟⠭⠼⠉⠼⠉⠪⠍⠁⠼⠑⠑⠛⠙⠙⠎⠚⠅⠟⠼⠉⠼⠛⠼⠝⠇⠼⠉⠼⠭⠇⠍⠼⠨e⠼⠨a⠓⠥⠪⠼⠪⠼⠪⠵⠁⠙⠼⠉⠉

US Democratic and US Policy.


XVI. Národní vědecké brandové obrazové materiály

<p align="center"><img src="https://raw.githubusercontent.com/mearvk/SLeeLa/master/brand/national-sleela-science-004.jpg" alt="National SLeeLa Science" width="560"></p>

<p align="center"><img src="https://raw.githubusercontent.com/mearvk/SLeeLa/master/brand/national-sleela-nsf-001.jpg" alt="National SLeeLa NSF" width="560"></p>

XVII. Experimentální katalog UTF-4088 s milionem položek

Generátor katalogu UTF-4088 deterministicky sestavuje experimentální katalog symbolů s 1 048 576 položkami. Zdokumentovaný kompaktní formát je popsán v utf-4088/FORMAT.md; smlouva o generování a validaci je v utf-4088/GENERATION-RESULTS.md.

Generátor spusťte v Pythonu 3:

python3 utf-4088/tools/generate_catalogue.py \
  --output utf4088-million.bin \
  --summary utf4088-million.summary.json

Vygenerovaný binární soubor má 16 777 244 bajtů a je navržen tak, aby zůstal pod 20 000 000 bajtů. Jednotkové testy a workflow GitHub Actions ověřují počet položek, jedinečnost glyfů, velikost a SHA-256; úspěšné běhy zveřejňují binární soubor a souhrn jako artefakt workflow utf4088-million-catalogue. Vygenerovaný binární soubor je záměrně udržován mimo historii Gitu. UTF-4088 zůstává experimentální a není kompatibilní s Unicode.


SLeeLa

<p align="center"><img src="../../images/sleela/sleela-wordmark.svg" alt="SLeeLa — The Now. The Ingredient." width="560"></p> <p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela-programming-language-002.jpg" alt="Marketingové logo SLeeLa" width="560"></p>


XVIII. Nedávné přírůstky — konstanta Pi, spouštění Modium/Registry, matematika sleelactl a @native

Tato část zaznamenává funkce přidané během prací 2026-11, nejnovější skupiny první. Autoritativní jsou odkazované zdrojové soubory a jejich stav validace; změny v revizi nejsou popisovány jako začleněné, dokud se nedostanou do master.

Konstanta katalogu Pi se 100 000 000 číslic

Repozitář dodává ověřenou hodnotu π o sto milionech číslic v pi-generator/pi.100000000.digits (dobře utvořené desetinné číslo, 3.14159…) vedle hodnoty o 57 344 číslicích pi-generator/pi.57344.digits. Obě jsou nezávisle ověřeny jako skutečné π — viz pi-generator/VERIFIED.md, který dokumentuje kontroly (učebnicový prefix, Feynmanův bod na desetinné pozici 762, slavná miliontá číslice, shoda s lib/math/SLPiReference.sleela a analýza četnosti číslic v celém souboru) a jednorázový skript pro reprodukci.

Modium™ / Registry™ načítají konstantu Pi při spuštění subsystému

Na vyhrazených vstupních bodech subsystémů — sleela registry a sleela modium (a při prvním spuštění instalátoru), nikoli při každém sleela run — subsystémy Modium a Registry načítají velkou konstantu katalogu π. Na interaktivním terminálu vypíší přechodný červený řádek Loading Modium™ / Loading Registry™, který je poté na místě smazán, než začne běžný výstup; efekt je přísně podmíněn TTY, takže výstup do roury a testovací výstup zůstávají byte po bytu beze změny. Lokátor (nikoli bajty) je zaset jako výchozí hodnoty klíče Math registru piReferenceLargePath a piReferenceLargeDigits, a to jak v modelu SLeeLa (lib/registry/SLRegistry.sleela), tak v nativním seederu (registry/sleela_registry.c); lib/math/SLPiReference.sleela zpřístupňuje largePath() / largeDigits(). Konstanta π se instaluje do umístění SLeeLa v OS (<data>/pi/) jak standardním instalátorem make, tak průvodcovským „beautiful“ instalátorem. Podrobnosti: pi-generator/MODIUM-REGISTRY-PI-STARTUP.md.

sleelactl — beautiful installer a nativně podložený subjekt math

@native, Native Drive a vícejazyčné provádění

Nová metodová anotace @native žádá o předběžnou nativní kompilaci (AOT) horké metody. Nový příkaz sleela aot najde metody s @native, ověří, že každá spadá do podporované offloadovatelné podmnožiny, a vyemituje C/C++ — selhává uzavřeně (odmítne s přesným důvodem) u každé konstrukce, kterou zatím nedokáže přeložit, takže se nikdy nevytvoří napůl přeložená metoda.

sleela aot --list <file.sleela>    # per-method verdict: ok / REFUSED (reason)
sleela aot --emit <file.sleela>    # emit C/C++ (stdout) for an in-subset program

@native zůstává žádostí o AOT zpracování, přičemž nepodporované konstrukce se odmítnou před emisí. Native Drive podporuje vícejednotková sestavení spustitelných souborů a sdílených knihoven v C/C++ pomocí hostitelských překladačů (včetně MSVC), podporovaný výstup SLeeLa AOT, inspekci symbolů vůči ABI nativního loaderu, spouštění procesů bez shellu, zpracování stdin/stdout/stderr, vícestupňové zřetězení rour a delegování XClass na produkční loader. sleelactl zpřístupňuje jeho příkazy sestavení/spuštění a směruje inspekci XClass a výslovné vykreslování/instalaci jednotek systemd přes inspect native-drive. VM vlastní omezenou tabulku úchytů nativních modulů s povinnou autorizací hostitele a úchyty kontrolovanými generací. Syntaxe 3.0 nyní přidává nativeOpen, nativeCall a nativeClose: bytecodové dispečování pouze s přidáváním překračuje samostatně verzované ABI null/bool/int64/double/UTF-8, zatímco pole, struktury a další složené hodnoty vlastněné VM zůstávají uvnitř interpretu a mohou používat bytecodový záložní postup se stejným názvem. Pluginy mohou volitelně obdržet verzovanou tabulku zpětných volání hostitele pro vyvolání přesných funkcí SLeeLa prostřednictvím vnořeného provádění VM, s rootováním pozastaveného zásobníku pro GC, výslovným seznamem povolených názvů zpětných volání hostitele a odmítáním rekurzivních volání nativního API. Nativní kód zůstává důvěryhodným kódem v témže procesu, nikoli sandboxem. Anotace zásad procesů ve zdroji mají verzované schéma, ale zatím se neparsují ani nevynucují. Podrobnosti, bezpečnostní hranice a evidenci sedmi pracovních proudů viz Native Drive a pi-generator/AT-NATIVE.md.

XIX. Mezinárodní edice README

SLeeLa poskytuje vstupní body README specifické pro jednotlivé země pro 50 trhů své mezinárodní edice. Každá země má jeden soubor pojmenovaný README.<CC>.md; kde je relevantních více jazyků, jsou seskupeny v souboru dané země.

Zásady překladu: Tyto soubory jsou počátečními lokalizovanými národními vstupními body. Jejich úvody a jazykové nadpisy jsou lokalizovány, zatímco úplná technická reference zůstává v kanonickém anglickém README.md. Soubor země nelze označit za úplný překlad, dokud není přeložen každý oddíl, nejsou zkontrolovány technické identifikátory a odkazy a edice neprošla jazykovou revizí. Jazykové pokrytí v tomto prvním průchodu je reprezentativní a není tvrzením, že byly plně přeloženy všechny ústavně uznané, regionální, původní či znakové jazyky.

Dodatek — zachované regionální pokyny

Tento dodatek zachovává praktické pokyny z dřívější krátké české příručky, které v kanonickém README nemají vlastní oddíly. Při jakémkoli rozporu má přednost kanonické anglické README.md.

Cíle, profily a hranice spouštění

SLeeLa odděluje zdrojový kód od cílů sestavení a spuštění. Dokumentovaná rodina cílů zahrnuje SLVM, SLJVM a SLIR; NATIVE je omezený cíl podmíněný konkrétní podporou a nelze předpokládat jeho dostupnost na všech platformách. Profily BASIC_COMPLETE a ADVANCED_TOTAL označují rozdílný rozsah. U každého sestavení ověřte skutečný cíl, profil a podporu platformy.

Reference identifikuje soubor, modul nebo prostředek, ale sama o sobě neopravňuje k jeho spuštění. Pokud program používá soubory, externí knihovny, native bindings nebo systémové prostředky, musí být jasně určeny hranice oprávnění a odpovědnost za spuštění. Popis v dokumentaci sám o sobě nedokazuje bezpečnostní záruku runtime; ověřte implementaci a související testy.

Životní cyklus prostředků a ladění

Dokumentujte vlastnictví, životnost a odpovědnost za synchronizaci prostředků sdílených mezi funkcemi nebo vlákny. Rozlišujte local variables, shared object state, VM handles a serializable data. VM-local handle není stabilní formát souboru ani síťová zpráva. Používejte serializační rozhraní definované modulem a testujte invalid, missing a boundary values.

Při ladění zaznamenejte commit, OS, architecture a toolchain. Nejprve sestavte nejmenší relevantní cíl, uchovejte úplný chybový výstup, rozlišujte compiler errors od runtime errors a vytvořte minimální reprodukovatelný příklad. Úspěšné sestavení samo o sobě nedokazuje správné chování runtime.

Validační zpráva má uvádět exact commit, OS/architecture, compiler versions, úplné build/test commands, počty pass/fail/skip a známá omezení. Přeskočené nebo nespouštěné testy se nesmějí počítat jako úspěšné.

Smlouvy modulových API, kompatibilita a strategie testování

Při zavádění nového API zdokumentujte vstupy, výstupy, chybové podmínky, vlastnictví dat a případné side effects. Příklady mají ukazovat běžné použití i zpracování invalid nebo missing input. Chování neoznačujte za zaručené, pokud je nepotvrzuje implementation a související tests.

Testy rozdělte podle etap compiler pipeline: lexing/parsing, semantic analysis, IR lowering, code generation, VM execution a native integration. Pro každý regression case uchovejte nejmenší reprodukovatelný vstup, očekávaný výsledek a skutečný výsledek. Změny API musí popsat backward compatibility, migration steps a dopad na existující examples.

Lokalizace, kódování a čitelnost

Technical identifiers, commands, paths, syntax a code blocks zachovávejte ve všech jazykových verzích. Překládejte vysvětlující text, nikoli tokeny nebo názvy používané ve source code. Jazykové a regionální označení uvádějte přesně; českou a slovenskou terminologii nezaměňujte. Po každé aktualizaci zkontrolujte Markdown links, hierarchii nadpisů, code fences a příklady. Při změně canonical English documents porovnejte příslušné části a aktualizujte celý překlad, nejen úvod. Obsah bez jazykové nebo technické kontroly musí být označen.

Poznámky k odkazům a adresám

Odkazy v README na témata jako CSPML, Character, Governance, Synchro, SleelaUI a United Nations popisují obsah repozitáře a nepředstavují oficiální schválení vládou nebo institucí.

Přítomnost adres nebo obrázků v oddílu Bitcoin Conjegeum (XV) není finančním doporučením, ověřením vlastnictví ani pokynem k převodu prostředků. Před použitím je nezávisle ověřte.

Stav překladu: Oddíly I–XIX jsou přeloženy do češtiny. Technické identifikátory, příkazy, ukázky kódu, názvy souborů, odkazy a adresy jsou zachovány. Doporučuje se závěrečná jazyková revize rodilými mluvčími.