From b8c65ab314df86723ce546f0578aa13144419a51 Mon Sep 17 00:00:00 2001 From: mochi-yu Date: Sat, 28 Mar 2026 03:34:50 +0900 Subject: [PATCH 1/4] i18n(ja): update migrate guides --- .../guides/migrate-to-astro/from-create-react-app.mdx | 10 ++++------ .../docs/ja/guides/migrate-to-astro/from-eleventy.mdx | 6 +++++- .../docs/ja/guides/migrate-to-astro/from-gatsby.mdx | 2 +- .../docs/ja/guides/migrate-to-astro/from-gitbook.mdx | 10 +++++----- .../docs/ja/guides/migrate-to-astro/from-gridsome.mdx | 2 +- .../docs/ja/guides/migrate-to-astro/from-hugo.mdx | 2 +- .../docs/ja/guides/migrate-to-astro/from-jekyll.mdx | 2 +- .../docs/ja/guides/migrate-to-astro/from-pelican.mdx | 8 +++++--- .../docs/ja/guides/migrate-to-astro/from-sveltekit.mdx | 2 +- .../docs/ja/guides/migrate-to-astro/from-wordpress.mdx | 6 +++--- 10 files changed, 27 insertions(+), 23 deletions(-) diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-create-react-app.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-create-react-app.mdx index 940d7cc185bde..3804ac55e841f 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-create-react-app.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-create-react-app.mdx @@ -22,7 +22,7 @@ Astroの[Reactインテグレーション](/ja/guides/integrations-guide/react/) // CRAプロジェクトのルートAppコンポーネントをインポート import App from '../cra-project/App.jsx'; --- -// クライアントディレクティブでアプリを読み込む + ``` @@ -52,7 +52,7 @@ CRAサイトをAstroで再構築すると、いくつか重要な違いに気づ ## CRAをAstroに組み込む -既存のCRAアプリをAstroでそのまま描画し、段階的に変換していく方法を紹介します。 +既存アプリは、コードをほとんど変えずに新しいAstroプロジェクト内でそのままレンダリングできます。 ### 新しいAstroプロジェクトを作成する @@ -328,9 +328,7 @@ const randomUser = data.results[0]; --- ``` -- `import.meta.glob()`によるローカルファイル取得 -- Collections APIのクエリ: [/ja/guides/content-collections/#コレクションのクエリ](/ja/guides/content-collections/#querying-build-time-collections) -- リモートデータのフェッチ: [/ja/guides/data-fetching/](/ja/guides/data-fetching/) +詳細は[`import.meta.glob()`](/ja/guides/imports/#importmetaglob)によるローカルファイルの読み込み、[コンテンツコレクションのクエリ](/ja/guides/content-collections/#querying-build-time-collections)、[リモートデータの取得](/ja/guides/data-fetching/)のそれぞれのガイドを参照してください。 ### CRAのスタイリングをAstroへ @@ -359,5 +357,5 @@ Tailwindを使う場合は[Tailwind Viteプラグイン](/ja/guides/styling/#tai :::note[共有したいリソースはありますか？] -もし、Create React AppをAstroに移行するのに役立つビデオやブログ記事を見つけた見つけた、**あるいは自分で作成した**役立つ動画やブログ記事があれば、[このリストに追加してください](https://github.com/withastro/docs/edit/main/src/content/docs/ja/guides/migrate-to-astro/from-create-react-app.mdx)。 +もし、Create React AppをAstroに移行するのに役立つビデオやブログ記事を見つけた、**あるいは自分で作成した**役立つ動画やブログ記事があれば、[このリストに追加してください](https://github.com/withastro/docs/edit/main/src/content/docs/ja/guides/migrate-to-astro/from-create-react-app.mdx)。 ::: diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-eleventy.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-eleventy.mdx index 3e3ce8b00516e..8f86dd85e2875 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-eleventy.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-eleventy.mdx @@ -15,11 +15,15 @@ import { Steps, LinkCard, CardGrid } from '@astrojs/starlight/components'; ## EleventyとAstroの類似点 +Eleventy（11ty）とAstroには、移行を助けるいくつかの共通点があります。 + - どちらもモダンなJavaScriptベース(Jamstack)のサイトビルダーです。 - 両者とも[ヘッドレスCMSやAPI、Markdownファイルをデータソース](/ja/guides/data-fetching/)として使用できます。既存コンテンツはそのまま利用可能です。 ## EleventyとAstroの主な相違点 +Eleventy（11ty）のサイトをAstroで再構築すると、いくつか重要な違いに気づくでしょう。 + - Eleventyは多彩なテンプレート言語をサポートしますが、Astroは[Astroコンポーネント](/ja/basics/astro-components/)を中心に、React・Svelte・Vue・Solidなどのフレームワークコンポーネントをオプションで組み込みます。 - Astroは[サイトメタデータも含むすべてのファイルを`src/`ディレクトリ](/ja/basics/project-structure/#src)に置き、[`src/pages/`](/ja/basics/astro-pages/)でファイルベースルーティングを行います。 - 静的アセットは[`public/`フォルダ](/ja/basics/project-structure/#public)に配置し、ビルド時に変換されません。 @@ -53,7 +57,7 @@ EleventyブログをAstroへ移行する場合、まず公式ブログテーマ Eleventyでは複数テンプレート言語で構築できましたが、Astroでは主にAstroコンポーネントをテンプレートとして使用します。UI要素・レイアウト・ページを[Astroのコンポーネント構文](/ja/basics/astro-components/)で記述する方法を確認してください。 -ポートフォリオやドキュメントサイトなど他タイプのサイトを移行する場合は、[astro.new](https://astro.new)にある他のスターターテンプレートも参照すると便利です。各テンプレートのGitHubリポジトリやIDX、StackBlitz、CodeSandbox、Gitpodで開くリンクが用意されています。 +ポートフォリオやドキュメントサイトなど他タイプのサイトを移行する場合は、[astro.new](https://astro.new)にある他のスターターテンプレートも参照すると便利です。各テンプレートのGitHubリポジトリへのリンクや、StackBlitzやCodeSandboxのオンライン開発環境をワンクリックで開けるリンクが用意されています。 ## コミュニティリソース diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-gatsby.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-gatsby.mdx index 3cb4a3d307e4f..c4dd4bd76df22 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-gatsby.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-gatsby.mdx @@ -80,7 +80,7 @@ GatsbyサイトをAstroで再構築する際には、次のような重要な違 次に、既存のGatsbyプロジェクトのファイルを**srcの外側**にある別フォルダーへコピーし、新しいAstroプロジェクトへ移行します。 :::tip -公式スターターテンプレートの一覧は[公式スターターテンプレート](https://astro.new)を参照してください。IDX、StackBlitz、CodeSandbox、またはGitpodで新規プロジェクトを開くためのリンクもあります。 +公式スターターテンプレートの一覧は[公式スターターテンプレート](https://astro.new)を参照してください。StackBlitzやCodeSandboxで新規プロジェクトを開くためのリンクもあります。 ::: ### インテグレーションのインストールする（任意） diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-gitbook.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-gitbook.mdx index 633291cad07b4..8655c7d0bfa3d 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-gitbook.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-gitbook.mdx @@ -16,14 +16,14 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro' GitBookとAstroには、プロジェクト移行を容易にするいくつかの共通点があります。 -- どちらも[Markdown](/ja/guides/markdown-content/)をサポートしています。GitBookの**GitSync**機能を使えば、既存ドキュメントをそのまま移行できます。 +- どちらも[Markdown](/ja/guides/markdown-content/)をサポートしています。GitBookの**Git Sync**機能を使えば、既存ドキュメントをそのまま移行できます。 - どちらも何らかの[ファイルベースルーティング](/ja/guides/routing/)を採用しています。Astroのディレクトリ構造で既存コンテンツを管理しても違和感は少ないでしょう。 ## GitBookとAstroの主な相違点 GitBook DocsからAstroへ移行する際、以下の重要な違いがあります。 -- GitBookサイトはオンラインダッシュボードで編集します。Astroでは[コードエディタ](/ja/editor-setup/)とローカル/クラウドの開発環境でサイトを管理します。 +- GitBookサイトはオンラインダッシュボードで編集します。Astroでは[コードエディタ](/ja/editor-setup/)と開発環境でサイトを管理します。ローカルで開発することも、StackBlitzやCodeSandboxのようなクラウドエディタ/開発環境を選ぶこともできます。 - GitBookはコンテンツをデータベースに保存します。Astroでは各ページをMarkdownやMDXなど**個別ファイル**として[`src/`ディレクトリ](/ja/basics/project-structure/)に配置します。あるいは[CMS](/ja/guides/cms/)と連携してデータを取得することもできます。 - GitBookはMarkdown上に独自構文を追加しています。Astroでは類似構文を持つMarkdocを[Markdocインテグレーション](/ja/guides/integrations-guide/markdoc/)で利用できます。 @@ -55,12 +55,12 @@ Astroプロジェクトを準備したら、GitBookの[Git Sync機能](https:// テンプレートのコンテンツコレクションに直接同期する場合は、`src/content/docs/en`または`src/content/docs`を同期先ディレクトリに指定してください。 -同期完了後、AstroリポジトリにGitBookのコンテンツがコピーされます。今後の衝突を防ぐため、GitSyncは無効化してください。 - :::caution -GitSyncを有効にするときは、必ず優先度を**"GitBook→GitHub"**に設定してください。これによりGitBookのコンテンツがGitHubリポジトリへ同期され、誤って上書きするリスクを防げます。 +Git Syncを有効にするときは、必ず優先度を**"GitBook→GitHub"**に設定してください。これによりGitBookのコンテンツがGitHubリポジトリへ同期され、誤って上書きするリスクを防げます。 ::: +同期完了後、AstroリポジトリにGitBookのコンテンツがコピーされます。今後の衝突を防ぐため、Git Syncは無効化してください。 + ただし、コンテンツをコピーしただけではそのままAstroで利用できません。GitBook特有の構文をAstro互換へ手動で変換する必要があります。 - Astroの[Markdocインテグレーション](/ja/guides/integrations-guide/markdoc/)を使用する場合、拡張子を`.mdoc`に変更します。`.md`や`.mdx`と競合しないための措置です。 diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-gridsome.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-gridsome.mdx index 7d88acd5955d8..951e9aac6167c 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-gridsome.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-gridsome.mdx @@ -61,7 +61,7 @@ Gridsomeのプロジェクト構成はAstroに似ているため、いくつか また、Gridsomeとは異なり、Astroではファイルの読み込みに`import.meta.glob()`を使用するため、ローカルファイルの操作方法も併せて確認してください。 -ポートフォリオサイトやドキュメントサイトなど別タイプのサイトに移行したい場合は、[astro.new](https://astro.new)で他の公式スターターテンプレートを確認してください。GitHubリポジトリへのリンクや、IDX・StackBlitz・CodeSandbox・Gitpodで開くためのワンクリックリンクが用意されています。 +ポートフォリオサイトやドキュメントサイトなど別タイプのサイトに移行したい場合は、[astro.new](https://astro.new)で他の公式スターターテンプレートを確認してください。GitHubリポジトリへのリンクや、StackBlitzやCodeSandboxのオンライン開発環境でワンクリックしてプロジェクトを開けるリンクも用意されています。 ## コミュニティリソース diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-hugo.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-hugo.mdx index 7b88505eff654..f979564715f56 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-hugo.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-hugo.mdx @@ -56,7 +56,7 @@ Markdown（またはMDX）ファイルは、[AstroのMarkdown/MDXページ](/ja/ Markdownファイル内で変数や表現、UIコンポーネントなど動的コンテンツを使用するには、AstroのMDXインテグレーションを追加して[MDXページ](/ja/guides/markdown-content/)へ変換してください。MDXはYAMLとTOMLのフロントマターをサポートしており、ショートコード構文は[MDX構文](https://mdxjs.com/docs/what-is-mdx/#mdx-syntax)に置き換える必要があります（JSX表現やコンポーネントのインポートなど）。 -ポートフォリオサイトやドキュメントサイトなど別のタイプのサイトを移行したい場合は、[astro.new](https://astro.new)で他の公式スターターテンプレートを参照してください。GitHubリポジトリへのリンクや、IDX・StackBlitz・CodeSandbox・Gitpodで開発環境をすぐに立ち上げるためのリンクも用意されています。 +ポートフォリオやドキュメントサイトなど他タイプのサイトを移行する場合は、[astro.new](https://astro.new)にある他のスターターテンプレートも参照すると便利です。各テンプレートのGitHubリポジトリへのリンクや、StackBlitzやCodeSandboxのオンライン開発環境をワンクリックで開けるリンクが用意されています。 ## コミュニティリソース diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-jekyll.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-jekyll.mdx index 4768b92d6ba84..44f61fc55e300 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-jekyll.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-jekyll.mdx @@ -60,7 +60,7 @@ JekyllブログをAstroへ移行するには、[公式ブログスターター AstroにはJekyllのような`permalink`プロパティは存在せず、プレースホルダーも利用できません。既存のURL構造を維持したい場合は、[Astroのルーティングガイド](/ja/guides/routing/)を確認するか、[Netlifyなどのホスティングサービスでリダイレクトを設定](https://docs.netlify.com/routing/redirects/)してください。 -ポートフォリオサイトやドキュメントサイトを移行したい場合は、[astro.new](https://astro.new)のスターターテンプレートをご覧ください。GitHubリポジトリへのリンクや、IDX・StackBlitz・CodeSandbox・Gitpodでの起動リンクも用意されています。 +ポートフォリオサイトやドキュメントサイトを移行したい場合は、[astro.new](https://astro.new)のスターターテンプレートをご覧ください。GitHubリポジトリへのリンクや、StackBlitzやCodeSandboxのオンライン開発環境でワンクリックしてプロジェクトを開けるリンクも用意されています。 ## コミュニティリソース diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-pelican.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-pelican.mdx index 9e7fb716a9384..85caccad8a4e7 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-pelican.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-pelican.mdx @@ -4,7 +4,7 @@ description: PelicanプロジェクトをAstroに移行するためのガイド sidebar: label: Pelican type: migration -stub: false +stub: true framework: Pelican i18nReady: true --- @@ -23,6 +23,8 @@ PelicanとAstroには、以下のような共通点があり、移行をスム ## PelicanとAstroの主な違い +PelicanサイトをAstroで再構築すると、いくつか重要な違いに気づくでしょう。 + - PelicanはMarkdownに加えてreStructuredText（`.rst`）にも対応していますが、Astroでは[MarkdownおよびMDX](/ja/guides/markdown-content/)のみ対応しており、reStructuredTextは非対応です。 - PelicanはHTMLファイルとJinjaテンプレートを使ってレイアウトを構築しますが、AstroはJSX風構文を採用した[`.astro`ファイル](/ja/basics/astro-components/)でテンプレートやコンポーネントを構成します。すべての有効なHTMLは`.astro`構文としても有効です。 @@ -57,9 +59,9 @@ Pelican製のドキュメントサイトをAstroへ移行するには、[公式S Pelicanではレイアウトやメタデータ管理が自動化されていますが、Astroでは[Markdownレイアウトとしてラップする構成](/ja/basics/layouts/#markdownのレイアウト)を自分で組む必要があります。 -Astroにも多くの[公式インテグレーション](/ja/guides/integrations/)があり、MDX対応などを追加できます。また、[Astro Integration API](/ja/reference/integrations-reference/)を使えば、自分用のカスタムインテグレーションも作成できます。 +Astroにも機能を拡張するプラグインが多数あります。MDX対応などは[公式インテグレーション](/ja/guides/integrations/)を参照してください。さらに[Astro Integrations Directory](https://astro.build/integrations/)にはコミュニティがメンテナンスするインテグレーションがたくさん掲載されています。また、[Astro Integration API](/ja/reference/integrations-reference/)を使えば、自分用のカスタムインテグレーションも作成できます。 -ポートフォリオサイトやブログサイトへの移行を検討している場合は、[astro.new](https://astro.new)で他のスターターテンプレートを確認できます。GitHubリポジトリのリンクに加え、IDX・StackBlitz・CodeSandbox・Gitpodで即時起動できるリンクも用意されています。 +ポートフォリオサイトやブログサイトへの移行を検討している場合は、[astro.new](https://astro.new)で他のスターターテンプレートを確認できます。GitHubリポジトリのリンクに加え、StackBlitzやCodeSandboxのオンライン開発環境でワンクリックしてプロジェクトを開けるリンクも用意されています。 ## コミュニティリソース diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-sveltekit.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-sveltekit.mdx index 3d82ef0da86dc..614514d4fd66a 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-sveltekit.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-sveltekit.mdx @@ -60,7 +60,7 @@ SvelteKitブログをAstroに変換するには、[公式のブログテーマ Astroでもファイルベースルーティングやレイアウトコンポーネントの概念はありますが、[Astroのプロジェクト構造](/ja/basics/project-structure/)を事前に確認しておくと、ファイル配置の理解に役立ちます。 -ポートフォリオやドキュメントなど、他の種類のサイトを移行したい場合は、[astro.new](https://astro.new)で公式スターターテンプレートを参照してください。GitHubリポジトリのリンクや、StackBlitz、CodeSandboxといったクラウド開発環境で即座に開けるワンクリックリンクも用意されています。 +ポートフォリオやドキュメントサイトなど他タイプのサイトを移行する場合は、[astro.new](https://astro.new)にある他のスターターテンプレートも参照すると便利です。各テンプレートのGitHubリポジトリへのリンクや、StackBlitzやCodeSandboxのオンライン開発環境をワンクリックで開けるリンクが用意されています。 ## コミュニティリソース diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-wordpress.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-wordpress.mdx index 604a10e62e618..8f484e05d7415 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-wordpress.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-wordpress.mdx @@ -29,9 +29,9 @@ WordPressとAstroには、移行を助けるいくつかの共通点がありま WordPressサイトをAstroで再構築する際には、以下のような違いがあります。 -- WordPressはオンラインダッシュボードで編集を行いますが、Astroでは[コードエディタ](/ja/editor-setup/)と開発環境を使用してサイトを保守します。ローカルでの開発も、IDX、StackBlitz、CodeSandbox、Gitpodのようなクラウドエディタも選べます。 +- WordPressはオンラインダッシュボードで編集を行いますが、Astroでは[コードエディタ](/ja/editor-setup/)と開発環境を使用してサイトを保守します。ローカルでの開発も、StackBlitzやCodeSandboxのようなクラウドエディタも選べます。 - WordPressには豊富なプラグインやテーマのマーケットがあります。Astroにも[インテグレーション](https://astro.build/integrations/)やテーマは存在しますが、多くの機能を自作する必要があるかもしれません。代わりに[機能付きのAstroテーマ](https://astro.build/themes)を選ぶという方法もあります。 -- WordPressはコンテンツをデータベースに保存しますが、Astroでは各ページのコンテンツを[プロジェクトディレクトリ](/ja/basics/project-structure/)内のMarkdownまたはMDXファイルとして保持します。または、[CMSを併用](/ja/guides/cms/)して、データの取得・表示をAstroで行うこともできます。 +- WordPressはコンテンツをデータベースに保存しますが、Astroでは各ページのコンテンツを[プロジェクトディレクトリ](/ja/basics/project-structure/)内のMarkdownまたはMDXファイルとして保持します。または、コンテンツ用の[CMS](/ja/guides/cms/)を選び、既存のWordPressサイトを含めてAstroでデータを取得して表示することもできます。 ## WordPressからAstroへ移行する @@ -63,7 +63,7 @@ WordPressブログをAstroに変換するには、公式のブログテーマス WordPress上のすべての投稿コンテンツを移行したい場合は、[WordPressからMarkdownへのエクスポートツール](https://github.com/lonekorean/wordpress-export-to-markdown)が便利です。もし[大規模サイトをMarkdownに変換する必要がある場合](https://swizec.com/blog/how-to-export-a-large-wordpress-site-to-markdown/)は、結果の調整が必要かもしれません。 -ポートフォリオやドキュメントサイトなど、別の種類のサイトを移行するには、[astro.new](https://astro.new)でスターターテンプレートを探してみてください。GitHubリポジトリへのリンクや、IDX、StackBlitz、CodeSandbox、Gitpodなどでプロジェクトをすぐに開けるリンクもあります。 +ポートフォリオやドキュメントサイトなど他タイプのサイトを移行する場合は、[astro.new](https://astro.new)にある他のスターターテンプレートも参照すると便利です。各テンプレートのGitHubリポジトリへのリンクや、StackBlitzやCodeSandboxのオンライン開発環境をワンクリックで開けるリンクが用意されています。 ## コミュニティリソース From 92946daec01b261ad8d0352f9da49b233f7476fe Mon Sep 17 00:00:00 2001 From: mochi-yu Date: Sat, 28 Mar 2026 03:41:02 +0900 Subject: [PATCH 2/4] i18n(ja): update migrate guide's online resource --- src/content/docs/ja/guides/migrate-to-astro/from-gridsome.mdx | 2 +- src/content/docs/ja/guides/migrate-to-astro/from-jekyll.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-gridsome.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-gridsome.mdx index 951e9aac6167c..0a20504716183 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-gridsome.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-gridsome.mdx @@ -61,7 +61,7 @@ Gridsomeのプロジェクト構成はAstroに似ているため、いくつか また、Gridsomeとは異なり、Astroではファイルの読み込みに`import.meta.glob()`を使用するため、ローカルファイルの操作方法も併せて確認してください。 -ポートフォリオサイトやドキュメントサイトなど別タイプのサイトに移行したい場合は、[astro.new](https://astro.new)で他の公式スターターテンプレートを確認してください。GitHubリポジトリへのリンクや、StackBlitzやCodeSandboxのオンライン開発環境でワンクリックしてプロジェクトを開けるリンクも用意されています。 +ポートフォリオやドキュメントサイトなど他タイプのサイトを移行する場合は、[astro.new](https://astro.new)にある他のスターターテンプレートも参照すると便利です。各テンプレートのGitHubリポジトリへのリンクや、StackBlitzやCodeSandboxのオンライン開発環境をワンクリックで開けるリンクが用意されています。 ## コミュニティリソース diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-jekyll.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-jekyll.mdx index 44f61fc55e300..925592b9e2054 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-jekyll.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-jekyll.mdx @@ -60,7 +60,7 @@ JekyllブログをAstroへ移行するには、[公式ブログスターター AstroにはJekyllのような`permalink`プロパティは存在せず、プレースホルダーも利用できません。既存のURL構造を維持したい場合は、[Astroのルーティングガイド](/ja/guides/routing/)を確認するか、[Netlifyなどのホスティングサービスでリダイレクトを設定](https://docs.netlify.com/routing/redirects/)してください。 -ポートフォリオサイトやドキュメントサイトを移行したい場合は、[astro.new](https://astro.new)のスターターテンプレートをご覧ください。GitHubリポジトリへのリンクや、StackBlitzやCodeSandboxのオンライン開発環境でワンクリックしてプロジェクトを開けるリンクも用意されています。 +ポートフォリオやドキュメントサイトなど他タイプのサイトを移行する場合は、[astro.new](https://astro.new)にある他のスターターテンプレートも参照すると便利です。各テンプレートのGitHubリポジトリへのリンクや、StackBlitzやCodeSandboxのオンライン開発環境をワンクリックで開けるリンクが用意されています。 ## コミュニティリソース From b9fc0aa960381577e9710093f6055e952c85e8bf Mon Sep 17 00:00:00 2001 From: mochi-yu Date: Sat, 28 Mar 2026 17:14:14 +0900 Subject: [PATCH 3/4] =?UTF-8?q?fix:=20=E3=83=AC=E3=83=93=E3=83=A5=E3=83=BC?= =?UTF-8?q?=E5=AF=BE=E5=BF=9C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../docs/ja/guides/migrate-to-astro/from-create-react-app.mdx | 4 ++-- src/content/docs/ja/guides/migrate-to-astro/from-eleventy.mdx | 2 +- src/content/docs/ja/guides/migrate-to-astro/from-gitbook.mdx | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-create-react-app.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-create-react-app.mdx index 3804ac55e841f..4214f1e4a7544 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-create-react-app.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-create-react-app.mdx @@ -52,7 +52,7 @@ CRAサイトをAstroで再構築すると、いくつか重要な違いに気づ ## CRAをAstroに組み込む -既存アプリは、コードをほとんど変えずに新しいAstroプロジェクト内でそのままレンダリングできます。 +既存のアプリは、多くの場合コード変えずに新しいAstroプロジェクト内でそのままレンダリングできます。 ### 新しいAstroプロジェクトを作成する @@ -328,7 +328,7 @@ const randomUser = data.results[0]; --- ``` -詳細は[`import.meta.glob()`](/ja/guides/imports/#importmetaglob)によるローカルファイルの読み込み、[コンテンツコレクションのクエリ](/ja/guides/content-collections/#querying-build-time-collections)、[リモートデータの取得](/ja/guides/data-fetching/)のそれぞれのガイドを参照してください。 +詳細は[`import.meta.glob()`](/ja/guides/imports/#importmetaglob)によるローカルファイルの読み込み、[コンテンツコレクションのクエリ](/ja/guides/content-collections/#querying-build-time-collections)、[リモートデータの取得](/ja/guides/data-fetching/)の各ガイドを参照してください。 ### CRAのスタイリングをAstroへ diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-eleventy.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-eleventy.mdx index 8f86dd85e2875..04d39a2becd06 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-eleventy.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-eleventy.mdx @@ -15,7 +15,7 @@ import { Steps, LinkCard, CardGrid } from '@astrojs/starlight/components'; ## EleventyとAstroの類似点 -Eleventy（11ty）とAstroには、移行を助けるいくつかの共通点があります。 +Eleventy（11ty）とAstroには、移行に役立ついくつかの共通点があります。 - どちらもモダンなJavaScriptベース(Jamstack)のサイトビルダーです。 - 両者とも[ヘッドレスCMSやAPI、Markdownファイルをデータソース](/ja/guides/data-fetching/)として使用できます。既存コンテンツはそのまま利用可能です。 diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-gitbook.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-gitbook.mdx index 8655c7d0bfa3d..da0b1ebde4e5a 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-gitbook.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-gitbook.mdx @@ -59,7 +59,7 @@ Astroプロジェクトを準備したら、GitBookの[Git Sync機能](https:// Git Syncを有効にするときは、必ず優先度を**"GitBook→GitHub"**に設定してください。これによりGitBookのコンテンツがGitHubリポジトリへ同期され、誤って上書きするリスクを防げます。 ::: -同期完了後、AstroリポジトリにGitBookのコンテンツがコピーされます。今後の衝突を防ぐため、Git Syncは無効化してください。 +同期完了後、AstroリポジトリにGitBookのコンテンツがコピーされます。今後GitBookとの同期が行われないようにするために、Git Syncを無効にしてください。 ただし、コンテンツをコピーしただけではそのままAstroで利用できません。GitBook特有の構文をAstro互換へ手動で変換する必要があります。 From b246865324e62194699c82dc7fe32c83cd5b30a6 Mon Sep 17 00:00:00 2001 From: mochi-yu Date: Sat, 28 Mar 2026 20:28:31 +0900 Subject: [PATCH 4/4] i18n(ja): revert unrelated changes --- .../guides/migrate-to-astro/from-create-react-app.mdx | 10 ++++++---- .../docs/ja/guides/migrate-to-astro/from-eleventy.mdx | 4 ---- .../docs/ja/guides/migrate-to-astro/from-gitbook.mdx | 8 ++++---- .../docs/ja/guides/migrate-to-astro/from-pelican.mdx | 4 +--- .../docs/ja/guides/migrate-to-astro/from-sveltekit.mdx | 2 +- .../docs/ja/guides/migrate-to-astro/from-wordpress.mdx | 2 +- 6 files changed, 13 insertions(+), 17 deletions(-) diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-create-react-app.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-create-react-app.mdx index 4214f1e4a7544..940d7cc185bde 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-create-react-app.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-create-react-app.mdx @@ -22,7 +22,7 @@ Astroの[Reactインテグレーション](/ja/guides/integrations-guide/react/) // CRAプロジェクトのルートAppコンポーネントをインポート import App from '../cra-project/App.jsx'; --- - +// クライアントディレクティブでアプリを読み込む ``` @@ -52,7 +52,7 @@ CRAサイトをAstroで再構築すると、いくつか重要な違いに気づ ## CRAをAstroに組み込む -既存のアプリは、多くの場合コード変えずに新しいAstroプロジェクト内でそのままレンダリングできます。 +既存のCRAアプリをAstroでそのまま描画し、段階的に変換していく方法を紹介します。 ### 新しいAstroプロジェクトを作成する @@ -328,7 +328,9 @@ const randomUser = data.results[0]; --- ``` -詳細は[`import.meta.glob()`](/ja/guides/imports/#importmetaglob)によるローカルファイルの読み込み、[コンテンツコレクションのクエリ](/ja/guides/content-collections/#querying-build-time-collections)、[リモートデータの取得](/ja/guides/data-fetching/)の各ガイドを参照してください。 +- `import.meta.glob()`によるローカルファイル取得 +- Collections APIのクエリ: [/ja/guides/content-collections/#コレクションのクエリ](/ja/guides/content-collections/#querying-build-time-collections) +- リモートデータのフェッチ: [/ja/guides/data-fetching/](/ja/guides/data-fetching/) ### CRAのスタイリングをAstroへ @@ -357,5 +359,5 @@ Tailwindを使う場合は[Tailwind Viteプラグイン](/ja/guides/styling/#tai :::note[共有したいリソースはありますか？] -もし、Create React AppをAstroに移行するのに役立つビデオやブログ記事を見つけた、**あるいは自分で作成した**役立つ動画やブログ記事があれば、[このリストに追加してください](https://github.com/withastro/docs/edit/main/src/content/docs/ja/guides/migrate-to-astro/from-create-react-app.mdx)。 +もし、Create React AppをAstroに移行するのに役立つビデオやブログ記事を見つけた見つけた、**あるいは自分で作成した**役立つ動画やブログ記事があれば、[このリストに追加してください](https://github.com/withastro/docs/edit/main/src/content/docs/ja/guides/migrate-to-astro/from-create-react-app.mdx)。 ::: diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-eleventy.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-eleventy.mdx index 04d39a2becd06..2f6ada57ed7df 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-eleventy.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-eleventy.mdx @@ -15,15 +15,11 @@ import { Steps, LinkCard, CardGrid } from '@astrojs/starlight/components'; ## EleventyとAstroの類似点 -Eleventy（11ty）とAstroには、移行に役立ついくつかの共通点があります。 - - どちらもモダンなJavaScriptベース(Jamstack)のサイトビルダーです。 - 両者とも[ヘッドレスCMSやAPI、Markdownファイルをデータソース](/ja/guides/data-fetching/)として使用できます。既存コンテンツはそのまま利用可能です。 ## EleventyとAstroの主な相違点 -Eleventy（11ty）のサイトをAstroで再構築すると、いくつか重要な違いに気づくでしょう。 - - Eleventyは多彩なテンプレート言語をサポートしますが、Astroは[Astroコンポーネント](/ja/basics/astro-components/)を中心に、React・Svelte・Vue・Solidなどのフレームワークコンポーネントをオプションで組み込みます。 - Astroは[サイトメタデータも含むすべてのファイルを`src/`ディレクトリ](/ja/basics/project-structure/#src)に置き、[`src/pages/`](/ja/basics/astro-pages/)でファイルベースルーティングを行います。 - 静的アセットは[`public/`フォルダ](/ja/basics/project-structure/#public)に配置し、ビルド時に変換されません。 diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-gitbook.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-gitbook.mdx index da0b1ebde4e5a..d3464e21d2881 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-gitbook.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-gitbook.mdx @@ -16,7 +16,7 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro' GitBookとAstroには、プロジェクト移行を容易にするいくつかの共通点があります。 -- どちらも[Markdown](/ja/guides/markdown-content/)をサポートしています。GitBookの**Git Sync**機能を使えば、既存ドキュメントをそのまま移行できます。 +- どちらも[Markdown](/ja/guides/markdown-content/)をサポートしています。GitBookの**GitSync**機能を使えば、既存ドキュメントをそのまま移行できます。 - どちらも何らかの[ファイルベースルーティング](/ja/guides/routing/)を採用しています。Astroのディレクトリ構造で既存コンテンツを管理しても違和感は少ないでしょう。 ## GitBookとAstroの主な相違点 @@ -55,12 +55,12 @@ Astroプロジェクトを準備したら、GitBookの[Git Sync機能](https:// テンプレートのコンテンツコレクションに直接同期する場合は、`src/content/docs/en`または`src/content/docs`を同期先ディレクトリに指定してください。 +同期完了後、AstroリポジトリにGitBookのコンテンツがコピーされます。今後の衝突を防ぐため、GitSyncは無効化してください。 + :::caution -Git Syncを有効にするときは、必ず優先度を**"GitBook→GitHub"**に設定してください。これによりGitBookのコンテンツがGitHubリポジトリへ同期され、誤って上書きするリスクを防げます。 +GitSyncを有効にするときは、必ず優先度を**"GitBook→GitHub"**に設定してください。これによりGitBookのコンテンツがGitHubリポジトリへ同期され、誤って上書きするリスクを防げます。 ::: -同期完了後、AstroリポジトリにGitBookのコンテンツがコピーされます。今後GitBookとの同期が行われないようにするために、Git Syncを無効にしてください。 - ただし、コンテンツをコピーしただけではそのままAstroで利用できません。GitBook特有の構文をAstro互換へ手動で変換する必要があります。 - Astroの[Markdocインテグレーション](/ja/guides/integrations-guide/markdoc/)を使用する場合、拡張子を`.mdoc`に変更します。`.md`や`.mdx`と競合しないための措置です。 diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-pelican.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-pelican.mdx index 85caccad8a4e7..0711ca470a570 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-pelican.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-pelican.mdx @@ -4,7 +4,7 @@ description: PelicanプロジェクトをAstroに移行するためのガイド sidebar: label: Pelican type: migration -stub: true +stub: false framework: Pelican i18nReady: true --- @@ -23,8 +23,6 @@ PelicanとAstroには、以下のような共通点があり、移行をスム ## PelicanとAstroの主な違い -PelicanサイトをAstroで再構築すると、いくつか重要な違いに気づくでしょう。 - - PelicanはMarkdownに加えてreStructuredText（`.rst`）にも対応していますが、Astroでは[MarkdownおよびMDX](/ja/guides/markdown-content/)のみ対応しており、reStructuredTextは非対応です。 - PelicanはHTMLファイルとJinjaテンプレートを使ってレイアウトを構築しますが、AstroはJSX風構文を採用した[`.astro`ファイル](/ja/basics/astro-components/)でテンプレートやコンポーネントを構成します。すべての有効なHTMLは`.astro`構文としても有効です。 diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-sveltekit.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-sveltekit.mdx index 614514d4fd66a..3d82ef0da86dc 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-sveltekit.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-sveltekit.mdx @@ -60,7 +60,7 @@ SvelteKitブログをAstroに変換するには、[公式のブログテーマ Astroでもファイルベースルーティングやレイアウトコンポーネントの概念はありますが、[Astroのプロジェクト構造](/ja/basics/project-structure/)を事前に確認しておくと、ファイル配置の理解に役立ちます。 -ポートフォリオやドキュメントサイトなど他タイプのサイトを移行する場合は、[astro.new](https://astro.new)にある他のスターターテンプレートも参照すると便利です。各テンプレートのGitHubリポジトリへのリンクや、StackBlitzやCodeSandboxのオンライン開発環境をワンクリックで開けるリンクが用意されています。 +ポートフォリオやドキュメントなど、他の種類のサイトを移行したい場合は、[astro.new](https://astro.new)で公式スターターテンプレートを参照してください。GitHubリポジトリのリンクや、StackBlitz、CodeSandboxといったクラウド開発環境で即座に開けるワンクリックリンクも用意されています。 ## コミュニティリソース diff --git a/src/content/docs/ja/guides/migrate-to-astro/from-wordpress.mdx b/src/content/docs/ja/guides/migrate-to-astro/from-wordpress.mdx index 8f484e05d7415..375f432369b43 100644 --- a/src/content/docs/ja/guides/migrate-to-astro/from-wordpress.mdx +++ b/src/content/docs/ja/guides/migrate-to-astro/from-wordpress.mdx @@ -31,7 +31,7 @@ WordPressサイトをAstroで再構築する際には、以下のような違い - WordPressはオンラインダッシュボードで編集を行いますが、Astroでは[コードエディタ](/ja/editor-setup/)と開発環境を使用してサイトを保守します。ローカルでの開発も、StackBlitzやCodeSandboxのようなクラウドエディタも選べます。 - WordPressには豊富なプラグインやテーマのマーケットがあります。Astroにも[インテグレーション](https://astro.build/integrations/)やテーマは存在しますが、多くの機能を自作する必要があるかもしれません。代わりに[機能付きのAstroテーマ](https://astro.build/themes)を選ぶという方法もあります。 -- WordPressはコンテンツをデータベースに保存しますが、Astroでは各ページのコンテンツを[プロジェクトディレクトリ](/ja/basics/project-structure/)内のMarkdownまたはMDXファイルとして保持します。または、コンテンツ用の[CMS](/ja/guides/cms/)を選び、既存のWordPressサイトを含めてAstroでデータを取得して表示することもできます。 +- WordPressはコンテンツをデータベースに保存しますが、Astroでは各ページのコンテンツを[プロジェクトディレクトリ](/ja/basics/project-structure/)内のMarkdownまたはMDXファイルとして保持します。または、[CMSを併用](/ja/guides/cms/)して、データの取得・表示をAstroで行うこともできます。 ## WordPressからAstroへ移行する