Yuki-no: オープンソース文書翻訳プロジェクトのための GitHub Action

こんにちは。Vite の韓国語ドキュメント翻訳プロジェクトを進める中で開発したオープンソースを紹介します。

Yuki-no (Gumball12/yuki-no)

翻訳作業では、原文ドキュメントの変更を追跡することが非常に重要です。そうしないと、誤った箇所を翻訳してしまったり、内容の一部を見落としてしまう可能性があります。

このため、これまでは Ryu-Cho というオープンソースを使っていました。このオープンソースは GitHub Actions を利用して、原文リポジトリの変更内容を翻訳リポジトリの GitHub Issues に登録して通知してくれます。ただし、2年近く使う中でいくつかの改善点が見つかりました。

1. Actions が失敗すると、未処理の原文リポジトリ変更がすべて失われ、GitHub Issues に登録されません。その結果、原文内容の一部を見落としてしまいます。
2. 追跡対象ファイルをフィルタリングする方式が非常に限定的です（先頭文字列比較方式）。
3. 作成される Issue にラベルを設定できないため、他の Issue と混ざってしまい、一目で把握しづらくなります。
4. 原文ドキュメントの変更がリリース済みかどうかの情報が提供されません。これにより、未リリースのコンテンツを早すぎる段階で提供してしまう可能性があります。

これらを改善することを目的に開発しており、以下の機能を提供します。

• バッチ処理による Action の安定性向上（200件以上のコミットで正常動作を確認）
• Action 失敗時に、次回実行で自動的に復旧するよう構成
• リリース追跡機能を提供（例: Vite 韓国語翻訳プロジェクト）
• Glob パターンベースの追跡対象フィルタリング
• 作成する Issue に対するカスタムラベルを設定可能

現在、以下のプロジェクトで使用中です。

• Vite 公式韓国語翻訳プロジェクト (作成された Issue)
• Vue.js 公式韓国語翻訳プロジェクト
• Vite 翻訳テンプレート

翻訳プロジェクトを進める予定のある方、マイグレーションなどの構成面で支援が必要な方、またはプロジェクトに関心のある方は、GitHub Issues またはメール（[e-mail]）でいつでもお気軽にご連絡ください。ありがとうございます。