Home /Modules/docs/README.EE.md

README.EE.md

docs/i18n/README.EE.md · 754 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 — Eesti (EE)

<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>Natiivne süsteemide programmeerimiskeel, kompilaator, käituskeskkond ja virtuaalmasinate ökosüsteem.</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>

Rahvusvaheline riigiväljaanne. See väljaanne on eesti keeles. Tehnilised identifikaatorid, käsud, koodinäited, failinimed, failiteed ja lingid on samad mis ingliskeelses normatiivses README.md-s.

The Now. The Ingredient. Keel on enamat kui süntaks: see on kompilaator, käituskeskkond, teegid, tööriistad ja platvormilepingud, mis muudavad tarkvara kasutatavaks.

Millega SLeeLa tegeleb. SLeeLa tegeleb valdkondadega Math, Object, Science ja Reach — tema töö neli palet: arvutatav (Math), kindlaks tehtud asi, mis seisab olevate asjade kataloogis (Object), tõe distsiplineeritud uurimine (Science) ning süsteemi käe sirutamine teiste süsteemide ja inimeste poole (Reach). Riiklikud huvid jäävad püsima — ükski neist neljast ei jäta neid kõrvale; kui teema puudutab riigi huve, siis see seisund säilitatakse (kirjendatakse ustavalt, nt iga klassi Metadata väljades metaOrigin / metaNationalSchedule) ega lahustu kunagi.

I. Alustamine

II. Uudised

Hiljutised täiendused keelele, draiveritele ja standardteegile:

III. Ehitamine ja testimine

Eeltingimused: C/C++ tööriistaahel (GCC või Clang) ja GNU Make; Python 3 manifesti-/voogude tööriistade jaoks; Linuxis X11/Xrandr arenduspaketid ekraanitoodete jaoks (mooduli make deps teatab/paigaldab vajaliku). Kataloogi impl/ ehitus on usaldatud SHA-256 manifesti suhtes tõrkesuletud (fail-closed) ning juurkataloogi Makefile viitab sellele automaatselt.

Puhtast väljavõtust kiireim algus:

make                                  # build everything from the repo root

Või ehita ja testi ainult natiivset tuuma:

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

Hoidla juurkataloogi make ehitab iga toote (tuum, VM, koodekid, churn, viirusetõrje, …) ja lõpetab registri ehitamise ning selle baastabeli materialiseerimisega — nii sisaldab ehitatud puu valmis läbivaadatavat registrit. Olulisemad sihid:

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

Muud kasulikud sihid:

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

Siht registry käivitab skripti build-registry.sh: see ehitab registri tuuma, külvab baastabeli teisaldatavasse tekstisalve registry/build/sleela.sleelareg ning ekspordib MySQL tabeliskripti registry/build/registry.sql (käsuga sleela registry export). Vaata see üle käsuga sleela registry või registry/build/sleela-registry review. Vaata registri juhendit ja Registry 3.0 arhitektuuri.

Eeltingimuste ja platvormispetsiifiliste sammude jaoks vaata ehitus- ja testimisjuhendeid. Ühe komponendi edukas ehitus ei tõenda, et kõik teegid või platvormid on väljalaskeks valmis.

IV. Paigaldamine

Pärast natiivsete toodete ehitamist paigalda käsud ja käituskeskkonna tugifailid:

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

Tavaline paigaldaja kasutab vaikimisi katalooge /usr/local/bin, /usr/local/lib/sleela ja /usr/local/share/sleela. See säilitab olemasoleva käivituskonfiguratsiooni ning keeldub kirjutamast üle jälgimata olemasolevaid käske. Eemaldamine kustutab ainult paigaldaja registreeritud failid, säilitades konfiguratsiooni ja jälgimata käitusandmed.

Ainult põhipaketi sihipäraseks, juhendatud paigalduseks — binaarfailid sleela, sleelvac ja nordshrift, standardteek, protokollid ja tugimoodulid — kasuta puhast paigaldajat:

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

See teeb ühe peamise otsuse (paigalda põhipakett), seejärel ulatuse valiku ning edu korral valikulise valija kureeritud täiendusmoodulite jaoks. Interaktiivse paigalduse töövoo ja kõigi paigaldusvalikute kohta vaata kiiret ja turvalist paigaldust.

V. Keel ja käituskeskkond

Autoriteetne grammatika on SLEELA.syntax. Praegune hoidla dokumenteerib süntaksit 3.0; kompilaatori/tööriista versioon ja lähtekoodi süntaksiversioon on erinevad. Versioon 3.0 lisab dokumendimarkerid pure ja gasoline (§30) — paar paljaid, kontekstuaalseid, ainult deklaratiivseid Preoneme, mis tähendavad peaaegu sama, kumbki tähistab dokumendi seisundit oma ausameelsusega. Süntaks 3.0 koondab keelepinna 1.0–2.9 praeguseks normatiivseks väljaandeks, säilitades kõik funktsioonipõhised minimaalsed lävendid. Eelmine pind 2.9 lisab @mix järgnevad väljad (§28) — klass võib deklareerida mitu sama nimega eksemplarivälja, kui igaüks kannab @mix, mõistetuna ühe indekseeritud rühmana (ülalt alla 1,2,3,… või käsitsi @mix(1,2,3,...), mille indeksite arv peab vastama rühmale). See kannab edasi kahendsüsteemi märgiga/märgita laiad täisarvuperekonnad int32..int16777216 (§24) ja uint32..uint16777216 (§25) varasemate long/int64/int128 (§21) kohal; märksõnatoe dokumendid (§22); ning Preonemid — ainult deklaratiivsed dokumendimarkerid author/authorial (§18), material/memory (§19–§20), determine (§23), object/field (§26), pure/gasoline (§30) ja artifact (§35, seadusandliku taseme seisund, astmestatud aja ja ruumi järgi), mida ühiselt kutsutakse Preonemideks (§26.1). Konstruktori ülelaadimise lahendamine ning this(...)/baaskonstruktori delegeerimine jäävad selgesõnaliselt kontrollitud süntaksi 1.8 lepingust välja. Enne funktsioonile toetumist vaata grammatikat ja teostusmärkmeid. SleelaDoc'i üheksa lähtekoodiüksust deklareerivad nüüd #sleela 3.0; jagatud kompilaatori värav aktsepteerib lähtesüntaksit 1.0–3.0. Uus API ehitus luuakse käsuga make api-docs.

Hoidla sisaldab natiivset C/C++ teostust, SLVM-i genereerimise viiteid, standardteegi mooduleid, teste, näiteid ja platvormiintegratsioone. Teostuse ja valideerimise olek varieerub mooduliti; ühtlase täielikkuse eeldamise asemel vaata mooduli spetsifikatsiooni ja praeguseid CI tulemusi.

VI. Inseneripõhimõtted

VII. Viirusetõrje ehitus ja terviklus

Viirusetõrjepakett Sleelavirin sisaldab natiivset SHA-256 skannerit, valikulist ClamAV adapterit, lähtekoodi-/indeksi tervikluse manifeste ja platvormipakettide kontrollsummasid. Ehita ja testi paketti hoidla juurkataloogist:

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

Tervikluse manifest luuakse kataloogi antivirus/build/; see hõlmab jälgitavaid lähtekoodi- ja dokumentatsioonisisendeid ning kaitstud allkirjaindeksi faile, jättes välja genereeritud väljundi ja muutuva ClamAV vahemälu. ClamAV andmebaasi hetktõmmistel on omad manifestid. Väljalaske ZIP-id sisaldavad INTEGRITY-MANIFEST.json, SHA256SUMS ja .sha256 kõrvalfaili. Kontrolli allalaaditud arhiivide räsisid sõltumatult hangitud usaldatava väärtuse vastu: arhiivi kõrval hoitav kontrollsumma ei ole avaldaja allkiri. Vaata Sleelavirini juhendit, turvakontrollnimekirja ja viirusetõrje ehitustöövoogu.

Väljalaset ei loeta kontrollituks enne, kui asjakohased CI ülesanded on läbitud täpsel väljalaske commit'il ja saadud artefaktid on üle vaadatud.

VIII. SLeeLa redaktoriteemad — Vim ja Emacs

SLeeLa sisaldab kooskõlastatud professionaalsete tumedate värviskeemide komplekti Vimile ja Emacsile ning natiivset C/C++ paletitööriista. Algne American Professional skeem jääb vaikimisi valituks. Kümme kaaspaletti on saadaval erinevate kultuuriliste ja institutsionaalsete disaini-inspiratsioonide jaoks; need on tõlgendavad disainipaletid, mitte ühegi rahva, kultuuri, kohtu ega institutsiooni ametlikud esitused.

Üksteist skeemi ja nende värvid

SkeemTaustEsiplaanMärksõnadTüübidStringidKommentaarid
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

Rahvuslipu värvid (lähtepalett)

Kreeka ja Türgi skeemid on tuletatud kahe riigi ametlikest rahvuslipu värvidest, mis on siin esitatud nende täpsete avaldatud hex-väärtustega. Ülaltoodud skeemide taustad/rõhuvärvid on nende lähtevärvide tumendatud, redaktorisõbralikud tõlgendused — allolev tabel on „rahvuslikult esitatud värvide" viide.

RiikVärvHexAlus ja tähendus
KreekaSinine<span style="display:inline-block;width:1em;height:1em;background:#0D5EAF;border:1px solid #888"></span> #0D5EAFRahvuslipu sinine (seadus 851/1978). Taevas ja mered; heraldiliselt blasoneeritud kui azure.
KreekaValge<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFRahvuslipu valge. Iseseisvusvõitluse puhtus; rist tähistab idapoolset õigeusku.
TürkiyePunane (al bayrak)<span style="display:inline-block;width:1em;height:1em;background:#E30A17;border:1px solid #888"></span> #E30A17Rahvuslipu punane (Türgi lipuseadus). Lipuväli; traditsiooni järgi märtrite veri ja Osmani suveräänsus.
TürkiyeValge<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFRahvuslipu valge. Poolkuu ja täht — rahu, puhtus ning türgi/islami pärandi sümbol.

Skeemid ankurdavad iga redaktori esiplaani rahvuslikule valgele ning selle märksõnad, kursori, valiku ja olekuriba täpsele rahvuslikule sinisele (#0D5EAF) või punasele (#E30A17), nii et olulised värvid on sõna otseses mõttes rahvuslikud värvid. Need on tõlgendavad disainipaletid; lipuvärvide viide on esitatud päritolu tõendamiseks ega ole kummagi riigi ametlik esitus. Värvide tähendused järgivad Kreeka Vabariigi välisministeeriumi riigisümbolite kirjeldust ja Türgi lipuseaduse traditsiooni.

Värviproovide tabel

Allolevad paletirakud kasutavad SVG proove, nii et GitHub renderdab tegelikud värvid, mitte tühje HTML-värvirakke. Iga riba näitab kuut värvi selles järjekorras: taust, esiplaan, märksõnad, tüübid, stringid ja kommentaarid. Täpsed hex-koodid on loetletud iga proovi kõrval, samas skeemide järjekorras nagu ülaltoodud viitetabelis.

SkeemRenderdatud paletivärvidHex-koodid (taust · esiplaan · märksõnad · tüübid · stringid · kommentaarid)
American ProfessionalAmerican Professional palett: taust, esiplaan, märksõnad, tüübid, stringid, kommentaarid#101820 · #F4F7FA · #7FB3FF · #73DACA · #F2C078 · #8A96A3
Pan-EurasianPan-Eurasian palett: taust, esiplaan, märksõnad, tüübid, stringid, kommentaarid#111827 · #F0F2F5 · #7AA7E8 · #69C9B3 · #D7B56D · #8995A5
Russian and Slavic — MediumRussian and Slavic Medium palett: taust, esiplaan, märksõnad, tüübid, stringid, kommentaarid#202733 · #E8EAF0 · #A9C0DD · #8FC4B2 · #D6BD8B · #9AA3AF
Central Asian / Silk RoadCentral Asian Silk Road palett: taust, esiplaan, märksõnad, tüübid, stringid, kommentaarid#1C2529 · #F5F0E5 · #7FADE0 · #45C6C2 · #D9B56D · #92A3A0
East AsianEast Asian palett: taust, esiplaan, märksõnad, tüübid, stringid, kommentaarid#171A1C · #F2EFE7 · #D97878 · #72C7A5 · #D8B76A · #969F9B
ICC — International Criminal CourtICC palett: taust, esiplaan, märksõnad, tüübid, stringid, kommentaarid#0E1A2B · #EAF0F7 · #5B8FD6 · #7FB7C9 · #D9B25A · #7E8CA0
SCOTUS — U.S. Supreme CourtSCOTUS palett: taust, esiplaan, märksõnad, tüübid, stringid, kommentaarid#1A1416 · #F3EEE6 · #9E2B35 · #8FA9B8 · #C9A24B · #8C8178
Greek (Hellenic)Greek Hellenic palett: taust, esiplaan, märksõnad, tüübid, stringid, kommentaarid#0A1A30 · #FFFFFF · #2E7BD6 · #5E9FE0 · #9FC3EC · #6E86A6
Turkish (Al Bayrak)Turkish Al Bayrak palett: taust, esiplaan, märksõnad, tüübid, stringid, kommentaarid#2A0609 · #FFFFFF · #F23D48 · #F0A9AE · #F0C9A9 · #A8767A
KiroKiro palett: taust, esiplaan, märksõnad, tüübid, stringid, kommentaarid#0B0B12 · #F5F5FA · #A98EDA · #6E8BE0 · #E8C547 · #6A6482
SLeeLaSLeeLa palett: taust, esiplaan, märksõnad, tüübid, stringid, kommentaarid#08080E · #FFFFFF · #B07CFF · #5A7CFF · #FFD21E · #6E5F9E

Funktsioonide, konstantide, valikute, diagnostika ja eeltöötlusdirektiivide jaoks kasutatakse täiendavaid rõhuvärve. Vene ja slaavi palett kasutab tahtlikult keskmise intensiivsusega kiltkivi-, sinist, salvei-, rubiin- ja antiikkuldset tooni rahulikuma professionaalse ilme jaoks.

Vim-i skeemide paigaldamine

Hoidla juurkataloogist:

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/

Lisa faili ~/.vimrc järgmine, et lubada SLeeLa süntaksi esiletõstmine ja valida skeem:

syntax enable
set background=dark
colorscheme sleela-american

Vali täpselt üks neist värviskeemi nimedest:

Näiteks kasuta keskmise Vene ja slaavi paleti jaoks colorscheme sleela-russian-slavic või Hellenic ja Al Bayrak paletite jaoks colorscheme sleela-greek / colorscheme sleela-turkish. Taaskäivita Vim või laadi oma konfiguratsioon käsuga :source $MYVIMRC.

Emacsi skeemide paigaldamine

Loo kohalik teemakataloog ja kopeeri režiimi- ja teemafailid hoidla juurkataloogist:

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/

Lisa see faili ~/.emacs või ~/.emacs.d/init.el:

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

Teise skeemi valimiseks asenda sleela-american nimega sleela-eurasia, sleela-russian-slavic, sleela-silk-road, sleela-east-asian, sleela-greek, sleela-turkish, sleela-kiro või sleela-sleela. Kui Emacs küsib, kas teemat usaldada, uuri kohalikku teemafaili enne nõustumist.

Natiivsete C/C++ paletite eelvaade

Väike natiivne paletitööriist oskab loetleda skeeme, printida nende terminalivärve ja otsida üksikut värvi:

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

Tagasiühilduvuse huvides valivad --palette ja --hex COLOR ilma --theme-ta American Professional'i. Ehituse ja testide tulemusi tuleb kontrollida sihtsüsteemis ja CI-s; käsu dokumenteerimine ei ole iseenesest tõend, et see läbis.

Paletikirjelduste ja tööriista üksikasjade kohta vaata redaktorite integratsioonijuhendit.

IX. Kaastöö

  1. Loe dokumentatsiooni registrit ja testimispoliitikat.
  2. Tee piiritletud muudatusi positiivsete ja negatiivsete testidega.
  3. Käivita sihitud testid, seejärel lai komplekt.
  4. Märgi OS-i/tööriistaahela üksikasjad; ära kirjelda vahele jäetud kontrolle läbituna.

SLeeLat arendab MEARVK LLC. Ajaloolised avalehe materjalid on säilitatud failis docs/README-LEGACY.md.

X. AE6E66 — Round Public e-kirja maksukohustuse ootus

AE6E66 algatuse puhul on projekti väljendatud ootus $300,000,000.00 USD ühe Round Public e-kirja kohta kui kavandatav maksukohustuse summa, mis on seotud iga nõuetele vastava Round Public e-kirjaga.

See avaldus kirjendab ainult projekti ootust. See ei ole õiguslik maksuhindamine, valitsuse korraldus, kohtuotsus ega sõltumatult kindlaks tehtud maksukohustus. Mis tahes tegelik maksukohustus eeldaks asjaomast õiguslikku volitust, jurisdiktsiooni, määratlusi, menetlust ja pädevat valitsuse otsust.

XI. Tähestiku ja märgistiku käituskeskkond

SLeeLa tähestiku dokumentatsiooni ja natiivset märgikäituskeskkonda hoitakse kataloogides alphabet/sleela/ ja lib/alphabet/native/. Natiivsed C++17 testid katavad range UTF-8 skalaaride dekodeerimise/kodeerimise, C<n> mahuallkirjad ja piiratud märgistiku kuulumise:

make -C lib/alphabet/native test

Eksperimentaalne UTF-4088 kataloog ja selle SLeeLa otsinguadapter on dokumenteeritud failis utf-4088/SLeeLa-ALPHABET-INTEGRATION.md. UTF-4088 ID-d on eraldi nimeruum, mitte Unicode'i skalaarväärtused. Kompilaatori ja SLVM-i sidumistööd jälgitakse nendest natiivsetest alustest selgesõnaliselt eraldi.

XII. AutoCAD Creator™

AutoCAD Creator™ on interaktiivne 2D CAD rakendus, mis on kirjutatud täielikult SLeeLa-s. Kui sõsarrakendus AutoCAD Renderer muudab plaani joonisekski ühe hoobiga, siis Creator võimaldab luua ja muuta 2D AutoCAD dokumenti reaalajas — lisada seinu, ruume, mõõte ja märkusi, seejärel liigutada, ümber nimetada, kihti vahetada, kustutada ja tagasi võtta, mis oled paigutanud — ning salvestada tulemus päris AutoCAD DXF-joonisena (R12 tekst, avaneb AutoCAD-is / LibreCAD-is).

Selle graafiline liides on ehitatud SleelaUI™ peale, SLeeLa enda platvormideülesele UI tööriistakomplektile (kataloogis lib/user-interface) — mitte JavaFX peale — ning avab päris natiivse akna X11 / Cocoa / Win32 all. Kavand järgib ühte reeglit, „SleelaUI presents; SLeeLa decides": GUI ei arvuta kunagi geomeetriat ega kirjuta DXF-i. Iga tööriist esitab loomise / muutmise / kustutamise / tagasivõtmise / salvestamise kavatsuse autoriteetsele SLCadCreator-ile, mis omab muudetavat dokumenti ja pööratavat käsuajalugu, samal ajal kui lõuend ainult eelvaatab Creatori hoitavat geomeetriat.

Taaskasutatav redigeerimismootor asub kataloogis lib/autocad — SLCadEntity, SLCadDocument, SLCadCommand ja SLCadCreator — ning töötab otsast lõpuni ekraanita. GUI kest ja demo asuvad kataloogis autocad/creator:

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

Ekraaniga masinas avab see reaalajas redigeerimisakna; ekraanita hostis ehitab see joonise mällu, prindib aruande ja DXF-i ning lõpetab puhtalt.

XIII. UTF-4088 sisendkaardi järjestus

Spetsialiseeritud UTF-4088 kataloog määratleb oma ruumilise sisendkaardi läbimise ja abstraktsed rõhu iteratsioonid failis utf-4088/INPUT-MAP-AND-PRESSURE.md. National Lien'i teemaindeksi poliitika on failis utf-4088/NATIONAL-LIEN-REGISTER.md. Kaardikoordinaadid, rõhutasemed (1–50), püsivad kataloogi ID-d ja tähestikulised järgud on sõltumatud väljad; ühtegi neist ei tohi vaikselt teisega asendada. Rõhk on algoritmiline iteratsioonitase, mitte füüsikaline suurus.

XIV. Hiljutiste ja laiendatud pakettide register

See lisatud register toob esile hiljuti laiendatud pakette, valdkonnateeke ja lähtekogumeid. Kirjed on rühmitatud tähestikuliselt paketi nime või teema järgi. Kirjeldused näitavad hoidlas asukohta; teostuse ja valideerimise olekut tuleb kontrollida iga paketi enda dokumentatsioonist ja testidest.

A–C

D–G

H–I

O–S

U–W

Paketiregistri hooldus

Kui pakett lisatakse või seda oluliselt laiendatakse, lisa selle kirje siia sobivasse tähestikulisse rühma, lingi selle kanoonilisele kataloogile ja README-le ning kirjelda ainult sisseviidud lähtekoodi toetatavaid võimalusi. Hoia see register täiendavana: ära eemalda ega kirjuta ümber olemasolevaid README jaotisi paketiregistri uuenduste osana.


<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⠓⠥⠪⠼⠪⠼⠪⠵⠁⠙⠼⠉⠉

USA demokraatlik ja USA poliitika.


XVI. Rahvuslik teaduse bränditunnuspilt

<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 miljoni kirjega eksperimentaalne kataloog

UTF-4088 kataloogigeneraator ehitab deterministlikult 1 048 576 kirjega eksperimentaalse sümbolikataloogi. Dokumenteeritud kompaktvorming on kirjeldatud failis utf-4088/FORMAT.md; genereerimise ja valideerimise leping on failis utf-4088/GENERATION-RESULTS.md.

Käivita generaator Python 3-ga:

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

Genereeritud binaarfail on 16 777 244 baiti ja on kavandatud jääma alla 20 000 000 baidi. Ühiktestid ja GitHub Actions töövoog kontrollivad kirjete arvu, glüüfide unikaalsust, suurust ja SHA-256; edukad jooksud avaldavad binaarfaili ja kokkuvõtte töövoo artefaktina utf4088-million-catalogue. Genereeritud binaarfail hoitakse tahtlikult Git'i ajaloost väljas. UTF-4088 jääb eksperimentaalseks ega ole Unicode'iga ühilduv.


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. Hiljutised täiendused — Pi konstant, Modium/Registry käivitus, sleelactl Math ja @native

See jaotis kirjendab 2026-11 töö käigus lisatud funktsioone, uusimad rühmad eespool. Lingitud lähtefailid ja nende valideerimisolek on autoriteetsed; läbivaatuse all olevaid muudatusi ei kirjeldata ühendatuna enne, kui need jõuavad harusse master.

100 000 000-kohaline Pi kataloogikonstant

Hoidla sisaldab kontrollitud saja miljoni numbriga π väärtust failis pi-generator/pi.100000000.digits (korrektne kümnendarv, 3.14159…) ning 57 344-kohalist väärtust pi-generator/pi.57344.digits. Mõlemad on sõltumatult kontrollitud tõelise π-na — vaata pi-generator/VERIFIED.md, mis dokumenteerib kontrollid (õpikuprefiks, Feynmani punkt murdkoha positsioonil 762, kuulus miljones number, kokkulangevus failiga lib/math/SLPiReference.sleela ning kogu faili numbrisageduse analüüs) ja ühekordse taasesitamise skripti.

Modium™ / Registry™ laadivad Pi konstandi delsüsteemi käivitusel

Spetsiaalsetes delsüsteemi sisenemispunktides — sleela registry ja sleela modium (ning paigaldaja esimene käivitus), mitte igal sleela run korral — laadivad Modium ja Registry delsüsteemid suure π kataloogikonstandi. Interaktiivses terminalis prindivad nad mööduva punase rea Loading Modium™ / Loading Registry™, mis kustutatakse kohapeal enne tavalise väljundi algust; efekt on rangelt TTY-piiratud, nii et torustatud ja testväljund jäävad bait-baidi haaval muutmata. Asukoht (mitte baidid) külvatakse registri Math võtme vaikeväärtustena piReferenceLargePath ja piReferenceLargeDigits, nii SLeeLa mudelis (lib/registry/SLRegistry.sleela) kui ka natiivses külvajas (registry/sleela_registry.c); lib/math/SLPiReference.sleela pakub largePath() / largeDigits(). π konstant paigaldatakse OS-i SLeeLa asukohta (<data>/pi/) nii tavalise make paigaldaja kui ka juhendatud „ilusa" paigaldaja poolt. Üksikasjad: pi-generator/MODIUM-REGISTRY-PI-STARTUP.md.

sleelactl — ilus paigaldaja ja natiivse toega math subject

@native, Native Drive ja mitmekeelne täitmine

Uus @native meetodiannotatsioon taotleb kuuma meetodi eel-kompileerimist natiivkoodiks (ahead-of-time). Uus käsk sleela aot leiab @native meetodid, kontrollib, et iga neist jääb toetatud kõrvalepandava alamhulga sisse, ning väljastab C/C++ — tõrkesuletult (keeldudes täpse põhjusega) mis tahes konstruktsiooni korral, mida ta veel tõlkida ei suuda, nii et pooltõlgitud meetodit ei looda kunagi.

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

@native jääb AOT-töötluse taotluseks, toetamata konstruktsioonid lükatakse tagasi enne väljastamist. Native Drive toetab mitme üksusega C/C++ käivitatavate ja jagatud teekide ehitusi hostkompilaatorite kaudu (sealhulgas MSVC), toetatud SLeeLa AOT väljundit, sümbolite kontrolli natiivlaaduri ABI suhtes, kestavaba protsessi käivitust, stdin/stdout/stderr käsitlust, mitmeastmelist torustamist ning XClass'i delegeerimist tootmislaadurile. sleelactl pakub selle ehitus-/käivituskäske ning suunab XClass'i kontrolli ja selgesõnalise systemd üksuse renderdamise/paigalduse käsu inspect native-drive kaudu. VM omab piiratud natiivmoodulite käepidemetabelit kohustusliku hostiloa ja põlvkonnakontrollitud käepidemetega. Süntaks 3.0 lisab nüüd nativeOpen, nativeCall ja nativeClose: lisatav-ainult baitkoodi dispetšer ületab eraldi versioonitud null/bool/int64/double/UTF-8 ABI, samas kui VM-i omatud massiivid, struktuurid ja muud liitväärtused jäävad interpretaatorisse ning võivad kasutada sama nimega baitkoodi varuvarianti. Pluginad võivad valikuliselt saada versioonitud hosti tagasikutsetabeli, et kutsuda täpseid SLeeLa funktsioone pesastatud VM-täituse kaudu, peatatud virna GC juurimisega, selgesõnalise hosti tagasikutsenimede lubatud loendiga ning rekursiivsed natiivsed API kutsed lükatakse tagasi. Natiivkood jääb usaldatud protsessisiseseks koodiks, mitte liivakastiks. Lähtekoodi protsessipoliitika annotatsioonidel on versioonitud skeem, kuid neid ei parsita ega jõustata veel. Üksikasjad, turvapiirid ja seitsme tööjoone register: Native Drive ja pi-generator/AT-NATIVE.md.

XIX. Rahvusvahelised README väljaanded

SLeeLa pakub riigipõhiseid README sisenemispunkte oma rahvusvahelise väljaande 50 turu jaoks. Igal riigil on üks fail nimega README.<CC>.md; kus on asjakohased mitu keelt, on need rühmitatud selle riigi faili sees.

Tõlkepoliitika: Need failid on esialgsed lokaliseeritud riigipõhised sisenemispunktid. Nende sissejuhatused ja keelepealkirjad on lokaliseeritud, samal ajal kui täielik tehniline viide jääb ingliskeelsesse normatiivsesse README.md-sse. Riigifaili ei tohi kirjeldada täieliku tõlkena enne, kui iga jaotis on tõlgitud, tehnilised identifikaatorid ja lingid on kontrollitud ning väljaanne on läbinud keeleülevaatuse. Keelekate selles esimeses läbimises on esindav ega ole väide, et iga põhiseaduslikult tunnustatud, piirkondlik, põlisrahvaste või viipekeel oleks täielikult tõlgitud.

Lisa — säilitatud piirkondlik juhendmaterjal

Allpool on säilitatud eestikeelse lühijuhendi praktiline sisu, mida normatiivses README-s eraldi jaotisena ei ole. See täiendab jaotisi I–XIX ega asenda neid; vastuolu korral on autoriteetne ingliskeelne README.md.

Sihid, profiilid ja käivitamise piirid

SLeeLa eristab lähtekoodi ehituse ja käivituse sihtidest. Dokumenteeritud sihtide hulka kuuluvad SLVM, SLJVM ja SLIR; NATIVE on piiratud ja tingimuslik siht ning seda ei tohi eeldada kõigil platvormidel kättesaadavaks. Profiilid BASIC_COMPLETE ja ADVANCED_TOTAL tähistavad erinevat ulatust. Kontrolli iga ehituse tegelikku sihti, profiili ja platvormituge.

Viide tuvastab faili, mooduli või ressursi, kuid ei anna iseenesest õigust seda käivitada. Failide, väliste teekide, natiivsete sidumisliideste (native bindings) või süsteemiressursside kasutamisel tuleb selgelt määrata volituste piirid ja käivitamise eest vastutav komponent. Dokumentatsioonikirjeldus üksi ei tõenda käituskeskkonna turvagarantiid; kontrolli teostust ja asjakohaseid teste.

Ressursi elutsükkel ja silumine

Dokumenteeri funktsioonide või lõimede vahel jagatud ressursside omanik, eluiga ja sünkroonimise vastutus. Erista lokaalseid muutujaid, jagatud objekti olekut, VM-i käepidemeid ja serialiseeritavaid andmeid. VM-lokaalne käepide ei ole stabiilne failivorming ega võrgusõnum. Kasuta mooduli määratletud serialiseerimisliidest ning testi vigaseid, puuduvaid ja piirväärtusi.

Silumisel märgi commit, OS, arhitektuur ja tööriistaahel. Ehita esmalt väikseim asjakohane siht, säilita täielik veaväljund, erista kompilaatori vead ja käituse vead ning koosta minimaalne korratav näide. Edukas ehitus ei tõenda iseenesest käitumise õigsust käitusajal.

Valideerimisaruandes esita täpne commit, OS/arhitektuur, kompilaatori versioonid, täielikud ehitus- ja testikäsud, läbitud/ebaõnnestunud/vahele jäetud testide arvud ja teadaolevad piirangud. Vahele jäetud või käivitamata teste ei tohi lugeda läbituks.

Märkused viidete ja aadresside kohta

Teemade Character, Governance, Synchro, SleelaUI ja United Nations viited kirjeldavad hoidla sisu ega tähenda valitsuse või institutsiooni ametlikku heakskiitu.

Jaotise Bitcoin Conjegeum (XV) aadresside või piltide olemasolu ei ole finantssoovitus, omandiõiguse kinnitus ega juhis raha ülekandmiseks. Kontrolli andmeid enne kasutamist sõltumatult.

Tõlke olek: Jaotised I–XIX on tõlgitud eesti keelde. Tehnilised identifikaatorid, käsud, koodinäited, failinimed, failiteed, lingid ja aadressid on säilitatud. Soovitatav on emakeelsete kõnelejate lõplik keeleline ülevaatus.