WARNING LocalSite.cfg could not be found (This is normal for a new installation)
This Foswiki is running using a bootstrap configuration worked out by detecting the layout of the installation. To complete the bootstrap process you should either:
  • Restore the missing LocalSite.cfg from a backup, or
  • Complete the new Foswiki installation:

You have been logged in as a temporary administrator. Any requests made to this Foswiki will be treated as requests made by an administrator with full rights Your temporary administrator rights will "stick" until you've logged out from this session.
A Proxy server was detected. {ForceDefaultUrlHost} has been enabled.

If this page is rendered without any styles and you are using SSL (https), your proxy server may be misconfigured. It must generate the X-Forwarded-Proto header. Try adding ?SSL=1 to the Foswiki URL to bypass this issue.

error Warning: Updates found for 1 extension(s): EditRowPlugin ... Upgrade
You are here: Foswiki>System Web>Category>UserDocumentationCategory>Macros>VarPUBURL (06 Aug 2023, UnknownUser)Edit Attach

PUBURL -- generate an URL for an attachment

Generate an absolute URL for an attachment, or for a web or topic within the attachment database.

Parameters

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

Examples

  • %PUBURL% expands to https://golland-wiki.csail.mit.edu/pub
  • %PUBURL{"icon_plus.png"}% expands to =%PUBURL{"icon_plus.png"}%
  • %PUBURL{web="System"}% expands to https://golland-wiki.csail.mit.edu/pub/System
  • %PUBURL{topic="System.MainFeatures"}% expands to https://golland-wiki.csail.mit.edu/pub/System/MainFeatures
  • %PUBURL{web="System" topic="MainFeatures"}% expands to https://golland-wiki.csail.mit.edu/pub/System/MainFeatures
  • %PUBURL{topic="System.MainFeatures"}% expands to https://golland-wiki.csail.mit.edu/pub/System/MainFeatures
  • %PUBURL{topic="System.MainFeatures" "icon_plus.png"}% expands to https://golland-wiki.csail.mit.edu/pub/System/MainFeatures/icon_plus.png
  • Also supports topic_version and attachment_version parameters. These can be used with advanced store implementations to select specific attachment versions. However simple file-based stores do not normally support them.
    HELP The 'old' way of building URLs using PUBURL involved concatenating the web and topic names to the PUBURL e.g. %PUBURL%/Main/SystemFeatures. 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 %PUBURL%{topic="System.MainFeatures"}%, which will handle URL encoding for you.

    IDEA! ATTACHURL provides a shorter way to refer to the attachments on the current topic.

PUBURLPATH, ATTACHURL, ATTACHURLPATH, SCRIPTURL, SCRIPTURLPATH, FileAttachments
Edit  | Attach |   | Print version | History: r1 | Backlinks | View wiki text | Edit wiki text | More topic actions
Topic revision: r1 - 06 Aug 2023, UnknownUser
This site is powered by FoswikiCopyright © by the contributing authors. All material on this site is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback