Home /Modules/docs/README.IS.md

README.IS.md

docs/i18n/README.IS.md · 766 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 — Ísland (IS)

<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>Innbyggt kerfisforritunarmál, þýðandi, keyrsluumhverfi og vistkerfi sýndarvéla.</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>

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.

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

II. Fréttir

Nýlegar viðbætur við málið, rekla og staðalsafn:

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:

make                                  # build everything from the repo root

Eða smíðaðu og prófaðu aðeins innbyggða kjarnann:

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:

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ð:

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: þ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 og Registry 3.0-arkitektúr.

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:

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ð:

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.

V. Mál og keyrsluumhverfi

Opinbera málskipanin er 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

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:

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, öryggisgátlistann og smíðaflæði vírusvarnar.

Ú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

ÞemaBakgrunnurForgrunnurLykilorðGerðirStrengirAthugasemdir
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

Þ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óðLiturHexGrunnur og merking
GrikklandBlár<span style="display:inline-block;width:1em;height:1em;background:#0D5EAF;border:1px solid #888"></span> #0D5EAFBlár litur þjóðfánans (lög 851/1978). Himinninn og höfin; í skjaldarmerkjafræði nefndur azure.
GrikklandHvítur<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFHvítur litur þjóðfánans. Hreinleiki sjálfstæðisbaráttunnar; krossinn táknar grísk-rétttrúnaðarkristni.
TürkiyeRauður (al bayrak)<span style="display:inline-block;width:1em;height:1em;background:#E30A17;border:1px solid #888"></span> #E30A17Rauður litur þjóðfánans (tyrknesku fánalögin). Flöturinn; samkvæmt hefð blóð píslarvotta og fullveldi Ottómana.
TürkiyeHvítur<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFHví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.

ÞemaBirtir paletturlitirSextándagildi (bakgrunnur · forgrunnur · lykilorð · gerðir · strengir · athugasemdir)
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

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:

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:

syntax enable
set background=dark
colorscheme sleela-american

Veldu nákvæmlega eitt af þessum litaþemaheitum:

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:

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:

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

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 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.

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<n>-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™ 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) — 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, 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 — SLCadEntity, SLCadDocument, SLCadCommand og SLCadCreator — og keyrir frá enda til enda án skjás. Skel myndræna viðmótsins og sýnidæmið eru í autocad/creator:

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. Stefna um efnisvísi National Lien er í 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

D–G

H–I

O–S

U–W

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.


<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. Þjóðleg vísindavörumerkjamyndefni

<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. Tilraunakennd UTF-4088-skrá með einni milljón færslna

UTF-4088-skráargjafinn smíðar ákvarðandi tilraunakennda táknaskrá með 1.048.576 færslum. Skjalfesta þétta sniðið er lýst í utf-4088/FORMAT.md; samningurinn um myndun og sannprófun er í utf-4088/GENERATION-RESULTS.md.

Keyrðu gjafann með Python 3:

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

<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. 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 (rétt myndaður tugabrotsstrengur, 3.14159…), ásamt gildi með 57.344 tölustöfum í pi-generator/pi.57344.digits. Bæði eru óháð sannprófuð sem ósvikið π — sjá 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) og innbyggða sáningarforritinu (registry/sleela_registry.c); lib/math/SLPiReference.sleela býður upp á largePath() / largeDigits(). π-fastinn er settur upp á SLeeLa-staðsetningu stýrikerfisins (<data>/pi/) af bæði staðlaða make-uppsetningarforritinu og leiðbeinda „fallega“ uppsetningarforritinu. Nánar: pi-generator/MODIUM-REGISTRY-PI-STARTUP.md.

sleelactl — fallega uppsetningarforritið og innbyggð math-viðfangseining

@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.

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 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 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 og 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.<CC>.md; þar sem mörg tungumál eiga við eru þau flokkuð saman í skrá viðkomandi lands.

Þýð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. 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 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.