app/helpers/browse_tags_helper.rb

   1 module BrowseTagsHelper
   2   def format_key(key)
   3     if url = wiki_link("key", key)
   4       link_to h(key), url, :title => t("browse.tag_details.wiki_link.key", :key => key)
   5     else
   6       h(key)
   7     end
   8   end
   9
  10   def format_value(key, value)
  11     if wp = wikipedia_link(key, value)
  12       link_to h(wp[:title]), wp[:url], :title => t("browse.tag_details.wikipedia_link", :page => wp[:title])
  13     elsif wdt = wikidata_links(key, value)
  14       # IMPORTANT: Note that wikidata_links() returns an array of hashes, unlike for example wikipedia_link(),
  15       # which just returns one such hash.
  16       wdt = wdt.map do |w|
  17         link_to(w[:title], w[:url], :title => t("browse.tag_details.wikidata_link", :page => w[:title].strip))
  18       end
  19       safe_join(wdt, ";")
  20     elsif wmc = wikimedia_commons_link(key, value)
  21       link_to h(wmc[:title]), wmc[:url], :title => t("browse.tag_details.wikimedia_commons_link", :page => wmc[:title])
  22     elsif url = wiki_link("tag", "#{key}=#{value}")
  23       link_to h(value), url, :title => t("browse.tag_details.wiki_link.tag", :key => key, :value => value)
  24     elsif phones = telephone_links(key, value)
  25       # similarly, telephone_links() returns an array of phone numbers
  26       phones = phones.map do |p|
  27         link_to(h(p[:phone_number]), p[:url], :title => t("browse.tag_details.telephone_link", :phone_number => p[:phone_number]))
  28       end
  29       safe_join(phones, "; ")
  30     elsif colour_value = colour_preview(key, value)
  31       content_tag(:span, "", :class => "colour-preview-box", :"data-colour" => colour_value, :title => t("browse.tag_details.colour_preview", :colour_value => colour_value)) + colour_value
  32     else
  33       linkify h(value)
  34     end
  35   end
  36
  37   private
  38
  39   def wiki_link(type, lookup)
  40     locale = I18n.locale.to_s
  41
  42     # update-wiki-pages does s/ /_/g on keys before saving them, we
  43     # have to replace spaces with underscore so we'll link
  44     # e.g. `source=Isle of Man Government aerial imagery (2001)' to
  45     # the correct page.
  46     lookup_us = lookup.tr(" ", "_")
  47
  48     if page = WIKI_PAGES.dig(locale, type, lookup_us)
  49       url = "https://wiki.openstreetmap.org/wiki/#{page}?uselang=#{locale}"
  50     elsif page = WIKI_PAGES.dig("en", type, lookup_us)
  51       url = "https://wiki.openstreetmap.org/wiki/#{page}?uselang=#{locale}"
  52     end
  53
  54     url
  55   end
  56
  57   def wikipedia_link(key, value)
  58     # Some k/v's are wikipedia=http://en.wikipedia.org/wiki/Full%20URL
  59     return nil if value =~ %r{^https?://}
  60
  61     if key == "wikipedia"
  62       # This regex should match Wikipedia language codes, everything
  63       # from de to zh-classical
  64       lang = if value =~ /^([a-z-]{2,12}):(.+)$/i
  65                # Value is <lang>:<title> so split it up
  66                # Note that value is always left as-is, see: https://trac.openstreetmap.org/ticket/4315
  67                Regexp.last_match(1)
  68              else
  69                # Value is <title> so default to English Wikipedia
  70                "en"
  71              end
  72     elsif key =~ /^wikipedia:(\S+)$/
  73       # Language is in the key, so assume value is the title
  74       lang = Regexp.last_match(1)
  75     else
  76       # Not a wikipedia key!
  77       return nil
  78     end
  79
  80     if value =~ /^([^#]*)#(.*)/
  81       # Contains a reference to a section of the wikipedia article
  82       # Must break it up to correctly build the url
  83       value = Regexp.last_match(1)
  84       section = "#" + Regexp.last_match(2)
  85       encoded_section = "#" + CGI.escape(Regexp.last_match(2).gsub(/ +/, "_")).tr("%", ".")
  86     else
  87       section = ""
  88       encoded_section = ""
  89     end
  90
  91     {
  92       :url => "https://#{lang}.wikipedia.org/wiki/#{value}?uselang=#{I18n.locale}#{encoded_section}",
  93       :title => value + section
  94     }
  95   end
  96
  97   def wikidata_links(key, value)
  98     # The simple wikidata-tag (this is limited to only one value)
  99     if key == "wikidata" && value =~ /^[Qq][1-9][0-9]*$/
 100       return [{
 101         :url => "//www.wikidata.org/entity/#{value}?uselang=#{I18n.locale}",
 102         :title => value
 103       }]
 104     # Key has to be one of the accepted wikidata-tags
 105     elsif key =~ /(architect|artist|brand|name:etymology|network|operator|subject):wikidata/ &&
 106           # Value has to be a semicolon-separated list of wikidata-IDs (whitespaces allowed before and after semicolons)
 107           value =~ /^[Qq][1-9][0-9]*(\s*;\s*[Qq][1-9][0-9]*)*$/
 108       # Splitting at every semicolon to get a separate hash for each wikidata-ID
 109       return value.split(";").map do |id|
 110         { :title => id, :url => "//www.wikidata.org/entity/#{id.strip}?uselang=#{I18n.locale}" }
 111       end
 112     end
 113     nil
 114   end
 115
 116   def wikimedia_commons_link(key, value)
 117     if key == "wikimedia_commons" && value =~ /^(?:file|category):/i
 118       return {
 119         :url => "//commons.wikimedia.org/wiki/#{value}?uselang=#{I18n.locale}",
 120         :title => value
 121       }
 122     end
 123     nil
 124   end
 125
 126   def telephone_links(_key, value)
 127     # Does it look like a global phone number? eg "+1 (234) 567-8901 "
 128     # or a list of alternate numbers separated by ;
 129     #
 130     # Per RFC 3966, this accepts the visual separators -.() within the number,
 131     # which are displayed and included in the tel: URL, and accepts whitespace,
 132     # which is displayed but not included in the tel: URL.
 133     #  (see: http://tools.ietf.org/html/rfc3966#section-5.1.1)
 134     #
 135     # Also accepting / as a visual separator although not given in RFC 3966,
 136     # because it is used as a visual separator in OSM data in some countries.
 137     if value.match?(%r{^\s*\+[\d\s\(\)/\.-]{6,25}\s*(;\s*\+[\d\s\(\)/\.-]{6,25}\s*)*$})
 138       return value.split(";").map do |phone_number|
 139         # for display, remove leading and trailing whitespace
 140         phone_number = phone_number.strip
 141
 142         # for tel: URL, remove all whitespace
 143         # "+1 (234) 567-8901 " -> "tel:+1(234)567-8901"
 144         phone_no_whitespace = phone_number.gsub(/\s+/, "")
 145         { :phone_number => phone_number, :url => "tel:#{phone_no_whitespace}" }
 146       end
 147     end
 148     nil
 149   end
 150
 151   def colour_preview(key, value)
 152     return nil unless key =~ /^(?>.+:)?colour$/ && !value.nil? # see discussion at https://github.com/openstreetmap/openstreetmap-website/pull/1779
 153
 154     # does value look like a colour? ( 3 or 6 digit hex code or w3c colour name)
 155     w3c_colors =
 156       %w[aliceblue antiquewhite aqua aquamarine azure beige bisque black blanchedalmond blue blueviolet brown burlywood cadetblue chartreuse chocolate
 157          coral cornflowerblue cornsilk crimson cyan darkblue darkcyan darkgoldenrod darkgray darkgrey darkgreen darkkhaki darkmagenta darkolivegreen
 158          darkorange darkorchid darkred darksalmon darkseagreen darkslateblue darkslategray darkslategrey darkturquoise darkviolet deeppink deepskyblue
 159          dimgray dimgrey dodgerblue firebrick floralwhite forestgreen fuchsia gainsboro ghostwhite gold goldenrod gray grey green greenyellow honeydew
 160          hotpink indianred indigo ivory khaki lavender lavenderblush lawngreen lemonchiffon lightblue lightcoral lightcyan lightgoldenrodyellow lightgray
 161          lightgrey lightgreen lightpink lightsalmon lightseagreen lightskyblue lightslategray lightslategrey lightsteelblue lightyellow lime limegreen
 162          linen magenta maroon mediumaquamarine mediumblue mediumorchid mediumpurple mediumseagreen mediumslateblue mediumspringgreen mediumturquoise
 163          mediumvioletred midnightblue mintcream mistyrose moccasin navajowhite navy oldlace olive olivedrab orange orangered orchid palegoldenrod
 164          palegreen paleturquoise palevioletred papayawhip peachpuff peru pink plum powderblue purple red rosybrown royalblue saddlebrown salmon
 165          sandybrown seagreen seashell sienna silver skyblue slateblue slategray slategrey snow springgreen steelblue tan teal thistle tomato turquoise
 166          violet wheat white whitesmoke yellow yellowgreen]
 167     return nil unless value =~ /^#([0-9a-fA-F]{3}){1,2}$/ || w3c_colors.include?(value.downcase)
 168
 169     value
 170   end
 171 end