Home /Modules/docs/README.HU.md

README.HU.md

docs/i18n/README.HU.md · 796 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 — Magyarország (HU)

<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ív rendszernyelv, fordítóprogram, futtatókörnyezet és virtuálisgép-ökoszisztéma.</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>

Nemzetközi országkiadás. Ez a kiadás magyar nyelven készült. A műszaki azonosítók, parancsok, kódpéldák, fájlnevek, elérési utak és hivatkozások változatlanok a kanonikus angol README.md fájlhoz képest.

The Now. The Ingredient. A nyelv több a szintaxisnál: a fordítóprogram, a futtatókörnyezet, a könyvtárak, az eszközök és a platformszerződések együtt teszik használhatóvá a szoftvert.

Mivel foglalkozik a SLeeLa. A SLeeLa a Math, az Object, a Science és a Reach területével foglalkozik — munkájának négy arcával: a kiszámíthatóval (Math), a megállapodott dologgal, amely a létezők katalógusában áll (Object), az igaz fegyelmezett tanulmányozásával (Science), valamint egy rendszer kezének más rendszerek és emberek felé való kinyújtásával (Reach). A nemzeti érdekek fennmaradnak — a négy terület egyike sem helyezi őket mellőzésre; ahol egy téma egy nemzet érdekét érinti, ez az álláspont megmarad (hűen rögzítve, például az egyes osztályok Metadata metaOrigin / metaNationalSchedule mezőiben), és soha nem oldódik fel.

I. Első lépések

II. Hírek

A nyelv, az illesztőprogramok és a szabványos könyvtár legutóbbi újdonságai:

III. Fordítás és tesztelés

Előfeltételek: C/C++ eszközlánc (GCC vagy Clang) és GNU Make; Python 3 a jegyzék-/folyamateszközökhöz; Linuxon az X11/Xrandr fejlesztőcsomagok a megjelenítési termékekhez (egy modul make deps parancsa jelzi/telepíti, amire szüksége van). Az impl/ build megbízható SHA-256 jegyzékre épül és hiba esetén lezár (fail-closed); a gyökér Makefile ezt automatikusan beállítja.

Tiszta checkoutból a leggyorsabb indulás:

make                                  # build everything from the repo root

Vagy csak a natív magot fordítsa és tesztelje:

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

A gyökérszintű make minden terméket lefordít (mag, VM, kodekek, churn, antivírus, …), és a registry felépítésével, valamint az alaptáblázat előállításával fejeződik be — így a lefordított fa kapásból egy átvizsgálható registryt szállít. A legfontosabb célok:

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

További hasznos célok:

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

A registry cél a build-registry.sh szkriptet futtatja: felépíti a registry magját, az alaptáblázatot betölti a hordozható szöveges tárba (registry/build/sleela.sleelareg), és exportálja a MySQL-táblaszkriptet (registry/build/registry.sql) a sleela registry export parancson keresztül. Átvizsgálható a sleela registry vagy a registry/build/sleela-registry review paranccsal. Lásd a registry-útmutatót és a Registry 3.0 architektúrát.

Az előfeltételekért és a platformspecifikus lépésekért olvassa el a build- és tesztelési útmutatókat. Egyetlen komponens sikeres fordítása nem bizonyítja, hogy minden könyvtár vagy platform kiadásra kész.

IV. Telepítés

A natív termékek lefordítása után telepítse a parancsokat és a futtatókörnyezet támogatófájljait:

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

A hagyományos telepítő alapértelmezés szerint a /usr/local/bin, a /usr/local/lib/sleela és a /usr/local/share/sleela könyvtárat használja. Megőrzi a meglévő indítási konfigurációt, és megtagadja a nem követett, már létező parancsok felülírását. Az eltávolítás kizárólag a telepítő által rögzített fájlokat törli, a konfigurációt és a nem követett futásidejű adatokat megőrzi.

A kizárólag a fő csomagra — a sleela, sleelvac és nordshrift binárisokra, a szabványos könyvtárra, a protokollokra és a támogató modulokra — összpontosító, vezetett telepítéshez használja a tiszta telepítőt:

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

Egyetlen elsődleges döntést kér (a fő csomag telepítése), majd hatókört kell választani, sikeres telepítés után pedig opcionálisan kiválasztható néhány gondosan válogatott kiegészítő modul. Az interaktív telepítési munkafolyamatról és az összes telepítési lehetőségről lásd: Gyors és biztonságos telepítés.

V. Nyelv és futtatókörnyezet

A mérvadó nyelvtan a SLEELA.syntax. A repository jelenleg a 3.0-s szintaxist dokumentálja; a fordító/eszköz verziója és a forrásszintaxis verziója két különböző fogalom. A 3.0-s felület hozzáadja a pure és gasoline dokumentumjelölőket (§30) — a Preonemek egy puszta, szövegkörnyezetfüggő, kizárólag deklaratív párját, amelyek majdnem ugyanazt jelentik, és mindegyik a saját őszintesége szerint jelöli a dokumentum állását. A 3.0-s szintaxis az 1.0–2.9-es nyelvi felületet egyetlen, jelenlegi normatív kiadássá vonja össze, megőrizve az összes funkcióspecifikus minimális kaput. Az előző, 2.9-es felület hozzáadja a @mix következményes mezőket (§28) — egy osztály több azonos nevű példánymezőt deklarálhat, ha mindegyik @mix-et hordoz, egyetlen indexelt csoportként értelmezve (fentről lefelé 1,2,3,… vagy kézzel @mix(1,2,3,...), amelynek indexszámának egyeznie kell a csoporttal). Továbbviszi a 2-es alapú előjeles/előjel nélküli széles egész családokat: int32..int16777216 (§24) és uint32..uint16777216 (§25) a korábbi long/int64/int128 (§21) felett; a kulcsszótámogató dokumentumokat (§22); valamint a Preonemeket — a kizárólag deklaratív dokumentumjelölőket: author/authorial (§18), material/memory (§19–§20), determine (§23), object/field (§26), pure/gasoline (§30) és artifact (§35, időre és térre fokozott törvényhozási szintű állás), amelyeket együttesen Preonemeknek nevezünk (§26.1). A konstruktor-túlterhelés feloldása és a this(...)/alaskonstruktor-delegálás kifejezetten az ellenőrzött 1.8-as szintaxisszerződésen kívül esik. Egy funkció használata előtt olvassa el a nyelvtant és a megvalósítási jegyzeteket. A SleelaDoc kilenc forrásegysége mostantól a #sleela 3.0 verziót deklarálja; a megosztott fordítói kapu az 1.0–3.0 forrásszintaxist fogadja el. Az új API-build a make api-docs paranccsal készül.

A repository natív C/C++ implementációt, SLVM-generálási referenciákat, szabványkönyvtári modulokat, teszteket, példákat és platformintegrációkat tartalmaz. A megvalósítás és az érvényesítés állapota modulonként eltérő; ne feltételezzen egységes teljességet, hanem olvassa el az adott modul specifikációját és az aktuális CI-eredményeket.

VI. Mérnöki alapelvek

VII. Antivírus-build és integritás

A Sleelavirin antivírus-csomag natív SHA-256 szkennert, opcionális ClamAV- adaptert, forrás-/indexintegritási jegyzékeket és platformcsomag-ellenőrzőösszegeket tartalmaz. A csomagot a repository gyökeréből lehet lefordítani és tesztelni:

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

Az integritási jegyzék az antivirus/build/ alatt jön létre; lefedi a követett forrás- és dokumentációs bemeneteket, valamint a védett aláírásindex-fájlokat, a generált kimenetet és a módosítható ClamAV-gyorsítótárat viszont kihagyja. A ClamAV adatbázis-pillanatképeknek saját jegyzékük van. A kiadási ZIP-ek tartalmazzák az INTEGRITY-MANIFEST.json és a SHA256SUMS fájlt, valamint egy .sha256 kísérőfájlt. A letöltött archívumok hash-értékét egy függetlenül beszerzett, megbízható értékkel vesse össze: az archívum mellett tárolt ellenőrzőösszeg nem a kiadó aláírása. Lásd a Sleelavirin-útmutatót, a biztonsági ellenőrzőlistát és az antivírus build-munkafolyamatot.

Egy kiadás addig nem tekinthető ellenőrzöttnek, amíg a vonatkozó CI-feladatok nem sikeresek pontosan a kiadási commiton, és az eredményül kapott artefaktumokat nem vizsgálták át.

VIII. A SLeeLa szerkesztőtémái — Vim és Emacs

A SLeeLa összehangolt, professzionális sötét színsémákat tartalmaz a Vimhez és az Emacshez, valamint egy natív C/C++ palettaeszközt. Az eredeti American Professional séma marad az alapértelmezett. Tíz kísérő paletta áll rendelkezésre különböző kulturális és intézményi tervezési ihletforrásokhoz; ezek értelmező tervezési paletták, nem pedig egy nemzet, kultúra, bíróság vagy intézmény hivatalos megjelenítései.

A tizenegy séma és színeik

SémaHáttérElőtérKulcsszavakTípusokKarakterláncokMegjegyzések
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

Nemzeti zászlószínek (forrás paletta)

A görög és a török séma a két ország hivatalos nemzeti zászlószíneiből származik, itt a pontos, közzétett hexadecimális értékekkel. A fenti sémák hátterei/kiemelései e forrásszínek sötétített, szerkesztőbarát értelmezései — az alábbi táblázat a „nemzetileg megjelenített színek” referenciája.

NemzetSzínHexAlap és jelentés
GörögországKék<span style="display:inline-block;width:1em;height:1em;background:#0D5EAF;border:1px solid #888"></span> #0D5EAFNemzeti zászlókék (851/1978. sz. törvény). Az ég és a tengerek; heraldikai nyelven azúr.
GörögországFehér<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFNemzeti zászlófehér. A függetlenségi harc tisztasága; a kereszt a keleti ortodox kereszténységet jelöli.
TürkiyeVörös (al bayrak)<span style="display:inline-block;width:1em;height:1em;background:#E30A17;border:1px solid #888"></span> #E30A17Nemzeti zászlóvörös (török zászlótörvény). A mező; hagyomány szerint a vértanúk vére és az oszmán szuverenitás.
TürkiyeFehér<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFNemzeti zászlófehér. A félhold és a csillag — béke, tisztaság, valamint a türk/iszlám örökség szimbóluma.

A sémák az egyes szerkesztők előterét a nemzeti fehérre, kulcsszavait, kurzorát, kijelölését és állapotsorát pedig a pontos nemzeti kékre (#0D5EAF) vagy vörösre (#E30A17) horgonyozzák, így a lényeges színek szó szerint a nemzeti színek. Ezek értelmező tervezési paletták; a zászlószín-hivatkozás az eredet igazolására szolgál, és egyik állam hivatalos megjelenítése sem. A színek jelentése a Helléni Köztársaság külügyminisztériumának állami szimbólumokról szóló leírását és a török zászlótörvény hagyományát követi.

Színminta-táblázat

Az alábbi palettacellák SVG-mintákat használnak, így a GitHub a tényleges színeket jeleníti meg az üres HTML színcellák helyett. Minden csík a hat színt ebben a sorrendben mutatja: háttér, előtér, kulcsszavak, típusok, karakterláncok és megjegyzések. A pontos hexadecimális kódok az egyes minták mellett állnak, ugyanabban a sémasorrendben, mint a fenti referenciatáblázatban.

SémaMegjelenített palettaszínekHex kódok (háttér · előtér · kulcsszavak · típusok · karakterláncok · megjegyzések)
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

További kiemelőszíneket használnak a függvényekhez, konstansokhoz, kijelölésekhez, diagnosztikához és előfeldolgozói direktívákhoz. Az orosz és szláv paletta szándékosan közepes intenzitású palát-, kék-, zsálya-, rubin- és antik aranyszínt használ a nyugodtabb, professzionálisabb megjelenésért.

A Vim-sémák telepítése

A repository gyökeréből:

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/

Adja hozzá a következőt a ~/.vimrc fájlhoz a SLeeLa szintaxiskiemelés engedélyezéséhez és egy séma kiválasztásához:

syntax enable
set background=dark
colorscheme sleela-american

Pontosan az alábbi colorscheme-nevek egyikét válassza:

Például a colorscheme sleela-russian-slavic a közepes orosz és szláv palettát, a colorscheme sleela-greek / colorscheme sleela-turkish pedig a helléni és az Al Bayrak palettát választja. Indítsa újra a Vimet, vagy töltse be újra a konfigurációt a :source $MYVIMRC paranccsal.

Az Emacs-sémák telepítése

Hozzon létre egy helyi témakönyvtárat, és másolja át a mód- és témafájlokat a repository gyökeréből:

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/

Adja hozzá ezt az ~/.emacs vagy az ~/.emacs.d/init.el fájlhoz:

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

Másik séma kiválasztásához cserélje le a sleela-american nevet a következők valamelyikére: sleela-eurasia, sleela-russian-slavic, sleela-silk-road, sleela-east-asian, sleela-greek, sleela-turkish, sleela-kiro vagy sleela-sleela. Ha az Emacs megkérdezi, hogy megbízik-e a témában, elfogadás előtt vizsgálja meg a helyi témafájlt.

A natív C/C++ paletták előnézete

A kis natív paletta-segédprogram képes listázni a sémákat, kiírni azok terminálszíneit, és lekérdezni egy-egy színt:

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

A visszamenőleges kompatibilitás érdekében a --theme nélküli --palette és --hex COLOR az American Professional sémát választja. A build- és tesztredményeket a célrendszeren és a CI-ben kell ellenőrizni; egy parancs dokumentálása önmagában nem bizonyíték arra, hogy sikeres volt.

A teljes palettaleírásokat és a segédprogram részleteit lásd a szerkesztő-integrációs útmutatóban.

IX. Közreműködés

  1. Olvassa el a dokumentációs indexet és a tesztelési szabályzatot.
  2. Végezzen célzott módosításokat pozitív és negatív tesztekkel.
  3. Futtasson célzott teszteket, majd a teljes csomagot.
  4. Adja meg az operációs rendszer/eszközlánc adatait; a kihagyott ellenőrzéseket ne írja le sikeresként.

A SLeeLa fejlesztője a MEARVK LLC. A korábbi nyitóoldali anyagot a docs/README-LEGACY.md őrzi.

X. AE6E66 — a Round Public e-mailekre vonatkozó illetékelvárás

Az AE6E66 kezdeményezés esetében a projekt kinyilvánított elvárása $300,000,000.00 USD minden egyes Round Public e-mailre, javasolt adóilletékként, minden egyes jogosult Round Public e-mailhez társítva.

Ez az állítás kizárólag a projekt elvárását rögzíti. Nem jogi adókivetés, kormányzati rendelet, bírósági ítélet vagy önállóan megállapított adókötelezettség. Bármely tényleges illeték az alkalmazandó jogi felhatalmazást, joghatóságot, fogalommeghatározásokat, eljárást és az illetékes kormányzati megállapítást igényelné.

XI. Ábécé- és karakterkészlet-futtatókörnyezet

A SLeeLa ábécé-dokumentációját és natív karakter-futtatókörnyezetét az alphabet/sleela/ és a lib/alphabet/native/ tartja karban. A natív C++17 tesztek a szigorú UTF-8 skalárdekódolást/-kódolást, a C<n> kapacitásaláírásokat és a korlátozott karakterkészlet-tagságot fedik le:

make -C lib/alphabet/native test

A kísérleti UTF-4088 katalógust és annak SLeeLa-keresőadapterét a utf-4088/SLeeLa-ALPHABET-INTEGRATION.md dokumentálja. Az UTF-4088 azonosítók külön névteret alkotnak, nem Unicode skalárértékek. A fordítói és SLVM-kötési munkát ezektől a natív alapoktól kifejezetten külön követjük.

XII. AutoCAD Creator™

Az AutoCAD Creator™ egy teljes egészében SLeeLa nyelven írt, interaktív 2D CAD-alkalmazás. Míg a testvér AutoCAD Renderer egy tervet egy lépésben rajzzá alakít, a Creator lehetővé teszi egy 2D AutoCAD-dokumentum élő létrehozását és módosítását — falak, helyiségek, méretezések és jegyzetek hozzáadását, majd az elhelyezettek mozgatását, átcímkézését, rétegváltását, törlését és visszavonását — és az eredmény mentését valódi AutoCAD DXF rajzként (R12 szöveg, megnyílik AutoCAD-ben / LibreCAD-ben).

Grafikus felülete a SleelaUI™-ra épül, a SLeeLa saját, többplatformos UI-eszköztárára (a lib/user-interface alatt) — nem JavaFX-re —, amely valódi natív ablakot nyit X11 / Cocoa / Win32 alatt. A tervezés egyetlen szabályt követ: „a SleelaUI megjelenít; a SLeeLa dönt”: a GUI soha nem számol geometriát és nem ír DXF-et. Minden eszköz létrehozási / módosítási / törlési / visszavonási / mentési szándékot küld a mérvadó SLCadCreator felé, amely a szerkeszthető dokumentumot és a visszafordítható parancselőzményt birtokolja, miközben a vászon csak a Creator által tartott geometriát jeleníti meg előnézetként.

Az újrahasznosítható szerkesztőmotor a lib/autocad alatt található — SLCadEntity, SLCadDocument, SLCadCommand és SLCadCreator — és teljesen fej nélkül (headless) is végigfut. A GUI-héj és a demó az autocad/creator alatt található:

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

Kijelzővel ez megnyitja az élő szerkesztőablakot; fej nélküli gazdagépen a rajzot a memóriában építi fel, kiírja a jelentést és a DXF-et, majd tisztán kilép.

XIII. UTF-4088 bemeneti térkép sorrendje

A specializált UTF-4088 katalógus a térbeli bemeneti térkép bejárását és az elvont nyomás-iterációkat az utf-4088/INPUT-MAP-AND-PRESSURE.md fájlban határozza meg. A National Lien tárgymutató-szabályzat az utf-4088/NATIONAL-LIEN-REGISTER.md fájlban található. A térképkoordináták, a nyomásszintek (1–50), az állandó katalógusazonosítók és az ábécé szerinti rangok egymástól független mezők; egyiket sem szabad csendben a másik helyére tenni. A nyomás algoritmikus iterációs szint, nem fizikai mennyiség.

XIV. Újabb és bővített csomagindex

Ez a hozzáfűzött index az újabban bővített csomagokat, doménkönyvtárakat és forrásgyűjteményeket emeli ki. A bejegyzések csomagnév vagy téma szerint ábécésorrendben csoportosítva szerepelnek. A leírások a repositorybeli helyet azonosítják; a megvalósítás és az érvényesítés állapotát az egyes csomagok saját dokumentációjában és tesztjeiben kell ellenőrizni.

A–C

D–G

H–I

O–S

U–W

A csomagindex karbantartása

Amikor egy csomagot hozzáadnak vagy érdemben bővítenek, vegye fel a bejegyzését ide a megfelelő ábécé szerinti csoportba, hivatkozzon a kanonikus könyvtárára és README-jére, és csak a becheckolt források által támogatott képességeket írja le. Tartsa ezt az indexet additívnak: a csomagindex frissítésének részeként ne távolítsa el és ne írja át a meglévő README-szakaszokat.


<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. Nemzeti tudományos arculati képanyag

<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. UTF-4088 egymillió bejegyzéses kísérleti katalógus

A UTF-4088 katalógusgenerátor determinisztikusan épít fel egy 1 048 576 bejegyzéses kísérleti szimbólumkatalógust. A dokumentált tömör formátumot az utf-4088/FORMAT.md írja le; a generálási és validálási szerződés az utf-4088/GENERATION-RESULTS.md fájlban található.

Futtassa a generátort Python 3-mal:

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

A generált bináris 16 777 244 bájt, és úgy tervezték, hogy 20 000 000 bájt alatt maradjon. Az egységtesztek és egy GitHub Actions munkafolyamat ellenőrzik a bejegyzések számát, a glifák egyediségét, a méretet és az SHA-256 értéket; a sikeres futások a binárist és az összegzést a utf4088-million-catalogue munkafolyamat-artefaktumként teszik közzé. A generált bináris szándékosan kimarad a Git-előzményekből. Az UTF-4088 kísérleti marad, és nem Unicode-kompatibilis.


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. Legutóbbi kiegészítések — Pi-állandó, Modium/Registry indítás, sleelactl Math és @native

Ez a szakasz a 2026-11-es munka során hozzáadott funkciókat rögzíti, a legújabb csoportokkal kezdve. A hivatkozott forrásfájlok és azok érvényesítési állapota mérvadó; az áttekintés alatt álló módosításokat nem írjuk le egyesítettként, amíg el nem érik a master ágat.

A 100 000 000 számjegyű Pi katalógusállandó

A repository egy ellenőrzött, száz-millió-számjegyű π-értéket szállít a pi-generator/pi.100000000.digits fájlban (jól formált tizedes tört, 3.14159…), egy 57 344 számjegyű érték, a pi-generator/pi.57344.digits mellett. Mindkettő egymástól függetlenül ellenőrzött, valódi π — lásd a pi-generator/VERIFIED.md fájlt, amely dokumentálja az ellenőrzéseket (tankönyvi előtag, a Feynman-pont a 762. törtjegy-pozíciónál, a híres egymilliomodik számjegy, egyezés a lib/math/SLPiReference.sleela fájllal és egy teljes fájlra kiterjedő számjegygyakoriság-elemzés), valamint egy egylépéses reprodukáló szkriptet.

A Modium™ / Registry™ az alrendszer indításakor betölti a Pi-állandót

A dedikált alrendszer-belépési pontokon — sleela registry és sleela modium (és a telepítő első futtatásakor), nem minden sleela run esetén — a Modium és a Registry alrendszer betölti a nagy π katalógusállandót. Interaktív terminálon átmeneti, piros Loading Modium™ / Loading Registry™ sort írnak ki, amelyet a normál kimenet megkezdése előtt a helyén törölnek; a hatás szigorúan TTY-hez kötött, így a csővezetékbe irányított és a tesztkimenet bájtról bájtra változatlan marad. A lelőhelyet (nem a bájtokat) a registry Math kulcs alapértékeiként, piReferenceLargePath és piReferenceLargeDigits néven töltik be, mind a SLeeLa-modellben (lib/registry/SLRegistry.sleela), mind a natív betöltőben (registry/sleela_registry.c); a lib/math/SLPiReference.sleela a largePath() / largeDigits() függvényeket teszi elérhetővé. A π-állandót az operációs rendszer SLeeLa-helyére (<data>/pi/) a szabványos make telepítő és a vezetett, „beautiful” telepítő is telepíti. Részletek: pi-generator/MODIUM-REGISTRY-PI-STARTUP.md.

sleelactl — a „beautiful” telepítő és egy natív hátterű math tárgy

@native, Native Drive és többnyelvű végrehajtás

Az új @native metódusannotáció egy forró metódus ahead-of-time natív fordítását kéri. Az új sleela aot parancs megkeresi a @native metódusokat, ellenőrzi, hogy mindegyik egy támogatott kiszervezhető részhalmazon belül van-e, és C/C++ kódot bocsát ki — zárt hibamóddal (fail closed): pontos indoklással megtagad minden olyan szerkezetet, amelyet még nem tud lefordítani, így félig lefordított metódus soha nem keletkezik.

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

Az @native továbbra is AOT-kezelés iránti kérés, a nem támogatott szerkezeteket a kibocsátás előtt elutasítják. A Native Drive többegységes C/C++ futtatható és megosztott könyvtár buildeket támogat gazdafordítókon keresztül (az MSVC-t is beleértve), támogatott SLeeLa AOT-kimenetet, szimbólumvizsgálatot a natív betöltő ABI-jával szemben, shell nélküli folyamatvégrehajtást, stdin/stdout/stderr kezelést, többlépcsős csővezetékezést, valamint az XClass delegálását a produkciós betöltőnek. A sleelactl elérhetővé teszi a build-/futtatási parancsait, és az XClass-vizsgálatot, valamint az explicit systemd-unit renderelést/telepítést az inspect native-drive parancson keresztül irányítja. A VM egy korlátozott méretű natív modul-handle táblát birtokol kötelező gazdaengedélyezéssel és generációellenőrzött handle-ökkel. A 3.0-s szintaxis most hozzáadja a nativeOpen, nativeCall és nativeClose hívásokat: a csak hozzáfűzhető bájtkód-diszpécselés egy külön verziózott null/bool/int64/double/UTF-8 ABI-n halad át, miközben a VM által birtokolt tömbök, struktúrák és más összetett értékek az interpreteren belül maradnak, és használhatnak azonos nevű bájtkód-tartalékot. A bővítmények opcionálisan kaphatnak egy verziózott gazda-visszahívási táblát, amellyel pontos SLeeLa-függvényeket hívhatnak meg beágyazott VM-végrehajtáson keresztül, felfüggesztett verem GC-gyökerezéssel, explicit gazda-visszahívásnév engedélyezőlistával, a rekurzív natív API-hívások pedig elutasításra kerülnek. A natív kód továbbra is megbízható, folyamaton belüli kód, nem homokozó. A forrásszintű folyamatpolitikai annotációknak van verziózott sémájuk, de még nem értelmezi és nem kényszeríti ki őket semmi. Részletek, biztonsági határok és a hét munkafolyamatos főkönyv: Native Drive és pi-generator/AT-NATIVE.md.

XIX. Nemzetközi README-kiadások

A SLeeLa országspecifikus README-belépési pontokat biztosít nemzetközi kiadásának 50 piacára. Minden országhoz egy README.<CC>.md nevű fájl tartozik; ahol több nyelv is releváns, azok az adott ország fájljában vannak csoportosítva.

Fordítási szabályzat: Ezek a fájlok kezdeti, lokalizált országos belépési pontok. Bevezetőik és nyelvi címsoraik lokalizáltak, a teljes műszaki referencia azonban a kanonikus angol README.md fájlban marad. Egy országfájl nem írható le teljes fordításként, amíg minden szakaszt le nem fordítottak, a műszaki azonosítókat és hivatkozásokat nem ellenőrizték, és a kiadás nyelvi felülvizsgálaton nem esett át. A nyelvi lefedettség ebben az első körben reprezentatív, és nem állítja, hogy minden alkotmányosan elismert, regionális, őshonos vagy jelnyelv teljesen le van fordítva.

Függelék — megőrzött regionális útmutatás

Az alábbi gyakorlati szakaszok a korábbi, rövidebb magyar útmutatóból származnak, és a kanonikus README mellett maradnak meg. Nem helyettesítik a fentebbi szakaszokat; ahol eltérés mutatkozik, a kanonikus tartalom az irányadó.

Célplatformok, profilok és a natív végrehajtás határai

A SLeeLa külön kezeli a forráskódot és a build-/végrehajtási célokat. A dokumentált célcsalád része az SLVM, az SLJVM és az SLIR; a NATIVE korlátozott, feltételekhez kötött cél, ezért nem tekinthető minden platformon általánosan elérhetőnek. A BASIC_COMPLETE és az ADVANCED_TOTAL profil eltérő hatókört jelöl (lásd az api/sleela/*/package/vm.html oldalakat). Minden buildnél ellenőrizze a tényleges célt, profilt és platformtámogatást.

A hivatkozás fájlt, modult vagy erőforrást azonosít, de önmagában nem ad végrehajtási engedélyt. Ez különösen fontos fájlok, külső könyvtárak, natív kötések és rendszererőforrások használatakor. Ellenőrizze a bemeneteket, és határozza meg, melyik komponens jogosult az adott műveletre. A dokumentációban szereplő állítás önmagában nem bizonyít futásidejű biztonsági garanciát; ehhez megvalósítási és tesztbizonyíték szükséges.

Erőforrás-életciklus és hibakeresés

Dokumentálja a függvények vagy szálak között megosztott erőforrások tulajdonjogát, élettartamát és szinkronizációját. Különböztesse meg a lokális változókat, a megosztott objektumállapotot, a VM-handle-öket és a szerializálható adatokat. A VM-lokális handle nem stabil fájlformátum vagy hálózati üzenet. Használja a modul dokumentált szerializációs felületét, és tesztelje az érvénytelen, hiányzó és határértékű bemeneteket.

Hibakereséskor rögzítse a commitot, az operációs rendszert, az architektúrát és az eszközláncot. Először a legkisebb releváns célt fordítsa le, őrizze meg a teljes hibaüzenetet, különítse el a fordítási hibákat a futásidejű hibáktól, és készítsen minimális, reprodukálható példát. A sikeres build önmagában nem bizonyítja a helyes futást.

A megfelelő ellenőrzési jelentés tartalmazza a pontos commitot, az operációs rendszer és az architektúra adatait, a fordítóverziókat, a teljes build- és tesztparancsokat, a sikeres/sikertelen/kihagyott tesztek számát és az ismert korlátozásokat. A kihagyott vagy le nem futtatott teszt nem számíthat sikeresnek.

Modul-API-szerződések, kompatibilitás és tesztelés

Új API bevezetésekor dokumentálni kell a bemeneteket, kimeneteket, hibafeltételeket, az adatok tulajdonjogát és az esetleges mellékhatásokat. A példáknak a szokásos használat mellett az érvénytelen vagy hiányzó bemenet kezelését is be kell mutatniuk. Olyan viselkedést ne állítsunk garanciaként, amelyet a megvalósítás és a tesztek nem igazolnak.

A teszteket a fordítási folyamat rétegei szerint érdemes csoportosítani: lexikai elemzés/szintaktikai elemzés, szemantikai elemzés, IR-leképezés, kódgenerálás, VM-végrehajtás és natív integráció. Minden regressziós esetnél őrizzük meg a legkisebb reprodukálható bemenetet, az elvárt és a tényleges eredményt. API-változásoknál ismertetni kell a visszamenőleges kompatibilitás kérdéseit, a migrációs lépéseket és a meglévő példákra gyakorolt hatást.

Nemzetközi dokumentáció karbantartása és lokalizáció

Az országonkénti README-k helyi belépési pontok a műszaki dokumentációhoz; nem helyettesítik a normatív nyelvi specifikációt vagy a modulok API-dokumentációját. Az angol forrás változásakor ellenőrizze a fordítás elavulását. Az azonosítókat, parancsokat, útvonalakat, szintaxist és kódpéldákat minden nyelvi változatban változatlanul kell hagyni; a magyarázó szöveget kell fordítani, a forráskód tokenjeit és neveit nem. A magyar terminológiát következetesen kell használni.

Minden frissítés után ellenőrizze a Markdown-hivatkozásokat, a címsorhierarchiát, a kódkerítések párosítását és a példákat. Az angol kanonikus dokumentumok módosításakor szakaszonként hasonlítsa össze és frissítse a fordítást, ne csak a bevezetőt. A nyelvi vagy műszaki ellenőrzésen még át nem esett tartalmat jelölje.

Fordítási állapot: Az I–XIX. szakasz magyar nyelvre lefordítva. A műszaki azonosítók, parancsok, kódpéldák, fájlnevek, hivatkozások és címek megmaradtak. Anyanyelvi beszélők általi záró nyelvi ellenőrzés ajánlott.