docs: manually re-translate existing ja translations (#4681)

hyshu · felangel · web-flow · commit e51077ce84f5 · 2025-11-20T15:08:14.000-06:00
Co-authored-by: Felix Angelov &lt;felangelov@gmail.com&gt;
diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs
@@ -59,7 +59,7 @@ export default defineConfig({
 								'zh-CN': '快速入门',
 								fa: 'شروع شدن',
 								es: 'Empezando',
-								ja: 'まずはじめに',
+								ja: 'はじめに',
 							},
 						},
 						{
@@ -69,7 +69,7 @@ export default defineConfig({
 								'zh-CN': '为什么用 Bloc?',
 								fa: 'چرا Bloc؟',
 								es: '¿Por qué Bloc?',
-								ja: 'なぜBlocを使う?',
+								ja: 'なぜBloc？',
 							},
 						},
 						{
@@ -79,7 +79,7 @@ export default defineConfig({
 								'zh-CN': 'Bloc 核心概念',
 								fa: 'مفاهیم Bloc',
 								es: 'Conceptos de Bloc',
-								ja: 'Blocコンセプト',
+								ja: 'Blocのコンセプト',
 							},
 						},
 						{
@@ -89,7 +89,7 @@ export default defineConfig({
 								'zh-CN': 'Flutter Bloc 核心概念',
 								fa: 'مفاهیم بلوک فلاتر',
 								es: 'Conceptos de Flutter Bloc',
-								ja: 'Flutter Blocコンセプト',
+								ja: 'Flutter Blocのコンセプト',
 							},
 						},
 						{
@@ -103,7 +103,7 @@ export default defineConfig({
 							translations: {
 								fa: 'وضعیت (State) مدل سازی',
 								es: 'Modelando el Estado',
-								ja: 'モデリング状態',
+								ja: '状態のモデリング',
 							},
 						},
 						{
diff --git a/docs/src/content/docs/ja/getting-started.mdx b/docs/src/content/docs/ja/getting-started.mdx
@@ -1,41 +1,40 @@
 ---
-title: まずはじめに
-description: Blocで構築を開始するために必要なものすべて
+title: はじめに
+description: Blocで開発を始めるためのすべてが揃っています。
 ---
 
 import InstallationTabs from '~/components/getting-started/InstallationTabs.astro';
 import ImportTabs from '~/components/getting-started/ImportTabs.astro';
 
 ## パッケージ
 
-bloc エコシステムは、以下にリストする複数のパッケージで構成されています。
+blocのエコシステムは以下のパッケージで構成されています。
 
-| Package                                                                                    | Description                 | Link                                                                                                           |
-| ------------------------------------------------------------------------------------------ | --------------------------- | -------------------------------------------------------------------------------------------------------------- |
-| [angular_bloc](https://github.com/felangel/bloc/tree/master/packages/angular_bloc)         | AngularDartコンポーネント   | [![pub package](https://img.shields.io/pub/v/angular_bloc.svg)](https://pub.dev/packages/angular_bloc)         |
-| [bloc](https://github.com/felangel/bloc/tree/master/packages/bloc)                         | コアDart API                | [![pub package](https://img.shields.io/pub/v/bloc.svg)](https://pub.dev/packages/bloc)                         |
-| [bloc_concurrency](https://github.com/felangel/bloc/tree/master/packages/bloc_concurrency) | イベントトランスフォーマー  | [![pub package](https://img.shields.io/pub/v/bloc_concurrency.svg)](https://pub.dev/packages/bloc_concurrency) |
-| [bloc_lint](https://github.com/felangel/bloc/tree/master/packages/bloc_lint)               | カスタムリンター            | [![pub package](https://img.shields.io/pub/v/bloc_lint.svg)](https://pub.dev/packages/bloc_lint)               |
-| [bloc_test](https://github.com/felangel/bloc/tree/master/packages/bloc_test)               | APIのテスト                 | [![pub package](https://img.shields.io/pub/v/bloc_test.svg)](https://pub.dev/packages/bloc_test)               |
-| [bloc_tools](https://github.com/felangel/bloc/tree/master/packages/bloc_tools)             | コマンドラインツール        | [![pub package](https://img.shields.io/pub/v/bloc_tools.svg)](https://pub.dev/packages/bloc_tools)             |
-| [flutter_bloc](https://github.com/felangel/bloc/tree/master/packages/flutter_bloc)         | Flutterウィジェット         | [![pub package](https://img.shields.io/pub/v/flutter_bloc.svg)](https://pub.dev/packages/flutter_bloc)         |
-| [hydrated_bloc](https://github.com/felangel/bloc/tree/master/packages/hydrated_bloc)       | キャッシュ/永続性のサポート | [![pub package](https://img.shields.io/pub/v/hydrated_bloc.svg)](https://pub.dev/packages/hydrated_bloc)       |
-| [replay_bloc](https://github.com/felangel/bloc/tree/master/packages/replay_bloc)           | 元に戻す/やり直しのサポート | [![pub package](https://img.shields.io/pub/v/replay_bloc.svg)](https://pub.dev/packages/replay_bloc)           |
+| Package                                                                                    | Description                  | Link                                                                                                           |
+| ------------------------------------------------------------------------------------------ | ---------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| [angular_bloc](https://github.com/felangel/bloc/tree/master/packages/angular_bloc)         | AngularDartコンポーネント    | [![pub package](https://img.shields.io/pub/v/angular_bloc.svg)](https://pub.dev/packages/angular_bloc)         |
+| [bloc](https://github.com/felangel/bloc/tree/master/packages/bloc)                         | コアDart API                 | [![pub package](https://img.shields.io/pub/v/bloc.svg)](https://pub.dev/packages/bloc)                         |
+| [bloc_concurrency](https://github.com/felangel/bloc/tree/master/packages/bloc_concurrency) | イベントのトランスフォーマー | [![pub package](https://img.shields.io/pub/v/bloc_concurrency.svg)](https://pub.dev/packages/bloc_concurrency) |
+| [bloc_lint](https://github.com/felangel/bloc/tree/master/packages/bloc_lint)               | カスタムLinter               | [![pub package](https://img.shields.io/pub/v/bloc_lint.svg)](https://pub.dev/packages/bloc_lint)               |
+| [bloc_test](https://github.com/felangel/bloc/tree/master/packages/bloc_test)               | APIのテスト                  | [![pub package](https://img.shields.io/pub/v/bloc_test.svg)](https://pub.dev/packages/bloc_test)               |
+| [bloc_tools](https://github.com/felangel/bloc/tree/master/packages/bloc_tools)             | コマンドラインツール         | [![pub package](https://img.shields.io/pub/v/bloc_tools.svg)](https://pub.dev/packages/bloc_tools)             |
+| [flutter_bloc](https://github.com/felangel/bloc/tree/master/packages/flutter_bloc)         | Flutterウィジェット          | [![pub package](https://img.shields.io/pub/v/flutter_bloc.svg)](https://pub.dev/packages/flutter_bloc)         |
+| [hydrated_bloc](https://github.com/felangel/bloc/tree/master/packages/hydrated_bloc)       | キャッシュ/永続化のサポート  | [![pub package](https://img.shields.io/pub/v/hydrated_bloc.svg)](https://pub.dev/packages/hydrated_bloc)       |
+| [replay_bloc](https://github.com/felangel/bloc/tree/master/packages/replay_bloc)           | Undo/Redo機能のサポート      | [![pub package](https://img.shields.io/pub/v/replay_bloc.svg)](https://pub.dev/packages/replay_bloc)           |
 
 ## インストール
 
 <InstallationTabs />
 
 :::note
 
-Blocを使って開発を始めるにはまず [Dart SDK](https://dart.dev/get-dart)
+Blocを使って開発を始めるにはまず[Dart SDK](https://dart.dev/get-dart)
 をインストールする必要があります。
 
 :::
 
-## 輸入品
+## importする
 
-bloc が正常にインストールされたので、`main.dart` を作成し、それぞれの `bloc`
-パッケージをインポートできます。
+blocが正常にインストールされたので、`main.dart`を作成し、それぞれの`bloc`パッケージを`import`できます。
 
 <ImportTabs />
diff --git a/docs/src/content/docs/ja/index.mdx b/docs/src/content/docs/ja/index.mdx
@@ -1,21 +1,20 @@
 ---
 template: splash
-title: Bloc 州管理ライブラリ
-description: Bloc状態管理ライブラリの公式ドキュメント。Dart、Flutter、AngularDartをサポートしています。サンプルとチュートリアルが含まれています。.
+title: Bloc 状態管理ライブラリ
+description: 状態管理ライブラリBlocの公式ドキュメントです。Dart、Flutter、AngularDartをサポートしています。サンプルとチュートリアルが含まれています。
 banner:
   content: |
-    ✨ を訪れる
-    <a href="https://shop.bloclibrary.dev">Bloc ショップ</a> ✨
+    ✨ <a href="https://shop.bloclibrary.dev">Blocショップ</a>にアクセス ✨
 editUrl: false
 lastUpdated: false
 hero:
   title: Bloc <sup><span style="font-size:0.4em">v9.1.0</span></sup>
-  tagline: 思い通りに動く Dart の状態管理用ライブラリー
+  tagline: 思い通りに動くDartの状態管理用ライブラリ
   image:
     alt: Bloc logo
     file: ~/assets/bloc.svg
   actions:
-    - text: まずはじめに
+    - text: はじめに
       link: /ja/getting-started/
       variant: primary
       icon: rocket
@@ -33,37 +32,37 @@ import SplitCard from '~/components/landing/SplitCard.astro';
 import Discord from '~/components/landing/Discord.astro';
 
 <SponsorsGrid
-	sponsoredBy="💖 による資金提供"
+	sponsoredBy="💖のあるスポンサーの方々"
 	becomeASponsor="スポンサーになる"
 />
 
 <hr />
 
 <CardGrid>
 
-<SplitCard title="まずはじめに" icon="rocket">
+<SplitCard title="はじめに" icon="rocket">
 	```sh
-	# プロジェクトに bloc を追加します。
+	# プロジェクトにblocを追加します。
 	dart pub add bloc
 	```
-弊社の[はじめに](/ja/getting-started)ガイドには、わずか数分でBlocを使い始める方法がステップバイステップで説明されています。
+[はじめに](/ja/getting-started)では、数分でBlocを使い始められるようになるための方法が順番に解説されています。
 
 </SplitCard>
 
-<Card title="ガイド付きツアーに参加する" icon="star">
-	[公式チュートリアル](/ja/tutorials/flutter-counter)を完了してベストプラクティスを学び、Bloc
-	を利用したさまざまなアプリを構築してください。
+<Card title="ガイド付きツアーに参加" icon="star">
+	[公式チュートリアル](/ja/tutorials/flutter-counter)でベストプラクティスを学び、
+	Blocを利用したさまざまなアプリを作成してみましょう。
 </Card>
 
 <Card title="Blocで構築" icon="laptop">
-	カウンター、タイマー、無限リスト、天気、ToDo など、高品質で完全にテストされた
-	[サンプル アプリ](https://github.com/felangel/bloc/tree/master/examples)
-	を探索しましょう。
+	カウンター、タイマー、無限にスクロール可能なリスト、天気、ToDoなど、完全にテストされた高品質な
+	[サンプルアプリ](https://github.com/felangel/bloc/tree/master/examples)
+	をご覧ください！
 </Card>
 
 <ListCard title="学ぶ" icon="open-book">
 
-    - [なぜBlocを使う?](/ja/why-bloc)
+    - [なぜBloc？](/ja/why-bloc)
     - [基本的なコンセプト](/ja/bloc-concepts)
     - [アーキテクチャー](/ja/architecture)
     - [テスト](/ja/testing)
@@ -73,10 +72,10 @@ import Discord from '~/components/landing/Discord.astro';
 </ListCard>
 
   <ListCard title="拡張機能" icon="puzzle">
-    - [VSCode 拡張機能](https://marketplace.visualstudio.com/items?itemName=FelixAngelov.bloc)
-    - [IntelliJ 拡張機能](https://plugins.jetbrains.com/plugin/12129-bloc)
-    - [Neovim 拡張機能](https://github.com/wa11breaker/flutter-bloc.nvim)
-    - [Mason 拡張機能](https://github.com/felangel/bloc/blob/master/bricks/README.md)
+    - [VSCode拡張機能](https://marketplace.visualstudio.com/items?itemName=FelixAngelov.bloc)
+    - [IntelliJ拡張機能](https://plugins.jetbrains.com/plugin/12129-bloc)
+    - [Neovim拡張機能](https://github.com/wa11breaker/flutter-bloc.nvim)
+    - [Mason拡張機能](https://github.com/felangel/bloc/blob/master/bricks/README.md)
     - [カスタムテンプレート](https://brickhub.dev/search?q=bloc)
     - [開発者ツール](https://github.com/felangel/bloc/blob/master/packages/bloc_tools/README.md)
   </ListCard>
diff --git a/docs/src/content/docs/ja/why-bloc.mdx b/docs/src/content/docs/ja/why-bloc.mdx
@@ -1,35 +1,37 @@
 ---
-title: なぜBlocを使う?
-description: Bloc がソリッド ステート管理ソリューションとなる理由の概要。
+title: なぜBloc？
+description: Blocが優れた状態管理手法である理由を解説しています。
 sidebar:
   order: 1
 ---
 
-BlocはUI側のコードとビジネスロジックを分け、 _素早く_, _楽にテストし_, そして
-*再利用しやすく*してくれます。
+Blocはプレゼンテーション層からビジネスロジックを簡単に分離できるので、コードが*高速で*、_テストしやすく_、
+*再利用可能に*なります。
 
-プロダクション用のアプリケーションを作るときは状態管理がとても大切になってきます。
+本番環境向けのアプリケーション開発において、状態管理は非常に重要です。
 
-開発者としては：
+開発者としては
 
-- いつアプリケーションがどの状態にあるかを知りたい
-- 簡単に全てのケースにおいて正しく挙動しているかをテストしたい
-- データを元にプロダクトの開発判断ができるようにユーザーがアプリケーションで何をしているかを一つ残らず把握したい
-- 特定のアプリケーションのコンポーネントをほかのアプリケーションでも再利用して効率よく開発をしたい
-- 大人数の開発者でも同じ開発パターンに基づき一つのコードベースを構築したい
-- サクサク動くリアクティブアプリケーションを開発したい
+- アプリケーションの状態を常に把握したい
+- 全てのケースにおいて正しく動作しているかを簡単にテストしたい
+- アプリケーション内でユーザーが行った操作を全て記録し、データに基づいた意思決定を可能にしたい
+- 特定のアプリケーションのコンポーネントを再利用することで、ほかのアプリケーションでも効率よく開発をしたい
+- 大勢が携わる開発でも同じパターンとルールに従って、単一のコードベースでもシームレスに作業したい
+- サクサク動くリアクティブなアプリケーションを開発したい
+
+ですよね。
 
 Blocはそんなニーズに応えるために開発されました。
 
-世の中には多数の状態管理用のソリューションがあり、どれを使うか判断するのは大変ですよね。
+世の中には多数の状態管理手法があり、どれを使うか判断するのは大変です。
 
-Blocはこれら３つのコアバリューを元に作成されました：
+Blocは以下の三つのコアバリューを元に作成されました。
 
 - シンプル
-  - 簡単に使え、開発者のレベルを問わずに使ってもらえる。
+  - 簡単に使え、開発者の技術レベルを問わず使ってもらえる
 - パワフル
-  - 大きく複雑なアプリケーションを小さなコンポーネントに分けることで質の高いアプリケーションを作る。
-- 可テスト性
-  - 品質に自信を持って開発できるようにアプリケーションを構築する全ての要素をテストできるようにする。
+  - 複雑なアプリケーションを小さなコンポーネントに分けることで、高品質なアプリケーションを作ることが出来る
+- テストのしやすさ
+  - 品質に自信を持って開発を進められるように、アプリケーションを構築する全ての要素を簡単にテストできるようにする
 
-Blocは状態変化がいつどのように起こるかを定義、制限することで状態変化をわかりやすくしてくれます。
+まとめると、Blocは状態変化のタイミングを制御し、アプリケーション全体で統一された方法で状態を管理することで、状態の変化を予測可能にします。
