Skip to content

Commit

Permalink
Translated Curating the Editor Experience
Browse files Browse the repository at this point in the history
  • Loading branch information
atachibana committed Dec 16, 2023
1 parent ccf14ad commit 49ebb76
Show file tree
Hide file tree
Showing 8 changed files with 294 additions and 54 deletions.
3 changes: 3 additions & 0 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -313,6 +313,9 @@ Everything you need to know to [start contributing to the block editor](/docs/co

### 主な変更

2023/12/16
- [ユーザーインターフェースの制限](https://ja.wordpress.org/team/handbook/block-editor/how-to-guides/curating-the-editor-experience/) - 翻訳

2023/12/2
- [Gutenberg Release Process](https://ja.wordpress.org/team/handbook/block-editor/contributors/code/release/) - 対象ブランチの説明 [#56183](https://github.com/WordPress/gutenberg/pull/56183)、トラブルシューティング [#56436](https://github.com/WordPress/gutenberg/pull/56436)
- [wp-scripts 入門](https://ja.wordpress.org/team/handbook/block-editor/getting-started/devenv/get-started-with-wp-scripts/) - 例の追加 [#56298](https://github.com/WordPress/gutenberg/pull/56298)
Expand Down
2 changes: 1 addition & 1 deletion docs/getting-started/fundamentals/block-json.md
Original file line number Diff line number Diff line change
Expand Up @@ -145,7 +145,7 @@ _例: ブロックのマークアップ表現として保管された属性_
<!--
These [`attributes`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-edit-save/#attributes) are passed to the React component `Edit`(to display in the Block Editor) and the `save` function (to return the markup saved to the DB) of the block, and to any server-side render definition for the block (see `render` prop above).
-->
これらの [`attributes`](https://ja.wordpress.org/team/handbook/block-editor/reference-guides/block-api/block-edit-save/#%E5%B1%9E%E6%80%A7) は React コンポーネントの `Edit` (ブロックエディターに表示するため)、`save` 関数 (DB に保存されるマークアップを返すため)、そしてブロックの任意のサーバーサイドレンダー定義 (上の `render` プロパティ参照) に渡されます。
これらの [`attributes`](https://ja.wordpress.org/team/handbook/block-editor/reference-guides/block-api/block-edit-save/#%E5%B1%9E%E6%80%A7) は React コンポーネントの `Edit` (ブロックエディターに表示するため)、`save` 関数 (データベース に保存されるマークアップを返すため)、そしてブロックの任意のサーバーサイドレンダー定義 (上の `render` プロパティ参照) に渡されます。

<!--
The `Edit` component receives exclusively the capability of updating the attributes via the [`setAttributes`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-edit-save/#setattributes) function.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ For more on creating a WordPress plugin see <a href="https://developer.wordpress
<!--
[`package.json`](https://docs.npmjs.com/cli/v10/configuring-npm/package-json) is a configuration file for a Node.js project. In this file you define the NPM dependencies of the block and the scripts used for local work.
-->
[`package.json`](https://docs.npmjs.com/cli/v10/configuring-npm/package-json) は Node.js プロジェクトの構成ファイルです。このファイルにはブロックの NPM 依存と、ローカルでの作業に使用するスクリプトを定義します。
[`package.json`](https://docs.npmjs.com/cli/v10/configuring-npm/package-json) は Node.js プロジェクトの構成ファイルです。このファイル内に、ブロックの NPM 依存と、ローカルでの作業に使用するスクリプトを定義します。

<!--
### `src` folder
Expand Down Expand Up @@ -160,7 +160,7 @@ In a standard project, the `build` folder contains the generated files in [the b
<!--
## Additional resources
-->
## 追加のリソース
## その他の情報

<!--
- [Metadata in block.json](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -97,7 +97,7 @@ Use [`enqueue_block_editor_assets`](https://developer.wordpress.org/reference/ho
<!--
## Additional resources
-->
## 追加リソース
## その他の情報

<!--
- [Get started with wp-scripts](https://developer.wordpress.org/block-editor/getting-started/devenv/get-started-with-wp-scripts/)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -191,7 +191,7 @@ _[例](https://github.com/WordPress/block-development-examples/tree/trunk/plugin
<!--
## Additional resources
-->
## 追加リソース
## その他の情報

<!--
- [`register_block_type` PHP function](https://developer.wordpress.org/reference/functions/register_block_type/)
Expand Down
281 changes: 263 additions & 18 deletions docs/how-to-guides/curating-the-editor-experience.md

Large diffs are not rendered by default.

3 changes: 3 additions & 0 deletions docs/japanese-changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,9 @@

翻訳の進捗や、最新の英語版で同期した際に気づいた箇所をメモしています。

2023/12/16
- [ユーザーインターフェースの制限](https://ja.wordpress.org/team/handbook/block-editor/how-to-guides/curating-the-editor-experience/) - 翻訳

2023/12/2
- [Gutenberg Release Process](https://ja.wordpress.org/team/handbook/block-editor/contributors/code/release/) - 対象ブランチの説明 [#56183](https://github.com/WordPress/gutenberg/pull/56183)、トラブルシューティング [#56436](https://github.com/WordPress/gutenberg/pull/56436)
- [wp-scripts 入門](https://ja.wordpress.org/team/handbook/block-editor/getting-started/devenv/get-started-with-wp-scripts/) - 例の追加 [#56298](https://github.com/WordPress/gutenberg/pull/56298)
Expand Down
51 changes: 20 additions & 31 deletions docs/reference-guides/block-api/block-patterns.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,9 @@
# パターン

<!--
Block Patterns are predefined block layouts, ready to insert and tweak.
Block Patterns are predefined block layouts, available from the patterns tab of the block inserter. Once inserted into content, the blocks are ready for additional or modified content and configuration.
-->
ブロックパターンは、あらかじめ定義されたブロックのレイアウトで、挿入して微調整できます。ブロックインサーターの「パターン」タブから利用できます。ブロックパターンをコンテンツ内に挿入すると、含まれるブロックのコンテンツや構成を追加、変更できます。
ブロックパターンは、あらかじめ定義されたブロックのレイアウトです。ブロックインサーターの「パターン」タブから利用できます。ブロックパターンをコンテンツ内に挿入すると、含まれるブロックのコンテンツや構成を追加、変更できます。

<!--
In this Document:
Expand Down Expand Up @@ -38,13 +37,6 @@ In this Document:
- ブロックタイプやパターン変換のコンテキストに応じたブロックパターン
- セマンティックブロックパターン

<!--
* [`register_block_pattern`](https://ja.wordpress.org/team/handbook/block-editor/reference-guides/block-api/block-patterns/#registerblockpattern)
* [`unregister_block_pattern`](https://ja.wordpress.org/team/handbook/block-editor/reference-guides/block-api/block-patterns/#unregisterblockpattern)
* [`register_block_pattern_category`](https://ja.wordpress.org/team/handbook/block-editor/reference-guides/block-api/block-patterns/#registerblockpatterncategory)
* [`unregister_block_pattern_category`](https://ja.wordpress.org/team/handbook/block-editor/reference-guides/block-api/block-patterns/#unregisterblockpatterncategory)
-->

<!--
## Block Patterns
-->
Expand All @@ -55,7 +47,7 @@ In this Document:
<!--
The editor comes with several core block patterns. Theme and plugin authors can register additional custom block patterns using the `register_block_pattern` helper function.
-->
エディターにはいくつかのコアブロックパターンが付属します。テーマやプラグインの作者は `register_block_pattern` ヘルパー関数を使用して、追加のカスタムブロックパターンを登録できます。
エディターにはいくつかのコアブロックパターンが付属します。それ以外にテーマやプラグインの作者は `register_block_pattern` ヘルパー関数を使用して、追加のカスタムブロックパターンを登録できます。

<!--
The `register_block_pattern` helper function receives two arguments.
Expand All @@ -66,24 +58,6 @@ The `register_block_pattern` helper function receives two arguments.
- `title`: 機械が読めるタイトル。命名規約は `namespace/title`
- `properties`: パターンのプロパティを説明する配列

<!--
The properties of the block pattern include:
- `title` (required): A human-readable title for the pattern.
- `content` (required): Raw HTML content for the pattern.
- `description`: A visually hidden text used to describe the pattern in the inserter. A description is optional but it is strongly encouraged when the title does not fully describe what the pattern does.
- `categories`: An array of pattern categories used to group block patterns. Block patterns can be shown on multiple categories.
- `keywords`: An array of aliases or keywords that help users discover the pattern while searching.
- `viewportWidth`: An integer specifying the width of the pattern in the inserter.
-->
<!--
ブロックパターンのプロパティを以下に示します。
- `title` (必須): 表示されるパターンのタイトル。
- `content` (必須): パターンの生の HTML コンテンツ。
- `description`: インスペクター内でパターンの記述に使用される非表示のテキスト。オプションだがタイトルで十分にブロックの動作を表せない場合は強く推奨。
- `categories`: ブロックパターンのグループ化に使用されるブロックカテゴリーの配列。ブロックパターンは複数のカテゴリーに分けて表示できる。
- `keywords`: 検索の際に役立つ別名またはキーワードの配列。
- `viewportWidth`: インサーター内でのパターンの幅を指定する整数
-->
<!--
The properties available for block patterns are:
-->
Expand All @@ -110,9 +84,9 @@ The properties available for block patterns are:
- `viewportWidth` (オプション): インサーター内でのパターンのインデント幅を指定する整数。パターンのスケールするプレビュー用。
- `blockTypes` (オプション): パターンが一緒に使われることを想定するブロックタイプの配列。各値は、ブロックの `name` で宣言される必要がある。
- `postTypes` (オプション): このパターンを使用可能な投稿タイプの配列。配列で指定した投稿タイプのいずれかを編集する際にのみこのパターンを使用でき、その他のすべての投稿タイプではまったく使用できない。
- `templateTypes` (オプション): パターンが意味を持つ、テンプレートタイプの配列。例: パターンが 404 ページ用であれば '404'。パターンが単一の投稿用であれば single-post。
- `inserter` (オプション): デフォルトでは、すべてのパターンはインサーターに表示されます。プログラムでのみ挿入できるようにパターンを非表示にするには、`inserter` `false` に設定します
- `source` (オプション): パターンのソースを示す文字列。パターンを登録するプラグインの場合は、文字列 'plugin' を指定します。テーマの場合は文字列 'theme' を指定します
- `templateTypes` (オプション): パターンの想定する、テンプレートタイプの配列。例: パターンが 404 ページ用であれば '404'。パターンが単一の投稿用であれば single-post。
- `inserter` (オプション): デフォルトでは、すべてのパターンはインサーターに表示される。パターンを非表示にして、プログラムでのみ挿入できるようにするには、`inserter` `false` を設定する
- `source` (オプション): パターンのソースを示す文字列。パターンを登録するプラグインの場合は、文字列 'plugin' を指定し、テーマの場合は文字列 'theme' を指定する

<!--
The following code sample registers a block pattern named 'my-plugin/my-awesome-pattern':
Expand Down Expand Up @@ -374,6 +348,7 @@ Example:
-->
例:

<!--
```php
<?php
register_block_pattern(
Expand All @@ -386,6 +361,20 @@ register_block_pattern(
'content' => 'Content of my block pattern',
)
);
```
-->
```php
<?php
register_block_pattern(
'my-plugin/my-header',
array(
'title' => __( 'My Header', 'my-plugin' ),
'categories' => array( 'header' ),
// パターンを「header」領域に割り当て
'blockTypes' => array( 'core/template-part/header' ),
'content' => 'Content of my block pattern',
)
);
```

[原文](https://github.com/WordPress/gutenberg/blob/trunk/docs/reference-guides/block-api/block-patterns.md)

0 comments on commit 49ebb76

Please sign in to comment.