debian-mirror-gitlab/app/helpers/wiki_helper.rb

140 lines
5 KiB
Ruby
Raw Normal View History

2018-12-05 23:21:45 +05:30
# frozen_string_literal: true
2017-08-17 22:00:37 +05:30
module WikiHelper
2018-11-20 20:47:30 +05:30
include API::Helpers::RelatedResourcesHelpers
2020-07-28 23:09:34 +05:30
def wiki_page_title(page, action = nil)
titles = [_('Wiki')]
if page.persisted?
titles << page.human_title
breadcrumb_title(page.human_title)
wiki_breadcrumb_dropdown_links(page.slug)
end
titles << action if action
page_title(*titles.reverse)
add_to_breadcrumbs(_('Wiki'), wiki_path(page.wiki))
end
def link_to_wiki_page(page, **options)
link_to page.human_title, wiki_page_path(page.wiki, page), **options
end
def wiki_sidebar_toggle_button
2021-04-29 21:17:54 +05:30
content_tag :button, class: 'gl-button btn btn-default btn-icon sidebar-toggle js-sidebar-wiki-toggle', role: 'button', type: 'button' do
2020-07-28 23:09:34 +05:30
sprite_icon('chevron-double-lg-left')
end
end
2017-08-17 22:00:37 +05:30
# Produces a pure text breadcrumb for a given page.
#
# page_slug - The slug of a WikiPage object.
#
# Returns a String composed of the capitalized name of each directory and the
# capitalized name of the page itself.
def breadcrumb(page_slug)
2017-09-10 17:25:29 +05:30
page_slug.split('/')
.map { |dir_or_page| WikiPage.unhyphenize(dir_or_page).capitalize }
.join(' / ')
2017-08-17 22:00:37 +05:30
end
2018-03-17 18:26:18 +05:30
def wiki_breadcrumb_dropdown_links(page_slug)
page_slug_split = page_slug.split('/')
page_slug_split.pop(1)
current_slug = ""
page_slug_split
.map do |dir_or_page|
current_slug = "#{current_slug}#{dir_or_page}/"
2020-06-23 00:09:42 +05:30
add_to_breadcrumb_dropdown link_to(WikiPage.unhyphenize(dir_or_page).capitalize, wiki_page_path(@wiki, current_slug)), location: :after
2018-03-17 18:26:18 +05:30
end
end
2018-11-20 20:47:30 +05:30
def wiki_attachment_upload_url
2020-11-24 15:15:51 +05:30
case @wiki.container
when Project
expose_url(api_v4_projects_wikis_attachments_path(id: @wiki.container.id))
else
raise TypeError, "Unsupported wiki container #{@wiki.container.class}"
end
2018-11-20 20:47:30 +05:30
end
2019-07-07 11:18:12 +05:30
2020-06-23 00:09:42 +05:30
def wiki_sort_controls(wiki, sort, direction)
sort ||= Wiki::TITLE_ORDER
2021-04-29 21:17:54 +05:30
link_class = 'gl-button btn btn-default btn-icon has-tooltip reverse-sort-btn qa-reverse-sort rspec-reverse-sort'
2019-07-07 11:18:12 +05:30
reversed_direction = direction == 'desc' ? 'asc' : 'desc'
icon_class = direction == 'desc' ? 'highest' : 'lowest'
2020-06-23 00:09:42 +05:30
link_to(wiki_path(wiki, action: :pages, sort: sort, direction: reversed_direction),
2019-07-07 11:18:12 +05:30
type: 'button', class: link_class, title: _('Sort direction')) do
2020-10-24 23:57:45 +05:30
sprite_icon("sort-#{icon_class}")
2019-07-07 11:18:12 +05:30
end
end
def wiki_sort_title(key)
2020-06-23 00:09:42 +05:30
if key == Wiki::CREATED_AT_ORDER
2019-07-07 11:18:12 +05:30
s_("Wiki|Created date")
else
s_("Wiki|Title")
end
end
2020-06-23 00:09:42 +05:30
def wiki_empty_state_messages(wiki)
case wiki.container
when Project
2020-07-28 23:09:34 +05:30
writable_body = s_("WikiEmpty|A wiki is where you can store all the details about your project. This can include why you've created it, its principles, how to use it, and so on.")
writable_body += s_("WikiEmpty| Have a Confluence wiki already? Use that instead.") if show_enable_confluence_integration?(wiki.container)
2020-06-23 00:09:42 +05:30
{
writable: {
title: s_('WikiEmpty|The wiki lets you write documentation for your project'),
2020-07-28 23:09:34 +05:30
body: writable_body
2020-06-23 00:09:42 +05:30
},
issuable: {
title: s_('WikiEmpty|This project has no wiki pages'),
body: s_('WikiEmptyIssueMessage|You must be a project member in order to add wiki pages. If you have suggestions for how to improve the wiki for this project, consider opening an issue in the %{issues_link}.')
},
readonly: {
title: s_('WikiEmpty|This project has no wiki pages'),
body: s_('WikiEmpty|You must be a project member in order to add wiki pages.')
}
}
when Group
{
writable: {
title: s_('WikiEmpty|The wiki lets you write documentation for your group'),
body: s_("WikiEmpty|A wiki is where you can store all the details about your group. This can include why you've created it, its principles, how to use it, and so on.")
},
issuable: {
title: s_('WikiEmpty|This group has no wiki pages'),
body: s_('WikiEmptyIssueMessage|You must be a group member in order to add wiki pages. If you have suggestions for how to improve the wiki for this group, consider opening an issue in the %{issues_link}.')
},
readonly: {
title: s_('WikiEmpty|This group has no wiki pages'),
body: s_('WikiEmpty|You must be a group member in order to add wiki pages.')
}
}
else
raise NotImplementedError, "Unknown wiki container type #{wiki.container.class.name}"
end
end
2020-07-28 23:09:34 +05:30
def wiki_page_tracking_context(page)
{
'wiki-format' => page.format,
'wiki-title-size' => page.title.bytesize,
'wiki-content-size' => page.raw_content.bytesize,
2021-01-03 14:25:43 +05:30
'wiki-directory-nest-level' => page.path.scan('/').count,
'wiki-container-type' => page.wiki.container.class.name
2020-07-28 23:09:34 +05:30
}
end
def show_enable_confluence_integration?(container)
container.is_a?(Project) &&
current_user&.can?(:admin_project, container) &&
!container.has_confluence?
end
2017-08-17 22:00:37 +05:30
end
2020-11-24 15:15:51 +05:30
2021-06-08 01:23:25 +05:30
WikiHelper.prepend_mod_with('WikiHelper')