docs: add master SVG for libvirt logo

Add the SVG files for the libvirt logo, along with corresponding
pre-rendered PNG bitmaps at key sizes. Also add a README file
describing how to modify the logos and their intended usages.
Signed-off-by: NDaniel P. Berrange <berrange@redhat.com>

docs/Makefile.am

@@ -64,6 +64,25 @@ devhelpcss = devhelp/style.css
 
 devhelpxsl = devhelp/devhelp.xsl devhelp/html.xsl
 
+logofiles = \
+  logos/logo-base.svg \
+  logos/logo-square.svg \
+  logos/logo-square-powered.svg \
+  logos/logo-banner-dark.svg \
+  logos/logo-banner-light.svg \
+  logos/logo-square-96.png \
+  logos/logo-square-128.png \
+  logos/logo-square-192.png \
+  logos/logo-square-256.png \
+  logos/logo-square-powered-96.png \
+  logos/logo-square-powered-128.png \
+  logos/logo-square-powered-192.png \
+  logos/logo-square-powered-256.png \
+  logos/logo-banner-dark-256.png \
+  logos/logo-banner-dark-800.png \
+  logos/logo-banner-light-256.png \
+  logos/logo-banner-light-800.png
+
 png = \
   32favicon.png \
   libvirt-header-bg.png \
@@ -154,7 +173,7 @@ EXTRA_DIST=					\
   $(dot_html) $(dot_html_in) $(gif) $(apihtml) $(apipng) \
   $(devhelphtml) $(devhelppng) $(devhelpcss) $(devhelpxsl) \
   $(xml) $(qemu_xml) $(lxc_xml) $(admin_xml) $(fig) $(png) $(css) \
-  $(patches) $(dot_php_in) $(dot_php_code_in) $(dot_php)\
+  $(logofiles) $(patches) $(dot_php_in) $(dot_php_code_in) $(dot_php)\
   $(internals_html_in) $(internals_html) \
   sitemap.html.in aclperms.htmlinc \
   todo.pl hvsupport.pl todo.cfg-example \
@@ -347,6 +366,9 @@ install-data-local:
 	$(mkinstalldirs) $(DESTDIR)$(HTML_DIR)
 	for f in $(css) $(dot_html) $(gif) $(png); do \
 	  $(INSTALL) -m 0644 $(srcdir)/$$f $(DESTDIR)$(HTML_DIR); done
+	$(mkinstalldirs) $(DESTDIR)$(HTML_DIR)/logos
+	for f in $(logofiles); do \
+	  $(INSTALL) -m 0644 $(srcdir)/$$f $(DESTDIR)$(HTML_DIR)/logos; done
 	$(mkinstalldirs) $(DESTDIR)$(HTML_DIR)/html
 	for h in $(apihtml); do \
 	  $(INSTALL) -m 0644 $(srcdir)/$$h $(DESTDIR)$(HTML_DIR)/html; done
@@ -365,6 +387,9 @@ uninstall-local:
 	for f in $(css) $(dot_html) $(gif) $(png); do \
 	  rm -f $(DESTDIR)$(HTML_DIR)/$$f; \
 	done
+	for f in $(logofiles); do \
+	  rm -f $(DESTDIR)$(HTML_DIR)/$$f; \
+	done
 	for h in $(apihtml); do rm -f $(DESTDIR)$(HTML_DIR)/$$h; done
 	for p in $(apipng); do rm -f $(DESTDIR)$(HTML_DIR)/$$p; done
 	for f in $(internals_html); do \

docs/logos/README

+       Libvirt Logo README
+       ===================
+
+The master SVG files were created in InkScape, using the Overpass font from Red
+Hat:
+
+   http://overpassfont.org/
+
+
+Logo formats
+============
+
+The following SVG files are provided, along with standard bitmap sizes in PNG
+format:
+
+ - logo-base.svg
+
+   The basic "sardine tin" graphic used to create the other forms of the
+   libvirt logo.
+
+   The tin is rotated by 20 degrees, so its angle matches the angle of the left
+   side of the letter "v" in the Overpass font
+
+   Never use this logo file directly. It exists merely as a base for building
+   the other logos
+
+
+ - logo-square.svg
+
+   The minimal square format logo for libvirt. Simply embeds the word "libvirt"
+   into the basic logo graphic.
+
+   This is intended for use where a compact, square format representation of
+   the logo is required.
+
+   Bitmap sizes: 64, 128, 192, 256 px square
+
+
+ - logo-square-powered.svg
+
+   A variant of the square logo for use by 3rd party applications, to advertize
+   their use of libvirt.
+
+   Bitmap sizes: 64, 128, 192, 256 px square
+
+
+ - logo-banner-light.svg
+
+   A wide banner format of the logo. Embeds the words "libvirt virtualization
+   API" into the basic logo graphic. The text is rendered in a light color, so
+   suitable for placement over a dark background.
+
+   Bitmap sizes: 257x92, 800x286 px
+
+
+ - logo-banner-dark.svg
+
+   A wide banner format of the logo. Embeds the words "libvirt virtualization
+   API" into the basic logo graphic. The text is rendered in a dark color, so
+   suitable for placement over a light background.
+
+   Bitmap sizes: 257x92, 800x286 px
+
+
+PNG file creation
+=================
+
+The bitmap images should not be created in Inkscape, since its anti-aliasing of
+the rendered bitmaps is too aggressive, resulting in fuzzy images. Instead the
+GIMP is used to create bitmaps as follows:
+
+ - File -> Open, select the SVG file
+
+   When prompted for the image size, enter 1024 as the width and allow height
+   to be auto-set based on aspect ratio
+
+ - Image -> Scale Image
+
+   Enter desired final bitmap size and use "Cubic" as scaling method.
+
+ - File -> Export As
+
+
+It is important to let GIMP render initially at 1024 and then scale down, rather
+than rendering directly at the target size, since this the manual scaling step
+produces better quality