Home /Modules/docs/README.PH.md

README.PH.md

docs/i18n/README.PH.md · 749 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 — Pilipinas (PH)

<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>Isang katutubong wika sa pagprograma ng sistema, compiler, runtime, at ekosistema ng mga virtual machine.</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>

Pandaigdigang edisyon para sa bansa. Ang edisyong ito ay nasa wikang Filipino (Filipino · English ang pamagat ng naunang gabay). Hindi binabago ang mga technical identifier, command, code example, filename, path, at link kumpara sa canonical na English README.md.

The Now. The Ingredient. Hindi lamang syntax ang isang wika: ito ang compiler, runtime, mga library, mga tool, at mga kasunduan ng platform na nagpapagamit sa software.

Ano ang kinasasangkutan ng SLeeLa. Kasangkot ang SLeeLa sa Math, Object, Science, at Reach — ang apat na mukha ng gawain nito: ang nakukwenta (Math), ang naitatag na bagay na nakatayo sa katalogo ng kung ano ang umiiral (Object), ang disiplinadong pag-aaral ng totoo (Science), at ang pag-abot ng kamay ng isang sistema sa ibang mga sistema at tao (Reach). Nananatili ang mga National Interest — hindi sila isinasantabi ng alinman sa apat; kapag may kinalaman ang isang paksa sa interes ng isang bansa, iniingatan ang katayuang iyon (itinatala nang tapat, hal. sa metaOrigin / metaNationalSchedule ng Metadata ng bawat class), at hindi kailanman binubuwag.

I. Magsimula Rito

II. Balita

Mga kamakailang dagdag sa wika, mga driver, at standard library:

III. Build at Test

Mga kinakailangan: isang C/C++ toolchain (GCC o Clang) at GNU Make; Python 3 para sa manifest/flow tooling; sa Linux, ang X11/Xrandr development package para sa mga display product (iniuulat/ini-install ng make deps ng isang module ang kailangan nito). Ang impl/ build ay fail-closed sa isang pinagkakatiwalaang SHA-256 manifest, na awtomatikong tinutukoy ng root Makefile.

Mula sa malinis na checkout, ang pinakamabilis na simula:

make                                  # build everything from the repo root

O buuin at subukan lamang ang native core:

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

Binubuo ng make sa repo-root ang bawat product (core, VM, codecs, churn, antivirus, …) at nagtatapos sa pagbuo ng registry at pag-materialize ng baseline table nito — kaya ang nabuong puno ay may dalang mare-review na registry agad. Ang mga mahahalagang target:

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

Iba pang kapaki-pakinabang na target:

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

Pinapatakbo ng registry target ang build-registry.sh: binubuo nito ang registry core, inilalagay ang baseline table sa portable text store na registry/build/sleela.sleelareg, at ine-export ang MySQL table script na registry/build/registry.sql (sa pamamagitan ng sleela registry export). I-review ito gamit ang sleela registry o registry/build/sleela-registry review. Tingnan ang gabay sa registry at arkitektura ng Registry 3.0.

Kumonsulta sa mga gabay sa build at testing para sa mga kinakailangan at hakbang na partikular sa platform. Hindi nangangahulugang handa na sa release ang bawat library o platform dahil lamang matagumpay ang build ng isang component.

IV. Pag-install

Matapos buuin ang mga native product, i-install ang mga command at runtime support file:

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

Ginagamit ng kumbensiyonal na installer bilang default ang /usr/local/bin, /usr/local/lib/sleela, at /usr/local/share/sleela. Pinapanatili nito ang umiiral na startup configuration at tumatangging mag-overwrite ng mga umiiral na command na hindi nito sinusubaybayan. Ang pag-uninstall ay nag-aalis lamang ng mga file na itinala ng installer, at pinapanatili ang configuration at mga runtime data na hindi nito sinusubaybayan.

Para sa nakatuon at gabay na deployment ng pangunahing package lamang — ang mga binary na sleela, sleelvac, at nordshrift, ang standard library, mga protocol, at mga support module — gamitin ang clean installer:

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

Gumagawa ito ng isang pangunahing desisyon (i-install ang pangunahing package), pagkatapos ay pagpili ng saklaw, at kapag nagtagumpay, isang opsyonal na picker para sa mga piling enhancement module. Para sa interactive na workflow ng deployment at lahat ng opsyon sa pag-install, tingnan ang Mabilis at Ligtas na Pag-install.

V. Wika at Runtime

Ang awtoritatibong grammar ay ang SLEELA.syntax. Dinodokumento ng kasalukuyang repository ang syntax 3.0; magkaiba ang bersiyon ng compiler/tool at ang bersiyon ng source syntax. Idinaragdag ng 3.0 surface ang mga document marker na pure at gasoline (§30) — isang pares ng hubad, contextual, declarative-only na Preonems na halos magkapareho ang ibig sabihin, na ang bawat isa ay nagmamarka sa katayuan ng dokumento ayon sa sarili nitong katapatan. Pinagsasama-sama ng syntax 3.0 ang 1.0–2.9 na language surface sa kasalukuyang normative na edisyon, habang pinapanatili ang lahat ng minimum gate na partikular sa feature. Idinaragdag ng naunang 2.9 surface ang @mix consequent field (§28) — maaaring magdeklara ang isang class ng maraming instance field na magkapareho ang pangalan kapag bawat isa ay may @mix, na nauunawaan bilang isang indexed na grupo (mula itaas pababa na 1,2,3,… o manwal na @mix(1,2,3,...) na ang bilang ng index ay dapat tumugma sa grupo). Dala nito ang base-2 signed/unsigned na wide-integer family na int32..int16777216 (§24) at uint32..uint16777216 (§25) sa ibabaw ng naunang long/int64/int128 (§21); ang keyword supporter document (§22); at ang Preonems — ang mga declarative-only na document marker na author/authorial (§18), material/memory (§19–§20), determine (§23), object/field (§26), pure/gasoline (§30), at artifact (§35, katayuang pang-lehislatura na iginagradwa ayon sa oras at espasyo), na sama-samang pinamagatang Preonems (§26.1). Tahasang nasa labas ng na-verify na kontrata ng syntax 1.8 ang constructor overload resolution at ang this(...)/base-constructor delegation. Kumonsulta sa grammar at sa mga implementation note bago umasa sa isang feature. Idineklara na ngayon ng siyam na source unit ng SleelaDoc ang #sleela 3.0; tumatanggap ang nakabahaging compiler gate ng source syntax 1.0–3.0. Ang bagong API build ay nabubuo ng make api-docs.

May native na C/C++ implementation ang repository, mga SLVM generation reference, mga module ng standard library, test, halimbawa, at integrasyon sa platform. Nag-iiba ang kalagayan ng implementation at validation ayon sa module; kumonsulta sa specification nito at sa kasalukuyang resulta ng CI sa halip na ipalagay na pare-pareho ang pagkakumpleto.

VI. Mga Prinsipyo sa Engineering

VII. Antivirus Build at Integridad

Kasama sa Sleelavirin antivirus package ang isang native na SHA-256 scanner, isang opsyonal na ClamAV adapter, mga integrity manifest ng source/index, at mga checksum ng platform package. Buuin at subukan ang package mula sa root ng repository:

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

Nabubuo ang integrity manifest sa ilalim ng antivirus/build/; saklaw nito ang mga tracked na source at documentation input pati ang mga protektadong signature-index file, habang hindi isinasama ang nabuong output at ang nababagong ClamAV cache. May sarili nilang manifest ang mga snapshot ng database ng ClamAV. Kasama sa mga release ZIP ang INTEGRITY-MANIFEST.json, SHA256SUMS, at isang .sha256 sidecar. Beripikahin ang mga hash ng na-download na archive laban sa pinagkakatiwalaang halagang nakuha nang hiwalay: ang checksum na nakatabi sa isang archive ay hindi lagda ng publisher. Tingnan ang gabay sa Sleelavirin, security checklist, at antivirus build workflow.

Hindi ituturing na verified ang isang release hangga't hindi pumapasa ang mga kaugnay na CI job sa eksaktong release commit at hindi nasusuri ang mga nagresultang artifact.

VIII. Mga Theme ng SLeeLa Editor — Vim at Emacs

Kasama sa SLeeLa ang koordinadong hanay ng mga propesyonal na dark color scheme para sa Vim at Emacs, pati isang native na C/C++ palette utility. Nananatiling default ang orihinal na scheme na American Professional. May sampung kasamang palette na hango sa iba't ibang kultural at institusyonal na inspirasyon sa disenyo; mga interpretibong design palette ang mga ito at hindi opisyal na representasyon ng alinmang bansa, kultura, hukuman, o institusyon.

Ang Labing-isang Scheme at ang Kanilang mga Kulay

SchemeBackgroundForegroundKeywordsTypesStringsComments
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

Mga kulay ng pambansang watawat (source palette)

Hango ang mga scheme na Greek at Turkish sa opisyal na kulay ng pambansang watawat ng dalawang bansa, na ipinapakita rito kasama ang eksaktong inilathalang hex value ng mga ito. Mga dinilimang interpretasyon ang mga background/accent ng scheme sa itaas na angkop sa editor, batay sa mga source colour na ito — ang talahanayan sa ibaba ang sanggunian ng "mga kulay ayon sa pambansang pagkakalantad".

BansaKulayHexBatayan at kahulugan
GreeceAsul<span style="display:inline-block;width:1em;height:1em;background:#0D5EAF;border:1px solid #888"></span> #0D5EAFAsul ng pambansang watawat (Batas 851/1978). Ang langit at mga dagat; tinutukoy sa heraldry bilang azure.
GreecePuti<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFPuti ng pambansang watawat. Kadalisayan ng pakikibaka para sa kalayaan; ang krus ay sumasagisag sa Eastern Orthodox na Kristiyanismo.
TürkiyePula (al bayrak)<span style="display:inline-block;width:1em;height:1em;background:#E30A17;border:1px solid #888"></span> #E30A17Pula ng pambansang watawat (Batas sa Watawat ng Turkey). Ang larangan; ayon sa tradisyon, ang dugo ng mga martir at ang soberanya ng Ottoman.
TürkiyePuti<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFPuti ng pambansang watawat. Ang gasuklay at bituin — kapayapaan, kadalisayan, at simbolo ng pamanang Turkic/Islamic.

Inaangkla ng mga scheme ang foreground ng bawat editor sa pambansang puti, at ang mga keyword, cursor, selection, at status line nito sa eksaktong pambansang asul (#0D5EAF) o pula (#E30A17), kaya literal na pambansang kulay ang mga kulay na mahalaga. Mga interpretibong design palette ang mga ito; inilalaan ang sanggunian sa kulay ng watawat para sa provenance at hindi ito opisyal na representasyon ng alinmang estado. Sumusunod ang kahulugan ng mga kulay sa paglalarawan ng state symbols ng MFA ng Hellenic Republic at sa tradisyon ng Batas sa Watawat ng Turkey.

Talahanayan ng Color Swatch

Gumagamit ang mga palette cell sa ibaba ng SVG swatch, kaya ipinapakita ng GitHub ang aktuwal na mga kulay sa halip na mga walang lamang HTML color cell. Ipinapakita ng bawat strip ang anim na kulay sa pagkakasunod na ito: background, foreground, keywords, types, strings, at comments. Nakalista sa tabi ng bawat swatch ang eksaktong hex code, sa parehong pagkakasunod ng scheme gaya ng talahanayan ng sanggunian sa itaas.

SchemeMga kulay ng palette na na-renderMga hex code (background · foreground · keywords · types · strings · comments)
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

May mga karagdagang accent color para sa mga function, constant, selection, diagnostic, at preprocessor directive. Sadyang gumagamit ang palette na Russian and Slavic ng katamtamang tindi ng slate, asul, sage, ruby, at antique gold para sa mas kalmadong propesyonal na hitsura.

I-install ang mga Vim Scheme

Mula sa root ng repository:

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/

Idagdag ang sumusunod sa ~/.vimrc upang paganahin ang SLeeLa syntax highlighting at pumili ng scheme:

syntax enable
set background=dark
colorscheme sleela-american

Pumili ng eksaktong isa sa mga pangalang ito ng colorscheme:

Halimbawa, gamitin ang colorscheme sleela-russian-slavic para sa katamtamang palette na Russian and Slavic, o ang colorscheme sleela-greek / colorscheme sleela-turkish para sa mga palette na Hellenic at Al Bayrak. I-restart ang Vim o i-source ang iyong configuration gamit ang :source $MYVIMRC.

I-install ang mga Emacs Scheme

Gumawa ng lokal na theme directory at kopyahin ang mga mode at theme file mula sa root ng repository:

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/

Idagdag ito sa ~/.emacs o ~/.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)

Palitan ang sleela-american ng sleela-eurasia, sleela-russian-slavic, sleela-silk-road, sleela-east-asian, sleela-greek, sleela-turkish, sleela-kiro, o sleela-sleela upang pumili ng ibang scheme. Kung itanong ng Emacs kung pagkakatiwalaan ang theme, suriin muna ang lokal na theme file bago tanggapin.

I-preview ang mga Native na C/C++ Palette

Kayang ilista ng maliit na native palette utility ang mga scheme, i-print ang mga terminal color ng mga ito, at maghanap ng isang indibidwal na kulay:

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

Para sa backward compatibility, pinipili ng --palette at --hex COLOR na walang --theme ang American Professional. Dapat suriin ang resulta ng build at test sa target na sistema at sa CI; hindi sa sarili nitong ebidensiya ng pagpasa ang dokumentasyon ng isang command.

Tingnan ang gabay sa editor integration para sa kumpletong paglalarawan ng palette at mga detalye ng utility.

IX. Kontribusyon

  1. Basahin ang indeks ng dokumentasyon at ang patakaran sa testing.
  2. Gumawa ng nakatuong pagbabago na may positibo at negatibong test.
  3. Patakbuhin muna ang mga targeted na test, pagkatapos ay ang malawak na suite.
  4. Iulat ang detalye ng OS/toolchain; huwag ilarawan bilang pumasa ang mga check na nilaktawan.

Binuo ang SLeeLa ng MEARVK LLC. Pinapanatili ang historikal na materyal ng landing-page sa docs/README-LEGACY.md.

X. AE6E66 — Inaasahang Levy sa Round Public Email

Para sa inisyatibang AE6E66, ang ipinahayag na inaasahan ng proyekto ay $300,000,000.00 USD bawat Round Public email bilang iminumungkahing halaga ng tax levy na kaugnay ng bawat kwalipikadong Round Public email.

Itinatala lamang ng pahayag na ito ang inaasahan ng proyekto. Ito ay hindi legal na tax assessment, utos ng pamahalaan, hatol ng hukuman, o independiyenteng naitatag na pananagutan sa buwis. Mangangailangan ang anumang aktuwal na levy ng naaangkop na legal na awtoridad, hurisdiksiyon, mga depinisyon, pamamaraan, at kakayahang pagpapasya ng pamahalaan.

XI. Alphabet at Character-set Runtime

Pinananatili ang dokumentasyon ng alphabet ng SLeeLa at ang native character runtime nito sa alphabet/sleela/ at lib/alphabet/native/. Sinasaklaw ng mga native na C++17 test ang mahigpit na UTF-8 scalar decoding/encoding, mga signature ng kapasidad na C<n>, at bounded na character-set membership:

make -C lib/alphabet/native test

Dokumentado sa utf-4088/SLeeLa-ALPHABET-INTEGRATION.md ang eksperimental na UTF-4088 catalogue at ang SLeeLa lookup adapter nito. Magkahiwalay na namespace ang mga UTF-4088 ID at hindi mga Unicode scalar value. Hiwalay na sinusubaybayan nang tahasan ang compiler at SLVM binding work mula sa mga native na pundasyong ito.

XII. AutoCAD Creator™

Ang AutoCAD Creator™ ay isang interactive na 2D CAD application na buong nakasulat sa SLeeLa. Kung ang kapatid nitong AutoCAD Renderer ay ginagawang drawing ang isang plano nang minsanan, hinahayaan ka ng Creator na lumikha at magbago ng 2D AutoCAD document nang live — magdagdag ng mga pader, silid, dimensyon, at tala, pagkatapos ay ilipat, palitan ang label, ilipat ng layer, burahin, at i-undo ang inilagay mo — at i-save ang resulta bilang totoong AutoCAD DXF drawing (R12 text, nabubuksan sa AutoCAD / LibreCAD).

Ang graphical interface nito ay binuo sa SleelaUI™, ang sariling cross-platform UI toolkit ng SLeeLa (sa ilalim ng lib/user-interface) — hindi JavaFX — na nagtataas ng totoong native window sa X11 / Cocoa / Win32. Sinusunod ng disenyo ang isang tuntunin, "SleelaUI presents; SLeeLa decides": hindi kailanman kinukwenta ng GUI ang geometry o isinusulat ang DXF. Nag-iisyu ang bawat tool ng create / alter / delete / undo / save na intent sa awtoritatibong SLCadCreator, na nagmamay-ari ng nae-edit na document at ng nababaligtad na command history, habang ipinapakita lamang ng canvas ang preview ng geometry na hawak ng Creator.

Ang reusable na editing engine ay nasa lib/autocad — SLCadEntity, SLCadDocument, SLCadCommand, at SLCadCreator — at tumatakbo mula simula hanggang wakas nang headless. Ang GUI shell at demo ay nasa ilalim ng autocad/creator:

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

Sa isang display, binubuksan nito ang live na editing window; sa headless na host, binubuo nito ang drawing sa memory, nagpi-print ng ulat at ng DXF, at maayos na lumalabas.

XIII. Pagkakasunod ng Input-map ng UTF-4088

Tinutukoy ng espesyalisadong UTF-4088 catalogue ang spatial input-map traversal at abstract pressure iteration nito sa utf-4088/INPUT-MAP-AND-PRESSURE.md. Nasa utf-4088/NATIONAL-LIEN-REGISTER.md ang patakaran ng National Lien subject-index. Magkakahiwalay na field ang mga map coordinate, pressure level (1–50), permanenteng catalogue ID, at alphabetic rank; wala sa mga ito ang dapat palihim na ipalit sa iba. Ang pressure ay antas ng algorithmic na iteration, hindi pisikal na dami.

XIV. Kamakailan at Pinalawak na Indeks ng Package

Itinatampok ng idinagdag na indeks na ito ang mga kamakailang pinalawak na package, domain library, at koleksiyon ng source. Pinagpapangkat ang mga entry ayon sa alpabeto ng pangalan ng package o paksa. Tinutukoy ng mga paglalarawan ang lokasyon sa repository; dapat suriin sa sariling dokumentasyon at test ng bawat package ang kalagayan ng implementation at validation.

A–C

D–G

H–I

O–S

U–W

Pagpapanatili ng Indeks ng Package

Kapag may idinagdag o malaking pinalawak na package, idagdag ang entry nito rito sa angkop na grupong alpabetiko, i-link sa canonical na directory at README nito, at ilarawan lamang ang mga kakayahang suportado ng mga naka-check-in na source. Panatilihing additive ang indeks na ito: huwag tanggalin o isulat muli ang umiiral na mga seksyon ng README bilang bahagi ng mga update sa indeks ng package.


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

Demokratiko ng US at Patakaran ng US.


XVI. Imaheng Pang-brand ng National Science

<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. Eksperimental na Catalogue ng UTF-4088 na May Isang Milyong Entry

Deterministikong binubuo ng UTF-4088 catalogue generator ang isang eksperimental na symbol catalogue na may 1,048,576 entry. Inilalarawan ang dokumentadong compact format sa utf-4088/FORMAT.md; nasa utf-4088/GENERATION-RESULTS.md ang kontrata sa generation at validation.

Patakbuhin ang generator gamit ang Python 3:

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

Ang nabuong binary ay 16,777,244 byte at dinisenyong manatili sa ibaba ng 20,000,000 byte. Beripikado ng mga unit test at ng isang GitHub Actions workflow ang bilang ng entry, pagiging natatangi ng glyph, laki, at SHA-256; ang matagumpay na takbo ay naglalathala ng binary at summary bilang utf4088-million-catalogue na workflow artifact. Sadyang ibinubukod ang nabuong binary sa kasaysayan ng Git. Nananatiling eksperimental ang UTF-4088 at hindi ito tugma sa Unicode.


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. Mga Kamakailang Dagdag — Pi Constant, Startup ng Modium/Registry, Math ng sleelactl, at @native

Itinatala ng seksiyong ito ang mga feature na idinagdag noong gawaing 2026-11, ang pinakabagong grupo muna. Awtoritatibo ang mga naka-link na source file at ang kalagayan ng kanilang validation; hindi inilalarawang naka-merge ang mga pagbabagong nasa ilalim ng review hangga't hindi pa nakakarating sa master.

Ang Pi catalog constant na may 100,000,000 digit

Nagpapadala ang repository ng na-verify na halagang isandaang milyong digit ng π sa pi-generator/pi.100000000.digits (isang maayos na decimal, 3.14159…), kasama ang halagang may 57,344 digit na pi-generator/pi.57344.digits. Parehong independiyenteng na-verify bilang totoong π — tingnan ang pi-generator/VERIFIED.md, na dinodokumento ang mga check (prefix sa textbook, ang Feynman point sa fractional na posisyon 762, ang tanyag na ika-isang-milyong digit, pagtutugma sa lib/math/SLPiReference.sleela, at pagsusuri ng dalas ng digit sa buong file) at isang one-shot na reproduction script.

Nilo-load ng Modium™ / Registry™ ang Pi constant sa startup ng subsystem

Sa mga nakalaang entry point ng subsystem — sleela registry at sleela modium (at ang unang takbo ng installer), hindi sa bawat sleela run — nilo-load ng mga subsystem na Modium at Registry ang malaking π catalog constant. Sa interactive na terminal, nagpi-print sila ng pansamantalang pulang linyang Loading Modium™ / Loading Registry™ na binubura sa mismong lugar bago magsimula ang normal na output; mahigpit na TTY-gated ang epektong ito, kaya nananatiling byte-for-byte na hindi nagbabago ang piped at test output. Ang locator (hindi ang mga byte) ay inilalagay bilang mga default ng Math key ng registry na piReferenceLargePath at piReferenceLargeDigits, sa parehong SLeeLa model (lib/registry/SLRegistry.sleela) at sa native seeder (registry/sleela_registry.c); inilalantad ng lib/math/SLPiReference.sleela ang largePath() / largeDigits(). Ini-install ang π constant sa lokasyon ng SLeeLa ng OS (<data>/pi/) ng parehong karaniwang make installer at ng gabay na "beautiful" installer. Mga detalye: pi-generator/MODIUM-REGISTRY-PI-STARTUP.md.

sleelactl — ang beautiful installer at isang native-backed na paksang math

@native, Native Drive, at multi-language na pagpapatakbo

Humihiling ang bagong method annotation na @native ng ahead-of-time na native compilation ng isang hot method. Hinahanap ng bagong command na sleela aot ang mga @native method, bine-verify na nasa loob ng sinusuportahang offloadable subset ang bawat isa, at naglalabas ng C/C++ — fail-closed (tumatangging magpatuloy, na may tiyak na dahilan) sa anumang construct na hindi pa nito kayang isalin, kaya hindi kailanman nalilikha ang kalahating naisaling method.

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

Nananatiling kahilingan para sa AOT na pagtrato ang @native, at tinatanggihan bago ang emission ang mga hindi suportadong construct. Sinusuportahan ng Native Drive ang multi-unit na C/C++ executable at shared-library build sa pamamagitan ng mga host compiler (kabilang ang MSVC), suportadong output ng SLeeLa AOT, inspeksiyon ng symbol laban sa ABI ng native-loader, shell-free na pagpapatakbo ng proseso, paghawak ng stdin/stdout/stderr, multi-stage na piping, at XClass delegation sa production loader. Inilalantad ng sleelactl ang mga build/run command nito at nagruruta ng XClass inspection at tahasang rendering/installation ng systemd unit sa pamamagitan ng inspect native-drive. Ang VM ay nagmamay-ari ng bounded na native-module handle table na may sapilitang host authorization at mga handle na tinitiyak ang generation. Idinaragdag na ngayon ng Syntax 3.0 ang nativeOpen, nativeCall, at nativeClose: ang append-only na bytecode dispatch ay tumatawid sa hiwalay na may-bersiyong null/bool/int64/double/UTF-8 ABI, habang nananatili sa loob ng interpreter ang mga array, struct, at iba pang composite value na pag-aari ng VM at maaaring gumamit ng bytecode fallback na may parehong pangalan. Maaaring opsyonal na tumanggap ang mga plugin ng may-bersiyong host callback table upang tumawag ng eksaktong mga SLeeLa function sa pamamagitan ng nested na VM execution, na may GC rooting ng suspended stack, tahasang allowlist ng pangalan ng host callback, at tinatanggihang recursive na native API call. Nananatiling pinagkakatiwalaang in-process code ang native code, hindi sandbox. May may-bersiyong schema ang mga source process-policy annotation ngunit hindi pa pina-parse/ipinapatupad. Mga detalye, hangganan ng seguridad, at ang ledger ng pitong workstream: Native Drive at pi-generator/AT-NATIVE.md.

XIX. Mga Pandaigdigang Edisyon ng README

Nagbibigay ang SLeeLa ng mga entry point ng README na partikular sa bansa para sa 50 pamilihan sa pandaigdigang edisyon nito. May iisang file na pinangalanang README.<CC>.md ang bawat bansa; kung may maraming wikang kaugnay, pinagpapangkat ang mga ito sa loob ng file ng bansang iyon.

Patakaran sa salin: Mga paunang lokalisadong entry point ng bansa ang mga file na ito. Lokalisado ang mga panimula at heading ng wika ng mga ito, habang nananatili sa canonical na English README.md ang kumpletong teknikal na sanggunian. Hindi dapat ilarawan na kumpletong salin ang file ng isang bansa hangga't hindi naisasalin ang bawat seksiyon, nasusuri ang mga technical identifier at link, at nagkaroon ng language review ang edisyon. Kinatawan lamang ang saklaw ng wika sa unang yugtong ito at hindi ito pahayag na lubos nang naisalin ang bawat wikang kinikilala ng konstitusyon, panrehiyon, katutubo, o sign language.

Appendix — Napanatiling Panrehiyong Gabay

Pinapanatili ng appendix na ito ang praktikal na gabay mula sa naunang maikling gabay sa Filipino na wala bilang sariling seksiyon sa canonical README. Mananaig ang canonical na English README.md sa anumang hindi pagkakatugma.

Mga target, profile, at hangganan ng pagpapatupad

Ibinubukod ng SLeeLa ang source code sa mga target ng build at execution. Kabilang sa dokumentadong target family ang SLVM, SLJVM, at SLIR; ang NATIVE ay limitado at may mga kundisyon, kaya huwag ipagpalagay na available ito sa lahat ng platform. Magkaiba ang saklaw ng BASIC_COMPLETE at ADVANCED_TOTAL. Tiyakin ang aktuwal na target, profile, at platform support sa bawat build.

Tinutukoy ng reference ang file, module, o resource; hindi ito kusang nagbibigay ng pahintulot na patakbuhin iyon. Kapag gumagamit ng files, external libraries, native bindings, o system resources ang programa, dapat malinaw ang authorization boundary at responsibilidad sa execution. Hindi sapat ang pahayag sa dokumentasyon lamang upang patunayan ang runtime security guarantee; suriin ang implementation at kaugnay na tests.

Resource lifecycle at debugging

Idokumento ang ownership, lifetime, at synchronization responsibilities ng resources na pinaghahatian ng functions o threads. Ihiwalay ang local variables, shared object state, VM handles, at serializable data. Hindi matatag na file format o network message ang VM-local handle. Gamitin ang serialization interface ng module at subukan ang invalid, missing, at boundary values.

Sa debugging, itala ang commit, OS, architecture, at toolchain. Unahin ang pinakamaliit na kaugnay na target, panatilihin ang buong error output, ihiwalay ang compiler errors sa runtime errors, at gumawa ng minimal reproducible example. Hindi pinatutunayan ng matagumpay na build lamang na tama ang runtime behavior.

Dapat ilista ng validation report ang exact commit, OS/architecture, compiler versions, kumpletong build/test commands, bilang ng pass/fail/skip, at mga kilalang limitasyon. Hindi dapat bilangin na passed ang tests na nilaktawan o hindi pinatakbo.

Katayuan ng salin: Naisalin sa Filipino ang mga seksiyon I–XIX. Pinananatili ang mga technical identifier, command, code sample, filename, link, at address. Inirerekomenda ang huling language review ng mga katutubong tagapagsalita.