nanoc-extensions/README.md
Thomas Hochstein 528a67b4d1 Release 1.2 of dejure filter.
Signed-off-by: Thomas Hochstein <thh@inter.net>
2017-08-14 20:00:47 +02:00

1.2 KiB

nanoc extensions

Nanoc is a popular static site generator.

I'll add some little extensions for Nanoc here.

filters

abbreviations.rb

Simple Nanoc filter to add <abbr> tags.

After reading a YAML document from /content/_data/abbreviations.yam, all occurences of each $abbrev are replaced by a <abbr title="$abbrev">$fulltext</abbr> construct.

The filter currently uses a very naive - and time consuming - regexp approach.

The abbreviations dictionay in /content/_data/abbreviations.yaml has to look like this:

---
  abbreviations:
  - abbrev: HTML
  fulltext: HyperText Markup Language

You'll need a (compile and) routing rule to stop the abbreviations.yaml from being rendered and compiled, i.e. like this:

# ignore everything starting with _
compile %r{/_} do
  nil
end
route %r{/_} do
  nil
end

dejure.rb

Nanoc filter implementation of the dejure.org legal integration service.

filter :dejure,
  format: 'weit',
  buzer: 1,
  noheadings: 0,
  target: '_blank',
  class: 'dejure'

Please see the distribution page (in German).