Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Sync beta docs #9424

Merged
merged 10 commits into from
Sep 17, 2024
6 changes: 3 additions & 3 deletions src/content/docs/de/guides/deploy/deno.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -29,18 +29,18 @@ npx astro add deno

Wenn du den Adapter stattdessen lieber manuell installieren möchtest, führe die folgenden zwei Schritte aus:

1. Installiere [den `@astrojs/deno`-Adapter](https://github.com/withastro/astro/tree/main/packages/integrations/deno) mit deinem bevorzugten Paketmanager als Abhängigkeit deines Projekts. Wenn du npm verwendest oder dir nicht sicher bist, führe dies im Terminal aus:
1. Installiere [den `@deno/astro-adapter`-Adapter](https://github.com/withastro/astro/tree/main/packages/integrations/deno) 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 @astrojs/deno
npm install @deno/astro-adapter
```

1. Aktualisiere deine Projektkonfigurationsdatei `astro.config.mjs` mit den folgenden Änderungen.

```js ins={3,6-7}
// astro.config.mjs
import { defineConfig } from 'astro/config';
import deno from '@astrojs/deno';
import deno from '@deno/astro-adapter';

export default defineConfig({
output: 'server',
Expand Down
2 changes: 2 additions & 0 deletions src/content/docs/en/getting-started.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,8 @@ hero:
tagline: Powered by Astro and our open-source contributors.
linkText: Join us!
link: /en/contribute/
banner:
content: Want to try Astro 5 beta? Read our <a href="https://5-0-0-beta.docs.astro.build/en/guides/upgrade-to/v5/">v5 upgrade guide</a>!
---

import { CardGrid } from '@astrojs/starlight/components'
Expand Down
2 changes: 2 additions & 0 deletions src/content/docs/en/guides/content-collections.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@ description: >-
Content collections help organize your Markdown and type-check your
frontmatter with schemas.
i18nReady: true
banner:
content: Want to try the new content collections? <a href="https://5-0-0-beta.docs.astro.build/en/guides/upgrade-to/v5/">Upgrade to the v5 beta</a>!
---
import { FileTree } from '@astrojs/starlight/components';
import Since from '~/components/Since.astro'
Expand Down
6 changes: 3 additions & 3 deletions src/content/docs/en/guides/deploy/deno.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -34,18 +34,18 @@ npx astro add deno
If you prefer to install the adapter manually instead, complete the following two steps:

<Steps>
1. Install [the `@astrojs/deno` adapter][Deno adapter] to your project’s dependencies using your preferred package manager. If you’re using npm or aren’t sure, run this in the terminal:
1. Install [the `@deno/astro-adapter` adapter][Deno adapter] to your project’s dependencies using your preferred package manager. If you’re using npm or aren’t sure, run this in the terminal:

```bash
npm install @astrojs/deno
npm install @deno/astro-adapter
```

2. Update your `astro.config.mjs` project configuration file with the changes below.

```js ins={3,6-7}
// astro.config.mjs
import { defineConfig } from 'astro/config';
import deno from '@astrojs/deno';
import deno from '@deno/astro-adapter';

export default defineConfig({
output: 'server',
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/en/guides/integrations-guide/deno.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: '@astrojs/deno'
title: '@deno/astro-adapter'
description: The Deno Astro adapter
i18nReady: true
---
Expand Down
6 changes: 6 additions & 0 deletions src/content/docs/en/upgrade-astro.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
title: Upgrade Astro
description: Learn how to upgrade Astro
i18nReady: true
banner:
content: Want to upgrade to Astro 5 beta? Read our <a href="https://5-0-0-beta.docs.astro.build/en/guides/upgrade-to/v5/">v5 upgrade guide</a>!
---
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
import Version from '~/components/Version.astro';
Expand Down Expand Up @@ -105,6 +107,10 @@ The main Astro documentation pages are always **accurate for the latest released

See the upgrade guides below for an explanation of changes, comparing the new version to the old. The upgrade guides include everything that could require you to change your own code: breaking changes, deprecations, feature removals and replacements as well as updated usage guidance. Each change to Astro includes a "What should I do?" section to help you successfully update your project code.

:::tip
Want to upgrade to the v5 beta? Check out the [v5 upgrade guide in the beta docs](https://5-0-0-beta.docs.astro.build/en/guides/upgrade-to/v5/).
:::

- [Upgrade to v4](/en/guides/upgrade-to/v4/)
- [Upgrade to v3](/en/guides/upgrade-to/v3/)
- [Upgrade to v2](/en/guides/upgrade-to/v2/)
Expand Down
6 changes: 3 additions & 3 deletions src/content/docs/es/guides/deploy/deno.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -35,18 +35,18 @@ npx astro add deno
Si prefieres instalar el adaptador manualmente, sigue los siguientes dos pasos:

<Steps>
1. Añadir [el adaptador `@astrojs/deno`][Deno adapter] a las dependencias de tu proyecto usando tu gestor de paquetes preferido. Si estás usando npm o no estás seguro, ejecuta esto en la terminal:
1. Añadir [el adaptador `@deno/astro-adapter`][Deno adapter] a las dependencias de tu proyecto usando tu gestor de paquetes preferido. Si estás usando npm o no estás seguro, ejecuta esto en la terminal:

```bash
npm install @astrojs/deno
npm install @deno/astro-adapter
```

2. Actualiza el archivo de configuración del proyecto `astro.config.mjs` con los cambios a continuación.

```js ins={3,6-7}
// astro.config.mjs
import { defineConfig } from 'astro/config';
import deno from '@astrojs/deno';
import deno from '@deno/astro-adapter';

export default defineConfig({
output: 'server',
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/es/guides/integrations-guide/deno.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: '@astrojs/deno'
title: '@deno/astro-adapter'
description: El adaptador Deno para Astro
i18nReady: true
---
Expand Down
6 changes: 3 additions & 3 deletions src/content/docs/fr/guides/deploy/deno.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -34,18 +34,18 @@ npx astro add deno
Si vous préférez installer l'adaptateur manuellement, suivez les deux étapes suivantes :

<Steps>
1. Installez [l'adaptateur `@astrojs/deno`][Deno adapter] aux dépendances de votre projet en utilisant votre gestionnaire de paquets préféré. Si vous utilisez npm ou si vous n'êtes pas sûr, exécutez ceci dans le terminal :
1. Installez [l'adaptateur `@deno/astro-adapter`][Deno adapter] aux dépendances de votre projet en utilisant votre gestionnaire de paquets préféré. Si vous utilisez npm ou si vous n'êtes pas sûr, exécutez ceci dans le terminal :

```bash
npm install @astrojs/deno
npm install @deno/astro-adapter
```

2. Mettez à jour votre fichier de configuration du projet `astro.config.mjs` avec les changements ci-dessous.

```js ins={3,6-7}
// astro.config.mjs
import { defineConfig } from 'astro/config';
import deno from '@astrojs/deno';
import deno from '@deno/astro-adapter';

export default defineConfig({
output: 'server',
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/fr/guides/integrations-guide/deno.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: '@astrojs/deno'
title: '@deno/astro-adapter'
description: L'adaptateur Deno Astro
i18nReady: true
---
Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/fr/reference/configuration-reference.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -1700,7 +1700,7 @@ const countries = defineCollection({
export const collections = { countries };
```

Pour une logique de chargement plus avancée, vous pouvez définir un chargeur d'objets. Cela permet des mises à jour incrémentielles et un chargement conditionnel tout en offrant un accès complet au magasin de données. Consultez l'API dans [la RFC de l'API Content Layer](https://github.com/withastro/roadmap/blob/content-layer/proposals/0047-content-layer.md#loaders).
Pour une logique de chargement plus avancée, vous pouvez définir un chargeur d'objets. Cela permet des mises à jour incrémentielles et un chargement conditionnel tout en offrant un accès complet au magasin de données. Consultez l'API dans [la RFC de l'API Content Layer](https://github.com/withastro/roadmap/blob/content-layer/proposals/0050-content-layer.md#loaders).

#### Migration d'une collection de contenu existante pour utiliser l'API Content Layer

Expand Down Expand Up @@ -1765,4 +1765,4 @@ Vous pouvez convertir une collection de contenu existante avec des entrées Mark

#### En savoir plus

Pour retrouver une présentation complète et la référence détaillée de l'API, consultez [le RFC de l'API de la couche de contenu](https://github.com/withastro/roadmap/blob/content-layer/proposals/0047-content-layer.md) et [partagez vos commentaires](https://github.com/withastro/roadmap/pull/982).
Pour retrouver une présentation complète et la référence détaillée de l'API, consultez [le RFC de l'API de la couche de contenu](https://github.com/withastro/roadmap/blob/content-layer/proposals/0050-content-layer.md) et [partagez vos commentaires](https://github.com/withastro/roadmap/pull/982).
6 changes: 3 additions & 3 deletions src/content/docs/it/guides/deploy/deno.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,18 +32,18 @@ npx astro add deno

Se vuoi installare l'adapter manualmente segui i seguienti passaggi:

1. Installa [l'adapter `@astrojs/deno`][Deno adapter] nel tuo progetto come dipendenza utilizzando il tuo package manager preferito. Se stai usando npm o non lo sai avvia questo comando nel terminale:
1. Installa [l'adapter `@deno/astro-adapter`][Deno adapter] nel tuo progetto come dipendenza utilizzando il tuo package manager preferito. Se stai usando npm o non lo sai avvia questo comando nel terminale:

```bash
npm install @astrojs/deno
npm install @deno/astro-adapter
```

1. Modifica il tuo file `astro.config.mjs` con le modifiche sottostanti.

```js ins={3,6-7}
// astro.config.mjs
import { defineConfig } from 'astro/config';
import deno from '@astrojs/deno';
import deno from '@deno/astro-adapter';

export default defineConfig({
output: 'server',
Expand Down
6 changes: 3 additions & 3 deletions src/content/docs/ja/guides/deploy/deno.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,18 +32,18 @@ npx astro add deno

アダプターを手動でインストールする場合は、以下の2つのステップを実行してください。

1. お好みのパッケージマネージャを使用して、[`@astrojs/deno`アダプター][Deno adapter]をプロジェクトの依存関係にインストールします。npmを使用している、またはよくわからない場合は、ターミナルで以下のコマンドを実行してください。
1. お好みのパッケージマネージャを使用して、[`@deno/astro-adapter`アダプター][Deno adapter]をプロジェクトの依存関係にインストールします。npmを使用している、またはよくわからない場合は、ターミナルで以下のコマンドを実行してください。

```bash
npm install @astrojs/deno
npm install @deno/astro-adapter
```

1. プロジェクトの設定ファイル`astro.config.mjs`を以下のように変更します。

```js ins={3,6-7}
// astro.config.mjs
import { defineConfig } from 'astro/config';
import deno from '@astrojs/deno';
import deno from '@deno/astro-adapter';

export default defineConfig({
output: 'server',
Expand Down
8 changes: 4 additions & 4 deletions src/content/docs/ko/guides/deploy/deno.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -34,18 +34,18 @@ npx astro add deno
대신 어댑터를 수동으로 설치하려면 다음 두 단계를 완료하세요.

<Steps>
1. 선호하는 패키지 관리자를 사용하여 프로젝트의 종속성에 [`@astrojs/deno` 어댑터][Deno adapter]를 설치합니다. npm을 사용 중이거나 확실하지 않은 경우 터미널에서 다음을 실행하세요.
1. 선호하는 패키지 관리자를 사용하여 프로젝트의 종속성에 [`@deno/astro-adapter` 어댑터][Deno adapter]를 설치합니다. npm을 사용 중이거나 확실하지 않은 경우 터미널에서 다음을 실행하세요.

```bash
npm install @astrojs/deno
npm install @deno/astro-adapter
```

2. `astro.config.mjs` 프로젝트 구성 파일을 아래 변경 사항으로 업데이트하세요.

```js ins={3,6-7}
// astro.config.mjs
import { defineConfig } from 'astro/config';
import deno from '@astrojs/deno';
import deno from '@deno/astro-adapter';

export default defineConfig({
output: 'server',
Expand Down Expand Up @@ -180,4 +180,4 @@ GitHub Actions 또는 Deno Deploy의 CLI (명령줄 인터페이스)를 사용

<ReadMore>[Astro의 SSR](/ko/guides/server-side-rendering/)에 대해 자세히 알아보세요.</ReadMore>

[Deno adapter]: https://github.com/denoland/deno-astro-adapter
[Deno adapter]: https://github.com/denoland/deno-astro-adapter
2 changes: 1 addition & 1 deletion src/content/docs/ko/guides/integrations-guide/deno.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: '@astrojs/deno'
title: '@deno/astro-adapter'
description: Deno Astro 어댑터
i18nReady: true
---
Expand Down
12 changes: 6 additions & 6 deletions src/content/docs/ko/guides/markdown-content.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,9 @@ import { Steps } from '@astrojs/starlight/components';

Astro에서는 Markdown으로 콘텐츠를 작성한 다음 `.astro` 컴포넌트에 이를 렌더링할 수 있습니다. 이는 콘텐츠용으로 설계된 친숙한 작성 형식과 Astro의 컴포넌트 구문 및 아키텍처의 유연성을 결합한 것입니다.

:::tip
Markdown에 컴포넌트 및 JSX 표현식을 포함하는 등의 추가 기능을 사용하려면 [`@astrojs/mdx` 통합](/ko/guides/integrations-guide/mdx/)을 추가하여 [MDX](https://mdxjs.com/)로 Markdown 콘텐츠를 작성하세요.
:::

## Markdown 파일 구성하기

Expand Down Expand Up @@ -212,10 +214,6 @@ export default {

### 프로그래밍 방식으로 프런트매터 수정하기

:::note
[콘텐츠 컬렉션](/ko/guides/content-collections/)을 사용하는 경우, ["프런트매터를 Remark로 수정하기"](/ko/guides/content-collections/#프런트매터를-remark로-수정하기)을 참조하세요.
:::

[remark 또는 rehype 플러그인](#markdown-플러그인)을 사용하여 모든 Markdown 및 MDX 파일에 프런트매터 속성을 추가할 수 있습니다.

<Steps>
Expand Down Expand Up @@ -439,6 +437,10 @@ const content = marked.parse(markdown);

## 개별 Markdown 페이지

:::tip
[콘텐츠 컬렉션](/ko/guides/content-collections/)과 [Markdown을 `.astro` 컴포넌트로 가져오기](#동적-jsx-유사-표현식)는 Markdown 렌더링에 더 많은 기능을 제공하며, 대부분의 콘텐츠를 처리하는 데 권장되는 방식입니다. 하지만 `src/pages/`에 파일을 추가하기만 하면 간단한 페이지가 자동으로 생성되는 편리함을 원할 때가 있습니다.
:::

Astro는 `.md` 및 기타 Markdown 파일 유형을 포함하여 [`/src/pages/` 디렉터리 내 지원되는 모든 파일](/ko/basics/astro-pages/#지원되는-페이지-파일)을 페이지로 취급합니다.

이 디렉터리 또는 하위 디렉터리에 파일을 배치하면 파일 경로명을 사용하여 페이지 경로를 자동으로 빌드하고 HTML로 렌더링된 Markdown 콘텐츠가 표시됩니다.
Expand All @@ -460,8 +462,6 @@ It probably isn't styled much, but Markdown does support:
- and more!
```

[콘텐츠 컬렉션](/ko/guides/content-collections/)과 [Markdown을 `.astro` 컴포넌트로 가져오기](#동적-jsx-유사-표현식)는 Markdown 렌더링에 더 많은 기능을 제공하며, 대부분의 콘텐츠를 처리하는 데 권장되는 방식입니다. 하지만 `src/pages/`에 파일을 추가하기만 하면 간단한 페이지가 자동으로 생성되는 편리함을 원할 때가 있습니다.

### 프런트매터 `layout` 속성

Markdown 페이지의 제한된 기능을 지원하기 위해, Astro는 Astro [Markdown 레이아웃 컴포넌트](/ko/basics/layouts/#markdown-레이아웃)에 대한 상대 경로인 특별한 프런트매터 `layout` 속성을 제공합니다. Markdown 파일이 `src/pages/`에 있는 경우 레이아웃 컴포넌트를 생성하고 이 layout 속성에 추가하여 Markdown 콘텐츠 주위에 페이지 셸을 제공하세요.
Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/ko/reference/configuration-reference.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -1777,7 +1777,7 @@ const countries = defineCollection({
export const collections = { countries };
```

더 복잡한 로딩 로직을 위해 객체 로더를 정의할 수 있습니다. 이를 통해 증분 업데이트와 조건부 로딩이 가능해지며, 데이터 저장소에 대한 전체 액세스 권한도 부여할 수 있습니다. [Content Layer API RFC](https://github.com/withastro/roadmap/blob/content-layer/proposals/0047-content-layer.md#loaders)에서 API를 참조하세요.
더 복잡한 로딩 로직을 위해 객체 로더를 정의할 수 있습니다. 이를 통해 증분 업데이트와 조건부 로딩이 가능해지며, 데이터 저장소에 대한 전체 액세스 권한도 부여할 수 있습니다. [Content Layer API RFC](https://github.com/withastro/roadmap/blob/content-layer/proposals/0050-content-layer.md#loaders)에서 API를 참조하세요.

#### Content Layer API를 사용하기 위해 기존 콘텐츠 컬렉션 마이그레이션하기

Expand Down Expand Up @@ -1842,4 +1842,4 @@ export const collections = { countries };

#### 더 알아보기

전체 개요와 전체 API 참조는 [Content Layer API RFC](https://github.com/withastro/roadmap/blob/content-layer/proposals/0047-content-layer.md)를 확인하고 [피드백을 공유하세요](https://github.com/withastro/roadmap/pull/982).
전체 개요와 전체 API 참조는 [Content Layer API RFC](https://github.com/withastro/roadmap/blob/content-layer/proposals/0050-content-layer.md)를 확인하고 [피드백을 공유하세요](https://github.com/withastro/roadmap/pull/982).
6 changes: 3 additions & 3 deletions src/content/docs/pt-br/guides/deploy/deno.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -29,18 +29,18 @@ npx astro add deno

Se você prefere instalar o adaptador manualmente, complete as duas etapas a seguir:

1. Instale [o adaptador `@astrojs/deno`](https://github.com/withastro/astro/tree/main/packages/integrations/deno) nas dependências do seu projeto utilizando seu gerenciador de pacotes de preferência. Se você estiver utilizando npm ou não tiver certeza, execute isso no terminal:
1. Instale [o adaptador `@deno/astro-adapter`](https://github.com/withastro/astro/tree/main/packages/integrations/deno) nas dependências do seu projeto utilizando seu gerenciador de pacotes de preferência. Se você estiver utilizando npm ou não tiver certeza, execute isso no terminal:

```bash
npm install @astrojs/deno
npm install @deno/astro-adapter
```

1. Atualize o arquivo de configuração do seu projeto `astro.config.mjs` com as mudanças abaixo.

```js ins={3,6-7}
// astro.config.mjs
import { defineConfig } from 'astro/config';
import deno from '@astrojs/deno';
import deno from '@deno/astro-adapter';

export default defineConfig({
output: 'server',
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/pt-br/guides/integrations-guide/deno.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: '@astrojs/deno'
title: '@deno/astro-adapter'
description: O adaptador Deno para o Astro
githubIntegrationURL: 'https://github.com/withastro/astro/tree/main/packages/integrations/deno/'
i18nReady: true
Expand Down
Loading
Loading