From 034ffae60f97921677e7529db40b589d8cb2d542 Mon Sep 17 00:00:00 2001 From: Mikhail Korobov Date: Sun, 18 Aug 2013 00:44:01 +0600 Subject: [PATCH] Recommend Pillow instead of PIL. Closes GH-317. --- docs/topics/images.rst | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/docs/topics/images.rst b/docs/topics/images.rst index abbef96c4..9c1de4dd0 100644 --- a/docs/topics/images.rst +++ b/docs/topics/images.rst @@ -24,10 +24,13 @@ being scheduled for download, and connects those items that arrive containing the same image, to that queue. This avoids downloading the same image more than once when it's shared by several items. -The `Python Imaging Library`_ is used for thumbnailing and normalizing images -to JPEG/RGB format, so you need to install that library in order to use the -images pipeline. +`Pillow`_ is used for thumbnailing and normalizing images to JPEG/RGB format, +so you need to install this library in order to use the images pipeline. +`Python Imaging Library`_ (PIL) should also work in most cases, but it +is known to cause troubles in some setups, so we recommend to use `Pillow`_ +instead of `PIL `_. +.. _Pillow: https://github.com/python-imaging/Pillow .. _Python Imaging Library: http://www.pythonware.com/products/pil/ Using the Images Pipeline @@ -107,7 +110,7 @@ File system storage ------------------- The images are stored in files (one per image), using a `SHA1 hash`_ of their -URLs for the file names. +URLs for the file names. For example, the following image URL:: @@ -167,7 +170,7 @@ When you use this feature, the Images Pipeline will create thumbnails of the each specified size with this format:: /thumbs//.jpg - + Where: * ```` is the one specified in the :setting:`IMAGES_THUMBS`