WikiCreole markup

[chuckssmith@…]

Hi, I just installed Trac and my development team would like to use the WikiCreole (www.wikicreole.org) markup in our project wiki. Are there any plans to make a parser for Creole? If not, would you please be able to develop it? Full specs can be found at http://www.wikicreole.org/wiki/Creole0.3 Thank you!

--Chuck Smith

[eblot]

There is no plan to change the Wiki syntax.

You may want to write a plugin to support an alternative syntax (see th:wiki:WikiStart#Request-a-Hack)

[mgood]

The Creole syntax seems pretty similar to what Trac already supports. The th:WikiGoodiesPlugin adds a bold and italics syntax similar to the one used in Creole, so you could use that as a basis for a plugin adding Creole-style bold and italics.

[cboos]

Yes, but that plugin only adds *bold* and /italic/ for single words. That could be extended to multiple words, but not across lines, as that spec says.

I've just gone through WikiCreole again, and I definitely think there are some good things that we can lift up from there:

• use "|" as another separator in labeled links (links)
• ... hm, well, that's about it ;)

For supporting **bold text** and //italic text//, the current workaround is simply to go and patch the Formatter, and edit those tokens appropriately, e.g.

formatter.py

@@ -151 +151 @@
     # Some constants used for clarifying the Wiki regexps:
 
     BOLDITALIC_TOKEN = "'''''"
-    BOLD_TOKEN = "'''"
-    ITALIC_TOKEN = "''"
+    BOLD_TOKEN = "**"
+    ITALIC_TOKEN = "//"
     UNDERLINE_TOKEN = "__"
     STRIKE_TOKEN = "~~"
     SUBSCRIPT_TOKEN = ",,"

It might even be interesting to see if we could have this notation in addition to the existing one.

[cboos]

... and support for line breaks in ticket descriptions and comments, for the reasons given there.

The links using double brackets [[... link ...]] could probably be supported as well, as it should be easy to distinguish them from macro calls.

[anonymous]

Replying to cboos:

For supporting **bold text** and //italic text//, the current workaround is

...

formatter.py

@@ -151 +151 @@
     # Some constants used for clarifying the Wiki regexps:
 
     BOLDITALIC_TOKEN = "'''''"
-    BOLD_TOKEN = "'''"
-    ITALIC_TOKEN = "''"
+    BOLD_TOKEN = r"\*\*"
+    ITALIC_TOKEN = "//"
     UNDERLINE_TOKEN = "__"
     STRIKE_TOKEN = "~~"
     SUBSCRIPT_TOKEN = ",,"

of course :P)

[cboos]

Adapt Trac WikiFormatting to be more compatible with WikiCreole

[cboos]

In attachment:trac_wiki_creole-r4428.patch:

• Bold And Italics compatibility
  • // and ** can be used as italic and bold markup, in addition to the existing ones '' and '''
  • they mix by pairs, e.g. you can't end a '' by a //.
• Links Internal And External compatibility
  • "|" can be used as a separator between the link and the label
  • simple square brackets or double square brackets can be used for links ([...] or [[...]])

All the existing wiki unit-tests still pass, so I think it's a good sign that this additions won't disturb existing Trac Wiki pages.

[cboos]

WikiEngine refactoring and related fixes postponed. At that point, the (full) WikiCreole support could be easily added as a plugin.

[fcorreia@…]

just listening...