df48f4c745d72de52464aea6da333e61e97e6df4
[homepage.git] / lib / helpers.rb
1 # Nick's web site: Ruby helpers for processing
2 #
3 # Copyright © 2018-2019 Nick Bowler
4 #
5 # This program is free software: you can redistribute it and/or modify
6 # it under the terms of the GNU General Public License as published by
7 # the Free Software Foundation, either version 3 of the License, or
8 # (at your option) any later version.
9 #
10 # This program is distributed in the hope that it will be useful,
11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13 # GNU General Public License for more details.
14 #
15 # You should have received a copy of the GNU General Public License
16 # along with this program.  If not, see <https://www.gnu.org/licenses/>.
17
18 require 'nokogiri'
19
20 use_helper Nanoc::Helpers::Breadcrumbs
21 use_helper Nanoc::Helpers::Blogging
22
23 Xmlns = {
24     'xhtml' => 'http://www.w3.org/1999/xhtml'
25 }.freeze
26 $counters = {}
27
28 def to_xhtml(subpath = "", item = @item)
29     if item.identifier =~ '/index.*'
30         ret =  "/" + subpath + "/index.xhtml"
31     else
32         ret = item.identifier.without_ext + "/" + subpath + "/index.xhtml"
33     end
34
35     return ret.gsub(/\/+/, "/")
36 end
37
38 def item_source(item = @item)
39     filename = "content" + item.identifier
40     filebase = filename.chomp(File.extname(filename))
41
42     [ if item.binary? then filebase + ".yaml" end,
43       filename].compact.find { |f| File.file? f }
44 end
45
46 def item_uri(item = @item, rep: :default)
47     return item.path(rep: rep).gsub(/\/index.[^.]*$/, "/")
48 end
49
50 def find_license(license)
51     matches = @items.find_all("/license/" + license + ".*")
52
53     raise("License not defined: " + license) if !matches.length
54     return matches.sort_by { |item| item.identifier } [0]
55 end
56
57 # Return the first paragraph of the given item as a string.
58 def item_longdesc(item)
59     xml = Nokogiri::XML("<body xmlns='" + Xmlns["xhtml"] + "'>" +
60                         item.compiled_content(snapshot: :rawbody) +
61                         "</body>")
62
63     p = xml.xpath('//xhtml:p', Xmlns)
64     if p.empty? then nil else p[0].xpath('string(.)') end
65 end
66
67 def counter(name = :default, item = @item)
68     $counters[item] ||= {}
69     $counters[item][name] ||= 0
70
71     name.to_s.capitalize + " " + ($counters[item][name] += 1).to_s
72 end
73
74 def human_filesize(size)
75     units = ["B", "KiB", "MiB", "GiB"]
76
77     for unit in units
78         if (size < 1024)
79             break
80         end
81
82         size /= 1024.0
83     end
84
85     sprintf("%.1f %s", size + 0.05, unit)
86 end