installation guide

[Dave Pawson]

On Fri, 2004-08-27 at 23:33, Paul W. Frields wrote:

> 1. PNG format. Is that too obvious?
No Paul, it needs saying!

> 2. No wider than 500 pixels. If your graphic is larger than that, use
> GIMP (Image -> Scale Image) or mogrify to scale the image to no wider
> than 500 pixels.
> 3. Graphics should be included as <figure> I think.
With full alternatives to make it work in html.

       <figure float="0" id="fig1007">
          <title>Block and Inline graphics</title>
        <mediaobject>
        <imageobject>
        <imagedata 
       id="fig10-7" 
       fileref="images/fig10-7.png" 
        format="PNG"/>
        </imageobject>
        <textobject>
        <phrase>Two graphics, one as a block, one as an inline.</phrase>
        </textobject>

          </mediaobject>
        </figure>


> 
> 4. Graphics should not be included unless you absolutely *cannot* get
> along without it. There's no reason to include repetitive screenshots of
> parts of the interface that are easily explained in a sentence.
> (Example: anaconda runs several progress bars when it computes package
> dependencies, writes an install image to the drive, etc.... those don't
> need to be screenshotted. Wait, is that a real word?)

+1 (accessibility)

> 
> -- 
> Paul W. Frields, RHCE
-- 
Regards DaveP.
XSLT&Docbook  FAQ
http://www.dpawson.co.uk/xsl