Sphinxのセットアップ用ファイル群

AdditionalCode4conf.py

# -- Additional Settings -------------------------------------------------------
execfile('../common.py')

CheckingInstallations.bat

python --version
omake --version
easy_install sphinx
easy_install blockdiag
easy_install sphinxcontrib-blockdiag
easy_install seqdiag 
easy_install sphinxcontrib-seqdiag
easy_install actdiag 
easy_install sphinxcontrib-actdiag
easy_install nwdiag
easy_install sphinxcontrib-nwdiag

common.py

# Additional font path
additional_fontpath = os.path.abspath(os.path.join(os.path.split(__file__)[0], os.pardir, 'Fonts'))

# Add any Sphinx extension module names here, as strings. They can be extensions
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
extensions += ['sphinxcontrib.blockdiag', 'sphinxcontrib.actdiag', 'sphinxcontrib.seqdiag', 'sphinxcontrib.nwdiag']

# The encoding of source files.
source_encoding = 'utf-8-sig'
#source_encoding = 'shift_jis'

# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
language = 'ja'

# The theme to use for HTML and HTML Help pages.  See the documentation for
# a list of builtin themes.
html_theme = 'sphinxdoc'

# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
# using the given strftime format.
html_last_updated_fmt = '%Y/%m/%d'

# Fontpath for blockdiag
blockdiag_fontpath = "%(additional_fontpath)s/VL-PGothic-Regular.ttf" % locals()
actdiag_fontpath = blockdiag_fontpath
seqdiag_fontpath = blockdiag_fontpath
nwdiag_fontpath = blockdiag_fontpath

# Enable Antialiasing
blockdiag_antialias = True
actdiag_antialias  = True
seqdiag_antialias   = True
nwdiag_antialias   = True

InstallSphinx.bat

easy_install sphinx
easy_install blockdiag
easy_install sphinxcontrib-blockdiag
easy_install seqdiag 
easy_install sphinxcontrib-seqdiag
easy_install actdiag 
easy_install sphinxcontrib-actdiag
easy_install nwdiag
easy_install sphinxcontrib-nwdiag

OMakefile4ADocument

# OMakefile for Sphinx documentation
#

# You can set these variables from the command line.
SPHINXOPTS    =
SPHINXBUILD   = sphinx-build
BUILDDIR      = _build

# Internal variables.
ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(SPHINXOPTS) .

SRCS = $(find . -name *.rst)

.DEFAULT: $(SRCS)
    $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html

OMakefile4All1

.SUBDIRS: document01

OMakefile4All2

.SUBDIRS: document01 document02