Metadata-Version: 2.0
Name: sphinxcontrib-toc
Version: 0.9.0
Summary: Sphinx extension to allow .toc file to builde the Table of Contents
Home-page: https://github.com/tk0miya/sphinxcontrib-toc
Author: Takeshi KOMIYA
Author-email: i.tkomiya@gmail.com
License: BSD
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Framework :: Sphinx :: Extension
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Documentation
Classifier: Topic :: Documentation :: Sphinx
Requires-Dist: Sphinx (>=1.4)

sphinxcontrib-toc
=================

``sphinxcontrib-toc`` is a Sphinx extension to allow .toc file to build
the Table of Contents.

This extension empower you to build complicated document with markup
languages which can not define toctrees.  Specifically, combination with
recommonmark, you don't need to write any reStructuredText in your document!

Usage
-----

Append this extension in conf.py::

    extensions = ['sphinxcontrib.toc']


And configure following settings:

``toc_title``
    The default title of toctree if no titles in .toc file.  By default,
    ``"{project} Documentation"``.

``toc_numbered``
    Same as ``:numbered:`` option of toctree directive.  If enabled,
    Sphinx assigns section numbers.  By default, ``true``.


.toc file
---------

.toc file is a list of documents like ``toctree`` directive::

   section1
   section2
   section3

You may define the title of toctree at top of the file::

   # The title of document
   section1
   section2
   section3


Tips
----

You can use "nested" .toc file like following::

   /index.toc
   /part1.rst
   /part2.rst
   /part3/index.toc
   /part3/section1.toc
   /part3/section2.toc

   # In /index.toc
   part1
   part2
   part3/index

   # In /part3/index.toc
   section1
   section2


