WebLink 1.0

Introduction

WebLink is a protocol designed to allow sites with downloads to appear to be just another part of the computer's hard drive. So far, only one browser that we know of supports WebLink, which is GoFoft.

Description

All WebLink commands are embedded in HTML comments ( <!-- and --> )

Types

String

Description

Strings are enclosed in double qoutes.

Example
<!-- % HREF = "download5.zip" % -->

List

Description

Lists are enclosed in parentheses and do not need quotes around their items. Items are seperated by comma-space.

Example
<!-- % FIELDS = (Field 1, Field 2) -->

Class

Description

Classes are defined groups. The main use for these are for setting field values with % FIELD ... %.

Example
<!-- % FIELD Author = "Quentin Smith" % -->

Elements

Download Lists

% BEGIN DOWNLOAD LIST % WebLink 1.0 %
Description

This signifies the beginning of a WebLink download list and says that the document supports version 1 of the protocol. You may only have one download list on each page at this time. Browsers are encouraged to ignore download list commands before this tag.

Parameters
None.
% END DOWNLOAD LIST %
Description

This signifies the end of a WebLink download list. Browsers are encouraged to parse weblink documents even if they do not include this tag, but it is not required by this standard. Browsers are encouraged to ignore download list commands after this tag.

Parameters
% FIELDS = list %
Description

This tag identifies the information that you will provide about the downloads. It should be after the BEGIN DOWNLOAD LIST command but before the first item.

Parameters
% BEGIN ITEM %
Description

This tag signifies the beginning of information for an item. Browsers should consider this tag to signify the end of the previous item, if necessary.

Parameters
None.
% END ITEM %
Description

This tag signifies the end of the information about an item. Browsers are encouraged to simply assume the current item ends when the next item begins if the end is not explicitly stated.

Parameters
None.
% HREF = link
Description

This tag identifies the file that this download should link to. The link may be relative, and if so, the same rules as for a link on the page should be applied. This tag is only valid within % BEGIN ITEM % and % END ITEM %.

Parameters
% FIELD name = value %
Description

This tag sets the value for a piece of information about a link. If multiple FIELD tags with the same name are in one item, the last tag will be the one accepted. This is only valid within % BEGIN ITEM % and % END ITEM %.

Parameters

Examples

Download Lists

Basic Example


<!-- % BEGIN DOWNLOAD LIST % WebLink 1.0 % -->
<!-- % FIELDS = (Version, Format) % -->

<!-- % BEGIN ITEM % -->
<!-- % HREF = "gofoft1.1.tar.gz" % -->
<!-- % FIELD Version = "Version 1.1" % -->
<!-- % FIELD Format = "Tar GZipped Archive" % -->
<!-- % END ITEM % -->

<!-- % BEGIN ITEM % -->
<!-- % HREF = "gofoft1.0.tar.gz" % -->
<!-- % FIELD Version = "Version 1.0" % -->
<!-- % FIELD Format = "Tar GZipped Archive" % -->
<!-- % END ITEM % -->

<!-- % END DOWNLOAD LIST % -->