From 7dc78d8ef3e62f7e06d7767c63dcede048377b9a Mon Sep 17 00:00:00 2001 From: Joe Conway Date: Sat, 27 Apr 2019 11:12:52 -0400 Subject: [PATCH] Add guidance on making documentation SVG images responsive Recently added guidance on adding SVG images to the documentation sources lacks advice on making the images responsive when rendered in a variety of media types and viewports. Add some. Patch by Jonathan Katz with some editorialization by me. Author: Jonathan Katz Discussion: https://postgr.es/m/6358ae6f-7191-a02b-e7b5-68050636ae71@postgresql.org --- doc/src/sgml/images/README | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/doc/src/sgml/images/README b/doc/src/sgml/images/README index dd29486a09..ade627bda2 100644 --- a/doc/src/sgml/images/README +++ b/doc/src/sgml/images/README @@ -59,3 +59,10 @@ Notes: - The width should be set to something. This ensures that the image is scaled to fit the page in PDF output. (Other widths than 100% might be appropriate.) + +- SVG images should be scalable as they will be rendered in a variety + of places (web, PDF, etc.) as well as in different viewports + (desktop, mobile, etc.). To help the images successfully scale, + employ a "viewBox" attribute in the SVG tag. For example, + to create an image with a default width and height of 400x300, + you would use viewBox="0.00 0.00 400.00 300.00"