Parameter | Description | Default |
---|---|---|
"attachment" |
Name of attachment to link | |
web |
Web | |
topic |
Topic, or Web.Topic | |
topic_version |
Select topic version, if supported | most recent |
attachment_version |
Select attachment version, if supported | most recent |
%PUBURLPATH%
expands to /foswiki/pub
%PUBURLPATH{"icon_plus.png"}%
expands to =%PUBURLPATH{"icon_plus.png"}%
%PUBURLPATH{web="System"}%
expands to /foswiki/pub/System
%PUBURLPATH{topic="System.MainFeatures"}%
expands to /foswiki/pub/System/MainFeatures
%PUBURLPATH{web="System" topic="MainFeatures"}%
expands to /foswiki/pub/System/MainFeatures
%PUBURLPATH{topic="System.MainFeatures" "icon_plus.png"}%
expands to /foswiki/pub/System/MainFeatures/icon_plus.png
topic_version
and attachment_version
parameters. These can be used with advanced store implements to select specific attachment versions. However simple file-based stores do not normally support them.
PUBURL
The 'old' way of building URLs using PUBURLPATHPATH
involved concatenating the web and topic names to the PUBURLPATH
e.g. %PUBURLPATH%/%WEB%/%TOPIC%
. This practice is strongly discouraged, as it does not correctly handle encoding of the parts of the URL. At the first opportunity you should replace all such URLs with the equivalent %PUBURLPATH%{topic="System.MainFeatures"}%
, which will handle URL encoding for you.
ATTACHURLPATH provides a shorter way to refer to the attachments on the current topic.