update documentation about auto import

Author: chfw

README.rst

@@ -17,14 +17,19 @@ well as on file system. This library can turn the excel data into a list of list
 a list of records(dictionaries), dictionaries of lists. And vice versa. Hence it
 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 idea originated from the common usability problem when developing an excel file
+driven web applications for non-technical office workers: such as office assistant,
+human resource administrator. It is an un-deniable fact that not all people know the
+difference among various excel formats: csv, xls, xlsx. Instead of training those people
+about file formats, this library helps web developers to handle most of the excel file
+formats by providing a common programming interface.
+
+.. note::
+ Here is a typical conversation between the developer and the user::
+
+  User: "I have uploaded an excel file as instructed, but your application says un-supported file format"
+  Developer: "Did you upload an xlsx file or a csv file?"
+  User: "Well, I am not sure. I saved the data using Microsoft Excel. Surely, it must be in an excel format."
 
 The highlighted features are:
 
@@ -46,7 +51,7 @@ The highlighted features are:
    `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,
+   `pyexcel-text`_  (write only)json, rst, mediawiki, html
                     latex, grid, pipe, orgtbl, plain simple
    ================ ========================================
 

doc/source/index.rst

@@ -18,14 +18,19 @@ well as on file system. This library can turn the excel data into a list of list
 a list of records(dictionaries), dictionaries of lists. And vice versa. Hence it
 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 idea originated from the common usability problem when developing an excel file
+driven web applications for non-technical office workers: such as office assistant,
+human resource administrator. It is an un-deniable fact that not all people know the
+difference among various excel formats: csv, xls, xlsx. Instead of training those people
+about file formats, this library helps web developers to handle most of the excel file
+formats by providing a common programming interface.
+
+.. note::
+ Here is a typical conversation between the developer and the user::
+
+  User: "I have uploaded an excel file as instructed, but your application says un-supported file format"
+  Developer: "Did you upload an xlsx file or a csv file?"
+  User: "Well, I am not sure. I saved the data using Microsoft Excel. Surely, it must be in an excel format."
 
 The highlighted features are:
 
@@ -47,7 +52,7 @@ The highlighted features are:
    `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,
+   `pyexcel-text`_  (write only)json, rst, mediawiki, html
                     latex, grid, pipe, orgtbl, plain simple
    ================ ========================================
 
@@ -104,14 +109,15 @@ You will need to update your *settings.py*::
 More excel file formats
 ------------------------
 
-The example application understands csv, tsv and its zipped variants: csvz and tsvz. If you would like to expand the list of supported excel file formats (see :ref:`file-format-list`) for your own application, you could include one or all of the following import lines right after **django-excel** is imported::
+The example application understands csv, tsv and its zipped variants: csvz and tsvz. If you would like to expand the list of supported excel file formats (see :ref:`file-format-list`) for your own application, you could install one or all of the following::
 
-    import pyexcel.ext.xls # pip install pyexcel-xls
-    import pyexcel.ext.xlsx # pip install pyexcel-xlsx
-    import pyexcel.ext.ods # pip install pyexcel-ods
+    pip install pyexcel-xls
+    pip install pyexcel-xlsx
+    pip install pyexcel-ods
 
-.. note::
+.. warning::
 
+   If you are using pyexcel <=0.2.1, you still need to import each plugin manually, e.g. `import pyexcel.ext.xls` and
    Your IDE or pyflakes may highlight it as un-used but it is used. The registration of
    the extra file format support happens when the import action is performed
 

polls/views.py

@@ -4,7 +4,9 @@
 from django.template import RequestContext
 import django_excel as excel
 from polls.models import Question, Choice
-import pyexcel.ext.xls
+
+# No longer you need the following import statements if you use pyexcel >=0.2.2
+import pyexcel.ext.xls 
 import pyexcel.ext.xlsx
 import pyexcel.ext.ods3