diff options
| author | Leitwolf11 | 2026-11-15 21:51:41 +0300 |
|---|---|---|
| committer | Leitwolf11 | 2026-11-15 21:51:41 +0300 |
| commit | c016c2f1a6883d0a41cc03ce58f21fc4be9c401a (patch) | |
| tree | 547a5a74394a7b43f8419896989fdc0cf3db560b | |
| parent | 45c1bb14326cbee8fe57c6f639550e8eadd81f0a (diff) | |
| download | tazel.net-c016c2f1a6883d0a41cc03ce58f21fc4be9c401a.tar.gz | |
Rewrite the site for the Tazel of C, C++, Objective-C, Objective-C++ and Zig
The site described the build system of the former language; Tazel now
builds C, C++, Objective-C, Objective-C++ and Zig from MODULE.kts and
BUILD.kts. Every word of it is rewritten from what Tazel on main does.
- Home page, header and footer in four languages: Kotlin project files,
five languages in one graph, per-action incremental builds, triples,
tests as targets, fmt and lint. The terminal shows the real output of a
build, a rebuild and a run of the first project; its long lines wrap.
The release chip says 0.1.0 in development and links the Unreleased
section of the changelog.
- Documentation, eight pages in every language: installation from
source, the first project (a C library, a C++ program and a test),
releases (SemVer; Rolling, LTS, ELTS), commands with labels and custom
commands, MODULE.kts, BUILD.kts, plugins and architecture. Every example
was built and run with Tazel; what this version does not do is said
plainly (no ViGet downloads, no plugin loading, MSVC and clang-cl stop
the build).
- French takes the place of Hebrew: locale code, collections, tests.
Old /he addresses are redirected by the server.
- The grammar of the former language, the docs sync script, the lockfile
page and the old links are gone; Codacy no longer excludes the docs,
which are written here now.
- tests/translations.test.mjs: every document exists in every language
with a title and a description, and the home page and frame are
complete in each.
- On phones, inline code longer than the column breaks instead of
widening the page.
Checked: npm test 7/7, Prettier, nuxt typecheck, nuxt generate (42
pages); Playwright over 36 pages at 1280 and 390 px: all 200, no
overflow, no console error, 36 internal links resolve.
Claude-Session: https://claude.ai/code/session_01Ji7xZMYjc4zankoc7hGBE1
54 files changed, 2995 insertions, 2416 deletions
diff --git a/.codacy.yml b/.codacy.yml index fc55949..9203885 100644 --- a/.codacy.yml +++ b/.codacy.yml @@ -1,14 +1,9 @@ # SPDX-FileCopyrightText: 2026 Progmasoft <[email protected]> # SPDX-License-Identifier: AGPL-3.0-or-later -# The reference under content/en-US/docs is copied from Progmasoft/tazel and -# the Tala grammar from Progmasoft/tala; both are reviewed where they live. +# Generated and installed files only; everything written here is analysed. exclude_paths: - "node_modules/**" - ".nuxt/**" - ".output/**" - "coverage/**" - - "content/en-US/docs/2.reference/**" - - "content/en-US/docs/3.extending/**" - - "content/en-US/docs/4.internals/**" - - "grammars/**" @@ -3,38 +3,31 @@ # tazel.net -The site of [Tazel](https://github.com/Progmasoft/tazel), the build system and package manager of Tala, at -[tazel.net](https://tazel.net/). It is a Nuxt site generated to static files, in English, German, Russian and Hebrew. +The site of [Tazel](https://github.com/Progmasoft/tazel), the build system for C, C++, Objective-C, Objective-C++ and +Zig, at [tazel.net](https://tazel.net/). It is a Nuxt site generated to static files, in English, German, Russian and +French. ```bash npm ci npm run dev # http://localhost:3000 npm run generate # .output/public, every page in every language npm run check # types -npm test # the language helpers +npm test # the language helpers and the translations npm run format:check ``` ## Content -| Where | What | -| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | -| `app/content/` | the words of the pages that are not documents: the frame, the home page, the site constants | -| `content/<locale>/docs/` | the documentation as Markdown, one folder per language; the numbers order the tree | -| `grammars/tala.tmLanguage.json` | the grammar that highlights Tala, from the [compiler repository](https://github.com/Progmasoft/tala/tree/main/Grammar) | +| Where | What | +| ------------------------ | ------------------------------------------------------------------------------------------- | +| `app/content/` | the words of the pages that are not documents: the frame, the home page, the site constants | +| `content/<locale>/docs/` | the documentation as Markdown, one folder per language; the numbers order the tree | -The reference, under `content/en-US/docs/2.reference`, `3.extending` and `4.internals`, is copied from the -`Documents/` of Tazel and is not edited here: - -```bash -node scripts/sync-docs.mjs ../tazel -``` - -A page a language lacks is shown in English, with a note that says so. A release of Tazel changes -`latestRelease` in `app/content/site.ts`. +Every page exists in every language; `tests/translations.test.mjs` fails when one is missing. The documents describe +what Tazel on its `main` branch does, and its examples are run with it. A release of Tazel changes `nextRelease` and +`releaseNotes` in `app/content/site.ts`. ## Licence -The code of the site is under AGPL-3.0-or-later with the Progmasoft Patent Grant 1.1; see [LICENSE.txt](LICENSE.txt), -[PATENTS.md](PATENTS.md) and [NOTICE.txt](NOTICE.txt). The documents copied from Tazel and the Tala grammar keep their own -licence, MPL-2.0 with the Progmasoft Exception 2.0, written at the top of each file or in the repository they come from. +The code of the site is under AGPL-3.0-or-later; see [LICENSE.txt](LICENSE.txt) and [NOTICE.txt](NOTICE.txt). +Progmasoft's own code is also covered by the [Progmasoft Patent Grant 1.1](PATENTS.md). diff --git a/app/assets/site.css b/app/assets/site.css index 2ae7ae3..4c1d4cc 100644 --- a/app/assets/site.css +++ b/app/assets/site.css @@ -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 (max-width: 600px) { + .prose :not(pre) > code { + white-space: normal; + overflow-wrap: anywhere; + } +} + .prose pre code { white-space: pre; } 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..0fedd14 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> 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/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 |