2015-04-03 00:46:43 +00:00
|
|
|
require 'html/pipeline'
|
|
|
|
|
|
|
|
module Gitlab
|
|
|
|
module Markdown
|
|
|
|
# HTML filter that replaces label references with links. References within
|
|
|
|
# <pre>, <code>, <a>, and <style> elements are ignored.
|
|
|
|
#
|
|
|
|
# Context options:
|
|
|
|
# :project (required) - Current project.
|
|
|
|
# :reference_class - Custom CSS class added to reference links.
|
|
|
|
# :only_path - Generate path-only links.
|
|
|
|
#
|
|
|
|
class LabelReferenceFilter < HTML::Pipeline::Filter
|
|
|
|
# Public: Find label references in text
|
|
|
|
#
|
2015-04-10 20:38:34 +00:00
|
|
|
# LabelReferenceFilter.references_in(text) do |match, id, name|
|
|
|
|
# "<a href=...>#{Label.find(id)}</a>"
|
2015-04-03 00:46:43 +00:00
|
|
|
# end
|
|
|
|
#
|
|
|
|
# text - String text to search.
|
|
|
|
#
|
2015-04-10 20:38:34 +00:00
|
|
|
# Yields the String match, an optional Integer label ID, and an optional
|
|
|
|
# String label name.
|
2015-04-03 00:46:43 +00:00
|
|
|
#
|
|
|
|
# Returns a String replaced with the return of the block.
|
|
|
|
def self.references_in(text)
|
|
|
|
text.gsub(LABEL_PATTERN) do |match|
|
2015-04-10 20:38:34 +00:00
|
|
|
yield match, $~[:label_id].to_i, $~[:label_name]
|
2015-04-03 00:46:43 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Pattern used to extract label references from text
|
|
|
|
#
|
2015-04-10 20:38:34 +00:00
|
|
|
# TODO (rspeicher): Limit to double quotes (meh) or disallow single quotes in label names (bad).
|
|
|
|
LABEL_PATTERN = %r{
|
|
|
|
~(
|
|
|
|
(?<label_id>\d+) | # Integer-based label ID, or
|
|
|
|
(?<label_name>
|
|
|
|
[^'"&\?,\s]+ | # String-based single-word label title
|
|
|
|
['"][^&\?,]+['"] # String-based multi-word label surrounded in quotes
|
|
|
|
)
|
|
|
|
)
|
|
|
|
}x
|
2015-04-03 00:46:43 +00:00
|
|
|
|
|
|
|
# Don't look for references in text nodes that are children of these
|
|
|
|
# elements.
|
|
|
|
IGNORE_PARENTS = %w(pre code a style).to_set
|
|
|
|
|
|
|
|
def call
|
|
|
|
doc.search('text()').each do |node|
|
|
|
|
content = node.to_html
|
|
|
|
|
|
|
|
next if project.nil?
|
|
|
|
next unless content.match(LABEL_PATTERN)
|
|
|
|
next if has_ancestor?(node, IGNORE_PARENTS)
|
|
|
|
|
|
|
|
html = label_link_filter(content)
|
|
|
|
|
|
|
|
next if html == content
|
|
|
|
|
|
|
|
node.replace(html)
|
|
|
|
end
|
|
|
|
|
|
|
|
doc
|
|
|
|
end
|
|
|
|
|
|
|
|
def validate
|
|
|
|
needs :project
|
|
|
|
end
|
|
|
|
|
|
|
|
# Replace label references in text with links to the label specified.
|
|
|
|
#
|
|
|
|
# text - String text to replace references in.
|
|
|
|
#
|
|
|
|
# Returns a String with label references replaced with links. All links
|
|
|
|
# have `gfm` and `gfm-label` class names attached for styling.
|
|
|
|
def label_link_filter(text)
|
|
|
|
project = context[:project]
|
|
|
|
|
2015-04-10 20:38:34 +00:00
|
|
|
self.class.references_in(text) do |match, id, name|
|
|
|
|
params = label_params(id, name)
|
|
|
|
|
|
|
|
if label = project.labels.find_by(params)
|
2015-04-03 00:46:43 +00:00
|
|
|
url = url_for_label(project, label)
|
|
|
|
|
|
|
|
klass = "gfm gfm-label #{context[:reference_class]}".strip
|
|
|
|
|
|
|
|
%(<a href="#{url}" class="#{klass}">#{render_colored_label(label)}</a>)
|
|
|
|
else
|
|
|
|
match
|
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
def url_for_label(project, label)
|
|
|
|
h = Rails.application.routes.url_helpers
|
|
|
|
h.namespace_project_issues_path(project.namespace, project,
|
|
|
|
label_name: label.name,
|
|
|
|
only_path: context[:only_path])
|
|
|
|
end
|
|
|
|
|
|
|
|
def render_colored_label(label)
|
|
|
|
LabelsHelper.render_colored_label(label)
|
|
|
|
end
|
|
|
|
|
2015-04-10 20:38:34 +00:00
|
|
|
# Parameters to pass to `Label.find_by` based on the given arguments
|
|
|
|
#
|
|
|
|
# id - Integer ID to pass. If present, returns {id: id}
|
|
|
|
# name - String name to pass. If `id` is absent, finds by name without
|
|
|
|
# surrounding quotes.
|
|
|
|
#
|
|
|
|
# Returns a Hash.
|
|
|
|
def label_params(id, name)
|
|
|
|
if id > 0
|
|
|
|
{ id: id }
|
|
|
|
else
|
|
|
|
# TODO (rspeicher): Don't strip single quotes if we decide to only use double quotes for surrounding.
|
|
|
|
{ name: name.tr('\'"', '') }
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2015-04-03 00:46:43 +00:00
|
|
|
def project
|
|
|
|
context[:project]
|
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|