Read-only mirrors. Development, issues and pull requests are on GitHub.

summaryrefslogtreecommitdiffhomepage
path: root/content/ru-RU/docs/1.getting-started
diff options
context:
space:
mode:
authorLeitwolf2026-11-16 14:49:23 +0300
committerGitHub2026-11-16 14:49:23 +0300
commit324048967d1fb198e3489b1722ca1ff317338550 (patch)
treee270ad6dc86200cc79cbdccfa1ef6de1da8aff0d /content/ru-RU/docs/1.getting-started
parent45c1bb14326cbee8fe57c6f639550e8eadd81f0a (diff)
parent4ee77681379619b3fab7b8b33446a67164216cc8 (diff)
downloadtazel.net-main.tar.gz
Merge pull request #10 from Progmasoft/content/new-tazelHEADmain
Rewrite the site for the Tazel of C, C++, Objective-C, Objective-C++ and Zig
Diffstat (limited to 'content/ru-RU/docs/1.getting-started')
-rw-r--r--content/ru-RU/docs/1.getting-started/1.installation.md51
-rw-r--r--content/ru-RU/docs/1.getting-started/2.first-project.md165
-rw-r--r--content/ru-RU/docs/1.getting-started/3.releases.md35
3 files changed, 181 insertions, 70 deletions
diff --git a/content/ru-RU/docs/1.getting-started/1.installation.md b/content/ru-RU/docs/1.getting-started/1.installation.md
index a64ccd9..fc0aebd 100644
--- a/content/ru-RU/docs/1.getting-started/1.installation.md
+++ b/content/ru-RU/docs/1.getting-started/1.installation.md
@@ -1,42 +1,49 @@
---
title: Установка
-description: Установка Tazel и инструментов Tala, которые он запускает.
+description: Собрать Tazel из исходного кода и установить компиляторы и инструменты, которые он вызывает.
---
<!-- SPDX-FileCopyrightText: 2026 Progmasoft <[email protected]> -->
<!-- SPDX-License-Identifier: AGPL-3.0-or-later -->
-Tazel — программа на Kotlin для JVM, поэтому машине нужна среда Java 25 или новее. Сам он ничего не компилирует:
-`check`, `build`, `run` и `test` запускают Talac, `fmt` запускает talafmt, а `lint` — talalint.
+Tazel — программа на Kotlin для JVM. Сам он ничего не компилирует: он вызывает компиляторы и инструменты, найденные в
+`PATH`. Ни одна версия ещё не выпущена, поэтому Tazel собирается из исходного кода.
-## Сборка Tazel
+## Что нужно машине
+
+| Для чего | Установить |
+| --- | --- |
+| сам Tazel | JDK 25, например Eclipse Temurin 25 |
+| цели на C, C++, Objective-C и Objective-C++ | Clang или GCC; Clang собирает и для других троек |
+| цели на Zig и `zig cc` как компилятор C | Zig |
+| `tazel fmt` | clang-format для семейства C, `zig fmt` (входит в Zig) для Zig |
+| `tazel lint` | clang-tidy |
-Tazel собирается из исходного кода обёрткой Gradle, которой нужен JDK 25. `installDist` записывает запускающие файлы
-`tazel` и `tazel.bat` в `build/install/tazel/bin`. Добавьте эту папку в `PATH`.
+Каждый инструмент нужен только для команд и целей, которые им пользуются: модулю только на C++ Zig не нужен.
-```bash [Linux и macOS]
+## Сборка Tazel
+
+```bash
git clone https://github.com/Progmasoft/tazel.git
cd tazel
./gradlew installDist
```
-```powershell [Windows]
-git clone https://github.com/Progmasoft/tazel.git
-cd tazel
-.\gradlew.bat installDist
-```
+В Windows выполните в PowerShell `gradlew.bat installDist`. Программа находится в `build/install/tazel`: добавьте её
+каталог `bin` в `PATH` и проверьте:
-`tazel version` выводит установленную версию.
+```bash
+tazel version
+```
-## Инструменты Tala
+```text
+tazel 0.1.0
+```
-Каждый инструмент Tazel ищет через `TAZEL_TALAC`, `TAZEL_TALAFMT` или `TAZEL_TALALINT`, затем в своей установке, затем
-в `PATH`. У каждого инструмента свои выпуски:
+## Где Tazel ищет инструменты
-| Инструмент | Нужен для | Исходный код |
-| ---------- | ------------------------------- | ------------------------------------------------------------- |
-| Talac | `check`, `build`, `run`, `test` | [Progmasoft/tala](https://github.com/Progmasoft/tala) |
-| talafmt | `fmt` | [Progmasoft/talafmt](https://github.com/Progmasoft/talafmt) |
-| talalint | `lint` | [Progmasoft/talalint](https://github.com/Progmasoft/talalint) |
+Tazel берёт `clang`, `gcc`, `zig`, `clang-format` и `clang-tidy` из `PATH`. Цель может назвать свой компилятор:
+`compiler = Compiler.CLANG`, `Compiler.GCC` или `Compiler.ZIG_CC`; без этого Tazel берёт первый найденный, который
+собирает для тройки цели. Каждый инструмент читает свою конфигурацию, например `.clang-format` и `.clang-tidy`.
-Дальше: [первый проект](/docs/getting-started/first-project).
+Далее: [ваш первый проект](/docs/getting-started/first-project).
diff --git a/content/ru-RU/docs/1.getting-started/2.first-project.md b/content/ru-RU/docs/1.getting-started/2.first-project.md
index cc7d0aa..e56c014 100644
--- a/content/ru-RU/docs/1.getting-started/2.first-project.md
+++ b/content/ru-RU/docs/1.getting-started/2.first-project.md
@@ -1,60 +1,161 @@
---
-title: Первый проект
-description: Проект Tala в нескольких строках, его сборка, запуск, форматирование и проверка.
+title: Ваш первый проект
+description: Модуль с библиотекой на C, программой на C++ и тестом, собранный, запущенный и проверенный Tazel.
---
<!-- SPDX-FileCopyrightText: 2026 Progmasoft <[email protected]> -->
<!-- SPDX-License-Identifier: AGPL-3.0-or-later -->
-Проект — это папка с файлом проекта. Его исходники — файлы `.tala` в `Sources/`, а `entry` называет класс, чей
-`public static void Main()` запускает программу.
+Модуль — это каталог с `MODULE.kts` в корне. Каждый каталог ниже с `BUILD.kts` — пакет, и у каждой цели пакета есть
+метка: `//app/:greeter` — это цель `greeter` из `app/BUILD.kts`.
-```kotlin [BUILD.kts]
-project {
- name = "Example"
+```text
+greeter/
+├── MODULE.kts
+├── core/
+│ ├── BUILD.kts
+│ ├── include/core/greet.h
+│ └── src/greet.c
+├── app/
+│ ├── BUILD.kts
+│ └── src/main.cpp
+└── tests/
+ ├── BUILD.kts
+ └── greet_test.cpp
+```
+
+## Модуль
+
+```kotlin
+// MODULE.kts
+module {
+ name = "greeter"
+ version = "0.1.0"
}
+```
+
+## Библиотека на C
+
+```kotlin
+// core/BUILD.kts
+isPublic = true
+
+c.staticlib("core") {
+ sources(glob("src/*.c"))
+ headers("include")
+ standard = CStandard.C17
+}
+```
-sources {
- executable {
- entry = "Example.Program"
- }
+`isPublic = true` позволяет другим пакетам модуля зависеть от целей этого файла. `headers("include")` делает
+`#include <core/greet.h>` доступным в `core` и в каждой цели, которая от неё зависит.
+
+```c
+// core/include/core/greet.h
+#pragma once
+const char *greeting(void);
+```
+
+```c
+// core/src/greet.c
+#include <core/greet.h>
+const char *greeting(void) { return "Hello"; }
+```
+
+## Программа на C++
+
+```kotlin
+// app/BUILD.kts
+cpp.bin("greeter") {
+ sources(glob("src/*.cpp"))
+ depends("//core/:core")
+ standard = CppStandard.CPP20
}
```
-```tala [Sources/Main.tala]
-namespace Example;
+```cpp
+// app/src/main.cpp
+#include <cstdio>
+extern "C" {
+#include <core/greet.h>
+}
-public class Program {
- public static void Main() {
- Console.Println("Hello from Tala!");
- }
+int main(int argc, char **argv)
+{
+ std::printf("%s, %s!\n", greeting(), argc > 1 ? argv[1] : "world");
}
```
## Сборка и запуск
-```bash [terminal]
-tazel build
-tazel run -- first second
+```bash
+tazel build //app/:greeter
```
-`tazel build` записывает `build/debug/Example`, в Windows — `Example.exe`. `tazel run` собирает программу и запускает
-её; всё после `--` без разбора передаётся программе. Повторный `tazel build` без изменений сообщает, что цель актуальна,
-и не запускает компилятор.
+```text
+ Compiling //core/:core src/greet.c
+ Archiving //core/:core
+ Compiling //app/:greeter src/main.cpp
+ Linking //app/:greeter
+ Built 2 target(s) for x86_64-unknown-linux-gnu, debug; 4 command(s) run
+```
-## Форматирование и проверка
+Вторая сборка ничего не запускает, потому что ни один вход не изменился:
-```bash [terminal]
-tazel fmt -- --check
-tazel lint -- --fix
+```text
+ Built 2 target(s) for x86_64-unknown-linux-gnu, debug; 0 command(s) run
```
-Параметры после `--` передаются talafmt и talalint, поэтому `tazel fmt -- --check` только сообщает, а
-`tazel lint -- --fix` применяет исправления, какие может.
+`tazel run` собирает одну программу и запускает её; то, что идёт после `--`, передаётся программе:
+
+```bash
+tazel run //app/:greeter -- Ada
+```
+
+```text
+Hello, Ada!
+```
+
+Результаты лежат в `.tazel/out/<triple>/<mode>`, здесь `.tazel/out/x86_64-unknown-linux-gnu/debug`. `--release`
+собирает в режиме release.
+
+## Тест
+
+```kotlin
+// tests/BUILD.kts
+cpp.test("greet") {
+ sources("greet_test.cpp")
+ depends("//core/:core")
+}
+```
+
+```cpp
+// tests/greet_test.cpp
+#include <cstring>
+extern "C" {
+#include <core/greet.h>
+}
+
+int main() { return std::strcmp(greeting(), "Hello") == 0 ? 0 : 1; }
+```
+
+Тест проходит, если его программа завершается с кодом 0. `//tests/...` берёт каждую цель в `tests/` и ниже:
+
+```bash
+tazel test //tests/...
+```
+
+```text
+ Compiling //tests/:greet greet_test.cpp
+ Linking //tests/:greet
+ Built 2 target(s) for x86_64-unknown-linux-gnu, debug; 2 command(s) run
+ PASSED //tests/:greet in 0.0s
+ Tested 1 test(s): 1 passed, 0 failed
+```
::note
-ViGet не раздаёт пакеты Tala. Проект, объявляющий зависимость сборки, библиотечные цели и создание `.vipkg` отклоняются
-по имени с кодом выхода 1.
+Без метки `build`, `run` и `test` берут пакет текущего каталога. `//...` берёт весь модуль.
::
-Дальше: каждый блок [файла проекта](/docs/reference/project-file) и каждая [команда](/docs/reference/commands).
+Далее: [команды](/docs/reference/commands) и все настройки [MODULE.kts](/docs/reference/module-file) и
+[BUILD.kts](/docs/reference/build-file).
diff --git a/content/ru-RU/docs/1.getting-started/3.releases.md b/content/ru-RU/docs/1.getting-started/3.releases.md
index 0727e65..3ee0188 100644
--- a/content/ru-RU/docs/1.getting-started/3.releases.md
+++ b/content/ru-RU/docs/1.getting-started/3.releases.md
@@ -1,29 +1,32 @@
---
-title: Выпуски и поддержка
-description: Как нумеруется Tazel и сколько поддерживаются выпуски Rolling, LTS и ELTS.
+title: Выпуски
+description: Как Tazel нумерует версии и сколько поддерживается каждый вид выпуска.
---
<!-- SPDX-FileCopyrightText: 2026 Progmasoft <[email protected]> -->
<!-- SPDX-License-Identifier: AGPL-3.0-or-later -->
-Версия Tazel состоит из четырёх чисел: `MAJOR.SEMIMAJOR.MINOR.PATCH`, например `0.4.0.3`. У каждого выпуска есть тег
-`tazel-<version>` и примечания на [GitHub](https://github.com/Progmasoft/tazel/releases).
+Ни одна версия Tazel ещё не выпущена; первой будет 0.1.0. Что в неё уже вошло, описано в
+[разделе Unreleased журнала изменений](https://github.com/Progmasoft/tazel/blob/main/CHANGELOG.md#unreleased).
-## Три вида выпусков
+## Номера версий
+
+Версии следуют [Semantic Versioning](https://semver.org): `MAJOR.MINOR.PATCH`. Патч-выпуск исправляет, минорный —
+добавляет, а мажорный может изменить то, что работало раньше. Теги называются `tazel-0.1.0`, и опубликованный тег
+никогда не переносится.
+
+## Виды выпусков
| Вид | Поддержка | Какие выпуски |
| --- | --- | --- |
-| Rolling | 6 месяцев | каждый выпуск, который не LTS и не ELTS, и каждый выпуск до `1.0.0.0` |
-| LTS (Long-Term Support) | 5 лет | линия `A.0` каждого `MAJOR`, начиная с `1.0.0.0` |
-| ELTS (Extended Long-Term Support) | 12 лет | линия LTS для `MAJOR` 1, 4, 7 и каждого третьего после них |
-
-Срок считается от первого выпуска линии. Поддерживаемая линия получает исправления ошибок и проблем безопасности
-в виде новых выпусков `MINOR` и `PATCH`; новых возможностей она не получает, они приходят в выпусках Rolling.
+| Rolling | 6 месяцев | каждый выпуск до 1.0.0 и каждый выпуск вне линии LTS или ELTS |
+| LTS | 5 лет | линия MAJOR.0 остальных мажорных версий: 2.0.x, 3.0.x, 5.0.x, 6.0.x и далее |
+| ELTS | 12 лет | линия MAJOR.0 мажорных версий 1, 4, 7 и каждой третьей после них: 1.0.x, 4.0.x, 7.0.x |
-## Что выбрать
+Поддерживаемая линия получает только исправления, в виде своих патч-выпусков.
-- **Rolling** первым приносит каждую возможность. Берите новейший выпуск; предыдущий поддерживается ещё 6 месяцев.
-- **LTS** остаётся на одной линии 5 лет — для проектов, которые обновляются время от времени.
-- **ELTS** остаётся на одной линии 12 лет — для продуктов, которые долго поставляют программы на Tala.
+## Прежний Tazel
-Каждый выпуск Tazel до `1.0.0.0` — Rolling.
+Прежняя программа с тем же именем, версии с 0.1.0 по 0.4.0.3, находится в архиве
+[Progmasoft/tazel-legacy](https://github.com/Progmasoft/tazel-legacy). Её версии — не версии этого Tazel, который
+начинает снова с 0.1.0.