X-Git-Url: https://git.draconx.ca/gitweb/homepage.git/blobdiff_plain/1dc021529f88ca4f1ebfed76ffe6378272a23032..556a5888d1091c5fb1d202d911941941d0bba9c8:/lib/helpers.rb diff --git a/lib/helpers.rb b/lib/helpers.rb index faa40c3..77916dd 100644 --- a/lib/helpers.rb +++ b/lib/helpers.rb @@ -1,6 +1,6 @@ # Nick's web site: Ruby helpers for processing # -# Copyright Â© 2018 Nick Bowler +# Copyright Â© 2018-2021 Nick Bowler # # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by @@ -15,6 +15,18 @@ # You should have received a copy of the GNU General Public License # along with this program. If not, see . +require 'nokogiri' +require 'fastimage' + +use_helper Nanoc::Helpers::Blogging +use_helper Nanoc::Helpers::Breadcrumbs +use_helper Nanoc::Helpers::Rendering + +Xmlns = { + 'xhtml' => 'http://www.w3.org/1999/xhtml' +}.freeze +$counters = {} + def to_xhtml(subpath = "", item = @item) if item.identifier =~ '/index.*' ret = "/" + subpath + "/index.xhtml" @@ -27,10 +39,131 @@ end def item_source(item = @item) filename = "content" + item.identifier + filebase = filename.chomp(File.extname(filename)) + + [ if item.binary? then filebase + ".yaml" end, + filename].compact.find { |f| File.file? f } +end + +def item_uri(item = @item, rep: :default) + return item.path(rep: rep).sub(%r{/index[.][^.]*$}, "/") +end + +def rep_uri(rep = @rep) + return rep.path.sub(%r{/index[.][^.]*$}, "/") +end + +def find_license(license) + matches = @items.find_all("/license/" + license + ".*") + + raise("License not defined: " + license) if !matches.length + return matches.sort_by { |item| item.identifier } [0] +end + +# Return the first paragraph of the given item as a string. +def item_longdesc(item) + xml = Nokogiri::XML("" + + item.compiled_content(snapshot: :rawbody) + + "") + + p = xml.xpath('//xhtml:p', Xmlns) + if p.empty? then nil else p[0].xpath('string(.)') end +end + +def counter(name = :default, item = @item) + $counters[item] ||= {} + $counters[item][name] ||= 0 + + name.to_s.capitalize + " " + ($counters[item][name] += 1).to_s +end + +def img_rep_fallback(item, rep) + return rep unless item.reps[rep].raw_path.nil? + return :large +end + +def gallery_img(item, rep: :large, alt: nil, caption: nil) + return "[image not found]" unless item + + alt ||= item[:title] + caption ||= alt + caption = caption.strip + caption.gsub!(/\s+/, " ") - if File.file? filename then - return filename + rep = img_rep_fallback(item, rep) + attrs = { :src => item_uri(item, rep: rep), :alt => item[:title] } + attrs[:width], attrs[:height] = FastImage.size(item.reps[rep].raw_path) + + b = Nokogiri::XML::Builder.new do |xml| + xml.a(:href => item_uri(item, rep: :info)) { + xml.img(attrs, "generate-gallery" => "generate-gallery") + unless caption.empty? + xml << " ⁠" + xml.small { xml << caption } + end + } + end + b.to_xml(:save_with => Nokogiri::XML::Node::SaveOptions::NO_DECLARATION) +end + +def expand_copyright(copyright) + result = { :years => {} } + + /^([-â[:digit:][:space:],]*)(.*)$/.match(copyright) do |m| + m[1].split(/\s*,\s*/).each do |range| + lo, hi = range.split(/[^[:digit:]]+/) + for y in (lo..hi||lo) + result[:years][y] = 1 + end + end + + result[:years] = result[:years].keys.sort + result[:name] = m[2] + return result end return nil end + +def path_to_rep(path) + @items.find_all(File::dirname(path) + "/*").each do |item| + item.reps.each do |rep| + return rep if rep.path == path + end + end + return nil +end + +def find_images(item = @item) + return [] if item.binary? + + result = {} + doc = Nokogiri::HTML(item.compiled_content(snapshot: :pre)) + doc.xpath("//img/@src").each do |imgsrc| + rep = path_to_rep(imgsrc.value) + if rep + result[rep.item.identifier] ||= rep.item + end + end + return result.values +end + +def human_filesize(size) + units = ["B", "KiB", "MiB", "GiB"] + prec = 0 + + for unit in units + if (size < 1024) + break + end + + size /= 1024.0 + prec = 1 + end + + sprintf("%.*f %s", prec, size + 0.05, unit) +end + +def license_shortname(item) + item.fetch(:shortname, File::basename(item.identifier.without_ext).upcase) +end