Sphinx がどういうものかをざっくり紹介した勉強会の資料です

1. sphinx
“
:
”
2011/11/18 t2y
2011 11 18

2. ( )
Python
Twitter: @t2y ( ) , @t2y_en ( )
G+: gplus.to/t2y ( )
Hatena:
forest book ( )
forest nook ( )
2011 11 18

3. python
python
python
10 :
sphinx
4
2011 11 18

4. sphinx
rest
sphinx
sphinx python
sphinx
2011 11 18

5. sphinx (1)
python
Georg Brandl
"Pocoo is
pocoo 1 pronounced /ˈpokʉː/"
2005 python
python3
2011 11 18

6. sphinx (2)
doxygen
sphinx:
docutils: REST
pygments:
jinja2: HTML
2011 11 18

7. sphinx (3)
latex latex
makefile
rest
(gettext)
2011 11 18

8. $ make help
Please use `make <target>' where <target> is one of
html to make standalone HTML files
dirhtml to make HTML files called index.html in directories
singlehtml to make one big HTML file
text to make text files
man to make manual pages
django
pickle to make pickle files json
json to make json files
htmlhelp to make HTML files and a HTML help project
qthelp to make Qt help files and project
devhelp to make Devhelp files and project
epub to make an epub file
latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter
latexpdf to make LaTeX files and run pdflatex
texinfo to make Texinfo files
info to make Texinfo files and run them through makeinfo
gettext to make PO message catalogs
changes to make an overview over all changed/added/deprecated items
linkcheck to check all external links for integrity
2011 11 18

9. sphinx (4)
doc/xls
rest
.. blockdiag::
blockdiag: {
A [label=" "];
A -> B [label="Open"];
A -> C;
O -> P -> C;
}
2011 11 18

10. sphinx (5)
sphinx
python
python
sqlalchemy
groonga
symfony2
2011 11 18

11. sphinx (6)
sphinx-users.jp
sphinx
sphinx
: :
2011 11 18

12. sphinx
rest
sphinx
sphinx python
sphinx
2011 11 18

13. rest
WIKI
STRUCTUREDTEXT
PYTHON
reStructuredText
2011 11 18

14. rest
:
2011 11 18

15. sphinx
: sphinx rest
2011 11 18

16. sphinx
rest
sphinx
sphinx python
sphinx
2011 11 18

17. :
:
:
2011 11 18

18. 10 :
2
sphinx
2011 11 18

19. ( )
2011 11 18

20. sphinx
2011 11 18

21. rest
=>
=>
html/epub/pdf =>
2011 11 18

22. sphinx
rest
sphinx
sphinx python
sphinx
2011 11 18

23. sphinx
pypi sphinxcontrib
30
pypi sphinxjp
8
2011 11 18

24. sphinxcontrib.spelling
sphinxcontrib.spelling
doug hellmann
pyenchant
sphinx
2011 11 18

25. sphinxjp.themes.s6
sphinxjp.themes.s6
rest
s6 js
s6 ( css)
“..s6:: xxx”
2011 11 18

26. blockdiag
blockdiag
diag
seqdiag
actdiag
nwdiag
rackdiag
2011 11 18

27. sphinxjp.shibukawa
sphinxjp.shibukawa
2011 11 18

28. sphinx
rest
sphinx
sphinx python
sphinx
2011 11 18

29. docstring
sphinx
python
docstring
2011 11 18

30. sphinx python
python
2011 11 18

31. python
setup.py
python : distutils
distutils : distribute
:
web: distutils, setuptools,
distribute, pip, virtualenv, buildout
2011 11 18

32. api
e.g) flask
javadoc
$ cd flask_repository
$ python setup.py build_sphinx
build/sphinx/html
2011 11 18

33. sphinx
rest
sphinx
sphinx python
sphinx
2011 11 18

34. pypy
2011 11 18

35. python
django
pyramid
2011 11 18

36. python
django
pyramid
web
2011 11 18

37. python (v2.7.2)
1424 page
C/API 192 page
122 page
django (v1.3) 1129 page
pyramid (v1.2) 670 page
2011 11 18

38. python
learning python ( : python)
: Mark Lutz
1 (1999/4) 384 page
2 (2003/12) 624 page
3 (2007/10) 752 page
4 (2009/9) 1216 page
2011 11 18

39. python
programming python ( : python)
: Mark Lutz
1 (1996/10) 902 page
2 (2001/3) 1296 page
3 (2006/8) 1600 page
4 (2010/12) 1632 page
2011 11 18

40. Mark Lutz
“python ”
python
1000
2011 11 18

41. sphinx
rest
sphinx
sphinx python
sphinx
2011 11 18

42. sphinx
python
pymotw & python insider
ikazuchi
2011 11 18

43. sphinx
ikazuchi
2011 11 18

44. sphinx
Python
PyMOTW
Python Insider
2011 11 18

45. ikazuchi
PyPI ikazuchi
ikazuchi
CUI
google translate api
microsoft translate API
2011 11 18

46. ikazuchi
ikazuchi
PyPI
python
europython lt
(sphinxcontrib-ikazuchi )
2011 11 18

47. sphinx
sphinx
(gettext)
quickstart
(doc/xls )
2011 11 18

48. rest
sphinx
2011 11 18

49. happy documenting
with sphinx
2011 11 18