Man Linux: Main Page and Category List

NAME

       wml::std::logo - Logo Insertion

SYNOPSIS

        #use wml::std::logo

        <logo [attributes]>

DESCRIPTION

       This include file provides the "<logo>" tag to insert logo images.  The
       logo is selected via attribute "name". The following logos are
       available:

         Name      Inserted Hint                  Inserted URL
         --------  ------------------------------ ----------------------------
         apache    Apache Webserver Project       http://www.apache.org/
         freebsd   FreeBSD Operating System       http://www.freebsd.org/
         gimp      GNU Image Manipulation Program http://www.gimp.org/
         htdig     Internet search engine         http://www.htdig.org/
         linux     Linux Operating System         http://www.linux.org/
         netbsd    NetBSD Operating System        http://www.netbsd.org/
         openbsd   OpenBSD Operating System       http://www.openbsd.org/
         php       PHP Hypertext Preprocessor     http://www.php.net/
         vim       Vi Improved Editor             http://www.vim.org/
         wml       Website META Language          http://www.engelschall.com/sw/wml/
         xemacs    XEmacs Editor                  http://www.xemacs.org/

ATTRIBUTES

       "name"
           The "name" attribute selects which logo is wanted. The table above
           lists valid names, and wml is used by default.

       "base"
           Usually the logos are copied into logo-xxxxxx.png where "xxxxxx" is
           the name of the logo.  When you use a "base=foo" attribute, then
           the resulting files are named foo.logo-xxxxxx.png.  Actually you
           can even use a complete filename including a directory prefix, i.e.
           when you use "base=../../common/foo" attribute, then the images are
           created as ../../common/foo.logo-xxxxxx.png.

           And for most flexibility when no base is specified and the variable
           "LOGO_BASE" is defined (usually from within a .wmlrc file via
           "-LOGO_BASE~path/to/logo/dir/base") it is used.  Use this feature
           to copy the logos to a particular directory.

           You may also use the variable "IMAGE_BASE" which defines in a
           single line all base names for images generated by WML.

       "format"
           Logos are available in PNG or GIF formats. This attribute is the
           filename extension of the desired format, i.e. respectively "png"
           and "gif".  Default is "png" extension ; this default can be
           changed via the "IMAGE_FORMAT" variable.

       "file"
           This attribute defines the logo filename. It overrides all other
           computed values.

       "target"
           If the "target" attribute is used, it refers to a target frame or
           window where the hyperlink is redirected to.

       "notag"
           This forces "<logo>" to expand to nothing, i.e. no resulting
           "<img>" tag. The image itself is still generated. In combination
           with the above "file" attribute this can be used to generate images
           to particular files which can be used at other positions, for
           instance inside "<rollover>" (see wml::des::rollover(3)) tags.

EXAMPLE

       This example only copy the vim logo to "$(IMAGES)/logo-vim.png" without
       any output:

        <logo name=vim format=png base="$(IMAGES)/logo" notag>

AUTHORS

        Ralf S. Engelschall
        rse@engelschall.com
        www.engelschall.com

        Denis Barbier
        barbier@engelschall.com

REQUIRES

        Internal: P1, P2, P3
        External: --

HISTORY

        For backward compatibility a logo named "php3" is also available.
        Inluding the version number was not a really good idea, use the
        logo "php" instead. Expect that the logo "php3" will be removed in
        future releases.

SEE ALSO

       wml(1)