Home /Modules/docs/README.SK.md

README.SK.md

docs/i18n/README.SK.md · 795 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 — Slovensko (SK)

<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="SLeeLa Marketing Logo" width="560"></p>

<p align="center"><strong>Natívny systémový jazyk, kompilátor, runtime prostredie a ekosystém virtuálnych strojov.</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>

Medzinárodné krajinské vydanie. Toto vydanie je v slovenčine. Technické identifikátory, príkazy, príklady kódu, názvy súborov, cesty a odkazy zostávajú rovnaké ako v kanonickom anglickom README.md.

The Now. The Ingredient. Jazyk je viac než syntax: tvorí ho kompilátor, runtime prostredie, knižnice, nástroje a platformové zmluvy, vďaka ktorým je softvér použiteľný.

Čím sa SLeeLa zaoberá. SLeeLa sa zaoberá oblasťami Math, Object, Science a Reach — štyrmi tvárami svojej práce: vypočítateľným (Math), ustálenou vecou stojacou v katalógu toho, čo jestvuje (Object), disciplinovaným štúdiom pravdivého (Science) a rozšírením ruky systému k iným systémom a ľuďom (Reach). Národné záujmy zostávajú — žiadna zo štyroch oblastí ich neodsúva stranou; ak sa predmet dotýka záujmu národa, toto postavenie sa zachováva (verne zaznamenané, napr. v metadátach každej triedy metaOrigin / metaNationalSchedule), nikdy sa nezrušuje.

I. Začíname

II. Novinky

Nedávne doplnenia jazyka, ovládačov a štandardnej knižnice:

III. Zostavenie a testovanie

Požiadavky: nástrojový reťazec C/C++ (GCC alebo Clang) a GNU Make; Python 3 pre nástroje manifestov a tokov; v Linuxe vývojové balíky X11/Xrandr pre zobrazovacie produkty (make deps modulu ohlási/nainštaluje, čo potrebuje). Zostavenie impl/ je fail-closed voči dôveryhodnému manifestu SHA-256, na ktorý koreňový Makefile automaticky odkazuje.

Z čistého checkoutu je najrýchlejší štart:

make                                  # build everything from the repo root

Alebo zostavte a otestujte iba natívne jadro:

make -C impl all                      # build the core compiler/runtime only
bash ./test-suites/run-all.sh --all   # run the full test suite

Koreňový make v repozitári zostaví každý produkt (jadro, VM, kodeky, churn, antivírus, …) a končí zostavením registra a vytvorením jeho základnej tabuľky — takže zostavený strom ponúka revidovateľný register hneď po zostavení. Základné ciele:

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

Ďalšie užitočné ciele:

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/)

Cieľ registry spúšťa build-registry.sh: zostaví jadro registra, nasype základnú tabuľku do prenosného textového úložiska registry/build/sleela.sleelareg a exportuje skript tabuľky MySQL registry/build/registry.sql (cez sleela registry export). Skontrolujte ju pomocou sleela registry alebo registry/build/sleela-registry review. Pozrite si príručku registra a architektúru Registry 3.0.

Prerekvizity a kroky špecifické pre platformu nájdete v príručkách zostavovania a testovania. Úspešné zostavenie jednej súčasti nedokazuje, že každá knižnica alebo platforma je pripravená na vydanie.

IV. Inštalácia

Po zostavení natívnych produktov nainštalujte príkazy a súbory podpory runtime prostredia:

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

Bežný inštalátor predvolene používa /usr/local/bin, /usr/local/lib/sleela a /usr/local/share/sleela. Zachováva existujúcu úvodnú konfiguráciu a odmieta prepísať existujúce príkazy, ktoré nie sú sledované. Odinštalovanie odstráni iba súbory zaznamenané inštalátorom a zachová konfiguráciu a nesledované údaje runtime prostredia.

Na cielené, riadené nasadenie iba hlavného balíka — binárnych súborov sleela, sleelvac a nordshrift, štandardnej knižnice, protokolov a podporných modulov — použite čistý inštalátor:

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

Urobí jedno primárne rozhodnutie (nainštalovať hlavný balík), potom voľbu rozsahu a po úspechu voliteľný výber vybraných rozširujúcich modulov. Interaktívny postup nasadenia a všetky možnosti inštalácie nájdete v dokumente Rýchla a bezpečná inštalácia.

V. Jazyk a runtime prostredie

Záväznou gramatikou je SLEELA.syntax. Aktuálny repozitár dokumentuje syntax 3.0; verzia kompilátora/nástroja a verzia zdrojovej syntaxe sú odlišné pojmy. Povrch 3.0 pridáva značky dokumentu pure a gasoline (§30) — dvojicu holých, kontextových, výlučne deklaratívnych Preonems, ktoré znamenajú takmer to isté, pričom každá označuje postavenie dokumentu svojou vlastnou úprimnosťou. Syntax 3.0 zjednocuje jazykový povrch 1.0–2.9 do súčasného normatívneho vydania a zachováva všetky minimálne brány špecifické pre jednotlivé funkcie. Predchádzajúci povrch 2.9 pridáva následné polia @mix (§28) — trieda môže deklarovať viacero rovnomenných inštančných polí, ak každé nesie @mix, chápaných ako jedna indexovaná skupina (zhora nadol 1,2,3,… alebo ručne @mix(1,2,3,...), pričom počet indexov musí zodpovedať skupine). Prenáša ďalej dvojkové rodiny širokých znamienkových/neznamienkových celých čísel int32..int16777216 (§24) a uint32..uint16777216 (§25) nad skoršími long/int64/int128 (§21); dokumenty podporovateľov kľúčových slov (§22); a Preonems — výlučne deklaratívne značky dokumentu author/authorial (§18), material/memory (§19–§20), determine (§23), object/field (§26), pure/gasoline (§30) a artifact (§35, postavenie na úrovni zákonodarstva odstupňované vzhľadom na čas a priestor), súhrnne titulované Preonems (§26.1). Rozlíšenie preťaženia konštruktorov a delegovanie this(...)/konštruktora bázy sú výslovne mimo overenej zmluvy syntaxe 1.8. Skôr než sa na funkciu spoľahnete, pozrite si gramatiku a poznámky k implementácii. Deväť zdrojových jednotiek SleelaDoc teraz deklaruje #sleela 3.0; spoločná brána kompilátora akceptuje zdrojovú syntax 1.0–3.0. Nové zostavenie API vzniká pomocou make api-docs.

Repozitár obsahuje natívnu implementáciu C/C++, referencie generovania SLVM, moduly štandardnej knižnice, testy, príklady a platformové integrácie. Stav implementácie a validácie sa líši podľa modulu; namiesto predpokladu rovnomernej úplnosti si pozrite jeho špecifikáciu a aktuálne výsledky CI.

VI. Inžinierske princípy

VII. Zostavenie antivírusu a integrita

Antivírusový balík Sleelavirin obsahuje natívny skener SHA-256, voliteľný adaptér ClamAV, manifesty integrity zdrojov/indexov a kontrolné súčty platformových balíkov. Balík zostavte a otestujte z koreňa repozitára:

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

Manifest integrity sa generuje pod antivirus/build/; zahŕňa sledované vstupy zdrojov a dokumentácie plus chránené súbory indexu podpisov, pričom vynecháva generovaný výstup a meniteľnú vyrovnávaciu pamäť ClamAV. Snímky databázy ClamAV majú vlastné manifesty. Archívy ZIP vydania obsahujú INTEGRITY-MANIFEST.json, SHA256SUMS a doplnkový súbor .sha256. Hashe stiahnutých archívov overte voči dôveryhodnej hodnote získanej nezávisle: kontrolný súčet uložený vedľa archívu nie je podpisom vydavateľa. Pozrite si príručku Sleelavirin, bezpečnostný kontrolný zoznam a pracovný postup zostavenia antivírusu.

Vydanie sa nepovažuje za overené, kým relevantné úlohy CI neprejdú na presnom commite vydania a výsledné artefakty nie sú skontrolované.

VIII. Editorové témy SLeeLa — Vim a Emacs

SLeeLa obsahuje koordinovanú sadu profesionálnych tmavých farebných schém pre Vim a Emacs a natívny nástroj na palety v C/C++. Pôvodná schéma American Professional zostáva predvolená. Desať sprievodných paliet je dostupných pre rozdielne kultúrne a inštitucionálne dizajnové inšpirácie; ide o interpretačné dizajnové palety, nie o oficiálne zobrazenia ktoréhokoľvek národa, kultúry, súdu alebo inštitúcie.

Jedenásť schém a ich farby

SchémaPozadiePopredieKľúčové slováTypyReťazceKomentáre
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

Národné vlajkové farby (zdrojová paleta)

Grécka a turecká schéma sú odvodené z oficiálnych národných vlajkových farieb oboch krajín, tu uvedených s ich presnými zverejnenými hodnotami hex. Pozadia/akcenty schém vyššie sú stmavené interpretácie týchto zdrojových farieb vhodné pre editor — tabuľka nižšie je referenciou „farieb tak, ako sú národne vystavené“.

ŠtátFarbaHexZáklad a význam
GréckoModrá<span style="display:inline-block;width:1em;height:1em;background:#0D5EAF;border:1px solid #888"></span> #0D5EAFModrá národnej vlajky (zákon 851/1978). Nebo a moria; heraldicky blazonovaná ako azure.
GréckoBiela<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFBiela národnej vlajky. Čistota boja za nezávislosť; kríž označuje východné pravoslávne kresťanstvo.
Turecko (Türkiye)Červená (al bayrak)<span style="display:inline-block;width:1em;height:1em;background:#E30A17;border:1px solid #888"></span> #E30A17Červená národnej vlajky (turecký zákon o vlajke). Pole; podľa tradície krv mučeníkov a osmanská zvrchovanosť.
Turecko (Türkiye)Biela<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFBiela národnej vlajky. Polmesiac a hviezda — mier, čistota a symbol tureckého/islamského dedičstva.

Schémy ukotvujú popredie každého editora na národnej bielej a jeho kľúčové slová, kurzor, výber a stavový riadok na presnej národnej modrej (#0D5EAF) alebo červenej (#E30A17), takže farby, na ktorých záleží, sú doslova národnými farbami. Ide o interpretačné dizajnové palety; referencia vlajkových farieb sa poskytuje kvôli pôvodu a nie je oficiálnym zobrazením ani jedného z oboch štátov. Významy farieb vychádzajú z opisu štátnych symbolov ministerstva zahraničných vecí Helénskej republiky a z tradície tureckého zákona o vlajke.

Tabuľka farebných vzoriek

Bunky paliet nižšie používajú vzorky SVG, takže GitHub vykreslí skutočné farby namiesto prázdnych buniek HTML. Každý pásik zobrazuje šesť farieb v tomto poradí: pozadie, popredie, kľúčové slová, typy, reťazce a komentáre. Presné kódy hex sú uvedené vedľa každej vzorky v rovnakom poradí schém ako v referenčnej tabuľke vyššie.

SchémaVykreslené farby paletyKódy hex (pozadie · popredie · kľúčové slová · typy · reťazce · komentáre)
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

Ďalšie akcentové farby sa používajú pre funkcie, konštanty, výbery, diagnostiku a direktívy preprocesora. Ruská a slovanská paleta zámerne používa bridlicovú, modrú, šalviovú, rubínovú a staroželtú zlatú strednej intenzity pre pokojnejší profesionálny vzhľad.

Inštalácia schém pre Vim

Z koreňa repozitára:

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 pridajte nasledujúce, aby ste zapli zvýrazňovanie syntaxe SLeeLa a zvolili schému:

syntax enable
set background=dark
colorscheme sleela-american

Zvoľte presne jeden z týchto názvov colorscheme:

Napríklad colorscheme sleela-russian-slavic použite pre strednú ruskú a slovanskú paletu alebo colorscheme sleela-greek / colorscheme sleela-turkish pre helénsku paletu a paletu Al Bayrak. Vim reštartujte alebo načítajte konfiguráciu pomocou :source $MYVIMRC.

Inštalácia schém pre Emacs

Vytvorte lokálny adresár tém a skopírujte súbory režimu a tém z koreňa repozitára:

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/

Pridajte toto do ~/.emacs alebo ~/.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)

Nahraďte sleela-american hodnotou sleela-eurasia, sleela-russian-slavic, sleela-silk-road, sleela-east-asian, sleela-greek, sleela-turkish, sleela-kiro alebo sleela-sleela, aby ste zvolili inú schému. Ak sa Emacs spýta, či dôverovať téme, pred prijatím skontrolujte lokálny súbor témy.

Náhľad natívnych paliet C/C++

Malý natívny nástroj na palety dokáže vypísať schémy, vytlačiť ich farby pre terminál a vyhľadať jednotlivú farbu:

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

Pre spätnú kompatibilitu --palette a --hex COLOR bez --theme vyberú American Professional. Výsledky zostavenia a testov treba overiť na cieľovom systéme a v CI; dokumentácia príkazu sama osebe nie je dôkazom, že prešiel.

Úplné opisy paliet a podrobnosti o nástroji nájdete v príručke integrácie editorov.

IX. Prispievanie

  1. Prečítajte si register dokumentácie a zásady testovania.
  2. Robte cielené zmeny s pozitívnymi aj negatívnymi testami.
  3. Spustite cielené testy a potom širokú sadu.
  4. Uveďte údaje o OS a nástrojovom reťazci; preskočené kontroly neoznačujte za úspešné.

SLeeLa vyvíja MEARVK LLC. Historický materiál úvodnej stránky je zachovaný v docs/README-LEGACY.md.

X. AE6E66 — Očakávanie odvodu z Round Public e-mailu

Pre iniciatívu AE6E66 je deklarovaným očakávaním projektu $300,000,000.00 USD za jeden Round Public e-mail ako navrhovaná výška daňového odvodu spojeného s každým kvalifikujúcim sa Round Public e-mailom.

Toto vyhlásenie zaznamenáva iba očakávanie projektu. Nie je to právne daňové vyrubenie, vládny príkaz, súdny rozsudok ani nezávisle preukázaná daňová povinnosť. Akýkoľvek skutočný odvod by vyžadoval príslušnú právnu autoritu, jurisdikciu, definície, postup a rozhodnutie spôsobilého vládneho orgánu.

XI. Abeceda a runtime znakových sád

Dokumentácia abecedy SLeeLa a natívny znakový runtime sa udržiavajú v alphabet/sleela/ a lib/alphabet/native/. Natívne testy v C++17 pokrývajú striktné dekódovanie/kódovanie skalárov UTF-8, podpisy kapacity C<n> a ohraničenú príslušnosť k znakovej sade:

make -C lib/alphabet/native test

Experimentálny katalóg UTF-4088 a jeho vyhľadávací adaptér pre SLeeLa sú zdokumentované v utf-4088/SLeeLa-ALPHABET-INTEGRATION.md. Identifikátory UTF-4088 sú samostatný menný priestor, nie skalárne hodnoty Unicode. Práca na väzbách kompilátora a SLVM sa sleduje výslovne oddelene od týchto natívnych základov.

XII. AutoCAD Creator™

AutoCAD Creator™ je interaktívna 2D CAD aplikácia napísaná celá v SLeeLa. Zatiaľ čo súrodenecký AutoCAD Renderer premení plán na výkres jedným ťahom, Creator vám umožňuje 2D dokument AutoCAD naživo vytvárať a meniť — pridávať steny, miestnosti, kóty a poznámky, potom ich presúvať, premenovávať, preradiť do inej vrstvy, mazať a vrátiť späť, čo ste umiestnili — a výsledok uložiť ako skutočný výkres AutoCAD DXF (text R12, otvorí sa v AutoCADe / LibreCADe).

Jeho grafické rozhranie je postavené na SleelaUI™, vlastnom multiplatformovom UI toolkite SLeeLa (pod lib/user-interface) — nie na JavaFX — a otvára skutočné natívne okno na X11 / Cocoa / Win32. Návrh sa riadi jedným pravidlom, „SleelaUI predstavuje; SLeeLa rozhoduje“: GUI nikdy nepočíta geometriu ani nezapisuje DXF. Každý nástroj posiela zámer vytvoriť / zmeniť / zmazať / vrátiť späť / uložiť autoritatívnej triede SLCadCreator, ktorá vlastní upraviteľný dokument a vratnú históriu príkazov, kým plátno iba zobrazuje náhľad geometrie, ktorú Creator drží.

Opakovane použiteľný editačný engine sa nachádza v lib/autocad — SLCadEntity, SLCadDocument, SLCadCommand a SLCadCreator — a beží od začiatku do konca bez displeja. Obal GUI a ukážka sú v autocad/creator:

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

Na displeji sa otvorí živé editačné okno; na hostiteľovi bez displeja sa výkres vytvorí v pamäti, vypíše sa správa plus DXF a program sa čisto ukončí.

XIII. Poradie vstupnej mapy UTF-4088

Špecializovaný katalóg UTF-4088 definuje prechod svojej priestorovej vstupnej mapy a abstraktné iterácie tlaku v utf-4088/INPUT-MAP-AND-PRESSURE.md. Politika predmetového indexu National Lien je v utf-4088/NATIONAL-LIEN-REGISTER.md. Súradnice mapy, úrovne tlaku (1–50), trvalé identifikátory katalógu a abecedné poradia sú nezávislé polia; žiadne z nich sa nesmie potichu nahradiť iným. Tlak je algoritmická úroveň iterácie, nie fyzikálna veličina.

XIV. Nedávny a rozšírený index balíkov

Tento pripojený index zvýrazňuje nedávno rozšírené balíky, doménové knižnice a zbierky zdrojov. Položky sú zoskupené abecedne podľa názvu balíka alebo témy. Opisy určujú umiestnenie v repozitári; stav implementácie a validácie treba overiť v dokumentácii a testoch každého balíka.

A–C

D–G

H–I

O–S

U–W

Údržba indexu balíkov

Keď sa balík pridá alebo podstatne rozšíri, pridajte jeho položku sem do príslušnej abecednej skupiny, odkážte na jeho kanonický adresár a README a opíšte iba možnosti podporené zdrojmi v repozitári. Tento index udržiavajte aditívne: pri aktualizáciách indexu balíkov neodstraňujte ani neprepisujte existujúce sekcie 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é obrazové materiály značky Science

<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álny katalóg UTF-4088 s miliónom položiek

Generátor katalógu UTF-4088 deterministicky vytvára experimentálny katalóg symbolov s 1 048 576 položkami. Zdokumentovaný kompaktný formát je opísaný v utf-4088/FORMAT.md; zmluva o generovaní a validácii je v utf-4088/GENERATION-RESULTS.md.

Generátor spustite pomocou Pythonu 3:

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

Vygenerovaný binárny súbor má 16 777 244 bajtov a je navrhnutý tak, aby zostal pod 20 000 000 bajtov. Jednotkové testy a pracovný postup GitHub Actions overujú počet položiek, jedinečnosť glyfov, veľkosť a SHA-256; úspešné behy zverejňujú binárny súbor a súhrn ako artefakt pracovného postupu utf4088-million-catalogue. Vygenerovaný binárny súbor sa zámerne uchováva mimo histórie Gitu. UTF-4088 zostáva experimentálny a nie je 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="SLeeLa Marketing Logo" width="560"></p>


XVIII. Nedávne doplnenia — konštanta Pi, štart Modium/Registry, matematika sleelactl a @native

Táto sekcia zaznamenáva funkcie pridané počas práce v 2026-11, najnovšie skupiny na začiatku. Prepojené zdrojové súbory a stav ich validácie sú záväzné; zmeny v revízii sa nepovažujú za zlúčené, kým sa nedostanú do master.

Konštanta katalógu Pi so 100 000 000 číslicami

Repozitár dodáva overenú hodnotu π so sto miliónmi číslic v súbore pi-generator/pi.100000000.digits (správne utvorené desatinné číslo, 3.14159…) spolu s hodnotou s 57 344 číslicami pi-generator/pi.57344.digits. Obe sú nezávisle overené ako skutočné π — pozrite si pi-generator/VERIFIED.md, ktorý dokumentuje kontroly (učebnicový prefix, Feynmanov bod na desatinnej pozícii 762, slávnu miliónitú číslicu, zhodu s lib/math/SLPiReference.sleela a analýzu frekvencie číslic celého súboru) a jednorazový skript na reprodukciu.

Modium™ / Registry™ načítavajú konštantu Pi pri štarte subsystému

Na vyhradených vstupných bodoch subsystémov — sleela registry a sleela modium (a pri prvom spustení inštalátora), nie pri každom sleela run — subsystémy Modium a Registry načítavajú veľkú konštantu katalógu π. V interaktívnom termináli vypíšu prechodný červený riadok Loading Modium™ / Loading Registry™, ktorý sa potom na mieste vymaže ešte pred začiatkom bežného výstupu; účinok je prísne viazaný na TTY, takže výstup cez rúru a testovací výstup zostávajú bajt po bajte nezmenené. Lokátor (nie bajty) je nasadený ako predvolené hodnoty kľúča registra Math piReferenceLargePath a piReferenceLargeDigits, a to v modeli SLeeLa (lib/registry/SLRegistry.sleela) aj v natívnom seederi (registry/sleela_registry.c); lib/math/SLPiReference.sleela sprístupňuje largePath() / largeDigits(). Konštanta π sa inštaluje do umiestnenia SLeeLa v OS (<data>/pi/) oboma štandardným inštalátorom make aj riadeným „krásnym“ inštalátorom. Podrobnosti: pi-generator/MODIUM-REGISTRY-PI-STARTUP.md.

sleelactl — krásny inštalátor a math s natívnym pozadím

@native, Native Drive a vykonávanie vo viacerých jazykoch

Nová anotácia metódy @native žiada o ahead-of-time natívnu kompiláciu horúcej metódy. Nový príkaz sleela aot nájde metódy @native, overí, že každá patrí do podporovanej odovzdateľnej podmnožiny, a vydá C/C++ — zlyháva uzavreto (odmietne s presným dôvodom) pri každom konštrukte, ktorý zatiaľ nevie preložiť, takže sa nikdy nevytvorí napoly preložená metóda.

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 zostáva žiadosťou o spracovanie AOT, pričom nepodporované konštrukty sa odmietnu pred emisiou. Native Drive podporuje viacjednotkové zostavenia spustiteľných súborov a zdieľaných knižníc v C/C++ cez hostiteľské kompilátory (vrátane MSVC), podporovaný výstup SLeeLa AOT, kontrolu symbolov voči ABI natívneho loadera, vykonávanie procesov bez shellu, spracovanie stdin/stdout/stderr, viacstupňové rúrovanie a delegovanie XClass na produkčný loader. sleelactl sprístupňuje jeho príkazy zostavenia/spustenia a cez inspect native-drive smeruje kontrolu XClass a výslovné vykresľovanie/inštaláciu jednotiek systemd. VM vlastní ohraničenú tabuľku rukovätí natívnych modulov s povinnou autorizáciou hostiteľa a rukoväťami kontrolovanými podľa generácie. Syntax 3.0 teraz pridáva nativeOpen, nativeCall a nativeClose: append-only bytecode dispatch prekračuje samostatne verzované ABI null/bool/int64/double/UTF-8, kým polia, štruktúry a iné zložené hodnoty vlastnené VM zostávajú vo vnútri interpretera a môžu používať záložné riešenie bytecode podľa rovnakého názvu. Pluginy môžu voliteľne dostať verzovanú tabuľku spätných volaní hostiteľa na vyvolanie presných funkcií SLeeLa cez vnorené vykonávanie VM, s rootovaním pozastaveného zásobníka pre GC, výslovným zoznamom povolených názvov spätných volaní hostiteľa a odmietnutím rekurzívnych volaní natívneho API. Natívny kód zostáva dôveryhodným kódom v procese, nie sandboxom. Anotácie politiky procesov v zdroji majú verzovanú schému, ale zatiaľ sa neparsujú ani nevynucujú. Podrobnosti, bezpečnostné hranice a ledger siedmich pracovných tokov: Native Drive a pi-generator/AT-NATIVE.md.

XIX. Medzinárodné vydania README

SLeeLa poskytuje krajinské vstupné body README pre 50 trhov svojho medzinárodného vydania. Každá krajina má jeden súbor s názvom README.<CC>.md; ak je relevantných viac jazykov, sú zoskupené v súbore danej krajiny.

Zásady prekladu: Tieto súbory sú úvodné lokalizované krajinské vstupné body. Ich úvody a jazykové nadpisy sú lokalizované, zatiaľ čo úplná technická referencia zostáva v kanonickom anglickom README.md. Krajinský súbor sa nesmie označiť za úplný preklad, kým nie je preložená každá sekcia, skontrolované technické identifikátory a odkazy a kým vydanie neprejde jazykovou revíziou. Pokrytie jazykov v tejto prvej fáze je reprezentatívne a nie je tvrdením, že každý ústavne uznaný, regionálny, domorodý alebo posunkový jazyk bol úplne preložený.

Príloha — zachované regionálne usmernenie

Táto príloha zachováva praktické usmernenie z predchádzajúceho krátkeho slovenského sprievodcu, ktoré sa v kanonickom README nenachádza ako samostatné sekcie. Pri akomkoľvek rozpore má prednosť kanonické anglické README.md.

Ciele, profily a hranice vykonávania

SLeeLa oddeľuje zdrojový kód od cieľov zostavenia a vykonávania. Dokumentovaná rodina cieľov zahŕňa SLVM, SLJVM a SLIR; NATIVE je obmedzený cieľ podmienený podporou, preto nemožno predpokladať jeho dostupnosť na každej platforme. Profily BASIC_COMPLETE a ADVANCED_TOTAL označujú rozdielny rozsah. Pri každom zostavení overte skutočný cieľ, profil a podporu platformy.

Referencia identifikuje súbor, modul alebo zdroj, ale sama osebe neposkytuje oprávnenie na jeho vykonanie. Pri používaní súborov, externých knižníc, natívnych väzieb alebo systémových zdrojov musia byť jasne určené hranice oprávnení a zodpovednosť za vykonanie. Opis v dokumentácii sám osebe nedokazuje bezpečnostnú záruku runtime prostredia; overte implementáciu a príslušné testy.

Životný cyklus zdrojov a ladenie

Zdokumentujte vlastníctvo, životnosť a zodpovednosť za synchronizáciu zdrojov zdieľaných medzi funkciami alebo vláknami. Rozlišujte lokálne premenné, zdieľaný stav objektov, rukoväte VM a serializovateľné údaje. Lokálna rukoväť VM nie je stabilný formát súboru ani sieťová správa. Používajte serializačné rozhranie definované modulom a testujte neplatné, chýbajúce a hraničné hodnoty.

Pri ladení zaznamenajte commit, OS, architektúru a nástrojový reťazec. Najprv zostavte najmenší relevantný cieľ, uchovajte úplný chybový výstup, rozlišujte chyby kompilátora od chýb runtime prostredia a vytvorte minimálny reprodukovateľný príklad. Úspešné zostavenie samo osebe nedokazuje správne správanie runtime prostredia.

Validačná správa má uvádzať presný commit, OS/architektúru, verzie kompilátora, úplné príkazy zostavenia a testov, počty pass/fail/skip a známe obmedzenia. Preskočené alebo nespustené testy sa nesmú počítať ako úspešné.

Zmluvy modulových API, kompatibilita a testovacia stratégia

Pri zavádzaní nového API zdokumentujte vstupy, výstupy, chybové podmienky, vlastníctvo údajov a prípadné vedľajšie účinky. Príklady majú ukazovať bežné použitie aj spracovanie neplatného alebo chýbajúceho vstupu. Správanie neoznačujte za zaručené, pokiaľ ho nepotvrdzuje implementácia a príslušné testy.

Testy rozdeľte podľa etáp kompilačného reťazca: lexikálna a syntaktická analýza, sémantická analýza, znižovanie do IR, generovanie kódu, vykonávanie vo VM a natívna integrácia. Pre každý regresný prípad uchovajte najmenší reprodukovateľný vstup, očakávaný výsledok a skutočný výsledok. Zmeny API musia opísať spätnú kompatibilitu, kroky migrácie a vplyv na existujúce príklady.

Lokalizácia, kódovanie a čitateľnosť

Technické identifikátory, príkazy, cesty, syntax a bloky kódu zachovávajte vo všetkých jazykových verziách. Prekladajte vysvetľujúci text, nie tokeny alebo názvy používané v zdrojovom kóde. Jazykové a regionálne označenie uvádzajte presne; slovenskú terminológiu nezamieňajte s českou.

Po každej aktualizácii skontrolujte odkazy Markdown, hierarchiu nadpisov, bloky kódu a príklady. Pri zmene kanonických anglických dokumentov porovnajte príslušné časti a aktualizujte celý preklad, nielen úvod. Obsah bez jazykovej alebo technickej kontroly musí byť označený.

Medzinárodné vydania a slovenské jazykové formy

Toto slovenské vydanie je určené predovšetkým čitateľom slovenčiny. Netvrdí, že pokrýva všetky regionálne, menšinové alebo posunkové jazyky používané na Slovensku. Príspevky pre ďalšie jazykové formy a prístupné formáty sú vítané.

Hlavné odkazy

Stav prekladu: Sekcie I–XIX sú preložené do slovenčiny. Technické identifikátory, príkazy, ukážky kódu, názvy súborov, odkazy a adresy sú zachované. Odporúča sa záverečná jazyková revízia rodenými hovorcami.