[svnbook] r4441 committed - * en/HACKING...

[svnbook at googlecode.com]

Revision: 4441
Author:   cmpilato at gmail.com
Date:     Sat Feb 16 18:26:58 2013
Log:      * en/HACKING
   Get specific about image creation.

http://code.google.com/p/svnbook/source/detail?r=4441

Modified:
  /trunk/en/HACKING

=======================================
--- /trunk/en/HACKING	Thu Feb 14 16:54:50 2013
+++ /trunk/en/HACKING	Sat Feb 16 18:26:58 2013
@@ -254,18 +254,29 @@

       [...]

-- Graphics:  We use PNG for our graphic format at this time (because it
-  offers maximum tool coverage).  Image files should be rendered at
-  the desired HTML display dimensions.  Use the 'width' and 'depth'
-  attributes of the <graphic> tag to specify the desired width and
-  height in inches for use with the FO-based output flavors.  (The
-  HTML output flavors will ignore these dimensions.)
+- Graphics:
+
+  We use OpenOffice.org Draw for the source material of our graphics,
+  and PNG for our embedded graphic format at this time (because it
+  offers maximum tool coverage).  Create drawings in OOo at the size
+  that they will be rendered in the FO output formats (PDF, PS).
+
+    - Use FreeSans for type.
+    - Use 0.03" shadows, and 0.00" lines and connectors.
+
+  Export the final drawing to PNG at 120 ppi.
+
+  When referencing images in the DocBook sources, use the 'width' and
+  'depth' attributes of the <graphic> tag to specify the desired width
+  and height in inches for use with the FO-based output flavors.
+  These should match the dimensions of the original source file.

    Example:

        <figure id="svn.intro.architecture.dia-1">
          <title>Subversion's architecture</title>
-        <graphic width="4in" depth="5in"  
fileref="images/svn-arch-diagram.png"/>
+        <graphic width="5in" depth="6.25in"
+                 fileref="images/svn-arch-diagram.png" />
        </figure>