use sphinxcontrib-excel to present sample.xls

Author: chfw

.moban.d/docs/source/conf.py

@@ -1,7 +1,8 @@
 {% extends 'docs/source/conf.py.jj2' %}
 
 {%block SPHINX_EXTENSIONS%}
-    'sphinxcontrib.spelling'
+    'sphinxcontrib.spelling',
+    'sphinxcontrib.excel'
 {%endblock%}
 
 

.moban.d/docs/source/index.rst.jj2

@@ -98,28 +98,7 @@ This example shows how to import uploaded excel file into django models. We are
 going to import
 `sample-data.xls <https://github.com/pyexcel/django-excel/blob/master/sample-data.xls>`_
 
-.. table:: Sheet 1 of sample-data.xls
-
-    ============================================ ============ =================
-    Question Text                                Publish Date Unique Identifier
-    ============================================ ============ =================
-    What is your favourite programming language? 28/01/15     language
-    What is your favourite IDE?                  29/01/15     ide
-    ============================================ ============ =================
-
-.. table:: Sheet 2 of sample-data.xls
-
-    ==========  ==============  ======
-    Question    Choice          Votes
-    ==========  ==============  ======
-    language    Java            0
-    language    C++             0
-    language    C               0
-    ide         Eclipse         0
-    ide         Visual Studio   0
-    ide         PyCharm         0
-    ide         IntelliJ        0
-    ==========  ==============  ======
+.. pyexcel-table:: ../../sample-data.xls
 
 into the following data models:
 

doc/requirements.txt

@@ -1,2 +1,4 @@
 sphinxcontrib-spelling
+sphinxcontrib-excel
+
 

doc/source/_static/handsontable.full.min.css

@@ -22,6 +22,11 @@
 {% if builder != "htmlhelp" %}
 {{ super() }}
 <script type="text/javascript" src="{{ pathto('templatebuiltins.js', 1) }}"></script>
+<link rel="stylesheet" type="text/css" href="_static/handsontable.full.min.css">
+<script src="_static/handsontable.full.min.js"></script>
+<style>
+body{font-family:Helvetica,sans-serif;margin:2 0 0 0}.tab{margin-bottom:0px !important;text-align:center;list-style:none;padding:0 0 0 10px;line-height:24px;height:26px;overflow:hidden;font-size:12px;font-family:verdana;position:relative;margin:0}.tab li{margin-left:0px !important;margin-top:2px !important;float:left;height:24px;border:1px solid #aaa;background:#d1d1d1;background:linear-gradient(top, #ececec 50%, #d1d1d1);display:inline-block;position:relative;z-index:0;border-top-left-radius:6px;border-top-right-radius:6px;box-shadow:0 3px 3px rgba(0,0,0,0.4),inset 0 1px 0 #fff;text-shadow:0 1px #fff;margin:0 -5px;padding:0 20px}.tab li.active{background:#fff;color:#333;z-index:2}.tab li:before{left:-6px;border-width:0 1px 1px 0;box-shadow:2px 2px 0 #d1d1d1}.tab li:after{right:-6px;border-width:0 0 1px 1px;box-shadow:-2px 2px 0 #d1d1d1}.tab a{color:#555;text-decoration:none !important}.tab:before{position:absolute;content:" ";width:100%;bottom:0;left:0;border-bottom:1px solid #aaa;z-index:1}.tabcontent{margin-top:-1px}
+</style>
 <script type="text/javascript">
 (function($) {
     if (!django_template_builtins) {

doc/source/_static/handsontable.full.min.js

@@ -9,7 +9,8 @@
     'sphinx.ext.doctest',
     'sphinx.ext.intersphinx',
     'sphinx.ext.viewcode',
-    'sphinxcontrib.spelling'
+    'sphinxcontrib.spelling',
+    'sphinxcontrib.excel'
 ]
 
 intersphinx_mapping = {

doc/source/_themes/djangodocs/layout.html

@@ -277,28 +277,7 @@ This example shows how to import uploaded excel file into django models. We are
 going to import
 `sample-data.xls <https://github.com/pyexcel/django-excel/blob/master/sample-data.xls>`_
 
-.. table:: Sheet 1 of sample-data.xls
-
-    ============================================ ============ =================
-    Question Text                                Publish Date Unique Identifier
-    ============================================ ============ =================
-    What is your favourite programming language? 28/01/15     language
-    What is your favourite IDE?                  29/01/15     ide
-    ============================================ ============ =================
-
-.. table:: Sheet 2 of sample-data.xls
-
-    ==========  ==============  ======
-    Question    Choice          Votes
-    ==========  ==============  ======
-    language    Java            0
-    language    C++             0
-    language    C               0
-    ide         Eclipse         0
-    ide         Visual Studio   0
-    ide         PyCharm         0
-    ide         IntelliJ        0
-    ==========  ==============  ======
+.. pyexcel-table:: ../../sample-data.xls
 
 into the following data models: