Kaydet (Commit) d80d05fc authored tarafından Preston Holmes's avatar Preston Holmes

Added examples of using startproject/app with URLs

thanks to Brent O'Connor for the idea and intial docs
üst 8e5573e9
...@@ -879,14 +879,19 @@ either the path to a directory with the app template file, or a path to a ...@@ -879,14 +879,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``) compressed file (``.tar.gz``, ``.tar.bz2``, ``.tgz``, ``.tbz``, ``.zip``)
containing the app template files. 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 Django will also accept URLs (``http``, ``https``, ``ftp``) to compressed
archives with the app template files, downloading and extracting them on the archives with the app template files, downloading and extracting them on the
fly. fly.
For example, this would look for an app template in the given directory when For example, taking advantage of Github's feature to expose repositories as
creating the ``myapp`` app:: 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 .. versionadded:: 1.4
...@@ -954,6 +959,15 @@ when creating the ``myproject`` project:: ...@@ -954,6 +959,15 @@ when creating the ``myproject`` project::
django-admin.py startproject --template=/Users/jezdez/Code/my_project_template myproject 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 When Django copies the project template files, it also renders certain files
through the template engine: the files whose extensions match the through the template engine: the files whose extensions match the
``--extension`` option (``py`` by default) and the files whose names are passed ``--extension`` option (``py`` by default) and the files whose names are passed
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment