2018-12-05 23:21:45 +05:30
|
|
|
# frozen_string_literal: true
|
|
|
|
|
2015-09-11 14:41:01 +05:30
|
|
|
require 'nokogiri'
|
|
|
|
|
2017-08-17 22:00:37 +05:30
|
|
|
module MarkupHelper
|
2019-09-30 21:07:59 +05:30
|
|
|
include ActionView::Helpers::TextHelper
|
2019-07-07 11:18:12 +05:30
|
|
|
include ::Gitlab::ActionViewOutput::Context
|
2017-08-17 22:00:37 +05:30
|
|
|
|
|
|
|
def plain?(filename)
|
|
|
|
Gitlab::MarkupHelper.plain?(filename)
|
|
|
|
end
|
|
|
|
|
|
|
|
def markup?(filename)
|
|
|
|
Gitlab::MarkupHelper.markup?(filename)
|
|
|
|
end
|
|
|
|
|
|
|
|
def gitlab_markdown?(filename)
|
|
|
|
Gitlab::MarkupHelper.gitlab_markdown?(filename)
|
|
|
|
end
|
|
|
|
|
|
|
|
def asciidoc?(filename)
|
|
|
|
Gitlab::MarkupHelper.asciidoc?(filename)
|
|
|
|
end
|
|
|
|
|
2014-09-02 18:07:02 +05:30
|
|
|
# Use this in places where you would normally use link_to(gfm(...), ...).
|
2018-03-17 18:26:18 +05:30
|
|
|
def link_to_markdown(body, url, html_options = {})
|
|
|
|
return '' if body.blank?
|
|
|
|
|
|
|
|
link_to_html(markdown(body, pipeline: :single_line), url, html_options)
|
|
|
|
end
|
|
|
|
|
|
|
|
def link_to_markdown_field(object, field, url, html_options = {})
|
|
|
|
rendered_field = markdown_field(object, field)
|
|
|
|
|
|
|
|
link_to_html(rendered_field, url, html_options)
|
|
|
|
end
|
|
|
|
|
2014-09-02 18:07:02 +05:30
|
|
|
# It solves a problem occurring with nested links (i.e.
|
|
|
|
# "<a>outer text <a>gfm ref</a> more outer text</a>"). This will not be
|
|
|
|
# interpreted as intended. Browsers will parse something like
|
|
|
|
# "<a>outer text </a><a>gfm ref</a> more outer text" (notice the last part is
|
2018-03-17 18:26:18 +05:30
|
|
|
# not linked any more). link_to_html corrects that. It wraps all parts to
|
2014-09-02 18:07:02 +05:30
|
|
|
# explicitly produce the correct linking behavior (i.e.
|
|
|
|
# "<a>outer text </a><a>gfm ref</a><a> more outer text</a>").
|
2018-03-17 18:26:18 +05:30
|
|
|
def link_to_html(redacted, url, html_options = {})
|
|
|
|
fragment = Nokogiri::HTML::DocumentFragment.parse(redacted)
|
2014-09-02 18:07:02 +05:30
|
|
|
|
2015-09-11 14:41:01 +05:30
|
|
|
if fragment.children.size == 1 && fragment.children[0].name == 'a'
|
|
|
|
# Fragment has only one node, and it's a link generated by `gfm`.
|
|
|
|
# Replace it with our requested link.
|
|
|
|
text = fragment.children[0].text
|
|
|
|
fragment.children[0].replace(link_to(text, url, html_options))
|
|
|
|
else
|
|
|
|
# Traverse the fragment's first generation of children looking for pure
|
|
|
|
# text, wrapping anything found in the requested link
|
|
|
|
fragment.children.each do |node|
|
|
|
|
next unless node.text?
|
2018-03-17 18:26:18 +05:30
|
|
|
|
2015-09-11 14:41:01 +05:30
|
|
|
node.replace(link_to(node.text, url, html_options))
|
|
|
|
end
|
2014-09-02 18:07:02 +05:30
|
|
|
end
|
|
|
|
|
2015-09-25 12:07:36 +05:30
|
|
|
# Add any custom CSS classes to the GFM-generated reference links
|
|
|
|
if html_options[:class]
|
|
|
|
fragment.css('a.gfm').add_class(html_options[:class])
|
|
|
|
end
|
|
|
|
|
2015-09-11 14:41:01 +05:30
|
|
|
fragment.to_html.html_safe
|
2014-09-02 18:07:02 +05:30
|
|
|
end
|
|
|
|
|
2017-08-17 22:00:37 +05:30
|
|
|
# Return the first line of +text+, up to +max_chars+, after parsing the line
|
|
|
|
# as Markdown. HTML tags in the parsed output are not counted toward the
|
|
|
|
# +max_chars+ limit. If the length limit falls within a tag's contents, then
|
|
|
|
# the tag contents are truncated without removing the closing tag.
|
2018-03-17 18:26:18 +05:30
|
|
|
def first_line_in_markdown(object, attribute, max_chars = nil, options = {})
|
|
|
|
md = markdown_field(object, attribute, options)
|
2019-07-07 11:18:12 +05:30
|
|
|
return unless md.present?
|
2018-03-17 18:26:18 +05:30
|
|
|
|
2018-12-05 23:21:45 +05:30
|
|
|
tags = %w(a gl-emoji b pre code p span)
|
|
|
|
tags << 'img' if options[:allow_images]
|
2017-08-17 22:00:37 +05:30
|
|
|
|
2018-12-05 23:21:45 +05:30
|
|
|
text = truncate_visible(md, max_chars || md.length)
|
|
|
|
text = sanitize(
|
2018-03-17 18:26:18 +05:30
|
|
|
text,
|
2018-12-05 23:21:45 +05:30
|
|
|
tags: tags,
|
2019-07-07 11:18:12 +05:30
|
|
|
attributes: Rails::Html::WhiteListSanitizer.allowed_attributes +
|
|
|
|
%w(style data-src data-name data-unicode-version data-iid data-project-path data-mr-title)
|
2018-03-17 18:26:18 +05:30
|
|
|
)
|
2018-12-05 23:21:45 +05:30
|
|
|
|
|
|
|
# since <img> tags are stripped, this can leave empty <a> tags hanging around
|
|
|
|
# (as our markdown wraps images in links)
|
|
|
|
options[:allow_images] ? text : strip_empty_link_tags(text).html_safe
|
2017-08-17 22:00:37 +05:30
|
|
|
end
|
|
|
|
|
2015-09-25 12:07:36 +05:30
|
|
|
def markdown(text, context = {})
|
2017-08-17 22:00:37 +05:30
|
|
|
return '' unless text.present?
|
2015-10-24 18:46:33 +05:30
|
|
|
|
2015-12-23 02:04:40 +05:30
|
|
|
context[:project] ||= @project
|
2018-03-17 18:26:18 +05:30
|
|
|
context[:group] ||= @group
|
|
|
|
|
2017-08-17 22:00:37 +05:30
|
|
|
html = markdown_unsafe(text, context)
|
|
|
|
prepare_for_rendering(html, context)
|
2016-11-03 12:29:30 +05:30
|
|
|
end
|
2015-10-24 18:46:33 +05:30
|
|
|
|
2018-03-17 18:26:18 +05:30
|
|
|
def markdown_field(object, field, context = {})
|
2016-11-03 12:29:30 +05:30
|
|
|
object = object.for_display if object.respond_to?(:for_display)
|
2018-03-17 18:26:18 +05:30
|
|
|
redacted_field_html = object.try(:"redacted_#{field}_html")
|
|
|
|
|
2017-08-17 22:00:37 +05:30
|
|
|
return '' unless object.present?
|
2018-03-17 18:26:18 +05:30
|
|
|
return redacted_field_html if redacted_field_html
|
2015-04-26 12:48:37 +05:30
|
|
|
|
2018-03-17 18:26:18 +05:30
|
|
|
html = Banzai.render_field(object, field, context)
|
|
|
|
context.reverse_merge!(object.banzai_render_context(field)) if object.respond_to?(:banzai_render_context)
|
|
|
|
|
|
|
|
prepare_for_rendering(html, context)
|
2014-09-02 18:07:02 +05:30
|
|
|
end
|
|
|
|
|
2017-08-17 22:00:37 +05:30
|
|
|
def markup(file_name, text, context = {})
|
|
|
|
context[:project] ||= @project
|
|
|
|
html = context.delete(:rendered) || markup_unsafe(file_name, text, context)
|
|
|
|
prepare_for_rendering(html, context)
|
2016-04-02 18:10:28 +05:30
|
|
|
end
|
|
|
|
|
2018-11-20 20:47:30 +05:30
|
|
|
def render_wiki_content(wiki_page, context = {})
|
2017-08-17 22:00:37 +05:30
|
|
|
text = wiki_page.content
|
|
|
|
return '' unless text.present?
|
|
|
|
|
2018-11-20 20:47:30 +05:30
|
|
|
context.merge!(
|
2018-03-17 18:26:18 +05:30
|
|
|
pipeline: :wiki,
|
|
|
|
project: @project,
|
|
|
|
project_wiki: @project_wiki,
|
|
|
|
page_slug: wiki_page.slug,
|
2018-11-20 20:47:30 +05:30
|
|
|
issuable_state_filter_enabled: true
|
|
|
|
)
|
2017-08-17 22:00:37 +05:30
|
|
|
|
2019-10-31 01:37:42 +05:30
|
|
|
html = markup_unsafe(wiki_page.path, text, context)
|
2015-12-23 02:04:40 +05:30
|
|
|
|
2017-08-17 22:00:37 +05:30
|
|
|
prepare_for_rendering(html, context)
|
2015-09-11 14:41:01 +05:30
|
|
|
end
|
|
|
|
|
2017-08-17 22:00:37 +05:30
|
|
|
def markup_unsafe(file_name, text, context = {})
|
|
|
|
return '' unless text.present?
|
2015-04-26 12:48:37 +05:30
|
|
|
|
2017-08-17 22:00:37 +05:30
|
|
|
if gitlab_markdown?(file_name)
|
|
|
|
markdown_unsafe(text, context)
|
|
|
|
elsif asciidoc?(file_name)
|
|
|
|
asciidoc_unsafe(text, context)
|
|
|
|
elsif plain?(file_name)
|
2019-09-30 21:07:59 +05:30
|
|
|
plain_unsafe(text)
|
2017-08-17 22:00:37 +05:30
|
|
|
else
|
|
|
|
other_markup_unsafe(file_name, text, context)
|
|
|
|
end
|
|
|
|
rescue RuntimeError
|
|
|
|
simple_format(text)
|
2015-04-26 12:48:37 +05:30
|
|
|
end
|
|
|
|
|
2017-08-17 22:00:37 +05:30
|
|
|
# Returns the text necessary to reference `entity` across projects
|
|
|
|
#
|
|
|
|
# project - Project to reference
|
|
|
|
# entity - Object that responds to `to_reference`
|
|
|
|
#
|
|
|
|
# Examples:
|
|
|
|
#
|
|
|
|
# cross_project_reference(project, project.issues.first)
|
|
|
|
# # => 'namespace1/project1#123'
|
|
|
|
#
|
|
|
|
# cross_project_reference(project, project.merge_requests.first)
|
|
|
|
# # => 'namespace1/project1!345'
|
|
|
|
#
|
|
|
|
# Returns a String
|
|
|
|
def cross_project_reference(project, entity)
|
|
|
|
if entity.respond_to?(:to_reference)
|
|
|
|
entity.to_reference(project, full: true)
|
2014-09-02 18:07:02 +05:30
|
|
|
else
|
2017-08-17 22:00:37 +05:30
|
|
|
''
|
2014-09-02 18:07:02 +05:30
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2015-04-26 12:48:37 +05:30
|
|
|
private
|
|
|
|
|
|
|
|
# Return +text+, truncated to +max_chars+ characters, excluding any HTML
|
|
|
|
# tags.
|
|
|
|
def truncate_visible(text, max_chars)
|
|
|
|
doc = Nokogiri::HTML.fragment(text)
|
|
|
|
content_length = 0
|
|
|
|
truncated = false
|
|
|
|
|
|
|
|
doc.traverse do |node|
|
|
|
|
if node.text? || node.content.empty?
|
|
|
|
if truncated
|
|
|
|
node.remove
|
|
|
|
next
|
|
|
|
end
|
|
|
|
|
|
|
|
# Handle line breaks within a node
|
|
|
|
if node.content.strip.lines.length > 1
|
|
|
|
node.content = "#{node.content.lines.first.chomp}..."
|
|
|
|
truncated = true
|
|
|
|
end
|
|
|
|
|
|
|
|
num_remaining = max_chars - content_length
|
|
|
|
if node.content.length > num_remaining
|
|
|
|
node.content = node.content.truncate(num_remaining)
|
|
|
|
truncated = true
|
|
|
|
end
|
2018-03-17 18:26:18 +05:30
|
|
|
|
2015-04-26 12:48:37 +05:30
|
|
|
content_length += node.content.length
|
|
|
|
end
|
|
|
|
|
|
|
|
truncated = truncate_if_block(node, truncated)
|
|
|
|
end
|
|
|
|
|
|
|
|
doc.to_html
|
|
|
|
end
|
|
|
|
|
|
|
|
# Used by #truncate_visible. If +node+ is the first block element, and the
|
|
|
|
# text hasn't already been truncated, then append "..." to the node contents
|
|
|
|
# and return true. Otherwise return false.
|
|
|
|
def truncate_if_block(node, truncated)
|
2017-08-17 22:00:37 +05:30
|
|
|
return true if truncated
|
|
|
|
|
|
|
|
if node.element? && (node.description&.block? || node.matches?('pre > code > .line'))
|
2015-10-24 18:46:33 +05:30
|
|
|
node.inner_html = "#{node.inner_html}..." if node.next_sibling
|
2015-04-26 12:48:37 +05:30
|
|
|
true
|
|
|
|
else
|
|
|
|
truncated
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2018-12-05 23:21:45 +05:30
|
|
|
def strip_empty_link_tags(text)
|
|
|
|
scrubber = Loofah::Scrubber.new do |node|
|
|
|
|
node.remove if node.name == 'a' && node.content.blank?
|
|
|
|
end
|
|
|
|
|
2019-07-31 22:56:46 +05:30
|
|
|
sanitize text, scrubber: scrubber
|
2018-12-05 23:21:45 +05:30
|
|
|
end
|
|
|
|
|
2016-08-24 12:49:21 +05:30
|
|
|
def markdown_toolbar_button(options = {})
|
2017-08-17 22:00:37 +05:30
|
|
|
data = options[:data].merge({ container: 'body' })
|
2016-08-24 12:49:21 +05:30
|
|
|
content_tag :button,
|
2017-08-17 22:00:37 +05:30
|
|
|
type: 'button',
|
2018-03-17 18:26:18 +05:30
|
|
|
class: 'toolbar-btn js-md has-tooltip',
|
2016-08-24 12:49:21 +05:30
|
|
|
tabindex: -1,
|
|
|
|
data: data,
|
|
|
|
title: options[:title],
|
|
|
|
aria: { label: options[:title] } do
|
2018-03-17 18:26:18 +05:30
|
|
|
sprite_icon(options[:icon])
|
2016-08-24 12:49:21 +05:30
|
|
|
end
|
|
|
|
end
|
2016-11-03 12:29:30 +05:30
|
|
|
|
2017-08-17 22:00:37 +05:30
|
|
|
def markdown_unsafe(text, context = {})
|
|
|
|
Banzai.render(text, context)
|
|
|
|
end
|
|
|
|
|
|
|
|
def asciidoc_unsafe(text, context = {})
|
2019-09-04 21:01:54 +05:30
|
|
|
context.merge!(
|
|
|
|
commit: @commit,
|
|
|
|
ref: @ref,
|
|
|
|
requested_path: @path
|
|
|
|
)
|
2017-08-17 22:00:37 +05:30
|
|
|
Gitlab::Asciidoc.render(text, context)
|
|
|
|
end
|
|
|
|
|
2019-09-30 21:07:59 +05:30
|
|
|
def plain_unsafe(text)
|
|
|
|
content_tag :pre, class: 'plain-readme' do
|
|
|
|
text
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2017-08-17 22:00:37 +05:30
|
|
|
def other_markup_unsafe(file_name, text, context = {})
|
|
|
|
Gitlab::OtherMarkup.render(file_name, text, context)
|
|
|
|
end
|
|
|
|
|
|
|
|
def prepare_for_rendering(html, context = {})
|
|
|
|
return '' unless html.present?
|
|
|
|
|
2019-09-30 21:07:59 +05:30
|
|
|
context.reverse_merge!(
|
2018-05-09 12:01:36 +05:30
|
|
|
current_user: (current_user if defined?(current_user)),
|
2016-11-03 12:29:30 +05:30
|
|
|
|
|
|
|
# RelativeLinkFilter
|
2017-08-17 22:00:37 +05:30
|
|
|
commit: @commit,
|
2016-11-03 12:29:30 +05:30
|
|
|
project_wiki: @project_wiki,
|
2017-08-17 22:00:37 +05:30
|
|
|
ref: @ref,
|
|
|
|
requested_path: @path
|
2016-11-03 12:29:30 +05:30
|
|
|
)
|
|
|
|
|
2017-08-17 22:00:37 +05:30
|
|
|
html = Banzai.post_process(html, context)
|
|
|
|
|
|
|
|
Hamlit::RailsHelpers.preserve(html)
|
2016-11-03 12:29:30 +05:30
|
|
|
end
|
2017-08-17 22:00:37 +05:30
|
|
|
|
|
|
|
extend self
|
2014-09-02 18:07:02 +05:30
|
|
|
end
|