Jekyll plugins

Plugins for the Jekyll static site generator.

file_link tag

A tag that generates a link (in markdown format) to a local file with its basename as link text. When the file cannot be found the tag only generates the basename without a link.

Usage:

• {% file_link path/to/file %} generates [file](path/to/file)
• {% file_link /path/to/file %} generates [file](/path/to/file)
• {% file_link no/such/file %} generates file

The path can be given relative (to the current page) or absolute, with the Jekyll source directory as root.

localize filter

A filter that localizes relative links using the lang variable from the page's YAML front matter. It is assumed that all relative links are meant to be relative to language specific sub sites -- like /en/, /de/, ... -- and returns the absolute link starting from the site root.

Absolute links and URLs starting with http:// or https:// are not modified.

Example (assuming 'lang: de'):

{{ 'relative/link' | localize }}  # => '/de/relative/link'
{{ '/en/link'      | localize }}  # => '/en/link'
{{ 'http://site'   | localize }}  # => 'http://site'

The site root '/' is also localized:

{{ '/' | localize }}  # => '/de/'

When the lang variable is not set, en is used as default:

{{ 'relative/link' | localize }}  # => '/en/relative/link'

Installation

Copy the files in the _plugins directory into the _plugins directory of your site.

License

Copyright © 2012-2024 Marcus Stollsteimer

This is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 3 or later (GPLv3+), see www.gnu.org/licenses/gpl.html. There is NO WARRANTY, to the extent permitted by law.