wiki/HowtoTracToMarkdown.md

---
title: Howto Trac to Markdown
...

Si on souhaite convertir des pages du format Trac vers le format Markdown un petit script peut faciliter la tâche.

~~~{.ruby}
#!/usr/bin/env ruby
## Based on: https://gist.github.com/619537

body = STDIN.read

body.gsub!(/\{\{\{([^\n]+?)\}\}\}/, '`\1`')
body.gsub!(/^\s*\*/, '*')
body.gsub!(/(\S)\n\* /, '\1' "\n\n* ")
body.gsub!(/^[ ]*\{\{\{/, '{{{')
body.gsub!(/(\S)\n\{\{\{/, '\1' "\n\n{{{")
body.gsub!(/\{\{\{(.+?)\}\}\}/m){|m| m.each_line.map{|x| "#{x}".gsub(/ *[\{\}]{3}/,"~~~")}.join}
body.gsub!(/\=\=\=\=\=\s(.+?)\s\=\=\=\=\=/, '##### \1')
body.gsub!(/\=\=\=\=\s(.+?)\s\=\=\=\=/, '#### \1')
body.gsub!(/\=\=\=\s(.+?)\s\=\=\=/, '### \1')
body.gsub!(/\=\=\s(.+?)\s\=\=/, '## \1')
body.gsub!(/\=\s(.+?)\s\=/, '# \1')
body.gsub!(/\[(https?[^\s\[\]]+)\s([^\[\]]+)\]/, '[\2](\1)')
body.gsub!(/([^(])(https?[^\s\[\]]+)/, '\1<\2>')
body.gsub!(/\!(([A-Z][a-z0-9]+){2,})/, '\1')
body.gsub!(/'''(.+?)'''/, '*\1*')
body.gsub!(/''(.+?)''/, '_\1_')
body.gsub!(/^\s\d\./, '1.')

# custom add-on for pedantic satisfaction
body.gsub!(/ *(\.){3,}/, '…')

STDOUT.write(body)
~~~

Copiez simplement ce script là où vous le souhaitez, rendez-le exécutable puis :

~~~{.bash}
$ cat Page.trac | trac2md
~~~

*Note* : le script ne gère pas une conversion parfaite, il faudra relire le document et faire quelques corrections manuelles (titre en "front matter Yaml", etc.). Patches welcome :)