mirror of
https://github.com/django/django.git
synced 2024-12-27 03:25:58 +00:00
4a954cfd11
This patch does not remove all occurrences of the words in question. Rather, I went through all of the occurrences of the words listed below, and judged if they a) suggested the reader had some kind of knowledge/experience, and b) if they added anything of value (including tone of voice, etc). I left most of the words alone. I looked at the following words: - simply/simple - easy/easier/easiest - obvious - just - merely - straightforward - ridiculous Thanks to Carlton Gibson for guidance on how to approach this issue, and to Tim Bell for providing the idea. But the enormous lion's share of thanks go to Adam Johnson for his patient and helpful review.
83 lines
2.7 KiB
Plaintext
83 lines
2.7 KiB
Plaintext
===================
|
|
Quick install guide
|
|
===================
|
|
|
|
Before you can use Django, you'll need to get it installed. We have a
|
|
:doc:`complete installation guide </topics/install>` that covers all the
|
|
possibilities; this guide will guide you to a minimal installation that'll work
|
|
while you walk through the introduction.
|
|
|
|
Install Python
|
|
==============
|
|
|
|
Being a Python Web framework, Django requires Python. See
|
|
:ref:`faq-python-version-support` for details. Python includes a lightweight
|
|
database called SQLite_ so you won't need to set up a database just yet.
|
|
|
|
.. _sqlite: https://sqlite.org/
|
|
|
|
Get the latest version of Python at https://www.python.org/downloads/ or with
|
|
your operating system's package manager.
|
|
|
|
You can verify that Python is installed by typing ``python`` from your shell;
|
|
you should see something like::
|
|
|
|
Python 3.x.y
|
|
[GCC 4.x] on linux
|
|
Type "help", "copyright", "credits" or "license" for more information.
|
|
>>>
|
|
|
|
Set up a database
|
|
=================
|
|
|
|
This step is only necessary if you'd like to work with a "large" database engine
|
|
like PostgreSQL, MariaDB, MySQL, or Oracle. To install such a database, consult
|
|
the :ref:`database installation information <database-installation>`.
|
|
|
|
Install Django
|
|
==============
|
|
|
|
You've got three options to install Django:
|
|
|
|
* :ref:`Install an official release <installing-official-release>`. This
|
|
is the best approach for most users.
|
|
|
|
* Install a version of Django :ref:`provided by your operating system
|
|
distribution <installing-distribution-package>`.
|
|
|
|
* :ref:`Install the latest development version
|
|
<installing-development-version>`. This option is for enthusiasts who want
|
|
the latest-and-greatest features and aren't afraid of running brand new code.
|
|
You might encounter new bugs in the development version, but reporting them
|
|
helps the development of Django. Also, releases of third-party packages are
|
|
less likely to be compatible with the development version than with the
|
|
latest stable release.
|
|
|
|
.. admonition:: Always refer to the documentation that corresponds to the
|
|
version of Django you're using!
|
|
|
|
If you do either of the first two steps, keep an eye out for parts of the
|
|
documentation marked **new in development version**. That phrase flags
|
|
features that are only available in development versions of Django, and
|
|
they likely won't work with an official release.
|
|
|
|
|
|
Verifying
|
|
=========
|
|
|
|
To verify that Django can be seen by Python, type ``python`` from your shell.
|
|
Then at the Python prompt, try to import Django:
|
|
|
|
.. parsed-literal::
|
|
|
|
>>> import django
|
|
>>> print(django.get_version())
|
|
|version|
|
|
|
|
You may have another version of Django installed.
|
|
|
|
That's it!
|
|
==========
|
|
|
|
That's it -- you can now :doc:`move onto the tutorial </intro/tutorial01>`.
|