(file: …)
Creates a download link for any file
Attributes
In addition to the main file
, option, the tag supports the following attributes:
class
download
rel
target
text
title
Attribute | Description | Default |
---|---|---|
class | The class which is added to file link | null |
download | The download attribute that is added to file link | true |
rel | The rel attribute that is added to file link | null |
target | The target attribute that is added to file link | null |
text | The text that is added to file link | null |
title | The title attribute that is added to file link | null |
Attribute defaults from config
You can customize the defaults of this tag's attributes via the kirbytext.file
config option.
Examples
Download link with filename as text
(file: companysecrets.pdf)
Download link with custom text
(file: companysecrets.pdf text: Download our company secrets)
Download link for a file from another internal page
(file: some/other/page/companysecrets.pdf text: Download our company secrets)
Download link for an external file
(file: http://example.com/companysecrets.pdf text: Download their company secrets)
Download link with a title
attribute
(file: companysecrets.pdf title: Download our company secrets)
Download link with a rel
attribute
(file: cv.pdf text: My CV rel: me)
Download link with a specified target
(file: companysecrets.pdf target: _blank)
Download link with a custom CSS class
(file: companysecrets.pdf class: download)
Download link with download
attribute
To avoid direct downloads you can set the download
option to false
:
(file: companysecrets.pdf download: false)