新しい公式ドキュメントサイトの日本語訳について：レビューと今後の管理の相談

Anki Translating
1

新しい公式ドキュメントサイトへの日本語訳追加と、今後の管理について相談したく、トピックを作成しました。

現在、日本語訳を追加するPRを提出しています。abdnhさんから、既存の日本語訳との連携や、レビューに参加する人を募るためにフォーラムで相談するよう提案をいただきました。

日本語訳のレビューと今後の管理について、日本語を使う方々と直接相談したいため、このトピックは日本語で作成しています。

翻訳の作成方法と確認状況

既存の日本語訳をいくつか参照しながら、英語の原文をもとにAIを使って翻訳しました。その後、yomiyasuスキルを使い、日本語の言い回しや読みやすさを整えています。

自分でも一通り確認し、ローカルでドキュメントサイトを動かしてプレビューを確認しました。ただ、自分だけの確認では見落としもあるため、レビューに協力してくださる方を探しています。

特に、次の点を確認していただけると助かります。

  • Ankiの日本語UIと用語が一致しているか

  • 誤訳や訳抜け、原文と意味が変わっている箇所がないか

  • 説明が分かりにくい箇所や、不自然な日本語がないか

  • 表示やリンク、ナビゲーションに問題がないか

既存の日本語訳との連携

Shigeyukiさんによる日本語訳のトピックも紹介していただきました。

@Shigeyuki さんをはじめ、これまで日本語訳に関わってきた方にも、用語や訳文についてご意見をいただければと思っています。既存の翻訳をどう活用し、重複する作業を減らせるかについても相談したいです。

今後の管理について

公式ドキュメントサイトは最近大きくリニューアルされ、多言語対応がしやすくなっています。英語の原文と各言語の翻訳を、一つのリポジトリで管理する構成になっている点も踏まえ、今後の日本語訳の管理について議論できればと思います。

自分としては、公式リポジトリで日本語訳を管理し、原文の更新に合わせて複数人で修正・レビューできる形を希望しています。

翻訳のレビュー方法、原文の更新への追従、既存の日本語訳との連携などについて、ご意見や協力をいただけると助かります。一部のページだけのレビューでも歓迎です。

よろしくお願いします。

2

私は翻訳で最近ほとんど活動していないですね、最後に翻訳したのは2年ぐらい前です。レポジトリはありますがレビューは省略している、なので貢献者の人は自分で更新する感じです。今度また更新しようとは考えてます。

翻訳についての過去の議論のスレッドはこれです。

You might be interested in such a project:
@sorata @snowtimeglass @juamnakuranam

3

I wasn’t aware of the Japanese translation at はじめに - Ankiマニュアル.
But then why does the official documentation—specifically the page at Introduction - Anki Docs—link to Anki日本語マニュアル Wiki* instead?

In my own add-on (https://ankiweb.net/shared/info/1032589920), I implemented a feature that directs users to the help documentation in their own language:
Attention! This add-on will change the Anki help URL if the Anki interface language is set to one of the following: Russian, Polish, Portuguese, Ukrainian, Arabic, or Simplified Chinese (the same site applies to Taiwan). No other languages ​​are included, either because the existing sites are outdated or because their site structure differs.

So, which site is better—はじめに - Ankiマニュアル or Anki日本語マニュアル Wiki*?

It would be ideal if the help documentation automatically appeared in the language the user has selected, just as I’ve implemented in my add-on. I’m not entirely sure how I’ll maintain the documentation moving forward, but I’ll likely continue doing so through 2026; after that, perhaps someone else can take it on—life being what it is, you never know what tomorrow might bring.

4

The official manual developed by Japanese contributors is the “Anki日本語マニュアル Wiki”, ideally this should be updated, but this Wiki has hardly been updated at all and has become outdated.

“はじめに - Ankiマニュアル” is an unofficial version that I developed and released myself. This version was released with some inaccuracies in the translation, I’ve been reviewing it but it’s not yet complete so I haven’t linked to it from the official AnkiManual yet.

5

If the manual is to be translated by AI rather than humans, wouldn’t it be sufficient for the official Anki team to use AI to handle both the translation and checking themselves? They have a budget so I think they can use more advanced AI than volunteers can, also if they update the translations regularly I think they could keep the latest versions available for all languages. It seems like too much of a burden for volunteers to check the massive volume of documents generated in bulk by AI or to handle the migration of all those documents.

6

I’m glad I don’t need translations…