Home /Modules/docs/README.RU.md

README.RU.md

docs/i18n/README.RU.md · 803 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 — Россия (RU)

<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" width="560"></p>

<p align="center"><strong>Нативный системный язык, компилятор, среда выполнения и экосистема виртуальных машин.</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>

Международное страновое издание. Это издание подготовлено на русском языке. Технические идентификаторы, команды, примеры кода, имена файлов, пути и ссылки остаются без изменений по сравнению с каноническим английским README.md.

The Now. The Ingredient. Язык — это больше, чем синтаксис: это компилятор, среда выполнения, библиотеки, инструменты и платформенные соглашения, благодаря которым программное обеспечение становится пригодным к использованию.

Чем занимается SLeeLa. SLeeLa занимается направлениями Math, Object, Science и Reach — четырьмя гранями своей работы: исчислимым (Math), устоявшейся вещью, занимающей место в каталоге существующего (Object), дисциплинированным изучением истинного (Science) и простиранием «руки» системы к другим системам и людям (Reach). Национальные интересы сохраняются — ни одно из четырёх направлений не отодвигает их в сторону; если предмет затрагивает интерес государства, это положение сохраняется (достоверно фиксируется, например, в metaOrigin / metaNationalSchedule метаданных каждого класса) и никогда не растворяется.

I. Начало работы

II. Новости

Недавние дополнения к языку, драйверам и стандартной библиотеке:

III. Сборка и тестирование

Требования: набор инструментов C/C++ (GCC или Clang) и GNU Make; Python 3 для инструментов манифестов и потоков; в Linux — пакеты разработки X11/Xrandr для графических продуктов (команда make deps модуля сообщает и устанавливает то, что ему нужно). Сборка impl/ работает в режиме fail-closed по доверенному манифесту SHA-256, на который корневой Makefile указывает автоматически.

Из чистой копии быстрее всего начать так:

make                                  # build everything from the repo root

Либо собрать и протестировать только native-ядро:

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

Корневая команда make собирает каждый продукт (ядро, VM, кодеки, churn, антивирус, …) и завершается сборкой реестра и материализацией его базовой таблицы — так что собранное дерево сразу поставляется с реестром, пригодным для проверки. Основные цели:

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

Другие полезные цели:

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 запускает build-registry.sh: он собирает ядро реестра, загружает базовую таблицу в переносимое текстовое хранилище registry/build/sleela.sleelareg и экспортирует скрипт таблицы MySQL registry/build/registry.sql (через sleela registry export). Просмотрите её командой sleela registry или registry/build/sleela-registry review. См. руководство по реестру и архитектуру Registry 3.0.

Требования и платформенные шаги уточняйте в руководствах по сборке и тестированию. Успешная сборка одного компонента не доказывает, что все библиотеки или платформы готовы к выпуску.

IV. Установка

После сборки native-продуктов установите команды и вспомогательные файлы среды выполнения:

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

Обычный установщик по умолчанию использует /usr/local/bin, /usr/local/lib/sleela и /usr/local/share/sleela. Он сохраняет существующую стартовую конфигурацию и отказывается перезаписывать существующие команды, не отслеживаемые установщиком. Удаление затрагивает только файлы, записанные установщиком, сохраняя конфигурацию и неотслеживаемые данные среды выполнения.

Для целевого пошагового развёртывания только основного пакета — бинарных файлов sleela, sleelvac и nordshrift, стандартной библиотеки, протоколов и вспомогательных модулей — используйте чистый установщик:

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

Он требует одного основного решения (установить основной пакет), затем выбора области установки, а при успехе — необязательного выбора из подобранных модулей расширения. Об интерактивном процессе развёртывания и всех параметрах установки см. Быструю и безопасную установку.

V. Язык и среда выполнения

Авторитетная грамматика — SLEELA.syntax. В репозитории сейчас документирован синтаксис 3.0; версия компилятора/инструмента и версия синтаксиса исходного кода — разные понятия. Поверхность 3.0 добавляет маркеры документа pure и gasoline (§30) — пару «голых», контекстных, только декларативных Preonems, значащих почти одно и то же, каждый из которых отмечает статус документа по-своему честно. Синтаксис 3.0 объединяет языковую поверхность 1.0–2.9 в текущую нормативную редакцию, сохраняя все минимальные пороги, привязанные к отдельным возможностям. Предыдущая поверхность 2.9 добавляет консеквентные поля @mix (§28) — класс может объявлять несколько одноимённых полей экземпляра, если каждое несёт @mix, понимаемых как одна индексированная группа (сверху вниз 1,2,3,… или вручную @mix(1,2,3,...), число индексов которого должно совпадать с группой). Она переносит дальше семейства широких знаковых/беззнаковых целых по основанию 2 int32..int16777216 (§24) и uint32..uint16777216 (§25) поверх более ранних long/int64/int128 (§21); документы-поддержки ключевых слов (§22); и Preonems — только декларативные маркеры документа author/authorial (§18), material/memory (§19–§20), determine (§23), object/field (§26), pure/gasoline (§30) и artifact (§35, статус законодательного уровня, градуированный по времени и пространству), совместно называемые Preonems (§26.1). Разрешение перегрузок конструкторов и делегирование this(...)/конструктору базового класса явно находятся за пределами проверенного контракта синтаксиса 1.8. Прежде чем полагаться на возможность, сверьтесь с грамматикой и примечаниями по реализации. Девять исходных модулей SleelaDoc теперь объявляют #sleela 3.0; общий шлюз компилятора принимает исходный синтаксис 1.0–3.0. Новая сборка API создаётся командой make api-docs.

Репозиторий включает native-реализацию на C/C++, справочные материалы по генерации SLVM, модули стандартной библиотеки, тесты, примеры и платформенные интеграции. Статус реализации и проверки различается по модулям; сверяйтесь со спецификацией модуля и текущими результатами CI, не предполагая единообразной полноты.

VI. Инженерные принципы

VII. Сборка антивируса и целостность

Пакет антивируса Sleelavirin включает native-сканер SHA-256, необязательный адаптер ClamAV, манифесты целостности исходников/индексов и контрольные суммы платформенных пакетов. Соберите и протестируйте пакет из корня репозитория:

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

Манифест целостности создаётся в antivirus/build/; он охватывает отслеживаемые исходные и документационные входные данные, а также защищённые файлы индекса сигнатур, исключая сгенерированный вывод и изменяемый кэш ClamAV. У снимков баз ClamAV есть собственные манифесты. ZIP-архивы выпуска включают INTEGRITY-MANIFEST.json, SHA256SUMS и сопутствующий файл .sha256. Проверяйте хеши скачанных архивов по доверенному значению, полученному независимо: контрольная сумма, хранящаяся рядом с архивом, не является подписью издателя. См. руководство по Sleelavirin, контрольный список безопасности и рабочий процесс сборки антивируса.

Выпуск не считается проверенным, пока соответствующие задания CI не пройдены на точном коммите выпуска, а полученные артефакты не проверены.

VIII. Цветовые темы редакторов SLeeLa — Vim и Emacs

SLeeLa включает согласованный набор профессиональных тёмных цветовых схем для Vim и Emacs, а также native-утилиту палитр на C/C++. Исходная схема 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
Паневразийская<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
Русская и славянская — средняя<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
Центральноазиатская / Шёлковый путь<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
Восточноазиатская<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 — Международный уголовный суд<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 — Верховный суд США<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
Греческая (эллинская)<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
Турецкая (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

Национальные цвета флагов (исходная палитра)

Греческая и турецкая схемы выведены из официальных цветов государственных флагов двух стран, приведённых здесь с точными опубликованными значениями hex. Фоны и акценты схем выше — это затемнённые, удобные для редактора интерпретации этих исходных цветов; приведённая ниже таблица служит справкой «цвета в том виде, как они официально представлены».

ГосударствоЦветHexОснование и значение
ГрецияСиний<span style="display:inline-block;width:1em;height:1em;background:#0D5EAF;border:1px solid #888"></span> #0D5EAFСиний цвет государственного флага (закон 851/1978). Небо и моря; в геральдике блазонируется как лазурь.
ГрецияБелый<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Красный цвет государственного флага (Закон о турецком флаге). Поле; по традиции — кровь мучеников и суверенитет Османской империи.
TürkiyeБелый<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFFБелый цвет государственного флага. Полумесяц и звезда — мир, чистота и символ тюркско-исламского наследия.

Схемы привязывают передний план каждого редактора к национальному белому, а ключевые слова, курсор, выделение и строку состояния — к точному национальному синему (#0D5EAF) или красному (#E30A17), так что значимые цвета буквально совпадают с национальными. Это интерпретационные дизайнерские палитры; справка по цветам флагов приводится ради происхождения данных и не является официальным представлением ни одного из государств. Значения цветов следуют описанию государственной символики Министерства иностранных дел Греческой Республики и традиции Закона о турецком флаге.

Таблица цветовых образцов

Ячейки палитры ниже используют SVG-образцы, поэтому GitHub отображает настоящие цвета, а не пустые HTML-ячейки цвета. Каждая полоса показывает шесть цветов в таком порядке: фон, передний план, ключевые слова, типы, строки и комментарии. Точные hex-коды перечислены рядом с каждым образцом, в том же порядке схем, что и в справочной таблице выше.

СхемаОтображаемые цвета палитрыHex-коды (фон · передний план · ключевые слова · типы · строки · комментарии)
Американская профессиональнаяAmerican Professional palette: background, foreground, keywords, types, strings, comments#101820 · #F4F7FA · #7FB3FF · #73DACA · #F2C078 · #8A96A3
ПаневразийскаяPan-Eurasian palette: background, foreground, keywords, types, strings, comments#111827 · #F0F2F5 · #7AA7E8 · #69C9B3 · #D7B56D · #8995A5
Русская и славянская — средняяRussian and Slavic Medium palette: background, foreground, keywords, types, strings, comments#202733 · #E8EAF0 · #A9C0DD · #8FC4B2 · #D6BD8B · #9AA3AF
Центральноазиатская / Шёлковый путьCentral Asian Silk Road palette: background, foreground, keywords, types, strings, comments#1C2529 · #F5F0E5 · #7FADE0 · #45C6C2 · #D9B56D · #92A3A0
ВосточноазиатскаяEast Asian palette: background, foreground, keywords, types, strings, comments#171A1C · #F2EFE7 · #D97878 · #72C7A5 · #D8B76A · #969F9B
ICC — Международный уголовный судICC palette: background, foreground, keywords, types, strings, comments#0E1A2B · #EAF0F7 · #5B8FD6 · #7FB7C9 · #D9B25A · #7E8CA0
SCOTUS — Верховный суд СШАSCOTUS palette: background, foreground, keywords, types, strings, comments#1A1416 · #F3EEE6 · #9E2B35 · #8FA9B8 · #C9A24B · #8C8178
Греческая (эллинская)Greek Hellenic palette: background, foreground, keywords, types, strings, comments#0A1A30 · #FFFFFF · #2E7BD6 · #5E9FE0 · #9FC3EC · #6E86A6
Турецкая (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

Дополнительные акцентные цвета используются для функций, констант, выделений, диагностики и директив препроцессора. Русская и славянская палитра намеренно использует цвета средней интенсивности — сланцевый, синий, шалфейный, рубиновый и античное золото — для более спокойного профессионального облика.

Установка схем Vim

Из корня репозитория:

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/

Добавьте следующее в ~/.vimrc, чтобы включить подсветку синтаксиса SLeeLa и выбрать схему:

syntax enable
set background=dark
colorscheme sleela-american

Выберите ровно одно из этих названий colorscheme:

Например, используйте colorscheme sleela-russian-slavic для средней русской и славянской палитры или colorscheme sleela-greek / colorscheme sleela-turkish для эллинской палитры и палитры Al Bayrak. Перезапустите Vim или загрузите конфигурацию командой :source $MYVIMRC.

Установка схем Emacs

Создайте локальный каталог тем и скопируйте файлы режима и тем из корня репозитория:

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)

Замените sleela-american на sleela-eurasia, sleela-russian-slavic, sleela-silk-road, sleela-east-asian, sleela-greek, sleela-turkish, sleela-kiro или sleela-sleela, чтобы выбрать другую схему. Если Emacs спросит, доверять ли теме, проверьте локальный файл темы, прежде чем соглашаться.

Предварительный просмотр native-палитр на C/C++

Небольшая native-утилита палитр умеет перечислять схемы, выводить их цвета для терминала и находить отдельный цвет:

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

Для обратной совместимости --palette и --hex COLOR без --theme выбирают American Professional. Результаты сборки и тестов следует проверять на целевой системе и в CI; документация команды сама по себе не является свидетельством того, что она прошла.

Полное описание палитр и подробности об утилите см. в руководстве по интеграции редакторов.

IX. Участие в проекте

  1. Прочитайте указатель документации и политику тестирования.
  2. Вносите целенаправленные изменения с позитивными и негативными тестами.
  3. Запускайте целевые тесты, затем широкий набор.
  4. Сообщайте сведения об ОС и наборе инструментов; не описывайте пропущенные проверки как пройденные.

SLeeLa разрабатывается компанией MEARVK LLC. Исторические материалы целевой страницы сохранены в docs/README-LEGACY.md.

X. AE6E66 — ожидаемый сбор с Round Public email

В рамках инициативы AE6E66 заявленное ожидание проекта составляет $300,000,000.00 USD за каждое Round Public email в качестве предлагаемой суммы налогового сбора, связанного с каждым соответствующим требованиям Round Public email.

Это заявление фиксирует лишь ожидание проекта. Оно не является юридическим налоговым начислением, распоряжением правительства, решением суда или независимо установленной налоговой обязанностью. Любой фактический сбор потребовал бы соответствующих правовых полномочий, юрисдикции, определений, процедуры и решения компетентного государственного органа.

XI. Алфавит и среда выполнения наборов символов

Документация по алфавитам SLeeLa и native-среда выполнения символов поддерживаются в alphabet/sleela/ и lib/alphabet/native/. Native-тесты на C++17 охватывают строгое декодирование/кодирование скаляров UTF-8, сигнатуры ёмкости C<n> и ограниченную проверку принадлежности к набору символов:

make -C lib/alphabet/native test

Экспериментальный каталог UTF-4088 и его адаптер поиска для SLeeLa документированы в utf-4088/SLeeLa-ALPHABET-INTEGRATION.md. Идентификаторы UTF-4088 — это отдельное пространство имён, а не скалярные значения Unicode. Работа над привязкой компилятора и SLVM отслеживается явно отдельно от этих native-основ.

XII. AutoCAD Creator™

AutoCAD Creator™ — интерактивное 2D CAD-приложение, целиком написанное на SLeeLa. Если родственный AutoCAD Renderer превращает план в чертёж за один проход, то Creator позволяет создавать и изменять 2D-документ AutoCAD в реальном времени — добавлять стены, комнаты, размеры и примечания, затем перемещать, переименовывать, переносить на другие слои, удалять и отменять размещённое — и сохранять результат как настоящий чертёж AutoCAD DXF (текстовый R12, открывается в AutoCAD / LibreCAD).

Его графический интерфейс построен на SleelaUI™ — собственном кроссплатформенном UI-тулките SLeeLa (в lib/user-interface), а не на JavaFX — и открывает настоящее нативное окно в X11 / Cocoa / Win32. Дизайн следует одному правилу: «SleelaUI показывает; SLeeLa решает»: GUI никогда не вычисляет геометрию и не пишет DXF. Каждый инструмент выдаёт намерение создать / изменить / удалить / отменить / сохранить авторитетному SLCadCreator, который владеет редактируемым документом и обратимой историей команд, тогда как холст лишь показывает предварительный вид геометрии, которую хранит Creator.

Многократно используемый механизм редактирования находится в lib/autocad — SLCadEntity, SLCadDocument, SLCadCommand и SLCadCreator — и работает от начала до конца без графической оболочки. Оболочка GUI и демонстрация находятся в autocad/creator:

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

На машине с дисплеем это открывает окно живого редактирования; на хосте без дисплея чертёж строится в памяти, выводятся отчёт и DXF, после чего программа штатно завершается.

XIII. Порядок входной карты UTF-4088

Специализированный каталог UTF-4088 определяет обход своей пространственной входной карты и абстрактные итерации давления в utf-4088/INPUT-MAP-AND-PRESSURE.md. Политика предметного индекса National Lien находится в utf-4088/NATIONAL-LIEN-REGISTER.md. Координаты карты, уровни давления (1–50), постоянные идентификаторы каталога и алфавитные ранги — независимые поля; ни одно из них не следует молча подставлять вместо другого. Давление — это алгоритмический уровень итерации, а не физическая величина.

XIV. Недавний и расширенный указатель пакетов

Этот дополняемый указатель выделяет недавно расширенные пакеты, предметные библиотеки и коллекции исходников. Записи сгруппированы по алфавиту названий пакетов или тем. Описания указывают расположение в репозитории; статус реализации и проверки следует смотреть в собственной документации и тестах каждого пакета.

A–C

D–G

H–I

O–S

U–W

Сопровождение указателя пакетов

Когда пакет добавляется или существенно расширяется, добавьте его запись сюда в подходящую алфавитную группу, сославшись на его канонический каталог и README, и описывайте только возможности, подтверждённые зафиксированными исходниками. Сохраняйте этот указатель аддитивным: не удаляйте и не переписывайте существующие разделы README при обновлении указателя пакетов.


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

Демократические США и политика США.


XVI. Национальные брендовые изображения науки

<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 на миллион записей

Генератор каталога UTF-4088 детерминированно строит экспериментальный каталог символов из 1 048 576 записей. Документированный компактный формат описан в utf-4088/FORMAT.md; контракт генерации и проверки — в utf-4088/GENERATION-RESULTS.md.

Запустите генератор с помощью Python 3:

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

Сгенерированный бинарный файл занимает 16 777 244 байта и рассчитан так, чтобы оставаться меньше 20 000 000 байт. Модульные тесты и рабочий процесс GitHub Actions проверяют число записей, уникальность глифов, размер и SHA-256; успешные запуски публикуют бинарный файл и сводку как артефакт рабочего процесса utf4088-million-catalogue. Сгенерированный бинарный файл намеренно не хранится в истории Git. 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" width="560"></p>


XVIII. Недавние дополнения — константа Pi, запуск Modium/Registry, математика sleelactl и @native

В этом разделе записаны возможности, добавленные в ходе работ 2026-11, сначала самые новые группы. Авторитетны связанные исходные файлы и статус их проверки; изменения на рассмотрении не описываются как влитые, пока не попадут в master.

Каталожная константа Pi на 100 000 000 цифр

Репозиторий поставляется с проверенным значением π в сто миллионов цифр в pi-generator/pi.100000000.digits (корректная десятичная запись, 3.14159…), а также со значением в 57 344 цифры в pi-generator/pi.57344.digits. Оба независимо подтверждены как подлинное π — см. pi-generator/VERIFIED.md, где задокументированы проверки (учебниковый префикс, точка Фейнмана в дробной позиции 762, известная миллионная цифра, совпадение с lib/math/SLPiReference.sleela и анализ частот цифр по всему файлу) и однократный скрипт воспроизведения.

Modium™ / Registry™ загружают константу Pi при запуске подсистемы

На выделенных точках входа подсистем — sleela registry и sleela modium (и при первом запуске установщика), а не при каждом sleela run — подсистемы Modium и Registry загружают большую каталожную константу π. На интерактивном терминале они выводят временную красную строку Loading Modium™ / Loading Registry™, которая затем стирается на месте до начала обычного вывода; эффект строго привязан к TTY, поэтому конвейерный вывод и вывод тестов остаются побайтно неизменными. Локатор (а не байты) заносится как значения по умолчанию ключей Math реестра piReferenceLargePath и piReferenceLargeDigits — как в модели SLeeLa (lib/registry/SLRegistry.sleela), так и в native-заполнителе (registry/sleela_registry.c); lib/math/SLPiReference.sleela предоставляет largePath() / largeDigits(). Константа π устанавливается в системное расположение SLeeLa (<data>/pi/) как стандартным установщиком make, так и управляемым «красивым» установщиком. Подробности: pi-generator/MODIUM-REGISTRY-PI-STARTUP.md.

sleelactl — красивый установщик и subject math на native-основе

@native, Native Drive и выполнение на нескольких языках

Новая аннотация метода @native запрашивает ahead-of-time native-компиляцию горячего метода. Новая команда sleela aot находит методы с @native, проверяет, что каждый находится в поддерживаемом выгружаемом подмножестве, и выдаёт C/C++ — с отказом по закрытому принципу (fail closed) (с отказом и точной причиной) для любой конструкции, которую она пока не умеет транслировать, так что наполовину транслированный метод никогда не создаётся.

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-обработку, а неподдерживаемые конструкции отвергаются до выдачи кода. Native Drive поддерживает многомодульные сборки исполняемых файлов и разделяемых библиотек C/C++ через хост-компиляторы (включая MSVC), поддерживаемый AOT-вывод SLeeLa, инспекцию символов по ABI native-загрузчика, выполнение процессов без оболочки, обработку stdin/stdout/stderr, многоступенчатые конвейеры и делегирование XClass производственному загрузчику. sleelactl предоставляет его команды сборки/запуска и направляет инспекцию XClass и явную генерацию/установку юнитов systemd через inspect native-drive. VM владеет ограниченной таблицей дескрипторов native-модулей с обязательной авторизацией хоста и дескрипторами, проверяемыми по поколению. Синтаксис 3.0 теперь добавляет nativeOpen, nativeCall и nativeClose: append-only диспетчеризация байт-кода пересекает отдельно версионируемый ABI null/bool/int64/double/UTF-8, тогда как принадлежащие VM массивы, структуры и другие составные значения остаются внутри интерпретатора и могут использовать резервный вызов байт-кода с тем же именем. Плагины могут по желанию получать версионируемую таблицу обратных вызовов хоста для вызова точных функций SLeeLa через вложенное выполнение VM, с корневым хранением приостановленного стека для GC, явным списком разрешённых имён обратных вызовов хоста и отклонением рекурсивных вызовов native API. Native-код остаётся доверенным кодом внутри процесса, а не песочницей. Аннотации политики процессов в исходном коде имеют версионируемую схему, но пока не разбираются и не применяются. Подробности, границы безопасности и реестр из семи направлений работ: Native Drive и pi-generator/AT-NATIVE.md.

XIX. Международные издания README

SLeeLa предоставляет страновые точки входа README для 50 рынков своего международного издания. У каждой страны есть один файл с именем README.<CC>.md; если актуальны несколько языков, они сгруппированы в файле этой страны.

Политика перевода: Эти файлы — первоначальные локализованные страновые точки входа. Их введения и языковые заголовки локализованы, тогда как полный технический справочник остаётся в каноническом английском README.md. Страновой файл нельзя называть полным переводом, пока не переведён каждый раздел, не проверены технические идентификаторы и ссылки, а издание не прошло языковую проверку. Охват языков на этом первом этапе репрезентативен и не является заявлением о том, что полностью переведены все конституционно признанные, региональные, коренные языки или языки жестов.

Приложение — сохранённые региональные рекомендации

В этом приложении сохранены практические рекомендации из прежнего краткого русскоязычного руководства, не имеющие собственных разделов в каноническом README. При любом расхождении приоритет имеет канонический английский README.md.

Типичная цепочка инструментов

Нормативная спецификация языка находится в SLEELA.syntax. Версию компилятора, версию синтаксиса и версию VM/ISA необходимо рассматривать как отдельные понятия. Типичная цепочка инструментов включает:

  1. Исходный код: файлы .sleela с указанием версии языка и декларациями.
  2. Frontend: лексический анализ, разбор, обработку символов и семантические проверки.
  3. Промежуточное представление: структурированную форму для последующих этапов преобразования.
  4. Генерацию кода: вывод для поддерживаемых VM- или промежуточных целей.
  5. Среду выполнения: выполнение скомпилированного содержимого с механизмами управления памятью и потоком управления.
  6. Библиотеки и инструменты: повторно используемые пакеты, документацию, сборку и верификацию.

Точные возможности зависят от текущей реализации. Наличие функции в спецификации не означает автоматически, что она поддерживается на каждой цели.

Цели, профили и границы выполнения

SLeeLa отделяет исходный код от целей сборки и выполнения. Документированное семейство целей включает SLVM, SLJVM и SLIR; NATIVE — ограниченная цель с условиями, и нельзя считать её доступной на всех платформах. Профили BASIC_COMPLETE и ADVANCED_TOTAL обозначают разный охват. Для каждой сборки проверяйте фактическую цель, профиль и поддержку платформы.

Ссылка идентифицирует файл, модуль или ресурс, но сама по себе не даёт разрешения на его выполнение. Когда программа использует файлы, внешние библиотеки, native-привязки или системные ресурсы, границы авторизации и ответственность за выполнение должны быть определены явно. Описание в документации само по себе не доказывает гарантию безопасности во время выполнения; проверяйте реализацию и соответствующие тесты.

При взаимодействии SLeeLa с C или C++ граница интерфейса должна быть явной. Контракты ABI, владение памятью, типы данных, обработка ошибок и платформенные зависимости необходимо документировать и тестировать. Native-код следует считать отдельной границей доверия.

Жизненный цикл ресурсов и диагностика

Документируйте владение, время жизни и ответственность за синхронизацию для ресурсов, совместно используемых функциями или потоками. Разделяйте local variables, shared object state, VM handles и serializable data. Локальный для VM дескриптор не является стабильным форматом файла или сетевым сообщением. Используйте определённый модулем интерфейс сериализации и тестируйте недопустимые, отсутствующие и граничные значения.

При диагностике записывайте коммит, ОС, архитектуру и набор инструментов. Сначала собирайте наименьшую относящуюся к делу цель, сохраняйте полный вывод ошибок, разделяйте ошибки компилятора и ошибки времени выполнения и создавайте минимальный воспроизводимый пример. Успешная сборка сама по себе не доказывает корректного поведения во время выполнения.

В отчёте о проверке следует указать точный коммит, ОС/архитектуру, версии компиляторов, полные команды сборки и тестирования, число пройденных/упавших/пропущенных тестов и известные ограничения. Пропущенные или не запускавшиеся тесты нельзя засчитывать как пройденные.

Замечания о ссылках и адресах

Упоминания в README таких тем, как CSPML, Character, Governance, Synchro, SleelaUI и United Nations, описывают содержимое репозитория и не являются официальным одобрением со стороны государственных органов или организаций.

Наличие адресов или изображений в разделе Bitcoin Conjegeum (XV) не является финансовой рекомендацией, подтверждением права собственности или указанием переводить средства. Перед использованием проверяйте сведения независимо.

Языковой охват русской редакции

Русская редакция предназначена для русскоязычных читателей. Она не заявляет о полном охвате всех языков народов Российской Федерации или всех региональных языковых форм. Вклад носителей других языков и специалистов по техническому переводу приветствуется.

Статус перевода: Разделы I–XIX переведены на русский язык. Технические идентификаторы, команды, примеры кода, имена файлов, ссылки и адреса сохранены. Рекомендуется заключительная языковая проверка носителями языка.