mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-01-22 00:02:15 +00:00
Code Issues 32 Releases Wiki Activity

Copy-edited docs/faq.txt

Browse Source 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@114 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Adrian Holovaty 2005-07-16 21:16:40 +00:00
parent caef61945d
commit 31cd933263
1 changed files with 24 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

48
docs/faq.txt
View File

@ -100,17 +100,16 @@ Django appears to be a MVC framework, but you call the Controller the "view", an
That's because Django isn't strictly a MVC framework. We don't really believe in That's because Django isn't strictly a MVC framework. We don't really believe in
any capital-M Methodologies; we do what "feels" right. If you squint the right any capital-M Methodologies; we do what "feels" right. If you squint the right
way, you can call Django's ORM the "Model", the view functions the "View", and way, you can call Django's ORM the "Model", the view functions the "View", and
the API automatically generated from the models the "Controller" -- but not the dynamically-generated API the "Controller" -- but not really.
really.
So although we've been strongly influenced by MVC -- especially in the So, although we've been strongly influenced by MVC -- especially in the
separation of data from logic department -- we've also strayed from the path separation-of-data-from-logic department -- we've also strayed from the path
where it makes sense. where it makes sense.
Do you have any of those nifty "screencast" things? Do you have any of those nifty "screencast" things?
--------------------------------------------------- ---------------------------------------------------
They're in the works -- it's amazing how much time those things take! Stay tuned... They're in the works. It's amazing how much time those things take! Stay tuned...
Installation questions Installation questions
====================== ======================
@ -123,7 +122,7 @@ How do I get started?
#. Walk through the tutorial_. #. Walk through the tutorial_.
#. Check out the rest of the documentation_, and ask questions if you #. Check out the rest of the documentation_, and ask questions if you
run into trouble. run into trouble.
.. _`Download the code`: http://www.djangoproject.com/download/ .. _`Download the code`: http://www.djangoproject.com/download/
.. _`installation guide`: http://www.djangoproject.com/documentation/install/ .. _`installation guide`: http://www.djangoproject.com/documentation/install/
.. _tutorial: http://www.djangoproject.com/documentation/tutorial1/ .. _tutorial: http://www.djangoproject.com/documentation/tutorial1/
@ -137,12 +136,13 @@ Just run the ``ex_setup.py`` script in the Django distribution.
What are Django's prerequisites? What are Django's prerequisites?
-------------------------------- --------------------------------
Django requires Python_ 2.3 or later, Apache2_, and mod_python_. You'll Django requires Python_ 2.3 or later, `Apache 2`_, and mod_python_.
also need a database engine; PostgreSQL_ is recommended, and MySQL_ is
You'll also need a database engine. PostgreSQL_ is recommended, and MySQL_ is
supported. supported.
.. _Python: http://www.python.org/ .. _Python: http://www.python.org/
.. _Apache2: http://httpd.apache.org/ .. _Apache 2: http://httpd.apache.org/
.. _mod_python: http://www.modpython.org/ .. _mod_python: http://www.modpython.org/
.. _PostgreSQL: http://www.postgresql.org/ .. _PostgreSQL: http://www.postgresql.org/
.. _MySQL: http://www.mysql.com/ .. _MySQL: http://www.mysql.com/
@ -155,8 +155,8 @@ How do I install mod_python on Windows?
* For Python 2.3, grab mod_python from http://www.mod_python.org/, the read * For Python 2.3, grab mod_python from http://www.mod_python.org/, the read
`Running mod_python on Apache on Windows2000`_. `Running mod_python on Apache on Windows2000`_.
* Also try this (not windows-specific) `guide to getting mod_python working`_. * Also try this (not Windows-specific) `guide to getting mod_python working`_.
.. _`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 .. _`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
.. _`Running mod_python on Apache on Windows2000`: http://groups-beta.google.com/group/comp.lang.python/msg/139af8c83a5a9d4f .. _`Running mod_python on Apache on Windows2000`: http://groups-beta.google.com/group/comp.lang.python/msg/139af8c83a5a9d4f
.. _`guide to getting mod_python working`: http://www.dscpl.com.au/articles/modpython-001.html .. _`guide to getting mod_python working`: http://www.dscpl.com.au/articles/modpython-001.html
@ -166,16 +166,16 @@ How do I install mod_python on Windows?
Do I have to use mod_python? Do I have to use mod_python?
---------------------------- ----------------------------
In the first release, yes. However, WSGI_ support (which will let Django run In the first release, yes. However, WSGI_ support (which will let Django run
under FCGI, SCGI, medusa, etc.) is in the works; stay tuned! under FCGI, SCGI, medusa, etc.) is in the works. Stay tuned!
.. _WSGI: http://www.python.org/peps/pep-0333.html .. _WSGI: http://www.python.org/peps/pep-0333.html
Will Django run under shared hosting (like TextDrive or Dreamhost)? Will Django run under shared hosting (like TextDrive or Dreamhost)?
------------------------------------------------------------------- -------------------------------------------------------------------
Right now, no, unless you can get your host to install mod_python. However, as Right now, no, unless you can get your host to install mod_python. However, as
the previous question says, WSGI support is coming!. the previous answer says, WSGI support is coming!
Using Django Using Django
============ ============
@ -187,27 +187,27 @@ Make sure that:
* The environment variable DJANGO_SETTINGS_MODULE is set to a fully-qualified * The environment variable DJANGO_SETTINGS_MODULE is set to a fully-qualified
Python module (i.e. "mysite.settings.main"). Python module (i.e. "mysite.settings.main").
* Said module is on ``sys.path`` (``import mysite.settings.main`` should work). * Said module is on ``sys.path`` (``import mysite.settings.main`` should work).
* The module doesn't contain syntax errors (of course). * The module doesn't contain syntax errors (of course).
* If you're using mod_python but *not* using Django's request handler, * If you're using mod_python but *not* using Django's request handler,
you'll need to work around a mod_python bug related to the use of you'll need to work around a mod_python bug related to the use of
``SetEnv``; before you import anything from Django you'll need to do ``SetEnv``; before you import anything from Django you'll need to do
the following:: the following::
os.environ.update(req.subprocess_env) os.environ.update(req.subprocess_env)
(where ``req`` is the mod_python request object). (where ``req`` is the mod_python request object).
I can't stand your template language; do I have to use it? I can't stand your template language. Do I have to use it?
---------------------------------------------------------- ----------------------------------------------------------
We happen to think our template engine is the best thing since chunky bacon, We happen to think our template engine is the best thing since chunky bacon,
but we recognize that choosing a template language runs close to religion. but we recognize that choosing a template language runs close to religion.
There's nothing about Django that requires using the template language, so There's nothing about Django that requires using the template language, so
if you're attached to ZPT, Cheetah, or whatever, feel free to use those. if you're attached to ZPT, Cheetah, or whatever, feel free to use those.
The admin interface The admin interface
=================== ===================