Skip to content
Merged
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
27 changes: 12 additions & 15 deletions src/content/docs/ja/upgrade-astro.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,21 +2,18 @@
title: Astroのアップグレード
description: Astroのアップグレード方法を学ぶ
i18nReady: true
banner:
content: |
Astro v5 が登場! <a href="/ja/guides/upgrade-to/v5/">サイトのアップグレード方法を学ぶ</a>
---
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
import Version from '~/components/Version.astro';


このガイドでは、Astroや関連する依存関係のバージョンを更新する方法、バージョン間で何が変更されたかを調べる方法、そしてAstroのバージョニングシステムとそれに対応するドキュメントの更新を理解する方法について説明します。

## 変更点は何ですか?

Astroの最新リリースは<Version pkgName="astro" />です。

すべての変更の詳細なリストは[Astroの変更履歴](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md)で確認できます。また、各[メジャーバージョン](#メジャーレベルの変更)へのアップグレードに関する重要な説明は、[アップグレードガイド](#アップグレードガイド)に記載されています。


## 最新バージョンへのアップグレード

パッケージマネージャーを使用して、一つのコマンドでプロジェクトのAstroとすべての公式インテグレーションを最新バージョンに更新します。
Expand All @@ -42,28 +39,27 @@ Astroの最新リリースは<Version pkgName="astro" />です。
</Fragment>
</PackageManagerTabs>


### 手動でのアップグレード

Astroとインテグレーションを手動で現在のバージョンに更新するには、パッケージマネージャーに適したコマンドを使用してください。

<PackageManagerTabs>
<Fragment slot="npm">
```shell
# 例:ReactとTailwindのインテグレーションと共にAstroをアップグレード
npm install astro@latest @astrojs/react@latest @astrojs/tailwind@latest
# 例:ReactとPartytownのインテグレーションと共にAstroをアップグレード
npm install astro@latest @astrojs/react@latest @astrojs/partytown@latest
```
</Fragment>
<Fragment slot="pnpm">
```shell
# 例:ReactとTailwindのインテグレーションと共にAstroをアップグレード
pnpm add astro@latest @astrojs/react@latest @astrojs/tailwind@latest
# 例:ReactとPartytownのインテグレーションと共にAstroをアップグレード
pnpm add astro@latest @astrojs/react@latest @astrojs/partytown@latest
```
</Fragment>
<Fragment slot="yarn">
```shell
# 例:ReactとTailwindのインテグレーションと共にAstroをアップグレード
yarn add astro@latest @astrojs/react@latest @astrojs/tailwind@latest
# 例:ReactとPartytownのインテグレーションと共にAstroをアップグレード
yarn add astro@latest @astrojs/react@latest @astrojs/partytown@latest
```
</Fragment>
</PackageManagerTabs>
Expand All @@ -90,7 +86,6 @@ Astroとインテグレーションを手動で現在のバージョンに更新
</Fragment>
</PackageManagerTabs>


## ドキュメントの更新

このドキュメントは、[マイナーリリース](#マイナーレベルの変更)および[メジャーバージョンリリース](#メジャーレベルの変更)ごとに更新されます。新機能が追加されたり、既存の使用方法が変更されたりすると、ドキュメントは**現在のAstroの挙動**を反映するように更新されます。自分のプロジェクトを更新していない場合、最新のドキュメントと一部の挙動が一致しないことに気づくかもしれません。
Expand All @@ -107,6 +102,7 @@ Astroの主要なドキュメントページは常に**最新リリースバー

以下のアップグレードガイドでは、新旧のバージョンを比較して変更点を説明しています。アップグレードガイドには、破壊的変更や非推奨化、機能の削除や置換、および使用方法の更新ガイダンスなど、コードの変更を必要とする可能性のあるすべての内容が含まれています。Astroへの各変更には「どうすればいいですか?」というセクションが付属しており、プロジェクトコードを上手く更新するための助けとなるはずです。

- [v5へのアップグレード](/ja/guides/upgrade-to/v5/)
- [v4へのアップグレード](/ja/guides/upgrade-to/v4/)
- [v3へのアップグレード](/ja/guides/upgrade-to/v3/)
- [v2へのアップグレード](/ja/guides/upgrade-to/v2/)
Expand All @@ -116,7 +112,8 @@ Astroの主要なドキュメントページは常に**最新リリースバー

古いバージョンのAstroのドキュメントはメンテナンスされていませんが、静的スナップショットとして利用可能です。プロジェクトをアップグレードできないものの、ガイドやリファレンスを参照したい場合は、これらのバージョンのドキュメントを使用してください。

- [メンテナンスされていないv3.6.3のスナップショット](https://docs-git-v3-docs-unmaintained-astrodotbuild.vercel.app/)
- [メンテナンスされていないv4.16.17のスナップショット](https://v4.docs.astro.build/en/getting-started/)
- [メンテナンスされていないv3.6.3のスナップショット](https://web.archive.org/web/20231203051122/https://docs.astro.build/en/getting-started/)
- [メンテナンスされていないv2.10.15のスナップショット](https://deploy-preview-4405--astro-docs-2.netlify.app/en/getting-started/)

## セマンティックバージョニング
Expand All @@ -143,7 +140,6 @@ Astroが「パッチ」バージョンを発行すると、最後の数字が増

パッチ変更には**バグ修正の多く**も含まれます。意図しないまたは望ましくない既存の挙動をユーザーが利用していた場合でも、パッチに含まれます。


### マイナーレベルの変更

マイナーリリースは、主に新機能や改善点を導入するもので、コードの変更を必要としません。ただし、既存の機能が**非推奨**(将来のバージョンで削除される予定であるが、機能は継続)となり、将来削除される予定であることをユーザーに伝えるために使われることもあります。
Expand Down Expand Up @@ -189,6 +185,7 @@ Astroが「パッチ」バージョンを発行すると、最後の数字が増
- AstroはNode.jsの[**最新の _Maintenance_ LTS**バージョン](https://nodejs.org/en/about/previous-releases#release-schedule)をサポートしています。
- AstroはNode.jsの[**現在の _Active_ LTS**バージョン](https://nodejs.org/en/about/previous-releases#release-schedule)をサポートしています。
- AstroはNode.jsの奇数バージョンをサポートしています。

#### アップグレード

次のルールは、AstroがNode.jsのバージョンのサポートを終了、削除、または追加するタイミングを定義します。
Expand Down
Loading