Complete quick_start

Author: reyoung

.gitignore

@@ -0,0 +1 @@
+.env

.gitmodules

@@ -1,3 +1,6 @@
 [submodule "paddle"]
 	path = paddle
 	url = https://github.com/PaddlePaddle/Paddle.git
+[submodule "book"]
+	path = book
+	url = https://github.com/PaddlePaddle/book.git

book

@@ -15,6 +15,8 @@
 import sys
 import os
 import shlex
+from recommonmark.parser import CommonMarkParser
+from recommonmark.transform import AutoStructify
 
 # 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
@@ -33,15 +35,20 @@
     'sphinx.ext.autodoc',
     'sphinx.ext.mathjax',
     'sphinx.ext.viewcode',
+    'sphinx.ext.todo',
+    'sphinx_markdown_tables',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
-# source_suffix = ['.rst', '.md']
-source_suffix = '.rst'
+source_parsers = {
+    '.md': CommonMarkParser,
+}
+
+source_suffix = ['.rst', '.md']
 
 # The encoding of source files.
 #source_encoding = 'utf-8-sig'
@@ -112,7 +119,7 @@
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'classic'
+html_theme = 'sphinx_rtd_theme'
 
 # 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
@@ -286,3 +293,12 @@
 
 # If true, do not generate a @detailmenu in the "Top" node's menu.
 #texinfo_no_detailmenu = False
+
+def setup(app):
+    app.add_config_value('recommonmark_config', {
+            'auto_toc_tree_section': 'Contents',
+            'enable_inline_math': True,
+            'enable_eval_rst': True,
+            'enable_math': True
+            }, True)
+    app.add_transform(AutoStructify)

source/conf.py

@@ -3,16 +3,19 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to PaddlePaddle Fluid's documentation!
-==============================================
+##############
+欢迎来到 Fluid
+##############
 
-Contents:
-
-.. toctree::
-   :maxdepth: 2
+..  todo::
+		内容简介，导引
 
 
+..  toctree::
+		:maxdepth: 1
 
+		quick_start/index.rst
+    
 Indices and tables
 ==================
 

source/index.rst

@@ -0,0 +1 @@
+../../../../book/01.fit_a_line/image/predictions.png

source/quick_start/fit_a_line/image/predictions.png

@@ -0,0 +1 @@
+../../../../book/01.fit_a_line/image/ranges.png

source/quick_start/fit_a_line/image/ranges.png

@@ -0,0 +1 @@
+../../../../book/01.fit_a_line/image/train_and_test.png

source/quick_start/fit_a_line/image/train_and_test.png

@@ -0,0 +1 @@
+../../../book/01.fit_a_line/README.cn.md

source/quick_start/fit_a_line/index.md

@@ -1,3 +1,14 @@
-###########
+########
 新手入门
-###########
+########
+
+..  todo::
+
+    新手入门的导引文字，需要完善。
+
+..  toctree::
+    :maxdepth: 2
+
+    install/index.rst
+    quick_start.rst
+    theoretical_background.rst