Commit Graph

197 Commits

Author SHA1 Message Date
Tim Graham e1bafdbffa Fixed #19965 - Added a warning that the tutorial is written for Python 2.
Thanks itsallvoodoo for the patch.
2013-03-12 08:04:32 -04:00
Claude Paroz 63c52dcbcd Fixed #20008 -- Removed trailing slash in Wikipedia link
Thanks senden9 at gmail.com for the report.
2013-03-10 15:57:51 +01:00
Ramiro Morales 3bbcec0aba Removed mentions of regressiontests. 2013-03-03 17:03:11 -03:00
Preston Holmes 17a28b39a8 Made a small clarification in tutorial.
refs #19889
2013-02-23 19:07:06 -08:00
Tim Graham f3ae67a62f Updated example to use staticfiles static template tag, thanks reinout for the suggestion, refs #19675. 2013-02-23 11:05:38 -05:00
Tim Graham 9e959e8d58 Updated static file example in overview to use static template tag, refs #19675.
Thanks jezdez for the note.
2013-02-23 10:35:22 -05:00
Tim Graham a61dbd6219 Fixed #19675 - Added mention of static files to overview.
Thanks Dwight Gunning for the patch.
2013-02-23 10:00:23 -05:00
Tim Graham 1b7fb29dfb Changed "mysite/mytemplates/" -> "mysite/templates" in tutorial.
Thanks James Pic.
2013-02-23 09:19:32 -05:00
Tim Graham 5ce6a7cea2 Updated tutorial 1 to reflect changes in default project template.
Thanks JonLoy for the patch.
2013-02-10 18:07:50 -05:00
Tim Graham aa85ccf8ce Fixed #19706 - Tweaks to the tutorial.
Thanks Daniele Procida.
2013-02-07 07:05:36 -05:00
Aymeric Augustin 3f1c7b7053 Simplified default project template.
Squashed commit of:

commit 508ec9144b35c50794708225b496bde1eb5e60aa
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Tue Jan 29 22:50:55 2013 +0100

    Tweaked default settings file.

    * Explained why BASE_DIR exists.
    * Added a link to the database configuration options, and put it in its
      own section.
    * Moved sensitive settings that must be changed for production at the
      top.

commit 6515fd2f1aa73a86dc8dbd2ccf512ddb6b140d57
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Tue Jan 29 14:35:21 2013 +0100

    Documented the simplified app & project templates in the changelog.

commit 2c5b576c2ea91d84273a019b3d0b3b8b4da72f23
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Tue Jan 29 13:59:27 2013 +0100

    Minor fixes in tutorials 5 and 6.

commit 55a51531be8104f21b3cca3f6bf70b0a7139a041
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Tue Jan 29 13:51:11 2013 +0100

    Updated tutorial 2 for the new project template.

commit 29ddae87bdaecff12dd31b16b000c01efbde9e20
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Tue Jan 29 11:58:54 2013 +0100

    Updated tutorial 1 for the new project template.

commit 0ecb9f6e2514cfd26a678a280d471433375101a3
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Tue Jan 29 11:29:13 2013 +0100

    Adjusted the default URLconf detection to account for the admin.

    It's now enabled by default.

commit 5fb4da0d3d09dac28dd94e3fde92b9d4335c0565
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Tue Jan 29 10:36:55 2013 +0100

    Added security warnings for the most sensitive settings.

commit 718d84bd8ac4a42fb4b28ec93965de32680f091e
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Mon Jan 28 23:24:06 2013 +0100

    Used an absolute path for the SQLite database.

    This ensures the settings file works regardless of which directory
    django-admin.py / manage.py is invoked from.

    BASE_DIR got a +1 from a BDFL and another core dev. It doesn't involve
    the concept of a "Django project"; it's just a convenient way to express
    relative paths within the source code repository for non-Python files.

    Thanks Jacob Kaplan-Moss for the suggestion.

commit 1b559b4bcda622e10909b68fe5cab90db6727dd9
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Mon Jan 28 23:22:40 2013 +0100

    Removed STATIC_ROOT from the default settings template.

    It isn't necessary in development, and it confuses beginners to no end.

    Thanks Carl Meyer for the suggestion.

commit a55f141a500bb7c9a1bc259bbe1954c13b199671
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Mon Jan 28 23:21:43 2013 +0100

    Removed MEDIA_ROOT/URL from default settings template.

    Many sites will never deal with user-uploaded files, and MEDIA_ROOT is
    complicated to explain.

    Thanks Carl Meyer for the suggestion.

commit 44bf2f2441420fd9429ee9fe1f7207f92dd87e70
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Mon Jan 28 22:22:09 2013 +0100

    Removed logging config.

    This configuration is applied regardless of the value of LOGGING;
    duplicating it in LOGGING is confusing.

commit eac747e848eaed65fd5f6f254f0a7559d856f88f
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Mon Jan 28 22:05:31 2013 +0100

    Enabled the locale middleware by default.

    USE_I18N is True by default, and doesn't work well without
    LocaleMiddleware.

commit d806c62b2d00826dc2688c84b092627b8d571cab
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Mon Jan 28 22:03:16 2013 +0100

    Enabled clickjacking protection by default.

commit 99152c30e6a15003f0b6737dc78e87adf462aacb
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Mon Jan 28 22:01:48 2013 +0100

    Reorganized settings in logical sections, and trimmed comments.

commit d37ffdfcb24b7e0ec7cc113d07190f65fb12fb8a
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Mon Jan 28 16:54:11 2013 +0100

    Avoided misleading TEMPLATE_DEBUG = DEBUG.

    According to the docs TEMPLATE_DEBUG works only when DEBUG = True.

commit 15d9478d3a9850e85841e7cf09cf83050371c6bf
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Mon Jan 28 16:46:25 2013 +0100

    Removed STATICFILES_FINDERS/TEMPLATE_LOADERS from default settings file.

    Only developers with special needs ever need to change these settings.

commit 574da0eb5bfb4570883756914b4dbd7e20e1f61e
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Mon Jan 28 16:45:01 2013 +0100

    Removed STATICFILES/TEMPLATES_DIRS from default settings file.

    The current best practice is to put static files and templates in
    applications, for easier testing and deployment.

commit 8cb18dbe56629aa1be74718a07e7cc66b4f9c9f0
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Mon Jan 28 16:24:16 2013 +0100

    Removed settings related to email reporting from default settings file.

    While handy for small scale projects, it isn't exactly a best practice.

commit 8ecbfcb3638058f0c49922540f874a7d802d864f
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Tue Jan 29 18:54:43 2013 +0100

    Documented how to enable the sites framework.

commit 23fc91a6fa67d91ddd9d71b1c3e0dc26bdad9841
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Mon Jan 28 16:28:59 2013 +0100

    Disabled the sites framework by default.

    RequestSite does the job for single-domain websites.

commit c4d82eb8afc0eb8568bf9c4d12644272415e3960
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Tue Jan 29 00:08:33 2013 +0100

    Added a default admin.py to the application template.

    Thanks Ryan D Hiebert for the suggestion.

commit 4071dc771e5c44b1c5ebb9beecefb164ae465e22
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Mon Jan 28 10:59:49 2013 +0100

    Enabled the admin by default.

    Everyone uses the admin.

commit c807a31f8d89e7e7fd97380e3023f7983a8b6fcb
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Mon Jan 28 10:57:05 2013 +0100

    Removed admindocs from default project template.

commit 09e4ce0e652a97da1a9e285046a91c8ad7a9189c
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Mon Jan 28 16:32:52 2013 +0100

    Added links to the settings documentation.

commit 5b8f5eaef364eb790fcde6f9e86f7d266074cca8
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Mon Jan 28 11:06:54 2013 +0100

    Used a significant example for URLconf includes.

commit 908e91d6fcee2a3cb51ca26ecdf12a6a24e69ef8
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Mon Jan 28 16:22:31 2013 +0100

    Moved code comments about WSGI to docs, and rewrote said docs.

commit 50417e51996146f891d08ca8b74dcc736a581932
Author: Aymeric Augustin <aymeric.augustin@m4x.org>
Date:   Mon Jan 28 15:51:50 2013 +0100

    Normalized the default application template.

    Removed the default test that 1 + 1 = 2, because it's been committed
    way too many times, in too many projects.

    Added an import of `render` for views, because the first view will
    often be:

    def home(request):
        return render(request, "mysite/home.html")
2013-02-04 13:21:36 +01:00
Aymeric Augustin 0412b7d280 Avoided ambiguous output when runserver port is already in use.
Thanks James Pic for the suggestion (PR 88).
2013-02-01 22:25:29 +01:00
Aymeric Augustin b2039d39d5 Attempted to reduce version mismatch problems in the tutorial. 2013-01-31 13:37:42 +01:00
Tim Graham ee26797cff Fixed typos in docs and comments 2013-01-29 10:55:55 -07:00
Aymeric Augustin b99a4e1073 Updated metrics on the documentation. 2013-01-29 14:12:04 +01:00
Tim Graham 14d1d504d5 Fixed two malformed links. 2013-01-27 06:09:50 -05:00
Tim Graham 43f89e0ad6 Fixed #19605 - Removed unused url imports from doc examples.
Thanks sergzach for the suggestion.
2013-01-15 07:50:26 -05:00
Tim Graham 9f9a7f03d7 Fixed #19437 - Clarified pip install instructions in contributing tutorial. 2013-01-11 07:01:56 -05:00
Tim Graham 1884868adc Added sphinx substitutions in place of hardcoded version numbers.
Refs #19571
2013-01-08 15:58:11 -05:00
Tim Graham 99315f709e Fixed #19555 - Removed '2012' from tutorial 1.
Thanks rodrigorosa.lg and others for the report.
2013-01-08 15:43:35 -05:00
Claude Paroz a890469d3b Fixed #19571 -- Updated runserver output in the tutorial 2013-01-06 22:59:23 +01:00
Tim Graham 9b5f64cc6e Fixed #19516 - Fixed remaining broken links.
Added -n to sphinx builds to catch issues going forward.
2013-01-02 18:32:57 -05:00
Tim Graham b3a8c9dab8 Fixed broken links, round 3. refs #19516 2012-12-26 19:07:22 -05:00
Tim Graham f56f6cfa58 Fixed links to DATABASE ENGINE setting. refs #19516 2012-12-24 15:38:05 -05:00
Ramiro Morales d19109fd37 Fixed #19497 -- Refactored testing docs.
Thanks Tim Graham for the review and suggestions.
2012-12-21 21:59:06 -03:00
Tim Graham 1e5b0fc4d0 Fixed #19344 - Documented how to run django-admin in a virtualenv on Windows.
Thanks Hourann Bosci for the patch.
2012-12-15 09:25:54 -05:00
Tim Graham b052e6cc95 Fixed #9962 - Added a testing tutorial.
Thank-you Daniele Procida for the first draft
and shaibi, Aymeric, and others for the reviews.
2012-12-15 08:09:40 -05:00
Ben Longden 55a2d5b577 Removes PHP references 2012-12-13 13:20:47 +00:00
Tim Graham 0eed8ece32 Fixed #19377 - Emphasized database host link in tutorial 2012-12-11 16:34:17 -05:00
Tim Graham 7058b595b6 Fixed #16779 - Added a contributing tutorial
Thank-you Taavi Taijala for the draft patch!
2012-11-17 14:10:25 -05:00
Tim Graham 2dbfa66f4d Fixed #19289 - Removed an out of place sentence in tutorial 2.
Thanks colinnkeenan for the report.
2012-11-14 05:46:30 -05:00
Tim Graham a72b8a2247 Fixed #19260 - Added a comment to tutorial 1.
Thanks terwey for the suggestion.
2012-11-13 05:45:08 -05:00
Tim Graham dd0d2c0be5 Fixed #19216 - Switched to user level installation in apps tutorial.
Thanks Nick Coghlan for the suggestion.
2012-10-31 19:56:53 -04:00
Tim Graham 08cf54990a Fixed #16671 - Added a tutorial on reuseable apps
Thank-you Katie Miller and Ben Sturmfels for the initial draft,
as well as Russ and Carl for the reviews.
2012-10-30 18:40:21 -04:00
Tim Graham 5c143cb340 Fixed #19180 - Clarified policy regarding older versions of the docs. 2012-10-25 17:55:42 -04:00
Tim Graham 07abb7a6b7 Fixed #18715 - Refactored tutorial 3. Thank-you Daniel Greenfeld! 2012-10-15 19:47:26 -04:00
Claude Paroz 8bd7b598b6 Fixed #18807 -- Made 404.html and 500.html optional
Thanks Aymeric Augustin for the report and Jannis Leidel for the
review.
2012-09-30 23:16:19 +02:00
Aymeric Augustin 98b6ce60f4 Made a version condition less confusing.
Fixed #18762 (again).
2012-09-23 20:18:29 +02:00
Julien Phalip 6eb4f25692 Removed an obsolete documentation page about admin style customization. 2012-09-10 17:19:35 -07:00
Aymeric Augustin e69348b4e7 Avoided mixing dates and datetimes in the examples.
Refs #16023.
2012-09-08 11:00:04 -04:00
Tim Graham 1d235b3914 Merge pull request #351 from 1ntrud3r/patch-1
Remove unused imports in tutorial 4. refs #18915
2012-09-07 15:29:42 -07:00
Tim Graham 499e71eb2e Merge pull request #341 from nmartini/master
Updated text in tutorial 3 regarding removing unused import; refs #18915
2012-09-07 15:27:29 -07:00
Aymeric Augustin 7435cc0167 Updated install docs to reflect Python 3 status.
Closes #17452.
2012-09-07 17:12:11 -04:00
Enrico Ehrhardt e78f2f6a63 remove unused import in tutorial 4 addition to #18915 (closed)
After submitting ticket #18915, I noticed 2 additional occurrences of the issue.
2012-09-07 23:26:37 +03:00
Nick Martini 9ce58906af removed unused import from tutorial 3 documentation as per ticket #18915 2012-09-07 13:05:23 -04:00
Dan Loewenherz 07b3d39d10 remove unused import in decoupling URLs tutorial, closes #18915
The `include` function isn't used in polls/urls.py.
2012-09-07 11:49:55 -04:00
Aymeric Augustin 4da1d0fd65 Added a warning about the {% url %} syntax change
at the point where it bites most beginners.

Refs #18787, #18762, #18756, #18723, #18705, #18689 and several duplicates.
2012-08-18 09:58:42 +02:00
Angeline Tan 5d4f993bb1 Moved a note about django-admin.py errors from Tutorial Part 1 to a new FAQ Troubleshooting page. This is to avoid confusion for beginners. 2012-08-04 17:27:57 -07:00
Tim Graham 2a16eb0792 Fixed #17704 - Updated the StackedInline section in Tutorial 2; thanks xbito for the draft patch. 2012-08-02 19:22:49 -04:00
Tim Graham 690ed57946 Fixed #18476 - Added use of {% url %} tag to tutorial.
Thanks Claude Paroz for the patch.
2012-07-29 18:14:26 -04:00