diff --git a/src/content/docs/de/config-reference/dashboard.mdx b/src/content/docs/de/config-reference/dashboard.mdx new file mode 100644 index 00000000..50c82b8d --- /dev/null +++ b/src/content/docs/de/config-reference/dashboard.mdx @@ -0,0 +1,227 @@ +--- +i18nReady: true +title: Dashboard-Konfiguration +description: Referenzseite für StudioCMSOptions dashboardConfig +sidebar: + order: 6 +--- + +import ReadMore from '~/components/ReadMore.astro'; + +StudioCMS Integration Konfigurationsoptionen Schema Referenz. + +```ts twoslash title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + dashboardConfig: { + dashboardEnabled: true, + dashboardRouteOverride: 'dashboard', + developerConfig: {}, + faviconURL: '/favicon.svg', + inject404Route: true, + versionCheck: true, + AuthConfig: {}, + }, +}); +``` + +## `dashboardEnabled` + +`dashboardEnabled` ist ein boolescher Wert, mit dem du bestimmen kannst, ob das Dashboard aktiviert ist. + +- **Typ:** `boolean` +- **Standard:** `true` + +### Verwendung + +```ts twoslash {3} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + dashboardConfig: { + dashboardEnabled: true, // STANDARD - Dadurch wird das Dashboard aktiviert. + } +}) +``` + +## `DashboardRouteOverride` + +`DashboardRouteOverride` ist eine Zeichenkette, der verwendet wird, um die Route für das Dashboard zu bestimmen. + +- **Typ:** `string` +- **Standard:** `'dashboard'` + +### Verwendung + +```ts twoslash {3} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + dashboardConfig: { + dashboardRouteOverride: 'dashboard', // STANDARD - Damit wird die Dashboard-Route auf /dashboard gesetzt. + } +}) +``` + +## `developerConfig` + +`developerConfig` ist ein Objekt, das verwendet wird, um die Entwicklereinstellungen für das Dashboard zu konfigurieren. + +### Verwendung + +```ts twoslash {3-5} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + dashboardConfig: { + developerConfig: { + demoMode: false, // STANDARD - Dadurch wird der Demomodus deaktiviert. + }, + } +}) +``` + +## `faviconURL` + +`faviconURL` ist eine Zeichenkette, die verwendet wird, um den Pfad zum Favicon für das Dashboard zu bestimmen. + +- **Typ:** `string` +- **Standard:** `'/favicon.svg'` + +### Verwendung + +```ts twoslash {3} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + dashboardConfig: { + faviconURL: '/favicon.svg', // STANDARD - Damit wird das Favicon für das Dashboard festgelegt. + } +}) +``` + +## `inject404Route` + +`inject404Route` ist ein boolescher Wert, mit dem festgelegt wird, ob die 404-Route injiziert werden soll. + +- **Typ:** `boolean` +- **Standard:** `true` + +### Verwendung + +```ts twoslash {3} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + dashboardConfig: { + inject404Route: true, // STANDARD - Dadurch wird die Route 404 injiziert. + } +}) +``` + +## `versionCheck` + +`versionCheck` ist ein boolescher Wert, mit dem festgelegt wird, ob die Versionsprüfung aktiviert werden soll. + +- **Typ:** `boolean` +- **Standard:** `true` + +### Verwendung + +```ts twoslash {3} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + dashboardConfig: { + versionCheck: true, // STANDARD - Dies aktiviert Versionskontrolle. + } +}) +``` + +## `AuthConfig` + +`AuthConfig` ist ein Objekt, das verwendet wird, um die Authentifizierungseinstellungen für das Dashboard zu konfigurieren. + +### Verwendung + +```ts twoslash {3-5} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + dashboardConfig: { + AuthConfig: { + enabled: true, // STANDARD - Dies aktiviert Authentifizierung. + }, + } +}) +``` + +### `providers` + +`providers` ist ein Objekt, das verwendet wird, um die Authentifizierungsanbieter für das Dashboard zu konfigurieren. + +- **Typ:** [`AuthProviders`](#authprovider) +- **Standard:** `{}` + +#### Verwendung + +```ts twoslash {4-11} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + dashboardConfig: { + AuthConfig: { + providers: { + google: true, + github: true, + discord: true, + auth0: true, + usernameAndPassword: true, + usernameAndPasswordConfig: {}, + }, + }, + }, +}) +``` + +#### `usernameAndPasswordConfig` + +`usernameAndPasswordConfig` ist ein Objekt, mit dem du die Einstellungen für den Benutzernamen und das Passwort für das Dashboard konfigurierst. + +- **Typ:** `{ allowUserRegistration?: boolean }` +- **Standard:** `{}` + +##### Verwendung + +```ts twoslash {5-8} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + dashboardConfig: { + AuthConfig: { + providers: { + usernameAndPassword: true, + usernameAndPasswordConfig: { + allowUserRegistration: true, // STANDARD - Dies ermöglicht die Registrierung von Nutzern. + }, + }, + }, + }, +}) +``` + +###### `AuthProvider` + +```ts +type AuthProviders: { + github?: boolean | undefined; + discord?: boolean | undefined; + google?: boolean | undefined; + auth0?: boolean | undefined; + usernameAndPassword?: boolean | undefined; + usernameAndPasswordConfig?: { + allowUserRegistration?: boolean | undefined; + } | undefined; +} | undefined +``` \ No newline at end of file diff --git a/src/content/docs/de/config-reference/default-frontend-config.mdx b/src/content/docs/de/config-reference/default-frontend-config.mdx new file mode 100644 index 00000000..7900fd00 --- /dev/null +++ b/src/content/docs/de/config-reference/default-frontend-config.mdx @@ -0,0 +1,120 @@ +--- +i18nReady: true +title: Standard-Frontend-Konfiguration +description: Referenzseite für StudioCMSOptions defaultFrontEndConfig +sidebar: + order: 5 +--- + +import ReadMore from '~/components/ReadMore.astro'; + +StudioCMS Integration Konfigurationsoptionen Schema Referenz. + +```ts twoslash title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + defaultFrontEndConfig: { + favicon: '/favicon.svg', + htmlDefaultLanguage: 'en', + htmlDefaultHead: [], + injectQuickActionsMenu: true, + }, +}); +``` + +## `favicon` + +`favicon` ist eine Zeichenkette, die verwendet wird, um den Pfad zum Favicon für die Website zu bestimmen. + +- **Typ:** `string` +- **Standard:** `'/favicon.svg'` + +### Verwendung + +```ts twoslash {3} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + defaultFrontEndConfig: { + favicon: '/favicon.svg', // STANDARD - Hier wird das Standard-Favicon verwendet. + } +}) +``` + +## `htmlDefaultLanguage` + +`htmlDefaultLanguage` ist eine Zeichenkette, die verwendet wird, um die Standardsprache für die Website festzulegen. + +- **Typ:** `string` +- **Standard:** `'en'` + +### Verwendung + +```ts twoslash {3} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + defaultFrontEndConfig: { + htmlDefaultLanguage: 'en', // STANDARD - Dabei wird die Standardsprache verwendet. + } +}) +``` + +## `htmlDefaultHead` + +**Typ:** [`HeadConfig[]`](#headconfig) + +Füge benutzerdefinierte Tags zum `` deiner Starlight-Website hinzu. +Das kann nützlich sein, um Analysen und andere Skripte und Ressourcen von Drittanbietern hinzuzufügen. + +```ts twoslash {3} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + defaultFrontEndConfig: { + htmlDefaultHead: [ + // Beispiel: Fathom analytics script tag hinzufügen. + { + tag: 'script', + attrs: { + src: 'https://cdn.usefathom.com/script.js', + 'data-site': 'MY-FATHOM-ID', + defer: true, + }, + }, + ], + }, +}); +``` + +Einträge in `head` werden direkt in HTML-Elemente umgewandelt und durchlaufen nicht die [Skript](https://docs.astro.build/en/guides/client-side-scripts/#script-processing)- oder [Style](https://docs.astro.build/en/guides/styling/#styling-in-astro)-Verarbeitung von Astro. + +#### `HeadConfig` + +```ts +interface HeadConfig { + tag: string; + attrs?: Record; + content?: string; +} +``` + +## `injectQuickActionsMenu` + +**Typ:** `boolean` +**Standard:** `true` + +Fügt eine Benutzeroberfläche für schnelle Aktionen in der rechten unteren Ecke der Hauptseite ein, mit der du schnell zur StudioCMS-Verwaltungsoberfläche navigieren kannst. + +### Verwendung + +```ts twoslash {3} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + defaultFrontEndConfig: { + injectQuickActionsMenu: true, // STANDARD - Dadurch wird das Schnellaktionsmenü eingefügt. + } +}) +``` \ No newline at end of file diff --git a/src/content/docs/de/config-reference/image-service.mdx b/src/content/docs/de/config-reference/image-service.mdx new file mode 100644 index 00000000..d66579aa --- /dev/null +++ b/src/content/docs/de/config-reference/image-service.mdx @@ -0,0 +1,28 @@ +--- +i18nReady: true +title: Bilderdienst +description: Referenzseite für StudioCMSOptions imageService +sidebar: + order: 4 +--- + +import ReadMore from '~/components/ReadMore.astro'; + +StudioCMS Integration Konfigurationsoptionen Schema Referenz. + +```ts twoslash title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + imageService: { + cdnPlugin: 'cloudinary-js' + }, +}); +``` + +## `cdnPlugin` + +`cdnPlugin` ist eine Aufzählung, mit der festgelegt wird, welches CDN-Plugin für Bilder verwendet werden soll, wenn es aktiviert ist. + +- **Typ:** `'cloudinary-js'` | `undefined` +- **Standard:** `undefined` \ No newline at end of file diff --git a/src/content/docs/de/config-reference/included-integrations.mdx b/src/content/docs/de/config-reference/included-integrations.mdx new file mode 100644 index 00000000..de5fb2cf --- /dev/null +++ b/src/content/docs/de/config-reference/included-integrations.mdx @@ -0,0 +1,56 @@ +--- +i18nReady: true +title: Inklusive Integrationen +description: Referenzseite für StudioCMSOptions IncludedIntegrations +sidebar: + order: 7 +--- + +import ReadMore from '~/components/ReadMore.astro'; + +StudioCMS Integration Konfigurationsoptionen Schema Referenz. + +```ts twoslash title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + includedIntegrations: { + robotsTXT: true + }, +}); +``` + +## `robotsTXT` + +`robotsTXT` ist ein boolescher Wert oder ein Objekt, das verwendet wird, um festzustellen, ob die robots.txt-Datei aktiviert ist. + +- **Typ:** `boolean` | [`RobotsConfig`](#robotsconfig) | `undefined` +- **Standard:** `true` + +### Verwendung + +```ts twoslash {3} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + includedIntegrations: { + robotsTXT: true, // STANDARD - Dies aktiviert die robots.txt-Datei. + } +}) +``` + +##### `RobotsConfig` + +```ts +interface RobotsConfig { + host?: boolean | string; + sitemap?: boolean | string | string[]; + policy?: { + userAgent?: string; + disallow?: string | string[]; + allow?: string | string[]; + crawlDelay?: number; + cleanParam?: string | string[]; + }[] | undefined; +} +``` \ No newline at end of file diff --git a/src/content/docs/de/config-reference/index.mdx b/src/content/docs/de/config-reference/index.mdx new file mode 100644 index 00000000..fc3484a8 --- /dev/null +++ b/src/content/docs/de/config-reference/index.mdx @@ -0,0 +1,187 @@ +--- +i18nReady: true +title: StudioCMSOptions +description: Referenzseite für StudioCMSOptions +sidebar: + order: 1 +--- + +import ReadMore from '~/components/ReadMore.astro'; + +StudioCMS Integration Konfigurationsoptionen Schema Referenz. + +```ts twoslash title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +// Standardwerte angezeigt +export default defineStudioCMSConfig({ + dbStartPage: true, + dateLocale: 'en-us', + verbose: false, + plugins: [], + componentRegistry: {}, + overrides: {}, + imageService: {}, + defaultFrontEndConfig: {}, + dashboardConfig: {}, + includedIntegrations: {}, + dateTimeFormat: {}, + sdk: {}, + pageTypeOptions: {} +}); +``` + +## `dbStartPage` + +Projektinitialisierungsseite - Wird bei der Ersteinrichtung verwendet, um deine Datenbankkonfiguration zu erstellen. + +- **Typ:** `boolean` +- **Standard:** `true` + +### Verwendung + +```ts twoslash {2} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + dbStartPage: true, // STANDARD - Dies fügt eine Startseite ein, um deine DB-Daten einzurichten. +}) +``` + +## `dateLocale` + +`dateLocale` ist eine Zeichenkette, der verwendet wird, um das Gebietsschema für die Datumsformatierung zu bestimmen. + +- **Typ:** `string` +- **Standard:** `'en-us'` + +### Verwendung + +```ts twoslash {2} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + dateLocale: 'en-us', // STANDARD - Hier wird das Gebietsschema für die Datumsformatierung festgelegt. +}) +``` + +## `verbose` + +`verbose` ist ein boolescher Wert, mit dem du die ausführliche Protokollierung aktivieren oder deaktivieren kannst. + +- **Typ:** `boolean` +- **Standard:** `false` + +### Verwendung + +```ts twoslash {2} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + verbose: false, // STANDARD - Dies setzt die ausführliche Protokollierung auf false. +}) +``` + +## `plugins` + +`plugins` ist ein Array, mit dem festgelegt wird, welche Plugins geladen werden sollen. + +- **Typ:** `StudioCMSPlugin[]` +- **Standard:** `[]` + +### Verwendung + +```ts twoslash {1, 3-5} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +import blog from '@studiocms/blog'; +export default defineStudioCMSConfig({ + plugins: [ + blog(), + ], +}) +``` + +## `componentRegistry` + +`componentRegistry` ist ein Objekt, das zur Registrierung von Komponenten verwendet wird. + +- **Typ:** `Record` +- **Standard:** `{}` + +### Verwendung + +```ts twoslash {2-4} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + componentRegistry: { + 'my-component': 'src/components/MyComponent.astro', + }, +}) +``` + +## `dateTimeFormat` + +`dateTimeFormat` ist ein Objekt, mit dem du das Datums- und Zeitformat konfigurieren kannst. + +- **Typ:** `Intl.DateTimeFormatOptions` +- **Standard:** `{}` + +### Verwendung + +```ts twoslash {2-6} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + dateTimeFormat: { + year: "numeric", + month: "short", + day: "numeric" + }, +}) +``` + +## `overrides` + +`overrides` ist ein Objekt, mit dem die Standardkonfiguration überschrieben werden kann. + +[Siehe `overrides` für alle Optionen][overrides] + +## `imageService` + +`imageService` ist ein Objekt, das zur Konfiguration des Bilddienstes verwendet wird. + +[Siehe `imageService` für alle Optionen][image-service] + +## `defaultFrontEndConfig` + +`defaultFrontEndConfig` ist ein Objekt, mit dem das Standard-Frontend konfiguriert wird. + +[Siehe `defaultFrontEndConfig` für alle Optionen][default-frontend-config] + +## `dashboardConfig` + +`dashboardConfig` ist ein Objekt, mit dem das Dashboard konfiguriert werden kann. + +[Siehe `dashboardConfig` für alle Optionen][dashboard] + +## `includedIntegrations` + +`includedIntegrations` ist ein Objekt, das verwendet wird, um zu konfigurieren, welche Integrationen einbezogen werden sollen. + +[Siehe `includedIntegrations` für alle Optionen][included-integrations] + +## `sdk` + +`sdk` ist ein Objekt, das zur Konfiguration des SDKs verwendet wird. + +[Siehe `sdk` für alle Optionen][sdk] + +{/* Links */} +[overrides]: /de/config-reference/overrides/ +[image-service]: /de/config-reference/image-service/ +[default-frontend-config]: /de/config-reference/default-frontend-config/ +[dashboard]: /de/config-reference/dashboard/ +[included-integrations]: /de/config-reference/included-integrations/ +[sdk]: /de/config-reference/sdk/ \ No newline at end of file diff --git a/src/content/docs/de/config-reference/overrides.mdx b/src/content/docs/de/config-reference/overrides.mdx new file mode 100644 index 00000000..f38ef339 --- /dev/null +++ b/src/content/docs/de/config-reference/overrides.mdx @@ -0,0 +1,77 @@ +--- +i18nReady: true +title: Überschreibungen +description: Referenzseite für StudioCMSOptions overrides +sidebar: + order: 2 +--- + +import ReadMore from '~/components/ReadMore.astro'; + +StudioCMS Integration Konfigurationsoptionen Schema Referenz. + +```ts twoslash title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + overrides: { + CustomImageOverride: 'src/components/CustomImage.astro', + FormattedDateOverride: 'src/components/FormattedDate.astro', + }, +}); +``` + +## `CustomImageOverride` + +`CustomImageOverride` ist eine Zeichenkette, der verwendet wird, um den Pfad zur benutzerdefinierten Bildkomponente zu bestimmen. + +- **Typ:** `string` +- **Standard:** `undefined` + +### Verwendung + +```ts twoslash {3} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + overrides: { + CustomImageOverride: 'src/components/CustomImage.astro', + }, +}) +``` + +## `FormattedDateOverride` + +`FormattedDateOverride` ist eine Zeichenkette, der verwendet wird, um den Pfad zur benutzerdefinierten Datumskomponente zu bestimmen. + +- **Typ:** `string` +- **Standard:** `undefined` + +### Verwendung + +```ts twoslash {3} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + overrides: { + FormattedDateOverride: 'src/components/FormattedDate.astro', + }, +}) +``` + +### Standard-Komponente + +```astro title="FormattedDate.astro" +--- +import config from 'studiocms:config'; + +interface Props { + date: Date; +} + +const datetime = Astro.props.date.toISOString(); +const formattedDate = Astro.props.date.toLocaleDateString(config.dateLocale, config.dateTimeFormat); +--- + + +``` \ No newline at end of file diff --git a/src/content/docs/de/config-reference/sdk.mdx b/src/content/docs/de/config-reference/sdk.mdx new file mode 100644 index 00000000..cb585478 --- /dev/null +++ b/src/content/docs/de/config-reference/sdk.mdx @@ -0,0 +1,43 @@ +--- +i18nReady: true +title: SDK +description: Referenzseite für StudioCMSOptions sdk +sidebar: + order: 8 +--- + +import ReadMore from '~/components/ReadMore.astro'; + +StudioCMS Integration Konfigurationsoptionen Schema Referenz. + +```ts twoslash title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + sdk: { + cacheConfig: {}, + }, +}); +``` + +## `cacheConfig` + +`cacheConfig` ist ein Objekt, das verwendet wird, um den Cache für das SDK zu konfigurieren. + +- **Typ:** `boolean` | `{ lifetime?: string | undefined; }` | `undefined` +- **Standard:** `{}` + +### Verwendung + +```ts twoslash {3} title="studiocms.config.mjs" +import { defineStudioCMSConfig } from 'studiocms/config'; +// ---cut--- +export default defineStudioCMSConfig({ + sdk: { + // STANDARD - Hier wird die Standard-Cache-Konfiguration verwendet. + cacheConfig: { + lifetime: '5m', + }, + } +}) +``` \ No newline at end of file diff --git a/src/content/docs/de/contributing/code-contributions.mdx b/src/content/docs/de/contributing/code-contributions.mdx new file mode 100644 index 00000000..9e12e093 --- /dev/null +++ b/src/content/docs/de/contributing/code-contributions.mdx @@ -0,0 +1,63 @@ +--- +i18nReady: true +title: Code-Beiträge +description: Erfahre, wie du zu StudioCMS beitragen kannst +sidebar: + order: 2 +--- + +import { Steps } from '@astrojs/starlight/components'; + +In diesem Leitfaden erhältst du einen Überblick über den Beitrags-Workflow vom Eröffnen eines Problems über das Erstellen eines PRs bis hin zum Überprüfen und Zusammenführen des PRs. + +Wenn du Code zu diesem Projekt beitragen möchtest, befolge bitte die folgenden Schritte: + +## Löse ein Problem + +Durchsuche unsere [bestehenden Issues](https://github.com/withstudiocms/studiocms/issues), um eine zu finden, die dich interessiert. Du kannst die Suche eingrenzen, indem du `labels` als Filter verwendest. Wenn du ein Problem findest, an dem du arbeiten möchtest, kannst du gerne einen PR mit einer Lösung eröffnen. + +## Änderungen vornehmen + + +1. Forke das Repository. + - GitHub Desktop verwenden: + - [Erste Schritte mit GitHub Desktop](https://docs.github.com/de/desktop/overview/getting-started-with-github-desktop) führt dich durch die Einrichtung von Desktop. + - Sobald der Desktop eingerichtet ist, kannst du ihn benutzen, um [das Repo zu forken](https://docs.github.com/de/desktop/adding-and-cloning-repositories/cloning-and-forking-repositories-from-github-desktop)! + + - Benutze die Kommandozeile: + - [Forke das Repo](https://docs.github.com/de/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo#fork-an-example-repository), damit du deine Änderungen vornehmen kannst, ohne das ursprüngliche Projekt zu beeinflussen, bis du sie zusammenführen kannst. + +2. Installiere oder aktualisiere **Node.js** und **pnpm**, auf die Versionen, die in [`.prototools`](https://github.com/withstudiocms/studiocms/blob/main/.prototools) definiert sind. + +3. Erstelle einen Branch und beginne mit deinen Änderungen! + +4. Schreibe Tests für deine Änderungen, falls zutreffend. + +5. Aktualisiere die Dokumentation, falls nötig. + + +## Commite deine Änderungen + +Commite die Änderungen, wenn du mit ihnen zufrieden bist. + +## Pull Request + +Wenn du mit den Änderungen fertig bist, erstelle einen Pull Request, auch PR genannt. +- FFülle die Vorlage „Bereit zur Überprüfung“ aus, damit wir deinen PR überprüfen können. Diese Vorlage hilft den Prüfern, deine Änderungen und den Zweck deines Pull Requests zu verstehen. +- Vergiss nicht, [PR zum Issue](https://docs.github.com/de/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue) zu verknüpfen, wenn du eine Aufgabe löst. +- Aktiviere das Kontrollkästchen [Erlaube Bearbeitungen der Maintainer](https://docs.github.com/de/pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork), damit der Branch für eine Zusammenführung aktualisiert werden kann. +Sobald du deinen PR eingereicht hast, wird ein Mitglied des Docs-Teams deinen Vorschlag prüfen. Wir können Fragen stellen oder zusätzliche Informationen anfordern. +- Wir können um Änderungen bitten, bevor ein PR zusammengeführt werden kann, entweder mit [Änderungsvorschlägen](https://docs.github.com/de/pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork) oder mit Pull Request-Kommentaren. Du kannst die vorgeschlagenen Änderungen direkt über die Benutzeroberfläche übernehmen. Du kannst alle anderen Änderungen in deinem Fork vornehmen und sie dann in deinen Branch übertragen. +- Wenn du deinen PR aktualisierst und Änderungen vornimmst, markiere jede Unterhaltung als [gelöst](https://docs.github.com/de/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request#unterhaltungen-auflösen). +- Wenn du auf Probleme beim Zusammenführen stößt, schau dir diese [Git-Anleitung](https://github.com/skills/resolve-merge-conflicts) an, welche dir hilft, Konflikte beim Zusammenführen und andere Probleme zu lösen. + +## Dein PR wird zusammengeführt! + +Herzlichen Glückwunsch! Das StudioCMS-Team dankt dir. Dein Beitrag wird Teil der nächsten Version sein. + +Jetzt, wo du Teil der StudioCMS-Community bist, kannst du uns helfen, andere PRs zu überprüfen, Fragen zu beantworten und anderen Autoren zu helfen. Wenn du es noch nicht getan hast, melde dich in unserem [Discord](https://chat.studiocms.dev) an, um dich mit anderen Autoren und dem StudioCMS-Team auszutauschen. + +Oh, und du wirst dein Gesicht in der [Liste der Mitwirkenden][contributors] sehen! 🎉 + +{/* Links */} +[contributors]: /de/contributing/getting-started/#unsere-mitwirkenden \ No newline at end of file diff --git a/src/content/docs/de/contributing/getting-started.mdx b/src/content/docs/de/contributing/getting-started.mdx new file mode 100644 index 00000000..38d790e4 --- /dev/null +++ b/src/content/docs/de/contributing/getting-started.mdx @@ -0,0 +1,27 @@ +--- +i18nReady: true +title: Erste Schritte +description: Erfahre, wie du zu StudioCMS beitragen kannst +sidebar: + order: 1 +--- +import ContributorList from '~/components/ContributorList.astro'; + +Danke, dass du deine Zeit in unser Projekt investierst! + +Lies unseren [Verhaltenskodex](https://github.com/withstudiocms/studiocms?tab=coc-ov-file#code-of-conduct-), um unsere Gemeinschaft ansprechbar und respektabel zu halten. + +Wir freuen uns über Beiträge aus der Community! Egal, ob es sich um Bug-Reports, Feature Requests oder Code-Beiträge handelt, wir freuen uns über deine Hilfe, dieses Projekt besser zu machen. Wie du dich in unserer Codebasis zurechtfindest, erfährst du im Abschnitt [Wie es funktioniert][how-it-works]. + +## Unsere Mitwirkenden + +Unser Projekt existiert dank all der Menschen, die dazu beitragen. [Tritt uns auf GitHub bei](https://github.com/withstudiocms/studiocms) und trage dich in die Liste ein! + + + +## Fehlerberichte und Feature Requests + +Wenn du auf einen Fehler stößt oder eine neue Funktion vorschlagen möchtest, eröffne bitte einen Fehler in unserem [GitHub Repository](https://github.com/withstudiocms/studiocms). Wenn du ein neues Problem erstellst, gib bitte so viele Details wie möglich an, einschließlich der Schritte zur Reproduktion des Problems (bei Fehlern) und einer klaren Beschreibung der vorgeschlagenen Funktion. + +{/* Links */} +[how-it-works]: /de/how-it-works/ \ No newline at end of file diff --git a/src/content/docs/de/contributing/translations.mdx b/src/content/docs/de/contributing/translations.mdx new file mode 100644 index 00000000..018792d6 --- /dev/null +++ b/src/content/docs/de/contributing/translations.mdx @@ -0,0 +1,34 @@ +--- +i18nReady: true +title: Übersetzungen +description: Erfahre, wie du bei der Übersetzung von StudioCMS helfen kannst +sidebar: + order: 2 + badge: + text: Demnächst + variant: note +--- + +import ReadMore from '~/components/ReadMore.astro'; + +StudioCMS ist ein globales Projekt, und wir wollen es für alle zugänglich machen. Wenn du mehrere Sprachen fließend beherrschst, kannst du uns helfen, StudioCMS in deine Sprache zu übersetzen. + +## Dashboard-i18n + +Aktueller Stand der Übersetzung + +Status der Übersetzung + +Besuche [unser i18n-Dashboard](https://i18n.studiocms.dev), um die Übersetzung von StudioCMS in deine Sprache zu unterstützen. Wenn deine Sprache nicht aufgeführt ist, kannst du sie im Dashboard hinzufügen. + +Wenn du die Übersetzungen lieber direkt in das Repository einbringen möchtest, werden sie im Verzeichnis [`packages/studiocms/src/lib/i18n/translations`](https://github.com/withstudiocms/studiocms/tree/main/packages/studiocms/src/lib/i18n/translations/) gespeichert. Die englischen Übersetzungen findest du in der Datei [`en-us.json`](https://github.com/withstudiocms/studiocms/blob/main/packages/studiocms/src/lib/i18n/translations/en-us.json). + + +StudioCMS nutzt [Crowdin](https://crowdin.com/) für die Verwaltung von Übersetzungen auf GitHub. Wenn du Crowdin noch nicht kennst, findest du auf der Website von Crowdin den [Leitfaden für Übersetzer](https://support.crowdin.com/for-translators/). + + +Sobald die Übersetzungen hinzugefügt wurden, werden sie zur [StudioCMS i18n-Konfiguration](https://github.com/withstudiocms/studiocms/blob/main/packages/studiocms/src/lib/i18n/index.ts#L8) hinzugefügt und sind in der nächsten Version verfügbar. + +## Dokumentation + +**Bald!** Wir arbeiten daran, die StudioCMS-Dokumentation zu übersetzen. Wenn du daran interessiert bist, uns dabei zu helfen, melde dich bitte bei uns auf [Discord](https://chat.studiocms.dev) diff --git a/src/content/docs/de/how-it-works/cli.mdx b/src/content/docs/de/how-it-works/cli.mdx new file mode 100644 index 00000000..91f1efc4 --- /dev/null +++ b/src/content/docs/de/how-it-works/cli.mdx @@ -0,0 +1,217 @@ +--- +i18nReady: true +title: "Das CLI" +description: "Erfahre mehr über die StudioCMS CLIs und wie du sie benutzt." +sidebar: + order: 2 +--- + +import { Tabs, TabItem } from '@astrojs/starlight/components'; +import ReadMore from '~/components/ReadMore.astro'; + +# Einführung + +Die StudioCMS CLIs sind Dienstprogramme, mit denen du schnell neue StudioCMS-Projekte einrichten und nützliche Dienstprogramme für StudioCMS bereitstellen kannst. +There is two different CLIs that are part of the StudioCMS ecosystem: + +- **`create-studiocms`**: Das StudioCMS-Projektgerüst CLI. +- **`studiocms`**: Das StudioCMS Dienstprogramm CLI. + +Im Folgenden findest du eine Übersicht über die StudioCMS CLI und ihre Komponenten. + +## `create-studiocms` + +### Installation + + + + ```sh + npm create studiocms@latest + ``` + + + ```sh + pnpm create studiocms + ``` + + + ```sh + yarn create studiocms + ``` + + + +`create-studiocms` läuft automatisch im _interaktiven_ Modus, aber du kannst deinen Projektnamen und deine Vorlage auch mit Kommandozeilenargumenten angeben. + + + + ```sh + npm create studiocms@latest -- --template studiocms/basics --project-name my-studiocms-project + ``` + + + ```sh + pnpm create studiocms --template studiocms/basics --project-name my-studiocms-project + ``` + + + ```sh + yarn create studiocms --template studiocms/basics --project-name my-studiocms-project + ``` + + + +[Eine vollständige Liste][templates] findest du auf GitHub. + +Wenn du `--template` verwendest, durchsucht das CLI das Vorlagen-Repository nach allen Ordnern. Die Vorlage `studiocms/basics` verweist zum Beispiel auf das Projekt `basics` im Ordner `studiocms` im Stammverzeichnis des Repositorys. + +### Vollständige CLI Optionen und Befehle + +#### Haupteinstiegspunkt + +```log +Usage: create-studiocms [options] [command] + +Options: + -V, --version Output the current version of the CLI Toolkit. + -h, --help display help for command + --color force color output + --no-color disable color output + +Commands: + get-turso Get the latest version of Turso. + help Show help for command + interactive* Start the interactive CLI. + + * Indicates the default command that is run when calling this CLI. +``` + +#### `get-turso` + +Du kannst die neueste Version von Turso herunterladen und installieren, indem du das Skript aus +Turso's [Dokumentation](https://docs.turso.tech/cli/installation). + +:::note +Windows erfordert die Verwendung von WSL wie bei Turso +::: + +```log +Usage: getTurso [options] + +Turso CLI Installer + +Options: + -h, --help display help for command +``` + +#### Interaktiv (Standardbefehl) + +```log +Usage: create-studiocms interactive [options] + +Start the interactive CLI. Powered by [clack](https://clack.cc). + +This command will open an interactive CLI prompt to guide you through +the process of creating a new StudioCMS(or StudioCMS Ecosystem package) +project using one of the available templates. + +Options: + -t, --template