Commits

Shoji KUMAGAI committed a801b77

Initial commit.

Comments (0)

Files changed (31)

+syntax: glob
+build
+*~
+*.orig
+*.omc
+*.omakedb*
+*.DS_Store
+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+PAPER         =
+BUILDDIR      = build
+
+# Internal variables.
+PAPEROPT_a4     = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
+# the i18n builder cannot share the environment and doctrees with the others
+I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
+
+.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html       to make standalone HTML files"
+	@echo "  dirhtml    to make HTML files named index.html in directories"
+	@echo "  singlehtml to make a single large HTML file"
+	@echo "  pickle     to make pickle files"
+	@echo "  json       to make JSON files"
+	@echo "  htmlhelp   to make HTML files and a HTML help project"
+	@echo "  qthelp     to make HTML files and a qthelp project"
+	@echo "  devhelp    to make HTML files and a Devhelp project"
+	@echo "  epub       to make an epub"
+	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
+	@echo "  text       to make text files"
+	@echo "  man        to make manual pages"
+	@echo "  texinfo    to make Texinfo files"
+	@echo "  info       to make Texinfo files and run them through makeinfo"
+	@echo "  gettext    to make PO message catalogs"
+	@echo "  changes    to make an overview of all changed/added/deprecated items"
+	@echo "  linkcheck  to check all external links for integrity"
+	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
+
+clean:
+	-rm -rf $(BUILDDIR)/*
+
+html:
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+
+dirhtml:
+	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
+
+singlehtml:
+	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
+	@echo
+	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
+
+pickle:
+	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
+	@echo
+	@echo "Build finished; now you can process the pickle files."
+
+json:
+	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
+	@echo
+	@echo "Build finished; now you can process the JSON files."
+
+htmlhelp:
+	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
+	@echo
+	@echo "Build finished; now you can run HTML Help Workshop with the" \
+	      ".hhp project file in $(BUILDDIR)/htmlhelp."
+
+qthelp:
+	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
+	@echo
+	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
+	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
+	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/QuickreStructuredText.qhcp"
+	@echo "To view the help file:"
+	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/QuickreStructuredText.qhc"
+
+devhelp:
+	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
+	@echo
+	@echo "Build finished."
+	@echo "To view the help file:"
+	@echo "# mkdir -p $$HOME/.local/share/devhelp/QuickreStructuredText"
+	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/QuickreStructuredText"
+	@echo "# devhelp"
+
+epub:
+	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
+	@echo
+	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
+
+latex:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo
+	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
+	@echo "Run \`make' in that directory to run these through (pdf)latex" \
+	      "(use \`make latexpdf' here to do that automatically)."
+
+latexpdf:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through pdflatex..."
+	$(MAKE) -C $(BUILDDIR)/latex all-pdf
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+text:
+	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
+	@echo
+	@echo "Build finished. The text files are in $(BUILDDIR)/text."
+
+man:
+	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
+	@echo
+	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
+
+texinfo:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo
+	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
+	@echo "Run \`make' in that directory to run these through makeinfo" \
+	      "(use \`make info' here to do that automatically)."
+
+info:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo "Running Texinfo files through makeinfo..."
+	make -C $(BUILDDIR)/texinfo info
+	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
+
+gettext:
+	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
+	@echo
+	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
+
+changes:
+	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
+	@echo
+	@echo "The overview file is in $(BUILDDIR)/changes."
+
+linkcheck:
+	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
+	@echo
+	@echo "Link check complete; look for any errors in the above output " \
+	      "or in $(BUILDDIR)/linkcheck/output.txt."
+
+doctest:
+	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
+	@echo "Testing of doctests in the sources finished, look at the " \
+	      "results in $(BUILDDIR)/doctest/output.txt."

source/_static/image/ball1.gif

Added
New image

source/_static/image/biohazard.png

Added
New image

source/block-quotes.txt

+Block quotes are just:
+
+    Indented paragraphs,
+
+        and they may nest.

source/bullet-lists.txt

+Bullet lists:
+
+- This is item 1 
+- This is item 2
+
+- Bullets are "-", "*" or "+". 
+  Continuing text must be aligned 
+  after the bullet and whitespace.
+
+Note that a blank line is required 
+before the first item and after the 
+last, but is optional between items.

source/citations.txt

+Citation references, like [CIT2002]_. 
+Note that citations may get 
+rearranged, e.g., to the bottom of 
+the "page".
+
+.. [CIT2002] A citation 
+   (as often used in journals).
+
+Citation labels contain alphanumerics, 
+underlines, hyphens and fullstops. 
+Case is not significant.
+
+Given a citation like [this]_, one 
+can also refer to it like this_.
+
+.. [this] here.

source/comment1.txt

+.. This text will not be shown 
+   (but, for instance, in HTML might be 
+   rendered as an HTML comment)

source/comment2.txt

+An "empty comment" does not 
+consume following blocks. 
+(An empty comment is ".." with 
+blank lines before and after.)
+
+..
+
+        So this block is not "lost", 
+        despite its indentation.
+# -*- coding: utf-8 -*-
+#
+# Quick reStructuredText documentation build configuration file, created by
+# sphinx-quickstart on Wed Feb 15 21:10:47 2012.
+#
+# This file is execfile()d with the current directory set to its containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys, os
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#sys.path.insert(0, os.path.abspath('.'))
+
+# -- General configuration -----------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+#needs_sphinx = '1.0'
+
+# Add any Sphinx extension module names here, as strings. They can be extensions
+# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
+extensions = ['sphinx.ext.intersphinx']
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# The suffix of source filenames.
+source_suffix = '.rst'
+
+# The encoding of source files.
+#source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = 'index'
+
+# General information about the project.
+project = u'Quick reStructuredText'
+copyright = u'2012, Tibs, David Goodger'
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The short X.Y version.
+version = '0.1'
+# The full version, including alpha/beta/rc tags.
+release = '0.1'
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+#today = ''
+# Else, today_fmt is used as the format for a strftime call.
+#today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = []
+
+# The reST default role (used for this markup: `text`) to use for all documents.
+#default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+#add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+#add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+#show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = 'sphinx'
+
+# A list of ignored prefixes for module index sorting.
+#modindex_common_prefix = []
+
+
+# -- Options for HTML output ---------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = 'default'
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+#html_theme_options = {}
+
+# Add any paths that contain custom themes here, relative to this directory.
+#html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+#html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+#html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+#html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+#html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+#html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+#html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+#html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+#html_additional_pages = {}
+
+# If false, no module index is generated.
+#html_domain_indices = True
+
+# If false, no index is generated.
+#html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+#html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+#html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+#html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+#html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+#html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+#html_file_suffix = None
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = 'QuickreStructuredTextdoc'
+
+
+# -- Options for LaTeX output --------------------------------------------------
+
+latex_elements = {
+# The paper size ('letterpaper' or 'a4paper').
+#'papersize': 'letterpaper',
+
+# The font size ('10pt', '11pt' or '12pt').
+#'pointsize': '10pt',
+
+# Additional stuff for the LaTeX preamble.
+#'preamble': '',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title, author, documentclass [howto/manual]).
+latex_documents = [
+  ('index', 'QuickreStructuredText.tex', u'Quick reStructuredText Documentation',
+   u'Tibs, David Goodger', 'manual'),
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+#latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+#latex_use_parts = False
+
+# If true, show page references after internal links.
+#latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+#latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+#latex_appendices = []
+
+# If false, no module index is generated.
+#latex_domain_indices = True
+
+
+# -- Options for manual page output --------------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    ('index', 'quickrestructuredtext', u'Quick reStructuredText Documentation',
+     [u'Tibs, David Goodger'], 1)
+]
+
+# If true, show URL addresses after external links.
+#man_show_urls = False
+
+
+# -- Options for Texinfo output ------------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+  ('index', 'QuickreStructuredText', u'Quick reStructuredText Documentation',
+   u'Tibs, David Goodger', 'QuickreStructuredText', 'One line description of project.',
+   'Miscellaneous'),
+]
+
+# Documents to append as an appendix to all manuals.
+#texinfo_appendices = []
+
+# If false, no module index is generated.
+#texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+#texinfo_show_urls = 'footnote'
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {'http://docs.python.org/': None}

source/definition-lists.txt

+Definition lists: 
+
+what 
+  Definition lists associate a term with 
+  a definition. 
+
+how 
+  The term is a one-line phrase, and the 
+  definition is one or more paragraphs or 
+  body elements, indented relative to the 
+  term. Blank lines are not allowed 
+  between term and definition.

source/doctest-blocks.txt

+Doctest blocks are interactive 
+Python sessions. They begin with 
+"``>>>``" and end with a blank line.
+
+>>> print "This is a doctest block." 
+This is a doctest block.

source/enumerated-lists.txt

+Enumerated lists:
+
+3. This is the first item 
+4. This is the second item 
+5. Enumerators are arabic numbers, 
+   single letters, or roman numerals 
+6. List items should be sequentially 
+   numbered, but need not start at 1 
+   (although not all formatters will 
+   honour the first index). 
+#. This item is auto-enumerated

source/field-lists.txt

+:Authors: 
+    Tony J. (Tibs) Ibbs, 
+    David Goodger
+    (and sundry other good-natured folks)
+
+:Version: 1.0 of 2001/08/08 
+:Dedication: To my father.

source/footnotes1.txt

+Footnote references, like [5]_. 
+Note that footnotes may get 
+rearranged, e.g., to the bottom of 
+the "page".
+
+.. [5] A numerical footnote. Note 
+   there's no colon after the ``]``.
+   

source/footnotes2.txt

+Autonumbered footnotes are 
+possible, like using [#]_ and [#]_.
+
+They may be assigned 'autonumber 
+labels' - for instance, 
+[#fourth]_ and [#third]_.
+
+
+.. [#] This is the first one. 
+.. [#] This is the second one.
+.. [#third] a.k.a. third_
+.. [#fourth] a.k.a. fourth_

source/footnotes3.txt

+Auto-symbol footnotes are also 
+possible, like this: [*]_ and [*]_.
+
+.. [*] This is the first one. 
+.. [*] This is the second one.

source/grid-table.txt

+Grid table:
+
++------------+------------+-----------+
+| Header 1   | Header 2   | Header 3  |
++============+============+===========+
+| body row 1 | column 2   | column 3  |
++------------+------------+-----------+
+| body row 2 | Cells may span columns.|
++------------+------------+-----------+
+| body row 3 | Cells may  | - Cells   |
++------------+ span rows. | - contain |
+| body row 4 |            | - blocks. |
++------------+------------+-----------+
+.. -*- coding: utf-8 -*-
+
+===========================
+ 早わかり reStructuredText
+===========================
+
+:Source URL: http://docutils.sourceforge.net/docs/user/rst/quickref.html
+:Updated: 2009-07-14 16:05:34 +0200 (Die, 14 Jul 2009)
+:Copyright: This document has been placed in the public domain.
+
+
+.. The full details of the markup may be found on the reStructuredText page. 
+   This document is just intended as a reminder.
+
+マークアップの完全な詳細は `reStructuredText <http://docutils.sourceforge.net/rst.html>`_ のページで
+見つけることができます。この文書は単なるリマインダを意図しています。
+
+.. Links that look like "(details)" point into the HTML version of the full reStructuredText 
+   specification document. These are relative links; if they don't work, please use the master 
+   "Quick reStructuredText" document.
+
+"(details)" というリンクは完全な `reStructuredText 仕様書`_ のHTML版を指しています。これらは相対リンクです;
+もしリンクが動作しない場合は、 `Quick reStructuredText`_ のマスタ文書を使ってください。
+
+.. _`reStructuredText 仕様書`: http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html
+.. _`Quick reStructuredText`: http://docutils.sourceforge.net/docs/user/rst/quickref.html
+
+.. contents::
+
+.. inline-markup:
+
+インラインマークアップ
+======================
+
+インラインマークアップは、文章中の単語や文節に文字スタイル(斜体や太字等)と機能(ハイパーリンク等)を与えます。
+
+.. list-table:: インラインマークアップ
+   :header-rows: 1
+   :widths: 20 20 50
+
+   * - プレーンテキスト
+     - 表示
+     - ノート
+
+   * - .. code-block:: none
+
+          *強調*
+     - *強調*
+     - イタリック(斜体)として表示されます
+
+   * - .. code-block:: none
+
+          **強い強調**
+     - **強い強調**
+     - ボールド(太字)として表示されます
+
+   * - .. code-block:: none
+
+          `用語テキスト`
+     - `用語テキスト`
+     - ドメイン又はアプリケーション固有の意味をもつテキストとして表示されます。
+       索引のエントリや(プログラム識別子のような)明示的記述的マークアップとして利用できます
+
+   * - .. code-block:: none
+
+          ``インラインリテラル``
+     - ``インラインリテラル``
+     - 等幅テキストとして表示されます。空白(スペース)は保持されますが、改行は保持されません
+
+   * - .. code-block:: none
+
+          reference_
+     - reference_
+     - シンプルな、1ワードのハイパーリンク参照です。 `ハイパーリンクターゲット`_ を参照して下さい
+
+   * - .. code-block:: none
+
+          `フレーズ参照`_
+     - `フレーズ参照`_
+     - 空白や記号を伴うハイパーリンク参照はバッククォートで括る必要があります。
+       `ハイパーリンクターゲット`_ を参照して下さい
+
+   * - .. code-block:: none
+
+          anonymous__
+     - anonymous__
+     - ハイパーリンク参照のアンダースコアが2つの場合は、匿名参照です。
+       `ハイパーリンクターゲット`_ を参照して下さい
+
+   * - .. code-block:: none
+
+          _`インライン内部ターゲット`
+     - _`インライン内部ターゲット`
+     - テキストの相互参照をします。
+       `ハイパーリンクターゲット`_ を参照して下さい
+
+   * - .. code-block:: none
+
+          |置換参照|
+     - (右のノート参照)
+     - 置換定義で定義された内容に置換されます。
+       テキスト、画像、ハイパーリンクもしくはそれらを組み合わせたものを
+       置き換えることができます
+
+   * - .. code-block:: none
+
+          脚注参照 [1]_
+     - `脚注参照`_
+     - `脚注参照`_ を参照してください
+
+   * - .. code-block:: none
+
+          引用参照 [CIT2002]_
+     - `引用参照`_
+     - `引用参照`_ を参照してください
+
+   * - .. code-block:: none
+
+          http://docutils.sf.net/
+     - http://docutils.sf.net/
+     - 一般的なハイパーリンクです
+
+アスタリスク ('\*') 、バッククォート ('\`') 、バーティカルバー ('\|') 及び
+アンダースコア ('\_') はインラインの区切り文字です。
+アスタリスク、バッククォート及びバーティカルバーは引用符のようにマークアップする
+単語やフレーズを対応する記号で囲みます。空白や他の引用符はそれらの外にある必要が
+あり、引用符の直ぐ内側に空白を含めることはできません。
+もし文字そのものとしてこれらインライン区切り文字を利用する場合には、
+エスケープする (バックスラッシュを用いる) か、それらを引用 (二重バッククォートを
+用いる、すなわちインラインリテラルを利用する) します。
+
+
+.. _escaping-with-backslashes:
+
+バックスラッシュによるエスケープ
+================================
+
+reStructuredText は特別な意味をもつマークアップ文字を上書きして、文字そのものを
+用いるためにバックスラッシュ ('\\') を使います。
+バックスラッシュそのものを使うには、バックスラッシュでエスケープします ('\\\\') 。
+
+.. list-table::
+   :header-rows: 1
+   :widths: 100 100
+
+   * - 元のreStructuredText
+     - 表示結果
+
+   * - .. code-block:: none
+
+          *escape* ``with`` "\"
+     - *escape* ``with`` "\"
+
+   * - .. code-block:: none
+
+          \*escape* \``with`` "\\"
+     - \*escape* \``with`` "\\"
+
+もちろん、Pythonの文字列でも正しく reStructuredText になるように、
+全てのバックスラッシュをエスケープする必要があります。
+
+.. list-table::
+   :header-rows: 1
+   :widths: 100 100
+
+   * - Pythonの文字列
+     - 表示結果
+
+   * - .. code-block:: none
+
+          r"""\*escape* \`with` "\\""""
+     - \*escape* \``with`` "\\"
+
+   * - .. code-block:: none
+
+          """\\*escape* \\`with` "\\\\""""
+     - \*escape* \``with`` "\\"
+
+   * - .. code-block:: none
+
+          """\*escape* \`with` "\\""""
+     - *escape* ``with`` "\"
+
+
+.. _section-structure:
+
+セクション構造
+==============
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: section-structure.txt
+     - .. include:: section-structure.txt
+
+.. _paragraphs:
+
+段落
+====
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: paragraphs.txt
+     - .. include:: paragraphs.txt
+
+
+.. _bullet-lists:
+
+箇条書きリスト
+==============
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: bullet-lists.txt
+     - .. include:: bullet-lists.txt
+
+
+.. _enumerated-lists:
+
+列挙リスト
+==========
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: enumerated-lists.txt
+     - .. include:: enumerated-lists.txt
+
+
+.. _definition-lists:
+
+定義リスト
+==========
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: definition-lists.txt
+     - .. include:: definition-lists.txt
+
+
+.. _field-lists:
+
+フィールドリスト
+================
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: field-lists.txt
+     - .. include:: field-lists.txt
+
+
+.. _option-lists:
+
+オプションリスト
+================
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: option-lists.txt
+     - .. include:: option-lists.txt
+
+
+.. _literal-blocks:
+
+リテラルブロック
+================
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: literal-blocks.txt
+     - .. include:: literal-blocks.txt
+
+
+.. _line-blocks:
+
+ラインブロック
+==============
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: line-blocks.txt
+     - .. include:: line-blocks.txt
+
+
+.. _block-quotes:
+
+引用ブロック
+============
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: block-quotes.txt
+     - .. include:: block-quotes.txt
+
+
+.. _doctest-blocks:
+
+Doctestブロック
+===============
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: doctest-blocks.txt
+     - .. include:: doctest-blocks.txt
+
+
+.. _tables:
+
+テーブル
+========
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: grid-table.txt
+     - .. include:: grid-table.txt
+
+   * - .. literalinclude:: simple-table.txt
+     - .. include:: simple-table.txt
+
+
+.. _transitions:
+
+切り替え
+========
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: transitions.txt
+     - .. include:: transitions.txt
+
+
+.. _explicit-markup:
+
+明示的マークアップ
+==================
+
+明示的マークアップブロックは注釈 (脚注)、直接的な紙媒体を持たないもの
+(ハイパーリンクターゲット、コメント)、特別な処理が必要なもの (ディレクティブ)を
+構成するために使います。これらはすべて2つのピリオドと空白、いわゆる
+"明示的なマークアップの開始" で始まります。
+
+.. _footnotes:
+
+脚注参照
+--------
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: footnotes1.txt
+     - .. include:: footnotes1.txt
+
+   * - .. literalinclude:: footnotes2.txt
+     - .. include:: footnotes2.txt
+
+   * - .. literalinclude:: footnotes3.txt
+     - .. include:: footnotes3.txt
+
+自動採番の脚注の番号は、参照される順番ではなく脚注の (記述の) 順番で決まります。
+自動採番の脚注をラベルなしで使う場合、参照と脚注は相互に同じ順番になっている
+必要があります。自動シンボルの脚注の場合も同様です。
+
+
+.. _citations:
+
+引用参照
+--------
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: citations.txt
+     - .. include:: citations.txt
+
+
+.. _reference:
+.. _`フレーズ参照`:
+.. _hyperlink-targets:
+
+ハイパーリンクターゲット
+------------------------
+
+.. _external-hyperlink-targets:
+
+外部ハイパーリンクターゲット
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: external-hyperlink-targets1.txt
+     - .. include:: external-hyperlink-targets1.txt
+
+`埋め込み形式` はHTMLドキュメントへの表示に適した表示方法で、 `呼び出し形式` は
+リンクが明示的に表示される必要がある印刷したドキュメントに適しています。
+"target-form" ディレクティブを使うことによって、 `呼び出し形式` を使うことができます。
+
+reStructuredText は高い可読性を保つためにURLの埋込む方法も提供しています。
+かぎ括弧を使って、対象のURLを直接埋め込むことができます。
+以下は、上述の例と全く同じです。
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: external-hyperlink-targets2.txt
+     - .. include:: external-hyperlink-targets2.txt
+
+.. _internal-hyperlink-targets:
+
+内部ハイパーリンクターゲット
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: internal-hyperlink-targets.txt
+     - .. include:: internal-hyperlink-targets.txt
+
+
+.. _indirect-hyperlink-targets:
+
+間接ハイパーリンクターゲット
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: indirect-hyperlink-targets.txt
+     - .. include:: indirect-hyperlink-targets.txt
+
+二つ目のハイパーリンクターゲット ("__"から始まっている行) は間接ハイパーリンク
+ターゲット ("Python_"を参照することで Python公式Webサイトを間接的に指している)
+であり、暗黙ハイパーリンクターゲットでもあります。
+テキストの中の2重アンダースコア接尾辞は、匿名ハイパーリンク参照であることを
+示します。匿名ハイパーリンクターゲットでは、参照テキストは再現されません。
+これは長いテキストや使い捨ての参照には便利ですが、同期が取れなくなってしまわない
+ように参照先の近くに保持しておくようにすべきです。
+
+
+.. _implicit-hyperlink-targets:
+
+暗黙的ハイパーリンクターゲット
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+セクションタイトル、脚注、引用は自動的にハイパーリンクが生成されます
+(タイトルテキストや脚注/引用ラベルをハイパーリンク名として使います) 。
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. code-block:: none
+
+          Implicit references, like `reStructuredText`_.
+     - Implicit references, like `reStructuredText`_.
+
+
+.. _directives:
+
+ディレクティブ
+==============
+
+ディレクティブは汎用の拡張メカニズムで、新しい文法を追加することなく
+新しい構造のサポートを追加する方法です。
+標準のディレクティブの説明は `reStructuredText Derectives`_ を参照してください。
+
+.. _`reStructuredText Derectives`: http://docutils.sourceforge.net/docs/ref/rst/directives.html
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. code-block:: none
+
+          .. image:: _static/image/ball1.gif
+     - .. image:: _static/image/ball1.gif
+
+
+.. _substitution-references-and-definitions:
+
+置換参照と定義
+==============
+
+置換は画像や任意の構造物をテキストに埋め込む、インラインディレクティブのようなものです。
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: substitution-references-and-definitions.txt
+     - .. include:: substitution-references-and-definitions.txt
+
+
+.. _comments:
+
+コメント
+========
+
+明示的マークアップで始まっていて上述のいずれの文法も使っていない構造体は
+全てコメントです。
+
+.. list-table::
+   :header-rows: 1
+   :widths: 80 100
+
+   * - プレーンテキスト
+     - 表示結果
+
+   * - .. literalinclude:: comment1.txt
+     - .. include:: comment1.txt
+
+   * - .. literalinclude:: comment2.txt
+     - .. include:: comment2.txt
+
+
+__ reference_
+
+.. END

source/line-blocks.txt

+| Line blocks are useful for addresses, 
+| verse, and adornment-free lists. 
+| 
+| Each new line begins with a 
+| vertical bar ("|"). 
+|     Line breaks and initial indents 
+|     are preserved. 
+| Continuation lines are wrapped 
+  portions of long lines; they begin 
+  with spaces in place of vertical bars.

source/literal-blocks.txt

+A paragraph containing only two colons 
+indicates that the following indented 
+or quoted text is a literal block. 
+
+:: 
+
+  Whitespace, newlines, blank lines, and 
+  all kinds of markup (like *this* or 
+  \this) is preserved by literal blocks. 
+
+  The paragraph containing only '::' 
+  will be omitted from the result. 
+
+The ``::`` may be tacked onto the very 
+end of any paragraph. The ``::`` will be 
+omitted if it is preceded by whitespace. 
+The ``::`` will be converted to a single 
+colon if preceded by text, like this:: 
+
+  It's very convenient to use this form. 
+
+Literal blocks end when text returns to 
+the preceding paragraph's indentation. 
+This means that something like this 
+is possible:: 
+
+      We start here 
+    and continue here 
+  and end here. 
+
+Per-line quoting can also be used on 
+unindented literal blocks:: 
+
+> Useful for quotes from email and 
+> for Haskell literate programming.

source/option-lists.txt

+-a            command-line option "a" 
+-b file       options can have arguments 
+              and long descriptions 
+--long        options can be long also 
+--input=file  long options can also have 
+              arguments 
+/V            DOS/VMS-style options too

source/paragraphs.txt

+This is a paragraph.
+
+Paragraphs line up at their left 
+edges, and are normally separated 
+by blank lines.

source/section-structure.txt

+=====
+Title
+=====
+
+Subtitle
+--------
+
+Titles are underlined (or over- 
+and underlined) with a printing 
+nonalphanumeric 7-bit ASCII 
+character. Recommended choices 
+are "``= - ` : ' " ~ ^ _ * + # < >``". 
+The underline/overline must be at 
+least as long as the title text. 
+
+A lone top-level (sub)section 
+is lifted up to be the document's 
+(sub)title.

source/simple-table.txt

+Simple table:
+
+=====  =====  ======
+   Inputs     Output
+------------  ------
+  A      B    A or B
+=====  =====  ======
+False  False  False 
+True   False  True 
+False  True   True 
+True   True   True 
+=====  =====  ======

source/substitution-references-and-definitions.txt

+The |biohazard| symbol must be used on containers used to dispose of medical waste.
+
+.. |biohazard| image:: _static/image/biohazard.png

source/transitions.txt

+A transition marker is a horizontal line 
+of 4 or more repeated punctuation 
+characters.
+
+------------
+
+A transition should not begin or end a 
+section or document, nor should two 
+transitions be immediately adjacent.