tk0miya

reST のいけてないところ。
=========================

普段書くテキストと同じような感じで書いていけるのが reST のいいところなんだけど、
ちょっとした時にインデントで文句を言われることがあるよね。
(例えば、こんなふうに括弧付きで補足を入れたりするときに、
 括弧の中で改行したあと、一文字インデントしたくならないかしら...)

tk0miya

注意

• 紹介する内容は SD や WEB+DB に載ってる内容です
  • 詳細はそっちを読んでください
• 知ってる人は内職しててください
• この資料は公開するので、メモするより聞きましょう

何度もやることは自動化しよう

tk0miya

$ python2.4 virtualenv-1.7.2/virtualenv.py py24
New python executable in py24/bin/python2.4
Also creating executable in py24/bin/python
Installing setuptools.............done.
Installing pip...............done.
$ py24/bin/python setup.py develop
running develop
running egg_info
creating src/diff_highlight.egg-info
writing src/diff_highlight.egg-info/PKG-INFO

tk0miya

[1] tkomiya@deneb> python
Python 2.7.6 (default, Feb 20 2014, 11:54:33)
[GCC 4.2.1 Compatible Apple LLVM 4.2 (clang-425.0.28)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> # 発表します枠
... candidates = ['@terapyon', '@jbking', '@ryu22e', '@kyon_mm', '@aodag', '@shomah4a', '@shimizukawa', '@usaturn',]
>>> # ツンデレ枠 (あんたがどうしてもっていうなら発表してやらなくもないんだからっ)
... tsundere = ['@r_rudi', '@masahito', '@takuan_osho', '@ransui', '@ytakeuch', '@kamekoopa', '@shidocchi', '@hajime_nakagami', '@masa_edw', '@takanory', '@turky', '@troter',]
>>>
>>> # 基調講演

tk0miya

revdiag {
    branch master [color = lightblue];
    branch develop [color = yellow];

    commit [message = 'Initial commit']

    commit;

    // branching
    master -> develop {

tk0miya

index.rst
builders.rst
changes.rst
config.rst
contents.rst
domains.rst
examples.rst
ext/appapi.rst	extdev/appapi.rst
ext/autodoc.rst
ext/autosummary.rst

tk0miya

import sys
sys.path.insert(0, 'source/')
extensions += ['mycodeblock']

language = 'ja'

latex_elements['preamble'] = '\\usepackage{ascmac}'
latex_docclass = {
    'manual': 'jsbook'
}

tk0miya

new_numfig.py: yet another numfig.py
-------------------------------------
This is Sphinx extension for numbering figures and tables automatically.

what's difference?
-------------------
- Support numbering tables
- Rename :num: role to :ref:num: and support HTML format
- Numbering over multiple .rst files (in HTML)
- Support branch numbering (cf. 1-1, 1-2, 2-1) with numbered toctree (in HTML)

tk0miya

sphinxcontrib-cacoo

sphinxcontrib-cacoo has moved to sphinx-contrib repos <https://bitbucket.org/birkenfeld/sphinx-contrib> and it is released as python package.

See https://pypi.python.org/pypi/sphinxcontrib-cacoo

tk0miya

sys.path.insert(0, '.')
extensions.append('sphinxcontrib_awesome')