Redmine

# redMine - project management software

# Copyright (C) 2008  Karl Heinz Marbaise

#

# This program is free software; you can redistribute it and/or

# modify it under the terms of the GNU General Public License

# as published by the Free Software Foundation; either version 2

# of the License, or (at your option) any later version.

# 

# This program is distributed in the hope that it will be useful,

# but WITHOUT ANY WARRANTY; without even the implied warranty of

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

# GNU General Public License for more details.

# 

# You should have received a copy of the GNU General Public License

# along with this program; if not, write to the Free Software

# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.

# This class is intended to do the conversion of trac wiki content

# into Redmine wiki content. This is needed cause 

# trac wiki and Redmine wiki have different markup languages.

module TracMigrate

  class TracWiki

    public

      # This will hold the renumbered ticket numbers

      # of trac.

      @@ticket_map = []

      def TracWiki.ticketmap(ticket, issue)

        @@ticket_map[ticket] = issue

      end

      def TracWiki.ticketmap

        return @@ticket_map

      end

      # This method will do the whole conversion between

      # trac wiki and Redmine wiki.

      #

      def TracWiki.wiki(text)

        # Titles

        text = text.gsub(/^(\=+)\s(.+)\s(\=+)/) {|s| "\nh#{$1.length}. #{$2}\n"}

        # External Links

        text = text.gsub(/\[(http[^\s]+)\s+([^\]]+)\]/) {|s| "\"#{$2}\":#{$1}"}

        text = linebreak(text)

        # Do ticket extractions and renumbering.

        text = ticket_links(text)

        # Do mailto extraction and conversion

        text = mailto_links(text)

        # Usual wiki links

        text = wiki_links(text)

        # Links to pages UsingJustWikiCaps

        text = text.gsub(/([^!]|^)(^| )([A-Z][a-z]+[A-Z][a-zA-Z]+)/, '\\1\\2[[\3]]')

        # Normalize things that were supposed to not be links

        # like !NotALink

        text = text.gsub(/(^| )!([A-Z][A-Za-z]+)/, '\1\2')

        # Do the changeset link conversion

        text = changeset_links(text)

        #Do the code highlighting stuff.

        text = code_highlighting(text)

        # emphasize etc.

        text = highlight(text)

        # different kind of lists.

        text = lists(text)

        # Table stuff

        text = tables(text)

        # Links to source area (repository browser in trac)

        text = source_links(text)

        # Links to versions in Redmine (trac milestones)

        text = milestone_links(text)

#TODO: Blockquotes ?

#TODO: http://trac.edgewall/wiki/WikiRestructuredText#BiggerReSTExample

      end

    private

      # This method will convert code highlighting

      # of trac where {{{ and }}} is used to separate

      # it from the usual wiki content.

      # The markers {{{ and }}} must be on separate lines

      # to indicate an code part. If they are

      # on the same line this is defined to create

      # text with monospace.

      #TODO: {{{Text}}} is currently not correctly converted!!! this is `monospace` too!

      # 

      def TracWiki.code_highlighting(text)

        # We would like to convert the Code highlighting too

        # This will go into the next line.

        shebang_line = false

        # Reguar expression for start of code

        pre_re = /^\{\{\{$/

        # Code hightlighing...

        shebang_re = /^\#\!([a-z]+)/

        # Regular expression for end of code

        pre_end_re = /^\}\}\}$/

        # Go through the whole text..extract it line by line

        text = text.gsub(/^(.*)$/) do |line|

          m_pre = pre_re.match(line)

          if m_pre

            line = '<pre>'

          else

            m_sl = shebang_re.match(line)

            if m_sl

              shebang_line = true

              line = '<code class="' + m_sl[1] + '">'

            end

            m_pre_end = pre_end_re.match(line)

            if m_pre_end

              line = '</pre>'

              if shebang_line

                line = '</code>' + line

              end

            end

          end

          line        

        end

      end

      # Things like _Text_ '''''AAA''''' etc. 

      #

      def TracWiki.highlight(text)

        # Highlighting

        # bold italic

        text = text.gsub(/'''''([^\s])/, '_*\1')

        # bold italic

        text = text.gsub(/([^\s])'''''/, '\1*_')

        # bold

        text = text.gsub(/'''/, '*')

        # italic

        text = text.gsub(/''/, '_')

        # underline.

        text = text.gsub(/__/, '+')

        # stike-through

        text = text.gsub(/~~/, '-')

        # monospace

        text = text.gsub(/`/, '@')

        # subscript

        text = text.gsub(/,,/, '~')

#TODO: superscript => CHECK HOW THIS IS DONE IN REDMINE

        #text = text.gsub(//, '~')

      end

      # The lists will be converted.

      #

      def TracWiki.lists(text)

        # Lists

        text = text.gsub(/^([ ]+)\* /) {|s| '*' * $1.length + " "}

#TODO: definition list => trac manual

#TODO: unordered lists (1. 2. etc.)

      end

      # This method will do the conversion of

      # all ticket entries.

      # Here we do a renumbering of the ticket

      # numbers into appropiate issue numbers of redmine.

      #

#TODO: Check the ticket re-writing in the first three cases; should be done too!

      def TracWiki.ticket_links(text)

        # Situations like the following:

        #      - [ticket:234 Text],[ticket:234 This is a test]

        # Hints: This is a little hack, cause in Redmine it seemed not to be 

        #        possible to have a link to an issue with different text like

        #        in Trac. So this uses the URL syntax to make a link to the 

        #        particular issue

        text = text.gsub(/\[ticket\:([^\ ]+)\ (.+?)\]/, '"\2":/issues/show/\1')

        # Situations like the following:

        #      - [ticket:234]

        text = text.gsub(/\[ticket\:([^\ ]+)\]/, '#\1')

        # Situations like:

        #      - ticket:1234

        #      - #1 is working cause Redmine uses the same syntax.

        text = text.gsub(/ticket\:([^\ ]+)/, '#\1')

        # Ticket number re-writing

        text = text.gsub(/#(\d+)/) do |s|

          if $1.length < 10

            @@ticket_map[$1.to_i] ||= $1

            "\##{@@ticket_map[$1.to_i] || $1}"

          else

            s

          end

        end

      end

      # This will convert the links to revisions

      # or in Subversion terms Changesets.

      #

      def TracWiki.changeset_links(text)

        # changeset links [123]

        text = text.gsub(/\[(\d+)\]/, 'r\1')

        # changeset:122

        text = text.gsub(/changeset\:(\d+)/, 'r\1')

        # r123 => r123 (No conversion needed.

        #text = text.gsub(/r(\d+)/, 'r\1')

      end

      # This method will do the conversion of mailto entries

      # in trac which will be converted to Redmine syntax.

      #

      def TracWiki.mailto_links(text)

        # Situations like:

        #      - [mailto:user@test.de]

        text = text.gsub(/\[mailto\:([^\ ]+)\]/, '\1')

        #      - [mailto:user@test.de This is the text]

        #      - Here we use a hack to have a different text in relationship

        #        with an email address.

        text = text.gsub(/\[mailto\:([^\ ]+)\ (.+?)\]/, '"\2":mailto:\1')

      end

      # This will convert the milestone references from trac to redmine.

      #

      def TracWiki.milestone_links(text)

        # First Situation:

        #      - [milestone:"0.1.0 Mercury" Milestone 0.1.0 (Mercury)]

        # Hint: The text "Milestone 0.1.0 (Mercury)" is not converted,

        #      cause Redmine's wiki does not support this.

#TODO: May be we can use a hack to convert into something visual identical

        text = text.gsub(/\[milestone\:\"([^\"]+)\"\ (.+?)\]/, 'version:"\1"')

        # Second Situation:

        #      [milestone:"0.1.0 Mercury"]

        #       milestone:"0.1.2 Mercury"

        text = text.gsub(/\[milestone\:\"([^\"]+)\"\]/, 'version:"\1"')

        text = text.gsub(/milestone\:\"([^\"]+)\"/, 'version:"\1"')

        # Third Situation:

        #      [milestone:0.1.0]

        text = text.gsub(/\[milestone\:([^\ ]+)\]/, 'version:\1')

        # Forth situation:

        #      milestone:xyzabc

        text = text.gsub(/milestone\:([^\ ]+)/, 'version:\1')

      end

      # This will convert source code links. In trac

      # these are links to the repository browser.

      #

      def TracWiki.source_links(text)

        # Links to repository browser trac:   source:/some/path/file@123

        #                                     source:/some/path/file@123#L10

        # Example 1:

        #    [source:/tags/JAGOSI-0.0.10/jagosiapi/src/main/java/com/soebes/jagosi/api/JaGoSI.java@latest#L626 Line 626]

        text = text.gsub(/\[source\:(\/[a-zA-Z0-9_\/\.\-]+)(\@latest)#L(\d+) (.*?)\]/, 'source:\1#L\3')

        text = text.gsub(/\[source\:(\/[a-zA-Z0-9_\/\.\-]+)\@(\d+)#L(\d+) (.*?)\]/, 'source:\1@\2#L\3')

      end

      # The usual wiki links

      #

      def TracWiki.wiki_links(text)

        # ["Text" xxxxx]

        text = text.gsub(/\[\"(.+)\".*\]/) {|s| "[[#{$1.delete(',./?;|:')}]]"}

        # [wiki:"text text" more text]

        text = text.gsub(/\[wiki:\"(.+)\".*\]/) {|s| "[[#{$1.delete(',./?;|:')}]]"}

        # 

        text = text.gsub(/\[wiki:\"(.+)\".*\]/) {|s| "[[#{$1.delete(',./?;|:')}]]"}

        text = text.gsub(/\[wiki:([^\s\]]+)\]/) {|s| "[[#{$1.delete(',./?;|:')}]]"}

        text = text.gsub(/\[wiki:([^\s\]]+)\s(.*)\]/) {|s| "[[#{$1.delete(',./?;|:')}|#{$2.delete(',./?;|:')}]]"}

      end

      # This will convert the particular line breaks in trac

      # into simple line breaks.

      #

      def TracWiki.linebreak(text)

        # line break trac support both ways.

        text = text.gsub(/\[\[(BR|br)\]\]/, "\n") # This has to go before the rules below

      end

      # Currently we will only convert the simple

      # situation ||X||YY||ZZ||

      # Not converted will be: empty lines (trac will ignore them)

      # Formatting left, right alignment etc.

#TODO: Support alignment etc.

      def TracWiki.tables(text)

        # Tables

        text = text.gsub(/\|\|/, '|')

      end

  end

end