Home /Modules/docs/README.FI.md

README.FI.md

docs/i18n/README.FI.md · 774 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 — Suomi (FI)

<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>Natiivi järjestelmäkieli, kääntäjä, suoritusympäristö ja virtuaalikoneiden ekosysteemi.</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>

Kansainvälinen maaeditio. Tämä editio on suomeksi. Tekniset tunnisteet, komennot, koodiesimerkit, tiedostonimet, polut ja linkit ovat muuttumattomia kanoniseen englanninkieliseen tiedostoon README.md verrattuna.

The Now. The Ingredient. Kieli on enemmän kuin syntaksi: se on kääntäjä, suoritusympäristö, kirjastot, työkalut ja alustasopimukset, jotka tekevät ohjelmistosta käyttökelpoisen.

Mihin SLeeLa on osallisena. SLeeLa on osallisena sanoissa Math, Object, Science ja Reach — työn neljä kasvoa: laskettava (Math), katalogissa olevan asian joukossa seisova vakiintunut asia (Object), totuuden kurinalainen tutkimus (Science) sekä järjestelmän käden ulottaminen muihin järjestelmiin ja ihmisiin (Reach). Kansalliset edut säilyvät — yksikään neljästä ei syrjäytä niitä; kun aihe koskee kansakunnan etua, tuo asema säilytetään (kirjataan tarkasti, esim. kunkin luokan Metadata-kentissä metaOrigin / metaNationalSchedule), eikä sitä koskaan hajoteta.

I. Aloitus tästä

II. Uutiset

Viimeaikaiset lisäykset kieleen, ajureihin ja vakiokirjastoon:

III. Rakentaminen ja testaus

Esivaatimukset: C/C++-työkaluketju (GCC tai Clang) ja GNU Make; Python 3 manifesti- ja työnkulkutyökaluille; Linuxissa X11/Xrandr-kehityspaketit näyttötuotteita varten (moduulin make deps raportoi/asentaa tarvittavan). Hakemiston impl/ koonti on fail-closed luotetun SHA-256-manifestin suhteen, johon juuren Makefile osoittaa automaattisesti.

Puhtaasta checkoutista nopein tapa aloittaa:

make                                  # build everything from the repo root

Tai rakenna ja testaa vain natiivi ydin:

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

Repositorion juuren make rakentaa kaikki tuotteet (ydin, VM, koodekit, churn, virustorjunta, …) ja päättyy rekisterin rakentamiseen sekä sen perustaulukon materialisointiin — joten rakennettu puu sisältää tarkistettavan rekisterin heti valmiina. Olennaiset kohteet:

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

Muita hyödyllisiä kohteita:

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

Kohde registry ajaa tiedoston build-registry.sh: se rakentaa rekisterin ytimen, kylvää perustaulukon siirrettävään tekstivarastoon registry/build/sleela.sleelareg ja vie MySQL-taulukkoskriptin registry/build/registry.sql (komennolla sleela registry export). Tarkista se komennolla sleela registry tai registry/build/sleela-registry review. Katso rekisterin opas ja Registry 3.0 -arkkitehtuuri.

Tarkista esivaatimukset ja alustakohtaiset vaiheet rakennus- ja testausoppaista. Yhden komponentin onnistunut koonti ei todista, että jokainen kirjasto tai alusta olisi julkaisukunnossa.

IV. Asennus

Kun natiivit tuotteet on rakennettu, asenna komennot ja suoritusympäristön tukitiedostot:

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

Perinteinen asennin käyttää oletuksena hakemistoja /usr/local/bin, /usr/local/lib/sleela ja /usr/local/share/sleela. Se säilyttää olemassa olevan käynnistysmäärityksen ja kieltäytyy korvaamasta seurantaan kuulumattomia olemassa olevia komentoja. Poisto poistaa vain asentimen kirjaamat tiedostot ja säilyttää määrityksen sekä seurantaan kuulumattoman suoritusaikaisen datan.

Pelkän pääpaketin kohdennettuun, ohjattuun käyttöönottoon — binäärit sleela, sleelvac ja nordshrift, vakiokirjasto, protokollat ja tukimoduulit — käytä puhdasta asenninta:

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

Se tekee yhden pääpäätöksen (asennetaanko pääpaketti), sitten laajuusvalinnan ja onnistumisen jälkeen valinnaisen valitsimen kuratoiduille lisämoduuleille. Vuorovaikutteisen käyttöönoton työnkulku ja kaikki asennusvaihtoehdot on kuvattu osoitteessa Quick and Safe Install.

V. Kieli ja suoritusympäristö

Normatiivinen kielioppi on SLEELA.syntax. Repositorio dokumentoi tällä hetkellä syntaksin 3.0; kääntäjän/työkalun versio ja lähdekielen syntaksiversio ovat eri asioita. Versio 3.0 lisää pure- ja gasoline-dokumenttimerkit (§30) — parin paljaita, kontekstuaalisia, vain deklaratiivisia Preonemeja, jotka tarkoittavat lähes samaa ja joista kumpikin merkitsee dokumentin aseman omalla rehellisyydellään. Syntaksi 3.0 yhdistää kielen pinnan 1.0–2.9 nykyiseksi normatiiviseksi editioksi säilyttäen kaikki ominaisuuskohtaiset vähimmäisportit. Edellinen pinta 2.9 lisää @mix-seurannaiskentät (§28) — luokka voi määritellä useita samannimisiä ilmentymäkenttiä, kun jokaisella on @mix, ja ne ymmärretään yhtenä indeksoituna ryhmänä (ylhäältä alas 1,2,3,… tai manuaalisesti @mix(1,2,3,...), jonka indeksien määrän on vastattava ryhmää). Se kantaa mukanaan kantaluvun 2 etumerkilliset/etumerkittömät leveät kokonaislukuperheet int32..int16777216 (§24) ja uint32..uint16777216 (§25) aiempien long/int64/int128-tyyppien (§21) päällä; avainsanatukidokumentit (§22); sekä Preonemit — vain deklaratiiviset dokumenttimerkit author/authorial (§18), material/memory (§19–§20), determine (§23), object/field (§26), pure/gasoline (§30) ja artifact (§35, lainsäädäntötason asema, joka on arvioitu ajan ja paikan suhteen), yhdessä nimeltään Preonemit (§26.1). Konstruktorin ylikuormituksen ratkaisu sekä this(...)-/kantakonstruktoridelegointi ovat nimenomaisesti varmennetun syntaksin 1.8 sopimuksen ulkopuolella. Tutustu kielioppiin ja toteutusmuistiinpanoihin ennen kuin turvaudut ominaisuuteen. SleelaDocin yhdeksän lähdeyksikköä ilmoittavat nyt #sleela 3.0; jaettu kääntäjäportti hyväksyy lähdesyntaksin 1.0–3.0. Uusi API-koonti tuotetaan komennolla make api-docs.

Repositorio sisältää natiivin C/C++-toteutuksen, SLVM-generointiviitteet, vakiokirjastomoduulit, testit, esimerkit ja alustaintegraatiot. Toteutuksen ja validoinnin tila vaihtelee moduuleittain; tarkista moduulin määrittely ja ajantasaiset CI-tulokset sen sijaan, että olettaisit yhtenäisen täydellisyyden.

VI. Suunnitteluperiaatteet

VII. Virustorjunnan koonti ja eheys

Sleelavirin-virustorjuntapaketti sisältää natiivin SHA-256-skannerin, valinnaisen ClamAV-sovittimen, lähde- ja indeksieheysmanifestit sekä alustapakettien tarkistussummat. Rakenna ja testaa paketti repositorion juuresta:

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

Eheysmanifesti generoidaan hakemiston antivirus/build/ alle; se kattaa seurannassa olevat lähde- ja dokumentaatiosyötteet sekä suojatut allekirjoitusindeksitiedostot, mutta jättää pois generoidun tulosteen ja muuttuvan ClamAV-välimuistin. ClamAV-tietokantojen tilannekuvilla on omat manifestinsa. Julkaisu-ZIP-paketit sisältävät INTEGRITY-MANIFEST.json, SHA256SUMS ja .sha256-sivutiedoston. Varmista ladattujen arkistojen tiivisteet erikseen hankittua luotettua arvoa vastaan: arkiston vieressä säilytetty tarkistussumma ei ole julkaisijan allekirjoitus. Katso Sleelavirin-opas, tietoturvatarkistuslista ja virustorjunnan koontityönkulku.

Julkaisua ei pidetä varmennettuna, ennen kuin asiaankuuluvat CI-työt ovat läpäisseet täsmälleen kyseisen julkaisucommitin ja syntyneet artefaktit on tarkastettu.

VIII. SLeeLa-editoriteemat — Vim ja Emacs

SLeeLa sisältää koordinoidun joukon ammattimaisia tummia värimaailmoja Vimille ja Emacsille sekä natiivin C/C++-palettityökalun. Alkuperäinen American Professional -teema on edelleen oletus. Kymmenen kumppanipalettia on tarjolla erilaisten kulttuuristen ja institutionaalisten suunnitteluinspiraatioiden pohjalta; ne ovat tulkinnallisia suunnittelupaletteja, eivät minkään kansakunnan, kulttuurin, tuomioistuimen tai instituution virallisia esityksiä.

Yksitoista teemaa ja niiden värit

TeemaTaustaEdustaväriAvainsanatTyypitMerkkijonotKommentit
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

Kansallisten lippujen värit (lähdepaletti)

Kreikan ja Turkin teemat on johdettu maiden virallisista kansallislippujen väreistä, jotka on esitetty tässä tarkkoine julkaistuine heksa-arvoineen. Yllä olevat teemojen taustat ja korostusvärit ovat näiden lähdevärien tummennettuja, editoriystävällisiä tulkintoja — alla oleva taulukko on ”kansallisesti esitetyt värit” -viite.

ValtioVäriHeksaPerusta ja merkitys
KreikkaSininen<span style="display:inline-block;width:1em;height:1em;background:#0D5EAF;border:1px solid #888"></span> #0D5EAFKansallislipun sininen (laki 851/1978). Taivas ja meret; heraldisesti kuvattuna azure.
KreikkaValkoinen<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFKansallislipun valkoinen. Itsenäisyystaistelun puhtaus; risti tarkoittaa itäortodoksista kristinuskoa.
TürkiyePunainen (al bayrak)<span style="display:inline-block;width:1em;height:1em;background:#E30A17;border:1px solid #888"></span> #E30A17Kansallislipun punainen (Turkin lippulaki). Kenttä; perinteisesti marttyyrien veri ja ottomaanien suvereniteetti.
TürkiyeValkoinen<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFKansallislipun valkoinen. Puolikuu ja tähti — rauha, puhtaus sekä turkkilaisen/islamilaisen perinnön symboli.

Teemat ankkuroivat kunkin editorin edustavärin kansalliseen valkoiseen ja avainsanat, kohdistimen, valinnan sekä tilarivin täsmälliseen kansalliseen siniseen (#0D5EAF) tai punaiseen (#E30A17), joten olennaiset värit ovat kirjaimellisesti kansallisia värejä. Nämä ovat tulkinnallisia suunnittelupaletteja; lippuvärien viite on annettu alkuperän osoittamiseksi, eikä se ole kummankaan valtion virallinen esitys. Värien merkitykset noudattavat Helleenien tasavallan ulkoministeriön valtion symbolien kuvausta ja Turkin lippulain perinnettä.

Värimallitaulukko

Alla olevien palettisolujen SVG-näytteet saavat GitHubin renderöimään todelliset värit tyhjien HTML-värisolujen sijaan. Jokainen kaista näyttää kuusi väriä tässä järjestyksessä: tausta, edustaväri, avainsanat, tyypit, merkkijonot ja kommentit. Tarkat heksakoodit on lueteltu kunkin näytteen vieressä samassa teemajärjestyksessä kuin yllä olevassa viitetaulukossa.

TeemaRenderöidyt palettiväritHeksakoodit (tausta · edustaväri · avainsanat · tyypit · merkkijonot · kommentit)
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

Funktioille, vakioille, valinnoille, diagnostiikalle ja esikääntäjän direktiiveille käytetään lisäkorostusvärejä. Venäläinen ja slaavilainen paletti käyttää tarkoituksella keskivoimakkaita liuskekiven, sinisen, salvian, rubiinin ja antiikkikullan sävyjä rauhallisemman ammattimaisen ilmeen aikaansaamiseksi.

Vim-teemojen asennus

Repositorion juuresta:

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/

Lisää seuraava tiedostoon ~/.vimrc ottaaksesi SLeeLa-syntaksikorostuksen käyttöön ja valitaksesi teeman:

syntax enable
set background=dark
colorscheme sleela-american

Valitse täsmälleen yksi seuraavista colorscheme-nimistä:

Käytä esimerkiksi colorscheme sleela-russian-slavic keskivoimakkaalle venäläiselle ja slaavilaiselle paletille tai colorscheme sleela-greek / colorscheme sleela-turkish helleeniselle ja Al Bayrak -paletille. Käynnistä Vim uudelleen tai lataa määritys komennolla :source $MYVIMRC.

Emacs-teemojen asennus

Luo paikallinen teemahakemisto ja kopioi tila- ja teematiedostot repositorion juuresta:

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/

Lisää tämä tiedostoon ~/.emacs tai ~/.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)

Korvaa sleela-american arvolla sleela-eurasia, sleela-russian-slavic, sleela-silk-road, sleela-east-asian, sleela-greek, sleela-turkish, sleela-kiro tai sleela-sleela valitaksesi toisen teeman. Jos Emacs kysyy, luotetaanko teemaan, tarkista paikallinen teematiedosto ennen hyväksymistä.

Natiivien C/C++-palettien esikatselu

Pieni natiivi palettityökalu osaa luetella teemat, tulostaa niiden päätteen värit ja hakea yksittäisen värin:

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

Taaksepäinyhteensopivuuden vuoksi --palette ja --hex COLOR ilman --theme-valitsinta valitsevat American Professionalin. Koonti- ja testitulokset on tarkistettava kohdejärjestelmässä ja CI:ssä; komennon dokumentointi ei sellaisenaan todista, että se olisi läpäissyt testin.

Katso täydelliset palettikuvaukset ja työkalun tiedot editoriintegraatio-oppaasta.

IX. Osallistuminen

  1. Lue dokumentaatiohakemisto ja testauskäytäntö.
  2. Tee rajattuja muutoksia positiivisten ja negatiivisten testien kera.
  3. Aja kohdennetut testit ja sen jälkeen laaja testikokonaisuus.
  4. Ilmoita käyttöjärjestelmän ja työkaluketjun tiedot; älä kuvaa ohitettuja tarkistuksia läpäistyiksi.

SLeeLaa kehittää MEARVK LLC. Historiallinen aloitussivuaineisto on säilytetty tiedostossa docs/README-LEGACY.md.

X. AE6E66 — Round Public -sähköpostin veroodotus

AE6E66-aloitteessa projektin ilmoitettu odotus on $300,000,000.00 USD jokaista Round Public -sähköpostia kohti ehdotettuna veromaksun määränä, joka liittyy kuhunkin kelpuutettuun Round Public -sähköpostiin.

Tämä lausuma kirjaa vain projektin odotuksen. Se ei ole oikeudellinen veropäätös, viranomaismääräys, tuomioistuimen tuomio eikä itsenäisesti vahvistettu verovelvollisuus. Todellinen vero edellyttäisi toimivaltaista oikeudellista viranomaista, lainkäyttöaluetta, määritelmiä, menettelyä ja pätevää valtiollista päätöstä.

XI. Aakkoset ja merkistön suoritusympäristö

SLeeLan aakkosdokumentaatiota ja natiivia merkkien suoritusympäristöä ylläpidetään hakemistoissa alphabet/sleela/ ja lib/alphabet/native/. Natiivit C++17-testit kattavat tiukan UTF-8-skalaarien dekoodauksen/enkoodauksen, C<n>-kapasiteettiallekirjoitukset ja rajatun merkistöjäsenyyden:

make -C lib/alphabet/native test

Kokeellinen UTF-4088-luettelo ja sen SLeeLa-hakusovitin on dokumentoitu tiedostossa utf-4088/SLeeLa-ALPHABET-INTEGRATION.md. UTF-4088-tunnisteet ovat erillinen nimiavaruus, eivät Unicode-skalaariarvoja. Kääntäjän ja SLVM:n sidostyö on nimenomaisesti erillään seurannassa näistä natiiveista perustoista.

XII. AutoCAD Creator™

AutoCAD Creator™ on vuorovaikutteinen 2D-CAD- sovellus, joka on kirjoitettu kokonaan SLeeLalla. Siinä missä sisarsovellus AutoCAD Renderer muuntaa suunnitelman piirrokseksi yhdellä kertaa, Creatorilla voi luoda ja muuttaa 2D- AutoCAD-dokumenttia livenä — lisätä seiniä, huoneita, mittoja ja huomautuksia ja sitten siirtää, nimetä uudelleen, vaihtaa tasoa, poistaa ja kumota lisäämänsä — sekä tallentaa tuloksen todelliseksi AutoCAD DXF -piirrokseksi (R12-teksti, aukeaa AutoCADissa / LibreCADissa).

Sen graafinen käyttöliittymä on rakennettu SleelaUI™-kirjaston päälle, joka on SLeeLan oma alustariippumaton käyttöliittymätyökalupakki (hakemistossa lib/user-interface) — ei JavaFX — ja se nostaa esiin todellisen natiivin ikkunan X11:llä / Cocoalla / Win32:lla. Suunnittelu noudattaa yhtä sääntöä, ”SleelaUI presents; SLeeLa decides”: GUI ei koskaan laske geometriaa eikä kirjoita DXF:ää. Jokainen työkalu antaa luonti- / muutos- / poisto- / kumoa- / tallenna-aikeen auktoriteettiselle SLCadCreator-luokalle, joka omistaa muokattavan dokumentin ja käännettävän komentohistorian, kun taas piirtoalue vain esikatselee Creatorin hallussa olevaa geometriaa.

Uudelleenkäytettävä muokkausmoottori sijaitsee hakemistossa lib/autocad — SLCadEntity, SLCadDocument, SLCadCommand ja SLCadCreator — ja toimii päästä päähän ilman näyttöä. GUI-kuori ja demo sijaitsevat hakemistossa autocad/creator:

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

Näytöllisellä koneella tämä avaa live-muokkausikkunan; näyttämättömällä isännällä se rakentaa piirroksen muistissa, tulostaa raportin ja DXF:n sekä päättyy siististi.

XIII. UTF-4088-syöttökartan järjestys

Erikoistunut UTF-4088-luettelo määrittelee tilallisen syöttökarttansa läpikäynnin ja abstraktit painekierrokset tiedostossa utf-4088/INPUT-MAP-AND-PRESSURE.md. National Lien -aiheindeksikäytäntö on tiedostossa utf-4088/NATIONAL-LIEN-REGISTER.md. Karttakoordinaatit, painetasot (1–50), pysyvät luettelotunnisteet ja aakkosjärjestysluokat ovat toisistaan riippumattomia kenttiä; mitään niistä ei saa huomaamatta korvata toisella. Paine on algoritminen iteraatiotaso, ei fysikaalinen suure.

XIV. Viimeaikainen ja laajennettu pakettihakemisto

Tämä liitetty hakemisto nostaa esiin äskettäin laajennettuja paketteja, aluekirjastoja ja lähdekokoelmia. Merkinnät on ryhmitelty aakkosjärjestykseen paketin nimen tai aiheen mukaan. Kuvaukset osoittavat repositoriosijainnin; toteutuksen ja validoinnin tila on tarkistettava kunkin paketin omasta dokumentaatiosta ja testeistä.

A–C

D–G

H–I

O–S

U–W

Pakettihakemiston ylläpito

Kun paketti lisätään tai sitä laajennetaan olennaisesti, lisää sen merkintä tänne asianmukaiseen aakkosryhmään, linkitä sen kanoniseen hakemistoon ja README-tiedostoon ja kuvaa vain ominaisuudet, joita sisäänkirjatut lähteet tukevat. Pidä tämä hakemisto additiivisena: älä poista tai kirjoita uudelleen olemassa olevia README-osioita pakettihakemistopäivitysten yhteydessä.


<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. Kansallinen tiedebrändikuvasto

<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:n miljoonan merkinnän kokeellinen luettelo

UTF-4088-luettelogeneraattori rakentaa deterministisesti 1 048 576 merkinnän kokeellisen symboliluettelon. Dokumentoitu kompakti muoto on kuvattu tiedostossa utf-4088/FORMAT.md; generoinnin ja validoinnin sopimus on tiedostossa utf-4088/GENERATION-RESULTS.md.

Aja generaattori Python 3:lla:

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

Generoitu binääri on 16 777 244 tavua, ja se on suunniteltu pysymään alle 20 000 000 tavun. Yksikkötestit ja GitHub Actions -työnkulku varmentavat merkintöjen määrän, glyfien yksilöllisyyden, koon ja SHA-256:n; onnistuneet ajot julkaisevat binäärin ja yhteenvedon työnkulun artefaktina utf4088-million-catalogue. Generoitu binääri pidetään tarkoituksella poissa Git-historiasta. UTF-4088 on edelleen kokeellinen eikä ole Unicode-yhteensopiva.


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. Viimeaikaiset lisäykset — Pi-vakio, Modium/Registry-käynnistys, sleelactl Math ja @native

Tämä osio kirjaa ominaisuudet, jotka lisättiin työssä 2026-11, uusimmat ryhmät ensin. Linkitetyt lähdetiedostot ja niiden varmennustila ovat ratkaisevia; tarkistettavana olevia muutoksia ei kuvata yhdistetyiksi, ennen kuin ne ovat tulleet haaraan master.

100 000 000 numeron Pi-luettelovakio

Repositorio sisältää varmennetun sadan miljoonan numeron π-arvon tiedostossa pi-generator/pi.100000000.digits (hyvin muodostettu desimaaliluku, 3.14159…) sekä 57 344 numeron arvon pi-generator/pi.57344.digits. Molemmat on itsenäisesti varmennettu aidoksi π:ksi — katso pi-generator/VERIFIED.md, joka dokumentoi tarkistukset (oppikirjan etuliite, Feynmanin piste murto-osan paikassa 762, kuuluisa miljoonas numero, yhtäpitävyys tiedoston lib/math/SLPiReference.sleela kanssa sekä koko tiedoston numerofrekvenssianalyysi) ja yhden ajon toistoskriptin.

Modium™ / Registry™ lataavat Pi-vakion alijärjestelmän käynnistyksessä

Omistetuissa alijärjestelmän sisääntulopisteissä — sleela registry ja sleela modium (sekä asentimen ensimmäinen ajo), ei jokaisella sleela run -ajolla — Modium- ja Registry-alijärjestelmät lataavat suuren π-luettelovakion. Interaktiivisessa päätteessä ne tulostavat ohimenevän punaisen Loading Modium™ / Loading Registry™ -rivin, joka pyyhitään paikallaan pois ennen normaalin tulosteen alkua; vaikutus on tiukasti sidottu TTY:hyn, joten putkitettu ja testitulos pysyvät tavu tavulta muuttumattomina. Paikannin (ei tavut) kylvetään rekisterin Math-avaimen oletuksiksi piReferenceLargePath ja piReferenceLargeDigits, sekä SLeeLa-mallissa (lib/registry/SLRegistry.sleela) että natiivissa kylväjässä (registry/sleela_registry.c); lib/math/SLPiReference.sleela tarjoaa largePath() / largeDigits(). π-vakio asennetaan käyttöjärjestelmän SLeeLa-sijaintiin (<data>/pi/) sekä tavallisella make-asentimella että ohjatulla ”kauniilla” asentimella. Lisätiedot: pi-generator/MODIUM-REGISTRY-PI-STARTUP.md.

sleelactl — kaunis asennin ja natiivitukeinen math-subjekti

@native, Native Drive ja monikielinen suoritus

Uusi @native-metodimerkintä pyytää kuuman metodin ennakkoon tehtävää natiivikäännöstä. Uusi sleela aot -komento etsii @native-metodit, varmistaa, että kukin kuuluu tuettuun ulkoistettavaan osajoukkoon, ja tuottaa C/C++:aa — epäonnistuen suljetusti (kieltäytyen täsmällisellä syyllä) kaikista rakenteista, joita se ei vielä osaa kääntää, jolloin puoliksi käännettyä metodia ei koskaan synny.

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 on edelleen pyyntö AOT-käsittelystä, ja tukemattomat rakenteet hylätään ennen tuottamista. Native Drive tukee usean yksikön C/C++-suoritettavien ja jaettujen kirjastojen koontia isäntäkääntäjillä (MSVC mukaan lukien), tuettua SLeeLa AOT -tulostetta, symbolien tarkastusta natiivilataajan ABI:a vasten, kuoretonta prosessin suoritusta, stdin/stdout/stderr-käsittelyä, monivaiheista putkitusta sekä XClass-delegointia tuotantolataajalle. sleelactl tarjoaa sen koonti-/ajokomennot ja reitittää XClass-tarkastuksen sekä nimenomaisen systemd-yksikön renderöinnin ja asennuksen komennon inspect native-drive kautta. VM omistaa rajatun natiivimoduulikahvataulukon, jossa on pakollinen isäntävaltuutus ja sukupolvitarkistetut kahvat. Syntaksi 3.0 lisää nyt nativeOpen, nativeCall ja nativeClose: vain lisäävä tavukoodivälitys ylittää erikseen versioidun null/bool/int64/double/UTF-8 -ABI:n, kun taas VM:n omistamat taulukot, structit ja muut yhdistetyt arvot pysyvät tulkin sisällä ja voivat käyttää samannimistä tavukoodivaraa. Lisäosat voivat valinnaisesti saada versioidun isäntäkutsutaulun, jolla ne kutsuvat täsmällisiä SLeeLa-funktioita sisäkkäisen VM-suorituksen kautta; keskeytettyjen pinojen GC-juuritus, nimenomainen isäntäkutsunimien sallittujen lista ja rekursiiviset natiivit API-kutsut hylätään. Natiivi koodi pysyy luotettuna prosessinsisäisenä koodina, ei hiekkalaatikkona. Lähteen prosessipolitiikkamerkinnöillä on versioitu skeema, mutta niitä ei vielä jäsennetä/pakoteta. Lisätiedot, turvallisuusrajat ja seitsemän työvirran kirjanpito: Native Drive ja pi-generator/AT-NATIVE.md.

XIX. Kansainväliset README-editiot

SLeeLa tarjoaa maakohtaiset README-aloituspisteet kansainvälisen editionsa 50 markkinalle. Jokaisella maalla on yksi tiedosto nimeltä README.<CC>.md; missä useat kielet ovat relevantteja, ne on ryhmitelty kyseisen maan tiedoston sisään.

Käännöskäytäntö: Nämä tiedostot ovat alustavia lokalisoituja maakohtaisia aloituspisteitä. Niiden johdannot ja kieliotsikot on lokalisoitu, kun taas täydellinen tekninen viite säilyy kanonisessa englanninkielisessä tiedostossa README.md. Maatiedostoa ei saa kuvata täydelliseksi käännökseksi, ennen kuin jokainen osio on käännetty, tekniset tunnisteet ja linkit on tarkistettu ja edition kieli on tarkastettu. Kielikattavuus tässä ensimmäisessä vaiheessa on edustava, eikä se ole väite siitä, että jokainen perustuslaillisesti tunnustettu, alueellinen, alkuperäiskansojen tai viittomakieli olisi käännetty täysin.

Liite — säilytetty alueellinen ohjeistus

Tämä liite säilyttää aiemman lyhyen suomenkielisen oppaan käytännön ohjeet, joita ei ole omina osioinaan kanonisessa README-tiedostossa. Kanoninen englanninkielinen README.md on ensisijainen kaikissa ristiriitatilanteissa.

Kääntäjän rakenne ja suoritusmalli

SLeeLa erottaa lähdekielen, kääntäjän frontendin, välimuodon, koodin generoinnin ja suoritusympäristön suorituksen. Kääntäjän julkaisuversio, syntaksiversio ja VM/ISA-versio ovat eri asioita. Ominaisuuden maininta määrittelyssä ei todista, että se olisi toteutettu kaikilla kohteilla.

Tavallinen putki lukee UTF-8-.sleela-lähdetiedostoja, tekee leksikaalisen ja syntaktisen analyysin, tarkistaa symbolit ja tyypit, muuntaa rakenteisen välimuodon, tuottaa tulosteen tuetuille VM- tai välikohteille ja suorittaa tuloksen suoritusympäristössä. Normatiivinen kielioppi on SLEELA.syntax; katso myös lähdedokumentaatio ja kääntäjädokumentaatio.

Tyypit, oliot ja kirjastot

Dokumentoituun lähdetyyppien joukkoon kuuluvat int, double, boolean, String, void, ilmoitetut struct-tyypit ja tuetut viitetyyppien allekirjoitukset. int, long ja int64 ovat etumerkillisiä 64-bittisiä kokonaislukuja. int128 hyväksytään kokonaislukutyypiksi, mutta nykyinen dokumentoitu toteutus perustuu edelleen 64 bittiin.

struct on nimetty koosterakenne. VM:n hallitsema struct-kahva ei ole raaka osoitin; sijoitus ja parametrien välitys jakavat saman ilmentymän, ja yhtäsuuruus perustuu identiteettiin. Käytä dokumentoituja structPack(instance)- ja structUnpack(TypeName, json)-toimintoja siirrettävään serialisointiin. Luokat sisältävät kenttiä ja metodeja; perintä, sisäkkäiset luokat ja geneeriset tyypit ovat syntaksiversion rajaamia.

Keskeisiä moduuleja ovat lib/advantage (mallipohjainen arviointi, matematiikka, integraatio, luokittelu ja reititettävä tuloste), lib/xml (XML DOM), lib/text (teksti- ja merkkijono-operaatiot), lib/sleeladoc (lähdedokumentaatio ja CLI), lib/cpu, lib/xlt (CPU-profiilit ja ajoitusviitteet) sekä recursion/stanchion (C/C++-rekursioprototyypit). Moduulin olemassaolo ei todista tuotantovalmiutta; tarkista testit ja alustarajoitukset.

Kohteet, profiilit ja natiivin suoritusraja

SLeeLa erottaa lähdekoodin suoritus- ja käännöskohteista. Dokumentoituun kohdeperheeseen kuuluvat SLVM, SLJVM ja SLIR; NATIVE on rajattu ja ehdollinen kohde, eikä sitä pidä olettaa yleisesti saatavaksi kaikilla alustoilla. Profiilit BASIC_COMPLETE ja ADVANCED_TOTAL kuvaavat eri laajuuksia. Varmista aina kyseisen koonnin todellinen kohde, profiili ja alustatuki.

Viite tunnistaa tiedoston, moduulin tai resurssin, mutta ei itsessään anna lupaa suorittaa sitä. Tämä on tärkeää, kun ohjelma käyttää tiedostoja, ulkoisia kirjastoja, native-sidoksia tai järjestelmäresursseja. Tarkista syötteet ja määritä selvästi, millä komponentilla on oikeus suorittaa toiminto. Dokumentaatioväite ei yksin todista suoritusaikaista tietoturvatakuuta ilman vastaavaa toteutus- tai testinäyttöä.

Resurssien elinkaari ja vianmääritys

Dokumentoi funktioiden tai säikeiden välillä jaettujen resurssien omistajuus, elinkaari ja synkronointivastuu. Erota paikalliset muuttujat, jaettu oliotila, VM-kahvat ja serialisoitava data toisistaan. VM-paikallinen kahva ei ole vakaa tiedostomuoto tai verkkoviesti. Käytä moduulin määrittelemää serialisointirajapintaa ja testaa virheelliset, puuttuvat ja raja-arvoiset syötteet.

Vianmäärityksessä kirjaa commit, käyttöjärjestelmä, arkkitehtuuri ja työkaluketju. Aloita pienimmästä asiaankuuluvasta koonnista, tallenna koko virhetuloste ja erota kääntäjän virheet suoritusaikaisista virheistä. Pyri tuottamaan pieni toistettava esimerkki. Onnistunut koonti ei yksin todista ohjelman oikeaa toimintaa.

Hyvä varmennusraportti sisältää tarkan commitin, käyttöjärjestelmän ja arkkitehtuurin, kääntäjän versiot, täsmälliset koonti- ja testikomennot, läpäisseiden/epäonnistuneiden/ohitettujen testien määrät sekä tunnetut rajoitukset. Ohitettuja tai suorittamattomia testejä ei saa laskea läpäistyiksi.

Moduulirajapinnat, yhteensopivuus ja testaus

Uuden API:n yhteydessä on kuvattava syötteet, tulosteet, virhetilanteet, tietojen omistajuus sekä mahdolliset sivuvaikutukset. Dokumentaatioesimerkkien tulee näyttää sekä tavallinen käyttö että virheellisten tai puuttuvien arvojen käsittely. Älä esitä takuuna toimintaa, jota toteutus ja testit eivät vahvista.

Jaa testaus kääntäjän vaiheiden mukaan: lekseeraus/jäsennys, semanttinen analyysi, IR-madallus, koodin generointi, VM-suoritus ja natiivi integraatio. Säilytä jokaisesta regressiotapauksesta pienin toistettava syöte, odotettu tulos ja todellinen tulos. API-muutoksissa on kuvattava taaksepäinyhteensopivuus, migraatiovaiheet ja vaikutukset olemassa oleviin esimerkkeihin.

Huomautuksia viitteistä ja osoitteista

README:n viitteet aiheisiin kuten CSPML, Character, Governance, Synchro, SleelaUI ja United Nations kuvaavat repositorion sisältöä eivätkä ole viranomaisten tai instituutioiden virallisia hyväksyntöjä.

Osoitteiden tai kuvien esiintyminen osiossa Bitcoin Conjegeum (XV) ei ole sijoitussuositus, omistuksen vahvistus eikä ohje siirtää varoja. Tarkista tiedot itsenäisesti ennen käyttöä.

Käännöksen tila: Osiot I–XIX on käännetty suomeksi. Tekniset tunnisteet, komennot, koodiesimerkit, tiedostonimet, linkit ja osoitteet on säilytetty. Äidinkielisten puhujien suorittama lopullinen kielentarkistus on suositeltavaa.