From: Dietmar Maurer <dietmar@proxmox.com>
Date: Tue, 8 Nov 2016 07:11:21 +0000 (+0100)
Subject: README.adoc: improve docs about screenshots
X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=commitdiff_plain;h=6a6f83747ec67a47d5ad624d7559a57dd0c8dcf2;hp=0d1b9a161a2277dfc19e61617e8f83f201b4fe79

README.adoc: improve docs about screenshots
---

diff --git a/README.adoc b/README.adoc
index 2970e60..6964087 100644
--- a/README.adoc
+++ b/README.adoc
@@ -256,6 +256,25 @@ screenshot by setting the 'thumbnail' attribute on a paragraph:
 First, it should be noted ...
 ----
 
+The corresponding file need to reside inside folder
+`images/screenshot`, and should be in `.png` image format. We include
+the screenshots in printed documentation, and 'pdftex' uses the
+density (DPI) specified inside the file. So all screenshots should use
+the same density. We currently require the density set to 146 DPI, so
+that we can display a 1024 pixels wide image. You should not include
+larger screenshots (although it is possible).
+
+You can use the `./png-cleanup.pl` script to set the correct
+density. Simply use the following command to import a screenshot
+image:
+
+----
+# ./png-cleanup.pl screenshot.png images/screenshot/screenshot.png
+----
+
+TIP: You can use `identify -verbose screenshot.png` command to show
+all image attributes (from debian package 'imagemagick')
+