db for tutorial

Author: chfw

db.sqlite3

@@ -67,13 +67,17 @@ Then run the test application::
     Quit the server with CTRL-BREAK.
 
 
-Handle excel file upload
-+++++++++++++++++++++++++
+Handle excel file upload and download
+++++++++++++++++++++++++++++++++++++++
 
-If you open your browser and visit http://localhost:8000/upload, you shall see this upload form:
+This example shows how to process uploaded excel file and how to make data download as an excel file. Open your browser and visit http://localhost:8000/upload, you shall see this upload form:
 
 .. image :: upload-form.png
 
+Choose an excel sheet, for example an xls file, and press "Submit". You will get a csv file for download.
+
+.. image :: download-file.png
+
 Please open the file **polls/views.py** and focus on the following code section::
 
     class UploadFileForm(forms.Form):
@@ -90,10 +94,12 @@ Please open the file **polls/views.py** and focus on the following code section:
             form = UploadFileForm()
         return render_to_response('upload_form.html', {'form': form}, context_instance=RequestContext(request))
 
-**UploadFileForm** is html widget for file upload form in the html page. Then look down at **filehandle**. It is an instance of either ExcelInMemoryUploadedFile or TemporaryUploadedExcelFile, which inherit ExcelMixin and hence have a list of conversion methods to call, such as get_sheet, get_array, etc.
+**UploadFileForm** is html widget for file upload form in the html page. Then look down at **filehandle**. It is an instance of either ExcelInMemoryUploadedFile or TemporaryUploadedExcelFile, which inherit ExcelMixin and hence have a list of conversion methods to call, such as get_sheet, get_array, etc. :meth:`~django_excel.make_response` converts :class:`~pyexcel.Sheet` instance obtained via :meth:`~django_excel.ExcelMixin.get_sheet` into a csv file for download. Please feel free to change those functions according to :ref:`the mapping table <data-types-and-its-conversion-funcs>`.
 
 ... to be continued ..
 
+.. _data-types-and-its-conversion-funcs:
+
 All supported data types
 --------------------------
 
@@ -184,6 +190,8 @@ API Reference
 Response methods
 -----------------
 
+.. automodule:: django_excel
+
    .. method:: make_response(pyexcel_instance, file_type, status=200)
 
       :param pyexcel_instance: pyexcel.Sheet or pyexcel.Book

doc/source/index.rst

@@ -1,3 +1,5 @@
 from django.contrib import admin
-
+from models import Question, Choice
 # Register your models here.
+admin.site.register(Question)
+admin.site.register(Choice)

polls/admin.py

@@ -1,3 +1,12 @@
 from django.db import models
 
 # Create your models here.
+class Question(models.Model):
+    question_text = models.CharField(max_length=200)
+    pub_date = models.DateTimeField('date published')
+
+
+class Choice(models.Model):
+    question = models.ForeignKey(Question)
+    choice_text = models.CharField(max_length=200)
+    votes = models.IntegerField(default=0)