GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — ドキュメントビルドでの WARNING の解消 · Issue #770 · python-doc-ja/python-doc-ja

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

New issue
Copy link
New issue
Copy link
Open
Open
ドキュメントビルドでの WARNING の解消#770
Copy link
Assignees
cocoatomo

Description

@cocoatomo
cocoatomo
opened on Sep 4, 2017
Issue body actions

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

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

Activity

  1. cocoatomo
    self-assigned this
    on Sep 4, 2017
  2. cocoatomo commented on Sep 7, 2017

    @cocoatomo
    cocoatomo
    on Sep 7, 2017
    ContributorAuthor
    More actions

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

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

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

  3. methane commented on Sep 8, 2017

    @methane
    methane
    on Sep 8, 2017
    Contributor
    More actions

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

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

  4. cocoatomo commented on Sep 9, 2017

    @cocoatomo
    cocoatomo
    on Sep 9, 2017
    ContributorAuthor
    More actions
    • 単なる文法ミス
      • 正しい文法に直す

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

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

  5. cocoatomo commented on Sep 22, 2017

    @cocoatomo
    cocoatomo
    on Sep 22, 2017
    ContributorAuthor
    More actions

    メモ

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

    @tenmyo
    tenmyo
    on Oct 18, 2026
    More actions

    現在のビルドWARNINGはこちらになるでしょうか?
    https://translations.python.org/index.html
     -> https://translations.python.org/build-details.html
      -> https://translations.python.org/warnings-ja.txt
      -> https://translations.python.org/warnings-lint-ja.txt

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

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

    あるいはこちら?
    https://github.com/python/python-docs-ja/actions/workflows/lint-and-built.yml

  7. methane commented on Oct 25, 2026

    @methane
    methane
    on Oct 25, 2026
    Contributor
    More actions

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

  • @cocoatomo
    cocoatomo

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions

    You are visitor 01402503 — GeezerVison does not store the pages you look up.
    Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.