bring back django theme

Author: chfw

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

@@ -1 +1,7 @@
 {% extends 'docs/source/conf.py.jj2' %}
+
+{%block custom_doc_theme%}
+sys.path.append(os.path.abspath('_themes'))
+html_theme_path = ['_themes']
+html_theme = 'djangodocs'
+{%endblock%}

.moban.yml

@@ -0,0 +1,16 @@
+configuration:
+  configuration_dir: "commons/config"
+  template_dir:
+    - "commons/templates"
+    - ".moban.d"
+  configuration: django_excel.yml
+targets:
+  - README.rst: README.rst
+  - setup.py: setup.py
+  - "doc/source/conf.py": "docs/source/conf.py"
+  - .travis.yml: travis.yml
+  - requirements.txt: requirements.txt
+  - LICENSE: LICENSE.jj2
+  - MANIFEST.in: MANIFEST.in.jj2
+  - "doc/source/index.rst": "docs/source/index.rst.jj2"
+  - "tests/requirements.txt": "tests/requirements.txt"

.travis.yml

@@ -20,7 +20,6 @@ matrix:
     - python: 3.5
       env: DJANGO_VERSION=1.8.2
 install:
-  - rm applymoban.py
   - pip install Django==$DJANGO_VERSION
   - pip install -r requirements.txt
   - pip install -r tests/requirements.txt

README.rst

@@ -28,31 +28,42 @@ programming interface to most of the excel readers and writers.
 
 The highlighted features are:
 
+#. excel data import into and export from databases
 #. turn uploaded excel file directly into Python data struture
 #. pass Python data structures as an excel file download
 #. provide data persistence as an excel file in server side
-#. supports csv, tsv, csvz, tsvz by default and other formats are supported via the following plugins:
-
-Available Plugins
-=================
-
-================ ==========================================
-Plugins          Supported file formats
-================ ==========================================
-`pyexcel-xls`_   xls, xlsx(r), xlsm(r)
-`pyexcel-xlsx`_  xlsx
-`pyexcel-ods`_   ods (python 2.6, 2.7)
-`pyexcel-ods3`_  ods (python 2.7, 3.3, 3.4)
-`pyexcel-text`_  write only)json, rst, mediawiki,
-                 latex, grid, pipe, orgtbl, plain simple
-================ ==========================================
-
+#. supports csv, tsv, csvz, tsvz by default and other formats are supported via
+   the following plugins:
+
+.. _file-format-list:
+
+.. table:: A list of file formats supported by external plugins
+
+   ================ ========================================
+   Plugins          Supported file formats
+   ================ ========================================
+   `pyexcel-xls`_   xls, xlsx(r), xlsm(r)
+   `pyexcel-xlsx`_  xlsx
+   `pyexcel-ods3`_  ods (python 2.6, 2.7, 3.3, 3.4)
+   `pyexcel-ods`_   ods (python 2.6, 2.7)
+   `pyexcel-text`_  (write only)json, rst, mediawiki,
+                    latex, grid, pipe, orgtbl, plain simple
+   ================ ========================================
+   
 .. _pyexcel-xls: https://github.com/pyexcel/pyexcel-xls
 .. _pyexcel-xlsx: https://github.com/pyexcel/pyexcel-xlsx
 .. _pyexcel-ods: https://github.com/pyexcel/pyexcel-ods
 .. _pyexcel-ods3: https://github.com/pyexcel/pyexcel-ods3
 .. _pyexcel-text: https://github.com/pyexcel/pyexcel-text
 
+This library makes infomation processing involving various excel files as easy as
+processing array, dictionary when processing file upload/download, data import into
+and export from SQL databases, information analysis and persistence. It uses
+**pyexcel** and its plugins:
+
+#. to provide one uniform programming interface to handle csv, tsv, xls, xlsx, xlsm and ods formats.
+#. to provide one-stop utility to import the data in uploaded file into a database and to export tables in a database as excel files for file download.
+#. to provide the same interface for information persistence at server side: saving a uploaded excel file to and loading a saved excel file from file system.
 
 Known constraints
 ==================
@@ -72,8 +83,7 @@ Tested Django Versions
     :target: http://travis-ci.org/pyexcel/django-excel
 
 Installation
-============
-
+================================================================================
 You can install it via pip:
 
 .. code-block:: bash
@@ -89,8 +99,6 @@ or clone it and install it:
     $ cd django-excel
     $ python setup.py install
 
-Installation of individual plugins , please refer to individual plugin page.
-
 Setup
 ======
 
@@ -136,6 +144,6 @@ Here is the example viewing function codes:
         return excel.make_response(sheet, "csv")
 
 License
-==========
+================================================================================
 
 New BSD License

applymoban.py

@@ -92,7 +92,9 @@
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'default'
+sys.path.append(os.path.abspath('_themes'))		
+html_theme_path = ['_themes']		
+html_theme = 'djangodocs'
 
 # 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

moban.yaml renamed to django_excel.yml

@@ -16,7 +16,16 @@ Welcome to django-excel's documentation!
 it easy to consume/produce information stored in excel files over HTTP protocol as
 well as on file system. This library can turn the excel data into a list of lists,
 a list of records(dictionaries), dictionaries of lists. And vice versa. Hence it
-lets you focus on data in Django web development, instead of file formats.
+lets you focus on data in Django based web development, instead of file formats.
+
+The idea originated from the problem of the illiteracy of excel file formats of
+non-technical office workers: such as office assistant, human resource administrator.
+There is nothing with the un-deniable fact that some people do not know the
+difference among various excel formats. It becomes usability problem to those
+people when a web service cannot parse the excel file that they saved using
+Microsoft Excel. Instead of training those people about file formats, this library
+helps web developers to handle most of the excel file formats by unifying the
+programming interface to most of the excel readers and writers.
 
 The highlighted features are:
 
@@ -60,12 +69,16 @@ and export from SQL databases, information analysis and persistence. It uses
 Installation
 -------------------
 
-You can install it via pip::
+You can install it via pip:
+
+.. code-block:: bash
 
     $ pip install django-excel
 
 
-or clone it and install it::
+or clone it and install it:
+
+.. code-block:: bash
 
     $ git clone http://github.com/pyexcel/django-excel.git
     $ cd django-excel
@@ -381,6 +394,7 @@ database table              :meth:`~django_excel.ExcelMixin.save_to_database`
 a list of database tables   :meth:`~django_excel.ExcelMixin.save_book_to_database`   :meth:`~django_excel.make_response_from_tables`
 a database query sets                                                                :meth:`~django_excel.make_response_from_query_sets`
 =========================== ======================================================== ===================================================
+
 See more examples of the data structures in :ref:`pyexcel documentation<pyexcel:a-list-of-data-structures>`
 
 API Reference