From: https://id.koumbit.net/anarcat Date: Sun, 4 Mar 2012 00:01:01 +0000 (-0400) Subject: rename wishlist/do_not_make_links_backwards.mdwn to todo/do_not_make_links_backwards... X-Git-Tag: 3.20120203~85 X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/commitdiff_plain/f6174572db65168ab00b15162a44163170a28846?hp=9b3c09143b04413d2c25d256a8bc9ccdd329f052 rename wishlist/do_not_make_links_backwards.mdwn to todo/do_not_make_links_backwards.mdwn --- diff --git a/doc/todo/do_not_make_links_backwards.mdwn b/doc/todo/do_not_make_links_backwards.mdwn new file mode 100644 index 000000000..5dbcc0a70 --- /dev/null +++ b/doc/todo/do_not_make_links_backwards.mdwn @@ -0,0 +1,19 @@ +[[!template id=gitbranch branch=anarcat/backwards_links author="[[anarcat]]"]] + +I understand this may be a bit provocative, but I strongly feel that ikiwiki linking rules are backwards. I come from the world of wikis like MoinMoin and [[plugins/contrib/mediawiki]], where you use `\[[link|description]]`. The defacto wiki markup "[[plugins/creole]]" also uses that convention, as does raw HTML (href comes first!). Ikiwiki doesn't: here we need to use `\[[description|link]]`. + +Everytime i come back to ikiwiki, i need to bend my mind backwards to create *proper* links. I understand that `\[[description|link]]` is more inline with Markdown's `[description](link)` approach, but in my mind it is too much of a problem for third part plugins to be a proper justification. For example, the [[plugins/creole]] plugin works pretty much as expected *expect* for links, because it can't override ikiwiki's internal link parser. For me that's a huge inconsistency that should be fixed. + +If there is an agreement within the community that we can change that, I am ready to work on a migration script or even a configuration variable... -- [[anarcat]] + +Dev notes +--------- + +I started looking into this, after encouraging words from Joey ("very long term roadmap", AKA "if someone does it"). It turns out it is less deeply rooted than i thought in the core of ikiwiki; everything being a plugin and all, this is also a plugin ([[plugins/link]]). + +The following needs to be done: + + 1. the `link_regexp` variable needs to be turned backwards (or frontwards, if you like :P) (./) added an option for this, needs testing + 2. a config setting need to be added to the `link` plugin so that we can choose if we want backwards links or not (./) `backwards_links`, how does that sound? + 3. a (solid!) parser needs to be written for [[ikiwiki-transition]] to change the actual links (if necessary) (!) still todo + 4. rewrite tests to take into account the two syntaxes diff --git a/doc/wishlist/do_not_make_links_backwards.mdwn b/doc/wishlist/do_not_make_links_backwards.mdwn deleted file mode 100644 index 5dbcc0a70..000000000 --- a/doc/wishlist/do_not_make_links_backwards.mdwn +++ /dev/null @@ -1,19 +0,0 @@ -[[!template id=gitbranch branch=anarcat/backwards_links author="[[anarcat]]"]] - -I understand this may be a bit provocative, but I strongly feel that ikiwiki linking rules are backwards. I come from the world of wikis like MoinMoin and [[plugins/contrib/mediawiki]], where you use `\[[link|description]]`. The defacto wiki markup "[[plugins/creole]]" also uses that convention, as does raw HTML (href comes first!). Ikiwiki doesn't: here we need to use `\[[description|link]]`. - -Everytime i come back to ikiwiki, i need to bend my mind backwards to create *proper* links. I understand that `\[[description|link]]` is more inline with Markdown's `[description](link)` approach, but in my mind it is too much of a problem for third part plugins to be a proper justification. For example, the [[plugins/creole]] plugin works pretty much as expected *expect* for links, because it can't override ikiwiki's internal link parser. For me that's a huge inconsistency that should be fixed. - -If there is an agreement within the community that we can change that, I am ready to work on a migration script or even a configuration variable... -- [[anarcat]] - -Dev notes ---------- - -I started looking into this, after encouraging words from Joey ("very long term roadmap", AKA "if someone does it"). It turns out it is less deeply rooted than i thought in the core of ikiwiki; everything being a plugin and all, this is also a plugin ([[plugins/link]]). - -The following needs to be done: - - 1. the `link_regexp` variable needs to be turned backwards (or frontwards, if you like :P) (./) added an option for this, needs testing - 2. a config setting need to be added to the `link` plugin so that we can choose if we want backwards links or not (./) `backwards_links`, how does that sound? - 3. a (solid!) parser needs to be written for [[ikiwiki-transition]] to change the actual links (if necessary) (!) still todo - 4. rewrite tests to take into account the two syntaxes