This version is out of date, covering development from v4.6.0 to v4.7.1. It is maintained here only for inbound reference links from elsewhere. Jump to the current version of aTbRef. |
|
A Tinderbox Reference File : Export Codes : Export Code Types : Creation of Links : ^url( item )^ | aTbRef Site Map |
^url( item )^ |
Code Type: | Link Creation |
Code Scope of Action: | item |
^url( item )^
The URL of the exported HTML web page for the item . The URL of an alias to a note is the URL attribute of that note's original. It is effectively ^host^ + ^path^ + ^file(note)^.
Don't confuse this with ^get(URL) which will return the content of the note's URL field.
^url(this)^ will return the relative path from the current page to the page the included note creates when it is exported. If the note is not exported, but only appears on included pages, ^url(this)^ is undefined.
As ^url()^ only supplies the 'href' parameter value for an HTML link, if you want to customise your link, e.g. by setting a CSS class parameter, you can do that in the template rather than needing to do so in the TB code itself.
^url(this)^ gives a relative path from the current page to the note; by comparison, ^path(this) gives the path from the top level of the site to the note. Thus:
^url(BorderBevel)^
: ../../../Attributes/SystemAttributeList/BorderBevel.html
^path(BorderBevel)^
: index/Attributes/SystemAttributeList/BorderBevel.html
^url(this)^
: #
^path(this)^
: index/ExportCodes/ExportCodeTypes/CreationofLinks/urlitem.html
Up: Creation of Links | |
Previous: ^similarTo( item, count[, start, list-item-prefix, list-item-suffix, end] )^ |
Licensed under Creative Commons Attribution-Noncommercial-Share Alike 3.0 License
[See aTbRef CC licence Attribution/Waiver info info]