Skip to content

rust-lang-ja/book-ja から内容をインポート #1

New issue

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

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

Already on GitHub? # to your account

Draft
wants to merge 1 commit into
base: ja
Choose a base branch
from

Conversation

shinmili
Copy link

@shinmili shinmili commented Feb 6, 2025

Contents are imported from rust-lang-ja/book-ja@ec529e1, which is based on rust-lang/book@19c40bf.

rust-lang/book@19c40bf の版をベースに翻訳を更新した rust-lang-ja/book-ja@ec529e1 (暫定) の内容を、mdbook-i18n-helpers による管理を行うこちらのリポジトリに取り込みます。

参考: rust-lang-ja/book-ja#276

TODO

Contents are imported from rust-lang-ja/book-ja@ec529e1,
which is based on rust-lang/book@19c40bf.

Co-authored-by: HAZAMA <kotonechan@live.jp>
Co-authored-by: Sunrin SHIMURA (keen) <3han5chou7@gmail.com>
Co-authored-by: hazama_akkarin <airisuragon@gmail.com>
Co-authored-by: koka <koka.code@gmail.com>
Co-authored-by: ak1t0 <aktoo3097@gmail.com>
Co-authored-by: Takanori Ishibashi <takanori.1112@gmail.com>
Co-authored-by: Susumu Ishizuka <susumu.ishizuka@kii.com>
Co-authored-by: zaneli <shun.otani@gmail.com>
Co-authored-by: Kentaro Takei <takei.k@gmail.com>
Co-authored-by: carimatics <github.carimatics@gmail.com>
Co-authored-by: Hirokazu Hata <h.hata.ai.t@gmail.com>
Co-authored-by: nmtake <nmtake@users.noreply.github.com>
Co-authored-by: Exsgo <exsgo@exs-go.com>
Co-authored-by: ooooooo_q <ooooooo-q@users.noreply.github.com>
Co-authored-by: train12 <kotonechan@live.jp>
Co-authored-by: azu <azu@users.noreply.github.com>
Co-authored-by: suzusime <tamagawajousuiro+git@gmail.com>
Co-authored-by: Cassin01 <42632201+Cassin01@users.noreply.github.com>
Co-authored-by: Tatsuya Kawano <tatsuya@hibaridb.org>
Co-authored-by: hagure <hagure-ru@users.noreply.github.com>
Co-authored-by: KisaragiEffective <48310258+KisaragiEffective@users.noreply.github.com>
Co-authored-by: Shota Munemoto <shota.munemoto@gmail.com>
Co-authored-by: Masaru Oinaga <teufelkonig@gmail.com>
Co-authored-by: Igaguri <igagurimk@gmail.com>
Co-authored-by: Hiro Ono <highfronter@gmail.com>
Co-authored-by: toku-sa-n <tokuchan3515@gmail.com>
Co-authored-by: Shogo Kagenaga <s.kagenaga@gmail.com>
Co-authored-by: aoisensi <aoisensi@users.noreply.github.com>
Co-authored-by: woodyZootopia <piequalsabout314159@gmail.com>
Co-authored-by: toku-sa-n <tokusan441@gmail.com>
Co-authored-by: hitsuji no shippo <43565959+hitsuji-no-shippo@users.noreply.github.com>
Co-authored-by: TonalidadeHidrica <47710717+TonalidadeHidrica@users.noreply.github.com>
Co-authored-by: neglect-yp <grandis.hebitombo@gmail.com>
Co-authored-by: Toasa <atsushi.tohyama.160.333@gmail.com>
Co-authored-by: zkitty <23345846+suricata3838@users.noreply.github.com>
Co-authored-by: mkontani <itoama@live.jp>
Co-authored-by: Hirotada Kiriyama <painapoo@gmail.com>
Co-authored-by: Jun-ya Norimatsu <do-not-send-to-this-address@jnory.com>
Co-authored-by: rsk0315 <rsk0315@icloud.com>
Co-authored-by: Kohei Sugimoto <18735471+kohbis@users.noreply.github.com>
Co-authored-by: Tatsuya Kawano <gh@hibaridb.org>
Co-authored-by: bn-e (CircleCI) <bn-e@hibaridb.org>
Co-authored-by: yiskw713 <i.yuchi713@gmail.com>
Co-authored-by: scivola <scivola@users.noreply.github.com>
Co-authored-by: Kazune Takahashi <kazunetakahashi@gmail.com>
Co-authored-by: Kosuke YOSHIMOTO <kosuke.yoshimoto@gmail.com>
Co-authored-by: たた <pf35301@gmail.com>
Co-authored-by: Thomas <50320710+thetkay@users.noreply.github.com>
Co-authored-by: Satoshi KOJIMA <skoji@skoji.jp>
Co-authored-by: puripuri2100 <puripuri2100@gmail.com>
Co-authored-by: toof <toof.jp.mail@gmail.com>
Co-authored-by: Kite <ixkaito@gmail.com>
Co-authored-by: Yusuke Nojima <nojima@ynojima.com>
Co-authored-by: taku-a11y <78937440+taku-a11y@users.noreply.github.com>
Co-authored-by: tmsc4zht <79966690+tmsc4zht@users.noreply.github.com>
Co-authored-by: Nash <snamiki1212@gmail.com>
Co-authored-by: snamiki1212 <snamiki1212@gmail.com>
Co-authored-by: m-shaka <buddha0818@gmail.com>
Co-authored-by: m-shaka <motoki.syakagori@kabuku.co.jp>
Co-authored-by: sozysozbot <sozysozbot@gmail.com>
Co-authored-by: emergent <yosikawa@gmail.com>
Co-authored-by: YOSHIMURA Yuu <yyu@mental.poker>
Co-authored-by: numb86 <16703337+numb86@users.noreply.github.com>
Co-authored-by: Hiroki Tokunaga <tokusan441@gmail.com>
Co-authored-by: Shotaro Tsuji <Shotaro.Tsuji@gmail.com>
Co-authored-by: ukikagi <ukikagi@users.noreply.github.com>
Co-authored-by: Nobuki Fujii <45781612+noi@users.noreply.github.com>
Co-authored-by: Horimoto Yasuhiro <horimoto@clear-code.com>
Co-authored-by: Takahiro Itazuri <77261350+zulinx86@users.noreply.github.com>
Co-authored-by: Masahiro Sakai <masahiro.sakai@gmail.com>
Co-authored-by: ice-creamer <ydoi@mac.com>
Co-authored-by: Taiki Sugawara <buzz.taiki@gmail.com>
Co-authored-by: Koichi ITO <koic.ito@gmail.com>
Co-authored-by: maekawatoshiki <konndennsa@gmail.com>
Co-authored-by: hirosuke29 <h2so4@mineo.jp>
Co-authored-by: HansRobo <pythagora.yoshimoto@gmail.com>
Co-authored-by: mirumi <mail@mirumi.me>
Co-authored-by: Yoshihide Jimbo <yjimbo@gmail.com>
Co-authored-by: ksera524 <ksera631@gmail.com>
Co-authored-by: Shuhei Matsuoka <matsuokashuheiii@gmail.com>
Co-authored-by: ucciQun <51139842+ucciqun@users.noreply.github.com>
Co-authored-by: hirasawayuki <hirasawa.yuki@zaim.co.jp>
Co-authored-by: fura2 <yamazoe0577@gmail.com>
@shinmili shinmili marked this pull request as draft February 6, 2025 03:35
@dalance
Copy link
Collaborator

dalance commented Feb 6, 2025

  • 右上の GitHub アイコンのリンク先が rust-lang/book になっている。book.toml を変更する必要がありそうだがどうするか?

rust-lang-translation.orgではそこのリンクは外部から上書きして正しいリポジトリを指すようにしました。

  • 「はじめに」の Ferris くんアイコンの凡例表が崩壊している

これはおそらくmdbook-i18n-helpersのバグなので報告して修正する必要があります。

  • 第 14 章と第 15 章の図の img タグに対応する msgid が無いので、alt の訳が失われている

こちらもmdbook-i18n-helpersへの機能追加になりますね。

  • 訳注ブロックの扱いをどうするか?(とりあえず、直前や直後の段落に無理矢理足して book-ja の内容と合わせている。そもそも gettext では段落の追加は想定されていなさそう)

確かにgettextのフォーマットではそういったものは想定されていなさそうなので現状の回避策しかなさそうです。

@dalance
Copy link
Collaborator

dalance commented Feb 6, 2025

こちらもmdbook-i18n-helpersへの機能追加になりますね。

こちら勘違いしていたのですが、alt が抽出されないのではなくてimg 全体が抽出されないならおそらくバグですね。

@shinmili
Copy link
Author

shinmili commented Feb 9, 2025

  • 右上の GitHub アイコンのリンク先が rust-lang/book になっている。book.toml を変更する必要がありそうだがどうするか?

rust-lang-translation.orgではそこのリンクは外部から上書きして正しいリポジトリを指すようにしました。

もしこの状態で公開したら日本語訳関連の issue を本家に立ててしまう人が現れるのではないかという懸念と、language switcher を使うなら特定の言語のリポジトリを指定することもできないからどうしようかという課題でした。rust-lang-translations に取り込んで公開する前提であれば、その心配は無さそうですね。

ところで、rust-lang-translations に取り込むフローがまだちょっと分かっていません。README を読んだのですが、Rust by Example のフローとは違って、各言語のリポジトリは個別管理されている必要は無いということでしょうか? このリポジトリは Rust by Example のフローで作業する想定で作ったので今ここにあるだけで、rust-lang-translations にすべて統合するならこのリポジトリは極論別になくてもいい……?


  • 「はじめに」の Ferris くんアイコンの凡例表が崩壊している
  • 第 14 章と第 15 章の図の img タグに対応する msgid が無いので、alt の訳が失われている

最初のコメントに対応する mdbook-i18n-helpers 側の issue/PR へのリンクを追記しました。後者のほうは仕様の可能性もあるかと思ったので、ひとまず理由の確認から始めています。


  • 訳注ブロックの扱いをどうするか?(とりあえず、直前や直後の段落に無理矢理足して book-ja の内容と合わせている。そもそも gettext では段落の追加は想定されていなさそう)

確かにgettextのフォーマットではそういったものは想定されていなさそうなので現状の回避策しかなさそうです。

やはりそうですよね。個人的にはインラインの訳注に変えてもいいのではと思ったりするのですが、ひとまずはインポートということでこのままにしておきます。問題が発生したらまた考えましょう。

@dalance
Copy link
Collaborator

dalance commented Feb 9, 2025

ところで、rust-lang-translations に取り込むフローがまだちょっと分かっていません。README を読んだのですが、Rust by Example のフローとは違って、各言語のリポジトリは個別管理されている必要は無いということでしょうか? このリポジトリは Rust by Example のフローで作業する想定で作ったので今ここにあるだけで、rust-lang-translations にすべて統合するならこのリポジトリは極論別になくてもいい……?

READMEのコマンドを実行すると、 translations.toml にbookの日本語のエントリができるのと、 translations/book/ja.po が生成されるので、それを実際のPOに置き換えてPRを出してもらえれば大丈夫です。

RBEのときは翻訳に関する議論を本家でやるわけにはいかないので、rust-lang-jaにフォークしましたが、rust-lang-translationsは翻訳専用なので、全員が直接あのリポジトリのPRやissueで議論してもいいかもしれないと思っています。

@dalance
Copy link
Collaborator

dalance commented Feb 9, 2025

リポジトリ名が rust-lang-translations/project だとフォークやクローンしたときによくわからないことになるので rust-lang-translations/translations に変更しました。

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

Successfully merging this pull request may close these issues.

2 participants