SomonScriptDocs

Документация SomonScript для школ и учащихся

Эта страница - общий план обучения. Если вы новичок или работаете с учениками в классе, начните отсюда: 3 шага к установке, первой программе и пониманию основ языка.

Шаг 1: Быстрый старт

Прежде всего убедитесь, что Node.js установлен, затем установите SomonScript CLI и напишите простую программу салом.som.

1. Node.js

Перейдите на nodejs.org и установите версию LTS.

2. SomonScript CLI

Установите CLI глобально с помощью npm.

3. Первая программа

Создайте файл салом.som и запустите его командой somon run.

Установка CLI и проверка в терминале

Выполните следующие команды в Terminal или PowerShell. Такой формат используется во всей документации.

terminal

# Проверка версий
node -v
npm -v

# Установка SomonScript CLI
npm install -g @lindentech/somon-script

# Проверка
somon --version

Шаг 2: «Привет, мир» на SomonScript

Теперь напишем свою первую программу. Этот пример встречается и в других разделах и отлично подходит для урока.

салом.som

// Первая программа
чоп.сабт("Салом ҷаҳон!");

Что нужно сделать?

Создайте новую папку, например somon-project.
Создайте в этой папке файл салом.som.
Скопируйте код, вставьте его в файл и запустите в терминале.

somon run салом.som
Салом ҷаҳон!

Шаг 3: Основы языка SomonScript

Для пошагового изучения начните с уроков: 18 уроков с примерами, которые запускаются прямо в браузере. Ниже - карта глав документации, к которым удобно возвращаться за справкой.

Основы синтаксиса

Переменные, типы данных, операторы и условия.

Функции и сущности

Простые функции, рекурсия и повторяющиеся действия.

Классы, ООП и модули

Для больших проектов: классы, наследование и разделение кода на файлы.

Система типов и ошибки

Продвинутые типы, проверка ошибок и исключения для надёжных программ.

CLI SomonScript в одной таблице

Команды ниже часто встречаются в примерах и упражнениях. Школам полезно распечатать эту таблицу и повесить её в классе.

Команда	Описание	Пример
somon run	Компиляция и запуск файла .som.	somon run салом.som
somon compile	Преобразование в JavaScript без запуска.	somon compile main.som
somon bundle	Объединение нескольких файлов в один .js.	somon bundle src/main.som -o dist/app.js
somon module-info	Просмотр зависимостей модулей.	somon module-info src/main.som --graph

Руководство для учащихся

Если вы учитесь самостоятельно, рекомендуем такой путь:

Пройдите уроки с 1 по 18: запускайте каждый пример и смотрите его выполнение по шагам.
Решайте задачи в песочнице: кнопка «Проверить» проверяет решение тестами.
Для программ побольше установите SomonScript на компьютер (шаг 1) и пользуйтесь главами 2-11 документации как справочником.

Руководство для учителей

18 уроков легко превратить в курс на 6 недель, по три урока в неделю. Предлагаемый план:

Недели 1-2: уроки 1-6 - вывод, ошибки, переменные, числа, ввод и вычисления.
Недели 3-4: уроки 7-12 - сравнения, условия и циклы.
Недели 5-6: уроки 13-18 - функции, списки, строки и объекты.

Как раздавать и проверять задания, частые ошибки учеников и сравнение уроков с учебником «Технологияи иттилоотӣ» описаны в памятке для учителя.