Build the site of Tazel with Nuxt

tazel.net is the site of Tazel itself: a Nuxt 4 site generated to static
files, in en-US, de-DE, ru-RU and he-IL, light by default with a dark
theme that is kept per browser.

- Home: the release and its kind, what Tazel does, the steps from a
  project file to a program, and a sample.
- Docs: Markdown through Nuxt Content, highlighted by Shiki (Kotlin,
  shell, PowerShell, and Tala through the grammar of the compiler
  repository), with a tree of the pages on the left, the headings of
  the page on the right, and the previous and next pages below.
  Installation, a first project, and releases and support are written
  in every language; the reference (commands, project file, lockfile,
  plugins, how Tazel works) is copied from the Documents of Tazel by
  scripts/sync-docs.mjs, and a language without a page shows the
  English one with a note.
- Every page has its canonical address, hreflang alternates and a
  sitemap entry; generation fails on a link to a page that does not
  exist.

CI checks the format, the types and the language helpers, generates
the site and runs Dependency Review on pull requests.

3 files changed, 131 insertions, 0 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
new file mode 100644
index 0000000..cc1fbc4
--- /dev/null
+++ b/content/ru-RU/docs/1.getting-started/1.installation.md
@@ -0,0 +1,42 @@
+---
+title: Установка
+description: Установка Tazel и инструментов Tala, которые он запускает.
+---
+
+<!-- SPDX-FileCopyrightText: 2026 Progmasoft <support@progmasoft.com> -->
+<!-- SPDX-License-Identifier: AGPL-3.0-or-later WITH AdditionRef-Progmasoft-Patent-Grant-1.1 -->
+
+Tazel — программа на Kotlin для JVM, поэтому машине нужна среда Java 25 или новее. Сам он ничего не компилирует:
+`check`, `build`, `run` и `test` запускают Talac, `fmt` запускает talafmt, а `lint` — talalint.
+
+## Сборка Tazel
+
+Tazel собирается из исходного кода обёрткой Gradle, которой нужен JDK 25. `installDist` записывает запускающие файлы
+`tazel` и `tazel.bat` в `build/install/tazel/bin`. Добавьте эту папку в `PATH`.
+
+```bash [Linux и macOS]
+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
+```
+
+`tazel version` выводит установленную версию.
+
+## Инструменты Tala
+
+Каждый инструмент Tazel ищет через `TAZEL_TALAC`, `TAZEL_TALAFMT` или `TAZEL_TALALINT`, затем в своей установке, затем
+в `PATH`. У каждого инструмента свои выпуски:
+
+| Инструмент | Нужен для                       | Исходный код                                                  |
+| ---------- | ------------------------------- | ------------------------------------------------------------- |
+| 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) |
+
+Дальше: [первый проект](/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
new file mode 100644
index 0000000..1e4ef10
--- /dev/null
+++ b/content/ru-RU/docs/1.getting-started/2.first-project.md
@@ -0,0 +1,60 @@
+---
+title: Первый проект
+description: Проект Tala в нескольких строках, его сборка, запуск, форматирование и проверка.
+---
+
+<!-- SPDX-FileCopyrightText: 2026 Progmasoft <support@progmasoft.com> -->
+<!-- SPDX-License-Identifier: AGPL-3.0-or-later WITH AdditionRef-Progmasoft-Patent-Grant-1.1 -->
+
+Проект — это папка с файлом проекта. Его исходники — файлы `.tala` в `Sources/`, а `entry` называет класс, чей
+`public static void Main()` запускает программу.
+
+```kotlin [BUILD.kts]
+project {
+  name = "Example"
+}
+
+sources {
+  executable {
+    entry = "Example.Program"
+  }
+}
+```
+
+```tala [Sources/Main.tala]
+namespace Example;
+
+public class Program {
+    public static void Main() {
+        Console.Println("Hello from Tala!");
+    }
+}
+```
+
+## Сборка и запуск
+
+```bash [terminal]
+tazel build
+tazel run -- first second
+```
+
+`tazel build` записывает `build/debug/Example`, в Windows — `Example.exe`. `tazel run` собирает программу и запускает
+её; всё после `--` без разбора передаётся программе. Повторный `tazel build` без изменений сообщает, что цель актуальна,
+и не запускает компилятор.
+
+## Форматирование и проверка
+
+```bash [terminal]
+tazel fmt -- --check
+tazel lint -- --fix
+```
+
+Параметры после `--` передаются talafmt и talalint, поэтому `tazel fmt -- --check` только сообщает, а
+`tazel lint -- --fix` применяет исправления, какие может.
+
+::note
+ViGet не раздаёт пакеты Tala. Проект, объявляющий зависимость сборки, библиотечные цели и создание `.vipkg` отклоняются
+по имени с кодом выхода 1.
+::
+
+Дальше: каждый блок [файла проекта](/docs/reference/project-file) и каждая [команда](/docs/reference/commands).
diff --git a/content/ru-RU/docs/1.getting-started/3.releases.md b/content/ru-RU/docs/1.getting-started/3.releases.md
new file mode 100644
index 0000000..bcf1d51
--- /dev/null
+++ b/content/ru-RU/docs/1.getting-started/3.releases.md
@@ -0,0 +1,29 @@
+---
+title: Выпуски и поддержка
+description: Как нумеруется Tazel и сколько поддерживаются выпуски Rolling, LTS и ELTS.
+---
+
+<!-- SPDX-FileCopyrightText: 2026 Progmasoft <support@progmasoft.com> -->
+<!-- SPDX-License-Identifier: AGPL-3.0-or-later WITH AdditionRef-Progmasoft-Patent-Grant-1.1 -->
+
+Версия Tazel состоит из четырёх чисел: `MAJOR.SEMIMAJOR.MINOR.PATCH`, например `0.4.0.3`. У каждого выпуска есть тег
+`tazel-<version>` и примечания на [GitHub](https://github.com/Progmasoft/tazel/releases).
+
+## Три вида выпусков
+
+| Вид | Поддержка | Какие выпуски |
+| --- | --- | --- |
+| 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 месяцев.
+- **LTS** остаётся на одной линии 5 лет — для проектов, которые обновляются время от времени.
+- **ELTS** остаётся на одной линии 12 лет — для продуктов, которые долго поставляют программы на Tala.
+
+Каждый выпуск Tazel до `1.0.0.0` — Rolling.