[Digikam-devel] branches/stable/extragear/graphics/doc/digikam

[Gilles Caulier]

SVN commit 541375 by cgilles:

digikam from stable : optimization of handbook PNG files using pngnq tool.

INCREDIBLE : look the results :

before recompression : 10.978.624 bytes
after recompression : 4.810.770 bytes!

Achim : with next release 0.8.2, a new doc release need to be done (:=)))

CCMAIL: digikam-devel at kde.org, ach at mpe.mpg.de

 M  +14 -7     README  
 M             cameraclient.png  
 M             cameraclientadvanced.png  
 M             cameraclientdownload.png  
 M             cameraclientitemproperties.png  
 M             cameratargetalbumdialog.png  
 M             digikamlogo.png  
 M             editoradjustcurves.png  
 M             editoradjustlevels.png  
 M             editorautolevels.png  
 M             editorautosizebutton.png  
 M             editorbcgadjust.png  
 M             editorblurplugin.png  
 M             editorcolorbalance.png  
 M             editorcommondialogtools.png  
 M             editorconvert_brown.png  
 M             editorconvert_bw.png  
 M             editorconvert_bwgreen.png  
 M             editorconvert_bworange.png  
 M             editorconvert_bwred.png  
 M             editorconvert_bwyellow.png  
 M             editorconvert_cold.png  
 M             editorconvert_original.png  
 M             editorconvert_platinium.png  
 M             editorconvert_selenium.png  
 M             editorconvert_sepia.png  
 M             editorcropbutton.png  
 M             editorequalize.png  
 M             editorexifviewer.png  
 M             editorgoldensectionsexample.png  
 M             editorgoldenspiralexample.png  
 M             editorgoldenspiralsectionsexample.png  
 M             editorgoldentrianglesexample.png  
 M             editorharmonioustrianglesexample.png  
 M             editorhistogramdescription.png  
 M             editorhistogramsample1.png  
 M             editorhistogramsample2.png  
 M             editorhistogramsample3.png  
 M             editorhistogramviewer.png  
 M             editorhsladjust.png  
 M             editorimageselection.png  
 M             editornoisereductionplugin.png  
 M             editornormalize.png  
 M             editorpreview.png  
 M             editorraindropsplugin.png  
 M             editorratiocroptool.png  
 M             editorredeyescorrection.png  
 M             editorresizetool.png  
 M             editorrevertbutton.png  
 M             editorrulethirdlinesexample.png  
 M             editorsharpenplugin.png  
 M             editorstretchcontrast.png  
 M             editortoolbar.png  
 M             editorunsharpedmaskplugin.png  
 M             editorzoombuttons.png  
 M             introductionalbumsmissingdialog.png  
 M             introductionfirewireconnector.png  
 M             introductionfirstrundialog.png  
 M             introductionplugininterfaces.png  
 M             introductionscandialog.png  
 M             introductionserialconnector.png  
 M             introductionusbconnector.png  
 M             maininterfaceadvancedsearch.png  
 M             maininterfaceadvancedsearchoption.png  
 M             maininterfaceadvancedsearchoptiongroup.png  
 M             maininterfacealbumproperties.png  
 M             maininterfaceassigntags.png  
 M             maininterfacecommentstags.png  
 M             maininterfacedateview.png  
 M             maininterfaceimgproperties1.png  
 M             maininterfaceimgproperties2.png  
 M             maininterfaceimgproperties3.png  
 M             maininterfacepreview.png  
 M             maininterfacequicksearch.png  
 M             maininterfacesearchview.png  
 M             maininterfacetagsview.png  
 M             maininterfacetoolbar.png  
 M             setupaddcamera.png  
 M             setupalbum.png  
 M             setupcamera.png  
 M             setupcollections.png  
 M             setupembededinfo.png  
 M             setupimageeditor.png  
 M             setupkipi.png  
 M             setupmimetypes.png  
 M             setupmisc.png  
 M             setupthemeclean.png  
 M             setupthemedark.png  
 M             setupthemedefault.png  
 M             setupthemedreary.png  
 M             setupthememarine.png  
 M             setupthemeorangecrush.png  
 M             setupthemesandy.png  


--- branches/stable/extragear/graphics/doc/digikam/README #541374:541375
@@ -3,10 +3,10 @@
 
 >>> How to Make Screenshot for Manual with Alpha Blending 3D Border <<<
 
-- Never use advanced color theme to make screenshots. Always use KDE default color.
+- Never use advanced color theme to make screenshots. Always use KDE default color and icon set.
 
-- Use KSnapshot for take a shot. Use region selection option for take only 
-  important area. Remove buttons and dialog hearder for limit image file size.
+- Use KSnapshot or Gimp Import to take a shot. Use region selection option to select only
+  important area. Remove buttons and dialog header to limit image file size.
   _ALWAYS use PNG file format to save image.
 
 - Open your screenshot in Gimp 2.0 and make operations below:
@@ -26,11 +26,18 @@
       -> Allow Resizing = On
    * Save target image in PNG with max compression (Compression Level = 9)
    
-Note : A gimp2.2 script from Gerhard Kulzer can be use to add Alpha Blending 3D Border around screenshots. 
+Note : A gimp2.[2,3] script from Gerhard Kulzer can be used to add Alpha Blending 3D Border around screenshots. 
        Always use default settings. Script can be downloaded from this url:
        
-http://digikam3rdparty.free.fr/Tools/printscreen-to-manual.scm
+http://digikam3rdparty.free.fr/Tools/printscreen-v2.2.scm
+http://digikam3rdparty.free.fr/Tools/printscreen-v2.3.scm
+
+!----------Important-------------!
+Since the documentation is very good it is also very demanding in terms of volume, 99% whereof are screenshots. In order to limit the byte count to the minimum the following command chain shall be used to reduce the png file size. A factor of 2-4 can be gained. From within the folder where the png reside issue this command (requires pngnq and optipng to be installed on the system):
+
+pngnq -s 1 ./*.png && optipng *-nq8.png && rename -f s/-nq8\.png/.png/ *-nq8.png
+
+
+Gilles Caulier <caulier dot gilles at free dot fr>
       
-Gilles Caulier <caulier dot gilles at free dot fr>      
-      
             
\ No newline at end of file