Back to the extension listing.
Webgen::Tag::Relocatable
Summary
The following tag names are registered for this tag class: relocatable
This tag uses the following options:
tag.relocatable.path(mandatory default)
Description
This tag ensures that the relative path to the specified path is always correct.
When the tag is used, it changes the directory part of the supplied path name to a relative path to
the destination and is most often used in template files. A relocatable tag looks like this:
{relocatable: default.css}. If this was put into a template and the template was used by a file
in a subdirectory, then the relocatable tag would put ../default.css into the output file; thus
ensuring that the relative path to file is valid.
You can only use the
relocatabletag with paths that are handled by webgen. If you want to handle paths that are not normally handled by webgen, create a virtual path for them.
If the specified path is an absolute URL (like http://webgen.rubyforge.org), it will just return
it. And if you specify an URL fragment, this fragment has to exist. If you don’t want to resolve a
fragment, just don’t specify it in the tag but afterwards!
Examples
| Usage | Output |
|---|---|
| {relocatable: /default.css} | ../default.css |
| {relocatable: ../} | ../index.html |
Back to the extension listing.