Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

世界のSphinx事情 @ SphinxCon JP 2015

1,985 views

Published on

世界のSphinx事情と日本での情報源を紹介

Published in: Technology
  • Be the first to comment

世界のSphinx事情 @ SphinxCon JP 2015

  1. 1. 1 Takayuki Shimizukawa Sphinx co-maintainer Sphinx-users.jp
  2. 2. おまえ誰よ @shimizukawa(清水川)  Sphinx メンテナ  Sphinx-users.jp  一般社団法人PyCon JP 理事  Python mini hack-a-thon運営 2
  3. 3. 3
  4. 4. gihyo.jpさんで記事を書きました  海外PyCon発表修行レポート2015  http://gihyo.jp/news/report/01/overseas-pycon- presentation-training-2015/ 4
  5. 5.  2015/6/5(金)~6/8(月)  今年3回目のPyCon, 参加 ??名(700くらいかな)  台湾のSphinx事情  発表参加者: 50名  Q&A: 4個  Sphinxを知ってる人 -> 50人中3人  Sphinxで作られているPython公式ドキュメントは全員が読 んだことがある  reStructuredText記法を知ってる -> 10人  Markdown記法を知っている -> 0人  ドキュメントを書いている -> 0人  Sphinxって? -> 会社名?(という人も居た) PyCon APAC 2015 (Taiwan) 5
  6. 6. PyCon Singapore 2015  2015/6/17(水)~6/19(金)  今年6回目の開催、参加 100名  シンガポールのSphinx事情  発表参加者: 13名  Q&A: 1個  不明(たぶんそんなに使われていない)  シンガポールのPyConが学会っぽい雰囲気が強い  PyData系の話が多かったイメージ 6
  7. 7. EuroPython 2015  2015/7/20(月)~7/26(日)  今年14回目の開催, 参加 1,100名  ヨーロッパのSphinx事情  発表参加者: 100名  Q&A: 4個  みんな普通に使っている  Pythonコードから生成するautodocもあたりまえ  「"ドキュメントを書く"とは何か」、にフォーカスが 移っている 7
  8. 8. PyCon Malaysia 2015  2015/8/21(金)~8/23(日)  今年初めてのPyCon, 参加 110名  マレーシアのSphinx事情  発表参加者: 10名  Q&A: 2個  不明(そんなに使われてなさそう)  "docstringを書いたことがある人" -> 40人中、20人  "docstringでAPIリファレンスを生成したことがある人 " ->0 8
  9. 9. PyCon Korea 2015  2015/8/29(土)~8/30(日)  今年2回目のPyCon, 参加 650名  韓国のSphinx事情  発表参加者: 100名  Q&A: 10個  Sphinxを知っていますか? - 60%  Sphinxを使っていますか? - 30%  Docstringを知っていますか?- 90%  docstringを使ってAPIドキュメントを書いたことがあ りますか? - 10% 9
  10. 10. PyCon JP 2015  2015/10/08(金)~11/11(月)  今年5回目のPyCon, 参加 602名  日本のSphinx事情  発表参加者: 100名  Q&A: 3個  Sphinxを知っていますか? - 90%  Docstringを知っていますか?- 90%  docstringを使ってAPIドキュメントを書いたことがあ りますか? - 10% 10
  11. 11. 11
  12. 12. さまざまな情報源  書籍  Sphinxをはじめよう (O'reilly)  SoftwareDesignのSphinx連載2015年4月号~  他  ネット  sphinx, docutils  sphinx-users.jp  イベント  SphinxCon  PyCon JP  Sphinx+翻訳 Hack-a-thon  Sphinx Tea Night 12 5. Sphinxの情報源
  13. 13. Sphinxをはじめよう(O'Reilly 2013)  Sphinx のみを扱った電子書籍  紙の本で100ページ相当  Sphinxのインストールから、HTML, PDF, EPUBの出 力方法について、reSTの記法について。  付録に、よく使うreST の文法を掲載  Sphinxを始める人、 必携の書!  本日、2刷り & PDF! 13 5. Sphinxの情報源 - 書籍 http://www.oreilly.co.jp/books/9784873116488/
  14. 14. SoftwareDesign Sphinx連載  2015年4月号~ Sphinx 連載開始!  6ページ/号, Sphinx短信を不定期掲載  4月: Sphinxで始めるドキュメント作成術  5月: 議事録を書こう(前編)  6月: 議事録を書こう(後編)  7月: テーブルを使いこなそう  8月: 目次,用語集,索引を付けよう  9月: サイトを作ろう(前編)  10月: サイトを作ろう(後編)  11月: HTMLテーマをカスタマイズしてみよう  12月: さまざまな方法で図を作ろう  1月: テキストマークアップから図を生成する 14 5. Sphinxの情報源 - 書籍 http://gihyo.jp/magazine/SD/archive/2015/201504
  15. 15. エキPy / PyPro1, 2  いくつかのPythonの本に、Sphinxを扱った章があり ます。  コラムで触れている本も含めるともう何冊かありそ う 15 5. Sphinxの情報源 - 書籍 PyPro 1 エキPy 2012年 2010年 PyPro 2 2015年
  16. 16. Sphinx, docutils本家ドキュメント 16 5. Sphinxの情報源 - ネット  Sphinx本家: http://sphinx-doc.org/  Docutils本家: http://docutils.sourceforge.net/  英語です
  17. 17.  本家ドキュメントにはない、さまざまな情報を複数 の切り口で提供。MLの案内もここに。  サイト自体Sphinxで作っています  Twitter: @sphinxjp #sphinxjp  Slack: sphinxjp.herokuapp.com Sphinx-users.jp 17 5. Sphinxの情報源 - ネット
  18. 18. Sphinx, docutils本家ドキュメントの翻訳  リファレンスを日本語に翻訳してあります  Sphinx: http://docs.sphinx-users.jp/ 90%翻訳済み  Docutils: http://docutils.sphinx-users.jp/ 一部翻訳済 み 18 5. Sphinxの情報源 - ネット
  19. 19. SphinxCon JP 2015  2012年以降、年に1回開催。  今年は 11月24日(火) 19時~ 渋谷にて開催  プレゼン6つ、LT3つ  Hack-a-thonや ハンズオンは無し  参加者(10人~40人)  ドキュメントに関わる人  関連ツールに関わる人  時々出版関係者 19 5. Sphinxの情報源 - イベント SphinxCon JP 2014 sphinxjp.connpass.com
  20. 20. PyCon JP 20 5. Sphinxの情報源 - イベント  Pythonの年次イベント。Sphinx-usres.jp として参加してイベントを併設しています。pycon.jp/2015/ ポスターセッション スプリント ハンズオン(有料)
  21. 21. Sphinx+翻訳 Hack-a-thon  月1回開催。週末の午後 (6h)  Sphinxや翻訳に興味のある人が集まって、それぞれ 自分の課題を進めたり、他の人に色々聞いたり、雑 談したり。  参加者(4人~8人)  Sphinxに興味のある方  ドキュメントに興味のある方  翻訳に興味のある方  場所: 東京曙橋か新宿の某社 5. Sphinxの情報源 - イベント 21 sphinxjp.connpass.com hack-a-thon
  22. 22. Sphinx Tea Night (お茶会) 22 5. Sphinxの情報源 - イベント  月1回開催。平日の夜 (2h)  Sphinxや翻訳に興味のある人が集まって、雑談して ます。  参加者(3人~6人)  Sphinxに興味のある方  ドキュメントに興味のある方  なんとなく雑談したい方  場所: 東京市ヶ谷のデニーズ Tea Night

×