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 /app | |
| 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 'app')
| -rw-r--r-- | app/assets/site.css | 10 | ||||
| -rw-r--r-- | app/components/DocsTree.vue | 4 | ||||
| -rw-r--r-- | app/components/ProseText.vue | 2 | ||||
| -rw-r--r-- | app/components/SiteFooter.vue | 4 | ||||
| -rw-r--r-- | app/components/SiteHeader.vue | 2 | ||||
| -rw-r--r-- | app/composables/useDocs.ts | 2 | ||||
| -rw-r--r-- | app/composables/useSiteLocale.ts | 7 | ||||
| -rw-r--r-- | app/content/chrome.ts | 80 | ||||
| -rw-r--r-- | app/content/home.ts | 269 | ||||
| -rw-r--r-- | app/content/locales.ts | 11 | ||||
| -rw-r--r-- | app/content/site.ts | 21 | ||||
| -rw-r--r-- | app/pages/[[locale]]/docs/[...slug].vue | 4 | ||||
| -rw-r--r-- | app/pages/[[locale]]/index.vue | 26 |
13 files changed, 208 insertions, 234 deletions
diff --git a/app/assets/site.css b/app/assets/site.css index 2ae7ae3..9594370 100644 --- a/app/assets/site.css +++ b/app/assets/site.css @@ -239,7 +239,7 @@ pre { line-height: 1.65; } -@media (max-width: 720px) { +@media (width <= 720px) { .section { padding-block: 60px; } @@ -324,6 +324,14 @@ pre { white-space: normal; } +/* On a phone a path can be wider than the column: there code breaks where it must. */ +@media (width <= 600px) { + .prose :not(pre) > code { + white-space: normal; + overflow-wrap: anywhere; + } +} + .prose pre code { white-space: pre; } diff --git a/app/components/DocsTree.vue b/app/components/DocsTree.vue index 32d0312..83c02a9 100644 --- a/app/components/DocsTree.vue +++ b/app/components/DocsTree.vue @@ -77,10 +77,6 @@ summary svg { transition: transform 0.15s; } -:root[dir="rtl"] summary svg { - transform: scaleX(-1); -} - details[open] > summary svg { transform: rotate(90deg); } diff --git a/app/components/ProseText.vue b/app/components/ProseText.vue index 1a58f93..51f8bfb 100644 --- a/app/components/ProseText.vue +++ b/app/components/ProseText.vue @@ -8,7 +8,7 @@ <script setup lang="ts"> const props = defineProps<{ text: string }>(); -// A flag starts a word: the dash of "Build-System" or of the Hebrew "ב-Kotlin" is not one. +// A flag starts a word: the dash of "Build-System" is not one. const flag = /((?<![\p{L}\p{N}_-])--?[A-Za-z][\w-]*|(?<![\p{L}\p{N}_-])--(?=[\s.,;:)]|$))/u; const parts = computed(() => props.text diff --git a/app/components/SiteFooter.vue b/app/components/SiteFooter.vue index 8d67c11..24986d6 100644 --- a/app/components/SiteFooter.vue +++ b/app/components/SiteFooter.vue @@ -19,8 +19,6 @@ const words = computed(() => chrome[locale.value]); <nav :aria-label="words.footer.family"> <h2>{{ words.footer.family }}</h2> <ul> - <li><a :href="family.tala">Tala</a></li> - <li><a :href="family.talac">Talac</a></li> <li><a :href="family.viget">ViGet</a></li> </ul> </nav> @@ -102,7 +100,7 @@ a:hover { margin: 0; } -@media (max-width: 760px) { +@media (width <= 760px) { .grid { grid-template-columns: 1fr 1fr; } diff --git a/app/components/SiteHeader.vue b/app/components/SiteHeader.vue index 304f74b..924af82 100644 --- a/app/components/SiteHeader.vue +++ b/app/components/SiteHeader.vue @@ -201,7 +201,7 @@ watch( font-size: 0.94rem; } -@media (max-width: 760px) { +@media (width <= 760px) { .links { display: none; } diff --git a/app/composables/useDocs.ts b/app/composables/useDocs.ts index ac5598b..2167ba9 100644 --- a/app/composables/useDocs.ts +++ b/app/composables/useDocs.ts @@ -8,7 +8,7 @@ export const docCollections = { "en-US": "docs_en", "de-DE": "docs_de", "ru-RU": "docs_ru", - "he-IL": "docs_he", + "fr-FR": "docs_fr", } as const satisfies Record<Locale, string>; /** A group of the documentation tree and the pages in it, in their order. */ diff --git a/app/composables/useSiteLocale.ts b/app/composables/useSiteLocale.ts index 1596751..45e3885 100644 --- a/app/composables/useSiteLocale.ts +++ b/app/composables/useSiteLocale.ts @@ -7,7 +7,6 @@ import { localePath, locales, pageOfPath, - textDirection, type Locale, } from "~/content/locales"; import { siteUrl } from "~/content/site"; @@ -25,14 +24,14 @@ export function useSiteLocale() { } /** - * The head of a page: its title and description, the language and direction of the document, - * and the address of the page in every language. + * The head of a page: its title and description, the language of the document, which runs left + * to right in every language of the site, and the address of the page in every language. */ export function usePageHead(text: () => { title: string; description: string }) { const { locale, page } = useSiteLocale(); const url = (target: Locale) => `${siteUrl}${localePath(target, page.value)}`; useHead(() => ({ - htmlAttrs: { lang: locale.value, dir: textDirection(locale.value) }, + htmlAttrs: { lang: locale.value, dir: "ltr" }, link: [ { rel: "canonical", href: url(locale.value) }, ...locales.map((target) => ({ diff --git a/app/content/chrome.ts b/app/content/chrome.ts index 1e07d54..6bae086 100644 --- a/app/content/chrome.ts +++ b/app/content/chrome.ts @@ -17,10 +17,10 @@ export const chrome: Record<Locale, Chrome> = { copy: "Copy", copied: "Copied", footer: { - tagline: "The build system and package manager of Tala.", - family: "Tala", + tagline: "The build system for C, C++, Objective-C, Objective-C++ and Zig.", + family: "Packages", company: "Progmasoft", - license: "Tazel is free software under MPL-2.0 with the Progmasoft Exception 2.0.", + license: "Tazel is free software under the MIT license.", }, docsNav: { groups: { @@ -54,10 +54,10 @@ export const chrome: Record<Locale, Chrome> = { copy: "Kopieren", copied: "Kopiert", footer: { - tagline: "Das Build-System und der Paketmanager von Tala.", - family: "Tala", + tagline: "Das Build-System für C, C++, Objective-C, Objective-C++ und Zig.", + family: "Pakete", company: "Progmasoft", - license: "Tazel ist freie Software unter MPL-2.0 mit der Progmasoft Exception 2.0.", + license: "Tazel ist freie Software unter der MIT-Lizenz.", }, docsNav: { groups: { @@ -80,7 +80,7 @@ export const chrome: Record<Locale, Chrome> = { }, }, "ru-RU": { - skip: "Перейти к содержанию", + skip: "Перейти к содержимому", docs: "Документ", getStarted: "Начать", source: "Исходный код", @@ -91,14 +91,14 @@ export const chrome: Record<Locale, Chrome> = { copy: "Копировать", copied: "Скопировано", footer: { - tagline: "Система сборки и менеджер пакетов Tala.", - family: "Tala", + tagline: "Система сборки для C, C++, Objective-C, Objective-C++ и Zig.", + family: "Пакеты", company: "Progmasoft", - license: "Tazel — свободное ПО под MPL-2.0 с Progmasoft Exception 2.0.", + license: "Tazel — свободное программное обеспечение под лицензией MIT.", }, docsNav: { groups: { - "getting-started": "Начало работы", + "getting-started": "Первые шаги", reference: "Справочник", extending: "Расширение Tazel", internals: "Устройство", @@ -107,50 +107,50 @@ export const chrome: Record<Locale, Chrome> = { englishOnly: "Эта страница есть только на английском.", previous: "Назад", next: "Далее", - edit: "Изменить страницу на GitHub", + edit: "Изменить эту страницу на GitHub", pages: "Документация", }, notFound: { title: "Страница не найдена", - text: "По этому адресу страницы нет.", + text: "По этому адресу нет страницы.", home: "На главную", }, }, - "he-IL": { - skip: "דילוג לתוכן", - docs: "מסמך", - getStarted: "מתחילים", - source: "קוד מקור", - language: "שפה", - toDark: "מעבר לערכת הנושא הכהה", - toLight: "מעבר לערכת הנושא הבהירה", - menu: "תפריט", - copy: "העתקה", - copied: "הועתק", + "fr-FR": { + skip: "Aller au contenu", + docs: "Document", + getStarted: "Commencer", + source: "Code source", + language: "Langue", + toDark: "Passer au thème sombre", + toLight: "Passer au thème clair", + menu: "Menu", + copy: "Copier", + copied: "Copié", footer: { - tagline: "מערכת הבנייה ומנהל החבילות של Tala.", - family: "Tala", + tagline: "Le système de build pour C, C++, Objective-C, Objective-C++ et Zig.", + family: "Paquets", company: "Progmasoft", - license: "Tazel היא תוכנה חופשית תחת MPL-2.0 עם Progmasoft Exception 2.0.", + license: "Tazel est un logiciel libre sous licence MIT.", }, docsNav: { groups: { - "getting-started": "צעדים ראשונים", - reference: "עיון", - extending: "הרחבת Tazel", - internals: "מבפנים", + "getting-started": "Premiers pas", + reference: "Référence", + extending: "Étendre Tazel", + internals: "Fonctionnement interne", }, - onThisPage: "בדף הזה", - englishOnly: "הדף הזה זמין באנגלית בלבד.", - previous: "הקודם", - next: "הבא", - edit: "עריכת הדף ב-GitHub", - pages: "תיעוד", + onThisPage: "Sur cette page", + englishOnly: "Cette page n’existe qu’en anglais.", + previous: "Précédent", + next: "Suivant", + edit: "Modifier cette page sur GitHub", + pages: "Documentation", }, notFound: { - title: "הדף לא נמצא", - text: "אין דף בכתובת הזאת.", - home: "לדף הבית", + title: "Page introuvable", + text: "Il n’y a pas de page à cette adresse.", + home: "Vers l’accueil", }, }, }; diff --git a/app/content/home.ts b/app/content/home.ts index fc4cb9d..9f592bf 100644 --- a/app/content/home.ts +++ b/app/content/home.ts @@ -4,274 +4,273 @@ import type { Locale } from "./locales"; import type { HomeText } from "./types"; -export const projectSample = `project { - name = "Example" - version = "0.1.0" -} - -compiler { - buildMode = BuildMode.RELEASE - warnings = Warnings.ALL -} - -sources { - executable { - entry = "Example.Program" - } +export const projectSample = `// app/BUILD.kts +cpp.bin("greeter") { + sources(glob("src/*.cpp")) + depends("//core/:core") + standard = CppStandard.CPP20 }`; -export const terminalSample = `$ tazel build - Compiling Example (Example, 12 sources) - Finished build in 4.21s -$ tazel build - Fresh Example (Example, 12 sources) - Finished build in 0.31s -$ tazel run -- --port 8080`; +// The output of Tazel 0.1.0 in development on the greeter of the first project. +export const terminalSample = `$ tazel build //app/:greeter + 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 +$ tazel build //app/:greeter + Built 2 target(s) for x86_64-unknown-linux-gnu, debug; 0 command(s) run +$ tazel run //app/:greeter -- Ada + Built 2 target(s) for x86_64-unknown-linux-gnu, debug; 0 command(s) run +Hello, Ada!`; export const home: Record<Locale, HomeText> = { "en-US": { - title: "Tazel — The build system of Tala", + title: "Tazel — A build system for C, C++, Objective-C, Objective-C++ and Zig", description: - "Tazel builds, runs, tests, formats and lints Tala projects from one Kotlin project file, and keeps their dependencies in a lockfile.", - eyebrow: "The build system of Tala", - headline: "One project file. One command for each job.", - lead: "Tazel reads a Kotlin project file, starts Talac, talafmt and talalint for you, and records every dependency in a lockfile. The name joins Tala and Bazel.", + "Tazel builds, runs, tests, formats and lints C, C++, Objective-C, Objective-C++ and Zig from project files written in Kotlin.", + eyebrow: "C, C++, Objective-C, Objective-C++ and Zig", + headline: "Kotlin project files. Builds that redo only what changed.", + lead: "Tazel reads a MODULE.kts at the root of a module and a BUILD.kts in each package, calls the compilers it finds, and runs again only the commands whose inputs changed.", start: "Get started", commands: "Commands", - release: "Tazel {version}", + release: "Tazel {version} in development", featuresHeading: "What Tazel does", featuresLead: - "One program for the whole life of a Tala project, from the first build to the published package.", + "One program for building, running, testing, formatting and linting native code, whatever the language of each target.", features: [ { - title: "A project file in Kotlin", - text: "BUILD.kts is a Kotlin script with a typed DSL, so an editor completes and checks it. Tazel runs it with its own scripting host: a JRE 25 is all a machine needs.", + title: "Project files in Kotlin", + text: "MODULE.kts and BUILD.kts are Kotlin scripts with a typed DSL, so an editor completes and checks them. A setting a language or a kind of target does not have is a compile error of the project file.", }, { - title: "Only what changed", - text: "A target compiles again only when its sources, its settings or the compiler changed. Everything else is reported as fresh and left alone.", + title: "Five languages, one graph", + text: "Targets of C, C++, Objective-C, Objective-C++ and Zig are programs, static or shared libraries and tests. Each target has one language; targets meet through depends.", }, { - title: "The whole machine", - text: "Plugin steps, compilations and test suites are units of one graph and run side by side. --jobs, --cpus and --memory set the limits, and --profile writes a trace.", + title: "Only what changed", + text: "Each compile, archive and link runs again only when its command line, its environment or the content of a file it read changed. Touching a file reruns nothing.", }, { - title: "Cache and remote builds", - text: "Build results go into a cache that a team can share. --remote-executor compiles on a trusted machine that runs tazel remote serve.", + title: "For every triple", + text: "A target names its LLVM target triples, and its block runs for each triple and build mode. Clang and zig cc build for other machines; --triple picks one.", }, { - title: "A lockfile you can read", - text: "LOCK.sqlite3 records what a project depends on, LOCK.dump writes it as text for review, and tazel lock graph shows who uses what.", + title: "Tests as targets", + text: "Tests have sizes, timeouts, shards and tags, are retried when flaky, and are not run again while their program, data and arguments are the same.", }, { - title: "Plugins in Kotlin", - text: "A plugin is a JAR, local or from ViGet, that extends the project file. Tazel checks its descriptor and its SHA-256 before it loads it.", + title: "Formatting and linting", + text: "tazel fmt runs clang-format and zig fmt on the sources of the selected targets; tazel lint writes compile_commands.json and runs clang-tidy.", }, ], - stepsHeading: "From project file to program", + stepsHeading: "From project files to program", steps: [ { title: "Describe", - text: "Name the project and its targets in BUILD.kts. Sources are the .tala files below Sources/.", + text: "MODULE.kts names the module; each BUILD.kts names the targets of its package, such as //app/:greeter.", }, { title: "Build", - text: "tazel build starts Talac with the options of the project and writes the program to build/debug or build/release.", + text: "tazel build calls Clang, GCC or zig cc and writes the outputs to .tazel/out, by triple and build mode.", }, { title: "Run and test", - text: "tazel run builds one executable and starts it; tazel test builds and runs the test suites.", + text: "tazel run builds one program and starts it; tazel test builds and runs the test targets.", }, ], - sampleHeading: "Every project starts the same way", + sampleHeading: "A target in a few lines", sampleLead: - "A few lines name the project and its program; the second build finds nothing to do.", + "A program, its sources, a library it depends on and its C++ standard; the second build finds nothing to do.", closingHeading: "Free software, built in the open", closingText: - "The source of Tazel, its issues and its releases are on GitHub. Talac, talafmt and talalint are separate programs with their own releases.", + "The source of Tazel, its issues and its changelog are on GitHub. Tazel is in development and works towards its first release, 0.1.0.", closingAction: "Tazel on GitHub", }, "de-DE": { - title: "Tazel — Das Build-System von Tala", + title: "Tazel — Ein Build-System für C, C++, Objective-C, Objective-C++ und Zig", description: - "Tazel baut, startet, testet, formatiert und prüft Tala-Projekte aus einer Kotlin-Projektdatei und hält ihre Abhängigkeiten in einer Lockdatei fest.", - eyebrow: "Das Build-System von Tala", - headline: "Eine Projektdatei. Ein Befehl für jede Aufgabe.", - lead: "Tazel liest eine Projektdatei in Kotlin, startet Talac, talafmt und talalint für Sie und hält jede Abhängigkeit in einer Lockdatei fest. Der Name verbindet Tala und Bazel.", + "Tazel baut, startet, testet, formatiert und prüft C, C++, Objective-C, Objective-C++ und Zig aus Projektdateien in Kotlin.", + eyebrow: "C, C++, Objective-C, Objective-C++ und Zig", + headline: "Projektdateien in Kotlin. Builds, die nur Geändertes wiederholen.", + lead: "Tazel liest ein MODULE.kts an der Wurzel eines Moduls und ein BUILD.kts in jedem Paket, ruft die Compiler auf, die es findet, und führt nur die Befehle erneut aus, deren Eingaben sich geändert haben.", start: "Loslegen", commands: "Befehle", - release: "Tazel {version}", + release: "Tazel {version} in Entwicklung", featuresHeading: "Was Tazel tut", featuresLead: - "Ein Programm für das ganze Leben eines Tala-Projekts, vom ersten Build bis zum veröffentlichten Paket.", + "Ein Programm zum Bauen, Starten, Testen, Formatieren und Prüfen von nativem Code, gleich in welcher Sprache ein Ziel geschrieben ist.", features: [ { - title: "Eine Projektdatei in Kotlin", - text: "BUILD.kts ist ein Kotlin-Skript mit typisierter DSL, also ergänzt und prüft es ein Editor. Tazel führt es mit seinem eigenen Skript-Host aus: Eine JRE 25 ist alles, was ein Rechner braucht.", + title: "Projektdateien in Kotlin", + text: "MODULE.kts und BUILD.kts sind Kotlin-Skripte mit einer typisierten DSL, also ergänzt und prüft sie ein Editor. Eine Einstellung, die eine Sprache oder Zielart nicht hat, ist ein Kompilierfehler der Projektdatei.", }, { - title: "Nur, was sich geändert hat", - text: "Ein Ziel wird nur neu kompiliert, wenn sich seine Quellen, seine Einstellungen oder der Compiler geändert haben. Alles andere gilt als aktuell und bleibt unberührt.", + title: "Fünf Sprachen, ein Graph", + text: "Ziele in C, C++, Objective-C, Objective-C++ und Zig sind Programme, statische oder gemeinsame Bibliotheken und Tests. Jedes Ziel hat eine Sprache; Ziele verbinden sich über depends.", }, { - title: "Der ganze Rechner", - text: "Plugin-Schritte, Kompilierungen und Testsuiten sind Einheiten eines Graphen und laufen nebeneinander. --jobs, --cpus und --memory setzen die Grenzen, --profile schreibt einen Trace.", + title: "Nur, was sich geändert hat", + text: "Jedes Kompilieren, Archivieren und Linken läuft nur erneut, wenn sich seine Befehlszeile, seine Umgebung oder der Inhalt einer gelesenen Datei geändert hat. Eine nur berührte Datei löst nichts aus.", }, { - title: "Cache und entfernte Builds", - text: "Build-Ergebnisse landen in einem Cache, den ein Team teilen kann. --remote-executor kompiliert auf einem vertrauenswürdigen Rechner, der tazel remote serve ausführt.", + title: "Für jedes Triple", + text: "Ein Ziel nennt seine LLVM-Target-Triples, und sein Block läuft für jedes Triple und jeden Build-Modus. Clang und zig cc bauen für andere Rechner; --triple wählt eines.", }, { - title: "Eine lesbare Lockdatei", - text: "LOCK.sqlite3 hält fest, wovon ein Projekt abhängt, LOCK.dump schreibt es als Text zur Durchsicht, und tazel lock graph zeigt, wer was verwendet.", + title: "Tests als Ziele", + text: "Tests haben Größen, Zeitlimits, Shards und Tags, werden bei flaky wiederholt und laufen nicht erneut, solange Programm, Daten und Argumente gleich bleiben.", }, { - title: "Plugins in Kotlin", - text: "Ein Plugin ist ein JAR, lokal oder aus ViGet, das die Projektdatei erweitert. Tazel prüft seinen Deskriptor und seine SHA-256, bevor es geladen wird.", + title: "Formatieren und Prüfen", + text: "tazel fmt führt clang-format und zig fmt auf den Quellen der gewählten Ziele aus; tazel lint schreibt compile_commands.json und führt clang-tidy aus.", }, ], - stepsHeading: "Von der Projektdatei zum Programm", + stepsHeading: "Von den Projektdateien zum Programm", steps: [ { title: "Beschreiben", - text: "Nennen Sie das Projekt und seine Ziele in BUILD.kts. Quellen sind die .tala-Dateien unter Sources/.", + text: "MODULE.kts benennt das Modul; jedes BUILD.kts benennt die Ziele seines Pakets, etwa //app/:greeter.", }, { title: "Bauen", - text: "tazel build startet Talac mit den Optionen des Projekts und schreibt das Programm nach build/debug oder build/release.", + text: "tazel build ruft Clang, GCC oder zig cc auf und schreibt die Ergebnisse nach .tazel/out, nach Triple und Build-Modus.", }, { title: "Starten und testen", - text: "tazel run baut eine ausführbare Datei und startet sie; tazel test baut die Testsuiten und führt sie aus.", + text: "tazel run baut ein Programm und startet es; tazel test baut die Testziele und führt sie aus.", }, ], - sampleHeading: "Jedes Projekt beginnt gleich", + sampleHeading: "Ein Ziel in wenigen Zeilen", sampleLead: - "Ein paar Zeilen nennen das Projekt und sein Programm; der zweite Build findet nichts zu tun.", + "Ein Programm, seine Quellen, eine Bibliothek, von der es abhängt, und sein C++-Standard; der zweite Build findet nichts zu tun.", closingHeading: "Freie Software, offen entwickelt", closingText: - "Der Quellcode von Tazel, seine Issues und seine Releases liegen auf GitHub. Talac, talafmt und talalint sind eigene Programme mit eigenen Releases.", + "Der Quellcode von Tazel, seine Issues und sein Changelog liegen auf GitHub. Tazel ist in Entwicklung und arbeitet auf seine erste Version hin, 0.1.0.", closingAction: "Tazel auf GitHub", }, "ru-RU": { - title: "Tazel — Система сборки Tala", + title: "Tazel — система сборки для C, C++, Objective-C, Objective-C++ и Zig", description: - "Tazel собирает, запускает, тестирует, форматирует и проверяет проекты Tala по одному файлу проекта на Kotlin и хранит их зависимости в lock-файле.", - eyebrow: "Система сборки Tala", - headline: "Один файл проекта. Одна команда на каждую задачу.", - lead: "Tazel читает файл проекта на Kotlin, сам запускает Talac, talafmt и talalint и записывает каждую зависимость в lock-файл. Название соединяет Tala и Bazel.", + "Tazel собирает, запускает, тестирует, форматирует и проверяет C, C++, Objective-C, Objective-C++ и Zig по файлам проекта на Kotlin.", + eyebrow: "C, C++, Objective-C, Objective-C++ и Zig", + headline: "Файлы проекта на Kotlin. Сборки, повторяющие только изменённое.", + lead: "Tazel читает MODULE.kts в корне модуля и BUILD.kts в каждом пакете, вызывает найденные компиляторы и повторяет только те команды, входные данные которых изменились.", start: "Начать", commands: "Команды", - release: "Tazel {version}", + release: "Tazel {version} в разработке", featuresHeading: "Что делает Tazel", featuresLead: - "Одна программа на всю жизнь проекта Tala — от первой сборки до опубликованного пакета.", + "Одна программа для сборки, запуска, тестирования, форматирования и проверки нативного кода, на каком бы языке ни была написана цель.", features: [ { - title: "Файл проекта на Kotlin", - text: "BUILD.kts — скрипт Kotlin с типизированным DSL, поэтому редактор дополняет и проверяет его. Tazel выполняет его своим скриптовым хостом: машине нужна только JRE 25.", + title: "Файлы проекта на Kotlin", + text: "MODULE.kts и BUILD.kts — скрипты Kotlin с типизированным DSL, поэтому редактор дополняет и проверяет их. Настройка, которой нет у языка или вида цели, — ошибка компиляции файла проекта.", }, { - title: "Только то, что изменилось", - text: "Цель компилируется заново, только если изменились её исходники, настройки или компилятор. Всё остальное считается актуальным и не трогается.", + title: "Пять языков, один граф", + text: "Цели на C, C++, Objective-C, Objective-C++ и Zig — это программы, статические и разделяемые библиотеки и тесты. У каждой цели один язык; цели связываются через depends.", }, { - title: "Вся машина", - text: "Шаги плагинов, компиляции и наборы тестов — единицы одного графа и выполняются параллельно. --jobs, --cpus и --memory задают пределы, а --profile записывает трассировку.", + title: "Только изменённое", + text: "Каждая компиляция, архивация и компоновка запускается снова, только если изменились её командная строка, окружение или содержимое прочитанного файла. Просто затронутый файл ничего не запускает.", }, { - title: "Кэш и удалённая сборка", - text: "Результаты сборки попадают в кэш, который может делить команда. --remote-executor компилирует на доверенной машине, где запущен tazel remote serve.", + title: "Для каждой тройки", + text: "Цель перечисляет свои целевые тройки LLVM, и её блок выполняется для каждой тройки и режима сборки. Clang и zig cc собирают для других машин; --triple выбирает одну.", }, { - title: "Читаемый lock-файл", - text: "LOCK.sqlite3 записывает, от чего зависит проект, LOCK.dump выводит это текстом для ревью, а tazel lock graph показывает, кто что использует.", + title: "Тесты как цели", + text: "У тестов есть размеры, тайм-ауты, шарды и теги; нестабильные повторяются, а прошедшие не запускаются снова, пока программа, данные и аргументы те же.", }, { - title: "Плагины на Kotlin", - text: "Плагин — это JAR, локальный или из ViGet, который расширяет файл проекта. Tazel проверяет его дескриптор и SHA-256, прежде чем загрузить.", + title: "Форматирование и проверка", + text: "tazel fmt запускает clang-format и zig fmt для исходников выбранных целей; tazel lint записывает compile_commands.json и запускает clang-tidy.", }, ], - stepsHeading: "От файла проекта к программе", + stepsHeading: "От файлов проекта к программе", steps: [ { title: "Описать", - text: "Назовите проект и его цели в BUILD.kts. Исходники — это файлы .tala в Sources/.", + text: "MODULE.kts называет модуль; каждый BUILD.kts называет цели своего пакета, например //app/:greeter.", }, { title: "Собрать", - text: "tazel build запускает Talac с параметрами проекта и записывает программу в build/debug или build/release.", + text: "tazel build вызывает Clang, GCC или zig cc и записывает результаты в .tazel/out по тройке и режиму сборки.", }, { title: "Запустить и проверить", - text: "tazel run собирает один исполняемый файл и запускает его; tazel test собирает и запускает наборы тестов.", + text: "tazel run собирает одну программу и запускает её; tazel test собирает и запускает тестовые цели.", }, ], - sampleHeading: "Каждый проект начинается одинаково", - sampleLead: "Несколько строк называют проект и его программу; вторая сборка не находит работы.", - closingHeading: "Свободное ПО, разработка в открытую", + sampleHeading: "Цель в нескольких строках", + sampleLead: + "Программа, её исходники, библиотека, от которой она зависит, и её стандарт C++; вторая сборка не находит работы.", + closingHeading: "Свободное ПО, открытая разработка", closingText: - "Исходный код Tazel, задачи и выпуски находятся на GitHub. Talac, talafmt и talalint — отдельные программы со своими выпусками.", + "Исходный код Tazel, задачи и журнал изменений находятся на GitHub. Tazel в разработке и движется к первому выпуску, 0.1.0.", closingAction: "Tazel на GitHub", }, - "he-IL": { - title: "Tazel — מערכת הבנייה של Tala", + "fr-FR": { + title: "Tazel — Un système de build pour C, C++, Objective-C, Objective-C++ et Zig", description: - "Tazel בונה, מריצה, בודקת, מעצבת ומנתחת פרויקטים של Tala מקובץ פרויקט אחד ב-Kotlin, ושומר את התלויות שלהם בקובץ נעילה.", - eyebrow: "מערכת הבנייה של Tala", - headline: "קובץ פרויקט אחד. פקודה אחת לכל משימה.", - lead: "Tazel קוראת קובץ פרויקט ב-Kotlin, מפעילה בשבילכם את Talac, talafmt ו-talalint, ורושמת כל תלות בקובץ נעילה. השם מחבר את Tala ואת Bazel.", - start: "מתחילים", - commands: "פקודות", - release: "Tazel {version}", - featuresHeading: "מה Tazel עושה", - featuresLead: "תוכנית אחת לכל חיי פרויקט של Tala, מהבנייה הראשונה ועד החבילה שפורסמה.", + "Tazel compile, lance, teste, formate et analyse du C, du C++, de l’Objective-C, de l’Objective-C++ et du Zig à partir de fichiers de projet écrits en Kotlin.", + eyebrow: "C, C++, Objective-C, Objective-C++ et Zig", + headline: "Des fichiers de projet en Kotlin. Des builds qui ne refont que ce qui a changé.", + lead: "Tazel lit un MODULE.kts à la racine d’un module et un BUILD.kts dans chaque paquet, appelle les compilateurs qu’il trouve et ne relance que les commandes dont les entrées ont changé.", + start: "Commencer", + commands: "Commandes", + release: "Tazel {version} en développement", + featuresHeading: "Ce que fait Tazel", + featuresLead: + "Un seul programme pour compiler, lancer, tester, formater et analyser du code natif, quel que soit le langage de chaque cible.", features: [ { - title: "קובץ פרויקט ב-Kotlin", - text: "BUILD.kts הוא סקריפט Kotlin עם DSL בעל טיפוסים, כך שעורך משלים ובודק אותו. Tazel מריצה אותו במארח הסקריפטים שלה: כל מה שמחשב צריך הוא JRE 25.", + title: "Des fichiers de projet en Kotlin", + text: "MODULE.kts et BUILD.kts sont des scripts Kotlin avec un DSL typé : un éditeur les complète et les vérifie. Un réglage qu’un langage ou un type de cible n’a pas est une erreur de compilation du fichier de projet.", }, { - title: "רק מה שהשתנה", - text: "יעד מהודר מחדש רק כשהמקורות, ההגדרות או המהדר שלו השתנו. כל השאר מדווח כעדכני ונשאר כמו שהוא.", + title: "Cinq langages, un graphe", + text: "Les cibles en C, C++, Objective-C, Objective-C++ et Zig sont des programmes, des bibliothèques statiques ou partagées et des tests. Chaque cible a un langage ; les cibles se rejoignent par depends.", }, { - title: "המחשב כולו", - text: "צעדי תוספים, הידורים וחבילות בדיקה הם יחידות בגרף אחד ורצים זה לצד זה. --jobs, --cpus ו---memory קובעים את הגבולות, ו---profile כותב עקבה.", + title: "Seulement ce qui a changé", + text: "Chaque compilation, archive et édition de liens ne se relance que si sa ligne de commande, son environnement ou le contenu d’un fichier lu a changé. Toucher un fichier ne relance rien.", }, { - title: "מטמון ובנייה מרחוק", - text: "תוצאות הבנייה נשמרות במטמון שצוות יכול לשתף. --remote-executor מהדר במחשב מהימן שמריץ את tazel remote serve.", + title: "Pour chaque triplet", + text: "Une cible nomme ses triplets cibles LLVM, et son bloc s’exécute pour chaque triplet et mode de build. Clang et zig cc compilent pour d’autres machines ; --triple en choisit un.", }, { - title: "קובץ נעילה קריא", - text: "LOCK.sqlite3 רושם במה הפרויקט תלוי, LOCK.dump כותב זאת כטקסט לסקירה, ו-tazel lock graph מראה מי משתמש במה.", + title: "Les tests sont des cibles", + text: "Les tests ont des tailles, des délais, des shards et des tags, sont relancés s’ils sont instables et ne s’exécutent pas à nouveau tant que leur programme, leurs données et leurs arguments restent les mêmes.", }, { - title: "תוספים ב-Kotlin", - text: "תוסף הוא JAR, מקומי או מ-ViGet, שמרחיב את קובץ הפרויקט. Tazel בודקת את המתאר שלו ואת ה-SHA-256 שלו לפני שהיא טוענת אותו.", + title: "Formatage et analyse", + text: "tazel fmt lance clang-format et zig fmt sur les sources des cibles choisies ; tazel lint écrit compile_commands.json et lance clang-tidy.", }, ], - stepsHeading: "מקובץ פרויקט לתוכנית", + stepsHeading: "Des fichiers de projet au programme", steps: [ { - title: "לתאר", - text: "כתבו ב-BUILD.kts את שם הפרויקט ואת היעדים שלו. המקורות הם קובצי .tala שמתחת ל-Sources/.", + title: "Décrire", + te |