Japanese translation of the documentation #2150

KentarouTakeda · 2024-03-19T06:53:27Z

Hi there!

I am a native Japanese speaker currently working on translating the Hexo documentation into Japanese.

~~Since the translation is still in progress, I am submitting this as a draft pull request to keep everyone informed about my work.~~
This pull request is ready to review and closes #2151 .

Translation Process

Copy all English documents to a Japanese folder.
- This is to facilitate comparison between the Japanese translations and the original English documents during the review process, using the commit change set.
Add an i18n dictionary and language settings.
Initially, perform a mechanical translation of all pages using Google Translate or ChatGPT.
Subsequently, enhance the readability in Japanese by standardizing terminology, phrasing, and Markdown formatting.
It may be necessary to consider the notation rules and unification of technical words and nouns.

Progress

All completed.

Records until completion

updated: 2024-03-23T03:01:13+09:00
updated: 2024-03-23T14:32:12+0900: done: api - core e4407e6
updated: 2024-03-23T21:41:14+0900: done: api - extensions f2e7d22
updated: 2024-03-24T14:07:02+0900 done: api - deployment 6e6b349
updated: 2024-03-24T16:11:40+0900 wip: docs - customization be8142d
updated: 2024-03-24T19:16:40+0900 done: docs - customization 2778119

Unchecked pages are machine translations. Although the meaning is understandable, there may be some unnatural expressions.

The checked pages have been proofread by me and are considered "ready to review".

You can see the change set for only the translation, not the entire pull request, from here.

Check List

Please read and check followings before submitting a PR.

Others (Update, fix, translation, etc...)
- Languages: Japanese

github-actions · 2024-03-19T06:54:14Z

Theme name validation passed.
Theme thumbnails validation completed.

yoshinorin

@KentarouTakeda

Progress にチェックが付いているドキュメントから順番に確認しています。思ったより量が多かったので順番に確認していきます。少し時間がかかりそうなうえに、その都度コメントすることになりますが、ご容赦ください。

技術文書含めて翻訳に特別明るいというわけではないので、指摘内容に対してなにかあればコメントください。

その他、相談等あれば都度コメントください。

その他

ご存じかもしれませんが、以下でこの PR のプレビューを閲覧することができます。

https://deploy-preview-2150--hexo-site.netlify.app/ja/

yoshinorin · 2024-03-23T09:25:02Z

source/ja/docs/configuration.md

+`render_drafts` | 下書きを表示するか | `false`
+`post_asset_folder` | [アセットフォルダ](asset-folders.html)を有効にするか | `false`
+`relative_link` | リンクをルートフォルダに対して相対的にするか | `false`
+`future` | 未来の投稿を表示するか | `true`


IMHO:

原文のように末尾に ？ を付与するか、もしくは「～かどうか」と記述したほうが分かりやすいかなと思います。

a3f5c21 で修正しました。
見つけられた範囲で、同じ修正を行ったほうが良さそうな箇所を同じcommitにまとめました。

yoshinorin · 2024-03-23T09:34:48Z

source/ja/docs/configuration.md

+--- | --- | ---
+`date_format` | 日付形式 | `YYYY-MM-DD`
+`time_format` | 時刻形式 | `HH:mm:ss`
+`updated_option` | フロントマターで提供されていない場合に使用する[`updated`](variables#ページ変数)の値 | `mtime`


IMHO:

フロントマター はそのまま front-matter でよいのではないかと思います。Obsidian は翻訳しているようですが、 GitHub や jekyll のサイトではそのまま英語でした。

他の技術用語でも翻訳しないほうがしっくりくるものはあるのではないかと思います（他の技術用語については都度コメントします）

参考:

GitHub

jekyll

Obsidian

be93b17 で修正しました。
全てFront Matterにしてみました。
（ハイフンの有無や大文字小文字などを使い分けるとむしろ表記揺れぽくなりそうなので、最も使いやすい表記で統一する意図です。）

source/ja/docs/commands.md

yoshinorin · 2024-03-23T10:07:11Z

source/ja/docs/tag-plugins.md

+
+投稿に引用を追加します。オプションで著者、出典、タイトル情報を含めることができます。
+
+**別名:** quote


IMHO:

エイリアス でよいのではないかと思います。別名 だと一見なにを指してるのか分かりませんでした。

同じページの別の箇所含め 2d63676 で修正しました。

yoshinorin · 2024-03-23T10:16:31Z

source/ja/docs/tag-plugins.md

+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque hendrerit lacus ut purus iaculis feugiat. Sed nec tempor elit, quis aliquam neque. Curabitur sed diam eget dolor fermentum semper at eu lorem.
+{% endblockquote %}
+```
+


原文では以下のように各々の例でコードブロック（"```"）で 囲んでいない ものも併せて記述されているのですが、それらが消えているようです。

site/source/docs/tag-plugins.md

Lines 34 to 36 in 0ddb974

{% blockquote %}

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque hendrerit lacus ut purus iaculis feugiat. Sed nec tempor elit, quis aliquam neque. Curabitur sed diam eget dolor fermentum semper at eu lorem.

{% endblockquote %}

参考: 原文のプレビュー

b862c01 で修正しました。
ありがとうございます、助かりました。いちばん最初に機械的に荒訳した際に、間違えて全て消してしまってました…

yoshinorin · 2024-03-23T10:24:11Z

source/ja/docs/tag-plugins.md

+## Gist (v7.0.0で削除されました)
+
+{% note warn %}
+v7.0.0+を使用する場合は、代わりに[hexo-tag-embed](https:/hexojs/hexo-tag-embed)を使用してください。


他の個所も同じように修正してください

Suggested change

v7.0.0+を使用する場合は、代わりに[hexo-tag-embed](https:/hexojs/hexo-tag-embed)を使用してください。

v7.0.0 以上で使用する場合は、代わりに[hexo-tag-embed](https:/hexojs/hexo-tag-embed)を使用してください。

本当はすべて以下と同じ文章になるべきなのですが、原文から誤ってます。原文に合わせて修正のほうが良いのでいったん上の Suggestion の修正をお願いします。

https:/hexojs/site/pull/2150/files#diff-c5e1c4c306ce8f5c78e60b93dbd08bb0c9cd1f0c6e1047deab358eccea71fba4R137

199410a で修正しました。

yoshinorin · 2024-03-23T10:28:29Z

source/ja/docs/tag-plugins.md

+
+### url_for (7.0.0+)
+
+ルートパスがプレフィックスとして付加されたURLを返します。出力は自動的にエンコードされます。


IMHO:

Suggested change

ルートパスがプレフィックスとして付加されたURLを返します。出力は自動的にエンコードされます。

ルートパスをプレフィックスとして付加したURLを返します。出力は自動的にエンコードされます。

同じページのほぼ同じ表現を含め 1539f4c で修正しました。

yoshinorin · 2024-03-23T10:43:44Z

source/ja/docs/troubleshooting.md

+$ ulimit -n 10000
+```
+
+**エラー：制限を変更できません**


原文はエラーメッセージをそのままタイトルにしているだけのようなので、ここは無理に翻訳しなくてもよいと思います

site/source/docs/troubleshooting.md

Line 36 in 4adb1d3

**Error: cannot modify limit**

4c54206 で修正しました。ありがとうございます、助かりました。

最初の荒訳をGPT-4にやらせた時に訳されてしまった箇所で、気付いた分は戻したのですが見落としていたようです。他に同じような箇所があったら指摘頂けると助かります。
（これは、残りの翻訳の際に注意深く作業します。）

yoshinorin · 2024-03-23T10:44:13Z

source/ja/docs/troubleshooting.md

+
+コンピュータ上で[gitを適切に設定](https://help.github.com/articles/set-up-git)していることを確認するか、HTTPSリポジトリURLを代わりに使用してみてください。
+
+### エラー：ENOENT：そのようなファイルやディレクトリはありません


ここも同様です

site/source/docs/troubleshooting.md

Line 99 in 4adb1d3

### Error: ENOENT: no such file or directory

上と同じ

source/ja/docs/contributing.md

…gative form. hexojs#2150 (comment)

hexojs#2150 (comment)

Co-authored-by: yoshinorin <[email protected]>

hexojs#2150 (comment)

hexojs#2150 (comment) hexojs#2150 (comment)

hexojs#2150 (comment)

hexojs#2150 (comment) hexojs#2150 (comment)

Co-authored-by: yoshinorin <[email protected]>

KentarouTakeda · 2024-03-23T13:49:18Z

@yoshinorin
レビューありがとうございます！このコメントより上の箇所は、一通り修正させて頂きました。
なかなかの分量なので、何れもお時間のある時で大丈夫です！

他の技術用語でも翻訳しないほうがしっくりくるものはあるのではないかと思います

同じ理由で私も迷っている箇所があります。見出しは原語にしたいが文中だと浮いてしまう、等。
加えて、カタカナ語の末尾長音の有無やそれが現時点で不統一になってしまっている箇所などもあるので、作業の終盤や終了後にざっと見直したほうが良さそう、と感じています。もちろんそれより前に指摘いただいても大丈夫です。

丁寧に見ていただいてありがとうございます。

hexojs#2150 (comment)

Co-authored-by: yoshinorin <[email protected]>

D-Sketon · 2024-03-30T11:28:55Z

maybe .github/labeler.yml also needs to be added ja like this:

site/.github/labeler.yml

Lines 38 to 41 in 4adb1d3

 ru: 

 - changed-files: 

 - any-glob-to-any-file: 

 - "source/ru/**"

Co-authored-by: yoshinorin <[email protected]>

KentarouTakeda · 2024-03-30T12:06:46Z

Thanks all!

@yoshinorin

Suggested changeは全てそのまま受け入れさせて頂きました。typo等お恥ずかしい限りです！
1466e43 で Pull Request Template へ ja を追加しました。

@D-Sketon

I added ja label pull request labeler with 1eebdab.

yoshinorin

@KentarouTakeda
LGTM 🎉

I'm going to merge this PR. If you want to improve wording etc, please submit additional PRs after merging this PR. Thank you :)

Copy files to be translated from English

125041f

github-actions bot added Docs source/docs infra infrastructure, configuration of this repo API labels Mar 19, 2024

KentarouTakeda mentioned this pull request Mar 19, 2024

Proposal: Japanese Translation of the Documentation #2151

Closed

yoshinorin self-assigned this Mar 20, 2024

This was referenced Mar 20, 2024

ci: add workflows of integrate with crowdin #2146

Merged

style: apply prettier formatting to md #2145

Merged

KentarouTakeda added 2 commits March 23, 2024 02:51

Added credit to Contributors in README

59dca39

wip

90e1f14

KentarouTakeda force-pushed the japanese-translation branch from 085c20f to 90e1f14 Compare March 22, 2024 17:52

docs(ja): api - core

e4407e6

yoshinorin reviewed Mar 23, 2024

View reviewed changes

KentarouTakeda and others added 9 commits March 23, 2024 21:40

docs(ja): api - extensions

f2e7d22

docs(ja): Changed the description of boolean value setting to interro…

a3f5c21

…gative form. hexojs#2150 (comment)

docs(ja): Unify フロントマター to Front Matter

be93b17

hexojs#2150 (comment)

Update source/ja/docs/commands.md

0e42386

Co-authored-by: yoshinorin <[email protected]>

docs(ja): Correct 別名 to エイリアス

2d63676

hexojs#2150 (comment)

docs(ja): Revert accidental deletion of tag rendering example

b862c01

hexojs#2150 (comment) hexojs#2150 (comment)

docs(ja): Improve wording

1539f4c

hexojs#2150 (comment)

docs(ja):Do not translate error messages

4c54206

hexojs#2150 (comment) hexojs#2150 (comment)

Update source/ja/docs/contributing.md

69107f1

Co-authored-by: yoshinorin <[email protected]>

KentarouTakeda added 5 commits March 23, 2024 23:13

docs(ja): Fix wording of vX.Y.Z+ to indicate *greater than*

199410a

hexojs#2150 (comment)

docs(ja): api - deployment

6e6b349

docs(ja): wip: docs - customization

be8142d

docs(ja): Do not translate argument names in code examples

c6aecef

docs(ja): docs - customization

2778119

KentarouTakeda marked this pull request as ready for review March 24, 2024 10:28

KentarouTakeda and others added 13 commits March 30, 2024 20:16

Update source/ja/api/posts.md

2fb23a5

Co-authored-by: yoshinorin <[email protected]>

Update source/ja/api/posts.md

4fc1398

Co-authored-by: yoshinorin <[email protected]>

Update source/ja/api/themes.md

c67f4ed

Co-authored-by: yoshinorin <[email protected]>

Update source/ja/docs/commands.md

324e0a4

Co-authored-by: yoshinorin <[email protected]>

Update source/ja/docs/configuration.md

191916a

Co-authored-by: yoshinorin <[email protected]>

Update source/ja/docs/configuration.md

6060798

Co-authored-by: yoshinorin <[email protected]>

Update source/ja/docs/configuration.md

6a787af

Co-authored-by: yoshinorin <[email protected]>

Update source/ja/docs/index.md

127538f

Co-authored-by: yoshinorin <[email protected]>

Update source/ja/docs/configuration.md

e3532a5

Co-authored-by: yoshinorin <[email protected]>

Update source/ja/docs/contributing.md

c952d20

Co-authored-by: yoshinorin <[email protected]>

Update source/ja/docs/front-matter.md

65b87cc

Co-authored-by: yoshinorin <[email protected]>

Update source/ja/docs/helpers.md

a7813db

Co-authored-by: yoshinorin <[email protected]>

Update source/ja/docs/helpers.md

8f23415

Co-authored-by: yoshinorin <[email protected]>

KentarouTakeda and others added 10 commits March 30, 2024 20:29

Update source/ja/docs/index.md

c21e769

Co-authored-by: yoshinorin <[email protected]>

Update source/ja/docs/index.md

10f49fc

Co-authored-by: yoshinorin <[email protected]>

Update source/ja/docs/index.md

869b219

Co-authored-by: yoshinorin <[email protected]>

Update source/ja/docs/one-command-deployment.md

fc29cac

Co-authored-by: yoshinorin <[email protected]>

Update source/ja/docs/one-command-deployment.md

6e3a531

Co-authored-by: yoshinorin <[email protected]>

Update source/ja/docs/configuration.md

3c1aeb1

Co-authored-by: yoshinorin <[email protected]>

Update source/ja/docs/configuration.md

b3f1ca2

Co-authored-by: yoshinorin <[email protected]>

docs(ja): Fix event argument wording

e47590b

chore: Add Japanese language option to pull request template

1466e43

chore: Add ja label to pull request labeler

1eebdab

yoshinorin approved these changes Mar 30, 2024

View reviewed changes

yoshinorin merged commit 956f2c2 into hexojs:master Mar 30, 2024
6 checks passed

KentarouTakeda deleted the japanese-translation branch March 30, 2024 14:12

stevenjoezhang mentioned this pull request Mar 30, 2024

docs(one-command-deployment): update ftpsync #2153

Merged

uiolee mentioned this pull request Jul 6, 2024

ci(crowdin): add ja #2213

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Japanese translation of the documentation #2150

Japanese translation of the documentation #2150

KentarouTakeda commented Mar 19, 2024 •

edited

Loading

github-actions bot commented Mar 19, 2024

yoshinorin left a comment

yoshinorin Mar 23, 2024

KentarouTakeda Mar 23, 2024

yoshinorin Mar 23, 2024

KentarouTakeda Mar 23, 2024

yoshinorin Mar 23, 2024

KentarouTakeda Mar 23, 2024

yoshinorin Mar 23, 2024

KentarouTakeda Mar 23, 2024

yoshinorin Mar 23, 2024

yoshinorin Mar 23, 2024 •

edited

Loading

KentarouTakeda Mar 23, 2024

yoshinorin Mar 23, 2024

KentarouTakeda Mar 23, 2024

yoshinorin Mar 23, 2024

KentarouTakeda Mar 23, 2024

yoshinorin Mar 23, 2024

KentarouTakeda Mar 23, 2024

KentarouTakeda commented Mar 23, 2024

D-Sketon commented Mar 30, 2024

KentarouTakeda commented Mar 30, 2024

yoshinorin left a comment


		投稿に引用を追加します。オプションで著者、出典、タイトル情報を含めることができます。

		別名: quote

	{% blockquote %}
	Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque hendrerit lacus ut purus iaculis feugiat. Sed nec tempor elit, quis aliquam neque. Curabitur sed diam eget dolor fermentum semper at eu lorem.
	{% endblockquote %}

	v7.0.0+を使用する場合は、代わりに[hexo-tag-embed](https:/hexojs/hexo-tag-embed)を使用してください。
	v7.0.0 以上で使用する場合は、代わりに[hexo-tag-embed](https:/hexojs/hexo-tag-embed)を使用してください。


		### url_for (7.0.0+)

		ルートパスがプレフィックスとして付加されたURLを返します。出力は自動的にエンコードされます。

	ルートパスがプレフィックスとして付加されたURLを返します。出力は自動的にエンコードされます。
	ルートパスをプレフィックスとして付加したURLを返します。出力は自動的にエンコードされます。


		コンピュータ上で[gitを適切に設定](https://help.github.com/articles/set-up-git)していることを確認するか、HTTPSリポジトリURLを代わりに使用してみてください。

		### エラー：ENOENT：そのようなファイルやディレクトリはありません

Japanese translation of the documentation #2150

Japanese translation of the documentation #2150

Conversation

KentarouTakeda commented Mar 19, 2024 • edited Loading

Translation Process

Progress

Check List

github-actions bot commented Mar 19, 2024

yoshinorin left a comment

Choose a reason for hiding this comment

その他

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

yoshinorin Mar 23, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

KentarouTakeda commented Mar 23, 2024

D-Sketon commented Mar 30, 2024

KentarouTakeda commented Mar 30, 2024

yoshinorin left a comment

Choose a reason for hiding this comment

KentarouTakeda commented Mar 19, 2024 •

edited

Loading

yoshinorin Mar 23, 2024 •

edited

Loading