summaryrefslogtreecommitdiff
path: root/docs/intro/tutorial01.txt
AgeCommit message (Collapse)Author
2013-05-07Fixed Sphinx error in tutorial 1.Carl Meyer
2013-04-29Fixed #20330 -- Normalized spelling of "web server".Aymeric Augustin
Thanks Baptiste Mispelon for the report.
2013-04-28Pointed to the docs version switcher in tutorial 1.Aymeric Augustin
Refs #20324. Thanks dwisehart for the suggestion.
2013-04-22Fixed #19211 -- Adapted tutorial for Python 3Claude Paroz
2013-04-20Updated tutorial INSTALLED_APPS section (removed contrib.sites)Claude Paroz
2013-04-12Fixed #20247 - Added some missing paths in the tutorial.Tim Graham
Thanks gsavix for the suggestion and patch.
2013-03-23Fix minor typo in tutorialChristos Kontas
2013-03-12Fixed #19965 - Added a warning that the tutorial is written for Python 2.Tim Graham
Thanks itsallvoodoo for the patch.
2013-02-10Updated tutorial 1 to reflect changes in default project template.Tim Graham
Thanks JonLoy for the patch.
2013-02-07Fixed #19706 - Tweaks to the tutorial.Tim Graham
Thanks Daniele Procida.
2013-02-04Simplified default project template.Aymeric Augustin
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-01Avoided ambiguous output when runserver port is already in use.Aymeric Augustin
Thanks James Pic for the suggestion (PR 88).
2013-01-31Attempted to reduce version mismatch problems in the tutorial.Aymeric Augustin
2013-01-08Added sphinx substitutions in place of hardcoded version numbers.Tim Graham
Refs #19571
2013-01-08Fixed #19555 - Removed '2012' from tutorial 1.Tim Graham
Thanks rodrigorosa.lg and others for the report.
2013-01-06Fixed #19571 -- Updated runserver output in the tutorialClaude Paroz
2013-01-02Fixed #19516 - Fixed remaining broken links.Tim Graham
Added -n to sphinx builds to catch issues going forward.
2012-12-24Fixed links to DATABASE ENGINE setting. refs #19516Tim Graham
2012-12-15Fixed #19344 - Documented how to run django-admin in a virtualenv on Windows.Tim Graham
Thanks Hourann Bosci for the patch.
2012-12-13Removes PHP referencesBen Longden
2012-12-11Fixed #19377 - Emphasized database host link in tutorialTim Graham
2012-11-13Fixed #19260 - Added a comment to tutorial 1.Tim Graham
Thanks terwey for the suggestion.
2012-08-04Moved a note about django-admin.py errors from Tutorial Part 1 to a new FAQ ↵Angeline Tan
Troubleshooting page. This is to avoid confusion for beginners.
2012-05-25Fixed #17929 -- Improved tutorial wording and capitalization.Claude Paroz
Thanks rmattb for the report and the patch.
2012-05-22Fixed #18167 -- Gave advice on checking Django version in the tutorial.Claude Paroz
Thanks smuss for the initial patch.
2012-04-20Fixed #10494 -- Added kwargs to QuerySet.get() error message in the case no ↵Anssi Kääriäinen
objects were found. Thanks brondsem for the report, Szymon Pyzalski for the patch and oinopion for review. git-svn-id: http://code.djangoproject.com/svn/django/trunk@17917 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2012-03-31Fixed #17965 -- Definitely dropped support for Python 2.5. Thanks jonash for ↵Claude Paroz
the initial patch and Aymeric Augustin for the review. git-svn-id: http://code.djangoproject.com/svn/django/trunk@17834 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2012-03-02Edited stuff from [17543] to [17629]Adrian Holovaty
git-svn-id: http://code.djangoproject.com/svn/django/trunk@17630 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2012-02-26Fixed #17715 -- Updated the tutorial for time zone support, plus a few other ↵Aymeric Augustin
improvements. git-svn-id: http://code.djangoproject.com/svn/django/trunk@17591 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2012-01-02Fixed #17490 -- Added a trailing comma in INSTALLED_APPS, to avoid ↵Aymeric Augustin
unexpected string concatenation when adding another app. git-svn-id: http://code.djangoproject.com/svn/django/trunk@17324 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-12-31Fixed #11986 - Added sudo to Mac OS permissions note in tutorial.Timo Graham
git-svn-id: http://code.djangoproject.com/svn/django/trunk@17318 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-11-16Fixed #17240 -- Replaced links to the online version of the docs by internal ↵Aymeric Augustin
references. git-svn-id: http://code.djangoproject.com/svn/django/trunk@17100 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-10-22Fixed #16360 -- Added WSGI entrypoint to startproject layout, and enabled ↵Carl Meyer
internal servers (runserver and runfcgi) to use an externally-defined WSGI application. Thanks to Armin Ronacher, Jannis Leidel, Alex Gaynor, ptone, and Jacob Kaplan-Moss. git-svn-id: http://code.djangoproject.com/svn/django/trunk@17022 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-10-14Fixed many more ReST indentation errors, somehow accidentally missed from ↵Luke Plant
[16955] git-svn-id: http://code.djangoproject.com/svn/django/trunk@16983 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-10-13Fixed #15372 -- Switched to a startproject default layout that allows us to ↵Carl Meyer
avoid sys.path hacks. git-svn-id: http://code.djangoproject.com/svn/django/trunk@16964 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-09-09Fixed #16782 -- Corrected a broken cross-reference to the database engine ↵Gabriel Hurley
setting in the tutorial. Thanks to mjumbewu for the report and patch. git-svn-id: http://code.djangoproject.com/svn/django/trunk@16754 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-08-23Fixed #16669 -- Made the startproject instruction formatting easier to read ↵Julien Phalip
and more consistent with other formatting in the tutorial part 1. Thanks to Daniel Lawrence and Aymeric Augustin. git-svn-id: http://code.djangoproject.com/svn/django/trunk@16664 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-05-13Fixed #16014 -- numerous documentation typos -- thanks psmith.Simon Meers
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16220 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-02-22Fixed #15257 - Add a link about field lookups to the tutorial; thanks dwillis.Timo Graham
git-svn-id: http://code.djangoproject.com/svn/django/trunk@15624 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-12-11Fixed #14863 - Add contrib.messages and staticfiles to list of default ↵Timo Graham
INSTALLED_APPS in tutorial. thanks tgm for report and adamv for patch. git-svn-id: http://code.djangoproject.com/svn/django/trunk@14870 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-11-19Fixed #14728 -- Broadened warning about django-admin.py missing .py suffix ↵Carl Meyer
to include more than just Ubuntu, since at least Fedora also does this. Thanks to giallu for the report. git-svn-id: http://code.djangoproject.com/svn/django/trunk@14621 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-11-17Remove an obsolete admonition in tutorial one (referencing 0.96 functionality)Chris Beaven
git-svn-id: http://code.djangoproject.com/svn/django/trunk@14585 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-11-08Small rewording of tutorial01.txt changes from [14066]Adrian Holovaty
git-svn-id: http://code.djangoproject.com/svn/django/trunk@14499 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-10-10Fixed typo in tutorial 01.Carl Meyer
git-svn-id: http://code.djangoproject.com/svn/django/trunk@14129 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-10-10Fixed #13927 -- Advises that the Ubuntu package manager drops the .py ↵Gabriel Hurley
extension from django-admin.py. Thanks to islands for the report and d0ugal for the patch. git-svn-id: http://code.djangoproject.com/svn/django/trunk@14108 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-10-09Fixed #11509 -- Modified usage of "Web" to match our style guide in various ↵Russell Keith-Magee
documentation, comments and code. Thanks to timo and Simon Meers for the work on the patch. git-svn-id: http://code.djangoproject.com/svn/django/trunk@14069 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-10-09Fixed #14255 -- factor project name out of app imports in tutorial. Thanks ↵Simon Meers
to adamend for the report and initial patch. git-svn-id: http://code.djangoproject.com/svn/django/trunk@14066 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-08-19Fixed #14141: docs now use the :doc: construct for links between documents.Jacob Kaplan-Moss
Thanks, Ramiro Morales. git-svn-id: http://code.djangoproject.com/svn/django/trunk@13608 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-03-08Fixed #12114 -- Clarified the existence of the reverse relation _set in the ↵Russell Keith-Magee
tutorial. Thanks to panfist for the suggestion, and dwillis for the patch. git-svn-id: http://code.djangoproject.com/svn/django/trunk@12711 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-02-01Fixed #12745: The maxlength -> max_length change happened in 2007, we can ↵James Bennett
probably stop mentioning it in the tutorial now. git-svn-id: http://code.djangoproject.com/svn/django/trunk@12362 bcc190cf-cafb-0310-a4f2-bffc1f526a37