Skip to content

i18n(ja): Add guides/migrate-to-astro/from-pelican.mdx #11704

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

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
68 changes: 68 additions & 0 deletions src/content/docs/ja/guides/migrate-to-astro/from-pelican.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
---
title: Pelicanからの移行
description: PelicanプロジェクトをAstroに移行するためのガイド
sidebar:
label: Pelican
type: migration
stub: false
framework: Pelican
i18nReady: true
---

import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';

[Pelican](https://getpelican.com)は、Pythonで構築されたオープンソースの静的サイトジェネレーターです。

## PelicanとAstroの類似点

PelicanとAstroには、以下のような共通点があり、移行をスムーズに行えます。

- どちらも[コンテンツ重視のウェブサイト](/ja/concepts/why-astro/#コンテンツ駆動)(例:ブログ)に適した静的サイトジェネレーターです。

- 両者とも[Markdownでの執筆](/ja/guides/markdown-content/)をサポートしており、ページメタデータにYAMLフロントマターを使用できます。Astroでは特別なフロントマターのプロパティが少ないため、PelicanのMarkdownファイルとそのフロントマターをそのまま活用できます。

## 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`構文としても有効です。

- Pelicanにはブログ機能が組み込まれていますが、Astroではそれらを自分で構築する必要があります。もしくは、[公式のブログテーマ](https://github.com/withastro/astro/tree/latest/examples/blog)を使えば、同等の機能をすぐに利用できます。

## PelicanサイトをAstroへ移行する

Pelican製のドキュメントサイトをAstroへ移行するには、[公式Starlightドキュメントテーマ](https://starlight.astro.build)を利用するか、[テーマショーケース](https://astro.build/themes/)から他のドキュメントテーマを選びます。

`create astro`コマンドに`--template`引数を渡すことで、公式スターターを使って新しいAstroプロジェクトを作成できます。また、[GitHub上の既存リポジトリからプロジェクトを開始](/ja/install-and-setup/)することも可能です。

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm create astro@latest -- --template starlight
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm create astro@latest --template starlight
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn create astro --template starlight
```
</Fragment>
</PackageManagerTabs>

既存のMarkdownファイルを[Markdownページとして作成](/ja/guides/markdown-content/)し、Pelicanの`content/`ディレクトリからAstroの`src/pages/`へコピーすることで、[ファイルベースルーティング](/ja/guides/routing/)を活用できます。

Pelicanではレイアウトやメタデータ管理が自動化されていますが、Astroでは[Markdownレイアウトとしてラップする構成](/ja/basics/layouts/#markdownのレイアウト)を自分で組む必要があります。

Astroにも多くの[公式インテグレーション](/ja/guides/integrations-guide/)があり、MDX対応などを追加できます。また、[Astro Integration API](/ja/reference/integrations-reference/)を使えば、自分用のカスタムインテグレーションも作成できます。

ポートフォリオサイトやブログサイトへの移行を検討している場合は、[astro.new](https://astro.new)で他のスターターテンプレートを確認できます。GitHubリポジトリのリンクに加え、IDX・StackBlitz・CodeSandbox・Gitpodで即時起動できるリンクも用意されています。

## コミュニティリソース

:::note[リソースを共有する]
PelicanサイトからAstroへの移行に役立つ動画やブログ記事などを見つけた(または作成した)場合は、ぜひ[こちらのリスト](https://github.com/withastro/docs/edit/main/src/content/docs/ja/guides/migrate-to-astro/from-pelican.mdx)に追加してください!
:::