丸括弧の全角・半角の統一

[keiichiw]

翻訳文中に、 全角の丸括弧 （） と半角の丸括弧() が混在しているので、どちらかに統一したほうが良いと思います。

個人的には半角推しですが、クォートのかわりに全角の鉤括弧「」を使っているのにあわせて、全角にするという考えもあるかもしれません。

[tatsuya6502]

ご提案、ありがとうございます。個人的には、書式上の見栄えとか、統一感については、一通り翻訳が終わった後で、私の方で一括して修正しようかなと、（勝手に）考えてました。

私は、（英語圏ではありますが）大学でデザインを専攻して、3年ほど（英語圏で）デザインの仕事をしていました。その知識と経験から、日本語の文章では、記号類も全角のものを使うのが美しいと考えています。半角の記号は、漢字やかな文字ではなく、アルファベットに合わせてデザインされてますので、横幅以上の違いがあります。

特にカッコ類は、少し大きめのサイズで見比べてみると分かるのですが、半角のものは、全角の文字よりも、わずかに下に寄せてデザインされてます。これは、アルファベットと日本語の文字の、ベースラインの位置の違いによるものです。アルファベットには、g や y のように、下に飛び出た部分があります。半角のカッコは、これと組み合わせた時に美しく見えるよう、下に寄せてデザインされているのです。逆に ! や ? は、下の部分が少し上がって、全角の！や？よりも、縦の長さが短くなっているはずです。

ただ、現状は、contributor guide に、半角を使用と書いてあったと思うので、ほとんどは半角の記号を使っているのではないでしょうか。

すでに全体の半分以上が翻訳されているので、私としては、皆さんに戻って変更してもらうより、最後に私の方で、一括して、ほぼ機械的に修正するほうがいいのかなと思ってます。

[keiichiw]

ご返信ありがとうございます。
CONTRIBUTING.mdには「エクスクラメーションマークは半角」という指定はあったのですが、括弧などの他の記号に関しては特に明記されてないようで翻訳中に迷ったため、issueを立てさせていただいた次第でした。

最終的に半角・全角のどちらにするかは別にして、とりあえずは括弧等の記号も、原則として半角としておけば良いということですね。CONTRIBUTING.mdに追記していただけると幸いです。

最後に私の方で、一括して、ほぼ機械的に修正するほうがいいのかなと思ってます。

はい。既に翻訳されたものを含めて統一するのは、一人の方がまとめて最後に行なう方が良いというのはその通りだと思います。

[yohhoy]

👍 日本語文書に対する括弧は全角統一に賛成です。

一律変換だと「日本語(original english)」 のように記述されている箇所も対象になりますが、この部分は半角を維持した方がよいかも？（そんな細かいこと気にしないというポリシーもあるかもしれません）

[tatsuya6502]

@kw-udon さん

ああ、CONTRIBUTING.md には書かれてなかったですか。すみません。

最終的に半角・全角のどちらにするかは別にして、とりあえずは括弧等の記号も、原則として半角としておけば良いということですね。

はい、その形でお願いします。

CONTRIBUTING.mdに追記していただけると幸いです。

そうですね、決まってから書こうと思います。あと、この辺の翻訳と関係ない部分のポリシーを覚えて守るのは、皆さんにとっても負担が大きいと思います。（マークアップ前後の半角スペースとか）　そこで、フォーマット整形をするツールを Rust で作ろうと考え始めました。翻訳が終わってレビューに入る前に、皆さんにこのツールを実行してもらい、フォーマットを自動整形した上で、最終的なPRにしてもらおうかと思います。

いま私が翻訳している章が終わったら、そのツールに着手します。

[tatsuya6502]

@yohhoy さん、ありがとうございます。

一律変換だと「日本語(original english)」 のように記述されている箇所も対象になりますが、この部分は半角を維持した方がよいかも？

美しさを取ると、自然にそうすることになっちゃいますね。

一括変換といっても、今のファイルには原文やコードも一緒に書かれているので、単なるエディタでの置換はできません。全部で２万行もありますので、上にも書いたようにフォーマット整形ツールを Rust で作ろうかと思います。恐らく来週着手できるかと。Markdown のよさ気なパーサーは 見つけました 。後ほど、別途ツールの開発のための issue を上げます。

[tatsuya6502]

念のため、実際にプロが制作・運営しているサイトでは記号をどうしているか見てみました。感嘆符！と疑問符？は、私が見た以下の６サイトでは全て全角を使用。丸括弧は５つのサイトが全角丸括弧、１つは半角スペースと半角丸括弧の組み合わせでした。

全角丸括弧を使用 -- これは（見本）です

• Apple
• WIRED.jp
• ITPro（日経BP）
• 無印良品ネットストア
• 三菱東京UFJ銀行

半角スペース＋半角丸括弧を使用 -- これは (見本) です

• 日本マイクロソフト

[keiichiw]

調査ありがとうございます。全角の方が一般的なんですね。

フォーマット整形をするツールを Rust で作ろうと考え始めました。

自動化できると、後からのスタイル変更も楽なので良いですね。
よろしくお願いします。

[KeenS]

全角、半角は最初に統一しておくべきでしたね。全角に賛成します。
@tatsuya6502 さん最後の変更宜しくお願いします。

[Nnwww]

私も賛成します。
この場合、現状手を付けている部分は全角統一で翻訳していった方がいいでしょうか？
(フォーマッタが整った後の事を考えると些細な話かもしれませんが

[tatsuya6502]

皆さん、コメント、ありがとうございます。

@Nnwww さん

この場合、現状手を付けている部分は全角統一で翻訳していった方がいいでしょうか？
(フォーマッタが整った後の事を考えると些細な話かもしれませんが

返事が遅れてすみません。そうですね、もし大変でなければ、全角統一でお願いします。

[ykomatsu]

@tatsuya6502 疑問符と感嘆符については、

• 直後に全角スペースを入れる
• 直後に半角スペースを入れる
• 何も入れない

という流派もあるようなのですが、こちらはどういたしましょう。

[tatsuya6502]

@ykomatsu さん

疑問符と感嘆符については、

・直後に全角スペースを入れる
・直後に半角スペースを入れる
・何も入れない

という流派もあるようなのですが、こちらはどういたしましょう。

原稿（md ファイル）では「何も入れない」に統一しましょう。

ちなみに、HTML ページでは、原稿の改行が半角スペースとしてレンダリングされてしまうので、私が翻訳したページでも、「。！？」の後には、全て半角スペースが入ってしまってます。rustdoc と rustbook をいずれ日本語ロケールに対応させて、余計な半角スペースを入れないようにしないといけないですね。