Selaa lähdekoodia

Updated index page of docs

master
David Winterbottom 14 vuotta sitten
vanhempi
commit
fd5708dd76
1 muutettua tiedostoa jossa 21 lisäystä ja 20 poistoa
  1. 21
    20
      docs/source/index.rst

+ 21
- 20
docs/source/index.rst Näytä tiedosto

7
 Welcome to the documentation for django-oscar
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
 Quick start
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
     mkvirtualenv --no-site-packages vanilla
31
     mkvirtualenv --no-site-packages vanilla
26
     pip install django django-oscar
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
 Import the sample products and images::
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
 .. toctree::
48
 .. toctree::
47
     :maxdepth: 2
49
     :maxdepth: 2
50
     contributing
52
     contributing
51
     getting_started
53
     getting_started
52
 
54
 
53
-
54
 Full contents:
55
 Full contents:
55
 
56
 
56
 .. toctree::
57
 .. toctree::

Loading…
Peruuta
Tallenna