Enhancing Worker Digital Experience: A Hands-on Workshop for Partners
Linking webinar
1. Linking in Cascade Server
Adam Griffis
Software Engineer
Hannon Hill Corporation
2. Outline
● Managed vs. Non-Managed Links
○ Why are some links managed and others not?
● Cross-Site Linking
● <link> Element for Index Blocks
○ Why is it preferable to path?
● Cross-Configuration Linking
3. Managed Links
● Tracked
○ If the linked asset is moved, the link will be updated.
● Link to another asset in Cascade
○ No prefix if in the same site
■ /path/to/asset
○ Site name prefix if in another site
■ site://sitename/path/to/asset
● Automatic for some attributes in XML-based assets
○ Pages, XML & XHTML Blocks, Templates, XSLT
Formats
○ http://www.hannonhill.com/kb/Linking/#managed-
links-within-assets-containing-xml
4. Managed Link Attributes
Element href src background
a x
area x x x
body x x
td x
table x
embed x x
frame x
iframe x
img x
input x x x
param x x x
link x x
script x
5. Manually Making Links Managed
● Non XML-based Assets
○ Velocity Template
○ CSS
○ Javascript
● Attributes that aren't normally tracked
● [system-asset] tag
● "Rewrite Links in File" attribute must be checked.
6. Why would a link not be managed?
● No Asset with the given path present
● The path is in the wrong format
○ http://www.site.com/path/to/asset
● The path isn't within [system-asset] tags and isn't tracked
automatically:
○ The path is not in a supported attribute
○ The document is not an xml-based asset.
7. Cross-Site Linking
● Just include the site://[site name]/ prefix
○ site://example.com/images/01.jpg
● Can only link between sites.
○ The global area can only be linked to by assets in the
global area and can only link to other assets in the
global area.
○ Any asset in a site can link to any other asset in the
same site or another site, but cannot link to Global
assets.
8. system-asset:local
● The system-asset:local tag means that the given path is
evaluated for the page in which the link ultimately exists.
○ Useful for templates, reused blocks
● Example: Single banner HTML code, automatically
customized to each site if they all have the banner image
in the same location.
○ <img src="[system-asset:local]files/images/banner.jpg[/system-asset:local]"
/>
9. Index Blocks - <link> tag
● Preferable to the path tag because it includes the site prefix.
○ Should be used whenever using index blocks indexing
other sites.
10. Linking between Configurations
● Links from a given configuration link to the same
configuration on other pages.
○ Based on configuration name.
● [system-asset:configuration]
○ A page can link to a different configuration with the
"system-asset:configuration" tag.
■ For example: a PDF download
■ <a href="[system-asset:configuration=pdf]/about/companyinfo.pdf
[/system-asset:configuration]"> Download our Company Guide PDF
</a>
2011 User Conference
11. Destination URLs
● Introduced in 6.10
● Destination URLs are URL prefixes used when linking to
configurations solely published to the given destination.
2011 User Conference