From fa58a66d148b995c59bf576cd8e0ee1759c3a75f Mon Sep 17 00:00:00 2001 From: Maksym Stoianov Date: Tue, 3 Nov 2026 18:38:25 +0100 Subject: [PATCH] docs: move README translations to docs/readme The 18 README translations move from the repository root to docs/readme/, so the root keeps only README.md (English) next to the project files. The language switcher in README.md now links docs/readme/README..md; inside docs/readme/ the translations link each other by file name and English as ../../README.md, and every other relative link is rewritten to resolve from the new folder. npm always packs root README* files, so the published package shipped all translations; after the move it carries only README.md. check-readme-translations.mjs reads the translations from docs/readme/, expects the new switcher links and fails on any relative link whose target does not exist. CONTRIBUTING describes the new paths. Co-Authored-By: Claude Opus 5.5 Signed-off-by: Maksym Stoianov --- CONTRIBUTING.md | 12 +-- README.md | 2 +- README.ar.md => docs/readme/README.ar.md | 40 ++++----- README.cs.md => docs/readme/README.cs.md | 40 ++++----- README.de.md => docs/readme/README.de.md | 42 ++++----- README.es.md => docs/readme/README.es.md | 42 ++++----- README.fr.md => docs/readme/README.fr.md | 42 ++++----- README.id.md => docs/readme/README.id.md | 40 ++++----- README.it.md => docs/readme/README.it.md | 40 ++++----- README.ja.md => docs/readme/README.ja.md | 38 ++++---- README.ko.md => docs/readme/README.ko.md | 38 ++++---- README.nl.md => docs/readme/README.nl.md | 40 ++++----- README.pl.md => docs/readme/README.pl.md | 40 ++++----- README.pt.md => docs/readme/README.pt.md | 42 ++++----- README.ru.md => docs/readme/README.ru.md | 40 ++++----- README.tr.md => docs/readme/README.tr.md | 38 ++++---- README.uk.md => docs/readme/README.uk.md | 42 ++++----- README.vi.md => docs/readme/README.vi.md | 40 ++++----- .../readme/README.zh-TW.md | 38 ++++---- README.zh.md => docs/readme/README.zh.md | 38 ++++---- scripts/check-readme-translations.mjs | 88 +++++++++++++++++-- 21 files changed, 448 insertions(+), 374 deletions(-) rename README.ar.md => docs/readme/README.ar.md (73%) rename README.cs.md => docs/readme/README.cs.md (71%) rename README.de.md => docs/readme/README.de.md (73%) rename README.es.md => docs/readme/README.es.md (73%) rename README.fr.md => docs/readme/README.fr.md (74%) rename README.id.md => docs/readme/README.id.md (71%) rename README.it.md => docs/readme/README.it.md (73%) rename README.ja.md => docs/readme/README.ja.md (70%) rename README.ko.md => docs/readme/README.ko.md (71%) rename README.nl.md => docs/readme/README.nl.md (73%) rename README.pl.md => docs/readme/README.pl.md (73%) rename README.pt.md => docs/readme/README.pt.md (73%) rename README.ru.md => docs/readme/README.ru.md (75%) rename README.tr.md => docs/readme/README.tr.md (73%) rename README.uk.md => docs/readme/README.uk.md (76%) rename README.vi.md => docs/readme/README.vi.md (73%) rename README.zh-TW.md => docs/readme/README.zh-TW.md (70%) rename README.zh.md => docs/readme/README.zh.md (70%) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index c73a4c4..6a443e8 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -250,11 +250,13 @@ The project uses [Vitest](https://vitest.dev/) for testing. ### README Translations -`README.md` (English) is the source of truth; `README..md` files in the repository root are AI-assisted -translations of it. When you change `README.md`, update the translations in the same pull request (or say in the PR -that they need an update): keep the same `##`/`###` headings, the language switcher line and the version in the -translation note in sync with `package.json`. Translate prose only — code, API names, commands and links stay as they -are, and links to `docs/` keep pointing to the English guides. Check the result with: +`README.md` (English) in the repository root is the source of truth; the `docs/readme/README..md` files are +AI-assisted translations of it. When you change `README.md`, update the translations in the same pull request (or say +in the PR that they need an update): keep the same `##`/`###` headings, the language switcher line and the version in +the translation note in sync with `package.json`. Translate prose only — code, API names and commands stay as they +are, and links to `docs/` keep pointing to the English guides. Links in a translation are relative to `docs/readme/`: +other translations are `README..md`, English is `../../README.md`, root files are `../../` and guides are +`../guide/.md`. Check the result with: ```bash npm run docs:check-i18n diff --git a/README.md b/README.md index 9276d92..59860ab 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@

-**English** | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) +**English** | [Українська](docs/readme/README.uk.md) | [Русский](docs/readme/README.ru.md) | [Deutsch](docs/readme/README.de.md) | [Français](docs/readme/README.fr.md) | [Español](docs/readme/README.es.md) | [Português](docs/readme/README.pt.md) | [Italiano](docs/readme/README.it.md) | [Nederlands](docs/readme/README.nl.md) | [Polski](docs/readme/README.pl.md) | [Čeština](docs/readme/README.cs.md) | [Türkçe](docs/readme/README.tr.md) | [العربية](docs/readme/README.ar.md) | [Bahasa Indonesia](docs/readme/README.id.md) | [Tiếng Việt](docs/readme/README.vi.md) | [日本語](docs/readme/README.ja.md) | [한국어](docs/readme/README.ko.md) | [简体中文](docs/readme/README.zh.md) | [繁體中文](docs/readme/README.zh-TW.md) # Boot Framework for Google Apps Script™ diff --git a/README.ar.md b/docs/readme/README.ar.md similarity index 73% rename from README.ar.md rename to docs/readme/README.ar.md index 2df32cd..7fd276d 100644 --- a/README.ar.md +++ b/docs/readme/README.ar.md @@ -1,6 +1,6 @@ -![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG) +![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)

@@ -8,11 +8,11 @@

-[English](README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | **العربية** | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) +[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | **العربية** | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md)
-> أُعدّت هذه الترجمة بمساعدة الذكاء الاصطناعي انطلاقًا من [README.md](README.md) للإصدار 1.10.0. ملف README الإنجليزي هو النسخة المرجعية. نرحّب بالتصحيحات: راجع [CONTRIBUTING.md](CONTRIBUTING.md). +> أُعدّت هذه الترجمة بمساعدة الذكاء الاصطناعي انطلاقًا من [README.md](../../README.md) للإصدار 1.10.0. ملف README الإنجليزي هو النسخة المرجعية. نرحّب بالتصحيحات: راجع [CONTRIBUTING.md](../../CONTRIBUTING.md). # Boot Framework for Google Apps Script™ @@ -20,9 +20,9 @@

Built with clasp - License - Security Policy - Roadmap + License + Security Policy + Roadmap Latest release

@@ -124,20 +124,20 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) {
الشرح الكامل، بما في ذلك `doPost` والتطبيق غير المتزامن `AsyncApp`، موجود في -[دليل Quick Start](docs/guide/quick-start.md) (بالإنجليزية). +[دليل Quick Start](../guide/quick-start.md) (بالإنجليزية). ## التوثيق الأدلة التفصيلية متاحة باللغة الإنجليزية: -- [Quick Start](docs/guide/quick-start.md): إعداد `App` (متزامن) و`AsyncApp` (غير متزامن). -- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md): معاملات الطلب، وأنواع MIME، +- [Quick Start](../guide/quick-start.md): إعداد `App` (متزامن) و`AsyncApp` (غير متزامن). +- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md): معاملات الطلب، وأنواع MIME، والاستدعاء عبر `google.script.run` وعنوان URL لتطبيق الويب، وتغليف الاستجابات. -- [Decorators](docs/guide/decorators.md): مزخرفات الفئات والتوابع والمعاملات، والتحقق، والأنابيب المدمجة. -- [Controlling the Response](docs/guide/responses.md): `ResponseEntity` و`@ResponseBody`. -- [Advanced Examples](docs/guide/examples.md): الأنابيب والمعالجة الشاملة للأخطاء. -- [AI Agent Skills](docs/guide/ai-agent-skills.md): القائمة الكاملة للمهارات وخيارات التثبيت. -- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md): مقارنة بين البنى المعمارية. +- [Decorators](../guide/decorators.md): مزخرفات الفئات والتوابع والمعاملات، والتحقق، والأنابيب المدمجة. +- [Controlling the Response](../guide/responses.md): `ResponseEntity` و`@ResponseBody`. +- [Advanced Examples](../guide/examples.md): الأنابيب والمعالجة الشاملة للأخطاء. +- [AI Agent Skills](../guide/ai-agent-skills.md): القائمة الكاملة للمهارات وخيارات التثبيت. +- [Boot.gs vs Spring Boot vs NestJS](../comparison.md): مقارنة بين البنى المعمارية. ## مهارات وكلاء الذكاء الاصطناعي @@ -154,7 +154,7 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) {
-القائمة الكاملة وطريقة التثبيت عبر Gemini CLI و`npx skills` موجودة في [AI Agent Skills](docs/guide/ai-agent-skills.md). +القائمة الكاملة وطريقة التثبيت عبر Gemini CLI و`npx skills` موجودة في [AI Agent Skills](../guide/ai-agent-skills.md). ## موصى به @@ -173,16 +173,16 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ## المساهمة -نرحّب بالمساهمات! راجع [إرشادات المساهمة](CONTRIBUTING.md) للاطلاع على قواعد السلوك وطريقة إرسال طلبات الدمج -(pull requests). للإبلاغ عن ثغرة أمنية، اتبع [سياسة الأمان](SECURITY.md). +نرحّب بالمساهمات! راجع [إرشادات المساهمة](../../CONTRIBUTING.md) للاطلاع على قواعد السلوك وطريقة إرسال طلبات الدمج +(pull requests). للإبلاغ عن ثغرة أمنية، اتبع [سياسة الأمان](../../SECURITY.md). ## خارطة الطريق -اطّلع على [خارطة الطريق](ROADMAP.md) لمعرفة ما نخطط له في الإصدارات القادمة. +اطّلع على [خارطة الطريق](../../ROADMAP.md) لمعرفة ما نخطط له في الإصدارات القادمة. ## سجل التغييرات -للاطلاع على قائمة مفصّلة بالتغييرات والتحديثات، راجع [CHANGELOG](CHANGELOG.md). +للاطلاع على قائمة مفصّلة بالتغييرات والتحديثات، راجع [CHANGELOG](../../CHANGELOG.md). ## الدعم @@ -192,7 +192,7 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ## الترخيص -هذا المشروع مرخّص بموجب [ترخيص Apache-2.0](LICENSE). +هذا المشروع مرخّص بموجب [ترخيص Apache-2.0](../../LICENSE). --- diff --git a/README.cs.md b/docs/readme/README.cs.md similarity index 71% rename from README.cs.md rename to docs/readme/README.cs.md index c1d603c..93072e6 100644 --- a/README.cs.md +++ b/docs/readme/README.cs.md @@ -1,6 +1,6 @@ -![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG) +![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)

@@ -8,17 +8,17 @@

-[English](README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | **Čeština** | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) +[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | **Čeština** | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) -> Tento překlad byl připraven s pomocí AI z [README.md](README.md) pro verzi 1.10.0. Referenční verzí je anglické README. Opravy jsou vítány: viz [CONTRIBUTING.md](CONTRIBUTING.md). +> Tento překlad byl připraven s pomocí AI z [README.md](../../README.md) pro verzi 1.10.0. Referenční verzí je anglické README. Opravy jsou vítány: viz [CONTRIBUTING.md](../../CONTRIBUTING.md). # Boot Framework for Google Apps Script™

Built with clasp - License - Security Policy - Roadmap + License + Security Policy + Roadmap Latest release

@@ -108,20 +108,20 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ``` Kompletní postup včetně `doPost` a asynchronní aplikace `AsyncApp` najdete v -[průvodci Quick Start](docs/guide/quick-start.md) (v angličtině). +[průvodci Quick Start](../guide/quick-start.md) (v angličtině). ## Dokumentace Podrobné průvodce jsou k dispozici v angličtině: -- [Quick Start](docs/guide/quick-start.md): nastavení synchronní `App` a asynchronní `AsyncApp`. -- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md): parametry požadavku, typy MIME, +- [Quick Start](../guide/quick-start.md): nastavení synchronní `App` a asynchronní `AsyncApp`. +- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md): parametry požadavku, typy MIME, volání přes `google.script.run` a URL webové aplikace, obalování odpovědí. -- [Decorators](docs/guide/decorators.md): dekorátory tříd, metod a parametrů, validace a vestavěné pipes. -- [Controlling the Response](docs/guide/responses.md): `ResponseEntity` a `@ResponseBody`. -- [Advanced Examples](docs/guide/examples.md): pipes a globální zpracování chyb. -- [AI Agent Skills](docs/guide/ai-agent-skills.md): úplný seznam skills a možnosti instalace. -- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md): srovnání architektur. +- [Decorators](../guide/decorators.md): dekorátory tříd, metod a parametrů, validace a vestavěné pipes. +- [Controlling the Response](../guide/responses.md): `ResponseEntity` a `@ResponseBody`. +- [Advanced Examples](../guide/examples.md): pipes a globální zpracování chyb. +- [AI Agent Skills](../guide/ai-agent-skills.md): úplný seznam skills a možnosti instalace. +- [Boot.gs vs Spring Boot vs NestJS](../comparison.md): srovnání architektur. ## Skills pro AI agenty @@ -134,7 +134,7 @@ a validovat aplikace **Boot.gs**, a navíc obecné skills pro vývoj v Google Ap /plugin install bootgs@bootgs-skills ``` -Úplný seznam a instalaci pro Gemini CLI a `npx skills` najdete v [AI Agent Skills](docs/guide/ai-agent-skills.md). +Úplný seznam a instalaci pro Gemini CLI a `npx skills` najdete v [AI Agent Skills](../guide/ai-agent-skills.md). ## Doporučujeme @@ -150,16 +150,16 @@ a validovat aplikace **Boot.gs**, a navíc obecné skills pro vývoj v Google Ap ## Jak přispět Příspěvky jsou vítány! Pravidla chování a postup při odesílání pull requestů najdete v -[pokynech pro přispěvatele](CONTRIBUTING.md). Chcete-li nahlásit zranitelnost, postupujte podle -[bezpečnostní politiky](SECURITY.md). +[pokynech pro přispěvatele](../../CONTRIBUTING.md). Chcete-li nahlásit zranitelnost, postupujte podle +[bezpečnostní politiky](../../SECURITY.md). ## Plán vývoje -V [plánu vývoje](ROADMAP.md) zjistíte, co chystáme v příštích verzích. +V [plánu vývoje](../../ROADMAP.md) zjistíte, co chystáme v příštích verzích. ## Seznam změn -Podrobný seznam změn a aktualizací najdete v [CHANGELOG](CHANGELOG.md). +Podrobný seznam změn a aktualizací najdete v [CHANGELOG](../../CHANGELOG.md). ## Podpora @@ -169,7 +169,7 @@ můžete ho podpořit přes [GitHub Sponsors](https://github.com/sponsors/Maksym ## Licence -Tento projekt je licencován pod [licencí Apache-2.0](LICENSE). +Tento projekt je licencován pod [licencí Apache-2.0](../../LICENSE). --- diff --git a/README.de.md b/docs/readme/README.de.md similarity index 73% rename from README.de.md rename to docs/readme/README.de.md index 2266366..eb4d2e1 100644 --- a/README.de.md +++ b/docs/readme/README.de.md @@ -1,6 +1,6 @@ -![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG) +![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)

@@ -8,18 +8,18 @@

-[English](README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | **Deutsch** | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) +[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | **Deutsch** | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) -> Diese Übersetzung wurde mit KI-Unterstützung aus [README.md](README.md) für Version 1.10.0 erstellt. Maßgeblich ist -> die englische README. Korrekturen sind willkommen — siehe [CONTRIBUTING.md](CONTRIBUTING.md). +> Diese Übersetzung wurde mit KI-Unterstützung aus [README.md](../../README.md) für Version 1.10.0 erstellt. Maßgeblich ist +> die englische README. Korrekturen sind willkommen — siehe [CONTRIBUTING.md](../../CONTRIBUTING.md). # Boot Framework for Google Apps Script™

Built with clasp - License - Security Policy - Roadmap + License + Security Policy + Roadmap Latest release

@@ -110,20 +110,20 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ``` Die vollständige Anleitung, auch mit `doPost` und der asynchronen `AsyncApp`, finden Sie im -[Quick-Start-Leitfaden](docs/guide/quick-start.md) (auf Englisch). +[Quick-Start-Leitfaden](../guide/quick-start.md) (auf Englisch). ## Dokumentation Die ausführlichen Leitfäden sind auf Englisch verfügbar: -- [Quick Start](docs/guide/quick-start.md): Einrichtung der synchronen `App` und der asynchronen `AsyncApp`. -- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md): Anfrageparameter, MIME-Typen, +- [Quick Start](../guide/quick-start.md): Einrichtung der synchronen `App` und der asynchronen `AsyncApp`. +- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md): Anfrageparameter, MIME-Typen, Aufrufe über `google.script.run` und die Web-App-URL, Antwort-Wrapping. -- [Decorators](docs/guide/decorators.md): Klassen-, Methoden- und Parameter-Decorators, Validierung und eingebaute Pipes. -- [Controlling the Response](docs/guide/responses.md): `ResponseEntity` und `@ResponseBody`. -- [Advanced Examples](docs/guide/examples.md): Pipes und globale Fehlerbehandlung. -- [AI Agent Skills](docs/guide/ai-agent-skills.md): vollständige Liste der Skills und Installationsoptionen. -- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md): Architekturvergleich. +- [Decorators](../guide/decorators.md): Klassen-, Methoden- und Parameter-Decorators, Validierung und eingebaute Pipes. +- [Controlling the Response](../guide/responses.md): `ResponseEntity` und `@ResponseBody`. +- [Advanced Examples](../guide/examples.md): Pipes und globale Fehlerbehandlung. +- [AI Agent Skills](../guide/ai-agent-skills.md): vollständige Liste der Skills und Installationsoptionen. +- [Boot.gs vs Spring Boot vs NestJS](../comparison.md): Architekturvergleich. ## Skills für KI-Agenten @@ -137,7 +137,7 @@ anzulegen, zu strukturieren und zu validieren, dazu frameworkunabhängige Skills ``` Die vollständige Liste und die Installation für Gemini CLI und `npx skills` finden Sie unter -[AI Agent Skills](docs/guide/ai-agent-skills.md). +[AI Agent Skills](../guide/ai-agent-skills.md). ## Empfehlung @@ -153,16 +153,16 @@ Die vollständige Liste und die Installation für Gemini CLI und `npx skills` fi ## Mitwirken Beiträge sind willkommen! Verhaltenskodex und Ablauf für Pull Requests beschreiben die -[Richtlinien für Beitragende](CONTRIBUTING.md). Sicherheitslücken melden Sie bitte gemäß der -[Sicherheitsrichtlinie](SECURITY.md). +[Richtlinien für Beitragende](../../CONTRIBUTING.md). Sicherheitslücken melden Sie bitte gemäß der +[Sicherheitsrichtlinie](../../SECURITY.md). ## Roadmap -In der [Roadmap](ROADMAP.md) sehen Sie, was für kommende Releases geplant ist. +In der [Roadmap](../../ROADMAP.md) sehen Sie, was für kommende Releases geplant ist. ## Änderungsprotokoll -Eine ausführliche Liste der Änderungen und Updates finden Sie im [CHANGELOG](CHANGELOG.md). +Eine ausführliche Liste der Änderungen und Updates finden Sie im [CHANGELOG](../../CHANGELOG.md). ## Unterstützung @@ -172,7 +172,7 @@ hilft, können Sie es über [GitHub Sponsors](https://github.com/sponsors/Maksym ## Lizenz -Dieses Projekt steht unter der [Apache-2.0-Lizenz](LICENSE). +Dieses Projekt steht unter der [Apache-2.0-Lizenz](../../LICENSE). --- diff --git a/README.es.md b/docs/readme/README.es.md similarity index 73% rename from README.es.md rename to docs/readme/README.es.md index 2297f34..cdd1e91 100644 --- a/README.es.md +++ b/docs/readme/README.es.md @@ -1,6 +1,6 @@ -![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG) +![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)

@@ -8,18 +8,18 @@

-[English](README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | **Español** | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) +[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | **Español** | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) -> Esta traducción se preparó con ayuda de IA a partir de [README.md](README.md) para la versión 1.10.0. La versión en -> inglés del README es la de referencia. Las correcciones son bienvenidas: consulta [CONTRIBUTING.md](CONTRIBUTING.md). +> Esta traducción se preparó con ayuda de IA a partir de [README.md](../../README.md) para la versión 1.10.0. La versión en +> inglés del README es la de referencia. Las correcciones son bienvenidas: consulta [CONTRIBUTING.md](../../CONTRIBUTING.md). # Boot Framework for Google Apps Script™

Built with clasp - License - Security Policy - Roadmap + License + Security Policy + Roadmap Latest release

@@ -109,20 +109,20 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ``` El recorrido completo, incluidos `doPost` y la aplicación asíncrona `AsyncApp`, está en la -[guía Quick Start](docs/guide/quick-start.md) (en inglés). +[guía Quick Start](../guide/quick-start.md) (en inglés). ## Documentación Las guías detalladas están disponibles en inglés: -- [Quick Start](docs/guide/quick-start.md): configuración de `App` (síncrona) y `AsyncApp` (asíncrona). -- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md): parámetros de la petición, tipos +- [Quick Start](../guide/quick-start.md): configuración de `App` (síncrona) y `AsyncApp` (asíncrona). +- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md): parámetros de la petición, tipos MIME, llamadas mediante `google.script.run` y la URL de la aplicación web, envoltura de respuestas. -- [Decorators](docs/guide/decorators.md): decoradores de clase, método y parámetro, validación y pipes integrados. -- [Controlling the Response](docs/guide/responses.md): `ResponseEntity` y `@ResponseBody`. -- [Advanced Examples](docs/guide/examples.md): pipes y gestión global de errores. -- [AI Agent Skills](docs/guide/ai-agent-skills.md): lista completa de skills y opciones de instalación. -- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md): comparación de arquitecturas. +- [Decorators](../guide/decorators.md): decoradores de clase, método y parámetro, validación y pipes integrados. +- [Controlling the Response](../guide/responses.md): `ResponseEntity` y `@ResponseBody`. +- [Advanced Examples](../guide/examples.md): pipes y gestión global de errores. +- [AI Agent Skills](../guide/ai-agent-skills.md): lista completa de skills y opciones de instalación. +- [Boot.gs vs Spring Boot vs NestJS](../comparison.md): comparación de arquitecturas. ## Skills para agentes de IA @@ -136,7 +136,7 @@ estructurar y validar aplicaciones **Boot.gs**, además de skills genéricas par ``` La lista completa y la instalación para Gemini CLI y `npx skills` están en -[AI Agent Skills](docs/guide/ai-agent-skills.md). +[AI Agent Skills](../guide/ai-agent-skills.md). ## Recomendado @@ -151,17 +151,17 @@ La lista completa y la instalación para Gemini CLI y `npx skills` están en ## Cómo contribuir -¡Las contribuciones son bienvenidas! Consulta la [guía de contribución](CONTRIBUTING.md) para conocer el código de +¡Las contribuciones son bienvenidas! Consulta la [guía de contribución](../../CONTRIBUTING.md) para conocer el código de conducta y el proceso para enviar pull requests. Para informar de una vulnerabilidad, sigue la -[política de seguridad](SECURITY.md). +[política de seguridad](../../SECURITY.md). ## Hoja de ruta -Consulta la [hoja de ruta](ROADMAP.md) para ver lo que está previsto en las próximas versiones. +Consulta la [hoja de ruta](../../ROADMAP.md) para ver lo que está previsto en las próximas versiones. ## Registro de cambios -La lista detallada de cambios y actualizaciones está en el [CHANGELOG](CHANGELOG.md). +La lista detallada de cambios y actualizaciones está en el [CHANGELOG](../../CHANGELOG.md). ## Apoyo @@ -171,7 +171,7 @@ te resulta útil, puedes apoyarlo a través de [GitHub Sponsors](https://github. ## Licencia -Este proyecto se distribuye bajo la [licencia Apache-2.0](LICENSE). +Este proyecto se distribuye bajo la [licencia Apache-2.0](../../LICENSE). --- diff --git a/README.fr.md b/docs/readme/README.fr.md similarity index 74% rename from README.fr.md rename to docs/readme/README.fr.md index 95ba7b9..0d3f45c 100644 --- a/README.fr.md +++ b/docs/readme/README.fr.md @@ -1,6 +1,6 @@ -![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG) +![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)

@@ -8,18 +8,18 @@

-[English](README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | **Français** | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) +[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | **Français** | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) -> Cette traduction a été réalisée avec l'aide de l'IA à partir de [README.md](README.md) pour la version 1.10.0. Le -> README anglais fait foi. Les corrections sont les bienvenues — voir [CONTRIBUTING.md](CONTRIBUTING.md). +> Cette traduction a été réalisée avec l'aide de l'IA à partir de [README.md](../../README.md) pour la version 1.10.0. Le +> README anglais fait foi. Les corrections sont les bienvenues — voir [CONTRIBUTING.md](../../CONTRIBUTING.md). # Boot Framework for Google Apps Script™

Built with clasp - License - Security Policy - Roadmap + License + Security Policy + Roadmap Latest release

@@ -111,20 +111,20 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ``` Le tutoriel complet, avec `doPost` et l'application asynchrone `AsyncApp`, se trouve dans le -[guide Quick Start](docs/guide/quick-start.md) (en anglais). +[guide Quick Start](../guide/quick-start.md) (en anglais). ## Documentation Les guides détaillés sont disponibles en anglais : -- [Quick Start](docs/guide/quick-start.md) : configuration de `App` (synchrone) et de `AsyncApp` (asynchrone). -- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md) : paramètres de requête, types +- [Quick Start](../guide/quick-start.md) : configuration de `App` (synchrone) et de `AsyncApp` (asynchrone). +- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md) : paramètres de requête, types MIME, appels via `google.script.run` et l'URL de l'application web, encapsulation des réponses. -- [Decorators](docs/guide/decorators.md) : décorateurs de classe, de méthode et de paramètre, validation et pipes intégrés. -- [Controlling the Response](docs/guide/responses.md) : `ResponseEntity` et `@ResponseBody`. -- [Advanced Examples](docs/guide/examples.md) : pipes et gestion globale des erreurs. -- [AI Agent Skills](docs/guide/ai-agent-skills.md) : liste complète des skills et options d'installation. -- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md) : comparaison des architectures. +- [Decorators](../guide/decorators.md) : décorateurs de classe, de méthode et de paramètre, validation et pipes intégrés. +- [Controlling the Response](../guide/responses.md) : `ResponseEntity` et `@ResponseBody`. +- [Advanced Examples](../guide/examples.md) : pipes et gestion globale des erreurs. +- [AI Agent Skills](../guide/ai-agent-skills.md) : liste complète des skills et options d'installation. +- [Boot.gs vs Spring Boot vs NestJS](../comparison.md) : comparaison des architectures. ## Skills pour agents IA @@ -138,7 +138,7 @@ et valider des applications **Boot.gs**, ainsi que des skills génériques pour ``` La liste complète et l'installation pour Gemini CLI et `npx skills` sont décrites dans -[AI Agent Skills](docs/guide/ai-agent-skills.md). +[AI Agent Skills](../guide/ai-agent-skills.md). ## Recommandé @@ -153,17 +153,17 @@ La liste complète et l'installation pour Gemini CLI et `npx skills` sont décri ## Contribuer -Les contributions sont les bienvenues ! Consultez le [guide de contribution](CONTRIBUTING.md) pour le code de conduite +Les contributions sont les bienvenues ! Consultez le [guide de contribution](../../CONTRIBUTING.md) pour le code de conduite et la procédure de soumission des pull requests. Pour signaler une vulnérabilité, suivez la -[politique de sécurité](SECURITY.md). +[politique de sécurité](../../SECURITY.md). ## Feuille de route -Consultez la [feuille de route](ROADMAP.md) pour voir ce qui est prévu dans les prochaines versions. +Consultez la [feuille de route](../../ROADMAP.md) pour voir ce qui est prévu dans les prochaines versions. ## Journal des modifications -La liste détaillée des changements et mises à jour se trouve dans le [CHANGELOG](CHANGELOG.md). +La liste détaillée des changements et mises à jour se trouve dans le [CHANGELOG](../../CHANGELOG.md). ## Soutien @@ -173,7 +173,7 @@ vous pouvez le soutenir via [GitHub Sponsors](https://github.com/sponsors/Maksym ## Licence -Ce projet est distribué sous [licence Apache-2.0](LICENSE). +Ce projet est distribué sous [licence Apache-2.0](../../LICENSE). --- diff --git a/README.id.md b/docs/readme/README.id.md similarity index 71% rename from README.id.md rename to docs/readme/README.id.md index a4c0c1c..92ca134 100644 --- a/README.id.md +++ b/docs/readme/README.id.md @@ -1,6 +1,6 @@ -![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG) +![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)

@@ -8,17 +8,17 @@

-[English](README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | **Bahasa Indonesia** | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) +[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | **Bahasa Indonesia** | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) -> Terjemahan ini disiapkan dengan bantuan AI dari [README.md](README.md) untuk versi 1.10.0. README berbahasa Inggris adalah versi acuan. Koreksi sangat kami harapkan: lihat [CONTRIBUTING.md](CONTRIBUTING.md). +> Terjemahan ini disiapkan dengan bantuan AI dari [README.md](../../README.md) untuk versi 1.10.0. README berbahasa Inggris adalah versi acuan. Koreksi sangat kami harapkan: lihat [CONTRIBUTING.md](../../CONTRIBUTING.md). # Boot Framework for Google Apps Script™

Built with clasp - License - Security Policy - Roadmap + License + Security Policy + Roadmap Latest release

@@ -107,20 +107,20 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ``` Panduan lengkapnya, termasuk `doPost` dan aplikasi asinkron `AsyncApp`, ada di -[panduan Quick Start](docs/guide/quick-start.md) (dalam bahasa Inggris). +[panduan Quick Start](../guide/quick-start.md) (dalam bahasa Inggris). ## Dokumentasi Panduan terperinci tersedia dalam bahasa Inggris: -- [Quick Start](docs/guide/quick-start.md): penyiapan `App` (sinkron) dan `AsyncApp` (asinkron). -- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md): parameter permintaan, tipe MIME, +- [Quick Start](../guide/quick-start.md): penyiapan `App` (sinkron) dan `AsyncApp` (asinkron). +- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md): parameter permintaan, tipe MIME, panggilan melalui `google.script.run` dan URL Web App, pembungkusan respons. -- [Decorators](docs/guide/decorators.md): dekorator kelas, method, dan parameter, validasi, serta pipe bawaan. -- [Controlling the Response](docs/guide/responses.md): `ResponseEntity` dan `@ResponseBody`. -- [Advanced Examples](docs/guide/examples.md): pipe dan penanganan error global. -- [AI Agent Skills](docs/guide/ai-agent-skills.md): daftar lengkap skill dan opsi instalasi. -- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md): perbandingan arsitektur. +- [Decorators](../guide/decorators.md): dekorator kelas, method, dan parameter, validasi, serta pipe bawaan. +- [Controlling the Response](../guide/responses.md): `ResponseEntity` dan `@ResponseBody`. +- [Advanced Examples](../guide/examples.md): pipe dan penanganan error global. +- [AI Agent Skills](../guide/ai-agent-skills.md): daftar lengkap skill dan opsi instalasi. +- [Boot.gs vs Spring Boot vs NestJS](../comparison.md): perbandingan arsitektur. ## Skill untuk agen AI @@ -134,7 +134,7 @@ terikat pada framework tertentu. /plugin install bootgs@bootgs-skills ``` -Daftar lengkap serta instalasi untuk Gemini CLI dan `npx skills` ada di [AI Agent Skills](docs/guide/ai-agent-skills.md). +Daftar lengkap serta instalasi untuk Gemini CLI dan `npx skills` ada di [AI Agent Skills](../guide/ai-agent-skills.md). ## Rekomendasi @@ -149,16 +149,16 @@ Daftar lengkap serta instalasi untuk Gemini CLI dan `npx skills` ada di [AI Agen ## Berkontribusi -Kontribusi sangat kami sambut! Lihat [panduan kontribusi](CONTRIBUTING.md) untuk mengetahui kode etik dan proses -pengajuan pull request. Untuk melaporkan kerentanan, ikuti [kebijakan keamanan](SECURITY.md). +Kontribusi sangat kami sambut! Lihat [panduan kontribusi](../../CONTRIBUTING.md) untuk mengetahui kode etik dan proses +pengajuan pull request. Untuk melaporkan kerentanan, ikuti [kebijakan keamanan](../../SECURITY.md). ## Peta jalan -Lihat [peta jalan](ROADMAP.md) untuk mengetahui apa yang direncanakan pada rilis mendatang. +Lihat [peta jalan](../../ROADMAP.md) untuk mengetahui apa yang direncanakan pada rilis mendatang. ## Catatan perubahan -Daftar perubahan dan pembaruan secara terperinci ada di [CHANGELOG](CHANGELOG.md). +Daftar perubahan dan pembaruan secara terperinci ada di [CHANGELOG](../../CHANGELOG.md). ## Dukungan @@ -168,7 +168,7 @@ atau [Buy Me a Coffee](https://buymeacoffee.com/MaksymStoianov). ## Lisensi -Proyek ini dilisensikan di bawah [lisensi Apache-2.0](LICENSE). +Proyek ini dilisensikan di bawah [lisensi Apache-2.0](../../LICENSE). --- diff --git a/README.it.md b/docs/readme/README.it.md similarity index 73% rename from README.it.md rename to docs/readme/README.it.md index 56a56da..97f271b 100644 --- a/README.it.md +++ b/docs/readme/README.it.md @@ -1,6 +1,6 @@ -![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG) +![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)

@@ -8,17 +8,17 @@

-[English](README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | **Italiano** | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) +[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | **Italiano** | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) -> Questa traduzione è stata preparata con l'aiuto dell'IA a partire da [README.md](README.md) per la versione 1.10.0. Il README in inglese è la versione di riferimento. Le correzioni sono benvenute: consulta [CONTRIBUTING.md](CONTRIBUTING.md). +> Questa traduzione è stata preparata con l'aiuto dell'IA a partire da [README.md](../../README.md) per la versione 1.10.0. Il README in inglese è la versione di riferimento. Le correzioni sono benvenute: consulta [CONTRIBUTING.md](../../CONTRIBUTING.md). # Boot Framework for Google Apps Script™

Built with clasp - License - Security Policy - Roadmap + License + Security Policy + Roadmap Latest release

@@ -111,20 +111,20 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ``` La procedura completa, inclusi `doPost` e l'applicazione asincrona `AsyncApp`, è nella -[guida Quick Start](docs/guide/quick-start.md) (in inglese). +[guida Quick Start](../guide/quick-start.md) (in inglese). ## Documentazione Le guide dettagliate sono disponibili in inglese: -- [Quick Start](docs/guide/quick-start.md): configurazione di `App` (sincrona) e `AsyncApp` (asincrona). -- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md): parametri della richiesta, tipi +- [Quick Start](../guide/quick-start.md): configurazione di `App` (sincrona) e `AsyncApp` (asincrona). +- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md): parametri della richiesta, tipi MIME, chiamate tramite `google.script.run` e l'URL della web app, incapsulamento delle risposte. -- [Decorators](docs/guide/decorators.md): decoratori di classe, metodo e parametro, validazione e pipe integrate. -- [Controlling the Response](docs/guide/responses.md): `ResponseEntity` e `@ResponseBody`. -- [Advanced Examples](docs/guide/examples.md): pipe e gestione globale degli errori. -- [AI Agent Skills](docs/guide/ai-agent-skills.md): elenco completo delle skill e opzioni di installazione. -- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md): confronto tra le architetture. +- [Decorators](../guide/decorators.md): decoratori di classe, metodo e parametro, validazione e pipe integrate. +- [Controlling the Response](../guide/responses.md): `ResponseEntity` e `@ResponseBody`. +- [Advanced Examples](../guide/examples.md): pipe e gestione globale degli errori. +- [AI Agent Skills](../guide/ai-agent-skills.md): elenco completo delle skill e opzioni di installazione. +- [Boot.gs vs Spring Boot vs NestJS](../comparison.md): confronto tra le architetture. ## Skill per agenti IA @@ -138,7 +138,7 @@ strutturare e validare applicazioni **Boot.gs**, oltre a skill generiche per lo ``` L'elenco completo e l'installazione per Gemini CLI e `npx skills` sono in -[AI Agent Skills](docs/guide/ai-agent-skills.md). +[AI Agent Skills](../guide/ai-agent-skills.md). ## Consigliato @@ -153,17 +153,17 @@ L'elenco completo e l'installazione per Gemini CLI e `npx skills` sono in ## Come contribuire -I contributi sono benvenuti! Consulta le [linee guida per i contributi](CONTRIBUTING.md) per il codice di condotta e +I contributi sono benvenuti! Consulta le [linee guida per i contributi](../../CONTRIBUTING.md) per il codice di condotta e la procedura per inviare pull request. Per segnalare una vulnerabilità, segui la -[politica di sicurezza](SECURITY.md). +[politica di sicurezza](../../SECURITY.md). ## Roadmap -Consulta la [roadmap](ROADMAP.md) per vedere cosa è previsto nelle prossime versioni. +Consulta la [roadmap](../../ROADMAP.md) per vedere cosa è previsto nelle prossime versioni. ## Registro delle modifiche -L'elenco dettagliato delle modifiche e degli aggiornamenti è nel [CHANGELOG](CHANGELOG.md). +L'elenco dettagliato delle modifiche e degli aggiornamenti è nel [CHANGELOG](../../CHANGELOG.md). ## Supporto @@ -173,7 +173,7 @@ utile, puoi sostenerlo tramite [GitHub Sponsors](https://github.com/sponsors/Mak ## Licenza -Questo progetto è distribuito con [licenza Apache-2.0](LICENSE). +Questo progetto è distribuito con [licenza Apache-2.0](../../LICENSE). --- diff --git a/README.ja.md b/docs/readme/README.ja.md similarity index 70% rename from README.ja.md rename to docs/readme/README.ja.md index c7cbfc0..3b1f00f 100644 --- a/README.ja.md +++ b/docs/readme/README.ja.md @@ -1,6 +1,6 @@ -![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG) +![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)

@@ -8,17 +8,17 @@

-[English](README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | **日本語** | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) +[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | **日本語** | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) -> この翻訳は、バージョン 1.10.0 の [README.md](README.md) をもとに AI の支援を受けて作成されました。正式な内容は英語版の README です。修正の提案を歓迎します。詳しくは [CONTRIBUTING.md](CONTRIBUTING.md) をご覧ください。 +> この翻訳は、バージョン 1.10.0 の [README.md](../../README.md) をもとに AI の支援を受けて作成されました。正式な内容は英語版の README です。修正の提案を歓迎します。詳しくは [CONTRIBUTING.md](../../CONTRIBUTING.md) をご覧ください。 # Boot Framework for Google Apps Script™

Built with clasp - License - Security Policy - Roadmap + License + Security Policy + Roadmap Latest release

@@ -100,19 +100,19 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { } ``` -`doPost` や非同期の `AsyncApp` を含む完全な手順は、[Quick Start ガイド](docs/guide/quick-start.md)（英語）をご覧ください。 +`doPost` や非同期の `AsyncApp` を含む完全な手順は、[Quick Start ガイド](../guide/quick-start.md)（英語）をご覧ください。 ## ドキュメント 詳細なガイドは英語で提供されています。 -- [Quick Start](docs/guide/quick-start.md): 同期 `App` と非同期 `AsyncApp` のセットアップ。 -- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md): リクエストパラメーター、MIME タイプ、`google.script.run` と Web アプリ URL からの呼び出し、レスポンスのラップ。 -- [Decorators](docs/guide/decorators.md): クラス・メソッド・パラメーターのデコレーター、バリデーション、組み込み pipes。 -- [Controlling the Response](docs/guide/responses.md): `ResponseEntity` と `@ResponseBody`。 -- [Advanced Examples](docs/guide/examples.md): pipes とグローバルなエラー処理。 -- [AI Agent Skills](docs/guide/ai-agent-skills.md): スキルの一覧とインストール方法。 -- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md): アーキテクチャの比較。 +- [Quick Start](../guide/quick-start.md): 同期 `App` と非同期 `AsyncApp` のセットアップ。 +- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md): リクエストパラメーター、MIME タイプ、`google.script.run` と Web アプリ URL からの呼び出し、レスポンスのラップ。 +- [Decorators](../guide/decorators.md): クラス・メソッド・パラメーターのデコレーター、バリデーション、組み込み pipes。 +- [Controlling the Response](../guide/responses.md): `ResponseEntity` と `@ResponseBody`。 +- [Advanced Examples](../guide/examples.md): pipes とグローバルなエラー処理。 +- [AI Agent Skills](../guide/ai-agent-skills.md): スキルの一覧とインストール方法。 +- [Boot.gs vs Spring Boot vs NestJS](../comparison.md): アーキテクチャの比較。 ## AI エージェント向けスキル @@ -123,7 +123,7 @@ AI コーディングエージェント（Claude Code、Gemini CLI、Cursor な /plugin install bootgs@bootgs-skills ``` -スキルの一覧と、Gemini CLI や `npx skills` でのインストール方法は [AI Agent Skills](docs/guide/ai-agent-skills.md) をご覧ください。 +スキルの一覧と、Gemini CLI や `npx skills` でのインストール方法は [AI Agent Skills](../guide/ai-agent-skills.md) をご覧ください。 ## おすすめ @@ -137,15 +137,15 @@ AI コーディングエージェント（Claude Code、Gemini CLI、Cursor な ## コントリビューション -コントリビューションを歓迎します！行動規範とプルリクエストの手順については [コントリビューションガイド](CONTRIBUTING.md) をご覧ください。脆弱性の報告は [セキュリティポリシー](SECURITY.md) に従ってください。 +コントリビューションを歓迎します！行動規範とプルリクエストの手順については [コントリビューションガイド](../../CONTRIBUTING.md) をご覧ください。脆弱性の報告は [セキュリティポリシー](../../SECURITY.md) に従ってください。 ## ロードマップ -今後のリリース予定は [ロードマップ](ROADMAP.md) をご覧ください。 +今後のリリース予定は [ロードマップ](../../ROADMAP.md) をご覧ください。 ## 変更履歴 -変更点と更新内容の詳細は [CHANGELOG](CHANGELOG.md) を参照してください。 +変更点と更新内容の詳細は [CHANGELOG](../../CHANGELOG.md) を参照してください。 ## サポート @@ -153,7 +153,7 @@ AI コーディングエージェント（Claude Code、Gemini CLI、Cursor な ## ライセンス -このプロジェクトは [Apache-2.0 ライセンス](LICENSE) の下で公開されています。 +このプロジェクトは [Apache-2.0 ライセンス](../../LICENSE) の下で公開されています。 --- diff --git a/README.ko.md b/docs/readme/README.ko.md similarity index 71% rename from README.ko.md rename to docs/readme/README.ko.md index 07eea21..4bba5f1 100644 --- a/README.ko.md +++ b/docs/readme/README.ko.md @@ -1,6 +1,6 @@ -![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG) +![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)

@@ -8,17 +8,17 @@

-[English](README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | **한국어** | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) +[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | **한국어** | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) -> 이 번역은 버전 1.10.0의 [README.md](README.md)를 바탕으로 AI의 도움을 받아 작성되었습니다. 기준이 되는 버전은 영어 README입니다. 수정 제안을 환영합니다. 자세한 내용은 [CONTRIBUTING.md](CONTRIBUTING.md)를 참고하세요. +> 이 번역은 버전 1.10.0의 [README.md](../../README.md)를 바탕으로 AI의 도움을 받아 작성되었습니다. 기준이 되는 버전은 영어 README입니다. 수정 제안을 환영합니다. 자세한 내용은 [CONTRIBUTING.md](../../CONTRIBUTING.md)를 참고하세요. # Boot Framework for Google Apps Script™

Built with clasp - License - Security Policy - Roadmap + License + Security Policy + Roadmap Latest release

@@ -100,19 +100,19 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { } ``` -`doPost`와 비동기 `AsyncApp`을 포함한 전체 안내는 [Quick Start 가이드](docs/guide/quick-start.md)(영어)에서 확인할 수 있습니다. +`doPost`와 비동기 `AsyncApp`을 포함한 전체 안내는 [Quick Start 가이드](../guide/quick-start.md)(영어)에서 확인할 수 있습니다. ## 문서 자세한 가이드는 영어로 제공됩니다. -- [Quick Start](docs/guide/quick-start.md): 동기 `App`과 비동기 `AsyncApp` 설정. -- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md): 요청 매개변수, MIME 타입, `google.script.run` 및 웹 앱 URL을 통한 호출, 응답 래핑. -- [Decorators](docs/guide/decorators.md): 클래스, 메서드, 매개변수 데코레이터, 유효성 검사와 내장 파이프. -- [Controlling the Response](docs/guide/responses.md): `ResponseEntity`와 `@ResponseBody`. -- [Advanced Examples](docs/guide/examples.md): 파이프와 전역 오류 처리. -- [AI Agent Skills](docs/guide/ai-agent-skills.md): 전체 스킬 목록과 설치 방법. -- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md): 아키텍처 비교. +- [Quick Start](../guide/quick-start.md): 동기 `App`과 비동기 `AsyncApp` 설정. +- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md): 요청 매개변수, MIME 타입, `google.script.run` 및 웹 앱 URL을 통한 호출, 응답 래핑. +- [Decorators](../guide/decorators.md): 클래스, 메서드, 매개변수 데코레이터, 유효성 검사와 내장 파이프. +- [Controlling the Response](../guide/responses.md): `ResponseEntity`와 `@ResponseBody`. +- [Advanced Examples](../guide/examples.md): 파이프와 전역 오류 처리. +- [AI Agent Skills](../guide/ai-agent-skills.md): 전체 스킬 목록과 설치 방법. +- [Boot.gs vs Spring Boot vs NestJS](../comparison.md): 아키텍처 비교. ## AI 에이전트용 스킬 @@ -123,7 +123,7 @@ AI 코딩 에이전트(Claude Code, Gemini CLI, Cursor 등)를 사용하고 계 /plugin install bootgs@bootgs-skills ``` -전체 목록과 Gemini CLI 및 `npx skills`를 이용한 설치 방법은 [AI Agent Skills](docs/guide/ai-agent-skills.md)를 참고하세요. +전체 목록과 Gemini CLI 및 `npx skills`를 이용한 설치 방법은 [AI Agent Skills](../guide/ai-agent-skills.md)를 참고하세요. ## 추천 @@ -137,15 +137,15 @@ AI 코딩 에이전트(Claude Code, Gemini CLI, Cursor 등)를 사용하고 계 ## 기여하기 -기여를 환영합니다! 행동 강령과 풀 리퀘스트 제출 절차는 [기여 가이드](CONTRIBUTING.md)를 참고하세요. 취약점을 신고하려면 [보안 정책](SECURITY.md)을 따라 주세요. +기여를 환영합니다! 행동 강령과 풀 리퀘스트 제출 절차는 [기여 가이드](../../CONTRIBUTING.md)를 참고하세요. 취약점을 신고하려면 [보안 정책](../../SECURITY.md)을 따라 주세요. ## 로드맵 -향후 릴리스 계획은 [로드맵](ROADMAP.md)에서 확인하세요. +향후 릴리스 계획은 [로드맵](../../ROADMAP.md)에서 확인하세요. ## 변경 이력 -변경 사항과 업데이트의 자세한 목록은 [CHANGELOG](CHANGELOG.md)를 참고하세요. +변경 사항과 업데이트의 자세한 목록은 [CHANGELOG](../../CHANGELOG.md)를 참고하세요. ## 지원 @@ -153,7 +153,7 @@ AI 코딩 에이전트(Claude Code, Gemini CLI, Cursor 등)를 사용하고 계 ## 라이선스 -이 프로젝트는 [Apache-2.0 라이선스](LICENSE)에 따라 배포됩니다. +이 프로젝트는 [Apache-2.0 라이선스](../../LICENSE)에 따라 배포됩니다. --- diff --git a/README.nl.md b/docs/readme/README.nl.md similarity index 73% rename from README.nl.md rename to docs/readme/README.nl.md index cf39859..fdcb4c4 100644 --- a/README.nl.md +++ b/docs/readme/README.nl.md @@ -1,6 +1,6 @@ -![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG) +![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)

@@ -8,17 +8,17 @@

-[English](README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | **Nederlands** | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) +[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | **Nederlands** | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) -> Deze vertaling is met behulp van AI gemaakt op basis van [README.md](README.md) voor versie 1.10.0. De Engelse README is de referentieversie. Correcties zijn welkom: zie [CONTRIBUTING.md](CONTRIBUTING.md). +> Deze vertaling is met behulp van AI gemaakt op basis van [README.md](../../README.md) voor versie 1.10.0. De Engelse README is de referentieversie. Correcties zijn welkom: zie [CONTRIBUTING.md](../../CONTRIBUTING.md). # Boot Framework for Google Apps Script™

Built with clasp - License - Security Policy - Roadmap + License + Security Policy + Roadmap Latest release

@@ -109,20 +109,20 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ``` De volledige uitleg, inclusief `doPost` en de asynchrone `AsyncApp`, staat in de -[Quick Start-gids](docs/guide/quick-start.md) (in het Engels). +[Quick Start-gids](../guide/quick-start.md) (in het Engels). ## Documentatie De uitgebreide handleidingen zijn beschikbaar in het Engels: -- [Quick Start](docs/guide/quick-start.md): opzet van de synchrone `App` en de asynchrone `AsyncApp`. -- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md): verzoekparameters, MIME-typen, +- [Quick Start](../guide/quick-start.md): opzet van de synchrone `App` en de asynchrone `AsyncApp`. +- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md): verzoekparameters, MIME-typen, aanroepen via `google.script.run` en de URL van de web-app, het verpakken van responses. -- [Decorators](docs/guide/decorators.md): decorators voor klassen, methoden en parameters, validatie en ingebouwde pipes. -- [Controlling the Response](docs/guide/responses.md): `ResponseEntity` en `@ResponseBody`. -- [Advanced Examples](docs/guide/examples.md): pipes en globale foutafhandeling. -- [AI Agent Skills](docs/guide/ai-agent-skills.md): de volledige lijst met skills en installatieopties. -- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md): vergelijking van de architecturen. +- [Decorators](../guide/decorators.md): decorators voor klassen, methoden en parameters, validatie en ingebouwde pipes. +- [Controlling the Response](../guide/responses.md): `ResponseEntity` en `@ResponseBody`. +- [Advanced Examples](../guide/examples.md): pipes en globale foutafhandeling. +- [AI Agent Skills](../guide/ai-agent-skills.md): de volledige lijst met skills en installatieopties. +- [Boot.gs vs Spring Boot vs NestJS](../comparison.md): vergelijking van de architecturen. ## Skills voor AI-agents @@ -136,7 +136,7 @@ opzet, structureert en valideert, plus framework-onafhankelijke skills voor ontw ``` De volledige lijst en de installatie voor Gemini CLI en `npx skills` vind je in -[AI Agent Skills](docs/guide/ai-agent-skills.md). +[AI Agent Skills](../guide/ai-agent-skills.md). ## Aanbevolen @@ -151,17 +151,17 @@ De volledige lijst en de installatie voor Gemini CLI en `npx skills` vind je in ## Bijdragen -Bijdragen zijn van harte welkom! Lees de [richtlijnen voor bijdragers](CONTRIBUTING.md) voor de gedragscode en de -werkwijze voor het indienen van pull requests. Volg het [beveiligingsbeleid](SECURITY.md) om een kwetsbaarheid te +Bijdragen zijn van harte welkom! Lees de [richtlijnen voor bijdragers](../../CONTRIBUTING.md) voor de gedragscode en de +werkwijze voor het indienen van pull requests. Volg het [beveiligingsbeleid](../../SECURITY.md) om een kwetsbaarheid te melden. ## Roadmap -Bekijk de [roadmap](ROADMAP.md) om te zien wat er voor toekomstige releases gepland staat. +Bekijk de [roadmap](../../ROADMAP.md) om te zien wat er voor toekomstige releases gepland staat. ## Changelog -Een gedetailleerde lijst met wijzigingen en updates vind je in de [CHANGELOG](CHANGELOG.md). +Een gedetailleerde lijst met wijzigingen en updates vind je in de [CHANGELOG](../../CHANGELOG.md). ## Ondersteuning @@ -171,7 +171,7 @@ project, dan kun je het steunen via [GitHub Sponsors](https://github.com/sponsor ## Licentie -Dit project valt onder de [Apache-2.0-licentie](LICENSE). +Dit project valt onder de [Apache-2.0-licentie](../../LICENSE). --- diff --git a/README.pl.md b/docs/readme/README.pl.md similarity index 73% rename from README.pl.md rename to docs/readme/README.pl.md index df304f9..4627b1b 100644 --- a/README.pl.md +++ b/docs/readme/README.pl.md @@ -1,6 +1,6 @@ -![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG) +![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)

@@ -8,17 +8,17 @@

-[English](README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | **Polski** | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) +[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | **Polski** | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) -> To tłumaczenie przygotowano z pomocą AI na podstawie [README.md](README.md) dla wersji 1.10.0. Wersją wzorcową jest angielskie README. Poprawki są mile widziane: zajrzyj do [CONTRIBUTING.md](CONTRIBUTING.md). +> To tłumaczenie przygotowano z pomocą AI na podstawie [README.md](../../README.md) dla wersji 1.10.0. Wersją wzorcową jest angielskie README. Poprawki są mile widziane: zajrzyj do [CONTRIBUTING.md](../../CONTRIBUTING.md). # Boot Framework for Google Apps Script™

Built with clasp - License - Security Policy - Roadmap + License + Security Policy + Roadmap Latest release

@@ -111,20 +111,20 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ``` Pełny przewodnik, obejmujący także `doPost` i asynchroniczną aplikację `AsyncApp`, znajdziesz w -[przewodniku Quick Start](docs/guide/quick-start.md) (po angielsku). +[przewodniku Quick Start](../guide/quick-start.md) (po angielsku). ## Dokumentacja Szczegółowe przewodniki są dostępne po angielsku: -- [Quick Start](docs/guide/quick-start.md): konfiguracja synchronicznej `App` i asynchronicznej `AsyncApp`. -- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md): parametry żądania, typy MIME, +- [Quick Start](../guide/quick-start.md): konfiguracja synchronicznej `App` i asynchronicznej `AsyncApp`. +- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md): parametry żądania, typy MIME, wywołania przez `google.script.run` i adres URL aplikacji internetowej, opakowywanie odpowiedzi. -- [Decorators](docs/guide/decorators.md): dekoratory klas, metod i parametrów, walidacja i wbudowane pipes. -- [Controlling the Response](docs/guide/responses.md): `ResponseEntity` i `@ResponseBody`. -- [Advanced Examples](docs/guide/examples.md): pipes i globalna obsługa błędów. -- [AI Agent Skills](docs/guide/ai-agent-skills.md): pełna lista skills i opcje instalacji. -- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md): porównanie architektur. +- [Decorators](../guide/decorators.md): dekoratory klas, metod i parametrów, walidacja i wbudowane pipes. +- [Controlling the Response](../guide/responses.md): `ResponseEntity` i `@ResponseBody`. +- [Advanced Examples](../guide/examples.md): pipes i globalna obsługa błędów. +- [AI Agent Skills](../guide/ai-agent-skills.md): pełna lista skills i opcje instalacji. +- [Boot.gs vs Spring Boot vs NestJS](../comparison.md): porównanie architektur. ## Skills dla agentów AI @@ -139,7 +139,7 @@ z Google Apps Script. ``` Pełną listę oraz instalację dla Gemini CLI i `npx skills` znajdziesz w -[AI Agent Skills](docs/guide/ai-agent-skills.md). +[AI Agent Skills](../guide/ai-agent-skills.md). ## Polecane @@ -155,16 +155,16 @@ Pełną listę oraz instalację dla Gemini CLI i `npx skills` znajdziesz w ## Jak pomóc w rozwoju Zachęcamy do współtworzenia projektu! Zasady postępowania i proces zgłaszania pull requestów opisuje -[przewodnik dla współtwórców](CONTRIBUTING.md). Aby zgłosić podatność, postępuj zgodnie z -[polityką bezpieczeństwa](SECURITY.md). +[przewodnik dla współtwórców](../../CONTRIBUTING.md). Aby zgłosić podatność, postępuj zgodnie z +[polityką bezpieczeństwa](../../SECURITY.md). ## Plan rozwoju -Zajrzyj do [planu rozwoju](ROADMAP.md), aby zobaczyć, co planujemy w kolejnych wydaniach. +Zajrzyj do [planu rozwoju](../../ROADMAP.md), aby zobaczyć, co planujemy w kolejnych wydaniach. ## Historia zmian -Szczegółowa lista zmian i aktualizacji znajduje się w [CHANGELOG](CHANGELOG.md). +Szczegółowa lista zmian i aktualizacji znajduje się w [CHANGELOG](../../CHANGELOG.md). ## Wsparcie @@ -174,7 +174,7 @@ możesz go wesprzeć przez [GitHub Sponsors](https://github.com/sponsors/MaksymS ## Licencja -Ten projekt jest udostępniany na [licencji Apache-2.0](LICENSE). +Ten projekt jest udostępniany na [licencji Apache-2.0](../../LICENSE). --- diff --git a/README.pt.md b/docs/readme/README.pt.md similarity index 73% rename from README.pt.md rename to docs/readme/README.pt.md index 668b37d..539fc10 100644 --- a/README.pt.md +++ b/docs/readme/README.pt.md @@ -1,6 +1,6 @@ -![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG) +![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)

@@ -8,18 +8,18 @@

-[English](README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | **Português** | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) +[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | **Português** | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) -> Esta tradução foi feita com ajuda de IA a partir do [README.md](README.md) para a versão 1.10.0. O README em inglês é -> a versão oficial. Correções são bem-vindas — veja o [CONTRIBUTING.md](CONTRIBUTING.md). +> Esta tradução foi feita com ajuda de IA a partir do [README.md](../../README.md) para a versão 1.10.0. O README em inglês é +> a versão oficial. Correções são bem-vindas — veja o [CONTRIBUTING.md](../../CONTRIBUTING.md). # Boot Framework for Google Apps Script™

Built with clasp - License - Security Policy - Roadmap + License + Security Policy + Roadmap Latest release

@@ -110,20 +110,20 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ``` O passo a passo completo, incluindo `doPost` e a aplicação assíncrona `AsyncApp`, está no -[guia Quick Start](docs/guide/quick-start.md) (em inglês). +[guia Quick Start](../guide/quick-start.md) (em inglês). ## Documentação Os guias detalhados estão disponíveis em inglês: -- [Quick Start](docs/guide/quick-start.md): configuração do `App` (síncrono) e do `AsyncApp` (assíncrono). -- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md): parâmetros da requisição, tipos +- [Quick Start](../guide/quick-start.md): configuração do `App` (síncrono) e do `AsyncApp` (assíncrono). +- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md): parâmetros da requisição, tipos MIME, chamadas via `google.script.run` e pela URL do app da web, empacotamento das respostas. -- [Decorators](docs/guide/decorators.md): decorators de classe, método e parâmetro, validação e pipes nativos. -- [Controlling the Response](docs/guide/responses.md): `ResponseEntity` e `@ResponseBody`. -- [Advanced Examples](docs/guide/examples.md): pipes e tratamento global de erros. -- [AI Agent Skills](docs/guide/ai-agent-skills.md): lista completa de skills e opções de instalação. -- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md): comparação de arquiteturas. +- [Decorators](../guide/decorators.md): decorators de classe, método e parâmetro, validação e pipes nativos. +- [Controlling the Response](../guide/responses.md): `ResponseEntity` e `@ResponseBody`. +- [Advanced Examples](../guide/examples.md): pipes e tratamento global de erros. +- [AI Agent Skills](../guide/ai-agent-skills.md): lista completa de skills e opções de instalação. +- [Boot.gs vs Spring Boot vs NestJS](../comparison.md): comparação de arquiteturas. ## Skills para agentes de IA @@ -137,7 +137,7 @@ inicial, organizar e validar aplicações **Boot.gs**, além de skills genérica ``` A lista completa e a instalação para Gemini CLI e `npx skills` estão em -[AI Agent Skills](docs/guide/ai-agent-skills.md). +[AI Agent Skills](../guide/ai-agent-skills.md). ## Recomendado @@ -152,16 +152,16 @@ A lista completa e a instalação para Gemini CLI e `npx skills` estão em ## Como contribuir -Contribuições são bem-vindas! Veja o [guia de contribuição](CONTRIBUTING.md) para conhecer o código de conduta e o -processo de envio de pull requests. Para relatar uma vulnerabilidade, siga a [política de segurança](SECURITY.md). +Contribuições são bem-vindas! Veja o [guia de contribuição](../../CONTRIBUTING.md) para conhecer o código de conduta e o +processo de envio de pull requests. Para relatar uma vulnerabilidade, siga a [política de segurança](../../SECURITY.md). ## Roadmap -Confira o [roadmap](ROADMAP.md) para ver o que está planejado para as próximas versões. +Confira o [roadmap](../../ROADMAP.md) para ver o que está planejado para as próximas versões. ## Changelog -A lista detalhada de mudanças e atualizações está no [CHANGELOG](CHANGELOG.md). +A lista detalhada de mudanças e atualizações está no [CHANGELOG](../../CHANGELOG.md). ## Apoio @@ -171,7 +171,7 @@ para você, apoie-o pelo [GitHub Sponsors](https://github.com/sponsors/MaksymSto ## Licença -Este projeto é licenciado sob a [Licença Apache-2.0](LICENSE). +Este projeto é licenciado sob a [Licença Apache-2.0](../../LICENSE). --- diff --git a/README.ru.md b/docs/readme/README.ru.md similarity index 75% rename from README.ru.md rename to docs/readme/README.ru.md index 1ca0fdd..9ac3dc3 100644 --- a/README.ru.md +++ b/docs/readme/README.ru.md @@ -1,6 +1,6 @@ -![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG) +![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)

@@ -8,18 +8,18 @@

-[English](README.md) | [Українська](README.uk.md) | **Русский** | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) +[English](../../README.md) | [Українська](README.uk.md) | **Русский** | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) -> Этот перевод подготовлен с помощью ИИ на основе [README.md](README.md) для версии 1.10.0. Основной считается -> английская версия README. Исправления приветствуются — см. [CONTRIBUTING.md](CONTRIBUTING.md). +> Этот перевод подготовлен с помощью ИИ на основе [README.md](../../README.md) для версии 1.10.0. Основной считается +> английская версия README. Исправления приветствуются — см. [CONTRIBUTING.md](../../CONTRIBUTING.md). # Boot Framework for Google Apps Script™

Built with clasp - License - Security Policy - Roadmap + License + Security Policy + Roadmap Latest release

@@ -109,20 +109,20 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ``` Полный пошаговый пример, в том числе с `doPost` и асинхронным `AsyncApp`, — в -[руководстве Quick Start](docs/guide/quick-start.md) (на английском). +[руководстве Quick Start](../guide/quick-start.md) (на английском). ## Документация Подробные руководства доступны на английском: -- [Quick Start](docs/guide/quick-start.md): настройка синхронного `App` и асинхронного `AsyncApp`. -- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md): параметры запроса, MIME-типы, +- [Quick Start](../guide/quick-start.md): настройка синхронного `App` и асинхронного `AsyncApp`. +- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md): параметры запроса, MIME-типы, вызовы через `google.script.run` и URL веб-приложения, обёртка ответов. -- [Decorators](docs/guide/decorators.md): декораторы классов, методов и параметров, валидация и встроенные pipes. -- [Controlling the Response](docs/guide/responses.md): `ResponseEntity` и `@ResponseBody`. -- [Advanced Examples](docs/guide/examples.md): pipes и глобальная обработка ошибок. -- [AI Agent Skills](docs/guide/ai-agent-skills.md): полный список навыков и способы установки. -- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md): сравнение архитектур. +- [Decorators](../guide/decorators.md): декораторы классов, методов и параметров, валидация и встроенные pipes. +- [Controlling the Response](../guide/responses.md): `ResponseEntity` и `@ResponseBody`. +- [Advanced Examples](../guide/examples.md): pipes и глобальная обработка ошибок. +- [AI Agent Skills](../guide/ai-agent-skills.md): полный список навыков и способы установки. +- [Boot.gs vs Spring Boot vs NestJS](../comparison.md): сравнение архитектур. ## Навыки для ИИ-агентов @@ -135,7 +135,7 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { /plugin install bootgs@bootgs-skills ``` -Полный список и установка для Gemini CLI и `npx skills` — в разделе [AI Agent Skills](docs/guide/ai-agent-skills.md). +Полный список и установка для Gemini CLI и `npx skills` — в разделе [AI Agent Skills](../guide/ai-agent-skills.md). ## Рекомендуем @@ -151,15 +151,15 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ## Как внести вклад Мы рады вашему участию! Правила сообщества и порядок отправки pull request описаны в -[руководстве для участников](CONTRIBUTING.md). Чтобы сообщить об уязвимости, следуйте [политике безопасности](SECURITY.md). +[руководстве для участников](../../CONTRIBUTING.md). Чтобы сообщить об уязвимости, следуйте [политике безопасности](../../SECURITY.md). ## Дорожная карта -Планы на будущие релизы — в [дорожной карте](ROADMAP.md). +Планы на будущие релизы — в [дорожной карте](../../ROADMAP.md). ## Журнал изменений -Подробный список изменений и обновлений — в [CHANGELOG](CHANGELOG.md). +Подробный список изменений и обновлений — в [CHANGELOG](../../CHANGELOG.md). ## Поддержка @@ -169,7 +169,7 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ## Лицензия -Проект распространяется по [лицензии Apache-2.0](LICENSE). +Проект распространяется по [лицензии Apache-2.0](../../LICENSE). --- diff --git a/README.tr.md b/docs/readme/README.tr.md similarity index 73% rename from README.tr.md rename to docs/readme/README.tr.md index d6215a4..038066b 100644 --- a/README.tr.md +++ b/docs/readme/README.tr.md @@ -1,6 +1,6 @@ -![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG) +![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)

@@ -8,17 +8,17 @@

-[English](README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | **Türkçe** | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) +[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | **Türkçe** | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) -> Bu çeviri, 1.10.0 sürümü için [README.md](README.md) dosyasından yapay zekâ desteğiyle hazırlanmıştır. Referans sürüm İngilizce README'dir. Düzeltmelerinizi bekliyoruz: [CONTRIBUTING.md](CONTRIBUTING.md) dosyasına bakın. +> Bu çeviri, 1.10.0 sürümü için [README.md](../../README.md) dosyasından yapay zekâ desteğiyle hazırlanmıştır. Referans sürüm İngilizce README'dir. Düzeltmelerinizi bekliyoruz: [CONTRIBUTING.md](../../CONTRIBUTING.md) dosyasına bakın. # Boot Framework for Google Apps Script™

Built with clasp - License - Security Policy - Roadmap + License + Security Policy + Roadmap Latest release

@@ -109,20 +109,20 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ``` `doPost` ve asenkron `AsyncApp` dahil olmak üzere adım adım anlatımın tamamı -[Quick Start kılavuzunda](docs/guide/quick-start.md) (İngilizce) yer alır. +[Quick Start kılavuzunda](../guide/quick-start.md) (İngilizce) yer alır. ## Dokümantasyon Ayrıntılı kılavuzlar İngilizce olarak mevcuttur: -- [Quick Start](docs/guide/quick-start.md): senkron `App` ve asenkron `AsyncApp` kurulumu. -- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md): istek parametreleri, MIME +- [Quick Start](../guide/quick-start.md): senkron `App` ve asenkron `AsyncApp` kurulumu. +- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md): istek parametreleri, MIME türleri, `google.script.run` ve Web App URL'si üzerinden çağrılar, yanıtların sarmalanması. -- [Decorators](docs/guide/decorators.md): sınıf, metot ve parametre dekoratörleri, doğrulama ve yerleşik pipe'lar. -- [Controlling the Response](docs/guide/responses.md): `ResponseEntity` ve `@ResponseBody`. -- [Advanced Examples](docs/guide/examples.md): pipe'lar ve genel hata yönetimi. -- [AI Agent Skills](docs/guide/ai-agent-skills.md): skill'lerin tam listesi ve kurulum seçenekleri. -- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md): mimari karşılaştırması. +- [Decorators](../guide/decorators.md): sınıf, metot ve parametre dekoratörleri, doğrulama ve yerleşik pipe'lar. +- [Controlling the Response](../guide/responses.md): `ResponseEntity` ve `@ResponseBody`. +- [Advanced Examples](../guide/examples.md): pipe'lar ve genel hata yönetimi. +- [AI Agent Skills](../guide/ai-agent-skills.md): skill'lerin tam listesi ve kurulum seçenekleri. +- [Boot.gs vs Spring Boot vs NestJS](../comparison.md): mimari karşılaştırması. ## Yapay zekâ ajanları için skill'ler @@ -136,7 +136,7 @@ bağımsız skill'ler sunar. /plugin install bootgs@bootgs-skills ``` -Tam liste ile Gemini CLI ve `npx skills` üzerinden kurulum için [AI Agent Skills](docs/guide/ai-agent-skills.md) +Tam liste ile Gemini CLI ve `npx skills` üzerinden kurulum için [AI Agent Skills](../guide/ai-agent-skills.md) sayfasına bakın. ## Önerilenler @@ -153,16 +153,16 @@ sayfasına bakın. ## Katkıda bulunma Katkılarınızı memnuniyetle karşılıyoruz! Davranış kuralları ve pull request gönderme süreci hakkında ayrıntılar için -[katkı kılavuzumuza](CONTRIBUTING.md) bakın. Bir güvenlik açığı bildirmek için [güvenlik politikasını](SECURITY.md) +[katkı kılavuzumuza](../../CONTRIBUTING.md) bakın. Bir güvenlik açığı bildirmek için [güvenlik politikasını](../../SECURITY.md) izleyin. ## Yol haritası -Gelecek sürümlerde neler planladığımızı görmek için [yol haritamıza](ROADMAP.md) göz atın. +Gelecek sürümlerde neler planladığımızı görmek için [yol haritamıza](../../ROADMAP.md) göz atın. ## Değişiklik günlüğü -Değişikliklerin ve güncellemelerin ayrıntılı listesi için [CHANGELOG](CHANGELOG.md) dosyasına bakın. +Değişikliklerin ve güncellemelerin ayrıntılı listesi için [CHANGELOG](../../CHANGELOG.md) dosyasına bakın. ## Destek @@ -172,7 +172,7 @@ yarıyorsa onu [GitHub Sponsors](https://github.com/sponsors/MaksymStoianov) vey ## Lisans -Bu proje [Apache-2.0 lisansı](LICENSE) ile lisanslanmıştır. +Bu proje [Apache-2.0 lisansı](../../LICENSE) ile lisanslanmıştır. --- diff --git a/README.uk.md b/docs/readme/README.uk.md similarity index 76% rename from README.uk.md rename to docs/readme/README.uk.md index ac1a961..d6f316a 100644 --- a/README.uk.md +++ b/docs/readme/README.uk.md @@ -1,6 +1,6 @@ -![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG) +![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)

@@ -8,18 +8,18 @@

-[English](README.md) | **Українська** | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) +[English](../../README.md) | **Українська** | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) -> Цей переклад підготовлено за допомогою ШІ на основі [README.md](README.md) для версії 1.10.0. Основною є англійська -> версія README. Виправлення вітаються — див. [CONTRIBUTING.md](CONTRIBUTING.md). +> Цей переклад підготовлено за допомогою ШІ на основі [README.md](../../README.md) для версії 1.10.0. Основною є англійська +> версія README. Виправлення вітаються — див. [CONTRIBUTING.md](../../CONTRIBUTING.md). # Boot Framework for Google Apps Script™

Built with clasp - License - Security Policy - Roadmap + License + Security Policy + Roadmap Latest release

@@ -108,20 +108,20 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ``` Повний покроковий приклад, зокрема з `doPost` і асинхронним `AsyncApp`, — у -[посібнику Quick Start](docs/guide/quick-start.md) (англійською). +[посібнику Quick Start](../guide/quick-start.md) (англійською). ## Документація Детальні посібники доступні англійською: -- [Quick Start](docs/guide/quick-start.md): налаштування синхронного `App` і асинхронного `AsyncApp`. -- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md): параметри запиту, MIME-типи, +- [Quick Start](../guide/quick-start.md): налаштування синхронного `App` і асинхронного `AsyncApp`. +- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md): параметри запиту, MIME-типи, виклики через `google.script.run` і URL вебзастосунку, обгортання відповідей. -- [Decorators](docs/guide/decorators.md): декоратори класів, методів і параметрів, валідація та вбудовані pipes. -- [Controlling the Response](docs/guide/responses.md): `ResponseEntity` і `@ResponseBody`. -- [Advanced Examples](docs/guide/examples.md): pipes і глобальна обробка помилок. -- [AI Agent Skills](docs/guide/ai-agent-skills.md): повний список навичок і способи встановлення. -- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md): порівняння архітектур. +- [Decorators](../guide/decorators.md): декоратори класів, методів і параметрів, валідація та вбудовані pipes. +- [Controlling the Response](../guide/responses.md): `ResponseEntity` і `@ResponseBody`. +- [Advanced Examples](../guide/examples.md): pipes і глобальна обробка помилок. +- [AI Agent Skills](../guide/ai-agent-skills.md): повний список навичок і способи встановлення. +- [Boot.gs vs Spring Boot vs NestJS](../comparison.md): порівняння архітектур. ## Навички для ШІ-агентів @@ -134,7 +134,7 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { /plugin install bootgs@bootgs-skills ``` -Повний список і встановлення для Gemini CLI та `npx skills` — у розділі [AI Agent Skills](docs/guide/ai-agent-skills.md). +Повний список і встановлення для Gemini CLI та `npx skills` — у розділі [AI Agent Skills](../guide/ai-agent-skills.md). ## Рекомендуємо @@ -149,16 +149,16 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ## Як долучитися -Ми раді внескам! Правила спільноти та порядок подання pull request описано в [настановах для учасників](CONTRIBUTING.md). -Щоб повідомити про вразливість, дотримуйтеся [політики безпеки](SECURITY.md). +Ми раді внескам! Правила спільноти та порядок подання pull request описано в [настановах для учасників](../../CONTRIBUTING.md). +Щоб повідомити про вразливість, дотримуйтеся [політики безпеки](../../SECURITY.md). ## Дорожня карта -Плани на наступні релізи — у [дорожній карті](ROADMAP.md). +Плани на наступні релізи — у [дорожній карті](../../ROADMAP.md). ## Журнал змін -Детальний перелік змін і оновлень — у [CHANGELOG](CHANGELOG.md). +Детальний перелік змін і оновлень — у [CHANGELOG](../../CHANGELOG.md). ## Підтримка @@ -168,7 +168,7 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ## Ліцензія -Проєкт поширюється за [ліцензією Apache-2.0](LICENSE). +Проєкт поширюється за [ліцензією Apache-2.0](../../LICENSE). --- diff --git a/README.vi.md b/docs/readme/README.vi.md similarity index 73% rename from README.vi.md rename to docs/readme/README.vi.md index e49bcb6..a7e6dc4 100644 --- a/README.vi.md +++ b/docs/readme/README.vi.md @@ -1,6 +1,6 @@ -![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG) +![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)

@@ -8,17 +8,17 @@

-[English](README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | **Tiếng Việt** | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) +[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | **Tiếng Việt** | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | [繁體中文](README.zh-TW.md) -> Bản dịch này được chuẩn bị với sự hỗ trợ của AI từ [README.md](README.md) cho phiên bản 1.10.0. README tiếng Anh là phiên bản tham chiếu. Mọi góp ý chỉnh sửa đều được hoan nghênh: xem [CONTRIBUTING.md](CONTRIBUTING.md). +> Bản dịch này được chuẩn bị với sự hỗ trợ của AI từ [README.md](../../README.md) cho phiên bản 1.10.0. README tiếng Anh là phiên bản tham chiếu. Mọi góp ý chỉnh sửa đều được hoan nghênh: xem [CONTRIBUTING.md](../../CONTRIBUTING.md). # Boot Framework for Google Apps Script™

Built with clasp - License - Security Policy - Roadmap + License + Security Policy + Roadmap Latest release

@@ -108,20 +108,20 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ``` Hướng dẫn đầy đủ, bao gồm `doPost` và ứng dụng bất đồng bộ `AsyncApp`, có trong -[hướng dẫn Quick Start](docs/guide/quick-start.md) (bằng tiếng Anh). +[hướng dẫn Quick Start](../guide/quick-start.md) (bằng tiếng Anh). ## Tài liệu Các hướng dẫn chi tiết hiện có bằng tiếng Anh: -- [Quick Start](docs/guide/quick-start.md): thiết lập `App` (đồng bộ) và `AsyncApp` (bất đồng bộ). -- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md): tham số yêu cầu, kiểu MIME, lệnh +- [Quick Start](../guide/quick-start.md): thiết lập `App` (đồng bộ) và `AsyncApp` (bất đồng bộ). +- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md): tham số yêu cầu, kiểu MIME, lệnh gọi qua `google.script.run` và URL của Web App, bao gói phản hồi. -- [Decorators](docs/guide/decorators.md): decorator cho lớp, phương thức và tham số, xác thực và các pipe dựng sẵn. -- [Controlling the Response](docs/guide/responses.md): `ResponseEntity` và `@ResponseBody`. -- [Advanced Examples](docs/guide/examples.md): pipe và xử lý lỗi toàn cục. -- [AI Agent Skills](docs/guide/ai-agent-skills.md): danh sách đầy đủ các skill và các cách cài đặt. -- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md): so sánh kiến trúc. +- [Decorators](../guide/decorators.md): decorator cho lớp, phương thức và tham số, xác thực và các pipe dựng sẵn. +- [Controlling the Response](../guide/responses.md): `ResponseEntity` và `@ResponseBody`. +- [Advanced Examples](../guide/examples.md): pipe và xử lý lỗi toàn cục. +- [AI Agent Skills](../guide/ai-agent-skills.md): danh sách đầy đủ các skill và các cách cài đặt. +- [Boot.gs vs Spring Boot vs NestJS](../comparison.md): so sánh kiến trúc. ## Skill cho tác tử AI @@ -136,7 +136,7 @@ Google Apps Script. ``` Danh sách đầy đủ và cách cài đặt cho Gemini CLI và `npx skills` có tại -[AI Agent Skills](docs/guide/ai-agent-skills.md). +[AI Agent Skills](../guide/ai-agent-skills.md). ## Đề xuất @@ -151,16 +151,16 @@ Danh sách đầy đủ và cách cài đặt cho Gemini CLI và `npx skills` c ## Đóng góp -Chúng tôi luôn hoan nghênh các đóng góp! Vui lòng xem [hướng dẫn đóng góp](CONTRIBUTING.md) để biết về quy tắc ứng xử -và quy trình gửi pull request. Để báo cáo lỗ hổng bảo mật, hãy làm theo [chính sách bảo mật](SECURITY.md). +Chúng tôi luôn hoan nghênh các đóng góp! Vui lòng xem [hướng dẫn đóng góp](../../CONTRIBUTING.md) để biết về quy tắc ứng xử +và quy trình gửi pull request. Để báo cáo lỗ hổng bảo mật, hãy làm theo [chính sách bảo mật](../../SECURITY.md). ## Lộ trình -Xem [lộ trình](ROADMAP.md) để biết những gì đã được lên kế hoạch cho các phiên bản sắp tới. +Xem [lộ trình](../../ROADMAP.md) để biết những gì đã được lên kế hoạch cho các phiên bản sắp tới. ## Nhật ký thay đổi -Danh sách chi tiết các thay đổi và cập nhật có trong [CHANGELOG](CHANGELOG.md). +Danh sách chi tiết các thay đổi và cập nhật có trong [CHANGELOG](../../CHANGELOG.md). ## Hỗ trợ @@ -170,7 +170,7 @@ bạn có thể ủng hộ qua [GitHub Sponsors](https://github.com/sponsors/Mak ## Giấy phép -Dự án này được cấp phép theo [giấy phép Apache-2.0](LICENSE). +Dự án này được cấp phép theo [giấy phép Apache-2.0](../../LICENSE). --- diff --git a/README.zh-TW.md b/docs/readme/README.zh-TW.md similarity index 70% rename from README.zh-TW.md rename to docs/readme/README.zh-TW.md index d0aa415..f1e7936 100644 --- a/README.zh-TW.md +++ b/docs/readme/README.zh-TW.md @@ -1,6 +1,6 @@ -![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG) +![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)

@@ -8,17 +8,17 @@

-[English](README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | **繁體中文** +[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [简体中文](README.zh.md) | **繁體中文** -> 本翻譯以 AI 輔助，依據版本 1.10.0 的 [README.md](README.md) 製作。英文版 README 為參考版本。歡迎提出修正，詳見 [CONTRIBUTING.md](CONTRIBUTING.md)。 +> 本翻譯以 AI 輔助，依據版本 1.10.0 的 [README.md](../../README.md) 製作。英文版 README 為參考版本。歡迎提出修正，詳見 [CONTRIBUTING.md](../../CONTRIBUTING.md)。 # Boot Framework for Google Apps Script™

Built with clasp - License - Security Policy - Roadmap + License + Security Policy + Roadmap Latest release

@@ -100,19 +100,19 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { } ``` -包含 `doPost` 與非同步 `AsyncApp` 的完整說明，請參閱 [Quick Start 指南](docs/guide/quick-start.md)（英文）。 +包含 `doPost` 與非同步 `AsyncApp` 的完整說明，請參閱 [Quick Start 指南](../guide/quick-start.md)（英文）。 ## 文件 詳細指南僅提供英文版： -- [Quick Start](docs/guide/quick-start.md)：同步 `App` 與非同步 `AsyncApp` 的設定。 -- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md)：請求參數、MIME 類型、透過 `google.script.run` 與 Web 應用程式 URL 呼叫、回應包裝。 -- [Decorators](docs/guide/decorators.md)：類別、方法與參數裝飾器、驗證及內建 pipes。 -- [Controlling the Response](docs/guide/responses.md)：`ResponseEntity` 與 `@ResponseBody`。 -- [Advanced Examples](docs/guide/examples.md)：pipes 與全域錯誤處理。 -- [AI Agent Skills](docs/guide/ai-agent-skills.md)：完整的技能清單與安裝方式。 -- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md)：架構比較。 +- [Quick Start](../guide/quick-start.md)：同步 `App` 與非同步 `AsyncApp` 的設定。 +- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md)：請求參數、MIME 類型、透過 `google.script.run` 與 Web 應用程式 URL 呼叫、回應包裝。 +- [Decorators](../guide/decorators.md)：類別、方法與參數裝飾器、驗證及內建 pipes。 +- [Controlling the Response](../guide/responses.md)：`ResponseEntity` 與 `@ResponseBody`。 +- [Advanced Examples](../guide/examples.md)：pipes 與全域錯誤處理。 +- [AI Agent Skills](../guide/ai-agent-skills.md)：完整的技能清單與安裝方式。 +- [Boot.gs vs Spring Boot vs NestJS](../comparison.md)：架構比較。 ## AI 代理技能 @@ -123,7 +123,7 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { /plugin install bootgs@bootgs-skills ``` -完整清單以及透過 Gemini CLI 與 `npx skills` 安裝的方式，請參閱 [AI Agent Skills](docs/guide/ai-agent-skills.md)。 +完整清單以及透過 Gemini CLI 與 `npx skills` 安裝的方式，請參閱 [AI Agent Skills](../guide/ai-agent-skills.md)。 ## 推薦 @@ -137,15 +137,15 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ## 參與貢獻 -歡迎各種貢獻！關於行為準則與提交 pull request 的流程，請參閱[貢獻指南](CONTRIBUTING.md)。如需回報安全漏洞，請依照[安全政策](SECURITY.md)辦理。 +歡迎各種貢獻！關於行為準則與提交 pull request 的流程，請參閱[貢獻指南](../../CONTRIBUTING.md)。如需回報安全漏洞，請依照[安全政策](../../SECURITY.md)辦理。 ## 路線圖 -請查看[路線圖](ROADMAP.md)，了解未來版本的規劃。 +請查看[路線圖](../../ROADMAP.md)，了解未來版本的規劃。 ## 變更紀錄 -詳細的變更與更新清單，請參閱 [CHANGELOG](CHANGELOG.md)。 +詳細的變更與更新清單，請參閱 [CHANGELOG](../../CHANGELOG.md)。 ## 支持 @@ -153,7 +153,7 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ## 授權條款 -本專案採用 [Apache-2.0 授權條款](LICENSE)。 +本專案採用 [Apache-2.0 授權條款](../../LICENSE)。 --- diff --git a/README.zh.md b/docs/readme/README.zh.md similarity index 70% rename from README.zh.md rename to docs/readme/README.zh.md index b8d09ff..4b58c3e 100644 --- a/README.zh.md +++ b/docs/readme/README.zh.md @@ -1,6 +1,6 @@ -![Project banner for Google Apps Script Boot Framework](docs/assets/images/banner-1280x640.JPG) +![Project banner for Google Apps Script Boot Framework](../assets/images/banner-1280x640.JPG)

@@ -8,17 +8,17 @@

-[English](README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | **简体中文** | [繁體中文](README.zh-TW.md) +[English](../../README.md) | [Українська](README.uk.md) | [Русский](README.ru.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [Português](README.pt.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Čeština](README.cs.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [Bahasa Indonesia](README.id.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | **简体中文** | [繁體中文](README.zh-TW.md) -> 本译文在 AI 辅助下根据 1.10.0 版本的 [README.md](README.md) 翻译而成，内容以英文版 README 为准。欢迎提出修改建议，详见 [CONTRIBUTING.md](CONTRIBUTING.md)。 +> 本译文在 AI 辅助下根据 1.10.0 版本的 [README.md](../../README.md) 翻译而成，内容以英文版 README 为准。欢迎提出修改建议，详见 [CONTRIBUTING.md](../../CONTRIBUTING.md)。 # Boot Framework for Google Apps Script™

Built with clasp - License - Security Policy - Roadmap + License + Security Policy + Roadmap Latest release

@@ -100,19 +100,19 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { } ``` -包含 `doPost` 和异步 `AsyncApp` 的完整步骤，请参阅 [Quick Start 指南](docs/guide/quick-start.md)（英文）。 +包含 `doPost` 和异步 `AsyncApp` 的完整步骤，请参阅 [Quick Start 指南](../guide/quick-start.md)（英文）。 ## 文档 详细指南目前提供英文版： -- [Quick Start](docs/guide/quick-start.md)：同步 `App` 与异步 `AsyncApp` 的配置。 -- [Calling the API (Virtual Transport Layer)](docs/guide/virtual-transport-layer.md)：请求参数、MIME 类型、通过 `google.script.run` 和 Web 应用 URL 调用、响应包装。 -- [Decorators](docs/guide/decorators.md)：类、方法和参数装饰器，校验与内置 pipes。 -- [Controlling the Response](docs/guide/responses.md)：`ResponseEntity` 与 `@ResponseBody`。 -- [Advanced Examples](docs/guide/examples.md)：pipes 与全局错误处理。 -- [AI Agent Skills](docs/guide/ai-agent-skills.md)：完整的技能列表与安装方式。 -- [Boot.gs vs Spring Boot vs NestJS](docs/comparison.md)：架构对比。 +- [Quick Start](../guide/quick-start.md)：同步 `App` 与异步 `AsyncApp` 的配置。 +- [Calling the API (Virtual Transport Layer)](../guide/virtual-transport-layer.md)：请求参数、MIME 类型、通过 `google.script.run` 和 Web 应用 URL 调用、响应包装。 +- [Decorators](../guide/decorators.md)：类、方法和参数装饰器，校验与内置 pipes。 +- [Controlling the Response](../guide/responses.md)：`ResponseEntity` 与 `@ResponseBody`。 +- [Advanced Examples](../guide/examples.md)：pipes 与全局错误处理。 +- [AI Agent Skills](../guide/ai-agent-skills.md)：完整的技能列表与安装方式。 +- [Boot.gs vs Spring Boot vs NestJS](../comparison.md)：架构对比。 ## AI 智能体技能 @@ -123,7 +123,7 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { /plugin install bootgs@bootgs-skills ``` -完整列表以及 Gemini CLI 和 `npx skills` 的安装方式，请参阅 [AI Agent Skills](docs/guide/ai-agent-skills.md)。 +完整列表以及 Gemini CLI 和 `npx skills` 的安装方式，请参阅 [AI Agent Skills](../guide/ai-agent-skills.md)。 ## 推荐 @@ -137,15 +137,15 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ## 参与贡献 -欢迎贡献！行为准则和提交 pull request 的流程请参阅 [贡献指南](CONTRIBUTING.md)。如需报告安全漏洞，请遵循 [安全策略](SECURITY.md)。 +欢迎贡献！行为准则和提交 pull request 的流程请参阅 [贡献指南](../../CONTRIBUTING.md)。如需报告安全漏洞，请遵循 [安全策略](../../SECURITY.md)。 ## 路线图 -查看 [路线图](ROADMAP.md)，了解后续版本的计划。 +查看 [路线图](../../ROADMAP.md)，了解后续版本的计划。 ## 更新日志 -详细的变更与更新列表请参阅 [CHANGELOG](CHANGELOG.md)。 +详细的变更与更新列表请参阅 [CHANGELOG](../../CHANGELOG.md)。 ## 支持 @@ -153,7 +153,7 @@ export function doGet(event: GoogleAppsScript.Events.DoGet) { ## 许可证 -本项目基于 [Apache-2.0 许可证](LICENSE) 发布。 +本项目基于 [Apache-2.0 许可证](../../LICENSE) 发布。 --- diff --git a/scripts/check-readme-translations.mjs b/scripts/check-readme-translations.mjs index 68505b3..a67111d 100644 --- a/scripts/check-readme-translations.mjs +++ b/scripts/check-readme-translations.mjs @@ -2,11 +2,17 @@ /** * Checks that README translations stay in sync with README.md. * - * For every language in LANGUAGES it verifies that README..md exists, - * contains the exact language switcher line, has the same number of `##` and - * `###` headings as README.md, and that its translation note names the + * For every language in LANGUAGES it verifies that docs/readme/README..md + * exists, contains the exact language switcher line, has the same number of + * `##` and `###` headings as README.md, and that its translation note names the * current package.json version. README.md itself must carry the switcher too. * + * README.md (English) stays in the repository root and links the translations + * as `docs/readme/README..md`. Inside docs/readme/ a translation links the + * other translations as `README..md` and English as `../../README.md`. + * Every relative link in a README must resolve to an existing file, so a + * repository-root path not rewritten for docs/readme/ is caught. + * * A right-to-left translation wraps its prose in `
` blocks. * Those wrapper lines are skipped when looking for the note, and the headings * inside them still count, since they stay `##`/`###` lines of their own. @@ -14,11 +20,16 @@ * Usage: npm run docs:check-i18n */ import { existsSync, readFileSync } from "node:fs"; -import { dirname, join } from "node:path"; +import { dirname, join, resolve } from "node:path"; import { fileURLToPath } from "node:url"; const ROOT = join(dirname(fileURLToPath(import.meta.url)), ".."); +/** + * Folder of the translations, relative to the repository root. + */ +const TRANSLATIONS_DIR = "docs/readme"; + /** * Languages in switcher order. `code: null` is the English source README.md. */ @@ -45,13 +56,26 @@ const LANGUAGES = [ ]; /** - * Returns the README file name for a language code. + * Returns the README path for a language code, relative to the repository root. * * @param {string | null} code Language code, or null for English. - * @returns {string} File name relative to the repository root. + * @returns {string} `README.md` or `docs/readme/README..md`. */ function fileName(code) { - return code ? `README.${code}.md` : "README.md"; + return code ? `${TRANSLATIONS_DIR}/README.${code}.md` : "README.md"; +} + +/** + * Returns the link to a language's README as written in the README of `from`. + * + * @param {string | null} code Language code of the link target, or null for English. + * @param {string | null} from Language code of the file holding the link. + * @returns {string} Relative link. + */ +function linkTo(code, from) { + if (from === null) return fileName(code); + + return code ? `README.${code}.md` : "../../README.md"; } /** @@ -62,10 +86,50 @@ function fileName(code) { */ function switcherLine(current) { return LANGUAGES.map(({ code, label }) => - code === current ? `**${label}**` : `[${label}](${fileName(code)})` + code === current ? `**${label}**` : `[${label}](${linkTo(code, current)})` ).join(" | "); } +/** + * Lists relative link targets that do not exist, outside fenced code blocks. + * + * Markdown links and `href`/`src`/`srcset` attributes are checked; absolute + * URLs, `mailto:` links and same-file `#anchors` are skipped. + * + * @param {string[]} lines File lines. + * @param {string} dir Absolute folder of the file. + * @returns {string[]} Missing link targets as written in the file. + */ +function missingLinks(lines, dir) { + const missing = []; + let fence = false; + + for (const line of lines) { + if (/^\s*(```|~~~)/.test(line)) { + fence = !fence; + continue; + } + if (fence) continue; + + const targets = [ + ...[...line.matchAll(/\]\(([^)\s]+)/g)].map((match) => match[1]), + ...[...line.matchAll(/\b(?:href|src)="([^"]+)"/g)].map((match) => match[1]), + ...[...line.matchAll(/\bsrcset="([^"]+)"/g)].flatMap((match) => + match[1].split(",").map((entry) => entry.trim().split(/\s+/)[0]) + ) + ]; + + for (const target of targets) { + if (/^(?:[a-z][a-z\d+.-]*:|\/\/|#)/i.test(target)) continue; + + const path = decodeURIComponent(target.split("#")[0]); + + if (!existsSync(resolve(dir, path))) missing.push(target); + } + } + return missing; +} + /** * Tells whether a line only opens or closes a right-to-left wrapper block. * @@ -111,6 +175,10 @@ if (!sourceLines.includes(switcherLine(null))) { errors.push("README.md: language switcher line is missing or differs"); } +for (const target of missingLinks(sourceLines, ROOT)) { + errors.push(`README.md: link target ${target} does not exist`); +} + for (const { code } of LANGUAGES.filter((language) => language.code)) { const name = fileName(code); const path = join(ROOT, name); @@ -122,6 +190,10 @@ for (const { code } of LANGUAGES.filter((language) => language.code)) { const lines = readFileSync(path, "utf8").split(/\r?\n/); + for (const target of missingLinks(lines, dirname(path))) { + errors.push(`${name}: link target ${target} does not exist`); + } + const switcherIndex = lines.indexOf(switcherLine(code)); if (switcherIndex === -1) {