Moving Sphinx documentation root to the root of the repository

Sphinx is not able to include files that are outside of the directory
of the root document or index. So to be able to include the Examples
directory, the root of the Sphinx documentation needs to be in the
root of the repository.

Author: blowekamp

Documentation/docs/Makefile

@@ -5,8 +5,8 @@
 SPHINXOPTS    =
 SPHINXBUILD   = sphinx-build
 SPHINXPROJ    = SimpleITK
-SOURCEDIR     = source
-BUILDDIR      = build
+SOURCEDIR     = ../..
+BUILDDIR      = ../../build
 
 # Put it first so that "make" without argument is like "make help".
 help:

Documentation/docs/static/.gitignore

@@ -70,7 +70,7 @@
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This patterns also effect to html_static_path and html_extra_path
-exclude_patterns = []
+exclude_patterns = [".*"]
 
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = 'sphinx'
@@ -95,9 +95,9 @@
 # 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']
+html_static_path = ['Documentation/docs/static']
 
-html_logo= '../../Images/simpleitk_logo.png'
+html_logo= 'Documentation/Images/simpleitk_logo.png'
 
 
 # -- Options for HTMLHelp output ------------------------------------------

Documentation/docs/source/conf.py conf.py

@@ -7,9 +7,8 @@ and is under development.
 .. toctree::
    :maxdepth: 2
 
-   faq
-   getting_started
-
+   Documentation/docs/source/faq
+   Documentation/docs/source/getting_started
 
 
 Indices and tables