0611 sphinx pykyoto

○○ とかとか2011.06.11 #pykyoto 発表資料？

「おまえ、誰よ？」なんて言わない● Twitter ID = @lab1092● 3DCG ソフトの Blender とかで Python 触っている ( た ) 程度の人間です。● 最近は Sphinx とか使っていろいろやりたいなー、とか思ってます。

( この夏にかけての Python? 関連イベント ? を ) 勝手に紹介。

あ゛っ http://atnd.org/events/15877

Tech LION(6/17) http://www.usptomonokai.jp/techlion http://www.usptomonokai.jp/wp/?p=1562

http://www.oreilly.co.jp/books/9784873114958/

Jus 勉強会 (6/18) http://www.jus.or.jp/benkyokai/11-06.html

梅 .py(6/19) http://atnd.org/events/16731

エキスパート Pythonプログラミング読書会 13(6/21) http://atnd.org/events/16717

OSC 京都 (7/15,16)Blender User Group of Japan (BLUG.jp) http://www.ospn.jp/osc2011-kyoto/

OSC 名古屋 ( 予定、 8/20)Blender User Group of Japan (BLUG.jp)

PyCon JP 2011(8/27) http://2011.pycon.jp/

IT 勉強会カレンダー

では本題に…

アジェンダ● Sphinx ってなーに？● インストールするるるる● 使ってみた● blockdiag もね

Sphinx ってなーに？インストールするるるる使ってみたblockdiag もね

Sphinx は… ドキュメントを作りたくなってしまう魔法のツールだそうです。 (→Link)

http://sphinx-users.jp/doc10/

http://docs.python.org/index.html

http://www.blender.org/documentation/blender_python_api_2_57_release/

Sphinx の「コンパイル」 http://interactive.blockdiag.com/ で作成

reST = reStructured Texthttp://www.microsoft.com/japan/presspass/detail.aspx?newsid=3491 から。

書く→コンパイルする…

インストールは「” easy_install sphinx” で OK 」ってうちのばあちゃんが言ってました。 ( えっ、そうなの ?)

自分はこんな感じで入れた

Sphinx ってなーに？インストールするるるる使ってみた ( 少し Pytohn 風味 )blockdiag もね

reST を自動生成

短いコード# -*- coding: utf-8 -*-## docs フォルダ配下のドキュメントリスト作成。# ( 何故 walk 使わないかなー )#import osimport sys# < ディレクトリ名 >,< タイトル表示名 >dlist = (["hoge","hogehoge"], ["misc","fugafuga"],)fo = open(docsall.rst,w)wl = u"""==============Docs directory==============未分類のドキュメントリストです。Index of docs/=============="""fo.write(wl)for x,y in dlist: wl = ".. _" + x +"-label:n" wl = wl +"n" + y +"n"+ ( "-" * len(y) ) +"nn" wl = wl + u"( ドキュメント分類： " + x +")nn" lines= os.popen("dir /B /A-D docs"+ x ,"r") sys.stdout.flush() while 1: filename = lines.readline() 収集 & リストに filename = filename.rstrip() if not filename: break wl = wl + u" * `%s </docs/%s>`_n" % (filename,filename) wl = wl + "n" fo.write(wl) するよ !! print filename,xfo.close()

出力 (reST)==============Docs directory==============未分類のドキュメントリストです。Index of docs/==============.. _hoge-label:hogehoge--------( ドキュメント分類： hoge) * `ms_vowel.rst.pdf </docs/ms_vowel.rst.pdf>`_ * `sphinx_basic.rst.pdf </docs/sphinx_basic.rst.pdf>`_.. _misc-label:fugafuga--------( ドキュメント分類： misc)

やってることは…C:usrProjsphinx_sample>cd docsC:usrProjsphinx_sampledocs>dir /b hogems_vowel.rst.pdfsphinx_basic.rst.pdfC:usrProjsphinx_sampledocs>dir /b miscC:usrProjsphinx_sampledocs>

PDF タイトルも一覧表示 !!reST ファイルによる一覧作成時、 PDFファイルであれば PDF ファイルのタイトルを表示させるように拡張してみるなどする。● ヒント 1 ”from pyPdf import PdfFileReader”● ヒント 2 ”filename = unicode(filename,"shift-jis")”● ヒント３ “ input1 = PdfFileReader(file(fpath, "rb"))”● ヒント 4 “z = input1.getDocumentInfo().title”

他にもいくつか作ったよ● HTML のテーブルをパースして別表現の reST ファイルを作成　　→ from HTMLParser import HTMLParser● メールアーカイブをクロールして、特定のファイル (HTML メール ) の中身から一覧を生成 → import os,time import quopri from HTMLParser import HTMLParser

Git(msysgit) のログも。# -*- coding: utf-8 -*- while 1:# line = lines.readline()# git log とるよ# if not line:import os breakimport sys if commit in line > 0:# Git 実行パスgitdir = r"C:Program FilesGitbingit.exe" if c >= c_max: breakfo = open(git_history.rst,w) c = c + 1wl = u"""============== # wl = line + "n"Git history # fo.write(wl)============== print >>fo, +unicode(line, utf-8).rstrip()Git 履歴。 print >>fo,""git.exe log print >>fo,u" 現在、最新の " , c_max , u" 件を表示中。 "============== fo.close().. code-block:: none"""fo.write(wl)lines= os.popen(gitdir+ log ,"r")sys.stdout.flush()# MAX?c_max = 10c = 0

Windows で、その他● HTTP サーバーをたてる cd _buildhtml python -m SimpleHTTPServer 8080● ”make html” + ブラウザ起動 call .make.bat html ._buildhtmlindex.html

一行 HTTP サーバ !!

Sphinx では” .. blockdiag ::”.. blockdiag :: diagram { // Set labels to nodes. A [label = "Python 2.6.x"]; B [label = "Sphinx 1.0.7"]; C [label = "PIL 1.1.6"]; D [label = "(Sph)blockdiag"]; E [label = "blockdiag"]; F [label = "(Sph)nwdiag"]; G [label = "nwdiag"]; H [label = "pymssql"]; I [label = "pypdf"]; J [label = "rst2pdf"]; // Set labels to edges. (short text only) A -> B , C , H ,I,J; B -> D -> E; B -> F -> G; }

Interactive shell for blockdiag http://interactive.blockdiag.com/

( これら２つのツールもPython 製なんですよ… )

Jus 勉強会 (6/18) http://www.jus.or.jp/benkyokai/11-06.html

Thanks forWatching!!

http://blog.livedoor.jp	94
http://webcache.googleusercontent.com	5
url_unknown	3
http://twitter.com	1

0611 sphinx pykyoto

by Tetsuo Mitsuda on Jun 10, 2011

Accessibility

Tags

Upload Details

Usage Rights

4 Embeds 103

Statistics

0611 sphinx pykyoto — Presentation Transcript