Bladeren bron

Updated index page of docs

master
David Winterbottom 14 jaren geleden
bovenliggende
commit
fd5708dd76
1 gewijzigde bestanden met toevoegingen van 21 en 20 verwijderingen
  1. 21
    20
      docs/source/index.rst

+ 21
- 20
docs/source/index.rst Bestand weergeven

@@ -7,41 +7,43 @@
7 7
 Welcome to the documentation for django-oscar
8 8
 =============================================
9 9
 
10
-django-oscar is a ecommerce framework for Django 1.3 for building domain-driven
11
-ecommerce sites.  It is structured in way that lets any part of the core
12
-ecommerce functionality be customised to suit the needs of your project.    
10
+django-oscar is an ecommerce framework for Django, designed for building
11
+domain-driven applications.  It is structured in way that lets any part of the
12
+core functionality be customised to suit the needs of your project.  For
13
+instance, if every product in your shop has an associated video, then
14
+django-oscar lets you add such a field to your core product model.  You don't
15
+have to model your domain logic using the Entity-Attribute-Value pattern or
16
+other such meta-nastiness - your core models should reflect the specifics of
17
+your domain.
13 18
 
14
-It is developed by Tangent Labs, a London-based digital agency, and is based on
15
-their existing Taoshop PHP platform which currently powers several large-scale ecommerce sites.  
19
+django-oscar is developed by Tangent Labs, a London-based digital agency, and
20
+is based on their existing Taoshop PHP platform which currently powers several
21
+large-scale ecommerce sites.  
16 22
 
17
-It is still in early development, but a stable release is planned for early summer 2011.
18
-The source is on Github: https://github.com/tangentlabs/django-oscar - all contributions welcome.
23
+The source is on Github: https://github.com/tangentlabs/django-oscar.
19 24
 
20 25
 Quick start
21 26
 ===========
22 27
 
23
-We can do this quickly.  Create a virtualenv using virtualenvwrapper and install django-oscar::
28
+We can do this quickly.  Create a virtualenv using virtualenvwrapper and
29
+install django and django-oscar::
24 30
 
25 31
     mkvirtualenv --no-site-packages vanilla
26 32
     pip install django django-oscar
27 33
 
28
-Take a copy of the example vanilla site, and copy the quickstart settings into place::
34
+Take a copy of the sameple settings file, found at::
29 35
 
30
-    cdsitepackages
31
-    cp -r 
32
-
33
-    cp -r ~/.virtualenvs/myshop/lib/python2.6/site-packages/src/examples/vanilla/ /tmp/vanilla
34
-    cd /tmp/vanilla
35
-    cp settings_quickstart.py settings.py
36
+    https://github.com/tangentlabs/django-oscar/blob/master/examples/vanilla/settings_quickstart.py
36 37
 
37 38
 Import the sample products and images::
38 39
 
39
-    python manage.py import_catalogue ~/.virtualenvs/myshop/src/django-oscar/examples/sample-data/books-catalogue.csv
40
-    python manage.py import_images ~/.virtualenvs/myshop/src/django-oscar/examples/sample-data/book-images.tar.gz
40
+    wget https://github.com/tangentlabs/django-oscar/blob/master/examples/sample-data/books-catalogue.csv
41
+    python manage.py import_catalogue books-catalogue.csv
41 42
 
42
-And there you have it: a fully functional ecommerce site with a product range of 100 popular books.
43
+    wget https://github.com/tangentlabs/django-oscar/blob/master/examples/sample-data/book-images.tar.gz
44
+    python manage.py import_images book-images.tar.gz
43 45
 
44
-Getting started:
46
+And there you have it: a fully functional ecommerce site with a product range of 100 popular books.
45 47
 
46 48
 .. toctree::
47 49
     :maxdepth: 2
@@ -50,7 +52,6 @@ Getting started:
50 52
     contributing
51 53
     getting_started
52 54
 
53
-
54 55
 Full contents:
55 56
 
56 57
 .. toctree::

Laden…
Annuleren
Opslaan