Upgrade to Pro — share decks privately, control downloads, hide ads and more …

WordPress ドキュメント最新情報 - WordPress latest documen...

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

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

Akira Tachibana

January 29, 2017
Tweet

More Decks by Akira Tachibana

Other Decks in Technology

Transcript

  1. 自己紹介 • 立花 明 • 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
  2. (勝手に)新刊紹介 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 発売 著: 野島祐慈、菱川拓郎、 杉田知至、細谷崇、枢木くっくる
  3. (勝手に)新刊紹介 2/3 • 初心者ユーザー~ • 人気講師 – 石川栄和 – 大串肇

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

    information 6 「2chまとめをWordpressで構築して 月50万稼ぐ戦略!: 月間PV1億、 月1000万稼ぐ猛者もいる2chまとめ 業界をWordpressから分析!」 (Kindle版) 2016/12/6 発売 著: kobayakawa P は大文字!
  5. Capital P • 日本語で読める WordPress 情報サイト • 「WordPressエキスパートによるデジタル・メディアハブ」 エキスパート: –

    高橋 文樹 – 西川 伸一 – 宮内 隆行 2017/1/29 WordBench Tokyo January - WordPress latest document information 7 https://capitalp.jp/
  6. 硬軟、公式非公式、国内外幅広く • 動向 – トランプ大統領就任に伴い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
  7. (おまけ) 関数 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
  8. 日本版 = 本家版の翻訳 + 独自記事 • 独自記事 – インストール情報 –

    レンタルサーバー情報 – 文字列に関する注記 2017/1/29 WordBench Tokyo January - WordPress latest document information 13 翻訳 追記
  9. 英語版 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
  10. • 現在、コンテンツ、テーマ共に開発中 HelpHub 2017/1/29 WordBench Tokyo January - WordPress latest

    document information 15 http://wphelphub.com/design-and-layout/navigation-menus/
  11. HelpHub 開発 Slack (2016/12/21) • (意訳) Travis CI 化したよ。エラーがいっぱいある けど、初心者向きだから、トライしてみてね」

    • ... が、#docs ということもあって、このあと動きなし 2017/1/29 WordBench Tokyo January - WordPress latest document information 16
  12. HelpHub 開発 Slack (2016/12/21) • ... 宮内さん登場。 • 怒涛のプルリクで「good-first-bugs」殲滅...。 •

    ほめられてました。wp-cli だよね? とも 2017/1/29 WordBench Tokyo January - WordPress latest document information 17
  13. Developer Resources 2017/1/29 WordBench Tokyo January - WordPress latest document

    information 20 • 開発者向け情報ポータル https://developer.wordpress.org/
  14. 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
  15. 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のカス タマイズがわかる本」 著:相原 知栄子、 大曲 仁
  16. Plugin Developer Handbook • プラグイン開発者向け • 幅広く網羅されている印象 • 日本語情報なら... 2017/1/29

    WordBench Tokyo January - WordPress latest document information 24 http://amzn.to/2krdmIe 「サイトの拡張性を飛躍的に高 める WordPressプラグイン開 発のバイブル」 著: 宮内 隆行、西川 伸一、 岡本 渉、三好 隆之
  17. 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
  18. その他のハンドブック • https://make.wordpress.org/ -> カテゴリー(例: Core, Polyglots(翻訳) 等) -> Handbook

    2017/1/29 WordBench Tokyo January - WordPress latest document information 26 https://make.wordpress.org/polyglots/handbook/
  19. 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/
  20. 日本語翻訳ガイドライン (抜粋) • 半角英字、半角記号の前後には半角スペースあり – 例: 「この 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_の翻訳/翻訳ガイドライン
  21. 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 翻訳しました。
  22. コーディング規約 日本語訳版 • 言語ごとの規約 – CSS コーディング規約 – HTML コーディング規約

    – JavaScript コーディング規約 – PHP コーディング規約 • アクセシビリティ規約 • インラインドキュメント規約 – PHP ドキュメント規約 – JavaScriptドキュメント規約 2017/1/29 WordBench Tokyo January - WordPress latest document information 30 http://wpdocs.osdn.jp/WordPress_コーディング規約
  23. コーディング規約 (抜粋) • 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
  24. 最後に、これからの最新情報の取得方法 • 開発コミュニティを追いかける – ここにしかないもの、他ではドキュメント化されていないものが 多数含まれます。 – Slack – Make

    Core (https://make.wordpress.org/core/) • 日本語情報なら... – Capital P – 本資料で名前を挙げた方(著者含む)、今日登壇している人 のフォロー 32 WordBench Tokyo January - WordPress latest document information 2017/1/29