instiki/app/models/chunks/wiki.rb

137 lines
4 KiB
Ruby
Raw Normal View History

2005-01-15 21:26:54 +01:00
require 'wiki_words'
require 'chunks/chunk'
require 'chunks/wiki'
2005-01-15 21:26:54 +01:00
require 'cgi'
# Contains all the methods for finding and replacing wiki related links.
2005-01-15 21:26:54 +01:00
module WikiChunk
include Chunk
# A wiki link is the top-level class for anything that refers to
# another wiki page.
class WikiLink < Chunk::Abstract
def self.apply_to(content)
content.gsub!( self.pattern ) do |matched_text|
chunk = self.new($~)
if chunk.textile_url?
# do not substitute
matched_text
else
content.chunks << chunk
chunk.mask(content)
end
end
end
def textile_url?
not @textile_link_suffix.nil?
end
2005-01-15 21:26:54 +01:00
# By default, no escaped text
def escaped_text() nil end
# Delimit the link text with markers to replace later unless
# the word is escaped. In that case, just return the link text
def mask(content) escaped_text || pre_mask + link_text + post_mask end
2005-01-21 23:28:37 +01:00
def regexp() /#{pre_mask}(.*)?#{post_mask}/ end
2005-01-15 21:26:54 +01:00
def revert(content) content.sub!(regexp, text) end
# Do not keep this chunk if it is escaped.
# Otherwise, pass the link procedure a page_name and link_text and
# get back a string of HTML to replace the mask with.
def unmask(content)
return nil if escaped_text
2005-01-21 23:28:37 +01:00
return self if content.sub!(regexp) do |match|
content.page_link(page_name, $1)
end
2005-01-15 21:26:54 +01:00
end
2005-01-15 21:26:54 +01:00
end
# This chunk matches a WikiWord. WikiWords can be escaped
# by prepending a '\'. When this is the case, the +escaped_text+
# method will return the WikiWord instead of the usual +nil+.
# The +page_name+ method returns the matched WikiWord.
class Word < WikiLink
2005-01-21 23:40:16 +01:00
unless defined? WIKI_LINK
WIKI_WORD = Regexp.new('(":)?(\\\\)?(' + WikiWords::WIKI_WORD_PATTERN + ')\b', 0, "utf-8")
2005-01-21 23:40:16 +01:00
end
2005-01-15 21:26:54 +01:00
def self.pattern
2005-01-21 23:40:16 +01:00
WIKI_WORD
2005-01-15 21:26:54 +01:00
end
attr_reader :page_name
def initialize(match_data)
super(match_data)
@textile_link_suffix, @escape, @page_name = match_data[1..3]
2005-01-15 21:26:54 +01:00
end
def escaped_text() (@escape.nil? ? nil : page_name) end
def link_text() WikiWords.separate(page_name) end
end
# This chunk handles [[bracketted wiki words]] and
# [[AliasedWords|aliased wiki words]]. The first part of an
# aliased wiki word must be a WikiWord. If the WikiWord
# is aliased, the +link_text+ field will contain the
# alias, otherwise +link_text+ will contain the entire
# contents within the double brackets.
#
# NOTE: This chunk must be tested before WikiWord since
# a WikiWords can be a substring of a WikiLink.
class Link < WikiLink
unless defined? WIKI_LINK
WIKI_LINK = /(":)?\[\[([^\]]+)\]\]/
LINK_TYPE_SEPARATION = Regexp.new('^(.+):((file)|(pic))$', 0, 'utf-8')
ALIAS_SEPARATION = Regexp.new('^(.+)\|(.+)$', 0, 'utf-8')
end
2005-01-21 22:58:48 +01:00
def self.pattern() WIKI_LINK end
2005-01-15 21:26:54 +01:00
attr_reader :page_name, :link_text, :link_type
2005-01-15 21:26:54 +01:00
def initialize(match_data)
super(match_data)
@textile_link_suffix, @page_name = match_data[1..2]
# defaults
@link_type = 'show'
@link_text = @page_name
separate_link_type
separate_alias
end
private
# if link wihin the brackets has a form of [[filename:file]] or [[filename:pic]],
# this means a link to a picture or a file
def separate_link_type
link_type_match = LINK_TYPE_SEPARATION.match(@page_name)
if link_type_match
@link_text = @page_name = link_type_match[1]
@link_type = link_type_match[2..3].compact[0]
end
end
# link text may be different from page name. this will look like [[actual page|link text]]
def separate_alias
alias_match = ALIAS_SEPARATION.match(@page_name)
if alias_match
@page_name, @link_text = alias_match[1..2]
2005-01-15 21:26:54 +01:00
end
# note that [[filename|link text:file]] is also supported
end
2005-01-15 21:26:54 +01:00
end
2005-01-15 21:26:54 +01:00
end