diff options
| author | Leitwolf | 2026-11-16 14:49:23 +0300 |
|---|---|---|
| committer | GitHub | 2026-11-16 14:49:23 +0300 |
| commit | 324048967d1fb198e3489b1722ca1ff317338550 (patch) | |
| tree | e270ad6dc86200cc79cbdccfa1ef6de1da8aff0d /content/ru-RU/docs/1.getting-started | |
| parent | 45c1bb14326cbee8fe57c6f639550e8eadd81f0a (diff) | |
| parent | 4ee77681379619b3fab7b8b33446a67164216cc8 (diff) | |
| download | tazel.net-main.tar.gz | |
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.md | 51 | ||||
| -rw-r--r-- | content/ru-RU/docs/1.getting-started/2.first-project.md | 165 | ||||
| -rw-r--r-- | content/ru-RU/docs/1.getting-started/3.releases.md | 35 |
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. |