Home /Modules/docs/README.MY.md

README.MY.md

docs/i18n/README.MY.md · 842 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 — Malaysia (MY)

<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>Bahasa sistem natif, pengkompil, persekitaran masa jalan dan ekosistem mesin maya.</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>

Edisi negara antarabangsa. Edisi ini disediakan dalam Bahasa Melayu (Malaysia). Pengecam teknikal, arahan, contoh kod, nama fail, laluan dan pautan tidak diubah berbanding README.md kanonik dalam bahasa Inggeris.

The Now. The Ingredient. Bahasa pengaturcaraan lebih daripada sekadar sintaks: ia ialah pengkompil, persekitaran masa jalan, pustaka, alat bantu dan kontrak platform yang menjadikan perisian boleh digunakan.

Bidang yang diceburi SLeeLa. SLeeLa menceburi Math, Object, Science dan Reach — empat wajah kerjanya: perkara yang boleh dikira (Math), benda yang telah mantap dan berdiri dalam katalog tentang apa yang ada (Object), kajian yang berdisiplin tentang yang benar (Science), dan perluasan jangkauan sesebuah sistem kepada sistem dan manusia lain (Reach). Kepentingan Nasional kekal — tiada satu pun daripada keempat-empatnya mengetepikannya; apabila sesuatu subjek menyentuh kepentingan sesebuah negara, kedudukan itu dikekalkan (direkodkan dengan setia, contohnya dalam metaOrigin / metaNationalSchedule pada Metadata setiap kelas), tidak sekali-kali dileburkan.

I. Mula di Sini

II. Berita

Tambahan terkini pada bahasa, pemacu dan pustaka standard:

III. Bina dan Uji

Prasyarat: rantai alat C/C++ (GCC atau Clang) dan GNU Make; Python 3 untuk perkakasan manifes/aliran; pada Linux, pakej pembangunan X11/Xrandr untuk produk paparan (make deps pada sesebuah modul melaporkan/memasang apa yang diperlukannya). Binaan impl/ bersifat fail-closed terhadap manifes SHA-256 yang dipercayai, yang ditunjuk secara automatik oleh Makefile akar.

Daripada checkout yang bersih, permulaan terpantas:

make                                  # build everything from the repo root

Atau bina dan uji teras natif sahaja:

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

make pada akar repositori membina setiap produk (teras, VM, codec, churn, antivirus, …) dan berakhir dengan membina registry serta mematerialkan jadual asasnya — maka pepohon yang telah dibina menyertakan registry yang boleh disemak sejak awal. Sasaran penting:

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

Sasaran berguna yang lain:

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

Sasaran registry menjalankan build-registry.sh: ia membina teras registry, menyemai jadual asas ke dalam stor teks mudah alih registry/build/sleela.sleelareg, dan mengeksport skrip jadual MySQL registry/build/registry.sql (melalui sleela registry export). Semaklah dengan sleela registry atau registry/build/sleela-registry review. Lihat panduan registry dan seni bina Registry 3.0.

Rujuk panduan binaan dan pengujian untuk prasyarat dan langkah khusus platform. Kejayaan membina satu komponen tidak membuktikan bahawa setiap pustaka atau platform sudah bersedia untuk keluaran.

IV. Pemasangan

Selepas membina produk natif, pasang arahan dan fail sokongan persekitaran masa jalan:

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

Pemasang konvensional menggunakan /usr/local/bin, /usr/local/lib/sleela dan /usr/local/share/sleela secara lalai. Ia mengekalkan konfigurasi permulaan yang sedia ada dan enggan menimpa arahan sedia ada yang tidak dijejaki. Nyahpasang hanya membuang fail yang direkodkan oleh pemasang, dengan mengekalkan konfigurasi dan data masa jalan yang tidak dijejaki.

Untuk penempatan berpandu yang tertumpu pada pakej utama sahaja — binari sleela, sleelvac dan nordshrift, pustaka standard, protokol dan modul sokongan — gunakan pemasang bersih:

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

Ia membuat satu keputusan utama (memasang pakej utama), kemudian pilihan skop, dan apabila berjaya, pemilih pilihan untuk modul peningkatan terpilih. Untuk aliran kerja penempatan interaktif dan semua pilihan pemasangan, lihat Pemasangan Pantas dan Selamat.

V. Bahasa dan Persekitaran Masa Jalan

Tatabahasa autoritatif ialah SLEELA.syntax. Repositori ini kini mendokumenkan sintaks 3.0; versi pengkompil/alat dan versi sintaks sumber ialah dua perkara yang berbeza. Permukaan 3.0 menambah penanda dokumen pure dan gasoline (§30) — sepasang Preonem kosong, kontekstual dan bersifat deklaratif sahaja yang bermaksud hampir sama, masing-masing menandakan kedudukan dokumen melalui kejujurannya sendiri. Sintaks 3.0 menyatukan permukaan bahasa 1.0–2.9 ke dalam edisi normatif semasa, dengan mengekalkan semua get minimum khusus ciri. Permukaan 2.9 sebelumnya menambah medan konsekuen @mix (§28) — sesebuah kelas boleh mengisytiharkan beberapa medan instans bernama sama apabila setiap satu membawa @mix, difahami sebagai satu kumpulan berindeks (dari atas ke bawah 1,2,3,… atau secara manual @mix(1,2,3,...) yang bilangan indeksnya mesti sama dengan kumpulan itu). Ia meneruskan keluarga integer lebar bertanda/tak bertanda asas-2 int32..int16777216 (§24) dan uint32..uint16777216 (§25) di atas long/int64/int128 yang lebih awal (§21); dokumen penyokong kata kunci (§22); dan Preonem — penanda dokumen yang bersifat deklaratif sahaja author/authorial (§18), material/memory (§19–§20), determine (§23), object/field (§26), pure/gasoline (§30), dan artifact (§35, kedudukan bertaraf badan perundangan yang digredkan terhadap masa dan ruang), yang secara kolektif bergelar Preonem (§26.1). Resolusi lebihan beban pembina serta delegasi this(...)/pembina asas secara jelas berada di luar kontrak sintaks 1.8 yang telah disahkan. Rujuk tatabahasa dan nota pelaksanaan sebelum bergantung pada sesuatu ciri. Sembilan unit sumber SleelaDoc kini mengisytiharkan #sleela 3.0; get pengkompil bersama menerima sintaks sumber 1.0–3.0. API baharu dihasilkan dengan make api-docs.

Repositori ini merangkumi pelaksanaan C/C++ natif, rujukan penjanaan SLVM, modul pustaka standard, ujian, contoh dan integrasi platform. Status pelaksanaan dan pengesahan berbeza mengikut modul; rujuklah spesifikasi dan keputusan CI terkini, jangan menganggap kelengkapan yang seragam.

VI. Prinsip Kejuruteraan

VII. Binaan Antivirus dan Integriti

Pakej antivirus Sleelavirin merangkumi pengimbas SHA-256 natif, penyesuai ClamAV pilihan, manifes integriti sumber/indeks dan hasil tambah semak pakej platform. Bina dan uji pakej itu dari akar repositori:

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

Manifes integriti dijana di bawah antivirus/build/; ia meliputi input sumber dan dokumentasi yang dijejaki serta fail indeks tandatangan yang dilindungi, dan mengecualikan output terjana serta cache ClamAV yang boleh berubah. Syot kilat pangkalan data ClamAV mempunyai manifes masing-masing. ZIP keluaran menyertakan INTEGRITY-MANIFEST.json, SHA256SUMS dan fail sampingan .sha256. Sahkan cincangan arkib yang dimuat turun berbanding nilai yang dipercayai yang diperoleh secara bebas: hasil tambah semak yang disimpan di sebelah arkib bukan tandatangan penerbit. Lihat panduan Sleelavirin, senarai semak keselamatan dan aliran kerja binaan antivirus.

Sesuatu keluaran tidak dianggap telah disahkan sehingga tugas CI yang berkaitan lulus pada commit keluaran yang tepat dan artifak yang terhasil telah disemak.

VIII. Tema Editor SLeeLa — Vim dan Emacs

SLeeLa merangkumi set skema warna gelap profesional yang diselaraskan untuk Vim dan Emacs, serta utiliti palet C/C++ natif. Skema American Professional yang asal kekal sebagai lalai. Sepuluh palet pendamping disediakan untuk pelbagai inspirasi reka bentuk budaya dan institusi; palet ini ialah palet reka bentuk interpretatif, bukan perwakilan rasmi mana-mana negara, budaya, mahkamah atau institusi.

Sebelas Skema dan Warnanya

SkemaLatar BelakangLatar DepanKata KunciJenisStringKomen
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

Warna Bendera Kebangsaan (Palet Sumber)

Skema Yunani dan Turki diperoleh daripada warna bendera kebangsaan rasmi kedua-dua negara, yang ditunjukkan di sini dengan nilai perenambelasan yang diterbitkan secara tepat. Latar belakang/aksen skema di atas ialah tafsiran yang digelapkan dan mesra editor bagi warna sumber ini — jadual di bawah ialah rujukan "warna sebagaimana diterbitkan secara kebangsaan".

NegaraWarnaPerenambelasanAsas dan makna
YunaniBiru<span style="display:inline-block;width:1em;height:1em;background:#0D5EAF;border:1px solid #888"></span> #0D5EAFBiru bendera kebangsaan (Undang-Undang 851/1978). Langit dan laut; dalam blazon heraldik disebut azure.
YunaniPutih<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFPutih bendera kebangsaan. Kesucian perjuangan kemerdekaan; salib melambangkan agama Kristian Ortodoks Timur.
TürkiyeMerah (al bayrak)<span style="display:inline-block;width:1em;height:1em;background:#E30A17;border:1px solid #888"></span> #E30A17Merah bendera kebangsaan (Undang-Undang Bendera Türkiye). Medan bendera; menurut tradisi melambangkan darah para syuhada dan kedaulatan Uthmaniyah.
TürkiyePutih<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFPutih bendera kebangsaan. Bulan sabit dan bintang — keamanan, kesucian dan simbol warisan Turkik/Islam.

Skema ini menambat latar depan setiap editor pada putih kebangsaan, serta kata kunci, kursor, pemilihan dan baris status pada biru kebangsaan (#0D5EAF) atau merah kebangsaan (#E30A17) yang tepat, supaya warna yang penting benar-benar ialah warna kebangsaan. Ini ialah palet reka bentuk interpretatif; rujukan warna bendera disediakan demi asal usul dan bukan perwakilan rasmi kedua-dua negara. Makna warna mengikut huraian simbol negara daripada Kementerian Luar Republik Hellenik dan tradisi Undang-Undang Bendera Türkiye.

Jadual Swatch Warna

Sel palet di bawah menggunakan swatch SVG, supaya GitHub memaparkan warna sebenar dan bukan sel warna HTML yang kosong. Setiap jalur menunjukkan enam warna dalam susunan ini: latar belakang, latar depan, kata kunci, jenis, string dan komen. Kod perenambelasan yang tepat disenaraikan di sebelah setiap swatch, mengikut susunan skema yang sama seperti jadual rujukan di atas.

SkemaWarna palet yang dipaparkanKod perenambelasan (latar belakang · latar depan · kata kunci · jenis · string · komen)
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

Warna aksen tambahan digunakan untuk fungsi, pemalar, pemilihan, diagnostik dan arahan prapemproses. Palet Rusia dan Slavik dengan sengaja menggunakan kelabu batu loh, biru, hijau sage, delima dan emas antik berintensiti sederhana untuk rupa profesional yang lebih tenang.

Memasang Skema Vim

Dari akar repositori:

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/

Tambahkan yang berikut ke dalam ~/.vimrc untuk mengaktifkan penyerlahan sintaks SLeeLa dan memilih skema:

syntax enable
set background=dark
colorscheme sleela-american

Pilih tepat satu daripada nama colorscheme berikut:

Sebagai contoh, gunakan colorscheme sleela-russian-slavic untuk palet Rusia dan Slavik berintensiti sederhana, atau colorscheme sleela-greek / colorscheme sleela-turkish untuk palet Hellenik dan Al Bayrak. Mulakan semula Vim atau muatkan konfigurasi anda dengan :source $MYVIMRC.

Memasang Skema Emacs

Cipta direktori tema setempat dan salin fail mod serta tema dari akar repositori:

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/

Tambahkan ini ke dalam ~/.emacs atau ~/.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)

Gantikan sleela-american dengan sleela-eurasia, sleela-russian-slavic, sleela-silk-road, sleela-east-asian, sleela-greek, sleela-turkish, sleela-kiro atau sleela-sleela untuk memilih skema lain. Jika Emacs bertanya sama ada tema itu dipercayai, semak fail tema setempat sebelum menerimanya.

Pratonton Palet C/C++ Natif

Utiliti palet natif yang kecil boleh menyenaraikan skema, mencetak warna terminalnya dan mencari satu warna individu:

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

Demi keserasian ke belakang, --palette dan --hex COLOR tanpa --theme memilih American Professional. Hasil binaan dan ujian hendaklah disemak pada sistem sasaran dan CI; dokumentasi sesuatu arahan bukanlah bukti bahawa arahan itu lulus.

Lihat panduan integrasi editor untuk huraian palet penuh dan butiran utiliti.

IX. Sumbangan

  1. Baca indeks dokumentasi dan dasar pengujian.
  2. Buat perubahan yang tertumpu bersama ujian positif dan negatif.
  3. Jalankan ujian yang disasarkan, kemudian rangkaian ujian yang menyeluruh.
  4. Laporkan butiran OS/rantai alat; jangan menyatakan pemeriksaan yang dilangkau sebagai lulus.

SLeeLa dibangunkan oleh MEARVK LLC. Bahan muka depan bersejarah dikekalkan di docs/README-LEGACY.md.

X. AE6E66 — Jangkaan Levi ke atas E-mel Round Public

Bagi inisiatif AE6E66, jangkaan yang dinyatakan projek ialah $300,000,000.00 USD bagi setiap e-mel Round Public sebagai jumlah levi cukai yang dicadangkan berkaitan dengan setiap e-mel Round Public yang layak.

Kenyataan ini hanya merekodkan jangkaan projek. Ia bukan taksiran cukai yang sah, perintah kerajaan, keputusan mahkamah atau liabiliti cukai yang ditetapkan secara bebas. Sebarang levi sebenar memerlukan pihak berkuasa undang-undang yang berwibawa, bidang kuasa, takrifan, prosedur dan penetapan kerajaan yang berwibawa.

XI. Persekitaran Masa Jalan Abjad dan Set Aksara

Dokumentasi abjad SLeeLa dan persekitaran masa jalan aksara natif diselenggara di alphabet/sleela/ dan lib/alphabet/native/. Ujian C++17 natif merangkumi penyahkodan/pengekodan skalar UTF-8 yang ketat, tandatangan kapasiti C<n>, dan keahlian set aksara yang dihadkan:

make -C lib/alphabet/native test

Katalog UTF-4088 yang bersifat eksperimen dan penyesuai carian SLeeLa-nya didokumentasikan di utf-4088/SLeeLa-ALPHABET-INTEGRATION.md. ID UTF-4088 ialah ruang nama tersendiri, bukan nilai skalar Unicode. Kerja pengikatan pengkompil dan SLVM dijejaki secara berasingan dan jelas daripada asas natif ini.

XII. AutoCAD Creator™

AutoCAD Creator™ ialah aplikasi CAD 2D interaktif yang ditulis sepenuhnya dalam SLeeLa. Jika AutoCAD Renderer yang sepasang dengannya menukarkan pelan lantai kepada lukisan secara sekali jalan, Creator membolehkan anda mencipta dan mengubah dokumen AutoCAD 2D secara langsung — menambah dinding, bilik, dimensi dan nota, kemudian mengalih, melabel semula, memindahkan lapisan, memadam dan membuat asal (undo) apa yang telah anda letakkan — dan menyimpan hasilnya sebagai lukisan AutoCAD DXF yang sebenar (teks R12, boleh dibuka dalam AutoCAD / LibreCAD).

Antara muka grafiknya dibina di atas SleelaUI™, kit alat UI merentas platform milik SLeeLa sendiri (di bawah lib/user-interface) — bukan JavaFX — yang memunculkan tetingkap natif sebenar pada X11 / Cocoa / Win32. Reka bentuknya mengikut satu peraturan, "SleelaUI memaparkan; SLeeLa memutuskan": GUI tidak sekali-kali mengira geometri atau menulis DXF. Setiap alat mengeluarkan hasrat create / alter / delete / undo / save kepada SLCadCreator yang berautoriti, yang memiliki dokumen boleh sunting dan sejarah arahan yang boleh diundurkan, manakala kanvas hanya mempratonton geometri yang dipegang oleh Creator.

Enjin penyuntingan yang boleh digunakan semula terletak di lib/autocad — SLCadEntity, SLCadDocument, SLCadCommand dan SLCadCreator — dan berjalan dari hujung ke hujung tanpa paparan (headless). Shell GUI dan demonya terletak di autocad/creator:

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

Pada mesin yang mempunyai paparan, ini membuka tetingkap penyuntingan langsung; pada hos headless, ia membina lukisan dalam memori, mencetak laporan beserta DXF-nya, dan keluar dengan bersih.

XIII. Pengisihan Peta Input UTF-4088

Katalog UTF-4088 yang khusus mentakrifkan penelusuran peta input spatial dan lelaran tekanan abstraknya dalam utf-4088/INPUT-MAP-AND-PRESSURE.md. Dasar indeks subjek National Lien terdapat dalam utf-4088/NATIONAL-LIEN-REGISTER.md. Koordinat peta, peringkat tekanan (1–50), ID katalog kekal dan kedudukan abjad ialah medan yang bebas; tiada satu pun boleh digantikan secara senyap oleh yang lain. Tekanan ialah peringkat lelaran algoritma, bukan kuantiti fizikal.

XIV. Indeks Pakej Terkini dan Yang Diperluas

Indeks tambahan ini menyerlahkan pakej, pustaka domain dan koleksi sumber yang baru-baru ini diperluas. Entri dikumpulkan mengikut abjad berdasarkan nama pakej atau topik. Huraian menunjukkan lokasi dalam repositori; status pelaksanaan dan pengesahan hendaklah disemak pada dokumentasi dan ujian setiap pakej.

A–C

D–G

H–I

O–S

U–W

Penyelenggaraan Indeks Pakej

Apabila sesebuah pakej ditambah atau diperluas secara ketara, tambahkan entrinya di sini pada kumpulan abjad yang sesuai, pautkan ke direktori dan README kanoniknya, dan huraikan hanya keupayaan yang disokong oleh sumber yang telah di-check-in. Kekalkan indeks ini bersifat tambahan: jangan membuang atau menulis semula bahagian README sedia ada sebagai sebahagian daripada kemas kini indeks pakej.


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

Demokratik A.S. dan Dasar A.S.


XVI. Imej Jenama 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. Katalog Eksperimen UTF-4088 Sejuta Entri

Penjana katalog UTF-4088 membina secara deterministik katalog simbol eksperimen yang mengandungi 1,048,576 entri. Format padat yang didokumenkan diterangkan dalam utf-4088/FORMAT.md; kontrak penjanaan dan pengesahannya terdapat di utf-4088/GENERATION-RESULTS.md.

Jalankan penjana dengan Python 3:

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

Binari yang dihasilkan bersaiz 16,777,244 bait dan direka supaya kekal di bawah 20,000,000 bait. Ujian unit dan aliran kerja GitHub Actions mengesahkan bilangan entri, keunikan glif, saiz dan SHA-256; larian yang berjaya menerbitkan binari dan ringkasannya sebagai artifak aliran kerja utf4088-million-catalogue. Binari yang dijana sengaja tidak disimpan dalam sejarah Git. UTF-4088 kekal bersifat eksperimen dan tidak serasi dengan 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. Tambahan Terkini — Pemalar Pi, Permulaan Modium/Registry, Matematik sleelactl dan @native

Bahagian ini merekodkan ciri yang ditambah semasa kerja 2026-11, dengan kumpulan terbaharu dahulu. Fail sumber yang dipautkan dan status pengesahannya bersifat autoritatif; perubahan yang masih dalam semakan tidak diterangkan sebagai telah digabungkan sehingga ia sampai ke master.

Pemalar katalog Pi 100,000,000 digit

Repositori ini menyertakan nilai π seratus juta digit yang telah disahkan di pi-generator/pi.100000000.digits (perpuluhan yang terbentuk dengan baik, 3.14159…), bersama nilai 57,344 digit di pi-generator/pi.57344.digits. Kedua-duanya disahkan secara bebas sebagai π yang tulen — lihat pi-generator/VERIFIED.md, yang mendokumentasikan semakannya (awalan buku teks, titik Feynman pada kedudukan pecahan 762, digit sejutaan yang terkenal, kesepadanan dengan lib/math/SLPiReference.sleela, dan analisis kekerapan digit seluruh fail) serta skrip pengulangan sekali jalan.

Modium™ / Registry™ memuatkan pemalar Pi semasa permulaan subsistem

Pada titik masuk subsistem yang khusus — sleela registry dan sleela modium (serta larian pertama pemasang), bukan pada setiap sleela run — subsistem Modium dan Registry memuatkan pemalar katalog π yang besar. Pada terminal interaktif, kedua-duanya mencetak baris merah sementara Loading Modium™ / Loading Registry™ yang kemudian dipadam di tempat sebelum output biasa bermula; kesan ini terhad sepenuhnya kepada TTY, maka output paip dan output ujian kekal serupa bait demi bait. Pencari lokasi (bukan bait-baitnya) disemai sebagai lalai kunci Math registry piReferenceLargePath dan piReferenceLargeDigits, dalam model SLeeLa (lib/registry/SLRegistry.sleela) dan penyemai natif (registry/sleela_registry.c); lib/math/SLPiReference.sleela mendedahkan largePath() / largeDigits(). Pemalar π dipasang ke lokasi SLeeLa OS (<data>/pi/) oleh kedua-dua pemasang make piawai dan pemasang "beautiful" berpandu. Butiran: pi-generator/MODIUM-REGISTRY-PI-STARTUP.md.

sleelactl — pemasang beautiful dan subjek math berasaskan natif

@native, Native Drive dan pelaksanaan berbilang bahasa

Anotasi kaedah @native yang baharu meminta kompilasi natif awal masa (ahead-of-time) bagi kaedah yang panas (hot). Arahan sleela aot yang baharu mencari kaedah @native, mengesahkan bahawa setiap satu berada dalam subset yang boleh dipunggah yang disokong, dan menjana C/C++ — gagal secara tertutup (menolak, dengan sebab yang tepat) pada sebarang binaan yang belum dapat diterjemahkannya, supaya kaedah yang separuh diterjemah tidak sekali-kali dihasilkan.

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 kekal sebagai permintaan layanan AOT, dengan binaan yang tidak disokong ditolak sebelum penjanaan. Native Drive menyokong binaan boleh laksana dan pustaka kongsi C/C++ berbilang unit melalui pengkompil hos (termasuk MSVC), output AOT SLeeLa yang disokong, pemeriksaan simbol terhadap ABI native-loader, pelaksanaan proses tanpa shell, pengendalian stdin/stdout/stderr, penyaluran berbilang peringkat, dan delegasi XClass kepada pemuat pengeluaran. sleelactl mendedahkan arahan bina/jalannya dan menyalurkan pemeriksaan XClass serta pemaparan/pemasangan unit systemd yang jelas melalui inspect native-drive. VM mempunyai jadual handle modul natif yang dihadkan dengan kebenaran hos yang wajib dan handle yang disemak generasinya. Sintaks 3.0 kini menambah nativeOpen, nativeCall dan nativeClose: penghantaran bytecode append-only merentasi ABI null/bool/int64/double/UTF-8 yang berversi secara berasingan, manakala tatasusunan, struct dan nilai komposit lain milik VM kekal di dalam pentafsir dan boleh menggunakan fallback bytecode yang bernama sama. Pemalam boleh menerima secara pilihan jadual panggil balik hos berversi untuk memanggil fungsi SLeeLa yang tepat melalui pelaksanaan VM bersarang, dengan GC rooting bagi tindanan yang digantung, senarai benar nama panggil balik hos yang jelas, dan panggilan API natif rekursif ditolak. Kod natif kekal sebagai kod dipercayai dalam proses, bukan kotak pasir. Anotasi dasar proses pada sumber mempunyai skema berversi tetapi belum diurai/dikuatkuasakan. Butiran, sempadan keselamatan dan lejar tujuh aliran kerja: Native Drive dan pi-generator/AT-NATIVE.md.

XIX. Edisi README Antarabangsa

SLeeLa menyediakan titik masuk README khusus negara untuk 50 pasaran dalam edisi antarabangsanya. Setiap negara mempunyai satu fail bernama README.<CC>.md; apabila beberapa bahasa relevan, bahasa-bahasa itu dikumpulkan dalam fail negara tersebut.

Dasar terjemahan: Fail-fail ini ialah titik masuk negara yang dilokalkan pada peringkat awal. Pengenalan dan tajuk bahasanya dilokalkan, manakala rujukan teknikal lengkap kekal dalam README.md kanonik berbahasa Inggeris. Fail negara tidak boleh disifatkan sebagai terjemahan lengkap sebelum setiap bahagian diterjemahkan, pengecam teknikal dan pautan disemak, dan edisi tersebut telah melalui semakan bahasa. Liputan bahasa pada fasa pertama ini bersifat mewakili dan bukan dakwaan bahawa setiap bahasa yang diiktiraf dari segi perlembagaan, bahasa wilayah, bahasa orang asli atau bahasa isyarat telah diterjemahkan sepenuhnya.

Lampiran — Panduan Serantau yang Dikekalkan

Lampiran ini mengekalkan bahan praktikal daripada panduan Bahasa Melayu sebelumnya yang tidak terdapat sebagai bahagian tersendiri dalam README kanonik. Bahan ini tidak menggantikan README kanonik; jika terdapat perbezaan, README.md kanonik berbahasa Inggeris dan SLEELA.syntax menjadi rujukan. Panduan sebelumnya tidak mengandungi catatan khusus tentang bahasa daerah atau bahasa isyarat, maka tiada apa-apa yang ditambah mengenainya.

Pengkompil, representasi dan mesin maya

Saluran kompilasi SLeeLa memisahkan bahasa sumber, analisis frontend, representasi perantaraan, penjanaan kod dan pelaksanaan masa jalan. Pemisahan ini penting: versi pengkompil, versi sintaks dan versi VM/ISA ialah penanda yang berbeza. Semak pengisytiharan versi pada sumber dan spesifikasi yang terpakai sebelum menganggap sesuatu ciri tersedia.

Secara konsepnya, aliran kerjanya merangkumi:

  1. Sumber: fail UTF-8 .sleela dengan pragma versi dan pengisytiharan.
  2. Lexer dan parser: menukarkan teks kepada token dan struktur sintaks.
  3. Analisis semantik: menyemak nama, simbol, jenis dan peraturan bahasa.
  4. Representasi perantaraan: bentuk program berstruktur untuk proses lowering seterusnya.
  5. Penjanaan kod: output bagi sasaran VM atau perantaraan yang disokong.
  6. Masa jalan: pelaksanaan program terkompil dengan mekanisme memori dan aliran kawalan yang tersedia.

Butiran pelaksanaan boleh berubah. Ciri yang tersenarai dalam spesifikasi tidak semestinya tersedia pada setiap sasaran. Rujukan normatif ialah SLEELA.syntax; untuk format sumber dan kitar hayat fail, lihat dokumentasi sumber dan dokumentasi pengkompil.

Jenis data dan model objek

Kosa kata jenis sumber merangkumi int, double, boolean, String, void, jenis struct yang diisytiharkan dan tandatangan jenis rujukan yang disokong. Dalam model yang didokumenkan sekarang, int, long dan int64 ialah integer bertanda 64-bit. int128 diterima sebagai jenis integer tetapi belum patut dianggap sebagai aritmetik 128-bit penuh.

struct ialah agregat bernama yang mengandungi medan. Handle struct yang diurus VM bukan penuding mentah. Tugasan dan penghantaran parameter berkongsi instans yang sama; kesamaan adalah berdasarkan identiti. Untuk pertukaran mudah alih, gunakan fungsi bersiri yang didokumenkan seperti structPack(instance) dan structUnpack(TypeName, json); handle yang terikat kepada VM bukan nilai rangkaian mudah alih.

Kelas mengandungi medan dan kaedah. Dalam model pelaksanaan semasa, medan ialah keadaan kelas yang dikongsi manakala pemboleh ubah setempat kaedah adalah khusus kepada thread. Pewarisan, kelas bersarang dan generik tertakluk pada get versi sintaks. Rujuk International Language Reference.

Aliran kawalan dan pemasaan gelung

Anotasi peringkat pernyataan @loopDelay dan @loopBudget menetapkan jeda atau belanjawan masa bagi gelung, diletakkan sebelum gelung dan diturunkan kepada arahan VM OP_SLEEP (ISA 157). Fungsi terbina dalam sleep(ms) menggunakan arahan yang sama. Lihat SLEELA.syntax §32 dan Loop Timing API.

Integriti, keselamatan dan pengesahan

SLeeLa menekankan kebolehjejakan antara sumber, dokumentasi, proses binaan dan keputusan ujian. Manifes cincangan dan alat pengesahan boleh menyemak sama ada fail sepadan dengan kandungan yang dijangka. Keputusan pemeriksaan hanya terpakai bagi skop dan masa pemeriksaan yang dinyatakan.

Prinsip penting:

Sasaran, profil dan sempadan pelaksanaan

SLeeLa memisahkan kod sumber daripada sasaran binaan dan pelaksanaan. Keluarga sasaran yang didokumenkan merangkumi SLVM, SLJVM dan SLIR; NATIVE ialah sasaran terhad dan bersyarat, bukan mod yang boleh dianggap tersedia pada semua platform. Profil BASIC_COMPLETE dan ADVANCED_TOTAL menunjukkan skop yang berbeza. Sahkan sasaran, profil dan sokongan platform yang benar-benar digunakan pada setiap binaan.

Rujukan mengenal pasti fail, modul atau sumber; rujukan tidak dengan sendirinya memberikan kebenaran untuk melaksanakannya. Apabila program menggunakan fail, pustaka luaran, native bindings atau sumber sistem, sempadan kebenaran dan tanggungjawab pelaksanaan mesti ditetapkan dengan jelas. Pernyataan dalam dokumentasi sahaja bukan bukti jaminan keselamatan masa jalan; semak pelaksanaan dan ujian yang berkaitan.

Kitar hayat sumber dan penyahpepijatan

Dokumentasikan pemilikan, jangka hayat dan tanggungjawab penyegerakan bagi sumber yang dikongsi antara fungsi atau thread. Bezakan pemboleh ubah setempat, keadaan objek kongsi, handle VM dan data boleh bersiri. Handle setempat VM bukan format fail atau mesej rangkaian yang stabil. Gunakan antara muka pensirian yang ditakrifkan oleh modul, dan uji nilai tidak sah, tiada serta sempadan.

Semasa menyahpepijat, rekodkan commit, OS, seni bina dan rantai alat. Bina sasaran berkaitan yang terkecil dahulu, simpan output ralat penuh, bezakan ralat pengkompil daripada ralat masa jalan, dan hasilkan contoh minimum yang boleh diulang. Binaan yang berjaya tidak dengan sendirinya membuktikan tingkah laku masa jalan yang betul.

Laporan pengesahan hendaklah menyatakan commit yang tepat, OS/seni bina, versi pengkompil, arahan bina/ujian penuh, bilangan pass/fail/skip dan batasan yang diketahui. Ujian yang dilangkau atau tidak dijalankan tidak boleh dikira sebagai lulus.

Kontrak API modul, keserasian dan strategi pengujian

Apabila API baharu diperkenalkan, dokumentasikan input, output, keadaan ralat, pemilikan data dan sama ada operasi menghasilkan kesan sampingan. Contoh dokumentasi hendaklah menunjukkan penggunaan biasa serta pengendalian input tidak sah atau tiada. Jangan menyatakan sesuatu tingkah laku sebagai jaminan jika pelaksanaan dan ujian belum mengesahkannya.

Asingkan ujian mengikut peringkat saluran pengkompil: lexing/parsing, analisis semantik, IR lowering, penjanaan kod, pelaksanaan VM dan integrasi natif. Bagi setiap kes regresi, simpan input minimum yang boleh diulang, hasil yang dijangka dan hasil sebenar. Perubahan API mesti menerangkan keserasian ke belakang, langkah migrasi dan kesannya terhadap contoh sedia ada.

Penyetempatan, pengekodan dan kebolehbacaan

Kekalkan pengecam teknikal, arahan, laluan, sintaks dan blok kod dalam bentuk yang sama merentas bahasa. Terjemahkan teks penerangan, bukan token atau nama yang digunakan dalam kod sumber. Nyatakan bahasa dan konteks wilayah dengan jelas; istilah Bahasa Melayu boleh berbeza mengikut komuniti dan negara. Edisi Malaysia ini menggunakan Bahasa Melayu sebagai bahasa utama; istilah teknikal boleh dikekalkan dalam bahasa Inggeris apabila terjemahan akan mengaburkan nama API, konsep pengkompil atau arahan. Sumbangan istilah tempatan digalakkan melalui glosari yang konsisten dan semakan penutur jati yang memahami bidang teknikal.

Selepas setiap kemas kini, periksa pautan Markdown, hierarki tajuk, pagar kod dan contoh. Apabila dokumen kanonik bahasa Inggeris berubah, bandingkan bahagian berkaitan dan kemas kini terjemahan secara menyeluruh, bukan sekadar pengenalan. Tandakan kandungan yang belum disemak oleh penutur jati atau penyemak teknikal.

Status terjemahan: Bahagian I–XIX diterjemahkan ke dalam Bahasa Melayu (Malaysia). Pengecam teknikal, arahan, contoh kod, nama fail, pautan dan alamat dikekalkan. Semakan bahasa akhir oleh penutur jati disyorkan.