QFQ now recommends ImageMagick instead of GraphicsMagic, due to much better...

QFQ now recommends ImageMagick instead of GraphicsMagic, due to much better 'convert' quality by converting 'svg' images.

extension/Documentation/Manual.rst

@@ -64,7 +64,7 @@ Preparation for Ubuntu 14.04::
 
 	sudo apt-get install php5-mysqlnd php5-intl
 	sudo apt-get install pdftk file                  # for file upload and PDF
-	sudo apt-get install inkscape graphicsmagick     # to render thumbnails
+	sudo apt-get install inkscape imagemagick     # to render thumbnails
 	sudo php5enmod mysqlnd
 	sudo service apache2 restart
 
@@ -161,7 +161,7 @@ The Typo3 sendmail eco-system is not used at all by QFQ.
 Thumbnail
 ^^^^^^^^^
 
-Thumbnails will be rendered via GraphicsMagick (http://www.graphicsmagick.org/) 'convert' and 'inkscape' (https://inkscape.org).
+Thumbnails will be rendered via ImageMagick (https://www.imagemagick.org/) 'convert' and 'inkscape' (https://inkscape.org).
 'inkscape' is only used for '.svg' files.
 
 The Typo3 graphic eco-system is not used at all by QFQ.
@@ -6130,14 +6130,17 @@ Examples: ::
 Column: _thumbnail
 ^^^^^^^^^^^^^^^^^^
 
-A thumbnail of the file `T:<pathFilename>` will be rendered and saved with the given pixel size as specified via
-`W:<dimension>`. The file is only rendered once and subsequent access is delivered via a local cache. The will be
-rendered again, if the source file is newer than the thumbnail or if the thumbnail dimension changes.
+For file `T:<pathFilename>` a thumbnail will be rendered, saved (to be reused) and a HTML `<img>` tag is returned,
+With the SIP encoded thumbnail.
 
-The thumbnail pathFilename is a MD5 hash of the pathFilename plus the dimension information.
+The thumbnail:
 
-From multi page files like PDFs, the first page is used as the thumbnail.
-All file formats, which GraphicsMagick 'convert' (http://www.graphicsmagick.org/formats.html) supports, can be
+* Size is specified via `W:<dimension>`. The file is only rendered once and subsequent access is delivered via a local QFQ cache.
+* Will be rendered, if the source file is newer than the thumbnail or if the thumbnail dimension changes.
+* The caching is done by building the MD5 of pathFilename and thumbnail dimension.
+* Of multi page files like PDFs, the first page is used as the thumbnail.
+
+All file formats, which 'convert' ImageMagick (https://www.imagemagick.org/) supports, can be
 used. Office file formats are not supported. Due to speed and quality reasons, SVG files will be converted by inkscape.
 If a file format is not known, QFQ tries to show a corresponding file type image provided by Typo3 - such an image is not
 scaled.
@@ -6169,7 +6172,7 @@ Example: ::
 	10.sql = SELECT 'T:fileadmin/file3.pdf' AS _thumbnail
 
 	# SIP protected, IMG tag, thumbnail width 50px
-	20.sql = SELECT 'T:fileadmin/file3.pdf|W:50x' AS _thumbnail
+	20.sql = SELECT 'T:fileadmin/file3.pdf|W:50' AS _thumbnail
 
 	# No SIP protection, IMG tag, thumbnail width 150px
 	30.sql = SELECT 'T:fileadmin/file3.pdf|s:0' AS _thumbnail
@@ -6181,7 +6184,8 @@ Example: ::
 Dimension
 '''''''''
 
-GraphicsMagick support various settings to force the thumbnail size. See http://www.graphicsmagick.org/GraphicsMagick.html#details-geometry.
+ImageMagick support various settings to force the thumbnail size.
+See https://www.imagemagick.org/script/command-line-processing.php#geometry or http://www.graphicsmagick.org/GraphicsMagick.html#details-geometry.
 
 Cleaning
 ''''''''