Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse code

Rolled comments from install and faq pages into those docs.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@111 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit fca1ef1d15650d6c2d5b9a35597f057004729ea4 1 parent 5721396
Jacob Kaplan-Moss authored
92  docs/faq.txt
@@ -94,13 +94,45 @@ Lawrence, Kansas, USA.
94 94
 .. _`Jacob Kaplan-Moss`: http://www.jacobian.org/
95 95
 .. _`Wilson Miner`: http://www.wilsonminer.com/live/
96 96
 
97  
-Using Django
98  
-============
  97
+Django appears to be a MVC framework, but you call the Controller the "view", and the View the "template". How come you don't use the standard names?
  98
+-----------------------------------------------------------------------------------------------------------------------------------------------------
  99
+
  100
+That's because Django isn't strictly a MVC framework.  We don't really belive in
  101
+any capital-M Methodoligies; we do what "feels" right.  If you squint the right
  102
+way, you can call Django's ORM the "Model", the view functions the "View", and
  103
+the API automatically generated from the models the "Controller" -- but not
  104
+really.
  105
+
  106
+So although we've been strongly influenced by MVC -- especially in the
  107
+separation of data from logic department -- we've also strayed from the path
  108
+where it makes sense.
  109
+
  110
+Do you have any of those nifty "screencast" things?
  111
+---------------------------------------------------
  112
+
  113
+They're in the works -- it's amazing how much time those things take!  Stay tuned...
  114
+
  115
+Installation questions
  116
+======================
99 117
 
100 118
 How do I get started?
101 119
 ---------------------
102 120
 
103  
-We're working on this documentation as you read this.
  121
+    #. `Download the code`_.
  122
+    #. Install Django (read the `installation guide`_).
  123
+    #. Walk through the tutorial_.
  124
+    #. Check out the rest of the documentation_, and ask questions if you
  125
+       run into trouble.
  126
+       
  127
+.. _`Download the code`: http://www.djangoproject.com/download/
  128
+.. _`installation guide`: http://www.djangoproject.com/documentation/install/
  129
+.. _tutorial:  http://www.djangoproject.com/documentation/tutorial1/
  130
+.. _documentation: http://www.djangoproject.com/documentation/
  131
+
  132
+How do I fix the "install a later version of setuptools" error?
  133
+---------------------------------------------------------------
  134
+
  135
+Just run the ``ex_setup.py`` script in the Django distribution.
104 136
 
105 137
 What are Django's prerequisites?
106 138
 --------------------------------
@@ -109,17 +141,63 @@ Django requires Python_ 2.3 or later, Apache2_, and mod_python_.  You'll
109 141
 also need a database engine; PostgreSQL_ is recommended, and MySQL_ is
110 142
 supported.
111 143
 
112  
-We're currently working on expanding those options: WSGI_ support is in the
113  
-works (which will allow Django to run under CGI, FCGI, etc.), as is support for
114  
-a number of other database backends.
115  
-
116 144
 .. _Python: http://www.python.org/
117 145
 .. _Apache2: http://httpd.apache.org/
118 146
 .. _mod_python: http://www.modpython.org/
119 147
 .. _PostgreSQL: http://www.postgresql.org/
120 148
 .. _MySQL: http://www.mysql.com/
  149
+
  150
+How do I install mod_python on Windows?
  151
+---------------------------------------
  152
+
  153
+    * If you are running Python 2.4, check out this `guide to mod_python & Python 2.3`_.
  154
+
  155
+    * For Python 2.3, grab mod_python from http://ww.mod_python.org/, the read
  156
+      `Running mod_python on Apache on Windows2000`_.
  157
+
  158
+    * Also try this (not windows-specific) `guide to getting mod_python working`_.
  159
+      
  160
+.. _`guide to mod_python & Python 2.3`: http://www.lehuen.com/nicolas/index.php/2005/02/21/39-win32-build-of-mod_python-314-for-python-24
  161
+.. _`Running mod_python on Apache on Windows2000`: http://groups-beta.google.com/group/comp.lang.python/msg/139af8c83a5a9d4f
  162
+.. _`guide to getting mod_python working`: http://www.dscpl.com.au/articles/modpython-001.html
  163
+
  164
+(Thanks to deelan for this info.)
  165
+
  166
+Do I have to use mod_python?
  167
+----------------------------
  168
+
  169
+In the first release, yes.  However, WSGI_ support (which will let Django run
  170
+under FCGI, SCGI, medusa, etc.) is in the works; stay tuned!
  171
+
121 172
 .. _WSGI: http://www.python.org/peps/pep-0333.html
122 173
 
  174
+Will Django run under shared hosting (like TextDrive or Dreamhost)?
  175
+-------------------------------------------------------------------
  176
+
  177
+Right now, no, unless you can get your host to install mod_python.  However, as
  178
+the previous question says, WSGI support is comming!.
  179
+
  180
+Why do I get an error about importing DJANGO_SETTINGS_MODULE?
  181
+-------------------------------------------------------------
  182
+
  183
+Make sure that:
  184
+
  185
+    * The environment variable DJANGO_SETTINGS_MODULE is set to a fully-qualifed
  186
+      Python module (i.e. "mysite.settings.main").
  187
+    
  188
+    * Said module is on ``sys.path`` (``import mysite.settings.main`` should work).
  189
+    
  190
+    * The module doesn't contain syntax errors (of course).
  191
+    
  192
+    * If you're using mod_python but *not* using Django's request handler,
  193
+      you'll need to work around a mod_python bug related to the use of
  194
+      ``SetEnv``; before you import anything from Django you'll need to do
  195
+      the following::
  196
+      
  197
+            os.environ.update(req.subprocess_env)
  198
+            
  199
+      (where ``req`` is the mod_python request object).
  200
+
123 201
 The admin interface
124 202
 ===================
125 203
 
2  docs/install.txt
@@ -63,7 +63,7 @@ Installing the development version
63 63
 3. Symlink ``django_src/django`` so that ``django`` is within your Python
64 64
    ``site-packages`` directory:
65 65
 
66  
-   ``ln -s django_src/django /usr/lib/python2.3/site-packages/django``
  66
+   ``ln -s `pwd`/django_src/django /usr/lib/python2.3/site-packages/django``
67 67
 
68 68
    (In the above line, change ``python2.3`` to match your current Python version.)
69 69
 

0 notes on commit fca1ef1

Please sign in to comment.
Something went wrong with that request. Please try again.