WebMake: Documentation: download_tag.wmk

WebMake Documentation (version 1.2) | [ Back | Forward | Index | All In One ]

# download_tag.wmk LOADING HTML TAGS DESCRIPTION OPTIONS WHICH AFFECT THIS TAG # LOADING
      < use plugin="download_tag" />
# HTML TAGS
      < download file="filename.dat" [text="template"] />
  # DESCRIPTION This WebMake Perl library provides a quick shortcut to make links to files for download. The attributes supported are as follows: file="filename.dat" The filename to link to. If a file by this filename does not exist, a warning will be printed. Filenames should be specified relative to one of the following: the top level of the site the output file which contains the tag (not recommended, as it precludes the tag being used in another output file in a different directory) a directory named in the FileSearchPath WebMake option text="template" The link text to be used. The following content items are defined for use inside the link text: download.path The real path to the file. download.href The path to the file, relative to the current output file. download.name The file's name, without directories. download.mdate The file's modification date, in `ctime()` format, e.g. Thu Mar 01 20:54:34 2001. download.mtime The file's modification date, in UNIX time_t format. download.size_in_k The file's size, in kilobytes (rounded up). download.size The file's size, in bytes. download.owner The file's owner. download.group The file's group. download.tag_attrs The remaining attributes of the download tag. `template` can be a $ {content_reference}. The default template is:
        < a href="$ {download.href}" $ {download.tag_attrs}>$ {download.name}
        ($ {download.size_in_k}k)< /a>
Note that this means that any unrecognised attributes of the download tag itself will become attributes of the A tag. # OPTIONS WHICH AFFECT THIS TAG `FileSearchPath` - WebMake option

WebMake Documentation (version 1.2) | [ Back | Forward | Index | All In One ]