summaryrefslogtreecommitdiff
path: root/docs/ref/files
diff options
context:
space:
mode:
authorElif T. Kus <elifkus@gmail.com>2016-01-03 12:56:22 +0200
committerTim Graham <timograham@gmail.com>2016-01-22 12:18:24 -0500
commit5dceb1f07807d76f163ce1929e9f1dc1b2da6289 (patch)
tree21057f127c428fd95dc35badefd67560a3d2c100 /docs/ref/files
parent647ce33e86807bcc75977a34871e1ee08230d9a5 (diff)
[1.9.x] Fixed #26020 -- Normalized header stylings in docs.
Backport of bca9faae95db2a92e540fbd08505c134639916fe from master
Diffstat (limited to 'docs/ref/files')
-rw-r--r--docs/ref/files/file.txt9
-rw-r--r--docs/ref/files/storage.txt7
-rw-r--r--docs/ref/files/uploads.txt4
3 files changed, 11 insertions, 9 deletions
diff --git a/docs/ref/files/file.txt b/docs/ref/files/file.txt
index 14efb83fe6..9c3bb59405 100644
--- a/docs/ref/files/file.txt
+++ b/docs/ref/files/file.txt
@@ -1,3 +1,4 @@
+===================
The ``File`` object
===================
@@ -7,7 +8,7 @@ for basic file handling in Django.
.. currentmodule:: django.core.files
The ``File`` Class
-------------------
+==================
.. class:: File(file_object)
@@ -99,7 +100,7 @@ The ``File`` Class
.. currentmodule:: django.core.files.base
The ``ContentFile`` Class
--------------------------
+=========================
.. class:: ContentFile(File)
@@ -116,7 +117,7 @@ The ``ContentFile`` Class
.. currentmodule:: django.core.files.images
The ``ImageFile`` Class
------------------------
+=======================
.. class:: ImageFile(file_object)
@@ -136,7 +137,7 @@ The ``ImageFile`` Class
.. currentmodule:: django.core.files
Additional methods on files attached to objects
------------------------------------------------
+===============================================
Any :class:`File` that is associated with an object (as with ``Car.photo``,
below) will also have a couple of extra methods:
diff --git a/docs/ref/files/storage.txt b/docs/ref/files/storage.txt
index 8dd700484d..fa6ced491d 100644
--- a/docs/ref/files/storage.txt
+++ b/docs/ref/files/storage.txt
@@ -1,10 +1,11 @@
+================
File storage API
================
.. module:: django.core.files.storage
Getting the current storage class
----------------------------------
+=================================
Django provides two convenient ways to access the current storage class:
@@ -27,7 +28,7 @@ Django provides two convenient ways to access the current storage class:
raised if the import is unsuccessful.
The FileSystemStorage Class
----------------------------
+===========================
.. class:: FileSystemStorage(location=None, base_url=None, file_permissions_mode=None, directory_permissions_mode=None)
@@ -62,7 +63,7 @@ The FileSystemStorage Class
an exception if the given file name does not exist.
The Storage Class
------------------
+=================
.. class:: Storage
diff --git a/docs/ref/files/uploads.txt b/docs/ref/files/uploads.txt
index daf2b8e90c..7fd5cecb87 100644
--- a/docs/ref/files/uploads.txt
+++ b/docs/ref/files/uploads.txt
@@ -141,7 +141,7 @@ All file upload handlers should be subclasses of
handlers wherever you wish.
Required methods
-~~~~~~~~~~~~~~~~
+----------------
Custom file upload handlers **must** define the following methods:
@@ -175,7 +175,7 @@ Custom file upload handlers **must** define the following methods:
the ``UploadedFile`` object should come from subsequent upload handlers.
Optional methods
-~~~~~~~~~~~~~~~~
+----------------
Custom upload handlers may also define any of the following optional methods or
attributes: