ドキュメントビルドでの WARNING の解消

にあるように, ビルド時に大量の WARNING が出ている.
これらの WARNING が出ないように訳文を修正する.

いくつか訳文を修正してみてパターンが見えてきたので, 修正方針と一緒にここに列挙する.

単なる文法ミス
- 正しい文法に直す
飜訳の都合上, 参照 (term, ref, etc.)の数が食い違うもの (代名詞の展開, 訳注, etc.)
- 日本語の文章としては正しいので, 今のところは据え置き
- たいていは代名詞を展開したパターンなので, 数が同じになるように該当する部分は参照にしないという方法も考えられる
(おそらく親切のため) 原文には無い term や ref などを追加したもの
- 読み手にメリットがありそうなので, 今のところは据え置き
- できれば原文に対して bpo に issue を上げて欲しいが, 作業負荷が高いのでそこまでは求めない

この方針へのコメントも歓迎です.

term に関しては、その説の最初の言及だけ :term: にして、それ以降は :term: なしで
使っていいと思うんですよね。
とはいえ、翻訳する文章だけじゃなくて説全体を見ないといけなくなるので、ルール化して
強制するのは難しいですが。

warning の分類もしないといけないかも。

単なる文法ミス

正しい文法に直す

ここに関してはだいたい直せました.

文章量は膨大なので, 焦らず少しずつやっていきましょう.

メモ

現時点では次の感じでした。
Last update: 2026/10/17 23:47:58
Sphinx build warnings: 345
lint failures: 342

lintは機械的に直せるのが多そうですね。ただTransifex上で該当箇所を探すのは少し面倒そうです。

codexに全部を修正させてtx pushしました。

Navigation Menu