Changes between Initial Version and Version 1 of FlexibleWikiPageNames

Timestamp:

Oct 17, 2005, 3:44:17 PM (19 years ago)

Author:

Christian Boos

Comment:

Proposal for easily customizable WikiPageNames rules

FlexibleWikiPageNames

@@ +1 @@
+= Flexible WikiPageNames =
+
+This page describes an experimental feature for having new custom-defined
+wiki page names conventions.
+
+The implementation can be found in the 
+[source:branches/cboos-dev/flexible-branch flexible] branch.
+
+Each alternate Wiki Syntax is presented by a `IWikiPageNamesSyntaxProvider`.
+By default, there are 3 WikiPageNames syntaxes to choose from.
+This can easily be setup in the `[components]` section from the TracIni.
+
+Furthermore, it makes it easy to take full control of the wiki page names syntax
+by writing an additional plugin.
+For example, this is what we use:
+{{{
+#!python
+class BctWikiPageNames(Component):
+    """Like FlexibleWikiPageNames, but:
+     * allow initial lower case letter
+     * allow anything after the slash "/"
+    """
+
+    implements(IWikiPageNameSyntaxProvider)
+
+    # IWikiPageNameSyntaxProvider methods
+
+    def get_wiki_page_names_syntax(self):
+        return (WIKI_START +
+                r"(?:[A-Z\d]{2,}[a-z]+"                          # 1st way
+                r"|[a-z]?[A-Z\d]+[a-z]+(?:/?[A-Z\d]+[a-z]*)+)" + # 2nd way
+                WIKI_TARGET + WIKI_END)
+
+}}}
+
+The `WIKI_START`, `WIKI_TARGET` and `WIKI_END` constants correspond
+to pieces of regular expressions that can be reused from syntax provider
+to syntax provider.
+