"Fossies" - the Fresh Open Source Software Archive

Member "Django-1.11.25/docs/intro/install.txt" (1 Oct 2019, 3287 Bytes) of package /linux/www/Django-1.11.25.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 ===================
    2 Quick install guide
    3 ===================
    4 
    5 Before you can use Django, you'll need to get it installed. We have a
    6 :doc:`complete installation guide </topics/install>` that covers all the
    7 possibilities; this guide will guide you to a simple, minimal installation
    8 that'll work while you walk through the introduction.
    9 
   10 Install Python
   11 ==============
   12 
   13 Being a Python Web framework, Django requires Python. See
   14 :ref:`faq-python-version-support` for details. Python includes a lightweight
   15 database called SQLite_ so you won't need to set up a database just yet.
   16 
   17 .. _sqlite: https://sqlite.org/
   18 
   19 Get the latest version of Python at https://www.python.org/downloads/ or with
   20 your operating system's package manager.
   21 
   22 .. admonition:: Django on Jython
   23 
   24     If you use Jython_ (a Python implementation for the Java platform), you'll
   25     need to follow a few additional steps. See :doc:`/howto/jython` for details.
   26 
   27 .. _jython: http://www.jython.org/
   28 
   29 You can verify that Python is installed by typing ``python`` from your shell;
   30 you should see something like::
   31 
   32     Python 3.4.x
   33     [GCC 4.x] on linux
   34     Type "help", "copyright", "credits" or "license" for more information.
   35     >>>
   36 
   37 Set up a database
   38 =================
   39 
   40 This step is only necessary if you'd like to work with a "large" database engine
   41 like PostgreSQL, MySQL, or Oracle. To install such a database, consult the
   42 :ref:`database installation information <database-installation>`.
   43 
   44 Remove any old versions of Django
   45 =================================
   46 
   47 If you are upgrading your installation of Django from a previous version, you
   48 will need to :ref:`uninstall the old Django version before installing the new
   49 version <removing-old-versions-of-django>`.
   50 
   51 Install Django
   52 ==============
   53 
   54 You've got three easy options to install Django:
   55 
   56 * :ref:`Install an official release <installing-official-release>`. This
   57   is the best approach for most users.
   58 
   59 * Install a version of Django :ref:`provided by your operating system
   60   distribution <installing-distribution-package>`.
   61 
   62 * :ref:`Install the latest development version
   63   <installing-development-version>`. This option is for enthusiasts who want
   64   the latest-and-greatest features and aren't afraid of running brand new code.
   65   You might encounter new bugs in the development version, but reporting them
   66   helps the development of Django. Also, releases of third-party packages are
   67   less likely to be compatible with the development version than with the
   68   latest stable release.
   69 
   70 .. admonition:: Always refer to the documentation that corresponds to the
   71     version of Django you're using!
   72 
   73     If you do either of the first two steps, keep an eye out for parts of the
   74     documentation marked **new in development version**. That phrase flags
   75     features that are only available in development versions of Django, and
   76     they likely won't work with an official release.
   77 
   78 
   79 Verifying
   80 =========
   81 
   82 To verify that Django can be seen by Python, type ``python`` from your shell.
   83 Then at the Python prompt, try to import Django:
   84 
   85 .. parsed-literal::
   86 
   87     >>> import django
   88     >>> print(django.get_version())
   89     |version|
   90 
   91 You may have another version of Django installed.
   92 
   93 That's it!
   94 ==========
   95 
   96 That's it -- you can now :doc:`move onto the tutorial </intro/tutorial01>`.