SLeeLa # SLeeLa 3.0 — Ísland (IS)

SLeeLa — The Now. The Ingredient.

SLeeLa Marketing Logo

Innbyggt kerfisforritunarmál, þýðandi, keyrsluumhverfi og vistkerfi sýndarvéla.

GitHub Actions Platform matrix

> **Alþjóðleg landsútgáfa.** Þessi útgáfa er á íslensku. Tæknileg auðkenni, skipanir, kóðadæmi, skráarnöfn, slóðir og tenglar eru óbreytt frá hinu staðlaða enska [README.md](../../README.md). **The Now. The Ingredient.** Tungumál er meira en setningafræði: það er þýðandinn, keyrsluumhverfið, söfnin, verkfærin og samningar um vettvang sem gera hugbúnað nothæfan. **Hvað SLeeLa tekur þátt í.** SLeeLa tekur þátt í **Math**, **Object**, **Science** og **Reach** — fjórum hliðum starfs þess: hinu reiknanlega (Math), hinum afgreidda hlut sem stendur í skrá yfir það sem er (Object), hinni agaðri rannsókn á hinu sanna (Science) og útréttri hönd kerfis til annarra kerfa og fólks (Reach). **Þjóðarhagsmunir haldast** — enginn þessara fjögurra þátta setur þá til hliðar; þegar viðfangsefni snertir hagsmuni þjóðar er sú staða varðveitt (skráð af trúmennsku, t.d. í `metaOrigin` / `metaNationalSchedule` í lýsigögnum hvers flokks), aldrei leyst upp. ## I. Byrjaðu hér - [Smíðaðu innbyggðu útfærsluna](../../impl/README.md) - [Sýndarvélar og Modium — hagnýt notendahandbók](../../virtual-machine/USER-GUIDE.md) (`sleela vm`, `sleela modium`) - [CPU-stafli í SLeeLa-frumkóða](../../lib/cpu/CPU.md) — heil vél frá rökhliðum → ALU → kjarna → stýrikerfi → forrit, skrá yfir 130+ CPU-snið og stillanleg [spenna, breytileg klukka og sérfræðitímasetningar](../../lib/cpu/TIMING.md) sem þú getur [keyrt samkvæmt forskrift og yfirklukkað](../../lib/cpu/components/README.md) - [Skjalayfirlit](../../docs/README.md) - [CSPML-gagnalind og tilvísun í Salt & Salary-rannsókn](../reference/CSPML.DATA.SOURCE.AND.SALT-AND-SALARY.REFERENCE.md) — upprunaskráning og leiðbeiningar um samþættingu ytri bandarískra gagna um staði, félags- og efnahagsmál, vinnuafl, menntun og opinbera skóla. - [Mynduð API-skjöl](../../docs/api/README.md) — núverandi HTML-viðmiðun, útgáfubundin API-útgáfa og leiðbeiningar um endurmyndun - [API-skrá](../../api/README.md) - [Samanburðarstaðlar fyrir útreikninga](../../comparison/README.md) — staðlar fyrir gerðir, minni, ABI og samræmi hjá SLeeLa VM, Java/JVM og innbyggðu C/C++. - [Recursion stanchion — C- og C++-frumgerðir](../../recursion/stanchion/README.md) — dæmi sérhæfð fyrir frumgerðirnar Boolean, Byte, Character, Integer, Long, Float og Double, ásamt almennum, hagnýtum, vísindalegum og kennslutengdum endurkvæmnimynstrum. - [Stuðningur við vettvang og sannprófunartafla](../../docs/PLATFORM-SUPPORT.md) - [Vörumerkjahandbók](../../docs/BRAND-GUIDE.md) - [Söluvöruhugmyndir og gögn](../../merchandise/README.md) - [NitroWebExpress-merki](../../images/nitro-web-express/nitrowebexpress-logo-004.jpeg) - [Prófunarstefna og útgáfuhlið](../../markdown/TESTING.md) ## II. Fréttir Nýlegar viðbætur við málið, rekla og staðalsafn: - **`advantage`-staðalsafnspakkinn — að „advantage-a“ arðgreiðslu, með stærðfræði, eðlisfræði, samþættingu, einkunnagjöf og framsendanlegu úttaki.** [`lib/advantage/`](../../lib/advantage/README.md) hjúpar *að advantage-a einstaka arðgreiðslu með tilliti til líkans* sem lagskipta **Sequitur-lauk** (arðgreiðsla → yfirferð → áhyggjuefni → stærðfræði → viðbætur → frádráttur → endurflokkun → ítrun), sem hægt er að rata um inn á við og út á við með fullri kvikri uppfærslu og endurheimt, og er aðgengilegur í gegnum einfalt **líkan notandans** og **líkan þróunaraðilans** með fullri stjórn. Hann geymir fimm viðfangssvið: **`math/`** tvíhliða viðskiptahagfræði (sameiginleg hagnaðarhámörkun, Nash-samningagerð, mikilvægt hlutfall tvíhliða newsvendor-líkansins), **`physics/`** byggingarhagfræðilega „eðlisfræði traustsviða“ (traust sem metrískur tensor, viðskiptageódesían, tilkynningarsnertibygging, CIR+stökk SDE fyrir traustrýrnun — líkanssamlíking, merkt sem slík), **`integration/`** endurkvæmt samsetjanlegt líkan lóðréttrar samþættingar fyrir kapítalisma/smásölu (hólf, verkfræðiflóar, tilraunahólf, newton-miðgildisbakkar og einkunn fyrir fágun kerfis), **`grading/`** fágunarrásar-einkunnagjafa sem metur hverja einingu og hvaða safn sigurvegara/taparaeininga/gjafaeininga/algildra eininga sem er á kvarðanum A–D, og **`output/`** framsendanlegt úttakssamskeyti sem sendir úttak eininga á skjáinn, á **CommonRails**-sniðið yfirborð eða á tengil/innstungu (rammað fyrir innbyggt `slnet_write`). Hver flokkur ber Metadata-Class-færsluna; fimm keyranleg sýnidæmi sannreyna viðfangssviðin og fylgiskjölin [`DEFINITIONS.md`](../../lib/advantage/DEFINITIONS.md), [`MATH.md`](../../lib/advantage/MATH.md) og [`PHYSICS.md`](../../lib/advantage/PHYSICS.md) lýsa þeim. Innbyggður C/C++-notandi undir [`advantage/`](../../advantage/README.md) (C-kjarninn `advantage_value`/`advantage_mean`, XML-þekkingargeymsla, örugg HTTPS/SFTP/SSH-öflun + lyklageymsla + DH/ECDH-flutningssafn) tengir líkanið við útfærð [viðskiptadæmi](../../advantage/examples/README.md) — jákvæð viðskipti frá gefnum netheimildum, röð sniðin að áheyrendum (Traders, Consumers, Helpers, Healers) og átta líkön raðað A–D (D = mest Cement, A = mest Brand). - **Lykkjutímasetningar-merkingar — `@loopDelay` / `@loopBudget` (+ innbyggt fall `sleep(ms)`).** Fyrstu **setningastigs-, hegðunar**merkingarnar í SLeeLa: þær eru skrifaðar á sérlínu á undan `for` / `while` / `do`-lykkju og setja raunverulega bið inn í keyrslu lykkjunnar. `@loopDelay(ms = 250)` / `@loopDelay(seconds = 2)` sefur fastan tíma í hverri ítrun (berskjölduð `@loopDelay(250)` miðast sjálfgefið við millisekúndur); `@loopBudget(seconds = 10, iterations = 1000)` dreifir þekktum fjölda ítrana jafnt yfir heildartímaáætlun á vegg-klukku. Báðar lækkast í nýju viðbótaraðgerðakóðana **`OP_SLEEP`** (ISA 157), sem stendur einnig að baki almennu innbyggðu falli **`sleep()`** sem hægt er að kalla á hvar sem er; biðin er útfærð færanlega (`nanosleep` / `Sleep`). Skilgreint í [`SLEELA.syntax` §32](../../SLEELA.syntax); API-viðmiðun í [`api/sleela/3.0/LOOP_TIMING_API.md`](../../api/sleela/3.0/LOOP_TIMING_API.md); keyranlegt [`examples/loop-timing-annotation-demo.sleela`](../../examples/loop-timing-annotation-demo.sleela). Yfirlit yfir viðbætur lotunnar (þar á meðal þessa, innbyggðu stórtölumargföldunina `OP_BIGMUL` og sjálfstæðu verkfærin **[local-generator](../../local-generator/README.md)** og **[pi-generator](../../pi-generator/README.md)**) er í [`api/sleela/3.0/SESSION-ADDITIONS-API.md`](../../api/sleela/3.0/SESSION-ADDITIONS-API.md). API-yfirborðin þrjú sem mynduð eru ([`sleeladoc-api/`](../../sleeladoc-api/README.md), [`docs/api/`](../../docs/api/README.md) og óbreytanlega [`api/sleela/3.0/version-014/`](../../api/sleela/3.0/version-014/index.html) skyndimyndin) voru endurbyggð með `make api-docs` og bera nú nýju `SLISASleep` / `SLISABigMul`-skipanafærslurnar á `vm`-pakkasíðu sinni. - **SleelaDoc af skipanalínu — `sleela docs`.** Nú er hægt að ná í SleelaDoc beint úr skelinni. `sleela docs` listar öll skjalanleg viðfangsefni; `sleela docs crypto` sýnir pakka; `sleela docs stringbuilder` leysir upp flokk (án tillits til há-/lágstafa og með `SL`-forskeyti staðalsafnsins → `SLStringBuilder`) og prentar ríkulega síðu — **skilgreining, hönnunartilgang, tengsl, byggingu, notendaleir og fimm þrepa leikni-stiga** — með röðuðum „áttirðu við“-niðurstöðum þegar næstum hittist. Höfundar auðga hverja síðu einfaldlega með því að bæta við SleelaDoc-`@`-merkjum (`@intent`, `@thesis`, `@axiom`, `@param`, `@see`, `@mastery`). `sleela docs --generate [dir]` skrifar hreinan textaforða (eina síðu fyrir hvern flokk + `TOPICS.index`) sem skipanalínan les síðan án nettengingar; **`make sleeladoc`** pakkar þeim forða **og samsvarandi `.sleela`-frumkóða** í `sleeladoc/build/sleeladoc.jar`. Fyrir viðfangsefni sem eingöngu eru framhlið (t.d. `psychiatry`, `politico`) leitar `sleela docs --facade ` í skráakerfinu á keyrslutíma og listar raunverulegar **möppur (síðan skrár, sem eðlilega hreyfingu)**, afmarkað af mörkum sem notandi getur breytt: **6 MB / 6000 skrár / 6 mínútur**. `lib/sleeladoc`-einingarnar eru viðhaldið í núverandi útgáfu, **`#sleela 3.0`**. Sjá [`man/man1/sleela.1`](../../man/man1/sleela.1) og [`lib/sleeladoc/README.md`](../../lib/sleeladoc/README.md). - **SleelaDoc — skjalalausn að hætti Javadoc, með myndaðri HTML-vefsíðu.** **SleelaDoc** er skjalaathugasemdavenja SLeeLa í frumkóða (hornklofaathugasemdir með vörðunum `@doc` / `@page`; sjá [`manifesto/SLEELADOC.md`](../../manifesto/SLEELADOC.md)) og [`lib/sleeladoc`](../../lib/sleeladoc/README.md) er **útdráttarverkfærið** sem birtir `.sleela`-einingu sem Markdown- eða HTML-API-síðu — á sama hátt og `javadoc` birtir Java, með því að skjalfesta *ásetning*. Heil, vafranleg **HTML-skjalavefsíða fyrir alla `/lib`** er mynduð í [`/sleeladoc-api`](../../sleeladoc-api/README.md) með `tools/generate-sleeladoc-api.py` (opnaðu `sleeladoc-api/index.html`; hreinn stíll í bláu / ljósbláu / ljósgráu / hvítu með stigveldi pakki → flokkur → meðlimur og orðasafni skrifuðu fyrir lesandann *Student 2*). Þýðandinn sendir einnig frá sér höfundarmerkt skjalaúttak sem aukaafurð þýðingar (`--wiki` MediaWiki-síða + upprunninn frumkóðatvíburi), skjalfest í [`manifesto/SLEELADOC.WIKI.md`](../../manifesto/SLEELADOC.WIKI.md). Keyranlegt: [`lib/sleeladoc/sleeladoc-demo.sleela`](../../lib/sleeladoc/sleeladoc-demo.sleela). - **XML-skjalahlutalíkan (`lib/xml`).** XML DOM SLeeLa-megin — skjal sem á tré af element-/texta-/athugasemda-/CDATA-/PI-hnútum með röðuðum börnum og nefndum eigindum, raðgerðari (þéttur/fallegur hamur, XML 1.0 §2.4 flóttar), stafahólfa-þáttara og gæðaskránni `SLXmlAspect`. Jafngildi hnúta er þriggja þrepa trausts-jafntefli (auðkenni → sama viðfang → bygging), sjálfhverft, samhverft og ákvarðandi. Sjá [`lib/xml/README.md`](../../lib/xml/README.md) og keyranlega [`lib/xml/xml-dom.sleela`](../../lib/xml/xml-dom.sleela). - **Víðar 64-bita formerktar heiltölu-frumgerðir (`long`, `int64`, `int128`).** `int`, `long` og `int64` eru allar 64-bita formerktar heiltölur sem gerðatékkast og keyra eins; `int128` er samþykkt sem heiltölugerð (að svo stöddu studd af 64 bitum, með sönnu 128-bita sem skjalfest framhaldsverkefni). Tvíundar-2 formerkta röðin `int32`..`int16777216` (málskipan 2.7) og samsvarandi óformerkta röðin `uint32`..`uint16777216` (málskipan 2.8) auka þetta. Sjá [`SLEELA.syntax`](../../SLEELA.syntax) §21, §24, §25. - **`@mix` afleidd svið (málskipan 2.9).** Flokkur má lýsa yfir mörgum tilviksreitum með **sama nafni** ef hver endurtekning ber `@mix`; málið skilur hópinn sem afleiddan (fylki / lista með vísi), ofanfrá og niður `1,2,3,…` sjálfgefið eða handvirkt með `@mix(1,2,3,...)` þar sem fjöldi vísa þarf að passa við fjölda reita. Sjá [`SLEELA.syntax`](../../SLEELA.syntax) §28. - **Skjalamerki — hið náttúrulega ferli, titlað Preonems (`author`/`authorial`, `material`, `memory`, `determine`, `object`, `field`).** Þessi berskjölduðu skjalamerkisorð eru sameiginlega titluð **Preonems** (eitt merki er *Preonem*; safnið *Preonems* — sjá [`SLEELA.syntax`](../../SLEELA.syntax) §26.1). Fyrsta flokks skjalamerki, eingöngu yfirlýsandi, sem nefna hvað skjal *er* í röð gerðar: `author`/`authorial` (málskipan 2.4; meðhöndlað af faglegu ráði — eini meðlimurinn með hegðunaráhrif), `material;` (afgreitt Source) og `memory;` (málskipan 2.5), `determine;` (málskipan 2.6; skjal opið til frekari vinnslu af lækni, lyflækni eða draugi í átt að lúkningu með löglegri hendi), og tvö hin nýjustu, **`object;`** (afgreiddur hlutur í skrá yfir það sem er — **raungerður, gefin áþreifanleg staða, í málskipan 2.8**) og **`field;`** (grunnur tengsla þar sem hlutir standa og hreyfast) — bæði hliðuð frá málskipan 2.6. Hvert er berskjaldað, samhengisbundið og útgáfuhliðað af framendanum án áhrifa á þáttun, tegundagreiningu eða kóðagerð; utan merkisstöðu er hvert þeirra áfram venjulegt auðkenni (svo `field` truflar aldrei flokksmeðlim eða `.field`-aðgang). Sjá [`SLEELA.syntax`](../../SLEELA.syntax) §18–§20, §23 og §26. - **Nordshrift í málskipan 3.0 með fullri ná til safna.** Nordshrift leysir upp í gegnum sömu endurkvæmu `/lib`-vísitöluna og þýðandinn og nær til hvers pakka og hverrar `.sleela`-einingar; `nordshrift check` skilar heildartölum alls trésins. - **Recursion stanchion.** Skráin [`recursion/stanchion/`](../../recursion/stanchion/README.md) inniheldur nú sérstakar C- og C++-viðmiðunarfrumgerðir fyrir samningana sjö um frumgerðir sem skjalfestir eru, auk almennra, hagnýtra, vísindalegra og kennslutengdra dæma. Þetta eru viðmiðunarfrumkóðar; þýddu þá og prófaðu áður en þeir eru taldir sannprófaðir. - **Hornklofaathugasemdir (`<` / `<<`).** Nýr athugasemdastíll héðan í frá — `< lína >` og `<< blokk >>` — lesinn af SLeeLa-framendanum og skjalfestur í [`SLEELA.syntax`](../../SLEELA.syntax) §1.1. - **Heiltölustaðvirði í mismunandi grunntölum.** `int`-staðvirði taka nú við sextándakerfi (`0x`), tvíundarkerfi (`0b`) og áttundakerfi (`0o`) með `_` sem tölustafaskilju, bæði í SLeeLa-frumkóðamálinu ([`SLEELA.syntax`](../../SLEELA.syntax) §1.4) og í [`.xlt` CPU-líkanasniðinu](../../lib/xlt/README.md). - **Metadata Class-staðallinn um allt safnið.** Lýsigagnamynstrið (uppruni, lögmæti, lögsagnarumdæmi) er nú borið af hverri `.sleela`-skrá með flokkum undir `/lib`; sjá [`SLEELA.syntax`](../../SLEELA.syntax) §15 og [kennslustundina](../../tutorial/13-metadata-class.md). - **Ríkulegri texta- / String-fjölskylda.** `lib/text` fær raunveruleg hjálparföll í málinu, stafahólfasýn sem veitir ósvikin `charAt`/`substring`/`indexOf`/`reverse`/dálkajöfnun og raunverulegt staðsetningarbundið sniðmátskerfi — sjá [texta- og String-kennsluna](../../tutorial/14-text-and-strings.md) og keyranlega [`lib/text/text-string-demo.sleela`](../../lib/text/text-string-demo.sleela). - **Fyrsta flokks `String` í Nordshrift-blöðum.** `.sst`-blað getur lýst yfir tegundaðri `strings:`-blokk sem leggur til íhlutaskrá smíðinnar; sjá [Nordshrift Sheet Reference](../../wiki/Nordshrift-Sheet-Reference.md). - **CPU-líkön keyrð bæði með aðgerðakóðum og jafngildi fallakalla.** Hvert `SLCPU` erfir þann grunn að keyra innbyggða skipanarunu í gegnum sækja-afkóða-framkvæma-lykkju sína *og* keyra kóða ætlaðs annars ferlis með jafngildum köllum á sameiginlega VM-undirlaginu — sjá [`lib/cpu/EXECUTION.md`](../../lib/cpu/EXECUTION.md) §5. ## III. Smíði og prófanir **Forkröfur:** C/C++-verkfærakeðja (GCC eða Clang) og GNU Make; Python 3 fyrir manifest-/flæðiverkfærin; á Linux X11/Xrandr-þróunarpakkar fyrir skjávörurnar (`make deps` einingar greinir frá / setur upp það sem hún þarf). Smíði `impl/` er lokuð við bilun (fail-closed) gagnvart traustu SHA-256-manifesti, sem `Makefile` í rót vísar sjálfkrafa á. Hraðasta byrjun úr hreinni útteknu afriti: ```sh make # build everything from the repo root ``` Eða smíðaðu og prófaðu aðeins innbyggða kjarnann: ```sh make -C impl all # build the core compiler/runtime only bash ./test-suites/run-all.sh --all # run the full test suite ``` Make-skipunin í rót hugbúnaðarsafnsins smíðar sérhverja vöru (kjarna, VM, kóðunarsöfn, churn, vírusvörn, …) og lýkur með því að smíða **registry** og efnisgera grunntöflu þess — þannig fylgir smíðuðu tré yfirferðarhæft registry beint úr kassanum. Mikilvægustu markmiðin: ```sh 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 ``` Önnur gagnleg markmið: ```sh 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/) ``` `registry`-markmiðið keyrir [`build-registry.sh`](../../build-registry.sh): það smíðar registry-kjarnann, sáir grunntöflunni í færanlegu textageymsluna `registry/build/sleela.sleelareg` og flytur út MySQL-töfluskriftuna `registry/build/registry.sql` (með `sleela registry export`). Yfirfarðu það með `sleela registry` eða `registry/build/sleela-registry review`. Sjá [registry-handbókina](../../registry/README.md) og [Registry 3.0-arkitektúr](../../registry/REGISTRY-3.0-ARCHITECTURE.md). Lestu smíða- og prófunarleiðbeiningarnar um forkröfur og skref sem eru háð vettvangi. Vel heppnuð smíði eins íhlutar sannar ekki að sérhvert safn eða vettvangur sé tilbúinn til útgáfu. ## IV. Uppsetning Eftir að innbyggðu vörurnar hafa verið smíðaðar skaltu setja upp skipanirnar og stuðningsskrár keyrsluumhverfisins: ```sh 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 ``` Hefðbundna uppsetningarforritið notar sjálfgefið `/usr/local/bin`, `/usr/local/lib/sleela` og `/usr/local/share/sleela`. Það varðveitir fyrirliggjandi ræsistillingar og neitar að skrifa yfir fyrirliggjandi skipanir sem eru ekki raktar. Afuppsetning fjarlægir aðeins skrár sem uppsetningarforritið skráði og varðveitir stillingar og órakin keyrslugögn. Fyrir einbeitta, leiðbeinda uppsetningu á aðalpakkanum einum — tvíundunum `sleela`, `sleelvac` og `nordshrift`, staðalsafninu, samskiptareglunum og stuðningseiningunum — notaðu hreina uppsetningarforritið: ```sh make clean-install # guided install of the main package only ``` Það krefst einnar aðalákvörðunar (að setja upp aðalpakkann), síðan vals á umfangi og að því loknu valfrjáls veljari fyrir valdar viðbótareiningar. Fyrir gagnvirka uppsetningarferlið og alla uppsetningarvalkosti, sjá [Hröð og örugg uppsetning](../../install/README.md). ## V. Mál og keyrsluumhverfi Opinbera málskipanin er [`SLEELA.syntax`](../../SLEELA.syntax). Núverandi hugbúnaðarsafn skjalfestir málskipan **3.0**; útgáfa þýðanda/verkfæris og útgáfa frumkóðamálskipanar eru aðskildar. Útgáfa 3.0 bætir við **skjalamerkjunum `pure` og `gasoline`** (§30) — pari berskjaldaðra, samhengisbundinna Preonems, eingöngu yfirlýsandi, sem þýða nánast það sama og merkja hvort um sig stöðu skjalsins með eigin heiðarleika. Málskipan 3.0 sameinar yfirborð málsins 1.0–2.9 í núgildandi staðalútgáfu og varðveitir öll lágmarkshlið einstakra eiginleika. Fyrra 2.9-yfirborðið bætir við **`@mix` afleiddum sviðum** (§28) — flokkur má lýsa yfir mörgum samnefndum tilviksreitum þegar hver ber `@mix`, skilið sem einn vísaður hópur (ofanfrá og niður `1,2,3,…` eða handvirkt `@mix(1,2,3,...)` þar sem fjöldi vísa þarf að passa við hópinn). Það heldur áfram með tvíundar-2 formerktu/óformerktu víðu heiltölufjölskyldurnar `int32`..`int16777216` (§24) og `uint32`..`uint16777216` (§25) ofan á fyrri `long`/`int64`/`int128` (§21); **lykilorðastuðningsskjöl** (§22); og **Preonems** — eingöngu yfirlýsandi skjalamerkin `author`/`authorial` (§18), `material`/`memory` (§19–§20), `determine` (§23), `object`/`field` (§26), `pure`/`gasoline` (§30) og `artifact` (§35, staða á löggjafarstigi flokkuð eftir tíma og rúmi), sameiginlega titluð Preonems (§26.1). Yfirhleðsluupplausn smiða og framsal `this(...)`/grunnsmiðs eru sérstaklega utan staðfests samnings málskipanar 1.8. Skoðaðu málskipanina og útfærsluathugasemdir áður en þú reiðir þig á eiginleika. Níu frumkóðaeiningar SleelaDoc lýsa nú yfir `#sleela 3.0`; sameiginlega þýðandahliðið tekur við frumkóðamálskipan 1.0–3.0. Nýja API-smíðin er framleidd með `make api-docs`. Hugbúnaðarsafnið inniheldur innbyggða C/C++-útfærslu, viðmiðanir um SLVM-myndun, staðalsafnseiningar, prófanir, dæmi og samþættingar við vettvanga. Útfærslu- og sannprófunarstaða er breytileg eftir einingum; styðstu við forskrift hennar og núverandi CI-niðurstöður frekar en að gera ráð fyrir einsleitri fullkomnun. ## VI. Verkfræðilegar meginreglur - **Gögn framar fullyrðingum:** greindu á milli útfærðrar, prófaðrar, tilraunakenndrar og fyrirhugaðrar hegðunar. - **Einn samningur á hver mörk:** skjalfestu málskipan, API, skráarsnið, forsendur um vettvang og hegðun við bilun. - **Færanlegt í hönnun:** einangraðu vettvangsháð bakendi og prófaðu á innbyggðum keyrurum. - **Örugg bilun:** prófaðu gallað inntak, auðlindamörk, ferlabilanir og hreinsunarleiðir. - **Endurtakanlegar útgáfur:** endursmíðaðu hreint og birtu tætigildi afurða og útgáfuathugasemdir. ## VII. Vírusvarnarsmíði og heilleiki Vírusvarnarpakkinn Sleelavirin inniheldur innbyggðan SHA-256-skanna, valfrjálsan ClamAV-millistykki, heilleikamanifest fyrir frumkóða/vísitölur og yfirsummur vettvangspakka. Smíðaðu og prófaðu pakkann úr rót hugbúnaðarsafnsins: ```sh make antivirus make antivirus-test make antivirus-integrity make antivirus-integrity-check MANIFEST=build/INTEGRITY-MANIFEST.json ``` Heilleikamanifestið er myndað undir `antivirus/build/`; það nær yfir raktan frumkóða og skjalainntak auk varinna undirskriftavísitöluskráa, en undanskilur myndað úttak og breytanlegt ClamAV-skyndiminni. Skyndimyndir ClamAV-gagnagrunna hafa eigin manifest. Útgáfu-ZIP innihalda `INTEGRITY-MANIFEST.json`, `SHA256SUMS` og `.sha256`-hliðarskrá. Sannreyndu tætigildi sóttra skjalasafna gegn traustu gildi sem fengið er óháð: yfirsumma sem geymd er við hlið skjalasafns er ekki undirskrift útgefanda. Sjá [Sleelavirin-handbókina](../../antivirus/README.md), [öryggisgátlistann](../../antivirus/SECURITY.md) og [smíðaflæði vírusvarnar](../../.github/workflows/antivirus-binaries.yml). Útgáfa telst ekki sannprófuð fyrr en viðeigandi CI-verk standast á nákvæmlega útgáfu-commitinu og afurðirnar sem af því hljótast hafa verið athugaðar. ## VIII. SLeeLa ritlaþemu — Vim og Emacs SLeeLa inniheldur samræmt safn faglegra dökkra litaþema fyrir **Vim** og **Emacs**, auk innbyggðs C/C++-litaveituforrits. Upprunalega þemað **American Professional** er áfram sjálfgefið. Tíu fylgipalettur eru í boði, innblásnar af ólíkri menningar- og stofnanahönnun; þetta eru túlkandi hönnunarpalettur, ekki opinber framsetning neinnar þjóðar, menningar, dómstóls eða stofnunar. ### Þemun ellefu og litir þeirra | Þema | Bakgrunnur | Forgrunnur | Lykilorð | Gerðir | Strengir | Athugasemdir | |---|---|---|---|---|---|---| | **American Professional** | `#101820` | `#F4F7FA` | `#7FB3FF` | `#73DACA` | `#F2C078` | `#8A96A3` | | **Pan-Eurasian** | `#111827` | `#F0F2F5` | `#7AA7E8` | `#69C9B3` | `#D7B56D` | `#8995A5` | | **Russian and Slavic — Medium** | `#202733` | `#E8EAF0` | `#A9C0DD` | `#8FC4B2` | `#D6BD8B` | `#9AA3AF` | | **Central Asian / Silk Road** | `#1C2529` | `#F5F0E5` | `#7FADE0` | `#45C6C2` | `#D9B56D` | `#92A3A0` | | **East Asian** | `#171A1C` | `#F2EFE7` | `#D97878` | `#72C7A5` | `#D8B76A` | `#969F9B` | | **ICC — International Criminal Court** | `#0E1A2B` | `#EAF0F7` | `#5B8FD6` | `#7FB7C9` | `#D9B25A` | `#7E8CA0` | | **SCOTUS — U.S. Supreme Court** | `#1A1416` | `#F3EEE6` | `#9E2B35` | `#8FA9B8` | `#C9A24B` | `#8C8178` | | **Greek (Hellenic)** | `#0A1A30` | `#FFFFFF` | `#2E7BD6` | `#5E9FE0` | `#9FC3EC` | `#6E86A6` | | **Turkish (Al Bayrak)** | `#2A0609` | `#FFFFFF` | `#F23D48` | `#F0A9AE` | `#F0C9A9` | `#A8767A` | | **Kiro** | `#0B0B12` | `#F5F5FA` | `#A98EDA` | `#6E8BE0` | `#E8C547` | `#6A6482` | | **SLeeLa** | `#08080E` | `#FFFFFF` | `#B07CFF` | `#5A7CFF` | `#FFD21E` | `#6E5F9E` | #### Þjóðfánalitir (upprunapaletta) Gríska og tyrkneska þemað eru leidd af **opinberum þjóðfánalitum** landanna tveggja, sýndum með nákvæmum útgefnum sextándagildum. Bakgrunnar og áherslulitir þemanna hér að ofan eru dekktar túlkanir á þessum upprunalitum, sniðnar að ritlum — taflan hér að neðan er viðmiðunin „litir eins og þeir eru birtir af þjóðunum“. | Þjóð | Litur | Hex | Grunnur og merking | |---|---|---|---| | **Grikkland** | Blár | `#0D5EAF` | Blár litur þjóðfánans (lög 851/1978). Himinninn og höfin; í skjaldarmerkjafræði nefndur *azure*. | | **Grikkland** | Hvítur | `#FFFFFF` | Hvítur litur þjóðfánans. Hreinleiki sjálfstæðisbaráttunnar; krossinn táknar grísk-rétttrúnaðarkristni. | | **Türkiye** | Rauður (*al bayrak*) | `#E30A17` | Rauður litur þjóðfánans (tyrknesku fánalögin). Flöturinn; samkvæmt hefð blóð píslarvotta og fullveldi Ottómana. | | **Türkiye** | Hvítur | `#FFFFFF` | Hvítur litur þjóðfánans. Hálfmáninn og stjarnan — friður, hreinleiki og tákn tyrkneskrar/íslamskrar arfleifðar. | Þemun festa forgrunn hvers ritils á þjóðarlitinn **hvítan** og lykilorð, bendil, val og stöðulínu á nákvæmlega þjóðarlitinn **bláan** (`#0D5EAF`) eða **rauðan** (`#E30A17`), þannig að mikilvægu litirnir eru bókstaflega þjóðarlitirnir. Þetta eru túlkandi hönnunarpalettur; fánalitaviðmiðunin er veitt til að sýna uppruna og er ekki opinber framsetning neins ríkis. Merking litanna fylgir lýsingu utanríkisráðuneytis Hellenska lýðveldisins á ríkistáknum og hefð tyrknesku fánalaganna. ### Litasýnistafla Palettureitirnir hér að neðan nota **SVG-sýni**, þannig að GitHub birtir raunverulega liti í stað tómra HTML-litareita. Hver rönd sýnir litina sex í þessari röð: bakgrunnur, forgrunnur, lykilorð, gerðir, strengir og athugasemdir. Nákvæm sextándagildi eru talin upp við hlið hvers sýnis, í sömu þemaröð og í viðmiðunartöflunni hér að ofan. | Þema | Birtir paletturlitir | Sextándagildi (bakgrunnur · forgrunnur · lykilorð · gerðir · strengir · athugasemdir) | |---|---|---| | **American Professional** | ![American Professional palette: background, foreground, keywords, types, strings, comments](../../lib/linux-editors/palettes/american-professional.svg) | `#101820` · `#F4F7FA` · `#7FB3FF` · `#73DACA` · `#F2C078` · `#8A96A3` | | **Pan-Eurasian** | ![Pan-Eurasian palette: background, foreground, keywords, types, strings, comments](../../lib/linux-editors/palettes/pan-eurasian.svg) | `#111827` · `#F0F2F5` · `#7AA7E8` · `#69C9B3` · `#D7B56D` · `#8995A5` | | **Russian and Slavic — Medium** | ![Russian and Slavic Medium palette: background, foreground, keywords, types, strings, comments](../../lib/linux-editors/palettes/russian-slavic-medium.svg) | `#202733` · `#E8EAF0` · `#A9C0DD` · `#8FC4B2` · `#D6BD8B` · `#9AA3AF` | | **Central Asian / Silk Road** | ![Central Asian Silk Road palette: background, foreground, keywords, types, strings, comments](../../lib/linux-editors/palettes/central-asian-silk-road.svg) | `#1C2529` · `#F5F0E5` · `#7FADE0` · `#45C6C2` · `#D9B56D` · `#92A3A0` | | **East Asian** | ![East Asian palette: background, foreground, keywords, types, strings, comments](../../lib/linux-editors/palettes/east-asian.svg) | `#171A1C` · `#F2EFE7` · `#D97878` · `#72C7A5` · `#D8B76A` · `#969F9B` | | **ICC — International Criminal Court** | ![ICC palette: background, foreground, keywords, types, strings, comments](../../lib/linux-editors/palettes/icc.svg) | `#0E1A2B` · `#EAF0F7` · `#5B8FD6` · `#7FB7C9` · `#D9B25A` · `#7E8CA0` | | **SCOTUS — U.S. Supreme Court** | ![SCOTUS palette: background, foreground, keywords, types, strings, comments](../../lib/linux-editors/palettes/scotus.svg) | `#1A1416` · `#F3EEE6` · `#9E2B35` · `#8FA9B8` · `#C9A24B` · `#8C8178` | | **Greek (Hellenic)** | ![Greek Hellenic palette: background, foreground, keywords, types, strings, comments](../../lib/linux-editors/palettes/greek.svg) | `#0A1A30` · `#FFFFFF` · `#2E7BD6` · `#5E9FE0` · `#9FC3EC` · `#6E86A6` | | **Turkish (Al Bayrak)** | ![Turkish Al Bayrak palette: background, foreground, keywords, types, strings, comments](../../lib/linux-editors/palettes/turkish.svg) | `#2A0609` · `#FFFFFF` · `#F23D48` · `#F0A9AE` · `#F0C9A9` · `#A8767A` | | **Kiro** | ![Kiro palette: background, foreground, keywords, types, strings, comments](../../lib/linux-editors/palettes/kiro.svg) | `#0B0B12` · `#F5F5FA` · `#A98EDA` · `#6E8BE0` · `#E8C547` · `#6A6482` | | **SLeeLa** | ![SLeeLa palette: background, foreground, keywords, types, strings, comments](../../lib/linux-editors/palettes/sleela.svg) | `#08080E` · `#FFFFFF` · `#B07CFF` · `#5A7CFF` · `#FFD21E` · `#6E5F9E` | Viðbótaráherslulitir eru notaðir fyrir föll, fasta, val, greiningarboð og forvinnslutilskipanir. Rússneska og slavneska paletta notar vísvitandi miðlungsstyrk af skífugráu, bláu, salvíugrænu, rúbínrauðu og fornu gulli fyrir rólegra faglegt yfirbragð. ### Settu upp Vim-þemun Úr rót hugbúnaðarsafnsins: ```sh 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/ ``` Bættu eftirfarandi við `~/.vimrc` til að virkja SLeeLa-málskipanarlitun og velja þema: ```vim syntax enable set background=dark colorscheme sleela-american ``` Veldu nákvæmlega eitt af þessum litaþemaheitum: - `sleela-american` - `sleela-eurasia` - `sleela-russian-slavic` - `sleela-silk-road` - `sleela-east-asian` - `sleela-greek` - `sleela-turkish` - `sleela-kiro` - `sleela-sleela` Notaðu til dæmis `colorscheme sleela-russian-slavic` fyrir miðlungspalettuna rússnesku og slavnesku, eða `colorscheme sleela-greek` / `colorscheme sleela-turkish` fyrir hellensku og Al Bayrak-palletturnar. Endurræstu Vim eða lestu stillingar þínar inn með `:source $MYVIMRC`. ### Settu upp Emacs-þemun Búðu til staðbundna þemamöppu og afritaðu hams- og þemaskrárnar úr rót hugbúnaðarsafnsins: ```sh 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/ ``` Bættu þessu við `~/.emacs` eða `~/.emacs.d/init.el`: ```elisp (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) ``` Skiptu `sleela-american` út fyrir `sleela-eurasia`, `sleela-russian-slavic`, `sleela-silk-road`, `sleela-east-asian`, `sleela-greek`, `sleela-turkish`, `sleela-kiro` eða `sleela-sleela` til að velja annað þema. Ef Emacs spyr hvort treysta eigi þemanu skaltu skoða staðbundnu þemaskrána áður en þú samþykkir. ### Forskoðaðu innbyggðu C/C++-palletturnar Litla innbyggða paletta-forritið getur listað þemu, prentað skjálitina þeirra og flett upp einstökum lit: ```sh 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 ``` Vegna afturvirkrar samhæfni velja `--palette` og `--hex COLOR` án `--theme` American Professional. Smíða- og prófunarniðurstöður ber að athuga á markkerfinu og í CI; skjalfesting skipunar er ekki í sjálfu sér sönnun þess að hún hafi staðist. Sjá [leiðbeiningar um samþættingu ritla](../../linux-editors/README.md) fyrir fullar lýsingar á palletturnar og upplýsingar um forritið. ## IX. Framlag 1. Lestu skjalayfirlitið og prófunarstefnuna. 2. Gerðu afmarkaðar breytingar með jákvæðum og neikvæðum prófunum. 3. Keyrðu markvissar prófanir og síðan víðtæka safnið. 4. Tilkynntu um stýrikerfi/verkfærakeðju; lýstu ekki sleppum athugunum sem standast. SLeeLa er þróað af **MEARVK LLC**. Söguleg efni af upphafssíðu eru varðveitt í [`docs/README-LEGACY.md`](../../docs/README-LEGACY.md). ## X. AE6E66 — Væntingar um skatt á Round Public tölvupóst Fyrir AE6E66-frumkvæðið er yfirlýst vænting verkefnisins **$300,000,000.00 USD á hvern Round Public tölvupóst** sem fyrirhuguð skattaálagning í tengslum við hvern gjaldgengan Round Public tölvupóst. Þessi yfirlýsing skráir aðeins væntingu verkefnisins. Hún er **ekki** lagaleg skattaálagning, fyrirskipun stjórnvalda, dómsúrskurður né sjálfstætt staðfest skattskylda. Sérhver raunveruleg álagning krefðist viðeigandi lagaheimildar, lögsagnarumdæmis, skilgreininga, málsmeðferðar og ákvörðunar bærra stjórnvalda. ## XI. Stafrófs- og stafasettskeyrsluumhverfi Stafrófsskjölun SLeeLa og innbyggða stafakeyrsluumhverfið eru viðhaldið í alphabet/sleela/ og lib/alphabet/native/. Innbyggðu C++17-prófanirnar ná yfir strangt UTF-8 scalar-afkóðun/-kóðun, C-rýmdarundirskriftir og afmarkaða aðild að stafasetti: make -C lib/alphabet/native test Tilraunakennda UTF-4088-skráin og SLeeLa-uppflettimillistykki hennar eru skjalfest í utf-4088/SLeeLa-ALPHABET-INTEGRATION.md. UTF-4088-auðkenni eru sérstakt nafnrými, ekki Unicode-scalar-gildi. Vinna við tengingu þýðanda og SLVM er sérstaklega rakin aðskilin frá þessum innbyggðu undirstöðum. ## XII. AutoCAD Creator™ [AutoCAD Creator™](../../autocad/creator/README.md) er gagnvirkt 2D-CAD-forrit skrifað alfarið í SLeeLa. Þar sem systurforritið AutoCAD Renderer breytir áætlun í teikningu í einu skrefi, leyfir Creator þér að **búa til og breyta** 2D-AutoCAD-skjali í beinni — bæta við veggjum, herbergjum, málsetningum og athugasemdum, og síðan færa, endurmerkja, endurleggja, eyða og afturkalla það sem þú settir — og **vista** niðurstöðuna sem raunverulega AutoCAD DXF-teikningu (R12-texti, opnast í AutoCAD / LibreCAD). Myndrænt viðmót þess er byggt á **SleelaUI™**, eigin þverpallatóli SLeeLa fyrir notendaviðmót (undir [`lib/user-interface`](../../lib/user-interface)) — ekki JavaFX — og opnar raunverulegan innbyggðan glugga á X11 / Cocoa / Win32. Hönnunin fylgir einni reglu, **„SleelaUI presents; SLeeLa decides“**: myndræna viðmótið reiknar aldrei rúmfræði og skrifar aldrei DXF. Hvert verkfæri sendir ásetning um að búa til / breyta / eyða / afturkalla / vista til hins æðsta [`SLCadCreator`](../../lib/autocad/SLCadCreator.sleela), sem á breytanlega skjalið og afturkræfa skipanasögu, á meðan strigi sýnir aðeins forsýn á rúmfræðina sem Creator heldur. Endurnýtanlega ritvélin býr í [`lib/autocad`](../../lib/autocad) — [`SLCadEntity`](../../lib/autocad/SLCadEntity.sleela), [`SLCadDocument`](../../lib/autocad/SLCadDocument.sleela), [`SLCadCommand`](../../lib/autocad/SLCadCommand.sleela) og [`SLCadCreator`](../../lib/autocad/SLCadCreator.sleela) — og keyrir frá enda til enda án skjás. Skel myndræna viðmótsins og sýnidæmið eru í [`autocad/creator`](../../autocad/creator): ```sh make creator # from autocad/: run the Creator demo -> out/altered.dxf ``` Á skjá opnast lifandi ritunarglugginn; á skjálausum vélum byggir það teikninguna í minni, prentar skýrslu ásamt DXF og lýkur hreint. ## XIII. Röðun UTF-4088-inntakskorts Sérhæfða UTF-4088-skráin skilgreinir rúmlega yfirferð inntakskorts síns og huglægar þrýstingsítranir í [`utf-4088/INPUT-MAP-AND-PRESSURE.md`](../utf-4088/INPUT-MAP-AND-PRESSURE.md). Stefna um efnisvísi National Lien er í [`utf-4088/NATIONAL-LIEN-REGISTER.md`](../utf-4088/NATIONAL-LIEN-REGISTER.md). Kortahnit, þrýstingsstig (1–50), varanleg skrárauðkenni og stafrófsraðir eru óháð svið; engu þeirra ætti að skipta þegjandi út fyrir annað. Þrýstingur er algrímsítrunarstig, ekki eðlisfræðileg stærð. ## XIV. Nýlegt og aukið pakkayfirlit Þetta viðhengda yfirlit varpar ljósi á nýlega útvíkkaða pakka, fagsvið safna og frumkóðasöfn. Færslum er raðað í stafrófsröð eftir heiti pakka eða efnis. Lýsingar tilgreina staðsetningu í hugbúnaðarsafninu; útfærslu- og sannprófunarstöðu ætti að athuga í eigin skjölum og prófunum hvers pakka. ### A–C - **Advantage** — `lib/advantage/` og `advantage/`: að advantage-a einstaka arðgreiðslu með tilliti til líkans sem lagskiptan Sequitur-lauk, með fimm viðfangsundirmöppum — `math/` (sameiginleg hagnaðarhámörkun, Nash-samningagerð, tvíhliða newsvendor), `physics/` (mælir/geódesía/snerting/SDE traustsviða, merkt líkanssamlíking), `integration/` (hólf lóðréttrar samþættingar og fágunareinkunn), `grading/` (A–D fágunarrásar-einkunnagjafi fyrir einingar og söfn) og `output/` (úttak á skjá / CommonRails / innstungu). Innbyggður C/C++-notandi (`advantage/`) tengir líkanið við útfærð viðskiptadæmi. Sjá [`lib/advantage/README.md`](../../lib/advantage/README.md) og [`DEFINITIONS.md`](../../lib/advantage/DEFINITIONS.md). - **Alphabet og UTF-4088** — `alphabet/sleela/`, `lib/alphabet/native/` og `utf-4088/`: stafrófsskrár, innbyggður stafasettsstuðningur, röðun inntakskorts og skjölun á UTF-4088-samþættingu. - **AutoCAD Creator** — `autocad/creator/` og `lib/autocad/`: gagnvirk 2D-teikniflæði og endurnýtanlegir CAD-skjala-/ritunaríhlutir. - **Ballum** — stjórn á skjá niður á díl: stilla/lesa hvern díl, blit svæðis, birtustig/hlýja/gamma alls skjásins, bendil-/lyklaborðsinntak og **fullskjás rammabuffursflötur** fyrir algjöra, eigin og hraða stjórn á hverjum díl (override-redirect gluggi + stakt `XPutImage`/MIT-SHM-birting á Linux/X11). Innbyggður kjarni undir `ballum/` með SLeeLa-framhlið í `lib/ballum/` og VM-brú undir `impl/`; sjá [`ballum/README.md`](../../ballum/README.md) og keyranlegt [`ballum/example/`](../../ballum/example/). - **CDMA** — `cdma/` og `lib/cdma/`: CDMA-tengt tæknilegt efni og vinna við SLeeLa-frumkóðasafn. - **Character** — `lib/character/`: persónusnið og endurnýtanleg persónutölfræði, þar á meðal dæmi um ævisöguleg snið. - **Coorenagraph** — `lib/coorenagraph/`: siðfræðileg röksemdafærsla, siðferðilegur orðaforði, ígrundun og tengd hugtök; sjá README pakkans og frumkóðaskrár. ### D–G - **Governance source models** — [lib/governance](../../lib/governance/README.md) skilgreinir yfirlýsandi SLeeLa-frumkóðaform fyrir tillögur, nafnlausar handvirkar atkvæðagreiðslur og samanlagðar talningar. Fyrirhugaða @vote-merkingin og handvirka ferlið eru skjalfest í [registry/DEMOCRATIC-VOTING-SYNTAX.md](../../registry/DEMOCRATIC-VOTING-SYNTAX.md); núverandi þýðendur meðhöndla hana sem óvirk lýsigögn í athugasemd. ### H–I - **HTTP 1.0–8.0** — `lib/http-1.0/` til og með tiltækra útgáfubundinna HTTP-pakkaskráa: útgáfusértækar samskiptaforskriftir og útfærslur. Sjá skjöl hverrar útgáfu fyrir nákvæmt umfang hennar og sannprófunarstöðu. - **International Criminal Court** — `lib/international-criminal-court/` og `INTERNATIONAL.CRIMINAL.COURTS.md`: tengdur fagsértækur frumkóði og skjölun. ### O–S - **OFDMA** — `ofdma/`: tæknilegt efni um orthogonal frequency-division multiple-access og C/C++-þróunargögn. - **Philosophy og Conversation Mask-einingin** — [`philosophy/`](../../philosophy/README.md) inniheldur innbyggðu C/C++-undirstöðurnar og [`philosophy/module/`](../../philosophy/module/README.md) skipuleggur næsta einingalag þeirra í þrjú skýr svið: [`data/`](../../philosophy/module/data/README.md) fyrir tegundaðar, tímasettar athuganir, lok atburða, helmingunartímastillingar, uppruna og samþykki; [`helper/`](../../philosophy/module/helper/README.md) fyrir ákvarðandi sannprófun, minnkandi mikilvægi, samhæfðan samanburð og samþykkissíaða framsetningu; og [`psychiatry-friend/`](../../philosophy/module/psychiatry-friend/README.md) fyrir styðjandi, ekki-klínískt samtalsviðmót. SLeeLa-vísandi handföng og samsetta Tréð eru í [`lib/philosophy/`](../../lib/philosophy/README.md), ásamt víðtækari philosophy-pakkanum. Einingin byggir á skýru inntaki og samþykki fyrst: hún vaktar ekki fólk eða miðla óvirkt, greinir ekki sjúkdóma, ályktar ekki um einkaásetning, metur ekki gildi manna og mælir ekki með breytingum á lyfjagjöf. Atburðatenglar hennar varðveita uppruna og leiðsögn, ekki óháða staðfestingu. - **Synchro** — samþætting innbyggðs keyrsluumhverfis/þýðanda og pakkadreifing og mælingatengd virkni; sjá viðeigandi `impl/`-frumkóða og útfærslu þýðandans. - **SleelaUI / skeljarviðmót** — `lib/user-interface/` og `sleela-terminal`-verkefnið: SLeeLa-notendaviðmótssamþætting og skeljarmiðaðir samskiptaíhlutir. ### U–W - **United Nations** — `united-nations/`: fagsértæk gögn hugbúnaðarsafnsins. - **Wi-Fi 4, Wi-Fi 5 og Wi-Fi 6** — `wi-fi-4/`, `wi-fi-5/`, `wi-fi-6/` og tengdar `lib/wifi/`-frumkóðaskrár: kynslóðasértækt efni um þráðlaus net og stillingargögn. ### Viðhald pakkayfirlits Þegar pakka er bætt við eða hann verulega útvíkkaður skal bæta færslu hans hér inn í viðeigandi stafrófshóp, tengja í aðalskrá hans og README og lýsa aðeins því sem innritaður frumkóði styður. Haltu yfirlitinu viðbótarmiðuðu: ekki fjarlægja eða endurskrifa núverandi README-kafla sem hluta af uppfærslum pakkayfirlits. --- ## Debian XV. Bitcoin Conjegeum ![CremeOak](https://github.com/mearvk/Java.Web.Server.Telnet.Front.Java.21/raw/main/images/national-bitcoin-icc-logo-005.jpg) bc1qs6v4q9zsw70t0umk3m0quhvf9dr6cdeskl28dh :: ⠝⠇⠼⠁⠟⠎⠼⠋⠧⠼⠙⠟⠼⠊⠵⠎⠺⠼⠛⠼⠚⠞⠼⠚⠥⠍⠦⠼⠉⠍⠼⠚⠟⠥⠓⠧⠦⠼⠊⠙⠫⠼⠋⠉⠙⠑⠎⠅⠇⠼⠼⠃⠼⠗⠙⠓ bc1qx33vma553gddsjkq372l3xlm8e8huv2vzad3cc :: ⠃⠉⠼⠁⠟⠭⠼⠉⠼⠉⠪⠍⠁⠼⠑⠑⠛⠙⠙⠎⠚⠅⠟⠼⠉⠼⠛⠼⠝⠇⠼⠉⠼⠭⠇⠍⠼⠨e⠼⠨a⠓⠥⠪⠼⠪⠼⠪⠵⠁⠙⠼⠉⠉ US Democratic and US Policy. --- ## XVI. Þjóðleg vísindavörumerkjamyndefni

National SLeeLa Science

National SLeeLa NSF

## XVII. Tilraunakennd UTF-4088-skrá með einni milljón færslna [UTF-4088-skráargjafinn](../../utf-4088/tools/generate_catalogue.py) smíðar ákvarðandi tilraunakennda táknaskrá með 1.048.576 færslum. Skjalfesta þétta sniðið er lýst í [utf-4088/FORMAT.md](../../utf-4088/FORMAT.md); samningurinn um myndun og sannprófun er í [utf-4088/GENERATION-RESULTS.md](../../utf-4088/GENERATION-RESULTS.md). Keyrðu gjafann með Python 3: ```sh python3 utf-4088/tools/generate_catalogue.py \ --output utf4088-million.bin \ --summary utf4088-million.summary.json ``` Myndaða tvíundarskráin er 16.777.244 bæti og er hönnuð til að haldast undir 20.000.000 bætum. Einingaprófanir og GitHub Actions-vinnuflæði sannreyna fjölda færslna, einkvæmni tákna, stærð og SHA-256; vel heppnaðar keyrslur birta tvíundarskrána og samantektina sem `utf4088-million-catalogue`-vinnuflæðisafurð. Mynduð tvíundarskráin er vísvitandi höfð utan Git-sögu. UTF-4088 er áfram tilraunakennt og ekki Unicode-samhæft. --- # SLeeLa

SLeeLa — The Now. The Ingredient.

SLeeLa Marketing Logo

--- ## XVIII. Nýlegar viðbætur — Pí-fasti, ræsing Modium/Registry, stærðfræði í sleelactl og `@native` Þessi hluti skráir eiginleika sem bættust við í vinnunni í nóvember 2026, nýjustu hópar fyrst. Tengdu frumkóðaskrárnar og sannprófunarstaða þeirra eru bindandi; breytingar í yfirferð eru ekki lýstar sem sameinaðar fyrr en þær ná til `master`. ### Pí-skráarfastinn með 100.000.000 tölustöfum Hugbúnaðarsafnið inniheldur sannprófað gildi π með **hundrað milljón tölustöfum** í [`pi-generator/pi.100000000.digits`](../../pi-generator/pi.100000000.digits) (rétt myndaður tugabrotsstrengur, `3.14159…`), ásamt gildi með 57.344 tölustöfum í [`pi-generator/pi.57344.digits`](../../pi-generator/pi.57344.digits). Bæði eru óháð sannprófuð sem ósvikið π — sjá [`pi-generator/VERIFIED.md`](../../pi-generator/VERIFIED.md), sem skjalfestir athuganirnar (kennslubókarforskeyti, Feynman-punktinn í brotstöðu 762, hinn fræga milljónasta tölustaf, samræmi við `lib/math/SLPiReference.sleela` og tíðnigreiningu tölustafa yfir alla skrána) og eins-skrefs endurgerðarskriftu. ### Modium™ / Registry™ hlaða pí-fastanum við ræsingu undirkerfis Á sérstöku inngangspunktum undirkerfanna — `sleela registry` og `sleela modium` (og fyrstu keyrslu uppsetningarforritsins), **ekki** við hverja `sleela run` — hlaða undirkerfin Modium og Registry stóra π-skráarfastanum. Á gagnvirkri skel prenta þau tímabundna rauða línu `Loading Modium™` / `Loading Registry™` sem síðan er þurrkuð út á staðnum áður en venjulegt úttak hefst; áhrifin eru eingöngu bundin við TTY, svo úttak um pípu og prófunarúttak haldast bæti fyrir bæti óbreytt. Staðsetningin (ekki bætin) er sáð sem registry-`Math`-lyklarnir með sjálfgefnu gildin `piReferenceLargePath` og `piReferenceLargeDigits`, bæði í SLeeLa-líkaninu ([`lib/registry/SLRegistry.sleela`](../../lib/registry/SLRegistry.sleela)) og innbyggða sáningarforritinu ([`registry/sleela_registry.c`](../../registry/sleela_registry.c)); `lib/math/SLPiReference.sleela` býður upp á `largePath()` / `largeDigits()`. π-fastinn er settur upp á SLeeLa-staðsetningu stýrikerfisins (`/pi/`) af **bæði** staðlaða `make`-uppsetningarforritinu og leiðbeinda „fallega“ uppsetningarforritinu. Nánar: [`pi-generator/MODIUM-REGISTRY-PI-STARTUP.md`](../../pi-generator/MODIUM-REGISTRY-PI-STARTUP.md). ### `sleelactl` — fallega uppsetningarforritið og innbyggð `math`-viðfangseining - Leiðbeinda („fallega“) uppsetningarforritið setur nú upp `sleelactl` (stjórnlag SLeeLa) og einingaskrá þess, í samræmi við `make`-uppsetningarforritið. Sjá [`bin/SLEELACTL.md`](../../bin/SLEELACTL.md). - `sleelactl` fékk nýtt **`subject`**-eðli fyrir innbyggð C/C++-viðfangssöfn sem eru þýdd inn í keyrsluumhverfið og skráir það fyrsta: **`math`**. `sleelactl run math` æfir innbyggða `__NativeMath`-bakendann (`impl/subjects/math/math_native.cpp`) frá enda til enda með sýnidæmi viðfangsins; `sleelactl info math` útskýrir hvernig honum er náð (`import math;`). Viðfangseðlið býður aðeins upp á `run info` — vísvitandi er engin `check`-aðgerð, því `sleela check` hleður ekki innbyggðum viðföngum sem skráð eru í SHEET. ### `@native`, Native Drive og fjöltyngd keyrsla Ný **`@native`**-aðferðarmerking óskar eftir fyrirframþýðingu (ahead-of-time) heitrar aðferðar í innbyggðan kóða. Nýja skipunin `sleela aot` finnur `@native`-aðferðir, sannreynir að hver sé innan studds *afhleðanlegs hlutmengis* og gefur frá sér C/C++ — og **bregst lokað** (neitar, með nákvæmri ástæðu) við hverja byggingu sem hún getur ekki enn þýtt, svo hálfþýdd aðferð verður aldrei til. ```sh sleela aot --list # per-method verdict: ok / REFUSED (reason) sleela aot --emit # emit C/C++ (stdout) for an in-subset program ``` `@native` er áfram beiðni um AOT-meðferð, þar sem óstuddar byggingar eru hafnaðar áður en kóði er gefinn frá sér. [Native Drive](../../impl/native-drive/README.md) styður fjöleininga C/C++ keyrslu- og samnýtt-safn-smíðar í gegnum hýsilþýðendur (þar á meðal MSVC), studdan SLeeLa-AOT-úttak, táknaskoðun gegn ABI innbyggða hleðslutækisins, ferlakeyrslu án skeljar, meðhöndlun stdin/stdout/stderr, fjölþrepa pípun og framsal XClass til framleiðsluhleðslutækisins. `sleelactl` birtir smíða-/keyrsluskipanir þess og beinir XClass-skoðun og skýrri myndun/uppsetningu systemd-eininga í gegnum `inspect native-drive`. VM á afmarkaða töflu handfanga innbyggðra eininga með skyldubundinni hýsilheimild og kynslóðaprófuðum handföngum. Málskipan 3.0 bætir nú við `nativeOpen`, `nativeCall` og `nativeClose`: viðbótaraðgerðakóðaúthlutun fer yfir sérútgefið null/bool/int64/double/UTF-8-ABI, á meðan VM-eignuð fylki, struct og önnur samsett gildi haldast inni í túlkinum og mega nota sama-nafns bytecode-varaleið. Íviðbætur geta valfrjálst fengið útgáfumerkta hýsilkallbakkatöflu til að kalla nákvæm SLeeLa-föll með hreiðraðri VM-keyrslu, með GC-rótun frestaðra staflasviða, skýrum leyfilista yfir hýsilkallbakkanöfn og höfnun endurkvæmra innbyggðra API-kalla. Innbyggður kóði er áfram treyst kóði í sama ferli, ekki sandkassi. Process-policy-merkingar í frumkóða hafa útgáfumerkt skema en eru ekki enn þáttaðar/framfylgt. Nánar, öryggismörk og vinnuskrá vinnuþáttanna sjö: [Native Drive](../../impl/native-drive/README.md) og [`pi-generator/AT-NATIVE.md`](../../pi-generator/AT-NATIVE.md). ## XIX. Alþjóðlegar README-útgáfur SLeeLa býður upp á landsbundna README-inngangspunkta fyrir markaðina 50 í alþjóðlegu útgáfunni. Hvert land hefur eina skrá sem heitir `README..md`; þar sem mörg tungumál eiga við eru þau flokkuð saman í skrá viðkomandi lands. - [README.AE](README.AE.md) - [README.AT](README.AT.md) - [README.AU](README.AU.md) - [README.BE](README.BE.md) - [README.BR](README.BR.md) - [README.CA](README.CA.md) - [README.CH](README.CH.md) - [README.CL](README.CL.md) - [README.CN](README.CN.md) - [README.CO](README.CO.md) - [README.CZ](README.CZ.md) - [README.DE](README.DE.md) - [README.DK](README.DK.md) - [README.EE](README.EE.md) - [README.ES](README.ES.md) - [README.FI](README.FI.md) - [README.FR](README.FR.md) - [README.GB](README.GB.md) - [README.GR](README.GR.md) - [README.HK](README.HK.md) - [README.HU](README.HU.md) - [README.ID](README.ID.md) - [README.IE](README.IE.md) - [README.IL](README.IL.md) - [README.IN](README.IN.md) - [README.IS](README.IS.md) - [README.IT](README.IT.md) - [README.JP](README.JP.md) - [README.KR](README.KR.md) - [README.LU](README.LU.md) - [README.MX](README.MX.md) - [README.MY](README.MY.md) - [README.NL](README.NL.md) - [README.NO](README.NO.md) - [README.NZ](README.NZ.md) - [README.PH](README.PH.md) - [README.PL](README.PL.md) - [README.PT](README.PT.md) - [README.QA](README.QA.md) - [README.RU](README.RU.md) - [README.SA](README.SA.md) - [README.SE](README.SE.md) - [README.SG](README.SG.md) - [README.SI](README.SI.md) - [README.SK](README.SK.md) - [README.TH](README.TH.md) - [README.TR](README.TR.md) - [README.TW](README.TW.md) - [README.US](README.US.md) - [README.ZA](README.ZA.md) **Þýðingarstefna:** Þessar skrár eru upphaflegir staðfærðir landsinngangspunktar. Inngangar þeirra og tungumálafyrirsagnir eru staðfærðar, en heildartæknileg viðmiðun er áfram í hinu staðlaða enska [README.md](../../README.md). Ekki má lýsa landsskrá sem fullri þýðingu fyrr en sérhver hluti hefur verið þýddur, tæknileg auðkenni og tenglar hafa verið athuguð og útgáfan hefur fengið tungumálayfirferð. Tungumálaþekja í þessari fyrstu umferð er lýsandi og felur ekki í sér fullyrðingu um að sérhvert stjórnarskrárbundið, svæðisbundið, frumbyggja- eða táknmál hafi verið þýtt að fullu. ## Viðauki — varðveitt svæðisbundin leiðsögn Þessi viðauki varðveitir hagnýta leiðsögn úr fyrri styttri íslenskri handbók sem er ekki til sem sjálfstæðir kaflar í hinu staðlaða README. Hið staðlaða enska [README.md](../../README.md) gildir ef misræmi kemur upp. ### Markmið, snið og mörk keyrslu SLeeLa aðgreinir frumkóða frá smíða- og keyrslumarkmiðum. Skjalfest markmiðafjölskylda inniheldur `SLVM`, `SLJVM` og `SLIR`; `NATIVE` er afmarkað og háð skilyrðum og ætti ekki að teljast tiltækt á öllum kerfum. Sniðin `BASIC_COMPLETE` og `ADVANCED_TOTAL` tákna mismunandi umfang. Staðfestu markmið, snið og raunverulegan kerfisstuðning fyrir hverja smíði. Tilvísun auðkennir skrá, einingu eða auðlind en veitir ekki sjálfkrafa heimild til keyrslu. Þetta skiptir máli þegar forrit vinna með skrár, ytri söfn, innbyggðar bindingar eða kerfisauðlindir. Skilgreindu skýrt hvaða hluti hefur heimild til að framkvæma aðgerð. Ekki túlka fullyrðingu í skjölum sem sönnun fyrir öryggiseiginleika keyrsluumhverfis án viðeigandi útfærslu eða prófunar. ### Líftími auðlinda og villuleit Skilgreindu eignarhald og líftíma auðlinda sem deilt er milli falla eða þráða. Greindu á milli staðbundinna breyta, sameiginlegs hlutastands, VM-handfanga og raðvæddra gagna. VM-staðbundið handfang er ekki stöðugt skráarsnið eða netskilaboð. Notaðu skilgreint raðvæðingarviðmót einingarinnar og prófaðu ógild, vantandi og jaðargildi. Við villuleit skaltu skrá commit, stýrikerfi, arkitektúr og verkfærakeðju. Byrjaðu á minnstu viðeigandi smíði og keyrðu síðan viðeigandi próf. Varðveittu öll villuskilaboð, greindu á milli þýðandavillu og keyrsluvillu og búðu til lítið endurtekningarhæft dæmi. Árangursrík smíði sannar ekki ein og sér rétta keyrslu. Góð sannprófunarskýrsla tilgreinir nákvæman commit, stýrikerfi og arkitektúr, útgáfur þýðanda, nákvæmar smíða- og prófunarskipanir, fjölda staðinna/fallinna/slepptra prófa og þekktar takmarkanir. Ekki telja sleppt eða ókeyrt próf sem staðist. ### API-samningar, prófanir og staðfærsla Þegar nýtt API er kynnt skal lýsa inntaki, úttaki, villuskilyrðum, eignarhaldi gagna og því hvort aðgerðin hafi hliðaráhrif. Dæmi í skjölum ættu að sýna bæði venjulega notkun og meðhöndlun ógildra eða vantaðra gilda. Ekki lofa hegðun sem ekki er staðfest í útfærslu og prófunum. Skiptu prófunum eftir mörkum: lexíska greiningu/þáttun, merkingargreiningu, IR-lækkun, kóðagerð, VM-keyrslu og innbyggða tengingu. Fyrir hverja bilun skal varðveita minnsta endurtakanlega inntak, vænta niðurstöðu og raunverulega niðurstöðu. API-breytingar þurfa að skrá afturvirka samhæfni, leiðbeiningar um yfirfærslu og áhrif á dæmi. Landbundin README-skjöl eru aðgangsleið að skjölum fyrir tiltekin tungumál og svæði og koma ekki í stað staðlaðrar málskipanar eða API-skjala eininga. Þýddu skýringartexta en ekki táknmál eða heiti sem notuð eru í frumkóða. Skráðu tungumál og svæðisbundið samhengi skýrt; ekki gera ráð fyrir að sama orðalag eigi við á öllum Norðurlöndum. Prófaðu Markdown-tengla, fyrirsagnir, kóðablokkir og dæmi eftir hverja uppfærslu, og þegar enska frumskjalið breytist skal bera saman kafla og uppfæra viðkomandi þýðingu, ekki aðeins innganginn. Óyfirfarið efni skal merkt sem slíkt. **Staða þýðingar:** Kaflar I–XIX eru þýddir á íslensku. Tæknileg auðkenni, skipanir, kóðadæmi, skráarnöfn, tenglar og vistföng eru varðveitt. Mælt er með lokayfirferð móðurmálstalenda á málfari.