Home /Modules/docs/README.IN.md

README.IN.md

docs/i18n/README.IN.md · 561 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 — भारत (IN)

<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>एक native systems भाषा, compiler, runtime और virtual-machine ecosystem।</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>

International देश संस्करण। यह संस्करण हिन्दी में है। तकनीकी identifiers, commands, code उदाहरण, फ़ाइल नाम, paths और links कैनोनिकल अंग्रेज़ी README.md की तुलना में अपरिवर्तित हैं।

The Now. The Ingredient. भाषा केवल syntax नहीं है: वह compiler, runtime, libraries, tools और platform contracts का समुच्चय है, जो software को उपयोगी बनाते हैं।

SLeeLa किन क्षेत्रों से जुड़ा है। SLeeLa Math, Object, Science और Reach से जुड़ा है — ये उसके कार्य के चार पक्ष हैं: गणना-योग्य (Math), जो कुछ है उसकी सूची में खड़ी स्थिर वस्तु (Object), सत्य का अनुशासित अध्ययन (Science), और किसी system के हाथ का अन्य systems तथा लोगों तक विस्तार (Reach)। राष्ट्रीय हित बने रहते हैं — इन चारों में से कोई भी उन्हें परे नहीं हटाता; जहाँ कोई विषय किसी राष्ट्र के हित से संबंधित है, वहाँ वह स्थिति सुरक्षित रखी जाती है (निष्ठापूर्वक दर्ज की जाती है, उदाहरणतः प्रत्येक class के Metadata metaOrigin / metaNationalSchedule में), कभी विलीन नहीं की जाती।

I. यहाँ से शुरू करें

II. समाचार

भाषा, drivers और standard library में हाल की वृद्धियाँ:

III. Build और Test

पूर्वापेक्षाएँ: एक C/C++ toolchain (GCC या Clang) और GNU Make; manifest/flow tooling के लिए Python 3; Linux पर display products के लिए X11/Xrandr development packages (किसी module का make deps बताता/स्थापित करता है कि उसे क्या चाहिए)। impl/ build विश्वसनीय SHA-256 manifest पर fail-closed है, जिसकी ओर root Makefile स्वतः संकेत करती है।

साफ़ checkout से सबसे तेज़ शुरुआत:

make                                  # build everything from the repo root

या केवल native core को build और test करें:

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

Repo-root का make प्रत्येक product (core, VM, codecs, churn, antivirus, …) बनाता है और अंत में registry बनाकर उसकी baseline table तैयार करता है — इस तरह बना हुआ tree अपने साथ समीक्षा-योग्य registry तैयार रूप में देता है। आवश्यक targets:

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

अन्य उपयोगी targets:

make registry            # just the registry: build + materialize the table
./build-registry.sh      # same thing, invoked directly
make tests               # build and run the test suite
make ballum              # build the Ballum display library for this OS (see ballum/)
bin/install-modules      # paced install/build of each module over ~10-20 min (see bin/)

registry target build-registry.sh चलाता है: यह registry core बनाता है, baseline table को portable text store registry/build/sleela.sleelareg में भरता है, और MySQL table script registry/build/registry.sql निर्यात करता है (sleela registry export के माध्यम से)। इसकी समीक्षा sleela registry या registry/build/sleela-registry review से करें। देखें registry guide और Registry 3.0 architecture।

पूर्वापेक्षाओं और platform-विशिष्ट चरणों के लिए build तथा testing guides देखें। किसी एक component का सफल build यह सिद्ध नहीं करता कि प्रत्येक library या platform release के लिए तैयार है।

IV. Install

Native products बनाने के बाद commands और runtime support files install करें:

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

परंपरागत installer डिफ़ॉल्ट रूप से /usr/local/bin, /usr/local/lib/sleela और /usr/local/share/sleela का उपयोग करता है। यह मौजूदा startup configuration को सुरक्षित रखता है और बिना track किए मौजूद commands को overwrite करने से इनकार करता है। Uninstall केवल installer द्वारा दर्ज फ़ाइलें हटाता है, configuration और untracked runtime data को सुरक्षित रखते हुए।

केवल मुख्य package — sleela, sleelvac और nordshrift binaries, standard library, protocols और support modules — की केंद्रित, निर्देशित deployment के लिए clean installer का उपयोग करें:

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

यह एक प्राथमिक निर्णय लेता है (मुख्य package install करना), फिर दायरे का चयन, और सफल होने पर चुने हुए enhancement modules के लिए वैकल्पिक picker। interactive deployment workflow और सभी installation विकल्पों के लिए Quick and Safe Install देखें।

V. भाषा और Runtime

प्रामाणिक grammar SLEELA.syntax है। वर्तमान repository syntax 3.0 को दस्तावेज़ित करता है; compiler/tool version और source syntax version अलग-अलग हैं। 3.0 surface pure और gasoline document markers (§30) जोड़ता है — bare, संदर्भाश्रित, केवल-घोषणात्मक Preonems की एक जोड़ी, जिनका अर्थ लगभग समान है, और प्रत्येक अपनी ईमानदारी से document की स्थिति चिह्नित करता है। Syntax 3.0 1.0–2.9 भाषा surface को वर्तमान normative संस्करण में समेकित करता है, और सभी feature-विशिष्ट न्यूनतम gates सुरक्षित रखता है। पूर्ववर्ती 2.9 surface @mix consequent fields (§28) जोड़ता है — कोई class एक ही नाम के कई instance fields घोषित कर सकती है, यदि प्रत्येक पर @mix हो, जिसे एक अनुक्रमित समूह के रूप में समझा जाता है (ऊपर से नीचे 1,2,3,… या मैन्युअल @mix(1,2,3,...), जिसकी index संख्या समूह से मेल खानी चाहिए)। यह पहले के long/int64/int128 (§21) के ऊपर base-2 signed/unsigned wide-integer परिवार int32..int16777216 (§24) और uint32..uint16777216 (§25) को आगे ले जाता है; keyword supporter documents (§22); और Preonems — केवल-घोषणात्मक document markers author/authorial (§18), material/memory (§19–§20), determine (§23), object/field (§26), pure/gasoline (§30) और artifact (§35, समय और स्थान के अनुसार श्रेणीबद्ध विधायिका-स्तरीय स्थिति), जिन्हें सामूहिक रूप से Preonems कहा गया है (§26.1)। Constructor overload resolution और this(...)/base-constructor delegation स्पष्ट रूप से verified syntax 1.8 contract के बाहर हैं। किसी feature पर निर्भर होने से पहले grammar और implementation notes देखें। SleelaDoc की नौ source units अब #sleela 3.0 घोषित करती हैं; साझा compiler gate source syntax 1.0–3.0 स्वीकार करता है। नया API build make api-docs से बनता है।

Repository में native C/C++ implementation, SLVM generation references, standard-library modules, tests, examples और platform integrations शामिल हैं। Implementation और validation की स्थिति module के अनुसार भिन्न होती है; समान पूर्णता मान लेने के बजाय उसका specification और वर्तमान CI परिणाम देखें।

VI. Engineering सिद्धांत

VII. Antivirus Build और Integrity

Sleelavirin antivirus package में native SHA-256 scanner, वैकल्पिक ClamAV adapter, source/index integrity manifests और platform-package checksums शामिल हैं। Repository root से package को build और test करें:

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

Integrity manifest antivirus/build/ के अंतर्गत बनता है; इसमें tracked source और documentation inputs तथा संरक्षित signature-index फ़ाइलें आती हैं, जबकि generated output और परिवर्तनीय ClamAV cache को छोड़ा जाता है। ClamAV database snapshots के अपने manifests होते हैं। Release ZIPs में INTEGRITY-MANIFEST.json, SHA256SUMS और .sha256 sidecar शामिल होते हैं। डाउनलोड किए गए archive के hashes को स्वतंत्र रूप से प्राप्त विश्वसनीय मान से मिलाएँ: archive के बगल में रखा checksum publisher का signature नहीं है। देखें Sleelavirin guide, security checklist और antivirus build workflow।

कोई release तब तक verified नहीं माना जाता जब तक संबंधित CI jobs ठीक उसी release commit पर पास न हों और परिणामी artifacts की जाँच न हो चुकी हो।

VIII. SLeeLa Editor Themes — Vim और Emacs

SLeeLa में Vim और Emacs के लिए पेशेवर dark color schemes का एक समन्वित समूह तथा एक native C/C++ palette utility शामिल है। मूल American Professional scheme डिफ़ॉल्ट बना रहता है। विभिन्न सांस्कृतिक और संस्थागत design प्रेरणाओं के लिए दस सहयोगी palettes उपलब्ध हैं; ये व्याख्यात्मक design palettes हैं, किसी राष्ट्र, संस्कृति, न्यायालय या संस्था का आधिकारिक प्रतिनिधित्व नहीं।

ग्यारह Schemes और उनके रंग

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

राष्ट्रीय ध्वज के रंग (स्रोत palette)

Greek और Turkish schemes दोनों देशों के आधिकारिक राष्ट्रीय ध्वज रंगों से व्युत्पन्न हैं, जिन्हें यहाँ उनके प्रकाशित सटीक hex मानों के साथ दिखाया गया है। ऊपर के scheme backgrounds/accents इन स्रोत रंगों की गहरी, editor-अनुकूल व्याख्याएँ हैं — नीचे की तालिका "राष्ट्रीय रूप से प्रदर्शित रंगों" का संदर्भ है।

राष्ट्ररंगHexआधार और अर्थ
Greeceनीला<span style="display:inline-block;width:1em;height:1em;background:#0D5EAF;border:1px solid #888"></span> #0D5EAFराष्ट्रीय ध्वज का नीला (Law 851/1978)। आकाश और समुद्र; heraldry में azure के रूप में वर्णित।
Greeceसफ़ेद<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFराष्ट्रीय ध्वज का सफ़ेद। स्वतंत्रता संग्राम की पवित्रता; क्रॉस पूर्वी ऑर्थोडॉक्स ईसाई धर्म का प्रतीक है।
Türkiyeलाल (al bayrak)<span style="display:inline-block;width:1em;height:1em;background:#E30A17;border:1px solid #888"></span> #E30A17राष्ट्रीय ध्वज का लाल (Turkish Flag Law)। पृष्ठभूमि; परंपरा से शहीदों का रक्त और Ottoman संप्रभुता।
Türkiyeसफ़ेद<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFराष्ट्रीय ध्वज का सफ़ेद। अर्धचंद्र और तारा — शांति, पवित्रता और तुर्क/इस्लामी विरासत का प्रतीक।

ये schemes प्रत्येक editor के foreground को राष्ट्रीय सफ़ेद पर, तथा उसके keywords, cursor, selection और status line को सटीक राष्ट्रीय नीले (#0D5EAF) या लाल (#E30A17) पर आधारित करती हैं, ताकि जो रंग महत्त्वपूर्ण हैं वे सचमुच राष्ट्रीय रंग हों। ये व्याख्यात्मक design palettes हैं; ध्वज-रंग संदर्भ उत्पत्ति (provenance) के लिए दिया गया है और किसी भी राज्य का आधिकारिक प्रतिनिधित्व नहीं है। रंगों के अर्थ Hellenic Republic MFA के राज्य-प्रतीकों के वर्णन और Turkish Flag Law की परंपरा का अनुसरण करते हैं।

Color Swatch तालिका

नीचे की palette कोशिकाएँ SVG swatches का उपयोग करती हैं, ताकि GitHub खाली HTML color cells के बजाय वास्तविक रंग दिखाए। प्रत्येक पट्टी छह रंगों को इस क्रम में दिखाती है: background, foreground, keywords, types, strings और comments। सटीक hex codes प्रत्येक swatch के पास, ऊपर की संदर्भ तालिका के समान scheme क्रम में सूचीबद्ध हैं।

Schemeप्रदर्शित palette रंगHex codes (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

अतिरिक्त accent रंग functions, constants, selections, diagnostics और preprocessor directives के लिए उपयोग किए जाते हैं। Russian and Slavic palette जान-बूझकर मध्यम-तीव्रता वाले slate, नीले, sage, माणिक (ruby) और प्राचीन स्वर्ण रंगों का उपयोग करती है, ताकि अधिक शांत पेशेवर रूप मिले।

Vim Schemes install करें

Repository root से:

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/

SLeeLa syntax highlighting सक्षम करने और scheme चुनने के लिए ~/.vimrc में निम्नलिखित जोड़ें:

syntax enable
set background=dark
colorscheme sleela-american

इन colorscheme नामों में से ठीक एक चुनें:

उदाहरण के लिए, मध्यम Russian and Slavic palette के लिए colorscheme sleela-russian-slavic उपयोग करें, या Hellenic और Al Bayrak palettes के लिए colorscheme sleela-greek / colorscheme sleela-turkish। Vim को पुनः आरंभ करें या :source $MYVIMRC से अपना configuration source करें।

Emacs Schemes install करें

एक स्थानीय theme directory बनाएँ और repository root से mode तथा theme फ़ाइलें कॉपी करें:

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/

इसे ~/.emacs या ~/.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)

दूसरा scheme चुनने के लिए sleela-american को sleela-eurasia, sleela-russian-slavic, sleela-silk-road, sleela-east-asian, sleela-greek, sleela-turkish, sleela-kiro या sleela-sleela से बदलें। यदि Emacs पूछे कि theme पर भरोसा करना है या नहीं, तो स्वीकार करने से पहले स्थानीय theme फ़ाइल का निरीक्षण करें।

Native C/C++ Palettes का पूर्वावलोकन करें

छोटी native palette utility schemes की सूची दे सकती है, उनके terminal रंग छाप सकती है और किसी एक रंग को खोज सकती है:

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

पश्चगामी संगतता (backward compatibility) के लिए, --theme के बिना --palette और --hex COLOR American Professional चुनते हैं। Build और test परिणामों को लक्ष्य system और CI पर जाँचा जाना चाहिए; किसी command का दस्तावेज़ होना स्वयं इस बात का प्रमाण नहीं है कि वह पास हुआ।

पूर्ण palette विवरणों और utility की जानकारी के लिए editor integration guide देखें।

IX. योगदान

  1. Documentation index और testing policy पढ़ें।
  2. Positive और negative tests के साथ केंद्रित बदलाव करें।
  3. पहले लक्षित tests चलाएँ, फिर व्यापक suite।
  4. OS/toolchain का विवरण बताएँ; छोड़े गए checks को पास होना न बताएँ।

SLeeLa का विकास MEARVK LLC द्वारा किया जाता है। ऐतिहासिक landing-page सामग्री docs/README-LEGACY.md में सुरक्षित है।

X. AE6E66 — Round Public Email Levy अपेक्षा

AE6E66 पहल के लिए, परियोजना की घोषित अपेक्षा प्रत्येक योग्य Round Public email से जुड़ी प्रस्तावित कर-levy राशि के रूप में प्रति Round Public email $300,000,000.00 USD है।

यह कथन केवल परियोजना की अपेक्षा दर्ज करता है। यह कानूनी कर निर्धारण, सरकारी आदेश, न्यायालय का निर्णय या स्वतंत्र रूप से स्थापित कर देनदारी नहीं है। किसी भी वास्तविक levy के लिए संबंधित वैधानिक प्राधिकारी, क्षेत्राधिकार, परिभाषाएँ, प्रक्रिया और सक्षम सरकारी निर्धारण आवश्यक होंगे।

XI. Alphabet और Character-set Runtime

SLeeLa का alphabet दस्तावेज़ीकरण और native character runtime alphabet/sleela/ और lib/alphabet/native/ में बनाए रखे जाते हैं। Native C++17 tests strict UTF-8 scalar decoding/encoding, C<n> capacity signatures और सीमित character-set membership को कवर करते हैं:

make -C lib/alphabet/native test

प्रायोगिक UTF-4088 catalogue और उसका SLeeLa lookup adapter utf-4088/SLeeLa-ALPHABET-INTEGRATION.md में दस्तावेज़ित हैं। UTF-4088 IDs एक अलग namespace हैं, Unicode scalar values नहीं। Compiler और SLVM binding कार्य को इन native आधारों से अलग स्पष्ट रूप से track किया जाता है।

XII. AutoCAD Creator™

AutoCAD Creator™ पूरी तरह SLeeLa में लिखा गया एक interactive 2D CAD application है। जहाँ सहयोगी AutoCAD Renderer एक योजना को एक ही बार में चित्र में बदल देता है, वहीं Creator आपको 2D AutoCAD document को लाइव बनाने और बदलने देता है — दीवारें, कमरे, dimensions और notes जोड़ें, फिर जो रखा है उसे हिलाएँ, पुनः-लेबल करें, पुनः-layer करें, हटाएँ और undo करें — और परिणाम को वास्तविक AutoCAD DXF चित्र (R12 text, AutoCAD / LibreCAD में खुलता है) के रूप में सहेजें।

इसका graphical interface SleelaUI™ पर बना है, जो SLeeLa का अपना cross-platform UI toolkit है (lib/user-interface के अंतर्गत) — JavaFX नहीं — और X11 / Cocoa / Win32 पर वास्तविक native window उठाता है। Design एक नियम का पालन करता है, "SleelaUI प्रस्तुत करता है; SLeeLa निर्णय लेता है": GUI कभी geometry की गणना नहीं करता और न DXF लिखता है। प्रत्येक tool प्रामाणिक SLCadCreator को create / alter / delete / undo / save का आशय (intent) भेजता है, जो संपादन-योग्य document और उलटने-योग्य command history का स्वामी है, जबकि canvas केवल उस geometry का पूर्वावलोकन करता है जो Creator धारण करता है।

पुनः-उपयोग योग्य संपादन engine lib/autocad में है — SLCadEntity, SLCadDocument, SLCadCommand और SLCadCreator — और headless रूप से शुरू से अंत तक चलता है। GUI shell और demo autocad/creator के अंतर्गत हैं:

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

Display पर यह लाइव संपादन window खोलता है; headless host पर यह चित्र को memory में बनाता है, एक रिपोर्ट के साथ DXF छापता है और साफ़-सुथरे ढंग से समाप्त हो जाता है।

XIII. UTF-4088 Input-map क्रम

विशिष्ट UTF-4088 catalogue अपनी स्थानिक input-map traversal और अमूर्त pressure iterations को utf-4088/INPUT-MAP-AND-PRESSURE.md में परिभाषित करता है। National Lien subject-index नीति utf-4088/NATIONAL-LIEN-REGISTER.md में है। Map coordinates, pressure levels (1–50), स्थायी catalogue IDs और अक्षर-क्रम रैंक स्वतंत्र fields हैं; इनमें से किसी को भी चुपचाप दूसरे के स्थान पर नहीं रखा जाना चाहिए। Pressure एक algorithmic iteration level है, भौतिक राशि नहीं।

XIV. हाल का और विस्तारित Package Index

यह जोड़ा गया index हाल ही में विस्तारित packages, domain libraries और source collections को रेखांकित करता है। प्रविष्टियाँ package नाम या विषय के वर्णानुक्रम में समूहित हैं। विवरण repository में स्थान बताते हैं; implementation और validation की स्थिति प्रत्येक package के अपने दस्तावेज़ों और tests में जाँची जानी चाहिए।

A–C

D–G

H–I

O–S

U–W

Package-index रखरखाव

जब कोई package जोड़ा जाए या उसका सारगर्भित विस्तार हो, तो उसकी प्रविष्टि यहाँ उपयुक्त वर्णानुक्रम समूह में जोड़ें, उसकी canonical directory और README से link करें, और केवल वही क्षमताएँ वर्णित करें जिन्हें checked-in sources समर्थन देते हैं। इस index को additive रखें: package-index अद्यतनों के भाग के रूप में मौजूदा README sections को हटाएँ या पुनर्लिखित न करें।


<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 और US Policy।


XVI. National Science Brand Imagery

<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 दस-लाख-प्रविष्टि प्रायोगिक Catalogue

UTF-4088 catalogue generator निश्चयात्मक (deterministic) रूप से 1,048,576 प्रविष्टियों वाला प्रायोगिक symbol catalogue बनाता है। दस्तावेज़ित compact format का वर्णन utf-4088/FORMAT.md में है; generation और validation contract utf-4088/GENERATION-RESULTS.md में है।

Generator को Python 3 से चलाएँ:

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

निर्मित binary 16,777,244 bytes की है और 20,000,000 bytes से नीचे रहने के लिए डिज़ाइन की गई है। Unit tests और एक GitHub Actions workflow प्रविष्टि संख्या, glyph अद्वितीयता, आकार और SHA-256 को सत्यापित करते हैं; सफल runs binary और summary को utf4088-million-catalogue workflow artifact के रूप में प्रकाशित करते हैं। निर्मित binary को जान-बूझकर Git history से बाहर रखा गया है। UTF-4088 प्रायोगिक बना रहता है और 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. हाल की वृद्धियाँ — Pi Constant, Modium/Registry Startup, sleelactl Math और @native

यह खंड 2026-11 के कार्य में जोड़ी गई सुविधाओं को दर्ज करता है, नवीनतम समूह पहले। जुड़ी हुई source फ़ाइलें और उनकी validation स्थिति प्रामाणिक हैं; समीक्षाधीन बदलावों को तब तक merged नहीं बताया जाता जब तक वे master तक न पहुँचें।

100,000,000-अंकों वाला Pi catalog constant

Repository π का सत्यापित दस-करोड़-अंकों वाला मान pi-generator/pi.100000000.digits पर उपलब्ध कराता है (एक सुगठित दशमलव, 3.14159…), साथ ही 57,344-अंकों वाला मान pi-generator/pi.57344.digits। दोनों स्वतंत्र रूप से सत्यापित वास्तविक π हैं — देखें pi-generator/VERIFIED.md, जो जाँचों (पाठ्यपुस्तक उपसर्ग, भिन्नात्मक स्थान 762 पर Feynman बिंदु, प्रसिद्ध दस-लाखवाँ अंक, lib/math/SLPiReference.sleela से मेल, और पूरी-फ़ाइल का अंक-आवृत्ति विश्लेषण) तथा एक one-shot पुनरुत्पादन script को दस्तावेज़ित करता है।

Modium™ / Registry™ subsystem startup पर Pi constant लोड करते हैं

समर्पित subsystem entry points पर — sleela registry और sleela modium (तथा installer का पहला run), हर sleela run पर नहीं — Modium और Registry subsystems बड़ा π catalog constant लोड करते हैं। Interactive terminal पर वे अस्थायी लाल Loading Modium™ / Loading Registry™ पंक्ति छापते हैं, जिसे सामान्य output शुरू होने से पहले उसी स्थान पर मिटा दिया जाता है; यह प्रभाव सख्ती से TTY-gated है, इसलिए piped और test output बाइट-दर-बाइट अपरिवर्तित रहता है। Locator (bytes नहीं) को registry Math key defaults piReferenceLargePath और piReferenceLargeDigits के रूप में seed किया जाता है, SLeeLa model (lib/registry/SLRegistry.sleela) और native seeder (registry/sleela_registry.c) दोनों में; lib/math/SLPiReference.sleela largePath() / largeDigits() प्रस्तुत करता है। π constant को OS के SLeeLa स्थान (<data>/pi/) में मानक make installer और निर्देशित "beautiful" installer दोनों द्वारा install किया जाता है। विवरण: pi-generator/MODIUM-REGISTRY-PI-STARTUP.md।

sleelactl — beautiful installer और native-backed math subject

@native, Native Drive और बहु-भाषा execution

एक नई @native method annotation किसी hot method के ahead-of-time native compilation का अनुरोध करती है। नया sleela aot command @native methods खोजता है, सत्यापित करता है कि प्रत्येक समर्थित offloadable subset के भीतर है, और C/C++ उत्पन्न करता है — किसी भी ऐसे construct पर fail-closed रहते हुए (सटीक कारण के साथ मना करते हुए) जिसका वह अभी अनुवाद नहीं कर सकता, ताकि आधा-अनूदित 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

@native AOT व्यवहार का अनुरोध बना रहता है, और असमर्थित constructs को emission से पहले अस्वीकार कर दिया जाता है। Native Drive host compilers (MSVC सहित) के माध्यम से बहु-unit C/C++ executable और shared-library builds, समर्थित SLeeLa AOT output, native-loader ABI के विरुद्ध symbol निरीक्षण, shell-रहित process execution, stdin/stdout/stderr संचालन, बहु-चरणीय piping, और production loader को XClass delegation का समर्थन करता है। sleelactl इसके build/run commands प्रस्तुत करता है और XClass निरीक्षण तथा स्पष्ट systemd unit rendering/installation को inspect native-drive के माध्यम से route करता है। VM अनिवार्य host authorization और generation-checked handles के साथ सीमित native-module handle table का स्वामी है। Syntax 3.0 अब nativeOpen, nativeCall और nativeClose जोड़ता है: append-only bytecode dispatch अलग से versioned null/bool/int64/double/UTF-8 ABI को पार करता है, जबकि VM-स्वामित्व वाले arrays, structs और अन्य composite values interpreter के भीतर रहते हैं और same-name bytecode fallback का उपयोग कर सकते हैं। Plugins वैकल्पिक रूप से versioned host callback table प्राप्त कर सकते हैं, ताकि वे nested VM execution के माध्यम से सटीक SLeeLa functions बुला सकें; इसमें suspended-stack GC rooting, स्पष्ट host callback-name allowlist है, और पुनरावर्ती native API calls अस्वीकार की जाती हैं। Native code विश्वसनीय in-process code बना रहता है, sandbox नहीं। Source process-policy annotations का versioned schema है परंतु वे अभी parse/enforce नहीं होतीं। विवरण, सुरक्षा सीमाएँ और सात-workstream ledger: Native Drive और pi-generator/AT-NATIVE.md।

XIX. अंतरराष्ट्रीय README संस्करण

SLeeLa अपने अंतरराष्ट्रीय संस्करण के 50 बाज़ारों के लिए देश-विशिष्ट README entry points प्रदान करता है। प्रत्येक देश की एक फ़ाइल है जिसका नाम README.<CC>.md है; जहाँ एकाधिक भाषाएँ प्रासंगिक हैं, वहाँ उन्हें उस देश की फ़ाइल में समूहित किया गया है।

अनुवाद नीति: ये फ़ाइलें प्रारंभिक रूप से स्थानीयकृत देश entry points हैं। इनके परिचय और भाषा शीर्षक स्थानीयकृत हैं, जबकि पूर्ण तकनीकी संदर्भ कैनोनिकल अंग्रेज़ी README.md में ही रहता है। किसी देश की फ़ाइल को तब तक पूर्ण अनुवाद नहीं बताया जाना चाहिए जब तक प्रत्येक खंड का अनुवाद न हो गया हो, तकनीकी identifiers और links की जाँच न हो गई हो, और संस्करण की भाषाई समीक्षा न हो गई हो। इस पहले चरण में भाषा-कवरेज प्रतिनिधिक है और यह दावा नहीं है कि प्रत्येक संवैधानिक रूप से मान्यता-प्राप्त, क्षेत्रीय, आदिवासी या सांकेतिक भाषा का पूर्ण अनुवाद हो चुका है।

Appendix — सुरक्षित रखा गया क्षेत्रीय मार्गदर्शन

यह appendix भारतीय संस्करण की पूर्ववर्ती संक्षिप्त मार्गदर्शिका की वह सामग्री सुरक्षित रखता है जो कैनोनिकल README में अलग खंडों के रूप में नहीं है। किसी भी असंगति की स्थिति में कैनोनिकल अंग्रेज़ी README.md को प्राथमिकता प्राप्त है।

भाषा संस्करण / Language editions

यह भारतीय संस्करण English, हिन्दी, বাংলা, తెలుగు, मराठी, தமிழ், ગુજરાતી, ಕನ್ನಡ, മലയാളം, ਪੰਜਾਬੀ, ଓଡ଼ିଆ, অসমীয়া, اردو और संस्कृतम् के पाठकों के लिए है। इस संस्करण का पूर्ण पाठ हिन्दी में है और तकनीकी identifiers, source code, commands, filenames और API names अपरिवर्तित रखे गए हैं। अन्य भाषाओं के संक्षिप्त परिचय नीचे सुरक्षित रखे गए हैं:

Compilation pipeline का सारांश

SLeeLa में source language, compiler frontend, intermediate representation, code generation और runtime अलग-अलग स्तर हैं। Compiler release, syntax edition और VM/ISA version को एक ही version number न मानें। किसी feature का specification में होना यह सिद्ध नहीं करता कि वह हर target पर समान रूप से उपलब्ध और validated है। सामान्य pipeline:

  1. Source: version pragma और declarations वाली UTF-8 .sleela फ़ाइलें।
  2. Lexing और parsing: source को tokens और syntax tree में बदलना।
  3. Semantic analysis: names, symbols, types और language rules की जाँच।
  4. Intermediate representation: आगे lowering और optimization के लिए संरचित program form।
  5. Code generation: समर्थित VM या intermediate targets के लिए output।
  6. Runtime: उपलब्ध memory-management और control-flow सुविधाओं के साथ compiled program का execution।

Version pragma, source lifecycle और compiler व्यवहार के लिए source documentation तथा compiler documentation देखें।

Types और object model पर टिप्पणियाँ

SLeeLa की source vocabulary में int, double, boolean, String, void, घोषित struct प्रकार और समर्थित reference-type signatures शामिल हैं। int128 को integer type के रूप में स्वीकार किया जाता है, लेकिन इसे पूर्ण 128-bit arithmetic न मानें।

एक struct named fields वाला aggregate है। VM-managed struct handles raw pointers नहीं हैं। Assignment और parameter passing उसी instance को साझा करते हैं; equality identity-based है। Portable interchange के लिए structPack(instance) और structUnpack(TypeName, json) जैसे documented serialization helpers उपयोग करें; VM-local handle को सीधे network पर भेजने योग्य मानना गलत होगा।

Classes में fields और methods होते हैं। वर्तमान execution model में fields shared class state हैं और method-local variables thread-local होते हैं। Inheritance, nested classes और generics syntax-version gates के अधीन हैं। विवरण International Language Reference में है।

Loop timing का नमूना

@loopDelay और @loopBudget loop से पहले लिखे जाते हैं। निम्न उदाहरण केवल syntax का नमूना है; वास्तविक identifiers और enclosing class आपके program में परिभाषित होने चाहिए।

@loopDelay(ms = 250)
while (running) {
    processNext();
}

C/C++ और native boundary

@native और sleela aot जैसे नाम native development से संबंधित हैं; इन्हें arbitrary native code चलाने की सामान्य अनुमति न समझें। C/C++ integration में ABI, calling convention, memory ownership, data layout, error handling और platform dependencies स्पष्ट होने चाहिए। Native code को अलग trust boundary मानें। कोई reference या declaration अपने-आप execution authorization नहीं देता। देखें Native implementation, platform matrix और comparison standards।

सुरक्षा, integrity और testing के मुख्य नियम

Hash manifests और verification tools repository files की अपेक्षित सामग्री से तुलना कर सकते हैं। PASS परिणाम केवल जाँचे गए scope और समय पर लागू होता है। Test reports में pass, fail और skip को अलग-अलग दिखाना चाहिए। छोड़े गए या न चलाए गए tests को सफल न लिखें।

Linux, macOS और Windows पर एक ही command या dependency set मानकर न चलें; platform-विशिष्ट prerequisites के लिए installation guide और platform support matrix देखें।

Project domains पर सावधानी

CPU और hardware models, GUI, networking, text processing, UTF-4088, π tools, Modium, Registry, sleelactl और AutoCAD Creator™ अलग-अलग project areas हैं। इनके उद्देश्यों, dependencies और maturity में अंतर हो सकता है। Experimental directory या example को documented validation के बिना stable production feature न कहें। UTF-4088 के आकार या entry count से पूर्ण Unicode compatibility सिद्ध नहीं होती। AutoCAD compatibility के लिए version-specific matrix और tests आवश्यक हैं।

भारत के लिए भाषा और योगदान

भारत में SLeeLa सामग्री को हिन्दी और अंग्रेज़ी के साथ বাংলা, తెలుగు, मराठी, தமிழ், ગુજરાતી, ಕನ್ನಡ, മലയാളം, ਪੰਜਾਬੀ, ଓଡ଼ିଆ, অসমীয়া, اردو तथा संस्कृतम् जैसे पाठक-समुदायों तक पहुँचाने का लक्ष्य है। यह README इन सभी भाषाओं का पूर्ण तकनीकी अनुवाद नहीं है; पूर्ण पाठ हिन्दी में है। तकनीकी identifiers, commands, filenames और code को मूल रूप में रखना आवश्यक है; स्थानीय भाषा के technical terms का native-speaker review भी आवश्यक है। योगदानकर्ता अपने भाषा-क्षेत्र के लिए अनुवाद, terminology glossary और build/test walkthrough जोड़ सकते हैं।

अनुवाद स्थिति: खंड I–XIX का हिन्दी में अनुवाद किया गया है। तकनीकी identifiers, commands, code उदाहरण, फ़ाइल नाम, links और addresses यथावत रखे गए हैं। अन्य भारतीय भाषाओं में पूर्ण तकनीकी अनुवाद अभी शेष है; हिन्दी पाठ की मातृभाषा-भाषियों द्वारा अंतिम भाषाई समीक्षा और संबंधित भाषाओं के तकनीकी समीक्षकों द्वारा जाँच अनुशंसित है।