chore(i18n,docs): processed translations (#44950)
This commit is contained in:
camperbot
GitHub
@@ -6,14 +6,14 @@
|
||||
|
||||
カリキュラム内容を説明する際に使用する用語がいくつかあります。
|
||||
|
||||
- `certification` : When referring to a certification in this instance, it is talking about the actual certificate that users claim. Which is separate from the name of the superBlock.
|
||||
- `superBlock` : A superblock is the top level collection of challenges. Each superblock corresponds to a certification in the curriculum (i.e. Responsive Web Design).
|
||||
- `block` : A block is a section within a superblock. A block corresponds to a group of challenges in a given certification (i.e. Basic HTML and HTML5)
|
||||
- `challenge` : A challenge is a single lesson within the curriculum (i.e. Say Hello to HTML Elements)
|
||||
- `certification` : この場合、ユーザーが求める実際の認定講座を意味します。 これは、スーパーブロック名とは別のものです。
|
||||
- `superBlock` : スーパーブロックは、チャレンジの最上位レベルのコレクションです。 各スーパーブロックは、カリキュラム内の各認定講座に相当します (例: レスポンシブ Web デザイン)。
|
||||
- `block` : ブロックは、スーパーブロック内のセクションです。 ブロックは、特定の認定講座のチャレンジグループに相当します (例: HTML と HTML5 の基礎)。
|
||||
- `challenge` : チャレンジは、カリキュラム内の単一のレッスンです (例: はじめての HTML 要素)
|
||||
|
||||
## File Tree
|
||||
## ファイルツリー
|
||||
|
||||
Using those terms, here is how the file structure would be defined:
|
||||
これらの用語を使用して、以下のようにファイル構造が定義されます。
|
||||
|
||||
<!-- prettier-ignore -->
|
||||
```md
|
||||
@@ -28,79 +28,79 @@ curriculum/
|
||||
│ │ │ ├─ {challenge}.md
|
||||
```
|
||||
|
||||
## The `_meta` Directory
|
||||
## `_meta` ディレクトリ
|
||||
|
||||
The `_meta` directory is a special directory which contains `.json` files. These files correspond to each block in the curriculum, and are used to determine which superBlock a block belongs to, and the order of the challenges within that block.
|
||||
`_meta` ディレクトリは、`.json` ファイルを含む特別なディレクトリです。 これらのファイルは、カリキュラム内の各ブロックに相当します。ブロックが属するスーパーブロックと、そのブロック内のチャレンジの順序を決めるために使用されます。
|
||||
|
||||
## Renaming Files
|
||||
## ファイル名を変更する
|
||||
|
||||
There may be times when you need to rename a certificate, superblock, block, or challenge. This section will outline the steps needed to avoid build errors when doing so.
|
||||
認定講座、スーパーブロック名、ブロック名、もしくはチャレンジ名を変更する必要がある場合があります。 このセクションでは、ビルドエラーを避けるために必要な手順を概説します。
|
||||
|
||||
> [!ATTENTION] Renaming files within the curriculum structure will often change the path (or URL) of the content on the main webpage. Doing so should be done with care, as redirects have to be set up for each change that is made.
|
||||
> [!ATTENTION] カリキュラム構造内のファイル名を変更すると、メインの Web ページ上のコンテンツパス (または URL) が変更されることがあります。 変更ごとにリダイレクトを設定する必要があるため、注意して行ってください。
|
||||
|
||||
### Renaming a Certification
|
||||
### 認定講座名を変更する
|
||||
|
||||
When renaming a certification, you will likely want to rename the associated superblock along with it. Do the following to rename only the certificate:
|
||||
認定講座名を変更する際、関連付けられているスーパーブロック名も一緒にに変更することも検討するでしょう。 以下は、認定講座名のみを変更するための手順です。
|
||||
|
||||
1. Rename the `curriculum/challenges/_meta/{superBlock}-certificate` folder to the new name.
|
||||
1. In the `meta.json` file of that folder, rename the values in `name`, `dashedName`, and `challengeOrder` to the new cert name.
|
||||
1. In `curriculum/challenges/english/12-certificate`, rename the `{superBlock}-certificate` folder, and the YAML file within it, to the new name.
|
||||
1. In the YAML file, change the `title` to the new name.
|
||||
1. Rename the file and folder from step 3 for the rest curriculum languages.
|
||||
1. Update `client/src/redux/index.ts` to use the correct `title`.
|
||||
1. Optionally, update the `certSlug` for the superblock in the same file. **Note** that renaming a `certSlug` will change the URL for certifications and should only be done with careful consideration.
|
||||
1. Update the `title` in `client/src/resources/cert-and-project-map.ts` to the new value. **Note** that changing the `title` here **will break** the superBlock page for the associated certification. It relies on the superBlock title to match the certification title. You will likely want to rename the superBlock at the same time.
|
||||
1. If you renamed the `certSlug` in step 7, change it here for the cert and all the nested `projects` values.
|
||||
1. In `config/certification-settings.js`, update the value of `certTypeTitleMap` to the new name.
|
||||
1. If you renamed the `certSlug` in step 7, update the key of `certSlugTypeMap` in the same file.
|
||||
1. Update the certificate name in the `legacyCerts` array of the `client/src/client-only-routes/show-project-links.tsx` if needed.
|
||||
1. Update the main `README.md` file to the new name.
|
||||
1. `curriculum/challenges/_meta/{superBlock}-certificate` フォルダ名を変更します。
|
||||
1. フォルダの `meta.json` ファイル内で、`name`、`dashedName`、`challengeOrder` の値を新しい認定講座名に変更します。
|
||||
1. `curriculum/challenges/english/12-certificate` 内で、`{superBlock}-certificate` フォルダ名と、その中の YAML ファイル名を変更します。
|
||||
1. YAML ファイルの `title` 名を変更します。
|
||||
1. 残りのカリキュラム言語について、手順 3 に従いファイル名とフォルダ名を変更します。
|
||||
1. `client/src/redux/index.ts` を更新して、正しい `title` を使用してください。
|
||||
1. 必要に応じて、同じファイル内のスーパーブロックの `certSlug` を更新します。**注記** : `certSlug` 名を変更すると、認定講座の URL が変更されるため、慎重に変更します。
|
||||
1. `client/src/resources/cert-and-project-map.ts` 内の `title` を新しい値に更新してください。**注記** : ここで `title` を変更すると、関連する認定講座のスーパーブロックのページ が **壊れます** 。 そのページは、スーパーブロックのタイトルに依存しており、認定講座タイトルと一致します。 スーパーブロック名も同時に変更したい場合があるからです。
|
||||
1. 手順 7 で、`certSlug` 名を変更した場合は、認定講座とネストされた `projects` の値を変更します。
|
||||
1. `config/certification-settings.js` で、`certTypeTitleMap` の値を新しい名前に更新します。
|
||||
1. 手順 7 で `certSlug` を変更した場合、同じファイル内の `certSlugTypeMap` のキーを更新します。
|
||||
1. 必要に応じて、`client/src/client-only-routes/show-project-links.tsx` の `legacyCerts` 配列内の認定講座名を更新します。
|
||||
1. メイン `README.md` ファイル名を新しい名前に更新します。
|
||||
|
||||
### Renaming a Superblock
|
||||
### スーパーブロック名を変更する
|
||||
|
||||
> [!NOTE] When you rename a superBlock, the new folder name is used as the path and should be considered the "correct" name. All other values should be updated to reflect that change.
|
||||
> [!NOTE] スーパーブロック名を変更すると、新しいフォルダ名がパスとして使用され、「正しい」フォルダ名とみなされます。 その変更を反映するために、その他のすべての値を更新する必要があります。
|
||||
|
||||
Also, you will likely want to rename the certificate and the `{superBlock}-projects` block when you rename a superBlock since they all shares a name. To rename only a superBlock you need to:
|
||||
スーパーブロック名は共有されており、スーパーブロック名を変更する際、認定講座名と `{superBlock}-projects` ブロック名を変更することも検討するでしょう。 以下は、スーパーブロック名のみを変更するための手順です。
|
||||
|
||||
1. Rename the superBlock folder in the `curriculum/challenges/english` directory.
|
||||
1. Rename the superBlock folder in _all_ other `curriculum/challenges/{language}` directories.
|
||||
1. For each block within that superBlock, update the `superBlock` value in the `meta.json` file to its dashedName. You don't need to rename any folders here. Do that when renaming a block.
|
||||
1. Rename the superblock folder in `client/src/pages/learn`.
|
||||
1. Update the `index.md` file in the above folder, changing the `title` and `superBlock` values to the new name.
|
||||
1. For each block folder within the above, update the `index.md` to use the correct `superBlock` value.
|
||||
1. In the `client/src/resources/cert-and-project-map.ts` file, update the path for the cert at the top of the file, and the `title` value for that superBlock. **Note** that changing the `title` here **will break** the ability to view the actual certification for this superBlock. It relies on the superBlock title to match the certification title. You will likely want to rename the certification at the same time.
|
||||
1. Update the `superBlockCertTypeMap` key in `config/certification-settings.js` to the new superBlock name.
|
||||
1. Update the path value in `client/src/assets/icons/index.tsx`.
|
||||
1. For each language in `client/i18n/locales`, update the `intro.json` file to use the new superBlock `dashedName`. In the English file, also update the `title`.
|
||||
1. Check the `config/i18n/all-langs.js` file to see if the superBlock is enabled in i18n builds. Update all the values where it is used.
|
||||
1. Update the main `README.md` file to the new name.
|
||||
1. スーパーブロックのフォルダ名を `curriculum/challenges/english` ディレクトリに変更します。
|
||||
1. _他の_すべての `curriculum/challenges/{language}` ディレクトリのスーパーブロックフォルダ名を変更します。
|
||||
1. スーパーブロック内の各ブロックについて、`meta.json` ファイル内の `superBlock` の値をその dashedName に更新します。 ここでは、フォルダ名を変更する必要はありません。 ブロック名変更時に、フォルダ名を変更します。
|
||||
1. `client/src/pages/learn` 内のスーパーブロックのフォルダ名を変更します。
|
||||
1. 上記フォルダの `index.md` ファイルを更新し、`title` と `superBlock` の値を新しい名前に変更します。
|
||||
1. 上記の各ブロックフォルダで、`index.md` を更新して、正しい `superBlock` の値を使用します。
|
||||
1. `client/src/resources/cert-and-project-map.ts` ファイルで、ファイルの先頭にある認定講座パスと、スーパーブロックの `title` 値を更新します。**注記** : ここで `title` を変更すると、スーパーブロックの実際の認定講座を表示する機能が **壊れます**。 表示機能は、スーパーブロックのタイトルに依存しており、認定講座タイトルと一致します。 認定講座名も同時に変更したいものです。
|
||||
1. `config/certification-settings.js` の `superBlockCertTypeMap` キーを新しいスーパーブロック名に更新します。
|
||||
1. `client/src/assets/icons/index.tsx` のパス値を更新します。
|
||||
1. `client/i18n/locales` の言語ごとに、`intro.json` ファイルを更新して新しいスーパーブロック `dashedName` を使用します。英語のファイルの `title` も更新します。
|
||||
1. i18n ビルドでスーパーブロックが使用可能かどうかを確認するには、`config/i18n/all-langs.js` ファイルを確認します。 使用しているすべての値を更新します。
|
||||
1. メイン `README.md` ファイルを新しい名前に更新します。
|
||||
|
||||
### Renaming a Block
|
||||
### ブロック名を変更する
|
||||
|
||||
When renaming a curriculum block, you need to:
|
||||
以下の手順に従い、カリキュラムブロック名を変更します。
|
||||
|
||||
1. Change the name of the block folder in the `curriculum/challenges/english/{superBlock}` directory.
|
||||
1. Change the name of the same block folder in _all_ of the other language directories to match. These must all be the same as the English structure or the build will error out.
|
||||
1. Change the name of the block folder in the `_meta` directory.
|
||||
1. Update the `name` and `dashedName` property for that block's `meta.json` file.
|
||||
1. Update the `client/utils/help-category-map.json` to use the new block name as the key.
|
||||
1. Update the block folder in `client/src/pages/learn/{superBlock}`.
|
||||
1. In the `index.md` file of the above folder, update the `block` value in the frontmatter.
|
||||
1. In the `client/i18n/locales/{language}/intro.json` files, update the block name to the new name for all the languages. In the English `intro.json` file, update the `title` as well.
|
||||
1. Update the main `README.md` file to the new name.
|
||||
1. `curriculum/challenges/english/{superBlock}` ディレクトリ内のブロックフォルダ名を変更します。
|
||||
1. 他の言語ディレクトリ _すべて_ において、同じブロックフォルダの名前を一致させます。 これらすべてが英語の構造と同じでないと、ビルドエラーになります。
|
||||
1. `_meta` ディレクトリ内のブロックフォルダ名を変更します。
|
||||
1. ブロックの `meta.json` ファイルの `name` と `dashedName` プロパティを更新します。
|
||||
1. `client/utils/help-category-map.json` を更新して、新しいブロック名をキーとして使用します。
|
||||
1. `client/src/pages/learn/{superBlock}` のブロックフォルダを更新します。
|
||||
1. 上記フォルダの `index.md` ファイルで、Frontmatter の `ブロック` の値を更新します。
|
||||
1. `client/i18n/locales/{language}/intro.json` ファイルで、全言語のブロック名を更新します。英語の `intro.json` ファイルでは、`title` も更新します。
|
||||
1. メイン `README.md` ファイルを新しい名前に更新します。
|
||||
|
||||
### Renaming a Challenge
|
||||
### チャレンジ名を変更する
|
||||
|
||||
When renaming a single challenge file, you need to:
|
||||
以下の手順に従い、単一のチャレンジファイル名を変更します。
|
||||
|
||||
1. Change the name of the challenge file in the `curriculum/challenges/english` directory.
|
||||
1. Change the name of the `title` and `dashedName` within that file.
|
||||
1. Change the name of the file, and the `dashedName` in those files for _all_ of the other language directories to match.
|
||||
1. Update the name of the challenge in the relevant `meta.json` file. The challenge names here are not used in the build, but provide a user-friendly way to identify the challenge order.
|
||||
1. If the challenge is a certificate project, update the YAML file in `curriculum/english/12-certificates/<superBlock>` to the new name.
|
||||
1. If the challenge is a certificate project, update the `title` and `link` in `client/src/resources/cert-and-project-map.ts`
|
||||
1. If the challenge is a certificate project, update the main `README.md` file to the new name.
|
||||
1. `urriculum/challenges/english` ディレクトリのチャレンジファイル名を変更します。
|
||||
1. ファイル内の `title` 名と `dashedName` 名を変更します。
|
||||
1. ファイル名と他の言語ディレクトリ _すべて_ のファイルの `dashedName` を変更して一致させます。
|
||||
1. 該当する `meta.json` ファイルのチャレンジ名を更新します。 ここでのチャレンジ名は、ビルドでは使用されませんが、チャレンジの順序を識別するためのユーザーフレンドリーな方法を提供します。
|
||||
1. チャレンジが認定講座プロジェクトの場合、 `curriculum/english/12-certificates/<superBlock>` 内の YAML ファイルを新しい名前に更新します。
|
||||
1. チャレンジが認定講座プロジェクトの場合、`client/src/resources/cert-and-project-map.ts` の `title` と `link` を更新します。
|
||||
1. チャレンジが認定講座プロジェクトの場合、メイン `README.md` ファイルを新しい名前に更新します。
|
||||
|
||||
## The `dashedName` Property
|
||||
## `dashedName` プロパティ
|
||||
|
||||
The `dashedName` property is used to generate the URL path for the superblock, block, or challenge. These should generally match what the `/utils/slugs.js` helper would output for the file name.
|
||||
`dashedName` プロパティは、スーパーブロック、ブロック、またはチャレンジの URL パスを生成するために使用されます。これらは通常 `/utils/slugs.js` ヘルパーがファイル名に対して出力するものと一致します。
|
||||
|
||||
Reference in New Issue
Block a user