From 0d57da1861e99f42c13b574d3bb59710074ecbef Mon Sep 17 00:00:00 2001 From: Dietmar Maurer Date: Tue, 8 Nov 2016 09:26:52 +0100 Subject: [PATCH] README.adoc: improve docs about screenshots --- README.adoc | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/README.adoc b/README.adoc index 6964087..5e1c36c 100644 --- a/README.adoc +++ b/README.adoc @@ -275,7 +275,30 @@ image: TIP: You can use `identify -verbose screenshot.png` command to show all image attributes (from debian package 'imagemagick') +.Default Screenshot Layout +[thumbnail="gui-datacenter-search.png"] + +We normally display screenshots as small thumbnail on the right side +of a paraprah. On printed docomentation, we render the full sized +graphic just before the paragraph, or between the title and the text +if the paragraph has a title. It is usually a good idea to add a title +to paragraph with screenshots. + +[thumbnail="gui-datacenter-search.png", float="left"] + +If you need to render many screenshots, it is possible to place them +on the left side, so you can alternate the thumbnail position using the +`float` attribute: + +---- +[thumbnail="gui-datacenter-search.png", float="left"] +If you need to render many screenshots ... +---- + +Please avoid to many consecutive screenshots to avoid rendering +problems. Also verify the printed documentation to see if large +screenshots create layout problems. Copyright -- 2.39.2