気軽に参加してください。

以下は、翻訳のガイドラインです。

翻訳の追加方法

• 基本的にプルリクエストを送ってください
• Typo などの小さな点は issue でも大丈夫です
• コミットメッセージは日本語を使用しても大丈夫です
• 行數を変更しないでください
  • 翻訳は翻訳元と同じ行に収めてください

基本的な表記

全角記号、全角数字、半角カタカナの仕様は禁止です

• 原文でこれらが使われていた場合はそのまま使用してください
• 〜 は文脈によっては使用しても構いません
• セリフ、会話文となっていた場合は 「」 で囲んでください
  • 鉤括弧の前後はスペースを追加します。

    友達は 「 Hono があるよ!」 と言いました。

文章中に英単語を含める場合は、前後にスペースを追加してください

In this way, Hono is a great framework.

この様に、 Hono は素晴らしいフレームワークです。

インラインコードブロックとダブルクオーテーションは例外です。

"RegExpRouter"

インラインコードブロックの前後には半角スペースを追加してください

句読点の扱い

• 句点には 。 読点には 、 を使用します
• 句点の後にはスペースを追加してください
• 改行の前にスペースは不要です
• スペースが連続する場合は1つにしてください

Hono は様々なプロフェッショナルが関わっています。 Hono は多くの不可能を可能にしてきました。

文章中で使われる括弧 () の前後には半角スペースを入れます

人生 (結婚は除く)

外部リンクされた記事の日本語版が存在する場合は、リンクを日本語版へ書き換えます

英語記事へのリンクを

https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication#basic_authentication_scheme

日本語版へのリンクに変更します。

https://developer.mozilla.org/ja/docs/Web/HTTP/Guides/Authentication#basic_認証方式

以下の言葉は翻訳しません。

• Hono
• Hono Stack
• Cloudflare Workers
• Fastly Compute
• Deno
• Bun
• Vercel
• Netlify
• AWS Lambda
• Lambda@Edge
• Node.js
• JavaScript
• TypeScript
• etc...

表記ゆれについて

以下の表に従ってください。

原語	日本語訳	備考
proxy	プロキシ
Type-Safe(ty)	型安全
MIME type(s)	MIME タイプ
Web Standard(s)	Web 標準	一部例外

TypeScript 用語は 「サバイバルTypeScript」 の 「日英対訳表」 に従ってください。

ただし、 文章中に英単語を含める場合は、前後にスペースを追加してください を優先します。

https://typescriptbook.jp/writing/japanese-english-table

原則的に単語の末尾に長音記号を付けません

パラメータ

但し、以下のリストは例外です。

• エラー
• ルーター
• サーバー
• ヘルパー
• スターター
• イノベーター
• バリデーター
• コントローラー
• イベントリスナー
• サードパーティー
• サービスワーカー

上流の変更

honojs/website に変更があった場合は以下のルールに従って取り込みます。

1. GitHub の "Update branch" 機能が使用できる場合: "Update branch" で更新します

コンフリクトが発生する場合

2. ファイルや章の追加だった場合: 新しいファイルをそのまま追加し、目次も翻訳せずに追加します
3. 大きな変更の場合: 変更で元の翻訳を上書きします
4. 小さな変更の場合: マージするときに翻訳して取り込みます