SomonScriptDocs

Ҳуҷҷатҳои SomonScript барои мактабҳо ва донишҷӯён

Ин саҳифа нақшаи умумии омӯзиш аст. Агар шумо навомӯз бошед ё бо донишҷӯён дар синф кор кунед, аз ҳамин ҷо оғоз кунед: 3 қадам барои насб, аввалин барнома ва фаҳмидани асосҳои забон.

Қадами 1: Оғози зуд

Пеш аз ҳама, мутмаин шавед, ки Node.js насб шудааст, пас SomonScript CLI-ро насб кунед ва як барномаи оддии салом.som нависед.

1. Node.js

Ба nodejs.org равед ва версияи LTS-ро насб кунед.

2. SomonScript CLI

Бо npm CLI-ро глобалӣ насб кунед.

3. Барномаи аввал

Файли салом.som созед ва онро бо somon run иҷро кунед.

Насби CLI ва санҷиш дар терминал

Фармонҳои зеринро дар Terminal ё PowerShell иҷро кунед. Ин услуб дар тамоми ҳуҷҷатҳо истифода мешавад.

terminal
# Санҷидани версияҳо
node -v
npm -v

# Насби SomonScript CLI
npm install -g @lindentech/somon-script

# Санҷиш
somon --version

Қадами 2: «Салом ҷаҳон» бо SomonScript

Акнун аввалин барномаи худро менависем. Ин мисол дар қисмҳои дигар низ такрор мешавад ва барои синф хеле мувофиқ аст.

салом.sом
// Аввалин барнома
чоп.сабт("Салом ҷаҳон!");

Чӣ бояд кард?

  1. Папкаи нав, масалан somon-project созед.
  2. Файли салом.som-ро дар он папка эҷод кунед.
  3. Кодро нусха гирифта, ба файл гузоред ва дар терминал иҷро кунед.
somon run салом.som # Натиҷа: Салом ҷаҳон!

Қадами 3: Асосҳои забони SomonScript

Барои хондани тафсилоти пурра, омӯзгорон метавонанд матни пурратарро аз файлиҳои Markdown дар docs/book истифода баранд. Дар ин ҷо танҳо харитаи умумӣ барои синф оварда шудааст.

Асосҳои синтаксис

Тағйирёбандаҳо, намудҳои маълумот, операторҳо ва шартҳо.

Функсияҳо ва ниҳодҳо

Функсияҳои оддӣ, рекурсия ва кори такроршаванда.

Синфҳо, ООП ва модулҳо

Барои лоиҳаҳои калон: синфҳо, меросбарӣ ва тақсим кардани код ба файлҳо.

Системаи намудҳо ва хатогиҳо

Намудҳои пешрафта, санҷиши хатогиҳо ва истиснокҳо барои барномаҳои боэътимод.

CLI-и SomonScript дар як ҷадвал

Фармонҳои поён аксар вақт дар мисолҳо ва машқҳо истифода мешаванд. Барои мактабҳо хуб аст, ки ин ҷадвалро чоп кунанд ва дар синф овезанд.

ФармонТавсиф
somon runКомпилятсия ва иҷрои файли .som.
somon compileТабдил додан ба JavaScript бидуни иҷро.
somon bundleЯкҷо кардани чанд файл ба як .js.
somon module-infoДидани вобастагиҳои модулҳо.

Роҳнамо барои донишҷӯён

Агар шумо худатон меомӯзед, роҳи зеринро тавсия медиҳем:

  1. Аз ин саҳифа ва қадамҳои насб оғоз кунед.
  2. Бобҳои 1–5-и маводро хонед ва ҳар як мисолро иҷро кунед.
  3. Аз боби 6 сар карда, лоиҳаҳои хурд (калькулятор, китобхона) созед.

Роҳнамо барои омӯзгорон

Ин ҳуҷҷатҳоро метавон ба осонӣ ба курси 6–8 ҳафтаӣ табдил дод. Пешниҳод:

  • Ҳафтаҳои 1–2: Бобҳои 1–3, иҷрои мисолҳои оддӣ ва машқҳои дохили мавод.
  • Ҳафтаҳои 3–4: Бобҳои 4–6, тамаркуз ба давраҳо ва функсияҳо.
  • Ҳафтаҳои 5–6: Бобҳои 7–9, сохтани лоиҳаҳои хурд аз боби 12.