From 498c0c389cf9b0ca50bbc49ca6a2326e8d05ac19 Mon Sep 17 00:00:00 2001 From: Andreas Deininger Date: Tue, 14 Apr 2026 22:45:04 +0200 Subject: [PATCH 1/3] i18n(de): update deploy guide, deno.mdx --- src/content/docs/de/guides/deploy/deno.mdx | 177 ++++++++++++++++----- 1 file changed, 135 insertions(+), 42 deletions(-) diff --git a/src/content/docs/de/guides/deploy/deno.mdx b/src/content/docs/de/guides/deploy/deno.mdx index df5a7603a87a2..d7ed744a8e918 100644 --- a/src/content/docs/de/guides/deploy/deno.mdx +++ b/src/content/docs/de/guides/deploy/deno.mdx @@ -1,5 +1,5 @@ --- -title: Veröffentliche deine Astro-Website auf Deno +title: Veröffentliche deine Astro-Website mit Deno description: Wie du deine Astro-Webseite mit Deno im Internet veröffentlichst. sidebar: label: Deno Deploy @@ -8,13 +8,13 @@ logo: deno supports: ['ssr', 'static'] i18nReady: true --- - import { Steps } from '@astrojs/starlight/components'; import StaticSsrTabs from '~/components/tabs/StaticSsrTabs.astro'; +import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro' -Du kannst eine serverseitig gerenderte Astro-Seite auf [Deno Deploy](https://deno.com/deploy) veröffentlichen, einem verteilten System, das JavaScript, TypeScript und WebAssembly weltweit ausführt. +Du kannst eine statische oder serverseitig gerenderte Astro-Seite mittels Deno veröffentlichen, entweder auf deinem eigenen Server oder auf [Deno Deploy](https://deno.com/deploy), einem verteilten System, das JavaScript, TypeScript und WebAssembly weltweit ausführt. -Dieser Leitfaden enthält Anweisungen für die Bereitstellung in Deno Deploy über GitHub Actions oder die CLI von Deno Deploy. +Dieser Leitfaden enthält Anweisungen dazu, wie du deine Astro-Site mittels Deno auf deinem eigenen Server betreibst sowie zur Bereitstellung in Deno Deploy über GitHub Actions oder die CLI von Deno Deploy. ## Anforderungen @@ -22,30 +22,36 @@ In dieser Anleitung wird davon ausgegangen, dass du [Deno](https://deno.com/) be ## Projektkonfiguration -Dein Astro-Projekt kann auf [Deno Deploy](https://deno.com/deploy) als statische Website oder als serverseitig gerenderte Website (SSR) bereitgestellt werden. +Dein Astro-Projekt kann als statische Website oder als serverseitig gerenderte Website (SSR) bereitgestellt werden. ### Statische Website -Dein Astro-Projekt ist standardmäßig eine statische Website. Du brauchst keine zusätzliche Konfiguration, um eine statische Astro-Site an Deno Deploy zu übergeben. +Dein Astro-Projekt ist standardmäßig eine statische Website. Du brauchst keine zusätzliche Konfiguration, um eine statische Astro-Site mit Deno zu veröffentlichen oder an Deno Deploy zu übergeben. -### Adapter für SSR +### Adapter für Rendern bei Bedarf (SSR) So aktivierst du SSR in deinem Astro-Projekt und stellst es mit Deno Deploy bereit: -Füge [den Deno-Adapter][Deno adapter] hinzu, um SSR in deinem Astro-Projekt mit dem folgenden Befehl `astro add` zu aktivieren. Damit installierst du den Adapter und nimmst in einem Schritt die entsprechenden Änderungen an deiner Datei `astro.config.mjs` vor. - -```bash -npx astro add deno -``` - -Wenn du den Adapter stattdessen lieber manuell installieren möchtest, führe die folgenden zwei Schritte aus: - -1. Installiere [den `@deno/astro-adapter`-Adapter][Deno adapter] mit deinem bevorzugten Paketmanager als Abhängigkeit deines Projekts. Wenn du npm verwendest oder dir nicht sicher bist, führe dies im Terminal aus: - - ```bash - npm install @deno/astro-adapter - ``` +1. Installiere [den `@deno/astro-adapter`-Adapter][Deno adapter] mit deinem bevorzugten Paketmanager als Abhängigkeit deines Projekts. + + + + ```shell + npm install @deno/astro-adapter + ``` + + + ```shell + pnpm install @deno/astro-adapter + ``` + + + ```shell + yarn add @deno/astro-adapter + ``` + + 2. Aktualisiere deine Projektkonfigurationsdatei `astro.config.mjs` mit den folgenden Änderungen. @@ -60,7 +66,7 @@ Wenn du den Adapter stattdessen lieber manuell installieren möchtest, führe di }); ``` - Als Nächstes aktualisierst du dein `Preview`-Skript in der Datei `package.json` mit der folgenden Änderung. +3. Aktualisiere dein `Preview`-Skript in der Datei `package.json` mit der folgenden Änderung. ```json del={8} ins={9} // package.json @@ -77,15 +83,91 @@ Wenn du den Adapter stattdessen lieber manuell installieren möchtest, führe di ``` Du kannst jetzt diesen Befehl verwenden, um deine Astro-Produktionsseite lokal mit Deno zu überprüfen. - - ```bash - npm run preview - ``` + + + + ```shell + npm run preview + ``` + + + ```shell + pnpm run preview + ``` + + + ```shell + yarn run preview + ``` + + ## Wie man veröffentlicht -Du kannst Deno Deploy über GitHub Actions oder über das Deno Deploy CLI (Command Line Interface) bereitstellen. +Du kannst deine Astro-Site auf deinem eigenen Server betreiben oder auf Deno Deploy über GitHub Actions oder über das Deno Deploy CLI (Command Line Interface) bereitstellen. + +### Auf deinem eigenen Server + + +1. Kopiere dein Projekt auf deinen Server. + +2. Installiere die Abhängigkeiten des Projekts mit deinem bevorzugten Paketmanager: + + + + ```shell + npm install + ``` + + + ```shell + pnpm install + ``` + + + ```shell + yarn + ``` + + + +3. Erstelle deine Astro-Site mit deinem bevorzugten Paketmanager: + + + + ```shell + npm run build + ``` + + + ```shell + pnpm run build + ``` + + + ```shell + yarn run build + ``` + + + +4. Starte deine Applikation mit dem folgenden Befehl: + + + + ```bash + deno run -A jsr:@std/http/file-server dist + ``` + + + + ```bash + deno run -A ./dist/server/entry.mjs + ``` + + + ### GitHub Actions Veröffentlichung @@ -119,7 +201,7 @@ Wenn dein Projekt auf GitHub gespeichert ist, führt dich die [Deno Deploy-Webse steps: - name: Clone repository - uses: actions/checkout@v4 + uses: actions/checkout@v6 # Du benutzt kein npm? Ändere `npm ci` in `yarn install` oder `pnpm i` - name: Install dependencies @@ -156,7 +238,7 @@ Wenn dein Projekt auf GitHub gespeichert ist, führt dich die [Deno Deploy-Webse steps: - name: Clone repository - uses: actions/checkout@v4 + uses: actions/checkout@v6 # Du benutzt kein npm? Ändere `npm ci` in `yarn install` oder `pnpm i` - name: Install dependencies @@ -170,8 +252,7 @@ Wenn dein Projekt auf GitHub gespeichert ist, führt dich die [Deno Deploy-Webse uses: denoland/deployctl@v1 with: project: my-deno-project # TODO: durch Deno Deploy Projektnamen ersetzen - entrypoint: server/entry.mjs - root: dist + entrypoint: dist/server/entry.mjs ``` @@ -190,26 +271,38 @@ Wenn dein Projekt auf GitHub gespeichert ist, führt dich die [Deno Deploy-Webse deno install -gArf jsr:@deno/deployctl ``` -2. Führe deinen Astro-Bauschritt aus. - - ```bash - npm run build - ``` +2. Erstelle deine Astro-Site mit deinem bevorzugten Paketmanager: + + + + ```shell + npm run build + ``` + + + ```shell + pnpm run build + ``` + + + ```shell + yarn run build + ``` + + 3. Führe `deployctl` zum Veröffentlichen aus! - Ersetze im folgenden Befehl `` mit deinem [Personal Access Token](https://dash.deno.com/account#access-tokens) und `` mit deinem Deno Deploy-Projektnamen. - ```bash - cd dist && DENO_DEPLOY_TOKEN= deployctl deploy --project= jsr:@std/http/file-server + cd dist && deployctl deploy jsr:@std/http/file-server ``` ```bash - DENO_DEPLOY_TOKEN= deployctl deploy --project= --no-static --include=./dist ./dist/server/entry.mjs + deployctl deploy ./dist/server/entry.mjs ``` @@ -229,7 +322,7 @@ Wenn dein Projekt auf GitHub gespeichert ist, führt dich die [Deno Deploy-Webse "start": "astro dev", "build": "astro build", "preview": "astro preview", - "deno-deploy": "npm run build && cd dist && deployctl deploy --project= jsr:@std/http/file-server" + "deno-deploy": "npm run build && cd dist && deployctl deploy jsr:@std/http/file-server" } } ``` @@ -244,7 +337,7 @@ Wenn dein Projekt auf GitHub gespeichert ist, führt dich die [Deno Deploy-Webse "start": "astro dev", "build": "astro build", "preview": "deno run --allow-net --allow-read --allow-env ./dist/server/entry.mjs", - "deno-deploy": "npm run build && deployctl deploy --project= --no-static --include=./dist ./dist/server/entry.mjs" + "deno-deploy": "npm run build && deployctl deploy ./dist/server/entry.mjs" } } ``` @@ -254,7 +347,7 @@ Wenn dein Projekt auf GitHub gespeichert ist, führt dich die [Deno Deploy-Webse Dann kannst du diesen Befehl verwenden, um deine Astro-Seite in einem Schritt zu erstellen und veröffentlichen. ```bash - DENO_DEPLOY_TOKEN= npm run deno-deploy + npm run deno-deploy ``` From 85c5e88d492b87e48a236d4e988147f41bc44f95 Mon Sep 17 00:00:00 2001 From: Andreas Deininger Date: Tue, 23 Jun 2026 19:38:13 +0200 Subject: [PATCH 2/3] Apply suggestions from review --- src/content/docs/de/guides/deploy/deno.mdx | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/src/content/docs/de/guides/deploy/deno.mdx b/src/content/docs/de/guides/deploy/deno.mdx index d7ed744a8e918..1f1dc6f6955ba 100644 --- a/src/content/docs/de/guides/deploy/deno.mdx +++ b/src/content/docs/de/guides/deploy/deno.mdx @@ -12,9 +12,9 @@ import { Steps } from '@astrojs/starlight/components'; import StaticSsrTabs from '~/components/tabs/StaticSsrTabs.astro'; import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro' -Du kannst eine statische oder serverseitig gerenderte Astro-Seite mittels Deno veröffentlichen, entweder auf deinem eigenen Server oder auf [Deno Deploy](https://deno.com/deploy), einem verteilten System, das JavaScript, TypeScript und WebAssembly weltweit ausführt. +Du kannst eine statische oder serverseitig gerenderte Astro-Website mittels Deno veröffentlichen, entweder auf deinem eigenen Server oder auf [Deno Deploy](https://deno.com/deploy), einem verteilten System, das JavaScript, TypeScript und WebAssembly weltweit ausführt. -Dieser Leitfaden enthält Anweisungen dazu, wie du deine Astro-Site mittels Deno auf deinem eigenen Server betreibst sowie zur Bereitstellung in Deno Deploy über GitHub Actions oder die CLI von Deno Deploy. +Dieser Leitfaden enthält Anweisungen dazu, wie du deine Astro-Website mittels Deno auf deinem eigenen Server betreibst sowie zur Bereitstellung in Deno Deploy über GitHub Actions oder die CLI von Deno Deploy. ## Anforderungen @@ -26,7 +26,7 @@ Dein Astro-Projekt kann als statische Website oder als serverseitig gerenderte W ### Statische Website -Dein Astro-Projekt ist standardmäßig eine statische Website. Du brauchst keine zusätzliche Konfiguration, um eine statische Astro-Site mit Deno zu veröffentlichen oder an Deno Deploy zu übergeben. +Dein Astro-Projekt ist standardmäßig eine statische Website. Du brauchst keine zusätzliche Konfiguration, um eine statische Astro-Website mit Deno zu veröffentlichen oder an Deno Deploy zu übergeben. ### Adapter für Rendern bei Bedarf (SSR) @@ -105,7 +105,7 @@ So aktivierst du SSR in deinem Astro-Projekt und stellst es mit Deno Deploy bere ## Wie man veröffentlicht -Du kannst deine Astro-Site auf deinem eigenen Server betreiben oder auf Deno Deploy über GitHub Actions oder über das Deno Deploy CLI (Command Line Interface) bereitstellen. +Du kannst deine Astro-Website auf deinem eigenen Server betreiben oder auf Deno Deploy über GitHub Actions oder über das Deno Deploy CLI (Command Line Interface) bereitstellen. ### Auf deinem eigenen Server @@ -132,7 +132,7 @@ Du kannst deine Astro-Site auf deinem eigenen Server betreiben oder auf Deno Dep -3. Erstelle deine Astro-Site mit deinem bevorzugten Paketmanager: +3. Erstelle deine Astro-Website mit deinem bevorzugten Paketmanager: @@ -171,16 +171,16 @@ Du kannst deine Astro-Site auf deinem eigenen Server betreiben oder auf Deno Dep ### GitHub Actions Veröffentlichung -Wenn dein Projekt auf GitHub gespeichert ist, führt dich die [Deno Deploy-Webseite](https://dash.deno.com/) durch die Einrichtung von GitHub-Aktionen für die Bereitstellung deiner Astro-Seite. +Wenn dein Projekt auf GitHub gespeichert ist, führt dich die [Deno Deploy-Webseite](https://dash.deno.com/) durch die Einrichtung von GitHub-Aktionen für die Bereitstellung deiner Astro-Website. 1. Veröffentliche deinen Code in einem öffentlichen oder privaten GitHub-Repository. 2. Melde dich auf [Deno Deploy](https://dash.deno.com/) mit deinem GitHub-Konto an und klicke auf [Neues Projekt](https://dash.deno.com). -3. Wähle dein Repository und den Branch aus, den du bereitstellen möchtest, und wähle den Modus **GitHub Action**. (Deine Astro-Seite benötigt einen Build-Schritt und kann den automatischen Modus nicht verwenden.) +3. Wähle dein Repository und den Branch aus, den du bereitstellen möchtest, und wähle den Modus **GitHub Action**. (Deine Astro-Website benötigt einen Build-Schritt und kann den automatischen Modus nicht verwenden.) -4. Erstelle in deinem Astro-Projekt eine neue Datei unter `.github/workflows/deploy.yml` und füge die unten stehende YAML ein. Diese Datei ähnelt der YAML-Datei von Deno Deploy, mit den zusätzlichen Schritten, die du für deine Astro-Seite benötigst. +4. Erstelle in deinem Astro-Projekt eine neue Datei unter `.github/workflows/deploy.yml` und füge die unten stehende YAML ein. Diese Datei ähnelt der YAML-Datei von Deno Deploy, mit den zusätzlichen Schritten, die du für deine Astro-Website benötigst. @@ -271,7 +271,7 @@ Wenn dein Projekt auf GitHub gespeichert ist, führt dich die [Deno Deploy-Webse deno install -gArf jsr:@deno/deployctl ``` -2. Erstelle deine Astro-Site mit deinem bevorzugten Paketmanager: +2. Erstelle deine Astro-Website mit deinem bevorzugten Paketmanager: @@ -344,7 +344,7 @@ Wenn dein Projekt auf GitHub gespeichert ist, führt dich die [Deno Deploy-Webse - Dann kannst du diesen Befehl verwenden, um deine Astro-Seite in einem Schritt zu erstellen und veröffentlichen. + Dann kannst du diesen Befehl verwenden, um deine Astro-Website in einem Schritt zu erstellen und veröffentlichen. ```bash npm run deno-deploy From b880619a8c633d27d75da970117714f1e2204594 Mon Sep 17 00:00:00 2001 From: Andreas Deininger Date: Tue, 23 Jun 2026 20:53:34 +0200 Subject: [PATCH 3/3] Apply another suggestion from reviewer --- src/content/docs/de/guides/deploy/deno.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/de/guides/deploy/deno.mdx b/src/content/docs/de/guides/deploy/deno.mdx index 1f1dc6f6955ba..b2f94703a031a 100644 --- a/src/content/docs/de/guides/deploy/deno.mdx +++ b/src/content/docs/de/guides/deploy/deno.mdx @@ -66,7 +66,7 @@ So aktivierst du SSR in deinem Astro-Projekt und stellst es mit Deno Deploy bere }); ``` -3. Aktualisiere dein `Preview`-Skript in der Datei `package.json` mit der folgenden Änderung. +3. Aktualisiere dein `preview`-Skript in der Datei `package.json` mit der folgenden Änderung. ```json del={8} ins={9} // package.json