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)
   

   View Slide

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
   

   View Slide

3. WordPress の情報
   • 情報全般
   • ユーザー向けドキュメント
   • 開発者向けドキュメント
   2017/1/29 WordBench Tokyo January - WordPress latest document information 3
   

   View Slide

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 発売
   著: 野島祐慈、菱川拓郎、
   杉田知至、細谷崇、枢木くっくる
   

   View Slide

5. (勝手に)新刊紹介 2/3
   • 初心者ユーザー～
   • 人気講師
   – 石川栄和
   – 大串肇
   – 星野邦敏
   2017/1/29 WordBench Tokyo January - WordPress latest document information 5
   改訂
   第3版
   「いちばんやさしいWordPressの教本
   第3版 人気講師が教える本格Web
   サイトの作り方」 2017/2/24 発売
   著: 石川栄和、大串肇、星野邦敏
   • 表紙の似顔絵の変遷
   に注目
   

   View Slide

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 は大文字!
   

   View Slide

7. Capital P
   • 日本語で読める WordPress 情報サイト
   • 「WordPressエキスパートによるデジタル・メディアハブ」
   エキスパート:
   – 高橋 文樹
   – 西川 伸一
   – 宮内 隆行
   2017/1/29 WordBench Tokyo January - WordPress latest document information 7
   https://capitalp.jp/
   

   View Slide

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
   

   View Slide

9. (おまけ) 関数 capital_P_dangit
   • 関数リファレンス/capital_P_dangit
   – "Wordpress" という誤った表記を "WordPress" に変
   更します。
   – WordPress はこれを the content、the title、
   comment text のフィルターで使用します。
   –
   2017/1/29 WordBench Tokyo January - WordPress latest document information 9
   https://wpdocs.osdn.jp/関数リファレンス/capital_P_dangit
   

   View Slide

10. WordPress の情報
    • 情報全般
    • ユーザー向けドキュメント
    • 開発者向けドキュメント
    2017/1/29 WordBench Tokyo January - WordPress latest document information 10
    

    View Slide

11. WordPress 公式マニュアル Codex
    – WordPress 知識の百科事典
    2017/1/29 WordBench Tokyo January - WordPress latest document information 11
    http://wpdocs.osdn.jp
    

    View Slide

12. Codex 英語版、あるいは本家版
    – WordPress 知識の百科事典
    2017/1/29 WordBench Tokyo January - WordPress latest document information 12
    https://codex.wordpress.org
    

    View Slide

13. 日本版 = 本家版の翻訳 + 独自記事
    • 独自記事
    – インストール情報
    – レンタルサーバー情報
    – 文字列に関する注記
    2017/1/29 WordBench Tokyo January - WordPress latest document information 13
    翻訳
    追記
    

    View Slide

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
    

    View Slide

15. • 現在、コンテンツ、テーマ共に開発中
    HelpHub
    2017/1/29 WordBench Tokyo January - WordPress latest document information 15
    http://wphelphub.com/design-and-layout/navigation-menus/
    

    View Slide

16. HelpHub 開発 Slack (2016/12/21)
    • (意訳) Travis CI 化したよ。エラーがいっぱいある
    けど、初心者向きだから、トライしてみてね」
    • ... が、#docs ということもあって、このあと動きなし
    2017/1/29 WordBench Tokyo January - WordPress latest document information 16
    

    View Slide

17. HelpHub 開発 Slack (2016/12/21)
    • ... 宮内さん登場。
    • 怒涛のプルリクで「good-first-bugs」殲滅...。
    • ほめられてました。wp-cli だよね? とも
    2017/1/29 WordBench Tokyo January - WordPress latest document information 17
    

    View Slide

18. HelpHub テーマ開発に日本人多数!
    • 宮内さん
    • とろゆにさん
    • 岡本さん
    2017/1/29 WordBench Tokyo January - WordPress latest document information 18
    

    View Slide

19. WordPress の情報
    • 情報全般
    • ユーザー向けドキュメント
    • 開発者向けドキュメント
    2017/1/29 WordBench Tokyo January - WordPress latest document information 19
    

    View Slide

20. Developer Resources
    2017/1/29 WordBench Tokyo January - WordPress latest document information 20
    • 開発者向け情報ポータル
    https://developer.wordpress.org/
    

    View Slide

21. Code Reference
    • 関数、フック、クラス、メソッドの検索
    2017/1/29 WordBench Tokyo January - WordPress latest document information 21
    https://developer.wordpress.org/reference/
    

    View Slide

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
    

    View Slide

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のカス
    タマイズがわかる本」
    著:相原 知栄子、
    大曲 仁
    

    View Slide

24. Plugin Developer Handbook
    • プラグイン開発者向け
    • 幅広く網羅されている印象
    • 日本語情報なら...
    2017/1/29 WordBench Tokyo January - WordPress latest document information 24
    http://amzn.to/2krdmIe
    「サイトの拡張性を飛躍的に高
    める WordPressプラグイン開
    発のバイブル」
    著: 宮内 隆行、西川 伸一、
    岡本 渉、三好 隆之
    

    View Slide

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
    

    View Slide

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/
    

    View Slide

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/
    

    View Slide

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_の翻訳/翻訳ガイドライン
    

    View Slide

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
    翻訳しました。
    

    View Slide

30. コーディング規約 日本語訳版
    • 言語ごとの規約
    – CSS コーディング規約
    – HTML コーディング規約
    – JavaScript コーディング規約
    – PHP コーディング規約
    • アクセシビリティ規約
    • インラインドキュメント規約
    – PHP ドキュメント規約
    – JavaScriptドキュメント規約
    2017/1/29 WordBench Tokyo January - WordPress latest document information 30
    http://wpdocs.osdn.jp/WordPress_コーディング規約
    

    View Slide

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
    

    View Slide

32. 最後に、これからの最新情報の取得方法
    • 開発コミュニティを追いかける
    – ここにしかないもの、他ではドキュメント化されていないものが
    多数含まれます。
    – Slack
    – Make Core (https://make.wordpress.org/core/)
    • 日本語情報なら...
    – Capital P
    – 本資料で名前を挙げた方(著者含む)、今日登壇している人
    のフォロー
    32
    WordBench Tokyo January - WordPress latest document information
    2017/1/29
    

    View Slide

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
    

    View Slide