Rules 2.77 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
#!/usr/bin/env ruby

# A few helpful tips about the Rules file:
#
# * The string given to #compile and #route are matching patterns for
#   identifiers--not for paths. Therefore, you can’t match on extension.
#
# * The order of rules is important: for each item, only the first matching
#   rule is applied.
#
# * Item identifiers start and end with a slash (e.g. “/about/” for the file
#   “content/about.html”). To select all children, grandchildren, … of an
#   item, use the pattern “/about/*/”; “/about/*” will also select the parent,
#   because “*” matches zero or more characters.

compile '/assets/*' do
end

route '/assets/*' do
20 21 22 23 24 25 26
  # Cachebuster currently doesn't fingerprint all needed files (SVG and font
  # extensions are missing), so we need to differentiate here.
  if Nanoc::Cachebuster::FILETYPES_TO_FINGERPRINT.include?(item[:extension])
    item.identifier[0..-(3 + item[:extension].length)] + fingerprint(item[:filename]) + '.' + item[:extension]
  else
    item.identifier[0..-2]
  end
27 28
end

29 30 31 32
route '/README/' do
    '/README.md'
end

33 34 35 36 37 38 39 40 41
# RSS Feed
compile '/blog/feed/' do
    filter :erb
end

route '/blog/feed/' do
    '/blog/feed.xml'
end

42
compile '*' do
Julius Volz's avatar
Julius Volz committed
43 44
  filter :erb

45
  if item[:title] == 'README.md'
46
    # Don't filter; this should propagate verbatim to the output GitHub repository.
47
  elsif item[:extension] == 'md'
48
    filter :redcarpet, options: {filter_html: true, autolink: true, no_intraemphasis: true, fenced_code_blocks: true, gh_blockcode: true, tables: true}, renderer_options: {with_toc_data: true}
49 50 51 52
    filter :add_anchors
    filter :bootstrappify
    filter :admonition
    filter :colorize_syntax, :default_colorizer => :pygmentsrb
53
    filter :config_linker if item[:title] == 'Configuration'
54
    filter :toc, style: item[:toc]
Julius Volz's avatar
Julius Volz committed
55 56 57 58 59
    if item[:kind] == 'article'
      layout 'blog'
    else
      layout 'docs'
    end
60 61 62 63
  elsif item[:extension] == 'css'
    # don’t filter stylesheets
  elsif item.binary?
    # don’t filter binary items
64 65
  elsif item[:layout]
    layout item[:layout]
66 67 68
  else
    layout 'default'
  end
69 70

  filter :cache_buster
71 72
end

Julius Volz's avatar
Julius Volz committed
73 74 75 76 77 78 79 80 81 82 83 84
route '/blog/' do
  '/blog/index.html'
end

# Transform /blog/<YYYY>-<MM>-<DD>-<post title> to
# /blog/<YYYY>/<MM>/<DD>/<post title>.
route '/blog/*' do
  y, m, d, slug = /([0-9]+)\-([0-9]+)\-([0-9]+)\-([^\/]+)/.match(item.identifier).captures

  "/blog/#{y}/#{m}/#{d}/#{slug}/index.html"
end

85 86 87
route '*' do
  if item[:extension] == 'css'
    # Write item with identifier /foo/ to /foo.css
88
    item.identifier.chop + fingerprint(item[:filename]) + '.css'
89 90 91 92 93 94 95 96 97 98 99 100
  elsif item.binary?
    # Write item with identifier /foo/ to /foo.ext
    item.identifier.chop + '.' + item[:extension]
  else
    # Write item with identifier /foo/ to /foo/index.html
    item.identifier + 'index.html'
  end
end

#passthrough '/assets/*'

layout '*', :erb