ちょっとした「翻訳ブーム」はこうして始まった

by Haruki Tazoe

Slide 1

Slide 1 text

ちょっとした「翻訳ブーム」はこうして始まった 2025/07/19 PHPカンファレンス関西2025 田添春樹 / @jdkfx

Slide 2

Slide 2 text

2024/11/21 PHP 8.4 リリース

Slide 3

Slide 3 text

マニュアル読んでますか？

Slide 4

Slide 4 text

No content

Slide 5

Slide 5 text

マニュアルのメンテナンスどうなってるの？

Slide 6

Slide 6 text

このマニュアルについて - このマニュアルは、関数リファレンスを中心として、言語リファレンス、 PHP の主な機能、そして、その他の付録から構成されています。 - 多くの我々の活動を支援してくれる人がおり、また、過去にこのプロジェクトを支援してくれた人がいます。 - 本マニュアルの日本語への翻訳は、PHP マニュアル翻訳プロジェクトにて行われています。 PHP: 序文 - Manual https://www.php.net/manual/ja/preface.php

Slide 7

Slide 7 text

https://x.com/KentarouTakeda/status/1854461443133038899

Slide 8

Slide 8 text

https://x.com/KentarouTakeda/status/1854461446580732175

Slide 9

Slide 9 text

https://x.com/KentarouTakeda/status/1854461446580732175 もしかして貢献チャンスでは...？

Slide 10

Slide 10 text

https://x.com/KentarouTakeda/status/1854461446580732175 翻訳しながら新しい仕様・機能を勉強できるのでは...？

Slide 11

Slide 11 text

翻訳に貢献しよう！

Slide 12

Slide 12 text

日本語マニュアルリポジトリ - https://github.com/php/doc-ja - PHPマニュアルのメンテナは、以下を行います。 - 英語版のコミットを翻訳し、日本語版に反映させる - このリポジトリのPRや issueに対応する

Slide 13

Slide 13 text

環境を構築してビルドしてみる

Slide 14

Slide 14 text

PHPマニュアルのビルド方法 - PHPのマニュアルは、DocBook と呼ばれるフォーマットで記述されており、 PhD という PHPマニュアルのためのツールによってその DocBook から HTML や CHM、PDF などの複数の形式にビルドできる。 1. PHPのインストール（7.4.0以降は非推奨のPEARが必要） 2. PhDのインストール 3. マニュアルのソースをリポジトリから取得 4. HTML版の PHPマニュアルをビルドする 5. chm 版の PHPマニュアルをビルドする https://github.com/php/doc-ja/blob/master/README_Building_HOWTO.md

Slide 15

Slide 15 text

結構やることが多い… https://github.com/php/doc-ja/blob/master/README_Building_HOWTO.md

Slide 16

Slide 16 text

従来の方法でも構築を試したがうまくいかなかった...

Slide 17

Slide 17 text

環境構築を簡略化したい！

Slide 18

Slide 18 text

No content

Slide 19

Slide 19 text

Makeﬁleを作成 setup, build, xhtmlにてビルドまで一気にできる！ローカルでの差分確認も可能！ https://github.com/jdkfx/phpdoc 参考： https://doc.php.net/guide/local-set up.md

Slide 20

Slide 20 text

Makeﬁleを作成

Slide 21

Slide 21 text

環境構築が簡単！ローカルでの確認も可能！

Slide 22

Slide 22 text

環境構築が簡単！ローカルでの確認も可能！すみません、今現在なぜかビルドできません… 解決します…

Slide 23

Slide 23 text

環境構築を簡単にできるようにしたことでいろんな反応をいただきました

Slide 24

Slide 24 text

No content

Slide 25

Slide 25 text

No content

Slide 26

Slide 26 text

様々な声 - 自分は「なんか良いタイミングだし？」くらいの軽い気持ちで入っていますが、周りにも「ちょっとやってみよう！」で最近になってから参加しましたな人も増えており、少しお祭りっぽい雰囲気で楽しいですw https://daisuki.nichiyoubi.land/entry/2024/11/24/145450 - そもそもこれまで自分がOSSにPRを出す機会がなく、やり方も全然わからなかった為、自分のようにはじめてOSSにPRを出す方向けに手順を残しておきます。自分と同じようにOSSで協力したいけど、手が出すのが少しハードルが高い! と思っている方はぜひ、こちらの翻訳作業に参加してみましょう! https://zenn.dev/fendo181/articles/84074e1ce63306

Slide 27

Slide 27 text

翻訳のやり方をの中で引用 - はじめての翻訳にツールを使った確認の方法をissueのコメントに記載してくださってもらえました

Slide 28

Slide 28 text

感じたこと

Slide 29

Slide 29 text

壁のない、ゴールまで一直線に登ることができる山やりたいことを一直線にできるため、作業を始める前から完了までにストレスがかからない

Slide 30

Slide 30 text

壁があり、ゴールまで一直線に登ることができない山やりたいことを一直線にできないため、取り組む作業以外のことに注力しなければならずストレスがかかってしまうことも...

Slide 31

Slide 31 text

壁を取り除いてあげることでたくさんの人の助けにスムーズに作業が行えるように環境を整えたりサポートしたりすることは大事なこと

Slide 32

Slide 32 text

まとめ - ちょっとしたことでも環境を整えたことで、予想よりも多くの方から反応をいただけた - 自分と同じ悩みで取り掛かる手を止めてしまった方がいることを知った - 初めてのOSS貢献への貢献ができてHappy！

Slide 33

Slide 33 text

自己紹介 - 名前・所属 - 田添春樹 / @jdkfx - 株式会社GoQSystem - よく使う技術 ( 使っていた技術 ) - PHP, JavaScript, Vue.js, Svelte … - PHPとは学生時代に出会う - 個人開発や自作フレームワークの制作 - 最近はAWSにハマってる

Slide 34

Slide 34 text

ご清聴ありがとうございました！ 10月11日（土）、PHPカンファレンス広島もよろしくお願いいたします！