如何将现有的Redmine Wiki从Textile转换为Markdown？

Question

我想将Markdown作为我的Redmine wiki引擎。

我已经安装了Markdown插件，并且它运行良好。

唯一的问题是，如何将旧的维基（Textile格式）转换为Markdown格式，以便可以正确显示？

- hSATAC

Answer 1

由于这是一项一次性任务，为什么不使用pandoc -f textile -t markdown oldfile.text -o newfile.md呢？您可以在Try Pandoc上尝试。

- applicative

---

这是我首先想到的，但我在我的CentOS 5上无法执行cabal install cabal-install。下次我会再试一次。 - hSATAC

快速提示：如果有人正在使用Redmine CKEditor插件，则自1.0.18以来，所有版本都包括一个rake任务，允许指定源格式和目标格式。 - user909694

Answer 2

我写了一个rake任务，将所有wiki页面及其版本转换为markdown格式。

将以下内容放入lib/tasks/convert_textile_to_markdown.rake中：

task :convert_textile_to_markdown => :environment do
  require 'tempfile'
  WikiContent.all.each do |wiki|
    ([wiki] + wiki.versions).each do |version|
      textile = version.text
      src = Tempfile.new('textile')
      src.write(textile)
      src.close
      dst = Tempfile.new('markdown')
      dst.close

      command = [
        "pandoc",
        "--no-wrap",
        "--smart",
        "--strict",
        "-f",
        "textile",
        "-t",
        "markdown",
        src.path,
        "-o",
        dst.path,
      ]
      system(*command) or raise "pandoc failed"

      dst.open
      markdown = dst.read

      # remove the \ pandoc puts before * and > at begining of lines
      markdown.gsub!(/^((\\[*>])+)/) { $1.gsub("\\", "") }

      # add a blank line before lists
      markdown.gsub!(/^([^*].*)\n\*/, "\\1\n\n*")

      version.update_attribute(:text, markdown)
    end
  end
end

然后运行：

bundle exec rake convert_textile_to_markdown RAILS_ENV=production

- Michaël Witrant

---

在我的编辑文件名和 RAILS_ENV 后，这在 redmine 2.5.2 中运作得非常好。 - Jesper Grann Laursen

在我们的Redmine 2.6上无缝运行。我首先需要执行“apt-get install pandoc”。 - tvdeyen

这个很好用（在Windows上使用redmine 2.6.1.stable），但有一些小问题：

• 我必须安装pandoc，例如使用chocolatey：choco install pandoc
• 对于某些文件，pandoc失败了 - 我将raise "pandoc failed"更改为puts "pandoc failed"以忽略这些错误
• 使用符号*的项目列表包含行末的斜杠（\）

- qbik

Answer 3

在Michaël的回答的基础上，这里提供了一种从Textile迁移到Markdown的工具。它将迁移所有内容（评论、wiki、问题、消息、新闻、文档、项目和日志）。并且还会修复Redmine的Textile和pandoc之间的几个不兼容问题。

工具在这里：https://github.com/Ecodev/redmine_convert_textile_to_markown

- PowerKiKi

Answer 4

当我试图通过上面的pandoc命令（pandoc版本为1.12.4.2）将markdown文件转换为textile文件时，Redmine不能正确地显示CodeBlock。因此最好是在pre元素中写入CodeBlock。

原始代码如下：

~~~ % foo bar ~~~

转换后的代码如下：

bc. % foo bar % foo bar 无法在Redmine中以CodeBlock形式显示。

你应该事先将CodeBlock编写为pre元素。

代码如下：

<pre> % foo bar </pre>

- umiyosh

Answer 5

刚在一个带有 Ruby 2.6.6 的 Redmine 4.1.1 系统上使用了 redmine_reformat，看起来运行良好。但它目前不支持 Redmine 5.0。在我们的情况下，我们正在迁移到 Redmine 5.x，所以我们在 4.1.1 系统中进行了切换，删除了插件，然后再进行了迁移。

- Gary Aitken