diff --git a/docs/howto/initial-data.txt b/docs/howto/initial-data.txt index dd6a099b9d7ff..69e728ef16244 100644 --- a/docs/howto/initial-data.txt +++ b/docs/howto/initial-data.txt @@ -13,6 +13,8 @@ but initial SQL is also quite a bit more flexible. .. _initial data as sql: `providing initial sql data`_ .. _initial data via fixtures: `providing initial data with fixtures`_ +.. _initial-data-via-fixtures: + Providing initial data with fixtures ==================================== @@ -65,12 +67,12 @@ And here's that same fixture as YAML: You'll store this data in a ``fixtures`` directory inside your app. -Loading data is easy: just call :djadmin:`manage.py loaddata fixturename -`, where *fixturename* is the name of the fixture file you've created. -Every time you run :djadmin:`loaddata` the data will be read from the fixture -and re-loaded into the database. Note that this means that if you change one of -the rows created by a fixture and then run :djadmin:`loaddata` again you'll -wipe out any changes you've made. +Loading data is easy: just call :djadmin:`manage.py loaddata +`, where ```` is the name of the fixture file you've +created. Every time you run :djadmin:`loaddata` the data will be read from the +fixture and re-loaded into the database. Note that this means that if you +change one of the rows created by a fixture and then run :djadmin:`loaddata` +again you'll wipe out any changes you've made. Automatically loading initial data fixtures ------------------------------------------- @@ -80,6 +82,17 @@ be loaded every time you run :djadmin:`syncdb`. This is extremely convenient, but be careful: remember that the data will be refreshed *every time* you run :djadmin:`syncdb`. So don't use ``initial_data`` for data you'll want to edit. +Where Django finds fixture files +-------------------------------- + +By default, Django looks in the ``fixtures`` directory inside each app for +fixtures. You can set the :setting:`FIXTURE_DIRS` setting to a list of +additional directories where Django should look. + +When running :djadmin:`manage.py loaddata `, you can also +specify an absolute path to a fixture file, which overrides searching +the usual directories. + .. seealso:: Fixtures are also used by the :ref:`testing framework diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt index 8dc5fdbe0d2db..1685379edf058 100644 --- a/docs/ref/settings.txt +++ b/docs/ref/settings.txt @@ -982,9 +982,12 @@ FIXTURE_DIRS Default: ``()`` (Empty tuple) -List of locations of the fixture data files, in search order. Note that -these paths should use Unix-style forward slashes, even on Windows. See -:doc:`/topics/testing`. +List of directories searched for fixture files, in addition to the +``fixtures`` directory of each application, in search order. + +Note that these paths should use Unix-style forward slashes, even on Windows. + +See :ref:`initial-data-via-fixtures` and :ref:`topics-testing-fixtures`. FORCE_SCRIPT_NAME ------------------ @@ -1746,8 +1749,10 @@ TEMPLATE_DIRS Default: ``()`` (Empty tuple) -List of locations of the template source files, in search order. Note that -these paths should use Unix-style forward slashes, even on Windows. +List of locations of the template source files searched by +:class:`django.template.loaders.filesystem.Loader`, in search order. + +Note that these paths should use Unix-style forward slashes, even on Windows. See :doc:`/topics/templates`.