Skip to content
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

PHP 8.4 マニュアル翻訳状況 #150

Open
KentarouTakeda opened this issue Nov 7, 2024 · 18 comments
Open

PHP 8.4 マニュアル翻訳状況 #150

KentarouTakeda opened this issue Nov 7, 2024 · 18 comments
Labels
help wanted Extra attention is needed

Comments

@KentarouTakeda
Copy link
Collaborator

KentarouTakeda commented Nov 7, 2024

翻訳状況 一覧

  • en: 更新日: 2024-12-21 12:50 JST
  • ja: 更新日: 2024-12-27 22:10 JST

英語版ドキュメントの次のIssueに掲載されたPull Requestの翻訳状況です:

PHP 8.4向けに翻訳が必要なセクションの参考にしてください。

初めての方へ

難度の目安をアイコンで表示しています。

  • 🔰 Good First Issue。ドキュメントの構造や対象機能に精通せずとも訳せるかもしれません。
  • 💪 力試し。対象機能、またはドキュメント構造の知識がある程度求められるかもしれません。
  • 🚨 ヘビーユーザー向け。新機能や、注目すべき変更点をピックアップしました。

着手の際は、他の人と作業が被らないよう、ドラフトプルリクエストやこのIssueへのコメントで宣言すると良いかもしれません。

このIssueをご覧になった皆様へ

レビューはどなたでも歓迎しています。

Approveボタンを押せない場合、コメントでLGTMを頂ければ参考にします。レビューが難しい場合、足跡(スタンプ)を頂ければ、皆のモチベーションに繋がります。

マニュアル

シグネチャ

英語版もまだ多くが完了していないため、このリストは随時追加される可能性があります。

@KentarouTakeda KentarouTakeda pinned this issue Nov 7, 2024
@jdkfx
Copy link
Contributor

jdkfx commented Nov 9, 2024

@KentarouTakeda
php/doc-en#3992 を取り込む際に確認したのですが、以下のファイルの翻訳が追いついていないようでしたのでこちらでファイルのblame見つつ翻訳追加していきます。
https://github.com/php/doc-en/blame/master/language-snippets.ent

@KentarouTakeda KentarouTakeda added the help wanted Extra attention is needed label Nov 10, 2024
@KentarouTakeda
Copy link
Collaborator Author

php/doc-en#3872 は現在更新されていないようなので Milestone / PHP 8.4 / Closed から最近の英語版の追加分を取得し、一覧を更新しました。

@KentarouTakeda
Copy link
Collaborator Author

難度の目安(私見)をアイコンにしました。
迷った際の着手の参考にしてください!

@asumikam
Copy link
Contributor

@KentarouTakeda

上記を対応しようと思ったのですが、#183 (comment) な理由で作業が不要そうです!🙇‍♀️

@KentarouTakeda
Copy link
Collaborator Author

@asumikam
ありがとうございます。すみません、お手数おかけしました。
(マージに至らずとも、仕分けが進むだけで大助かりです!!)

@naopusyu
Copy link

@KentarouTakeda

下記は f96063d にて翻訳済みな感じですね!

@asumikam
Copy link
Contributor

asumikam commented Nov 23, 2024

昨日はじめて翻訳作業をした俺が、PHPマニュアル翻訳のやりかたを解説(忘備録)

事前に読む

対応する

  • 対応する(php-en PRと呼びます)PRを決める
  • php-en PRが最新の変更なのかを一応確認すると安心する
    • File Changedタブ > View file でphp-en PRに積まれているcommitと一緒だよな、を確認すると良い
    • スクリーンショット 2024-11-23 9 48 53
  • 空commitで draftなPRを作り、「やってるよ」を表明する
    • スクリーンショット 2024-11-23 9 59 37
    • descriptionでこのissueをコール&php-en PRを貼っておくと良さそう、と思っています
  • 翻訳作業をする
    • 基本的には比べっこして、追加修正ならブロックを適切な場所において日本語にする
      • https://github.com/php/doc-ja/blob/master/README_Glossary.md を読むとフムフムとなったりします
      • 「この単語(熟語)なんと訳してるんだろう・・・?」は、PHPマニュアルのenバージョンで同じものを探して、日本語マニュアルでなんと訳していそうかを調べたりしました
    • すでに日本語訳があるものもあります!その場合はメンションしてお知らせしましょう
  • https://github.com/jdkfx/phpdoc で、セルフレビュー(確認)する
    • 画面で自分の修正がみれて最高🎉

→ ここまでできてヨシっとなったら空commitをdropしてforce pushして、ready for reviewなPRにしています。
commitやPRタイトルは、なんとなくまわりをみて、[PHP 8.4] HonyaHonyaHonya の翻訳としています。

@Fendo181
Copy link
Contributor

@asumikam さんが書いてくれた方法がわかりやすく、自分も翻訳参加できそうだと思ったのでPR用意します! 🙏

こちらのPRを翻訳予定です。
php/doc-en#3901

@SakiTakamachi
Copy link
Member

BCMathは、原文がひと段落したら自分で翻訳書きます :)

@KentarouTakeda
Copy link
Collaborator Author

着手は数日後になってしまいそうですが php/doc-en#4115 は私が担当しようと思ってます。
(分量が膨大・DBは自分の専門分野)

@Ippey
Copy link
Contributor

Ippey commented Dec 7, 2024

↓頑張ります。

@siwa32
Copy link
Contributor

siwa32 commented Dec 12, 2024

php/doc-en#4083

こちらの作業致します

@siwa32
Copy link
Contributor

siwa32 commented Dec 15, 2024

コレ翻訳します

@siwa32
Copy link
Contributor

siwa32 commented Dec 20, 2024

  1. PHP 8.4: Document reflection changes doc-en#4037
  2. [PHP 8.4] Add class constant types for Reflection doc-en#4244

こちらの取り込みをします。
2は上記リストにありませんが、1と修正されたファイルがかぶっているので一緒に行ってしまおうかと思います。

@siwa32
Copy link
Contributor

siwa32 commented Dec 21, 2024

php/doc-en#3872 から上記リストにないものを抜き出してみました。
機械的に抽出しただけで中身は見ていないので、抜け漏れや無関係な物が混じってしまっているかもしれません。

@KentarouTakeda
Copy link
Collaborator Author

@siwa32
ありがとうございます!私の方でも未確認なのですが 🆕 を付けてリストに反映させて頂きました。
(更新が追いついておらず申し訳ないです!)

@siwa32
Copy link
Contributor

siwa32 commented Dec 24, 2024

はプルリクではなくIssueでしたので、翻訳リストに含めなくてよいものでした。
上記のリストに対象外も混じってしまいました。失礼しました。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
help wanted Extra attention is needed
Projects
None yet
Development

No branches or pull requests

9 participants