Sha256: 476404a61548eacd34a11e855c7c93854e5f1e7359155fb17a9b44c8a3887b02
Contents?: true
Size: 1.28 KB
Versions: 17
Compression:
Stored size: 1.28 KB
Contents
---
title: Webgen::Tag::Link
used_options:
- tag.link.path
- tag.link.attr
---
## Description
This tag can be used to generate a link to an (absolute) (localized) canonical path. The generated
link will behave exactly like the ones generated by, for example, the breadcrumb trail tag or the
menu tag. So it respects the setting of the configuration option `website.link_to_current_page`
which means that if this option is set to `false` only a `span` element and not an `a` element is
created.
The configuration option `tag.link.attr` lets you specify additional HTML options that should be set
on the generated link. It can also be used to set the link text via the special `:link_text` key!
## Examples
<table class="examples">
<tr>
<th>Usage</th><th>Output</th>
</tr>
<tr>
<td>\{link: /default.css}</td>
<td>{link: /default.css}</td>
</tr>
<tr>
<td>\{link: link.html}</td>
<td>{link: link.html}</td>
</tr>
<tr>
<td>\{link: link.html#description}</td>
<td>{link: link.html#description}</td>
</tr>
<tr>
<td>\{link: ../}</td>
<td>{link: ../}</td>
</tr>
<tr>
<td>\{link: {path: relocatable.html, attr: {:link_text: A nicer link text, title: Just a title}}}</td>
<td>{link: {path: relocatable.html, attr: {:link_text: A nicer link text, title: Just a title}}}</td>
</tr>
</table>
Version data entries
17 entries across 17 versions & 3 rubygems