From 369ae2862f13eca253a35ff09452b0a32a1a30f5 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Mon, 30 Mar 2026 18:40:35 +0200 Subject: [PATCH] i18n - docs translations (#19135) Created by Github action Co-authored-by: github-actions --- .../l/ar/developers/extend/apps/building.mdx | 22 ++++++------- .../extend/apps/getting-started.mdx | 31 ++++++------------- .../ar/developers/extend/apps/publishing.mdx | 4 +++ .../developers/extend/capabilities/apps.mdx | 2 +- .../l/cs/developers/extend/apps/building.mdx | 22 ++++++------- .../extend/apps/getting-started.mdx | 31 ++++++------------- .../cs/developers/extend/apps/publishing.mdx | 8 +++-- .../developers/extend/capabilities/apps.mdx | 2 +- .../l/de/developers/extend/apps/building.mdx | 22 ++++++------- .../extend/apps/getting-started.mdx | 31 ++++++------------- .../de/developers/extend/apps/publishing.mdx | 4 +++ .../developers/extend/capabilities/apps.mdx | 2 +- .../l/it/developers/extend/apps/building.mdx | 22 ++++++------- .../extend/apps/getting-started.mdx | 31 ++++++------------- .../it/developers/extend/apps/publishing.mdx | 4 +++ .../developers/extend/capabilities/apps.mdx | 2 +- .../l/ro/developers/extend/apps/building.mdx | 22 ++++++------- .../extend/apps/getting-started.mdx | 31 ++++++------------- .../ro/developers/extend/apps/publishing.mdx | 4 +++ .../developers/extend/capabilities/apps.mdx | 2 +- .../l/ru/developers/extend/apps/building.mdx | 22 ++++++------- .../extend/apps/getting-started.mdx | 31 ++++++------------- .../ru/developers/extend/apps/publishing.mdx | 8 +++-- .../developers/extend/capabilities/apps.mdx | 2 +- .../l/tr/developers/extend/apps/building.mdx | 22 ++++++------- .../extend/apps/getting-started.mdx | 31 ++++++------------- .../tr/developers/extend/apps/publishing.mdx | 4 +++ .../developers/extend/capabilities/apps.mdx | 2 +- .../l/zh/developers/extend/apps/building.mdx | 22 ++++++------- .../extend/apps/getting-started.mdx | 31 ++++++------------- .../zh/developers/extend/apps/publishing.mdx | 4 +++ .../developers/extend/capabilities/apps.mdx | 2 +- 32 files changed, 212 insertions(+), 268 deletions(-) diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/building.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/building.mdx index 1a39f4fe14..cd2b078ea9 100644 --- a/packages/twenty-docs/l/ar/developers/extend/apps/building.mdx +++ b/packages/twenty-docs/l/ar/developers/extend/apps/building.mdx @@ -358,17 +358,17 @@ export default defineApplication({ إذا كنت تخطط لـ [نشر تطبيقك](/l/ar/developers/extend/apps/publishing)، فإن هذه الحقول الاختيارية تتحكّم في كيفية ظهور تطبيقك في السوق: -| الحقل | الوصف | -| ------------------ | ---------------------------------------------------- | -| `author` | اسم المؤلف أو الشركة | -| `category` | فئة التطبيق لتصفية سوق التطبيقات | -| `logoUrl` | المسار إلى شعار تطبيقك (نسبيًا إلى `./assets/`) | -| `screenshots` | مصفوفة لمسارات لقطات الشاشة (نسبيًا إلى `./assets/`) | -| `aboutDescription` | وصف ماركداون أطول لعلامة التبويب "حول" | -| `websiteUrl` | رابط إلى موقعك الإلكتروني | -| `termsUrl` | رابط إلى شروط الخدمة | -| `emailSupport` | عنوان البريد الإلكتروني للدعم | -| `issueReportUrl` | رابط إلى متتبّع المشاكل | +| الحقل | الوصف | +| ------------------ | ------------------------------------------------------------------------------------------------------------ | +| `author` | اسم المؤلف أو الشركة | +| `category` | فئة التطبيق لتصفية سوق التطبيقات | +| `logoUrl` | المسار إلى شعار تطبيقك (نسبيًا إلى `./assets/`) | +| `screenshots` | مصفوفة لمسارات لقطات الشاشة (نسبيًا إلى `./assets/`) | +| `aboutDescription` | وصف ماركداون أطول لعلامة التبويب "حول". إذا لم يتم تضمينه، يستخدم السوق ملف `README.md` الخاص بالحزمة من npm | +| `websiteUrl` | رابط إلى موقعك الإلكتروني | +| `termsUrl` | رابط إلى شروط الخدمة | +| `emailSupport` | عنوان البريد الإلكتروني للدعم | +| `issueReportUrl` | رابط إلى متتبّع المشاكل | #### الأدوار والصلاحيات diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/getting-started.mdx index d20e576458..e132e6defa 100644 --- a/packages/twenty-docs/l/ar/developers/extend/apps/getting-started.mdx +++ b/packages/twenty-docs/l/ar/developers/extend/apps/getting-started.mdx @@ -9,18 +9,19 @@ description: أنشئ أول تطبيق Twenty خلال دقائق. تتيح لك التطبيقات توسيع Twenty باستخدام كائنات وحقول ووظائف منطقية ومهارات ذكاء اصطناعي ومكونات واجهة مستخدم مخصصة — جميعها تُدار ككود. -**ما الذي يمكنك فعله اليوم:** +**What you can build:** -* عرِّف كائنات وحقولًا مخصصة على شكل كود (نموذج بيانات مُدار) -* أنشئ وظائف منطقية مع مشغلات مخصصة (مسارات HTTP، cron، أحداث قاعدة البيانات) -* حدد المهارات لوكلاء الذكاء الاصطناعي -* أنشئ مكونات واجهية تُعرَض داخل واجهة مستخدم Twenty -* انشر التطبيق نفسه عبر مساحات عمل متعددة +* Custom objects, fields, views, and navigation items to shape your data model +* Logic functions triggered by HTTP routes, cron schedules, or database events +* Front components that render directly inside Twenty's UI +* Skills that extend Twenty's AI agents +* Deploy an app across multiple workspaces ## المتطلبات الأساسية -* Node.js 24+ وYarn 4 -* Docker (لخادم تطوير Twenty المحلي) +* Node.js 24+ +* Yarn 4 +* Docker (or a running local Twenty instance) ## البدء @@ -29,21 +30,9 @@ description: أنشئ أول تطبيق Twenty خلال دقائق. ```bash filename="Terminal" # Scaffold a new app (includes all examples by default) npx create-twenty-app@latest my-twenty-app -cd my-twenty-app - -# Start dev mode: automatically syncs local changes to your workspace -yarn twenty dev ``` -يدعم المُهيئ وضعين للتحكم في ملفات الأمثلة التي سيتم تضمينها: - -```bash filename="Terminal" -# Default (exhaustive): all examples (object, field, logic function, front component, view, navigation menu item, skill, agent) -npx create-twenty-app@latest my-app - -# Minimal: only core files (application-config.ts and default-role.ts) -npx create-twenty-app@latest my-app --minimal -``` +> Use `--minimal` option to scaffold a minimal installation من هنا يمكنك: diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/publishing.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/publishing.mdx index aac2aa8cab..e57357210a 100644 --- a/packages/twenty-docs/l/ar/developers/extend/apps/publishing.mdx +++ b/packages/twenty-docs/l/ar/developers/extend/apps/publishing.mdx @@ -102,6 +102,10 @@ yarn twenty catalog-sync -r production تأتي بيانات التعريف المعروضة في السوق من استدعائك لـ `defineApplication()` في الشيفرة المصدرية لتطبيقك — حقول مثل `displayName` و`description` و`author` و`category` و`logoUrl` و`screenshots` و`aboutDescription` و`websiteUrl` و`termsUrl`. + +إذا لم يحدد تطبيقك `aboutDescription` في `defineApplication()`، فسيستخدم السوق تلقائيًا ملف `README.md` الخاص بحزمتك من npm كمحتوى لصفحة حول. هذا يعني أنه يمكنك الاحتفاظ بملف README واحد لكل من npm وسوق Twenty. إذا كنت تريد وصفًا مختلفًا في السوق، فقم بتعيين `aboutDescription` بشكل صريح. + + ### النشر عبر CI يتضمن المشروع المُولَّد سير عمل GitHub Actions يقوم بالنشر عند كل إصدار: diff --git a/packages/twenty-docs/l/ar/developers/extend/capabilities/apps.mdx b/packages/twenty-docs/l/ar/developers/extend/capabilities/apps.mdx index 2fb9d9d726..06b3fea41c 100644 --- a/packages/twenty-docs/l/ar/developers/extend/capabilities/apps.mdx +++ b/packages/twenty-docs/l/ar/developers/extend/capabilities/apps.mdx @@ -38,7 +38,7 @@ yarn twenty dev ### إدارة الخادم المحلي -يتضمن SDK أوامر لإدارة خادم تطوير Twenty محلي (صورة Docker متكاملة تتضمن PostgreSQL وRedis والخادم والعامل): +The SDK includes commands to manage a local Twenty dev server (all-in-one Docker image with PostgreSQL, Redis, server, and worker on port 2020). These commands only apply to the Docker-based dev server — they do not manage a Twenty instance started from source (e.g. `npx nx start twenty-server` on port 3000): ```bash filename="Terminal" # ابدأ الخادم المحلي (يسحب الصورة إذا لزم الأمر) diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/building.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/building.mdx index 154aecf0e3..a54e74d088 100644 --- a/packages/twenty-docs/l/cs/developers/extend/apps/building.mdx +++ b/packages/twenty-docs/l/cs/developers/extend/apps/building.mdx @@ -358,17 +358,17 @@ Poznámky: Pokud plánujete [zveřejnit svou aplikaci](/l/cs/developers/extend/apps/publishing), tato volitelná pole určují, jak se vaše aplikace zobrazuje na Marketplace: -| Pole | Popis | -| ------------------ | -------------------------------------------------------- | -| `author` | Jméno autora nebo název společnosti | -| `category` | Kategorie aplikace pro filtrování na Marketplace | -| `logoUrl` | Cesta k logu vaší aplikace (relativně k `./assets/`) | -| `screenshots` | Pole cest ke snímkům obrazovky (relativně k `./assets/`) | -| `aboutDescription` | Delší popis v Markdownu pro kartu "O aplikaci" | -| `websiteUrl` | Odkaz na váš web | -| `termsUrl` | Odkaz na Podmínky služby | -| `emailSupport` | E-mailová adresa podpory | -| `issueReportUrl` | Odkaz na nástroj pro sledování problémů | +| Pole | Popis | +| ------------------ | ------------------------------------------------------------------------------------------------------------- | +| `author` | Jméno autora nebo název společnosti | +| `category` | Kategorie aplikace pro filtrování na Marketplace | +| `logoUrl` | Cesta k logu vaší aplikace (relativně k `./assets/`) | +| `screenshots` | Pole cest ke snímkům obrazovky (relativně k `./assets/`) | +| `aboutDescription` | Delší popis v Markdownu pro kartu "O aplikaci". Pokud je vynecháno, tržiště použije `README.md` balíčku z npm | +| `websiteUrl` | Odkaz na váš web | +| `termsUrl` | Odkaz na Podmínky služby | +| `emailSupport` | E-mailová adresa podpory | +| `issueReportUrl` | Odkaz na nástroj pro sledování problémů | #### Role a oprávnění diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/getting-started.mdx index 5931e2b147..04bc040fac 100644 --- a/packages/twenty-docs/l/cs/developers/extend/apps/getting-started.mdx +++ b/packages/twenty-docs/l/cs/developers/extend/apps/getting-started.mdx @@ -9,18 +9,19 @@ Aplikace jsou aktuálně v alfa testování. Tato funkce je funkční, ale stál Aplikace vám umožňují rozšířit Twenty o vlastní objekty, pole, logické funkce, AI schopnosti a komponenty uživatelského rozhraní — vše je spravováno jako kód. -**Co můžete dělat už dnes:** +**What you can build:** -* Definujte vlastní objekty a pole jako kód (spravovaný datový model) -* Vytvářejte logické funkce s vlastními spouštěči (HTTP routy, cron, databázové události) -* Definujte dovednosti agentů AI -* Vytvářejte frontendové komponenty, které se vykreslují uvnitř uživatelského rozhraní Twenty -* Nasazujte stejnou aplikaci do více pracovních prostorů +* Custom objects, fields, views, and navigation items to shape your data model +* Logic functions triggered by HTTP routes, cron schedules, or database events +* Front components that render directly inside Twenty's UI +* Skills that extend Twenty's AI agents +* Deploy an app across multiple workspaces ## Předpoklady -* Node.js 24+ a Yarn 4 -* Docker (pro místní vývojový server Twenty) +* Node.js 24+ +* Yarn 4 +* Docker (or a running local Twenty instance) ## Začínáme @@ -29,21 +30,9 @@ Vytvořte novou aplikaci pomocí oficiálního scaffolderu, poté se ověřte a ```bash filename="Terminal" # Scaffold a new app (includes all examples by default) npx create-twenty-app@latest my-twenty-app -cd my-twenty-app - -# Start dev mode: automatically syncs local changes to your workspace -yarn twenty dev ``` -Nástroj pro generování kostry podporuje dva režimy pro řízení toho, které ukázkové soubory jsou zahrnuty: - -```bash filename="Terminal" -# Default (exhaustive): all examples (object, field, logic function, front component, view, navigation menu item, skill, agent) -npx create-twenty-app@latest my-app - -# Minimal: only core files (application-config.ts and default-role.ts) -npx create-twenty-app@latest my-app --minimal -``` +> Use `--minimal` option to scaffold a minimal installation Odtud můžete: diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/publishing.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/publishing.mdx index 95abcb4e72..2977f9eade 100644 --- a/packages/twenty-docs/l/cs/developers/extend/apps/publishing.mdx +++ b/packages/twenty-docs/l/cs/developers/extend/apps/publishing.mdx @@ -102,6 +102,10 @@ yarn twenty catalog-sync -r production Metadata zobrazená v tržišti pocházejí z volání `defineApplication()` ve zdrojovém kódu vaší aplikace — z polí jako `displayName`, `description`, `author`, `category`, `logoUrl`, `screenshots`, `aboutDescription`, `websiteUrl` a `termsUrl`. + +Pokud vaše aplikace nedefinuje `aboutDescription` v `defineApplication()`, tržiště automaticky použije soubor `README.md` vašeho balíčku z npm jako obsah stránky O aplikaci. To znamená, že můžete spravovat jediný soubor README jak pro npm, tak pro tržiště Twenty. Pokud chcete v tržišti jiný popis, explicitně nastavte `aboutDescription`. + + ### Publikování pomocí CI Vygenerovaný projekt obsahuje pracovní postup GitHub Actions, který publikuje při každém vydání: @@ -238,8 +242,8 @@ Začněte v režimu **Development** při sestavování své aplikace. Až bude p | --------------------------- | ----------------------------------------------------- | --------------------------------------------------- | | `yarn twenty build` | Sestaví aplikaci a vygeneruje manifest | `--tarball` — také vytvoří balíček `.tgz` | | `yarn twenty publish` | Sestaví a publikuje na npm | `--tag ` — npm dist-tag (např. `beta`, `next`) | -| `yarn twenty deploy` | Sestaví a nahraje tarball na server | `-r, --remote ` — cílový vzdálený server | -| `yarn twenty catalog-sync` | Spustí synchronizaci katalogu tržiště na serveru | `-r, --remote ` — cílový vzdálený server | +| `yarn twenty deploy` | Sestaví a nahraje tarball na server | `-r, --remote ` — cílový vzdálený repozitář | +| `yarn twenty catalog-sync` | Spustí synchronizaci katalogu tržiště na serveru | `-r, --remote ` — cílový vzdálený repozitář | | `yarn twenty install` | Nainstaluje nasazenou aplikaci do pracovního prostoru | `-r, --remote ` — cílový vzdálený server | | `yarn twenty dev` | Sleduje a synchronizuje lokální změny | Používá výchozí vzdálený server | | `yarn twenty remote add` | Přidá připojení k serveru | `--url`, `--token`, `--as`, `--local`, `--port` | diff --git a/packages/twenty-docs/l/cs/developers/extend/capabilities/apps.mdx b/packages/twenty-docs/l/cs/developers/extend/capabilities/apps.mdx index 10c8704bb2..43a204ad97 100644 --- a/packages/twenty-docs/l/cs/developers/extend/capabilities/apps.mdx +++ b/packages/twenty-docs/l/cs/developers/extend/capabilities/apps.mdx @@ -38,7 +38,7 @@ yarn twenty dev ### Správa místního serveru -SDK obsahuje příkazy ke správě místního vývojového serveru Twenty (all-in-one obraz Dockeru s PostgreSQL, Redisem, serverem a workerem): +The SDK includes commands to manage a local Twenty dev server (all-in-one Docker image with PostgreSQL, Redis, server, and worker on port 2020). These commands only apply to the Docker-based dev server — they do not manage a Twenty instance started from source (e.g. `npx nx start twenty-server` on port 3000): ```bash filename="Terminal" # Spusťte místní server (v případě potřeby stáhne obraz) diff --git a/packages/twenty-docs/l/de/developers/extend/apps/building.mdx b/packages/twenty-docs/l/de/developers/extend/apps/building.mdx index 0a491b5ee2..3e75f03a6c 100644 --- a/packages/twenty-docs/l/de/developers/extend/apps/building.mdx +++ b/packages/twenty-docs/l/de/developers/extend/apps/building.mdx @@ -358,17 +358,17 @@ Notizen: Wenn Sie planen, [Ihre App zu veröffentlichen](/l/de/developers/extend/apps/publishing), steuern diese optionalen Felder, wie Ihre App im Marktplatz erscheint: -| Feld | Beschreibung | -| ------------------ | ---------------------------------------------------- | -| `author` | Name des Autors oder des Unternehmens | -| `category` | App-Kategorie für die Filterung im Marktplatz | -| `logoUrl` | Pfad zu Ihrem App-Logo (relativ zu `./assets/`) | -| `screenshots` | Array von Screenshot-Pfaden (relativ zu `./assets/`) | -| `aboutDescription` | Längere Markdown-Beschreibung für den Tab "Info" | -| `websiteUrl` | Link zu Ihrer Website | -| `termsUrl` | Link zu den Nutzungsbedingungen | -| `emailSupport` | Support-E-Mail-Adresse | -| `issueReportUrl` | Link zum Issue-Tracker | +| Feld | Beschreibung | +| ------------------ | -------------------------------------------------------------------------------------------------------------------------------- | +| `author` | Name des Autors oder des Unternehmens | +| `category` | App-Kategorie für die Filterung im Marktplatz | +| `logoUrl` | Pfad zu Ihrem App-Logo (relativ zu `./assets/`) | +| `screenshots` | Array von Screenshot-Pfaden (relativ zu `./assets/`) | +| `aboutDescription` | Längere Markdown-Beschreibung für den Tab "Info". Wenn weggelassen, verwendet der Marketplace die `README.md` des Pakets von npm | +| `websiteUrl` | Link zu Ihrer Website | +| `termsUrl` | Link zu den Nutzungsbedingungen | +| `emailSupport` | Support-E-Mail-Adresse | +| `issueReportUrl` | Link zum Issue-Tracker | #### Rollen und Berechtigungen diff --git a/packages/twenty-docs/l/de/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/de/developers/extend/apps/getting-started.mdx index b7c59afab9..cdb2f89bba 100644 --- a/packages/twenty-docs/l/de/developers/extend/apps/getting-started.mdx +++ b/packages/twenty-docs/l/de/developers/extend/apps/getting-started.mdx @@ -9,18 +9,19 @@ Apps befinden sich derzeit in der Alpha-Testphase. Die Funktion ist funktionsfä Apps ermöglichen es Ihnen, Twenty mit benutzerdefinierten Objekten, Feldern, Logikfunktionen, KI-Fähigkeiten und UI-Komponenten zu erweitern — alles als Code verwaltet. -**Was Sie heute tun können:** +**What you can build:** -* Benutzerdefinierte Objekte und Felder als Code definieren (verwaltetes Datenmodell) -* Erstellen Sie Logikfunktionen mit benutzerdefinierten Triggern (HTTP-Routen, cron, Datenbankereignisse) -* Fähigkeiten für KI-Agenten definieren -* Erstellen Sie Frontend-Komponenten, die in der Twenty-UI gerendert werden -* Dieselbe App in mehreren Workspaces bereitstellen +* Custom objects, fields, views, and navigation items to shape your data model +* Logic functions triggered by HTTP routes, cron schedules, or database events +* Front components that render directly inside Twenty's UI +* Skills that extend Twenty's AI agents +* Deploy an app across multiple workspaces ## Voraussetzungen -* Node.js 24+ und Yarn 4 -* Docker (für den lokalen Twenty-Dev-Server) +* Node.js 24+ +* Yarn 4 +* Docker (or a running local Twenty instance) ## Erste Schritte @@ -29,21 +30,9 @@ Erstellen Sie mit dem offiziellen Scaffolder eine neue App, authentifizieren Sie ```bash filename="Terminal" # Scaffold a new app (includes all examples by default) npx create-twenty-app@latest my-twenty-app -cd my-twenty-app - -# Start dev mode: automatically syncs local changes to your workspace -yarn twenty dev ``` -Das Scaffolding-Tool unterstützt zwei Modi, um zu steuern, welche Beispieldateien enthalten sind: - -```bash filename="Terminal" -# Default (exhaustive): all examples (object, field, logic function, front component, view, navigation menu item, skill, agent) -npx create-twenty-app@latest my-app - -# Minimal: only core files (application-config.ts and default-role.ts) -npx create-twenty-app@latest my-app --minimal -``` +> Use `--minimal` option to scaffold a minimal installation Von hier aus können Sie: diff --git a/packages/twenty-docs/l/de/developers/extend/apps/publishing.mdx b/packages/twenty-docs/l/de/developers/extend/apps/publishing.mdx index 42f88d117d..a1d586ffa1 100644 --- a/packages/twenty-docs/l/de/developers/extend/apps/publishing.mdx +++ b/packages/twenty-docs/l/de/developers/extend/apps/publishing.mdx @@ -102,6 +102,10 @@ yarn twenty catalog-sync -r production Die im Marktplatz angezeigten Metadaten stammen aus Ihrem `defineApplication()`-Aufruf im Quellcode Ihrer App — Felder wie `displayName`, `description`, `author`, `category`, `logoUrl`, `screenshots`, `aboutDescription`, `websiteUrl` und `termsUrl`. + +Wenn deine App keine `aboutDescription` in `defineApplication()` definiert, verwendet der Marktplatz automatisch die `README.md` deines Pakets von npm als Inhalt der Über-uns-Seite. Das bedeutet, dass du eine einzige README sowohl für npm als auch für den Twenty-Marktplatz pflegen kannst. Wenn du im Marktplatz eine andere Beschreibung möchtest, setze `aboutDescription` explizit. + + ### CI-Veröffentlichung Das vorgefertigte Projekt enthält einen GitHub-Actions-Workflow, der bei jedem Release eine Veröffentlichung durchführt: diff --git a/packages/twenty-docs/l/de/developers/extend/capabilities/apps.mdx b/packages/twenty-docs/l/de/developers/extend/capabilities/apps.mdx index 797de37bdc..27f06eff0d 100644 --- a/packages/twenty-docs/l/de/developers/extend/capabilities/apps.mdx +++ b/packages/twenty-docs/l/de/developers/extend/capabilities/apps.mdx @@ -38,7 +38,7 @@ yarn twenty dev ### Lokale Serververwaltung -Das SDK enthält Befehle zur Verwaltung eines lokalen Twenty-Dev-Servers (All-in-One-Docker-Image mit PostgreSQL, Redis, Server und Worker): +The SDK includes commands to manage a local Twenty dev server (all-in-one Docker image with PostgreSQL, Redis, server, and worker on port 2020). These commands only apply to the Docker-based dev server — they do not manage a Twenty instance started from source (e.g. `npx nx start twenty-server` on port 3000): ```bash filename="Terminal" # Den lokalen Server starten (lädt das Image bei Bedarf herunter) diff --git a/packages/twenty-docs/l/it/developers/extend/apps/building.mdx b/packages/twenty-docs/l/it/developers/extend/apps/building.mdx index 3559d86e80..f154053e50 100644 --- a/packages/twenty-docs/l/it/developers/extend/apps/building.mdx +++ b/packages/twenty-docs/l/it/developers/extend/apps/building.mdx @@ -358,17 +358,17 @@ Note: Se prevedi di [pubblicare la tua app](/l/it/developers/extend/apps/publishing), questi campi opzionali controllano come la tua app appare nel marketplace: -| Campo | Descrizione | -| ------------------ | ----------------------------------------------------------- | -| `autore` | Nome dell'autore o dell'azienda | -| `categoria` | Categoria dell'app per il filtraggio nel marketplace | -| `logoUrl` | Percorso del logo della tua app (relativo a `./assets/`) | -| `screenshots` | Array di percorsi degli screenshot (relativi a `./assets/`) | -| `aboutDescription` | Descrizione markdown più lunga per la scheda "Informazioni" | -| `websiteUrl` | Link al tuo sito web | -| `termsUrl` | Link ai Termini di servizio | -| `emailSupport` | Indirizzo email di supporto | -| `issueReportUrl` | Link al sistema di tracciamento dei problemi | +| Campo | Descrizione | +| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------- | +| `autore` | Nome dell'autore o dell'azienda | +| `categoria` | Categoria dell'app per il filtraggio nel marketplace | +| `logoUrl` | Percorso del logo della tua app (relativo a `./assets/`) | +| `screenshots` | Array di percorsi degli screenshot (relativi a `./assets/`) | +| `aboutDescription` | Descrizione markdown più lunga per la scheda "Informazioni". Se omesso, il marketplace utilizza il `README.md` del pacchetto da npm | +| `websiteUrl` | Link al tuo sito web | +| `termsUrl` | Link ai Termini di servizio | +| `emailSupport` | Indirizzo email di supporto | +| `issueReportUrl` | Link al sistema di tracciamento dei problemi | #### Ruoli e permessi diff --git a/packages/twenty-docs/l/it/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/it/developers/extend/apps/getting-started.mdx index 67c8f4581e..b1e46a9f32 100644 --- a/packages/twenty-docs/l/it/developers/extend/apps/getting-started.mdx +++ b/packages/twenty-docs/l/it/developers/extend/apps/getting-started.mdx @@ -9,18 +9,19 @@ Le app sono attualmente in fase alfa. La funzionalità è funzionante ma ancora Le app ti permettono di estendere Twenty con oggetti, campi, funzioni logiche, competenze IA e componenti UI personalizzati — il tutto gestito come codice. -**Cosa puoi fare oggi:** +**What you can build:** -* Definisci oggetti e campi personalizzati come codice (modello dati gestito) -* Crea funzioni logiche con trigger personalizzati (route HTTP, cron, eventi del database) -* Definisci le abilità per gli agenti IA -* Crea componenti front-end che vengono renderizzati all'interno della UI di Twenty -* Distribuisci la stessa app su più spazi di lavoro +* Custom objects, fields, views, and navigation items to shape your data model +* Logic functions triggered by HTTP routes, cron schedules, or database events +* Front components that render directly inside Twenty's UI +* Skills that extend Twenty's AI agents +* Deploy an app across multiple workspaces ## Prerequisiti -* Node.js 24+ e Yarn 4 -* Docker (per il server di sviluppo locale di Twenty) +* Node.js 24+ +* Yarn 4 +* Docker (or a running local Twenty instance) ## Per iniziare @@ -29,21 +30,9 @@ Crea una nuova app utilizzando lo scaffolder ufficiale, quindi autenticati e ini ```bash filename="Terminal" # Scaffold a new app (includes all examples by default) npx create-twenty-app@latest my-twenty-app -cd my-twenty-app - -# Start dev mode: automatically syncs local changes to your workspace -yarn twenty dev ``` -Lo strumento di scaffolding supporta due modalità per controllare quali file di esempio vengono inclusi: - -```bash filename="Terminal" -# Default (exhaustive): all examples (object, field, logic function, front component, view, navigation menu item, skill, agent) -npx create-twenty-app@latest my-app - -# Minimal: only core files (application-config.ts and default-role.ts) -npx create-twenty-app@latest my-app --minimal -``` +> Use `--minimal` option to scaffold a minimal installation Da qui puoi: diff --git a/packages/twenty-docs/l/it/developers/extend/apps/publishing.mdx b/packages/twenty-docs/l/it/developers/extend/apps/publishing.mdx index bc02c0a195..7bfff4baee 100644 --- a/packages/twenty-docs/l/it/developers/extend/apps/publishing.mdx +++ b/packages/twenty-docs/l/it/developers/extend/apps/publishing.mdx @@ -102,6 +102,10 @@ yarn twenty catalog-sync -r production I metadati mostrati nel marketplace provengono dalla chiamata a `defineApplication()` nel codice sorgente della tua app — campi come `displayName`, `description`, `author`, `category`, `logoUrl`, `screenshots`, `aboutDescription`, `websiteUrl` e `termsUrl`. + +If your app does not define an `aboutDescription` in `defineApplication()`, the marketplace will automatically use your package's `README.md` from npm as the about page content. This means you can maintain a single README for both npm and the Twenty marketplace. If you want a different description in the marketplace, explicitly set `aboutDescription`. + + ### Pubblicazione con CI Il progetto generato include un workflow di GitHub Actions che pubblica a ogni release: diff --git a/packages/twenty-docs/l/it/developers/extend/capabilities/apps.mdx b/packages/twenty-docs/l/it/developers/extend/capabilities/apps.mdx index 1926f97f0b..0ce8bdc4a8 100644 --- a/packages/twenty-docs/l/it/developers/extend/capabilities/apps.mdx +++ b/packages/twenty-docs/l/it/developers/extend/capabilities/apps.mdx @@ -38,7 +38,7 @@ yarn twenty dev ### Gestione del server locale -L'SDK include comandi per gestire un server di sviluppo locale di Twenty (immagine Docker all-in-one con PostgreSQL, Redis, server e worker): +The SDK includes commands to manage a local Twenty dev server (all-in-one Docker image with PostgreSQL, Redis, server, and worker on port 2020). These commands only apply to the Docker-based dev server — they do not manage a Twenty instance started from source (e.g. `npx nx start twenty-server` on port 3000): ```bash filename="Terminal" # Avvia il server locale (scarica l'immagine se necessario) diff --git a/packages/twenty-docs/l/ro/developers/extend/apps/building.mdx b/packages/twenty-docs/l/ro/developers/extend/apps/building.mdx index c7d1e97022..020ff28d64 100644 --- a/packages/twenty-docs/l/ro/developers/extend/apps/building.mdx +++ b/packages/twenty-docs/l/ro/developers/extend/apps/building.mdx @@ -358,17 +358,17 @@ Notițe: Dacă intenționați să [publicați aplicația](/l/ro/developers/extend/apps/publishing), aceste câmpuri opționale controlează modul în care aplicația apare în marketplace: -| Câmp | Descriere | -| ------------------ | ------------------------------------------------------------- | -| `autor` | Numele autorului sau al companiei | -| `categorie` | Categoria aplicației pentru filtrarea în marketplace | -| `logoUrl` | Calea către logo-ul aplicației (relativă la `./assets/`) | -| `screenshots` | Listă de căi către capturi de ecran (relative la `./assets/`) | -| `aboutDescription` | Descriere markdown mai lungă pentru fila "About" | -| `websiteUrl` | Link către site-ul dvs. | -| `termsUrl` | Link către termenii de serviciu | -| `emailSupport` | Adresă de e-mail pentru suport | -| `issueReportUrl` | Link către sistemul de urmărire a problemelor | +| Câmp | Descriere | +| ------------------ | ------------------------------------------------------------------------------------------------------------------------------ | +| `autor` | Numele autorului sau al companiei | +| `categorie` | Categoria aplicației pentru filtrarea în marketplace | +| `logoUrl` | Calea către logo-ul aplicației (relativă la `./assets/`) | +| `screenshots` | Listă de căi către capturi de ecran (relative la `./assets/`) | +| `aboutDescription` | Descriere markdown mai lungă pentru fila "About". Dacă este omis, marketplace-ul folosește `README.md` al pachetului de pe npm | +| `websiteUrl` | Link către site-ul dvs. | +| `termsUrl` | Link către termenii de serviciu | +| `emailSupport` | Adresă de e-mail pentru suport | +| `issueReportUrl` | Link către sistemul de urmărire a problemelor | #### Roluri și permisiuni diff --git a/packages/twenty-docs/l/ro/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/ro/developers/extend/apps/getting-started.mdx index 56eb8c8976..94c70a20a2 100644 --- a/packages/twenty-docs/l/ro/developers/extend/apps/getting-started.mdx +++ b/packages/twenty-docs/l/ro/developers/extend/apps/getting-started.mdx @@ -9,18 +9,19 @@ Aplicațiile sunt în prezent în testare alfa. Caracteristica funcționează, d Aplicațiile vă permit să extindeți Twenty cu obiecte personalizate, câmpuri, funcții logice, abilități IA și componente UI — toate gestionate ca cod. -**Ce puteți face astăzi:** +**What you can build:** -* Definiți obiecte și câmpuri personalizate sub formă de cod (model de date gestionat) -* Construiți funcții logice cu declanșatoare personalizate (rute HTTP, cron, evenimente ale bazei de date) -* Definiți abilități pentru agenți de IA -* Construiți componente front-end care se afișează în interfața Twenty -* Implementați aceeași aplicație în mai multe spații de lucru +* Custom objects, fields, views, and navigation items to shape your data model +* Logic functions triggered by HTTP routes, cron schedules, or database events +* Front components that render directly inside Twenty's UI +* Skills that extend Twenty's AI agents +* Deploy an app across multiple workspaces ## Cerințe -* Node.js 24+ și Yarn 4 -* Docker (pentru serverul local de dezvoltare Twenty) +* Node.js 24+ +* Yarn 4 +* Docker (or a running local Twenty instance) ## Începeți @@ -29,21 +30,9 @@ Creați o aplicație nouă folosind generatorul oficial, apoi autentificați-vă ```bash filename="Terminal" # Scaffold a new app (includes all examples by default) npx create-twenty-app@latest my-twenty-app -cd my-twenty-app - -# Start dev mode: automatically syncs local changes to your workspace -yarn twenty dev ``` -Generatorul de schelet acceptă două moduri pentru a controla ce fișiere de exemplu sunt incluse: - -```bash filename="Terminal" -# Default (exhaustive): all examples (object, field, logic function, front component, view, navigation menu item, skill, agent) -npx create-twenty-app@latest my-app - -# Minimal: only core files (application-config.ts and default-role.ts) -npx create-twenty-app@latest my-app --minimal -``` +> Use `--minimal` option to scaffold a minimal installation De aici puteți: diff --git a/packages/twenty-docs/l/ro/developers/extend/apps/publishing.mdx b/packages/twenty-docs/l/ro/developers/extend/apps/publishing.mdx index f68adbb3e7..30283e8cf6 100644 --- a/packages/twenty-docs/l/ro/developers/extend/apps/publishing.mdx +++ b/packages/twenty-docs/l/ro/developers/extend/apps/publishing.mdx @@ -102,6 +102,10 @@ yarn twenty catalog-sync -r production Metadatele afișate în marketplace provin din apelul tău `defineApplication()` din codul sursă al aplicației — câmpuri precum `displayName`, `description`, `author`, `category`, `logoUrl`, `screenshots`, `aboutDescription`, `websiteUrl` și `termsUrl`. + +If your app does not define an `aboutDescription` in `defineApplication()`, the marketplace will automatically use your package's `README.md` from npm as the about page content. This means you can maintain a single README for both npm and the Twenty marketplace. If you want a different description in the marketplace, explicitly set `aboutDescription`. + + ### Publicare CI Proiectul generat include un workflow GitHub Actions care publică la fiecare lansare: diff --git a/packages/twenty-docs/l/ro/developers/extend/capabilities/apps.mdx b/packages/twenty-docs/l/ro/developers/extend/capabilities/apps.mdx index b34c111303..0c808d3991 100644 --- a/packages/twenty-docs/l/ro/developers/extend/capabilities/apps.mdx +++ b/packages/twenty-docs/l/ro/developers/extend/capabilities/apps.mdx @@ -38,7 +38,7 @@ yarn twenty dev ### Gestionarea serverului local -SDK-ul include comenzi pentru a gestiona un server local de dezvoltare Twenty (imagine Docker all-in-one cu PostgreSQL, Redis, server și worker): +The SDK includes commands to manage a local Twenty dev server (all-in-one Docker image with PostgreSQL, Redis, server, and worker on port 2020). These commands only apply to the Docker-based dev server — they do not manage a Twenty instance started from source (e.g. `npx nx start twenty-server` on port 3000): ```bash filename="Terminal" # Pornește serverul local (descarcă imaginea dacă este necesar) diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/building.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/building.mdx index 99de2053b8..43ad4112a8 100644 --- a/packages/twenty-docs/l/ru/developers/extend/apps/building.mdx +++ b/packages/twenty-docs/l/ru/developers/extend/apps/building.mdx @@ -358,17 +358,17 @@ export default defineApplication({ Если вы планируете [опубликовать приложение](/l/ru/developers/extend/apps/publishing), эти необязательные поля определяют, как ваше приложение отображается в маркетплейсе: -| Поле | Описание | -| ------------------ | ------------------------------------------------------------ | -| `author` | Имя автора или название компании | -| `category` | Категория приложения для фильтрации в маркетплейсе | -| `logoUrl` | Путь к логотипу вашего приложения (относительно `./assets/`) | -| `screenshots` | Массив путей к скриншотам (относительно `./assets/`) | -| `aboutDescription` | Расширенное описание в Markdown для вкладки "About" | -| `websiteUrl` | Ссылка на ваш сайт | -| `termsUrl` | Ссылка на условия предоставления услуг | -| `emailSupport` | Адрес электронной почты поддержки | -| `issueReportUrl` | Ссылка на систему отслеживания проблем | +| Поле | Описание | +| ------------------ | ------------------------------------------------------------------------------------------------------------------- | +| `author` | Имя автора или название компании | +| `category` | Категория приложения для фильтрации в маркетплейсе | +| `logoUrl` | Путь к логотипу вашего приложения (относительно `./assets/`) | +| `screenshots` | Массив путей к скриншотам (относительно `./assets/`) | +| `aboutDescription` | Расширенное описание в Markdown для вкладки "About". Если опущено, маркетплейс использует `README.md` пакета из npm | +| `websiteUrl` | Ссылка на ваш сайт | +| `termsUrl` | Ссылка на условия предоставления услуг | +| `emailSupport` | Адрес электронной почты поддержки | +| `issueReportUrl` | Ссылка на систему отслеживания проблем | #### Роли и разрешения diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/getting-started.mdx index 0c96527a5b..5a17cf2376 100644 --- a/packages/twenty-docs/l/ru/developers/extend/apps/getting-started.mdx +++ b/packages/twenty-docs/l/ru/developers/extend/apps/getting-started.mdx @@ -9,18 +9,19 @@ description: Создайте своё первое приложение Twenty Приложения позволяют расширять Twenty с помощью пользовательских объектов, полей, логических функций, навыков ИИ и UI-компонентов — всё это управляется как код. -**Что вы можете делать уже сегодня:** +**What you can build:** -* Определяйте пользовательские объекты и поля в виде кода (управляемая модель данных) -* Создавайте логические функции с пользовательскими триггерами (HTTP-маршруты, cron, события базы данных) -* Определяйте навыки для ИИ-агентов -* Создавайте фронтенд-компоненты, которые отображаются внутри интерфейса Twenty -* Развёртывайте одно и то же приложение в нескольких рабочих пространствах +* Custom objects, fields, views, and navigation items to shape your data model +* Logic functions triggered by HTTP routes, cron schedules, or database events +* Front components that render directly inside Twenty's UI +* Skills that extend Twenty's AI agents +* Deploy an app across multiple workspaces ## Требования -* Node.js 24+ и Yarn 4 -* Docker (для локального сервера разработки Twenty) +* Node.js 24+ +* Yarn 4 +* Docker (or a running local Twenty instance) ## Начало работы @@ -29,21 +30,9 @@ description: Создайте своё первое приложение Twenty ```bash filename="Terminal" # Scaffold a new app (includes all examples by default) npx create-twenty-app@latest my-twenty-app -cd my-twenty-app - -# Start dev mode: automatically syncs local changes to your workspace -yarn twenty dev ``` -Генератор каркаса поддерживает два режима для управления тем, какие файлы-примеры включаются: - -```bash filename="Terminal" -# Default (exhaustive): all examples (object, field, logic function, front component, view, navigation menu item, skill, agent) -npx create-twenty-app@latest my-app - -# Minimal: only core files (application-config.ts and default-role.ts) -npx create-twenty-app@latest my-app --minimal -``` +> Use `--minimal` option to scaffold a minimal installation Отсюда вы можете: diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/publishing.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/publishing.mdx index 34b7bb4b8c..ef19bda214 100644 --- a/packages/twenty-docs/l/ru/developers/extend/apps/publishing.mdx +++ b/packages/twenty-docs/l/ru/developers/extend/apps/publishing.mdx @@ -102,6 +102,10 @@ yarn twenty catalog-sync -r production Метаданные, отображаемые в маркетплейсе, берутся из вызова `defineApplication()` в исходном коде вашего приложения — из таких полей, как `displayName`, `description`, `author`, `category`, `logoUrl`, `screenshots`, `aboutDescription`, `websiteUrl` и `termsUrl`. + +If your app does not define an `aboutDescription` in `defineApplication()`, the marketplace will automatically use your package's `README.md` from npm as the about page content. This means you can maintain a single README for both npm and the Twenty marketplace. If you want a different description in the marketplace, explicitly set `aboutDescription`. + + ### Публикация через CI Сгенерированный шаблоном проект включает рабочий процесс GitHub Actions, который выполняет публикацию при каждом релизе: @@ -238,8 +242,8 @@ Twenty группирует приложения в три категории в | --------------------------- | -------------------------------------------------------- | ------------------------------------------------------- | | `yarn twenty build` | Скомпилировать приложение и сгенерировать манифест | `--tarball` — также создать пакет `.tgz` | | `yarn twenty publish` | Собрать и опубликовать в npm | `--tag ` — dist-tag npm (например, `beta`, `next`) | -| `yarn twenty deploy` | Собрать и загрузить tarball на сервер | `-r, --remote ` — целевой remote | -| `yarn twenty catalog-sync` | Запустить на сервере синхронизацию каталога маркетплейса | `-r, --remote ` — целевой remote | +| `yarn twenty deploy` | Собрать и загрузить tarball на сервер | `-r, --remote ` — целевой удалённый репозиторий | +| `yarn twenty catalog-sync` | Запустить на сервере синхронизацию каталога маркетплейса | `-r, --remote ` — целевой удалённый репозиторий | | `yarn twenty install` | Установить развернутое приложение в рабочем пространстве | `-r, --remote ` — целевой remote | | `yarn twenty dev` | Отслеживать и синхронизировать локальные изменения | Использует remote по умолчанию | | `yarn twenty remote add` | Добавить подключение к серверу | `--url`, `--token`, `--as`, `--local`, `--port` | diff --git a/packages/twenty-docs/l/ru/developers/extend/capabilities/apps.mdx b/packages/twenty-docs/l/ru/developers/extend/capabilities/apps.mdx index 23da2142a5..1050035ec1 100644 --- a/packages/twenty-docs/l/ru/developers/extend/capabilities/apps.mdx +++ b/packages/twenty-docs/l/ru/developers/extend/capabilities/apps.mdx @@ -38,7 +38,7 @@ yarn twenty dev ### Управление локальным сервером -SDK включает команды для управления локальным сервером разработки Twenty (универсальный образ Docker с PostgreSQL, Redis, сервером и воркером): +The SDK includes commands to manage a local Twenty dev server (all-in-one Docker image with PostgreSQL, Redis, server, and worker on port 2020). These commands only apply to the Docker-based dev server — they do not manage a Twenty instance started from source (e.g. `npx nx start twenty-server` on port 3000): ```bash filename="Terminal" # Запустить локальный сервер (при необходимости будет загружен образ) diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/building.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/building.mdx index 576b063822..d5a6126368 100644 --- a/packages/twenty-docs/l/tr/developers/extend/apps/building.mdx +++ b/packages/twenty-docs/l/tr/developers/extend/apps/building.mdx @@ -358,17 +358,17 @@ Notlar: Eğer [uygulamanızı yayımlamayı](/l/tr/developers/extend/apps/publishing) planlıyorsanız, bu isteğe bağlı alanlar uygulamanızın pazaryerinde nasıl görüneceğini kontrol eder: -| Alan | Açıklama | -| ------------------ | ------------------------------------------------------------- | -| `author` | Yazar veya şirket adı | -| `category` | Pazaryerinde filtreleme için uygulama kategorisi | -| `logoUrl` | Uygulama logonuzun yolu (`./assets/` dizinine göre) | -| `screenshots` | Ekran görüntüsü yollarının dizisi (`./assets/` dizinine göre) | -| `aboutDescription` | "Hakkında" sekmesi için daha uzun bir markdown açıklaması | -| `websiteUrl` | Web sitenize bağlantı | -| `termsUrl` | Hizmet Koşulları'na bağlantı | -| `emailSupport` | Destek e-posta adresi | -| `issueReportUrl` | Sorun izleyicisine bağlantı | +| Alan | Açıklama | +| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------- | +| `author` | Yazar veya şirket adı | +| `category` | Pazaryerinde filtreleme için uygulama kategorisi | +| `logoUrl` | Uygulama logonuzun yolu (`./assets/` dizinine göre) | +| `screenshots` | Ekran görüntüsü yollarının dizisi (`./assets/` dizinine göre) | +| `aboutDescription` | "Hakkında" sekmesi için daha uzun bir markdown açıklaması. Belirtilmezse, pazaryeri npm'deki paketin `README.md` dosyasını kullanır | +| `websiteUrl` | Web sitenize bağlantı | +| `termsUrl` | Hizmet Koşulları'na bağlantı | +| `emailSupport` | Destek e-posta adresi | +| `issueReportUrl` | Sorun izleyicisine bağlantı | #### Roller ve izinler diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/getting-started.mdx index 8526ddf96e..54dab5ca15 100644 --- a/packages/twenty-docs/l/tr/developers/extend/apps/getting-started.mdx +++ b/packages/twenty-docs/l/tr/developers/extend/apps/getting-started.mdx @@ -9,18 +9,19 @@ Uygulamalar şu anda alfa testinde. Özellik işlevsel ancak hâlâ gelişmekte. Uygulamalar, Twenty'yi özel nesneler, alanlar, mantık işlevleri, Yapay Zeka yetenekleri ve UI bileşenleriyle genişletmenizi sağlar — tümü kod olarak yönetilir. -**Bugün Yapabilecekleriniz:** +**What you can build:** -* Özel nesneleri ve alanları kod olarak tanımlayın (yönetilen veri modeli) -* Özel tetikleyicilerle mantık işlevleri oluşturun (HTTP routes, cron, database events) -* Yapay zekâ ajanları için becerileri tanımlayın -* Twenty'nin UI'si içinde görüntülenen ön bileşenler oluşturun -* Aynı uygulamayı birden çok çalışma alanına dağıtın +* Custom objects, fields, views, and navigation items to shape your data model +* Logic functions triggered by HTTP routes, cron schedules, or database events +* Front components that render directly inside Twenty's UI +* Skills that extend Twenty's AI agents +* Deploy an app across multiple workspaces ## Ön Gereksinimler -* Node.js 24+ ve Yarn 4 -* Docker (yerel Twenty geliştirme sunucusu için) +* Node.js 24+ +* Yarn 4 +* Docker (or a running local Twenty instance) ## Başlarken @@ -29,21 +30,9 @@ Resmi iskelet oluşturucu aracını kullanarak yeni bir uygulama oluşturun, ard ```bash filename="Terminal" # Scaffold a new app (includes all examples by default) npx create-twenty-app@latest my-twenty-app -cd my-twenty-app - -# Start dev mode: automatically syncs local changes to your workspace -yarn twenty dev ``` -İskelet oluşturucu, hangi örnek dosyaların dahil edileceğini kontrol etmek için iki modu destekler: - -```bash filename="Terminal" -# Default (exhaustive): all examples (object, field, logic function, front component, view, navigation menu item, skill, agent) -npx create-twenty-app@latest my-app - -# Minimal: only core files (application-config.ts and default-role.ts) -npx create-twenty-app@latest my-app --minimal -``` +> Use `--minimal` option to scaffold a minimal installation Buradan şunları yapabilirsiniz: diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/publishing.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/publishing.mdx index 0b8dea60e3..6291fa2015 100644 --- a/packages/twenty-docs/l/tr/developers/extend/apps/publishing.mdx +++ b/packages/twenty-docs/l/tr/developers/extend/apps/publishing.mdx @@ -102,6 +102,10 @@ yarn twenty catalog-sync -r production Pazar yerinde gösterilen meta veriler, uygulamanızın kaynak kodundaki `defineApplication()` çağrısından gelir — `displayName`, `description`, `author`, `category`, `logoUrl`, `screenshots`, `aboutDescription`, `websiteUrl` ve `termsUrl` gibi alanlar. + +If your app does not define an `aboutDescription` in `defineApplication()`, the marketplace will automatically use your package's `README.md` from npm as the about page content. This means you can maintain a single README for both npm and the Twenty marketplace. If you want a different description in the marketplace, explicitly set `aboutDescription`. + + ### CI üzerinden yayımlama İskelet proje, her sürümde yayımlayan bir GitHub Actions iş akışını içerir: diff --git a/packages/twenty-docs/l/tr/developers/extend/capabilities/apps.mdx b/packages/twenty-docs/l/tr/developers/extend/capabilities/apps.mdx index 4478213a1a..2ca0e9b73b 100644 --- a/packages/twenty-docs/l/tr/developers/extend/capabilities/apps.mdx +++ b/packages/twenty-docs/l/tr/developers/extend/capabilities/apps.mdx @@ -38,7 +38,7 @@ yarn twenty dev ### Yerel Sunucu Yönetimi -SDK, yerel bir Twenty geliştirme sunucusunu yönetmek için komutlar içerir (PostgreSQL, Redis, sunucu ve worker içeren hepsi bir arada Docker imajı): +The SDK includes commands to manage a local Twenty dev server (all-in-one Docker image with PostgreSQL, Redis, server, and worker on port 2020). These commands only apply to the Docker-based dev server — they do not manage a Twenty instance started from source (e.g. `npx nx start twenty-server` on port 3000): ```bash filename="Terminal" # Yerel sunucuyu başlatın (gerekirse imajı indirir) diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/building.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/building.mdx index 9bab23b73c..ee9f2e0fad 100644 --- a/packages/twenty-docs/l/zh/developers/extend/apps/building.mdx +++ b/packages/twenty-docs/l/zh/developers/extend/apps/building.mdx @@ -358,17 +358,17 @@ export default defineApplication({ 如果你计划[发布你的应用](/l/zh/developers/extend/apps/publishing)，这些可选字段将控制你的应用在应用市场中的展示： -| 字段 | 描述 | -| ------------------ | -------------------------- | -| `作者` | 作者或公司名称 | -| `类别` | 用于应用市场筛选的应用类别 | -| `logoUrl` | 你的应用徽标的路径（相对于 `./assets/`） | -| `screenshots` | 屏幕截图路径数组（相对于 `./assets/`） | -| `aboutDescription` | 用于“关于”选项卡的更长 Markdown 描述 | -| `websiteUrl` | 你的网站链接 | -| `termsUrl` | 服务条款链接 | -| `emailSupport` | 支持电子邮件地址 | -| `issueReportUrl` | 问题跟踪器链接 | +| 字段 | 描述 | +| ------------------ | -------------------------------------------------------------- | +| `作者` | 作者或公司名称 | +| `类别` | 用于应用市场筛选的应用类别 | +| `logoUrl` | 你的应用徽标的路径（相对于 `./assets/`） | +| `screenshots` | 屏幕截图路径数组（相对于 `./assets/`） | +| `aboutDescription` | 用于“关于”选项卡的更长的 Markdown 描述。 如果省略，市场将使用该软件包在 npm 上的 `README.md`。 | +| `websiteUrl` | 你的网站链接 | +| `termsUrl` | 服务条款链接 | +| `emailSupport` | 支持电子邮件地址 | +| `issueReportUrl` | 问题跟踪器链接 | #### 角色和权限 diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/getting-started.mdx index b42700dd93..13985033a4 100644 --- a/packages/twenty-docs/l/zh/developers/extend/apps/getting-started.mdx +++ b/packages/twenty-docs/l/zh/developers/extend/apps/getting-started.mdx @@ -9,18 +9,19 @@ description: 几分钟内创建你的第一个 Twenty 应用。 应用可通过自定义对象、字段、逻辑函数、AI 技能和 UI 组件来扩展 Twenty——全部以代码进行管理。 -**你现在可以做什么:** +**What you can build:** -* 以代码定义自定义对象和字段（受管理的数据模型） -* 使用自定义触发器（HTTP 路由、cron、数据库事件）构建逻辑函数 -* 为 AI 智能体定义技能 -* 构建在 Twenty 的 UI 中渲染的前端组件 -* 将同一个应用部署到多个工作空间 +* Custom objects, fields, views, and navigation items to shape your data model +* Logic functions triggered by HTTP routes, cron schedules, or database events +* Front components that render directly inside Twenty's UI +* Skills that extend Twenty's AI agents +* Deploy an app across multiple workspaces ## 先决条件 -* Node.js 24+ 和 Yarn 4 -* Docker (用于本地 Twenty 开发服务器) +* Node.js 24+ +* Yarn 4 +* Docker (or a running local Twenty instance) ## 开始使用 @@ -29,21 +30,9 @@ description: 几分钟内创建你的第一个 Twenty 应用。 ```bash filename="Terminal" # Scaffold a new app (includes all examples by default) npx create-twenty-app@latest my-twenty-app -cd my-twenty-app - -# Start dev mode: automatically syncs local changes to your workspace -yarn twenty dev ``` -脚手架工具支持两种模式，用于控制包含哪些示例文件： - -```bash filename="Terminal" -# Default (exhaustive): all examples (object, field, logic function, front component, view, navigation menu item, skill, agent) -npx create-twenty-app@latest my-app - -# Minimal: only core files (application-config.ts and default-role.ts) -npx create-twenty-app@latest my-app --minimal -``` +> Use `--minimal` option to scaffold a minimal installation 从这里您可以： diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/publishing.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/publishing.mdx index f016e8f6c8..6a50b2f845 100644 --- a/packages/twenty-docs/l/zh/developers/extend/apps/publishing.mdx +++ b/packages/twenty-docs/l/zh/developers/extend/apps/publishing.mdx @@ -102,6 +102,10 @@ yarn twenty catalog-sync -r production 市场中显示的元数据来自你在应用源代码中调用的 `defineApplication()` —— 诸如 `displayName`、`description`、`author`、`category`、`logoUrl`、`screenshots`、`aboutDescription`、`websiteUrl` 和 `termsUrl` 等字段。 + +如果您的应用未在 `defineApplication()` 中定义 `aboutDescription`，市场将自动使用 npm 上您的软件包的 `README.md` 作为关于页面内容。 这意味着您可以为 npm 和 Twenty 市场维护同一个 README。 如果您希望在市场中使用不同的描述，请显式设置 `aboutDescription`。 + + ### CI 发布 脚手架项目包含一个 GitHub Actions 工作流，会在每次发版时自动发布： diff --git a/packages/twenty-docs/l/zh/developers/extend/capabilities/apps.mdx b/packages/twenty-docs/l/zh/developers/extend/capabilities/apps.mdx index f7d941a0e1..42d51a45b4 100644 --- a/packages/twenty-docs/l/zh/developers/extend/capabilities/apps.mdx +++ b/packages/twenty-docs/l/zh/developers/extend/capabilities/apps.mdx @@ -38,7 +38,7 @@ yarn twenty dev ### 本地服务器管理 -该 SDK 包含用于管理本地 Twenty 开发服务器的命令（该服务器是一体化 Docker 镜像，内含 PostgreSQL、Redis、服务器和工作进程）： +The SDK includes commands to manage a local Twenty dev server (all-in-one Docker image with PostgreSQL, Redis, server, and worker on port 2020). These commands only apply to the Docker-based dev server — they do not manage a Twenty instance started from source (e.g. `npx nx start twenty-server` on port 3000): ```bash filename="Terminal" # Start the local server (pulls the image if needed)