Ҳуҷҷатҳои 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 иҷро кунед. Ин услуб дар тамоми ҳуҷҷатҳо истифода мешавад.
# Санҷидани версияҳо
node -v
npm -v
# Насби SomonScript CLI
npm install -g @lindentech/somon-script
# Санҷиш
somon --version
Қадами 2: «Салом ҷаҳон» бо SomonScript
Акнун аввалин барномаи худро менависем. Ин мисол дар қисмҳои дигар низ такрор мешавад ва барои синф хеле мувофиқ аст.
// Аввалин барнома
чоп.сабт("Салом ҷаҳон!");Чӣ бояд кард?
- Папкаи нав, масалан somon-project созед.
- Файли салом.som-ро дар он папка эҷод кунед.
- Кодро нусха гирифта, ба файл гузоред ва дар терминал иҷро кунед.
somon run салом.som
# Натиҷа: Салом ҷаҳон!Қадами 3: Асосҳои забони SomonScript
Барои хондани тафсилоти пурра, омӯзгорон метавонанд матни пурратарро аз файлиҳои Markdown дар docs/book истифода баранд. Дар ин ҷо танҳо харитаи умумӣ барои синф оварда шудааст.
Асосҳои синтаксис
Тағйирёбандаҳо, намудҳои маълумот, операторҳо ва шартҳо.
Функсияҳо ва ниҳодҳо
Функсияҳои оддӣ, рекурсия ва кори такроршаванда.
Синфҳо, ООП ва модулҳо
Барои лоиҳаҳои калон: синфҳо, меросбарӣ ва тақсим кардани код ба файлҳо.
Системаи намудҳо ва хатогиҳо
Намудҳои пешрафта, санҷиши хатогиҳо ва истиснокҳо барои барномаҳои боэътимод.
CLI-и SomonScript дар як ҷадвал
Фармонҳои поён аксар вақт дар мисолҳо ва машқҳо истифода мешаванд. Барои мактабҳо хуб аст, ки ин ҷадвалро чоп кунанд ва дар синф овезанд.
| Фармон | Тавсиф |
|---|---|
| somon run | Компилятсия ва иҷрои файли .som. |
| somon compile | Табдил додан ба JavaScript бидуни иҷро. |
| somon bundle | Якҷо кардани чанд файл ба як .js. |
| somon module-info | Дидани вобастагиҳои модулҳо. |
Роҳнамо барои донишҷӯён
Агар шумо худатон меомӯзед, роҳи зеринро тавсия медиҳем:
- Аз ин саҳифа ва қадамҳои насб оғоз кунед.
- Бобҳои 1–5-и маводро хонед ва ҳар як мисолро иҷро кунед.
- Аз боби 6 сар карда, лоиҳаҳои хурд (калькулятор, китобхона) созед.
Роҳнамо барои омӯзгорон
Ин ҳуҷҷатҳоро метавон ба осонӣ ба курси 6–8 ҳафтаӣ табдил дод. Пешниҳод:
- Ҳафтаҳои 1–2: Бобҳои 1–3, иҷрои мисолҳои оддӣ ва машқҳои дохили мавод.
- Ҳафтаҳои 3–4: Бобҳои 4–6, тамаркуз ба давраҳо ва функсияҳо.
- Ҳафтаҳои 5–6: Бобҳои 7–9, сохтани лоиҳаҳои хурд аз боби 12.
