Commit Graph

486 Commits

Author SHA1 Message Date
darkryder 9ec8aa5e5d Fixed #24149 -- Normalized tuple settings to lists. 2015-02-03 14:59:45 -05:00
Tim Graham 7e8cf74dc7 Removed support for syncing apps without migrations per deprecation timeline.
Kept support for creating models without migrations when running tests
(especially for Django's test suite).
2015-01-18 15:58:06 -05:00
Tim Graham 4aa089a9a9 Removed support for custom SQL per deprecation timeline. 2015-01-17 10:16:06 -05:00
Tim Graham fed25f1105 Removed compatibility with Python 3.2. 2015-01-17 09:00:17 -05:00
Keryn Knight 726a9550db Fixed #24143 -- Encouraged use of Http404 messages for debugging. 2015-01-16 09:41:01 -05:00
Collin Anderson 26a92619f6 Fixed #24124 -- Changed context_processors in the default settings.py 2015-01-12 13:17:44 -05:00
Aymeric Augustin ee8d5b91e9 Wrote main documentation for templates. 2015-01-10 20:16:19 +01:00
Aymeric Augustin d3205e3e2e Deprecated TEMPLATE_DIRS. 2014-12-28 17:02:30 +01:00
Aymeric Augustin cf0fd65ed4 Deprecated TEMPLATE_LOADERS. 2014-12-28 17:02:30 +01:00
Collin Anderson 0821b3d53c Clarified custom header instructions in tutorial 2. 2014-12-26 18:28:47 -05:00
Brian Scoles a6f0b6a98f Fixed typo in docs/intro/tutorial01.txt. 2014-12-25 06:56:23 -05:00
Claude Paroz 0a4b04fc23 Used https for most *.python.org links 2014-12-19 18:07:52 +01:00
Claude Paroz 742fba9455 Used the 🎫 syntax more extensively 2014-12-19 18:07:52 +01:00
Berker Peksag 560b4207b1 Removed redundant numbered parameters from str.format().
Since Python 2.7 and 3.1, "{0} {1}" is equivalent to "{} {}".
2014-12-03 14:27:38 -05:00
Tim Graham 1dbdc03382 Fixed #23907 -- Added admin.site.register in tutorial 2 for consistency. 2014-11-24 15:58:56 -05:00
Tim Graham 8fce797830 Fixed #23855 -- Removed unnecessary all() in tutorial 3. 2014-11-17 18:10:50 +01:00
Tim Graham 3a550bb6d3 Fixed #23588 -- Added a link in tutorial for list_display options. 2014-11-13 20:15:45 +01:00
Tim Graham dc241fdfdf Replaced dead links to python-distribute.org. 2014-10-24 18:58:31 -04:00
Tim Graham e949f4435f Fixed #23587 -- Clarified admin template overriding in tutorial 2.
Thanks Petrus van Bork for the report.
2014-10-08 08:19:11 -04:00
Corey Farwell 37b13033c6 Removed sudo from pip commands in docs. 2014-09-22 15:49:48 -04:00
velis74 24aa85cea9 Fixed #23535 -- Updated tutorial to account for default filter added in 5ea34f3f86. 2014-09-22 15:22:25 -04:00
Tim Graham 54fd84e432 Fixed #23491 -- Clarified tutorial 3.
Thanks diek for the suggestion.
2014-09-17 08:37:27 -04:00
Tim Graham 0d1561d197 Fixed #23486 -- Corrected makemigrations output in tutorial 1.
Thanks nmarler for the report.
2014-09-15 20:27:52 -04:00
Aymeric Augustin 9562ffea97 Avoid the word "stupid".
There's always a better word.
2014-09-09 20:55:57 +02:00
Tim Graham 88c4e01d34 Fixed #23438 -- Added snippet & imports to docs/intro/overview.txt. 2014-09-06 07:31:36 -04:00
Tim Graham 62939aba99 Removed an admonition in the tutorial about the old project layout.
There are no supported versions that use the old layout (<=1.3).
2014-09-05 14:43:33 -04:00
Tim Graham 035f2e699c Fixed #23362 -- Clarified "database columns as attributes" in tutorial. 2014-08-26 10:00:33 -04:00
areski 9d6551204e Removed unnecessary code-block directives. 2014-08-19 16:44:25 -04:00
Baptiste Mispelon 5853c87a45 Fixed #23303 -- Added BEGIN and COMMIT statements to the output of sqlmigrate. 2014-08-18 18:55:12 +02:00
Tim Graham a9fd740d22 Fixed #23276 -- Deprecated passing views as strings to url(). 2014-08-12 13:15:40 -04:00
Tim Graham 21d0ceefb5 Updated links for continous integration server. 2014-08-05 07:28:04 -04:00
Collin Anderson e075d2e66b Fixed #23148 -- Minor tweaks in tutorial code samples 2014-08-02 10:17:45 +02:00
Christoph Heer d47409831f Fixed #23067 -- Updated docs to use django-admin 2014-07-30 14:14:03 -04:00
Rikki 731f313d60 Added warning in tutorial 4 that the regex capture group name has changed. 2014-07-22 14:00:22 -04:00
Dean Silfen b8d255071e Edited setup.py in reuseable apps tutorial to use a context manager for open(). 2014-07-16 14:21:27 -04:00
Claude Paroz 232f2028d5 Included irc link in paragraph to allow for l10n
Translators may want to change the irc link pointing to a
language-specific channel.
2014-07-01 21:54:32 +02:00
Tim Graham 1e8411259f Fixed #22912 -- Warned about a common mistake in tutorial 5. 2014-06-27 09:51:21 -04:00
Tim Graham 1bbffe7867 Fixed #22888 -- Removed some unnecessary text in tutorial 3. 2014-06-23 09:10:44 -04:00
Maxime Turcotte 608aa8d101 Fixed #22836 -- Linked tutorial05 to the right section of tutorial04. 2014-06-20 08:14:17 -04:00
Collin Anderson a8fa96796f Tutorial: Consistent url syntax 2014-06-17 12:23:26 -04:00
vagrant 7a1f8414c3 Fixed #22842 2014-06-15 10:44:33 +00:00
Maxime Turcotte f97c53c098 Fixed #22801 -- Added 'www.' to diveintopython.net links 2014-06-10 15:38:25 -04:00
Tim Graham 93d05536fd Fixed #22770 -- Removed create_superuser from post_migrate signals.
Moved logic to syncdb command for backwards compatibility.
2014-06-10 14:37:37 -04:00
Tom 6923fdbbf1 Reordered tutorial 1 so that the database is configured first.
This change is required after the introduction of
SessionAuthenticationMiddleware to the default middleware
2014-05-05 13:34:46 -04:00
Brenda J. Butler c8d257e81d Fixed #22558 -- Added missing word in contributing docs 2014-05-02 08:28:07 +02:00
Tim Graham b0d032f9fc Fixed #22547 -- Added some links to tutorial 2.
Thanks bjb at sourcer.ca for the suggestion.
2014-04-30 18:22:43 -04:00
Moayad Mardini 927245ccd8 Fixed #22546 -- Removed idioms in tutorial 2.
Thanks bjb at sourcerer.ca for the suggestion.
2014-04-30 18:01:35 -04:00
Claude Paroz 680a0f08b1 Updated doc links to point to Python 3 documentation 2014-04-26 16:02:53 +02:00
Tim Graham 6b2ce38c49 Fixed #22472 -- Clarified meaning of dots in tutorial 4 code block. 2014-04-18 12:10:46 -04:00
chriscauley 66ec9ee441 Fixed #22378 -- Updated \d to [0-9]+ in urlpatterns of docs and tests.
Thanks tomwys for the suggestion.
2014-04-16 20:36:29 -04:00
Tim Graham eefad142de Fixed #22453 -- Corrected DoesNotExist message in docs.
Thanks Eugenio Cano-Manuel.
2014-04-16 08:36:02 -04:00
Tim Graham a1fa6fcabc Added Python 3.4 to list of supported version in docs/intro/install.txt 2014-04-08 11:13:05 -04:00
Tim Graham d73d0e071c Fixed #22218 -- Deprecated django.conf.urls.patterns.
Thanks Carl Meyer for the suggestion and Alex Gaynor and Carl for reviews.
2014-04-03 07:28:10 -04:00
Jeremy Dunck 0e52b2863b Substituted 'shortcut function' for 'factory method' in tutorial
Many newbies don't know what a factory method is, nor is it pertinent to the
information the tutorial hopes to convey.
2014-03-09 14:07:39 -07:00
Baptiste Mispelon ea4da8e63c Fixed some typos in the documentation.
Thanks to Rodolfo Carvalho and Piotr Kasprzyk
for the patch.
2014-03-02 17:05:57 +01:00
Tim Graham 1f5f015c32 Fixed spelling mistakes in docs. 2014-02-28 21:03:46 -05:00
Greg Chapple 2f25cdc18a Fixed #22129 -- Added steps for creating superusers to tutorial. 2014-02-28 08:10:07 -05:00
Szczepan Cieślik e816198034 Fixed docs typos. 2014-02-25 10:28:32 -05:00
Zbigniew Siciarz 74d4d58b62 Fixed #21939 -- Deprecated loading ssi/url tags from future. 2014-02-16 13:25:21 +01:00
Alasdair Nicol f3805f5c52 Added missing snippet to show filename in docs 2014-02-14 12:45:35 +00:00
Alasdair Nicol 8aa1efff6d Fixed #21951 -- Updated docs to use __str__ for Python 3
Thanks Tim Graham for the report and recommendations
2014-02-13 07:12:40 -05:00
Aymeric Augustin 2ff93e027c Fixed #21829 -- Added default AppConfigs.
Thanks Russell for the report, Marc for the initial patch, Carl for the
final review, and everyone who contributed to the design discussion.
2014-01-25 10:41:56 +01:00
Russell Keith-Magee d818e0c9b2 Fixed #16905 -- Added extensible checks (nee validation) framework
This is the result of Christopher Medrela's 2013 Summer of Code project.

Thanks also to Preston Holmes, Tim Graham, Anssi Kääriäinen, Florian
Apolloner, and Alex Gaynor for review notes along the way.

Also: Fixes #8579, fixes #3055, fixes #19844.
2014-01-20 10:45:21 +08:00
Aymeric Augustin 10e0cfc0e4 Fixed #21712 -- Moved autodiscover() to AdminConfig.ready().
Thanks Marc Tamlyn for the initial version of the patch.
2014-01-18 23:06:00 +01:00
Tianyi Wang e6800ea136 Fixed #21728 -- Corrected an inadvertent path change in docs/intro/contributing.txt. 2014-01-03 11:59:15 -05:00
Tim Graham 9953e98e6a Fixed #21701 -- Improved testing doc titles and added testing/tools.txt.
Thanks cjerdonek for the suggestion.
2013-12-31 08:14:09 -05:00
Tim Graham ec020cab7e Fixed a broken link in docs/intro/tutorial01.txt. 2013-12-30 17:59:18 -05:00
Aymeric Augustin 80d74097b4 Stopped populating the app registry as a side effect.
Since it triggers imports, it shouldn't be done lightly.

This commit adds a public API for doing it explicitly, django.setup(),
and does it automatically when using manage.py and wsgi.py.
2013-12-30 22:11:17 +01:00
Aymeric Augustin 99649ddcb2 Assumed Python 3 throughout docs/intro.
Various small fixes while I was proof-reading.
2013-12-30 19:09:45 +01:00
Yaroslav Halchenko 80027d2c38 Unified listing of shell commands/code
- use code-block:: bash
- prefix the command with $
2013-12-25 15:19:14 -05:00
Aymeric Augustin 9b8192ce51 Updated a few doc paragraphs following the app-loading refactor. 2013-12-24 17:20:11 +01:00
Tim Graham cc2d960274 Fixed #21613 -- Removed a hardcoded input id from the tutorial.
Thanks Bruno Brouard for the report.
2013-12-18 18:36:01 -05:00
Chris Jerdonek e1cfc4b96a Fixed link text for "Testing in Django" in tutorial 5. 2013-12-14 10:41:26 -05:00
Claude Paroz 626bdf648a Updated a bunch of hyperlinks in documentation 2013-12-08 18:40:09 +01:00
Alasdair Nicol 317fd13c7a Fixed #21562 -- Warned against using the same app name as a django contrib app.
Thanks yourcelf for the report.
2013-12-05 19:09:45 -05:00
Andrew Godwin 0b3c8fc851 Update tutorial part 1 to discuss migrations properly 2013-11-27 16:29:49 +00:00
Loic Bistuer 27f04e79b1 Fixed #21479 -- Favor 'migrate' over 'syncdb' in the docs. 2013-11-21 15:12:39 +01:00
Dražen Lučanin b5eef8535a Recommended setuptools in the reuseable app tutorial.
setuptools has merged with distribute.
2013-11-19 13:57:17 -05:00
Tim Graham 6c5f5b9a41 Fixed typo in tutorial 2; refs #21418. 2013-11-10 06:10:13 -05:00
Tim Graham af2dc4ebb8 Fixed doc typo. 2013-11-09 10:09:25 -05:00
Vajrasky Kok 10a39debb2 Fixed #21378 -- Updated tutorial02 for how to override admin site header. 2013-11-09 07:18:46 -05:00
Phil Elson 2110b31365 Fixed indentation of example in tutuorial 2. 2013-10-22 08:10:56 -04:00
M Nasimul Haque d07d6ae116 Fixed #20910 -- Added a "snippet" sphinx directive to allow prefixing a filename.
Thanks Marc Tamlyn for the suggestion.
2013-10-14 13:00:57 -04:00
Bouke Haarsma 9b7d38ed5a Fixed #21210 -- Documented when runserver doesn't auto-restart.
Thanks gergely at polonkai.eu for the suggestion.
2013-10-14 10:36:18 -04:00
Max Vizard 13ddf0e002 Fixed #21027 -- Updated tutorial 5 docs to link to management shell command page. 2013-10-14 08:07:44 -04:00
Unai Zalakain 3895d8899d Fixed #21213 -- Added docs for Django's mailing lists.
Added docs/internals/mailing-lists.txt documenting the use of django's
mailing lists. All references across docs changed to point to this page.

The referencing makes use of substitution because there's no way to make
a :ref: link in a non-inline fashion in Sphinx. It also makes use of
rst_epilog Sphinx conf for making this substitutions across all the
docs.
2013-10-04 10:00:36 -04:00
Tim Graham b66a51ad54 Fixed #21195 -- Clarifed usage of template_name in tutorial part 4. 2013-10-01 10:08:36 -04:00
Rogério Yokomizo 1b4b710355 Fixed #21141 -- Update Sphinx URL
Updated Sphinx URL from http://sphinx.pocoo.org/ to http://sphinx-doc.org/.
2013-09-22 14:44:09 -03:00
Tim Graham d1c9802811 Fixed #21116 -- Made usage of manage.py in docs more consistent.
Thanks daniel.quattro at gmail.com for the report.
2013-09-18 10:35:41 -04:00
Aymeric Augustin 5abc43cabf Updated examples in the docs after eade315d. 2013-09-17 10:05:45 +02:00
Tim Graham e4aab1bb8d Fixed #21094 -- Updated reuseable apps tutorial to use pip for installation.
Thanks ylb415 at gmail.com for the suggestion.
2013-09-13 09:29:21 -04:00
Tim Graham 0ac7cc3265 Fixed #21083 - Fixed spelling in tutorial.
Thanks jimmy.kjaersgaard at gmail.com for the report.
2013-09-10 09:54:26 -04:00
Kevin Christopher Henry 9d700322b3 Fixed #19885 -- cleaned up the django.test namespace
* override_settings may now be imported from django.test
* removed Approximate from django.test
* updated documentation for things importable from django.test

Thanks akaariai for the suggestion.
2013-09-09 16:03:13 -04:00
Rodolfo d34b94b00f Fixed #20876 -- Changed Poll model name in tutorial to Question 2013-09-07 13:37:09 -04:00
Tim Graham 112799e9a8 Fixed #20983 -- Updated package classifiers in reuseable apps tutorial.
Thanks Cloudream for the report.
2013-08-28 10:54:13 -04:00
Andrew Godwin b6a957f0ba Merge remote-tracking branch 'core/master' into schema-alteration
Conflicts:
	docs/ref/django-admin.txt
2013-08-19 18:30:48 +01:00
Tim Graham 55339a7669 Fixed #20891 -- Removed part of the tutorial that requires pytz
Thanks AtomicSpark for the report.
2013-08-15 15:24:58 -04:00
Tim Graham 29255fcb4f Fixed some ReST errors regarding backticks 2013-08-15 07:14:10 -04:00
Andrew Godwin de64c4d6e9 Merge remote-tracking branch 'core/master' into schema-alteration
Conflicts:
	django/core/management/commands/flush.py
	django/core/management/commands/syncdb.py
	django/db/models/loading.py
	docs/internals/deprecation.txt
	docs/ref/django-admin.txt
	docs/releases/1.7.txt
2013-08-09 14:17:30 +01:00
Dominic Rodger c33d1ca1d9 Fixed #20852 - Fixed incorrectly generated left quotes in docs.
Sphinx generates left single quotes for apostrophes after
code markup, when right single quotes are required. The
easiest way to fix this is just by inserting the unicode
character for a right single quote.

Instances of the problem were found by looking for
">&#8216;" in the generated HTML.
2013-08-06 07:13:17 -04:00
Tim Graham b278f7478d Fixed #20858 -- Removed erroneous import in tutorial 2.
Thanks AtomicSpark.
2013-08-04 05:57:11 -04:00
Tim Graham 31ee120787 Fixed #20667 - Removed discussion of DEBUG from tutorial.
Forward-port of 3493f18d78 from master.
2013-08-01 18:07:59 -04:00
Andrew Godwin f8297f6323 More migration docs, and conversion of all easy syncdb references 2013-07-25 16:19:36 +01:00
Tim Graham fd95dc9e27 Fixed #20763 -- Typo in tutorial 3.
Thanks crichard@ for the report.
2013-07-18 07:58:51 -04:00
Tim Graham 2456ffa42c Fixed #20746 -- Removed Python 2.6 specific code/docs 2013-07-14 13:02:55 -04:00
SusanTan ef3fddf26e Fixed #18261 -- Clarified 'project root directory' 2013-07-09 07:11:41 -04:00
Claude Paroz 7442eb1a24 Fixed #20224 -- Update docs examples which mention __unicode__
Thanks Marc Tamlyn and Tim Graham for the review.
2013-07-05 19:27:07 +02:00
Aymeric Augustin a763915a03 Bumped minimum Python version requirement to 2.7 in Django 1.7. 2013-07-01 12:01:59 +02:00
Aymeric Augustin 3fd8eb1a27 Stopped branding Python 3 support as experimental.
Forward-port of 0de21a6 from stable/1.6.x.
2013-07-01 11:52:37 +02:00
Baptiste Mispelon 5caced89e0 Fixed missing slash in reusable apps tutorial. 2013-06-28 09:43:14 +02:00
Tim Graham 6ef199a08e Fixed error in last commit. Thanks Simon Charette. 2013-06-20 10:41:29 -04:00
Harm Geerts df4a74d709 Modified tutorial 3 to use RequestContext in place of Context. 2013-06-20 09:58:01 -04:00
Tim Graham 4e94c84e50 Fixed #19875 - Added warnings regarding DEBUG=False and empty ALLOWED_HOSTS 2013-06-09 15:05:15 -04:00
Tim Graham 9e65bd33db Fixed #20482 - Added a file reference in tutorial 3.
Thanks diek@ for the suggestion.
2013-05-23 08:36:53 -04:00
Tim Graham bdde7feb26 Added some links in /docs/intro/overview.txt
Thanks Claes Ström for the patch.
2013-05-19 12:06:35 -04:00
Marc Tamlyn 33c361ef9d Merge pull request #1129 from frog32/master
Add needed Imports to the Documentation
2013-05-19 01:37:25 -07:00
Ramiro Morales 0a50311063 Fixed #20004 -- Moved non DB-related assertions to SimpleTestCase.
Thanks zalew for the suggestion and work on a patch.

Also updated, tweaked and fixed testing documentation.
2013-05-18 19:04:34 -03:00
leandrafinger ddd9ee16fa Add missing imports to the examples in the 'First Steps' 2013-05-18 18:39:21 +02:00
Tim Graham 679a2ac843 Fixed #20249 - Removed a "feature" in the tutorial that doesn't actually work.
Thanks bmispelon for the report and draft patch.
2013-05-11 19:08:57 -04:00
Carl Meyer 9012833af8 Fixed #17365, #17366, #18727 -- Switched to discovery test runner.
Thanks to Preston Timmons for the bulk of the work on the patch, especially
updating Django's own test suite to comply with the requirements of the new
runner. Thanks also to Jannis Leidel and Mahdi Yusuf for earlier work on the
patch and the discovery runner.

Refs #11077, #17032, and #18670.
2013-05-10 23:08:45 -04:00
Carl Meyer bc46f67fa8 Fixed Sphinx error in tutorial 1. 2013-05-07 18:18:42 -06:00
Carl Meyer 6c6c67f5a6 Fixed inconsistent punctuation in tutorial 5. 2013-05-07 17:07:29 -06:00
Tim Graham bc02a963db Fixed #20177 - Corrected docs for django.test.utils.setup_test_environment.
Thanks vlad.london.uk@ for the report.
2013-05-06 13:55:02 -04:00
Tim Graham 86d3079d57 Fixed #20305 - Added include for polls/static to MANIFEST.in in tutorial.
Thanks monuszko for the report.
2013-05-06 06:19:52 -04:00
Aymeric Augustin 1267d2d9bc Fixed #20330 -- Normalized spelling of "web server".
Thanks Baptiste Mispelon for the report.
2013-04-29 19:40:43 +02:00
Aymeric Augustin f7f69cf7dd Pointed to the docs version switcher in tutorial 1.
Refs #20324. Thanks dwisehart for the suggestion.
2013-04-28 15:10:59 +02:00
Jannis Leidel db394e6ab2 Fixed a rST bug in the README template in the reusable apps docs. 2013-04-24 09:41:06 +02:00
Jannis Leidel 949b4e9458 Fixed the reusable apps docs to use a rst file extension for the README and follow PEP8 a bit more. 2013-04-24 09:27:03 +02:00
Thomas Thurman f17aa998be Fixed #20307 -- Word repeated in tutorial.
Replaced "the the" in the tutorial with "the".
2013-04-23 23:12:47 -04:00
Claude Paroz 7cc3acbb70 Fixed #19211 -- Adapted tutorial for Python 3 2013-04-22 19:51:42 +02:00
jktravis 70d3adf9f2 Added 'polls' sub directory under static and reorganized to more accurately represent the project; compared using 'tree' command. 2013-04-21 09:52:02 -04:00
Juan Catalano 78c842a323 Adapted uses of versionchanged/versionadded to the new form.
Refs #20104.
2013-04-20 17:18:35 +02:00
Claude Paroz 3be8165b62 Updated tutorial INSTALLED_APPS section (removed contrib.sites) 2013-04-20 11:34:35 +02:00
Tim Graham aad5661c6c Fixed #20247 - Added some missing paths in the tutorial.
Thanks gsavix for the suggestion and patch.
2013-04-12 19:22:02 -04:00
Claude Paroz 2bcbca3451 Updated some 'Dive Into Python' links 2013-04-01 14:04:41 +02:00
Tim Graham 6c730da1f6 Fixed #19897 - Updated static files howto.
Thanks Jan Murre, Reinout van Rees and Wim Feijen,
plus Remco Wendt for reviewing.
2013-03-29 19:15:19 -04:00
Tim Graham c32fc79aa1 Fixed #19582 - Added a static files tutorial.
Thanks James Pic.
2013-03-29 19:03:53 -04:00
Christos Kontas 15f12d4181 Fix minor typo in tutorial 2013-03-23 09:55:24 +02:00
Tim Graham 93cffc3b37 Added missing markup to docs. 2013-03-22 13:50:07 -04:00
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
Tim Graham 00d5e632fa Fixed #18630 -- Updated version in docs/intro/install.txt; thanks Kevin London. 2012-07-28 13:17:33 -04:00
Preston Holmes 18b9dc4154 Fixed #18601 -- Specified that Python minimum version is 2.6.5
This is due to a bug in previous Python 2.6 versions related to
unicode keyword arguments.
2012-07-13 17:33:13 +02:00
Claude Paroz 4c417cc9eb Fixed #18576 -- Added missing import in tutorial02
Thanks jaaruiz at yahoo.com for the report.
2012-07-06 13:58:49 +02:00
Tim Graham c68f4c514c Fixed #18493 - Added instructions to locate the Django source files to the t
Thanks Claude Paroz for the draft patch.
2012-07-01 06:55:46 -04:00
Tim Graham c5fb8299ef Fixed #17705 - Updated TabularInline image and doc in tutorial 2.
Thanks xbito for the draft patch.
2012-06-30 18:20:34 -04:00
Claude Paroz c446bdee84 Fixed #17024 -- Added import statements in tutorial code sample 2012-06-30 20:52:49 +02:00
Claude Paroz 8a5d1a6b93 Updated obsolete links in the documentation 2012-06-28 10:49:07 +02:00
Jannis Leidel c4c7fbcc0d Fixed #18451 -- Vastly improved class based view documentation.
Many thanks to Daniel Greenfeld, James Aylett, Marc Tamlyn, Simon Williams, Danilo Bargen and Luke Plant for their work on this.
2012-06-11 10:40:23 +02:00
Aymeric Augustin 6a66fc08b3 Fixed #17933 -- Added a missing label to the docs. 2012-06-07 19:47:32 +02:00
Aymeric Augustin 29a80354ab Added alt attribute to img tags in docs.
This is a good practice for accessibility.
Thanks Jessica McKellar for the report.
2012-06-06 10:32:03 +02:00
Claude Paroz 45284a90a5 Fixed #17929 -- Improved tutorial wording and capitalization.
Thanks rmattb for the report and the patch.
2012-05-25 21:49:47 +02:00