Commit 19710955 authored by Preston Holmes's avatar Preston Holmes
Browse files

[1.4.x] Added examples of using startproject/app with URLs

thanks to Brent O'Connor for the idea and intial docs
parent 9003d6fe
Loading
Loading
Loading
Loading
+17 −3
Original line number Diff line number Diff line
@@ -940,14 +940,19 @@ either the path to a directory with the app template file, or a path to a
compressed file (``.tar.gz``, ``.tar.bz2``, ``.tgz``, ``.tbz``, ``.zip``)
containing the app template files.

For example, this would look for an app template in the given directory when
creating the ``myapp`` app::

    django-admin.py startapp --template=/Users/jezdez/Code/my_app_template myapp

Django will also accept URLs (``http``, ``https``, ``ftp``) to compressed
archives with the app template files, downloading and extracting them on the
fly.

For example, this would look for an app template in the given directory when
creating the ``myapp`` app::
For example, taking advantage of Github's feature to expose repositories as
zip files, you can use a URL like::

    django-admin.py startapp --template=/Users/jezdez/Code/my_app_template myapp
    django-admin.py startapp --template=https://github.com/githubuser/django-app-template/archive/master.zip myapp

.. versionadded:: 1.4

@@ -1015,6 +1020,15 @@ when creating the ``myproject`` project::

    django-admin.py startproject --template=/Users/jezdez/Code/my_project_template myproject

Django will also accept URLs (``http``, ``https``, ``ftp``) to compressed
archives with the project template files, downloading and extracting them on the
fly.

For example, taking advantage of Github's feature to expose repositories as
zip files, you can use a URL like::

    django-admin.py startproject --template=https://github.com/githubuser/django-project-template/archive/master.zip myproject

When Django copies the project template files, it also renders certain files
through the template engine: the files whose extensions match the
``--extension`` option (``py`` by default) and the files whose names are passed