Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
cocoatomo opened this issue Sep 4, 2017 · 4 comments
Open

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

cocoatomo opened this issue Sep 4, 2017 · 4 comments
Assignees

Comments

@cocoatomo
Copy link
Contributor

https://travis-ci.org/python-doc-ja/py36-locale/builds/271285392#L969

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

@cocoatomo cocoatomo self-assigned this Sep 4, 2017
@cocoatomo
Copy link
Contributor Author

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

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

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

@methane
Copy link
Contributor

methane commented Sep 8, 2017

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

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

@cocoatomo
Copy link
Contributor Author

  • 単なる文法ミス
    • 正しい文法に直す

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

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

@cocoatomo
Copy link
Contributor Author

メモ

  • c:func role
    • () が末尾に追加され見た目が変わり過ぎるのでいったん据え置き, :c:func: を付けたままにする
  • c:macro role
    • こちらはフォントが変わる程度なので :c:macro: は外す

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants