WordPress ドキュメント最新情報 - WordPress latest document information

2017年1月29日(日) WordBench東京 1月勉強会@株式会社ドワンゴ セミナールーム ショートセッション資料

Transcript

1. WordPress ドキュメント最新情報 WordPress latest document information WordBench東京 1月勉強会@株式会社ドワンゴ セミナールーム 2017年1月29日 第1.2版 立花 明 (@atachibana)
2. 自己紹介 • 立花 明 • IT 系会社に勤務 (非 WordPress) • WordPress Documentation Team • 好きなもの: 本屋と紙の本 2017/1/29 WordBench Tokyo January - WordPress latest document information 2 https://www.kinokuniya.co.jp/c/store/Shinjuku-Main-Store/20150925144602.html
3. WordPress の情報 • 情報全般 • ユーザー向けドキュメント • 開発者向けドキュメント 2017/1/29 WordBench Tokyo January - WordPress latest document information 3
4. (勝手に)新刊紹介 1/3 • エンジニア、中級ユーザー～ – 「WordPress ステップアップブック」 – 「WordPress プラグイン開発のバイブル」 – 「詳解 WordPress」等に続く • 新しい記述多数 – query_posts() 非推奨 WP_Query のオブジェクトマッピング – WP REST API の紹介 等々 • MVCフレームワーク視点あり 2017/1/29 WordBench Tokyo January - WordPress latest document information 4 「エンジニアのためのWordPress開発 入門」 2017/1/26 発売 著: 野島祐慈、菱川拓郎、 杉田知至、細谷崇、枢木くっくる
5. (勝手に)新刊紹介 2/3 • 初心者ユーザー～ • 人気講師 – 石川栄和 – 大串肇 – 星野邦敏 2017/1/29 WordBench Tokyo January - WordPress latest document information 5 改訂 第3版 「いちばんやさしいWordPressの教本 第3版 人気講師が教える本格Web サイトの作り方」 2017/2/24 発売 著: 石川栄和、大串肇、星野邦敏 • 表紙の似顔絵の変遷 に注目
6. (勝手に)新刊紹介 3/3 2017/1/29 WordBench Tokyo January - WordPress latest document information 6 「2chまとめをWordpressで構築して 月50万稼ぐ戦略！: 月間ＰＶ1億、 月1000万稼ぐ猛者もいる2chまとめ 業界をWordpressから分析！」 (Kindle版) 2016/12/6 発売 著: kobayakawa P は大文字!
7. Capital P • 日本語で読める WordPress 情報サイト • 「WordPressエキスパートによるデジタル・メディアハブ」 エキスパート: – 高橋 文樹 – 西川 伸一 – 宮内 隆行 2017/1/29 WordBench Tokyo January - WordPress latest document information 7 https://capitalp.jp/
8. 硬軟、公式非公式、国内外幅広く • 動向 – トランプ大統領就任に伴いLGBT関連の記事が削除されたのではと一悶着 – SucuriがWebサイトハッキング調査2016Q3を公表 • コミュニティ – 英語圏の WordCamp 以外の WordPress イベントってどんなのがあるのか調べてみた – WordCamp でスピーカーに交通費を出すべきか？ – WordCamp Tokyo 2017実行委員会が運営スタッフを募集開始 • 技術 – [クイズ] WordPress のテーマやプラグインで mailto: リンクの正しい記述はどれでしょう？ – ShortcakeでビジュアルエディタのショートコードUXを向上する – WordPress のドメイン名やURLを変える際の GUID 問題のちゃんとした話 2017/1/29 WordBench Tokyo January - WordPress latest document information 8
9. (おまけ) 関数 capital_P_dangit • 関数リファレンス/capital_P_dangit – "Wordpress" という誤った表記を "WordPress" に変 更します。 – WordPress はこれを the content、the title、 comment text のフィルターで使用します。 – <?php capital_P_dangit( $text ); ?> 2017/1/29 WordBench Tokyo January - WordPress latest document information 9 https://wpdocs.osdn.jp/関数リファレンス/capital_P_dangit
10. WordPress の情報 • 情報全般 • ユーザー向けドキュメント • 開発者向けドキュメント 2017/1/29 WordBench Tokyo January - WordPress latest document information 10
11. WordPress 公式マニュアル Codex – WordPress 知識の百科事典 2017/1/29 WordBench Tokyo January - WordPress latest document information 11 http://wpdocs.osdn.jp
12. Codex 英語版、あるいは本家版 – WordPress 知識の百科事典 2017/1/29 WordBench Tokyo January - WordPress latest document information 12 https://codex.wordpress.org
13. 日本版 = 本家版の翻訳 + 独自記事 • 独自記事 – インストール情報 – レンタルサーバー情報 – 文字列に関する注記 2017/1/29 WordBench Tokyo January - WordPress latest document information 13 翻訳 追記
14. 英語版 Codex もうすぐリタイヤ予定 • 2017年中 • 主な移行先 2017/1/29 WordBench Tokyo January - WordPress latest document information 14 Codex 移行先 使い方、FAQ HelpHub (移行中) 構文、関数、クラス etc. Code Reference 開発者向け情報 Theme Handbook Plugin Handbook REST API Handbook
15. • 現在、コンテンツ、テーマ共に開発中 HelpHub 2017/1/29 WordBench Tokyo January - WordPress latest document information 15 http://wphelphub.com/design-and-layout/navigation-menus/
16. HelpHub 開発 Slack (2016/12/21) • (意訳) Travis CI 化したよ。エラーがいっぱいある けど、初心者向きだから、トライしてみてね」 • ... が、#docs ということもあって、このあと動きなし 2017/1/29 WordBench Tokyo January - WordPress latest document information 16
17. HelpHub 開発 Slack (2016/12/21) • ... 宮内さん登場。 • 怒涛のプルリクで「good-first-bugs」殲滅...。 • ほめられてました。wp-cli だよね? とも 2017/1/29 WordBench Tokyo January - WordPress latest document information 17
18. HelpHub テーマ開発に日本人多数! • 宮内さん • とろゆにさん • 岡本さん 2017/1/29 WordBench Tokyo January - WordPress latest document information 18
19. WordPress の情報 • 情報全般 • ユーザー向けドキュメント • 開発者向けドキュメント 2017/1/29 WordBench Tokyo January - WordPress latest document information 19
20. Developer Resources 2017/1/29 WordBench Tokyo January - WordPress latest document information 20 • 開発者向け情報ポータル https://developer.wordpress.org/
21. Code Reference • 関数、フック、クラス、メソッドの検索 2017/1/29 WordBench Tokyo January - WordPress latest document information 21 https://developer.wordpress.org/reference/
22. Code Reference • WordPress Version 4.0 以降の情報は Code Reference のみ – Codex 本家版でもほぼ情報はありません。 • 英語のみ – 構文等はソースコードのヘッダー部に記述されたものを出力 – 使用例はコメントの形で追記 • Tips: Version 4.7 に追加された関数を調べる – https://developer.wordpress.org/reference/since/4.7.0/ 2017/1/29 WordBench Tokyo January - WordPress latest document information 22
23. Theme Developer Handbook • テーマ開発者向け • 2017年1月 第1版リリース! – 2年の月日と、3度のチーム交代 – 実体は Codex からの移植 + 一部書き換え – 最新情報に追いついていない部分もあります。 – もちろん、最新情報は多数あります! – 例: Customizer API • 日本語情報なら... 一般書籍をおすすめ 2017/1/29 WordBench Tokyo January - WordPress latest document information 23 http://amzn.to/2jvSrQd 「一歩先にいく WordPressのカス タマイズがわかる本」 著:相原 知栄子、 大曲 仁
24. Plugin Developer Handbook • プラグイン開発者向け • 幅広く網羅されている印象 • 日本語情報なら... 2017/1/29 WordBench Tokyo January - WordPress latest document information 24 http://amzn.to/2krdmIe 「サイトの拡張性を飛躍的に高 める WordPressプラグイン開 発のバイブル」 著: 宮内 隆行、西川 伸一、 岡本 渉、三好 隆之
25. REST API Handbook • REST API を利用する開発者向け • 2016年12月(?) リリース。短期間で一気に執筆 • 日本語情報なら... – WP REST API v2 Documentation http://ja.wp-api.org/ – オリジナルは API Handbook の元 2017/1/29 WordBench Tokyo January - WordPress latest document information 25
26. その他のハンドブック • https://make.wordpress.org/ -> カテゴリー(例: Core, Polyglots(翻訳) 等) -> Handbook 2017/1/29 WordBench Tokyo January - WordPress latest document information 26 https://make.wordpress.org/polyglots/handbook/
27. Translator Handbook • Glossaries and Style Guides per locale – 日本語翻訳用語集 / 日本語翻訳ガイドライン 2017/1/29 WordBench Tokyo January - WordPress latest document information 27 https://make.wordpress.org/polyglots/handbook/tools/glotpress-translate-wordpress-org/list-of-glossaries-per-locale/
28. 日本語翻訳ガイドライン (抜粋) • 半角英字、半角記号の前後には半角スペースあり – 例: 「この ID のコメントはありません。」 • 半角数字の前後には半角スペースなし – 例: 2009年5月10日12時30分48秒 – 例: 1件のコメント • 受動態は、能動態で訳す – If this command is entered, all of the files will be listed. – (誤)このコマンドが入力されると、すべてのファイル名が表示されます。 – (正)このコマンドを入力すると、すべてのファイル名が表示されます。 2017/1/29 WordBench Tokyo January - WordPress latest document information 28 https://wpdocs.osdn.jp/WordPress_の翻訳/翻訳ガイドライン
29. Core Contributor Handbook • Contribute with Testing – Tests / Automation • Contribute with Code – Coding / Git, SVN, Trac • Best Practices – Coding Standards • Tutorials & Guides – Local setup / Submit of Ticket, Patch 2017/1/29 WordBench Tokyo January - WordPress latest document information 29 翻訳しました。
30. コーディング規約 日本語訳版 • 言語ごとの規約 – CSS コーディング規約 – HTML コーディング規約 – JavaScript コーディング規約 – PHP コーディング規約 • アクセシビリティ規約 • インラインドキュメント規約 – PHP ドキュメント規約 – JavaScriptドキュメント規約 2017/1/29 WordBench Tokyo January - WordPress latest document information 30 http://wpdocs.osdn.jp/WordPress_コーディング規約
31. コーディング規約 (抜粋) • Space – function func( $p1 = ‘x’, $p2 = ‘y' ) { – foreach ( (array) $foo as $bar ) { – $x = $foo[ $bar ]; – $x = $foo['bar']; – $x = $foo[0]; • Indent = Tab, Not space 2017/1/29 WordBench Tokyo January - WordPress latest document information 31
32. 最後に、これからの最新情報の取得方法 • 開発コミュニティを追いかける – ここにしかないもの、他ではドキュメント化されていないものが 多数含まれます。 – Slack – Make Core (https://make.wordpress.org/core/) • 日本語情報なら... – Capital P – 本資料で名前を挙げた方(著者含む)、今日登壇している人 のフォロー 32 WordBench Tokyo January - WordPress latest document information 2017/1/29
33. ありがとうございました。 • このスライド – https://speakerdeck.com/atachibana/wordpr ess-dokiyumentozui-xin-qing-bao-wordpress- latest-document-information • Unofficial Tokyo Web Site – http://unofficialtokyo.com 33 WordBench Tokyo January - WordPress latest document information 2017/1/29