Download - 儲かるドキュメント

Transcript
Page 1: 儲かるドキュメント

��������

���Ruby��02���@toRuby

Page 2: 儲かるドキュメント
Page 3: 儲かるドキュメント

• Wiki�� ���(reST)�� ��HTML�PDF�������

• ��� !"#$%&!'()����• *�+,-.-/0123��

(Erlang�4nginx!5678-9:OK)• HTML!;<=JS>?@A%�%BC

�������� Sphinx

http://sphinx.pocoo.orghttp://sphinx.pocoo.org

Page 4: 儲かるドキュメント

�� �����

Page 5: 儲かるドキュメント

������������������

http://sphinx.shibu.jphttp://sphinx.shibu.jp

Page 6: 儲かるドキュメント

����������������

http://bitbucket.org/shibu/sphinx/http://bitbucket.org/shibu/sphinx/

Page 7: 儲かるドキュメント

�� �������� ������

http://www.shibu.jp/sdeditext/http://www.shibu.jp/sdeditext/

Page 8: 儲かるドキュメント

������������

Page 9: 儲かるドキュメント

$

Page 10: 儲かるドキュメント

$ s

Page 11: 儲かるドキュメント

$ su

Page 12: 儲かるドキュメント

$ sud

Page 13: 儲かるドキュメント

$ sudo

Page 14: 儲かるドキュメント

$ sudo p

Page 15: 儲かるドキュメント

$ sudo po

Page 16: 儲かるドキュメント

$ sudo por

Page 17: 儲かるドキュメント

$ sudo port

Page 18: 儲かるドキュメント

$ sudo port i

Page 19: 儲かるドキュメント

$ sudo port in

Page 20: 儲かるドキュメント

$ sudo port ins

Page 21: 儲かるドキュメント

$ sudo port inst

Page 22: 儲かるドキュメント

$ sudo port insta

Page 23: 儲かるドキュメント

$ sudo port instal

Page 24: 儲かるドキュメント

$ sudo port install

Page 25: 儲かるドキュメント

$ sudo port install p

Page 26: 儲かるドキュメント

$ sudo port install py

Page 27: 儲かるドキュメント

$ sudo port install pyt

Page 28: 儲かるドキュメント

$ sudo port install pyth

Page 29: 儲かるドキュメント

$ sudo port install pytho

Page 30: 儲かるドキュメント

$ sudo port install python

Page 31: 儲かるドキュメント

Taken by noukorama under CC BY-NC-SA

������������

Page 32: 儲かるドキュメント

�����������

Page 33: 儲かるドキュメント

Sphinx�� ����� !"�APSW: http://apsw.googlecode.com/svn/publish/index.htmlboostmpi: http://documen.tician.de/boostmpi/Calibre: http://calibre.kovidgoyal.net/user_manual/Chaco: http://code.enthought.com/projects/chaco/docs/html/CodePy: http://documen.tician.de/codepy/Cython: http://docs.cython.org/C/C++ Python language binding project: http://language-binding.net/index.htmlDirector: http://packages.python.org/director/Djagios: http://djagios.org/Django: http://docs.djangoproject.com/F2py: http://www.f2py.org/html/GeoDjango: http://geodjango.org/docs/GeoServer: http://docs.geoserver.org/Glashammer: http://glashammer.org/Grok: http://grok.zope.org/doc/current/Hedge: http://documen.tician.de/hedge/IFM: http://fluffybunny.memebot.com/ifm-docs/index.htmlJinja: http://jinja.pocoo.org/2/documentation/LEPL: http://www.acooke.org/lepl/MapServer: http://mapserver.org/Matplotlib: http://matplotlib.sourceforge.net/Mayavi: http://code.enthought.com/projects/mayavi/docs/development/html/mayaviMeshPy: http://documen.tician.de/meshpy/MirrorBrain: http://mirrorbrain.org/docs/Mixin.com: http://dev.mixin.com/mpmath: http://mpmath.googlecode.com/svn/trunk/doc/build/index.htmlMyHDL: http://www.myhdl.org/doc/0.6/NetworkX: http://networkx.lanl.gov/NumPy: http://docs.scipy.org/doc/numpy/reference/ObjectListView: http://objectlistview.sourceforge.net/pythonOpenEXR: http://excamera.com/articles/26/doc/index.htmlOpenLayers: http://docs.openlayers.org/openWNS: http://docs.openwns.org/Paste: http://pythonpaste.org/script/Paver: http://www.blueskyonmars.com/projects/paver/

Py on Windows: http://timgolden.me.uk/python-on-windows/PyCuda: http://documen.tician.de/pycuda/PyEphem: http://rhodesmill.org/pyephem/Pyevolve: http://pyevolve.sourceforge.net/PyLit: http://pylit.berlios.de/Pylo: http://documen.tician.de/pylo/Pylons: http://docs.pylonshq.com/PyMOTW: http://www.doughellmann.com/PyMOTW/PyPubSub: http://pubsub.sourceforge.net/pyrticle: http://documen.tician.de/pyrticle/Pysparse: http://pysparse.sourceforge.net/Python: http://docs.python.org/python-apt: http://people.debian.org/~jak/python-apt-doc/PyUblas: http://documen.tician.de/pyublas/Quex: http://quex.sourceforge.net/Reteisi: http://docs.argolinux.org/reteisi/Roundup: http://www.roundup-tracker.org/Sage: http://sagemath.org/doc/Satchmo: http://www.satchmoproject.com/docs/svn/Scapy: http://www.secdev.org/projects/scapy/doc/Selenium: http://seleniumhq.org/docs/Self: http://selflanguage.org/SimPy: http://simpy.sourceforge.net/Sphinx: http://sphinx.pocoo.org/Sprox: http://sprox.org/SQLAlchemy: http://www.sqlalchemy.org/docs/Sqlkit: http://sqlkit.argolinux.org/SymPy: http://docs.sympy.org/tinyTiM: http://tinytim.sourceforge.net/docs/2.0/The Wine Cellar Book: http://www.thewinecellarbook.com/doc/en/TurboGears: http://turbogears.org/2.0/docs/VOR: http://www.vor-cycling.be/WebFaction: http://docs.webfaction.com/WFront: http://discorporate.us/projects/WFront/WTForms: http://wtforms.simplecodes.com/docs/Zope 3: e.g. http://docs.carduner.net/z3c-tutorial/zc.async: http://packages.python.org/zc.async/1.5.0/

Python#$

Django

Zope3

SeleniumSelfTurboGears

Page 34: 儲かるドキュメント

%&�'

Page 35: 儲かるドキュメント

%&�'

Page 36: 儲かるドキュメント

%&�'

Page 37: 儲かるドキュメント

�� ����

Page 38: 儲かるドキュメント

�()�*�

Page 39: 儲かるドキュメント

SphinxWiki��

��������

��

��

��������

��

��

Page 40: 儲かるドキュメント

Sphinx�Wiki�+,

���������

� ������

HTML���������HTML�������� !"�#$

�%�&'�()*+

��,�-.+/���

0��12

���������

� ������

HTML�������Web���3�4'�5!67���!"�#$

�%�&'�()89

:�&.+/���

;<!���12

�Sphinx �Wiki

Page 41: 儲かるドキュメント

Sphinx�Wiki�+,

���������

� ������

HTML���������HTML�������� !"�#$

�%�&'�()*+

��,�-.+/���

0��12

���������

� ������

HTML�������Web���3�4'�5!67���!"�#$

�%�&'�()89

:�&.+/���

;<!���12

�Sphinx �Wiki

Page 42: 儲かるドキュメント

Sphinx�Wiki�-.�/�Wiki

toRuby

Ruby

Hiki

RWiki

���

toRuby����Ruby

dRuby��

�� Ruby��

02

01����

def ����

����

Page 43: 儲かるドキュメント

�� ����

Page 44: 儲かるドキュメント

������������ !"#$�%

Page 45: 儲かるドキュメント

�����������

������

Page 46: 儲かるドキュメント

����������

�� !�" ��

Page 47: 儲かるドキュメント

������������

�������� !"�

#$%&'()�*

Page 48: 儲かるドキュメント

�����+()�,-./

0����� ����12

3���#4$����+

()�*

Page 49: 儲かるドキュメント

0123�456

DE FGH�I��J

,�+KLM

N7/KLMOP�//QRST-U

Page 50: 儲かるドキュメント

0123�456

DE

����������������������

���� ����

�I��J FGH

Page 51: 儲かるドキュメント
Page 52: 儲かるドキュメント

IT789:;<=���>�����

?@AB C

DEB=B C

�FG���

��������� � ���

� !"#$%&�#'(

��������� � ���

� !"#$%&�#'(

Page 53: 儲かるドキュメント

)*+�,'

�������-./012

Page 54: 儲かるドキュメント

VM�W-9�:XYZ[�=\�]�^3_

`XYZ[�� a�

`b c���def�ggg

Page 55: 儲かるドキュメント

HI J��K���=A�L

��MNOA�

PxUnit��QRS:T�BU

http://www.hyuki.com/yukiwiki/wiki.cgi?JUnit���������

Page 56: 儲かるドキュメント

• Zh�����ij�%klR/– diff=>?�@A�-BCD%�&'�()–EFEFGH�

• mn3�+lop%/�qr

Page 57: 儲かるドキュメント

������.3)*+�,�4560

Taken by ifranz under CC BY-NC

• Sphinx�SUnit–�KV�KWXA������–YZ�[\�]^�_���

•���������–PySpec3��O?

Page 58: 儲かるドキュメント

`aRuby?Sphinx"����b•��� !"#$%&'–xUnit>Wiki>

•�(�)���*+�,-./01�"2345678

•9 :;<=>>>

Page 59: 儲かるドキュメント
Page 60: 儲かるドキュメント

Python�&'()*+�,-*��.�/�0123�45678�9:;�"<=>?@�A�"�)BC�?D)BC�E7�9.�/�;E

FG�H�E?)*+I*J�KLM7�

Wergzueg 0.2M���4N�O$PQR�ST��9DocutilsUV�J�W�&XY�01Z[U\]�?^_�W�&�&'()*��`aE

bc�d�e8�9Georg Brandl���f�gU�/h�?Sphinx��iBB�J��9�c�Python 2.6, 3.0�&'()*�M"jklc?Pythonmn�opqrs�"t����i��

�c�u�MMvH�&'()*�f�gw901xyB*s?z{�23

"t����i��9|}APIUj~�lYe�01�"a�M/�

Twitter��������

RubyIRD/RdtoolJK��0�L=M?�NORubyIRD/RdtoolJK��0�L=M?�NO

Page 61: 儲かるドキュメント

Taken by noukorama under CC BY-NC-SA

����Python��������

���������

Page 62: 儲かるドキュメント

• -%R/�9=st(setuptools=u��v)

• iw�L&/]xy^Iz

$ sudo easy_install sphinx

$ sphinx-quickstartP+QNRST

http://blog.shibu.jp/article/32044108.html

Page 63: 儲かるドキュメント

cd��e�Bf

• {|�}~�/kR/]����!e�• {|�kR/�OK!\�])�[!e�• ����t0��3�!]���[!e�

Sphinx?>Qg6hNde�ibSphinx?>Qg6hNde�ib