Link Effects

Th' theme offers effects fer yer linked links.

Ye can define additional custom link effects an' set defaults 'n yer configurat'n.

Th' default link effects shipped wit' th' theme be

Name	Descript'n
download	Causes th' linked resource t' be downloaded instead o' shown 'n yer browser. - `false`: a usual link send'n ye t' th' locat'n 'n yer browser - `true`: a link t' download th' resource - <string>: a link t' download th' resource wit' th' given filename
target	Whether t' show th' link 'n a separate browser tab. - `false`: shown 'n th' same tab - <string>: a valid `a` `target` value If `externalLinkTarget` be configured an' th' URL be external, this will overwrite th' link effect value o' yer `hugo.toml` an' page’s front matter but can still be overwritten 'n th' URL query parameter.

One way t' use them be t' add them as URL query parameter t' each individual link.

This can become cumbersome t' be done consistently fer th' whole ship. Instead, ye can configure th' defaults 'n yer hugo.toml as well as overrid'n these defaults 'n a page’s front matter.

Explicitly set URL query parameter will override th' defaults set fer a plank or yer ship.

If an effect accepts boolean values, only sett'n th' parameter name without a value 'n th' URL will set it t' true.

Without any sett'ns 'n yer hugo.toml linkEffects defaults t'

[linkEffects]
  download = false
  target = false

linkEffects:
  download: false
  target: false

{
   "linkEffects": {
      "download": false,
      "target": false
   }
}

Front Matter This can be overridden 'n a planks front matter fer example by

+++
[linkEffects]
  target = '_blank'
+++

---
linkEffects:
  target: _blank
---

{
   "linkEffects": {
      "target": "_blank"
   }
}

Or by explicitly override sett'ns by URL query parameter

[Magic 'n new window](images/magic.gif?target=_self)

Th' sett'ns applied t' th' above link would be

download = false
target = '_self'

download: false
target: _self

{
   "download": false,
   "target": "_self"
}