2014-09-02 18:07:02 +05:30
|
|
|
class ProjectWiki
|
|
|
|
include Gitlab::ShellAdapter
|
|
|
|
|
|
|
|
MARKUPS = {
|
2015-09-11 14:41:01 +05:30
|
|
|
'Markdown' => :md,
|
2015-04-26 12:48:37 +05:30
|
|
|
'RDoc' => :rdoc,
|
|
|
|
'AsciiDoc' => :asciidoc
|
|
|
|
} unless defined?(MARKUPS)
|
2014-09-02 18:07:02 +05:30
|
|
|
|
|
|
|
class CouldNotCreateWikiError < StandardError; end
|
|
|
|
|
|
|
|
# Returns a string describing what went wrong after
|
|
|
|
# an operation fails.
|
|
|
|
attr_reader :error_message
|
|
|
|
|
|
|
|
def initialize(project, user = nil)
|
|
|
|
@project = project
|
|
|
|
@user = user
|
|
|
|
end
|
|
|
|
|
|
|
|
def path
|
|
|
|
@project.path + '.wiki'
|
|
|
|
end
|
|
|
|
|
|
|
|
def path_with_namespace
|
|
|
|
@project.path_with_namespace + ".wiki"
|
|
|
|
end
|
|
|
|
|
|
|
|
def url_to_repo
|
|
|
|
gitlab_shell.url_to_repo(path_with_namespace)
|
|
|
|
end
|
|
|
|
|
|
|
|
def ssh_url_to_repo
|
|
|
|
url_to_repo
|
|
|
|
end
|
|
|
|
|
|
|
|
def http_url_to_repo
|
|
|
|
[Gitlab.config.gitlab.url, "/", path_with_namespace, ".git"].join('')
|
|
|
|
end
|
|
|
|
|
2016-01-19 16:12:03 +05:30
|
|
|
def wiki_base_path
|
|
|
|
["/", @project.path_with_namespace, "/wikis"].join('')
|
|
|
|
end
|
|
|
|
|
2014-09-02 18:07:02 +05:30
|
|
|
# Returns the Gollum::Wiki object.
|
|
|
|
def wiki
|
|
|
|
@wiki ||= begin
|
|
|
|
Gollum::Wiki.new(path_to_repo)
|
|
|
|
rescue Gollum::NoSuchPathError
|
|
|
|
create_repo!
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
def empty?
|
|
|
|
pages.empty?
|
|
|
|
end
|
|
|
|
|
|
|
|
# Returns an Array of Gitlab WikiPage instances or an
|
|
|
|
# empty Array if this Wiki has no pages.
|
|
|
|
def pages
|
|
|
|
wiki.pages.map { |page| WikiPage.new(self, page, true) }
|
|
|
|
end
|
|
|
|
|
|
|
|
# Finds a page within the repository based on a tile
|
|
|
|
# or slug.
|
|
|
|
#
|
|
|
|
# title - The human readable or parameterized title of
|
|
|
|
# the page.
|
|
|
|
#
|
|
|
|
# Returns an initialized WikiPage instance or nil
|
|
|
|
def find_page(title, version = nil)
|
|
|
|
page_title, page_dir = page_title_and_dir(title)
|
|
|
|
if page = wiki.page(page_title, version, page_dir)
|
|
|
|
WikiPage.new(self, page, true)
|
|
|
|
else
|
|
|
|
nil
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
def find_file(name, version = nil, try_on_disk = true)
|
|
|
|
version = wiki.ref if version.nil? # Gollum::Wiki#file ?
|
|
|
|
if wiki_file = wiki.file(name, version, try_on_disk)
|
|
|
|
wiki_file
|
|
|
|
else
|
|
|
|
nil
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
def create_page(title, content, format = :markdown, message = nil)
|
|
|
|
commit = commit_details(:created, message, title)
|
|
|
|
|
|
|
|
wiki.write_page(title, format, content, commit)
|
2015-11-26 14:37:03 +05:30
|
|
|
|
|
|
|
update_project_activity
|
2014-09-02 18:07:02 +05:30
|
|
|
rescue Gollum::DuplicatePageError => e
|
|
|
|
@error_message = "Duplicate page: #{e.message}"
|
|
|
|
return false
|
|
|
|
end
|
|
|
|
|
|
|
|
def update_page(page, content, format = :markdown, message = nil)
|
|
|
|
commit = commit_details(:updated, message, page.title)
|
|
|
|
|
|
|
|
wiki.update_page(page, page.name, format, content, commit)
|
2015-11-26 14:37:03 +05:30
|
|
|
|
|
|
|
update_project_activity
|
2014-09-02 18:07:02 +05:30
|
|
|
end
|
|
|
|
|
|
|
|
def delete_page(page, message = nil)
|
|
|
|
wiki.delete_page(page, commit_details(:deleted, message, page.title))
|
2015-11-26 14:37:03 +05:30
|
|
|
|
|
|
|
update_project_activity
|
2014-09-02 18:07:02 +05:30
|
|
|
end
|
|
|
|
|
|
|
|
def page_title_and_dir(title)
|
|
|
|
title_array = title.split("/")
|
|
|
|
title = title_array.pop
|
2015-04-26 12:48:37 +05:30
|
|
|
[title, title_array.join("/")]
|
|
|
|
end
|
|
|
|
|
|
|
|
def search_files(query)
|
|
|
|
repository.search_files(query, default_branch)
|
|
|
|
end
|
|
|
|
|
|
|
|
def repository
|
2015-09-11 14:41:01 +05:30
|
|
|
Repository.new(path_with_namespace, default_branch, @project)
|
2015-04-26 12:48:37 +05:30
|
|
|
end
|
|
|
|
|
|
|
|
def default_branch
|
|
|
|
wiki.class.default_ref
|
2014-09-02 18:07:02 +05:30
|
|
|
end
|
|
|
|
|
|
|
|
private
|
|
|
|
|
|
|
|
def create_repo!
|
|
|
|
if init_repo(path_with_namespace)
|
|
|
|
Gollum::Wiki.new(path_to_repo)
|
|
|
|
else
|
|
|
|
raise CouldNotCreateWikiError
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
def init_repo(path_with_namespace)
|
|
|
|
gitlab_shell.add_repository(path_with_namespace)
|
|
|
|
end
|
|
|
|
|
|
|
|
def commit_details(action, message = nil, title = nil)
|
|
|
|
commit_message = message || default_message(action, title)
|
|
|
|
|
2015-04-26 12:48:37 +05:30
|
|
|
{ email: @user.email, name: @user.name, message: commit_message }
|
2014-09-02 18:07:02 +05:30
|
|
|
end
|
|
|
|
|
|
|
|
def default_message(action, title)
|
|
|
|
"#{@user.username} #{action} page: #{title}"
|
|
|
|
end
|
|
|
|
|
|
|
|
def path_to_repo
|
|
|
|
@path_to_repo ||= File.join(Gitlab.config.gitlab_shell.repos_path, "#{path_with_namespace}.git")
|
|
|
|
end
|
2015-11-26 14:37:03 +05:30
|
|
|
|
|
|
|
def update_project_activity
|
|
|
|
@project.touch(:last_activity_at)
|
|
|
|
end
|
2014-09-02 18:07:02 +05:30
|
|
|
end
|