[xwiki-devs] [Proposal] Rendering Link Syntax Take 2
Hi devs, Sorry for the numerous mails on this topic. I've been struggling a bit in choosing the best solution with the caveats brought by wikimodel. So here's my latest proposal that replaces all previous ones on the link topic: 1) General link syntax: [[label>>reference]] or [[label||reference]] Note1: I've removed the need for parameters, see below. Note2: I'm suggesting double character separators since if we allow wiki syntax in link labels we need to easily differentiate the separator from a character typed in the label. Same reason why we doubled [[ ]], **, //, etc. characters. We could still use single characters (open question, I'm not sure about double chars) since people are not meant to write tons of text in link labels. OTOH it's consistent with our usage of double chars everywhere else (but it breaks current habits of the single char for links). 2) Links with parameters: (% param1=value1 paramN=valueN %)[[label>>reference]] 3) Links with wiki syntax for the label: [[**bold** link>>reference]] [[{{velocity}}...{{/velocity}}>>reference]] [[{{image:...}}>>reference]] <-- image link <OT> Note: For the image link we'll still need to decide if we want a macro for inserting an image or use wiki syntax but that's a topic that is now dissociated from the link topic: [[{{image:my.png}}>>reference]] or [[image:my.png>>reference </OT> Last for those wondering, I've found a solution to make this work with wikimodel and I've discovered Doxia supported wiki syntax in link labels, hence why I'm resurrecting the idea of having wiki syntax in links which is a way superior solution. Thanks -Vincent
On Mon, Oct 6, 2008 at 12:41 PM, Vincent Massol <[email protected]> wrote:
Hi devs, 1) General link syntax: [[label>>reference]] or [[label||reference]]
+0. I'd be +1 for [[label|reference]] : [pro] it's a common syntax [pro] | is imho less likely to be used than > in a wiki page name. [con] | may be harder to type on some keyboards.
2) Links with parameters:
(% param1=value1 paramN=valueN %)[[label>>reference]]
+1: [pro] good to have a single way of defining parameters. [con] seems like a complex syntax but it's ok since it's not supposed to be used frequently.
3) Links with wiki syntax for the label:
[[**bold** link>>reference]] [[{{velocity}}...{{/velocity}}>>reference]] [[{{image:...}}>>reference]] <-- image link
Big +1
Last for those wondering, I've found a solution to make this work with wikimodel and I've discovered Doxia supported wiki syntax in link labels, hence why I'm resurrecting the idea of having wiki syntax in links which is a way superior solution.
Good news ! :) Thanks, JV.
On Oct 6, 2008, at 3:28 PM, Jean-Vincent Drean wrote:
On Mon, Oct 6, 2008 at 12:41 PM, Vincent Massol <[email protected]> wrote:
Hi devs, 1) General link syntax: [[label>>reference]] or [[label||reference]]
+0.
I'd be +1 for [[label|reference]] : [pro] it's a common syntax [pro] | is imho less likely to be used than > in a wiki page name. [con] | may be harder to type on some keyboards.
... And it's completely unreadable. Try to read the above with the l of label... ;) Anyway the idea is not to change the separator. The question was more whether we use a single char or double char separator.
2) Links with parameters:
(% param1=value1 paramN=valueN %)[[label>>reference]]
+1: [pro] good to have a single way of defining parameters. [con] seems like a complex syntax but it's ok since it's not supposed to be used frequently.
Yep that's the point.
3) Links with wiki syntax for the label:
[[**bold** link>>reference]] [[{{velocity}}...{{/velocity}}>>reference]] [[{{image:...}}>>reference]] <-- image link
Big +1
Last for those wondering, I've found a solution to make this work with wikimodel and I've discovered Doxia supported wiki syntax in link labels, hence why I'm resurrecting the idea of having wiki syntax in links which is a way superior solution.
Good news ! :)
Thanks -Vincent
+1 for all Vincent Massol wrote:
Hi devs,
Sorry for the numerous mails on this topic. I've been struggling a bit in choosing the best solution with the caveats brought by wikimodel.
So here's my latest proposal that replaces all previous ones on the link topic:
1) General link syntax: [[label>>reference]] or [[label||reference]]
Note1: I've removed the need for parameters, see below. Note2: I'm suggesting double character separators since if we allow wiki syntax in link labels we need to easily differentiate the separator from a character typed in the label. Same reason why we doubled [[ ]], **, //, etc. characters. We could still use single characters (open question, I'm not sure about double chars) since people are not meant to write tons of text in link labels. OTOH it's consistent with our usage of double chars everywhere else (but it breaks current habits of the single char for links).
2) Links with parameters:
(% param1=value1 paramN=valueN %)[[label>>reference]]
3) Links with wiki syntax for the label:
[[**bold** link>>reference]] [[{{velocity}}...{{/velocity}}>>reference]] [[{{image:...}}>>reference]] <-- image link
<OT> Note: For the image link we'll still need to decide if we want a macro for inserting an image or use wiki syntax but that's a topic that is now dissociated from the link topic: [[{{image:my.png}}>>reference]] or [[image:my.png>>reference </OT>
Last for those wondering, I've found a solution to make this work with wikimodel and I've discovered Doxia supported wiki syntax in link labels, hence why I'm resurrecting the idea of having wiki syntax in links which is a way superior solution.
Thanks -Vincent
_______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
On Mon, Oct 6, 2008 at 12:41 PM, Vincent Massol <[email protected]> wrote:
Hi devs,
Sorry for the numerous mails on this topic. I've been struggling a bit in choosing the best solution with the caveats brought by wikimodel.
So here's my latest proposal that replaces all previous ones on the link topic:
1) General link syntax: [[label>>reference]] or [[label||reference]]
Note1: I've removed the need for parameters, see below. Note2: I'm suggesting double character separators since if we allow wiki syntax in link labels we need to easily differentiate the separator from a character typed in the label. Same reason why we doubled [[ ]], **, //, etc. characters. We could still use single characters (open question, I'm not sure about double chars) since people are not meant to write tons of text in link labels. OTOH it's consistent with our usage of double chars everywhere else (but it breaks current habits of the single char for links).
+0 i don't think ">" or "|" is used a lot in pages names
2) Links with parameters:
(% param1=value1 paramN=valueN %)[[label>>reference]]
+1 always better to have same way to define parameters IMO
3) Links with wiki syntax for the label:
[[**bold** link>>reference]] [[{{velocity}}...{{/velocity}}>>reference]] [[{{image:...}}>>reference]] <-- image link
++1
<OT> Note: For the image link we'll still need to decide if we want a macro for inserting an image or use wiki syntax but that's a topic that is now dissociated from the link topic: [[{{image:my.png}}>>reference]] or [[image:my.png>>reference </OT>
Last for those wondering, I've found a solution to make this work with wikimodel and I've discovered Doxia supported wiki syntax in link labels, hence why I'm resurrecting the idea of having wiki syntax in links which is a way superior solution.
Thanks -Vincent
_______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
-- Thomas Mortagne
On Mon, Oct 6, 2008 at 3:34 PM, Thomas Mortagne <[email protected]> wrote:
On Mon, Oct 6, 2008 at 12:41 PM, Vincent Massol <[email protected]> wrote:
Hi devs,
Sorry for the numerous mails on this topic. I've been struggling a bit in choosing the best solution with the caveats brought by wikimodel.
So here's my latest proposal that replaces all previous ones on the link topic:
1) General link syntax: [[label>>reference]] or [[label||reference]]
Note1: I've removed the need for parameters, see below. Note2: I'm suggesting double character separators since if we allow wiki syntax in link labels we need to easily differentiate the separator from a character typed in the label. Same reason why we doubled [[ ]], **, //, etc. characters. We could still use single characters (open question, I'm not sure about double chars) since people are not meant to write tons of text in link labels. OTOH it's consistent with our usage of double chars everywhere else (but it breaks current habits of the single char for links).
+0 i don't think ">" or "|" is used a lot in pages names
"labels" and not "pages names" of course
2) Links with parameters:
(% param1=value1 paramN=valueN %)[[label>>reference]]
+1 always better to have same way to define parameters IMO
3) Links with wiki syntax for the label:
[[**bold** link>>reference]] [[{{velocity}}...{{/velocity}}>>reference]] [[{{image:...}}>>reference]] <-- image link
++1
<OT> Note: For the image link we'll still need to decide if we want a macro for inserting an image or use wiki syntax but that's a topic that is now dissociated from the link topic: [[{{image:my.png}}>>reference]] or [[image:my.png>>reference </OT>
Last for those wondering, I've found a solution to make this work with wikimodel and I've discovered Doxia supported wiki syntax in link labels, hence why I'm resurrecting the idea of having wiki syntax in links which is a way superior solution.
Thanks -Vincent
_______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
-- Thomas Mortagne
-- Thomas Mortagne
+1 for everything. Vincent Massol wrote:
Hi devs,
Sorry for the numerous mails on this topic. I've been struggling a bit in choosing the best solution with the caveats brought by wikimodel.
So here's my latest proposal that replaces all previous ones on the link topic:
1) General link syntax: [[label>>reference]] or [[label||reference]]
Note1: I've removed the need for parameters, see below. Note2: I'm suggesting double character separators since if we allow wiki syntax in link labels we need to easily differentiate the separator from a character typed in the label. Same reason why we doubled [[ ]], **, //, etc. characters. We could still use single characters (open question, I'm not sure about double chars) since people are not meant to write tons of text in link labels. OTOH it's consistent with our usage of double chars everywhere else (but it breaks current habits of the single char for links).
2) Links with parameters:
(% param1=value1 paramN=valueN %)[[label>>reference]]
3) Links with wiki syntax for the label:
[[**bold** link>>reference]] [[{{velocity}}...{{/velocity}}>>reference]] [[{{image:...}}>>reference]] <-- image link
<OT> Note: For the image link we'll still need to decide if we want a macro for inserting an image or use wiki syntax but that's a topic that is now dissociated from the link topic: [[{{image:my.png}}>>reference]] or [[image:my.png>>reference </OT>
Last for those wondering, I've found a solution to make this work with wikimodel and I've discovered Doxia supported wiki syntax in link labels, hence why I'm resurrecting the idea of having wiki syntax in links which is a way superior solution.
Thanks -Vincent
_______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
Vincent Massol wrote:
Hi devs,
Sorry for the numerous mails on this topic. I've been struggling a bit in choosing the best solution with the caveats brought by wikimodel.
So here's my latest proposal that replaces all previous ones on the link topic:
1) General link syntax: [[label>>reference]] or [[label||reference]]
+1. Of course, [[reference]] should also work, right?
2) Links with parameters:
(% param1=value1 paramN=valueN %)[[label>>reference]]
+1
3) Links with wiki syntax for the label:
[[**bold** link>>reference]] [[{{velocity}}...{{/velocity}}>>reference]] [[{{image:...}}>>reference]] <-- image link
+1 -- Sergiu Dumitriu http://purl.org/net/sergiu/
On Oct 6, 2008, at 3:41 PM, Sergiu Dumitriu wrote:
Vincent Massol wrote:
Hi devs,
Sorry for the numerous mails on this topic. I've been struggling a bit in choosing the best solution with the caveats brought by wikimodel.
So here's my latest proposal that replaces all previous ones on the link topic:
1) General link syntax: [[label>>reference]] or [[label||reference]]
+1. Of course, [[reference]] should also work, right?
yes
2) Links with parameters:
(% param1=value1 paramN=valueN %)[[label>>reference]]
+1
3) Links with wiki syntax for the label:
[[**bold** link>>reference]] [[{{velocity}}...{{/velocity}}>>reference]] [[{{image:...}}>>reference]] <-- image link
+1
Thanks -Vincent
+1 to all. On Mon, Oct 6, 2008 at 4:11 PM, Vincent Massol <[email protected]> wrote:
Hi devs,
Sorry for the numerous mails on this topic. I've been struggling a bit in choosing the best solution with the caveats brought by wikimodel.
So here's my latest proposal that replaces all previous ones on the link topic:
1) General link syntax: [[label>>reference]] or [[label||reference]]
Note1: I've removed the need for parameters, see below. Note2: I'm suggesting double character separators since if we allow wiki syntax in link labels we need to easily differentiate the separator from a character typed in the label. Same reason why we doubled [[ ]], **, //, etc. characters. We could still use single characters (open question, I'm not sure about double chars) since people are not meant to write tons of text in link labels. OTOH it's consistent with our usage of double chars everywhere else (but it breaks current habits of the single char for links).
2) Links with parameters:
(% param1=value1 paramN=valueN %)[[label>>reference]]
3) Links with wiki syntax for the label:
[[**bold** link>>reference]] [[{{velocity}}...{{/velocity}}>>reference]] [[{{image:...}}>>reference]] <-- image link
<OT> Note: For the image link we'll still need to decide if we want a macro for inserting an image or use wiki syntax but that's a topic that is now dissociated from the link topic: [[{{image:my.png}}>>reference]] or [[image:my.png>>reference </OT>
Last for those wondering, I've found a solution to make this work with wikimodel and I've discovered Doxia supported wiki syntax in link labels, hence why I'm resurrecting the idea of having wiki syntax in links which is a way superior solution.
Thanks -Vincent
_______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
+1 for all. Vincent Massol wrote:
Hi devs,
Sorry for the numerous mails on this topic. I've been struggling a bit in choosing the best solution with the caveats brought by wikimodel.
So here's my latest proposal that replaces all previous ones on the link topic:
1) General link syntax: [[label>>reference]] or [[label||reference]]
Note1: I've removed the need for parameters, see below. Note2: I'm suggesting double character separators since if we allow wiki syntax in link labels we need to easily differentiate the separator from a character typed in the label. Same reason why we doubled [[ ]], **, //, etc. characters. We could still use single characters (open question, I'm not sure about double chars) since people are not meant to write tons of text in link labels. OTOH it's consistent with our usage of double chars everywhere else (but it breaks current habits of the single char for links).
2) Links with parameters:
(% param1=value1 paramN=valueN %)[[label>>reference]]
3) Links with wiki syntax for the label:
[[**bold** link>>reference]] [[{{velocity}}...{{/velocity}}>>reference]] [[{{image:...}}>>reference]] <-- image link
<OT> Note: For the image link we'll still need to decide if we want a macro for inserting an image or use wiki syntax but that's a topic that is now dissociated from the link topic: [[{{image:my.png}}>>reference]] or [[image:my.png>>reference </OT>
Last for those wondering, I've found a solution to make this work with wikimodel and I've discovered Doxia supported wiki syntax in link labels, hence why I'm resurrecting the idea of having wiki syntax in links which is a way superior solution.
-- Artem Melentyev
participants (8)
-
Artem Melentyev -
Asiri Rathnayake -
Jean-Vincent Drean -
Jerome Velociter -
Marius Dumitru Florea -
Sergiu Dumitriu -
Thomas Mortagne -
Vincent Massol