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.

of

How to spread reST and Sphinx Slide 1 How to spread reST and Sphinx Slide 2 How to spread reST and Sphinx Slide 3 How to spread reST and Sphinx Slide 4 How to spread reST and Sphinx Slide 5 How to spread reST and Sphinx Slide 6 How to spread reST and Sphinx Slide 7 How to spread reST and Sphinx Slide 8 How to spread reST and Sphinx Slide 9 How to spread reST and Sphinx Slide 10 How to spread reST and Sphinx Slide 11 How to spread reST and Sphinx Slide 12 How to spread reST and Sphinx Slide 13 How to spread reST and Sphinx Slide 14 How to spread reST and Sphinx Slide 15 How to spread reST and Sphinx Slide 16 How to spread reST and Sphinx Slide 17 How to spread reST and Sphinx Slide 18 How to spread reST and Sphinx Slide 19 How to spread reST and Sphinx Slide 20 How to spread reST and Sphinx Slide 21 How to spread reST and Sphinx Slide 22
Upcoming SlideShare
Sphinxで作る貢献しやすい ドキュメント翻訳の仕組み
Next
Download to read offline and view in fullscreen.

6 Likes

Share

Download to read offline

How to spread reST and Sphinx

Download to read offline

How do I spread reStructuredText and Sphinx to my project team.

Related Books

Free with a 30 day trial from Scribd

See all

Related Audiobooks

Free with a 30 day trial from Scribd

See all

How to spread reST and Sphinx

  1. 1. How to spread reST and Sphinx 2012-09-16 Sphinx Con JP 2012(#sphinxconjp) Takanori Suzuki(@takanory)
  2. 2. Who am I(お前誰よ) • 鈴木 たかのり/ Takanori Suzuki • Twitter: @takanory • http://takanory.net/ • PyCon JP 2011, 2012 Staff • Python mini Hack-a-thon(#pyhack) • Python Bouldering Club(#kabepy)
  3. 3. Story • Motivation • 1st step: reStructuredText • 2nd step: Plone + reStructuredText • 3rd step: Sphinx
  4. 4. Motivation • MS-Word使いたくない / I hate MS-Word • らくしたい / I hate routine work • reStructuredTextで書きたい / I like reST
  5. 5. reStructuredText
  6. 6. reStructuredText • 1st step • 議事録を書く / Write minutes • メールに添付 / Attach to email • なんとなく読める / Readable
  7. 7. reStructuredText
  8. 8. reStructuredText • reStructuredText がなんとなく読める ようになる / Somehow read • 同じフォーマットで書く人が出てく る / Followers come out
  9. 9. Plone + reST
  10. 10. Plone + reST • 2nd step • 議事録を書く / Write minutes • サイトにアップ / Site upload • 週報を書く / Write weekly reports • 相互に書き込み / Collaboration
  11. 11. Plone + reST • Plone • Python based CMS • reStructuredText format support
  12. 12. Plone + reST
  13. 13. Plone + reST
  14. 14. Plone + reST • 普段からreSTを使うようになる / Everyday use reST • 楽しく書く / Fun writing • 他の人を真似する / Imitate others
  15. 15. Sphinx
  16. 16. Sphinx • 3rd step • チームで資料を書く / Team writing • 書くことに集中 / Focus on writing • 設定したい人は使えるようにする / Installation instructions
  17. 17. チームでドキュメント Team writing • Sphinx のファイル構成を全部作る / I made document structure • タイトルと担当者をすべて入れる / I fill in all titles and all authors • 目次だけできている状態 / Table of contents completed
  18. 18. 書くことに集中 Focus on writing • ファイルはバージョン管理 / use Version Control System • サーバでbuildしてみんなが読める / build on Server • sphinx環境不要 / Do not need sphinx
  19. 19. 使えるようにする Installation instructions • インストール手順を書く / Installation document • conf.py で環境による条件分岐 / eliminate environment-dependent • Windows / Linux / Mac • blockdiag / seqdiag
  20. 20. Sphinx • みんなでドキュメントが作れた !! / We build specification document !!
  21. 21. Summary • 徐々に広める / little by little spread • 書くことに集中 / Focus on writing • 最後は自分で面倒をみる / Take care of overall
  22. 22. Happy writing!
  • dolven

    Mar. 17, 2016
  • 831jsh

    Jan. 1, 2015
  • TsuyoshiOkawa

    Sep. 12, 2014
  • MoriyamaToshiharu

    Dec. 27, 2012
  • shimabukuro

    Dec. 10, 2012
  • m0201

    Nov. 19, 2012

How do I spread reStructuredText and Sphinx to my project team.

Views

Total views

9,525

On Slideshare

0

From embeds

0

Number of embeds

6,718

Actions

Downloads

12

Shares

0

Comments

0

Likes

6

×