[xwiki-devs] [Proposal] Handling document references in UIs?
Hi, We need a consistent way to handle document references in UIs. For example, on the rename template, the title is "Renaming <string serialization of a reference here>". Thus if the page is named "?." in the space "Main" for example we get: "Renaming Main.?\." Same for the wysiwyg editor's insert link dialog box (under the title we have the technical reference printed). Proposal ======= Since references are technical I don't think we should print them in the UI. Instead we should print its constituents: wiki, space, page (or just space, page when not in multiwiki or when handling a ref not from the current wiki). This is what Caty has done in the Search UI BTW. Thus I propose to reuse her idea and print this: wiki >> space >> page where >> is the HTML Å symbol. You can check visually what I mean here: http://playground.myxwiki.org/xwiki/bin/view/Main/WebSearch?text=test&x=0&y=... Thus applying this to the example above, we would have: "Renaming Main >> ?." And thus this removes the technical aspects: * no ":" or "." to separate wiki and space *no character escaping WDYT? Any other idea to achieve the same result ? Thanks -Vincent
Hello Vincent, I'm +1 only if we rationalize the breadcrumb at the same time. Currently the breadcrumb is already using the HTML Å symbol. having both document references and breadcrumb using this symbol would be a mistake in my opinion, as users would not understand the difference, and would mix one for the other. To sum up, I'm -1 if we don't have this global reflection that includes the breadcrumb. (I don't have yet ideas of how to handle both in a nice way, but I'll come back if I do) Regards, Jerome.
Hi,
We need a consistent way to handle document references in UIs.
For example, on the rename template, the title is "Renaming <string serialization of a reference here>". Thus if the page is named "?." in the space "Main" for example we get: "Renaming Main.?\." Same for the wysiwyg editor's insert link dialog box (under the title we have the technical reference printed).
Proposal =======
Since references are technical I don't think we should print them in the UI.
Instead we should print its constituents: wiki, space, page (or just space, page when not in multiwiki or when handling a ref not from the current wiki).
This is what Caty has done in the Search UI BTW. Thus I propose to reuse her idea and print this:
wiki >> space >> page
where >> is the HTML Å symbol.
You can check visually what I mean here: http://playground.myxwiki.org/xwiki/bin/view/Main/WebSearch?text=test&x=0&y=...
Thus applying this to the example above, we would have:
"Renaming Main >> ?."
And thus this removes the technical aspects: * no ":" or "." to separate wiki and space *no character escaping
WDYT? Any other idea to achieve the same result ?
Thanks -Vincent
_______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
On Mar 31, 2010, at 10:30 AM, Vincent Massol wrote:
Hi,
We need a consistent way to handle document references in UIs.
For example, on the rename template, the title is "Renaming <string serialization of a reference here>". Thus if the page is named "?." in the space "Main" for example we get: "Renaming Main.?\." Same for the wysiwyg editor's insert link dialog box (under the title we have the technical reference printed).
Proposal =======
Since references are technical I don't think we should print them in the UI.
Instead we should print its constituents: wiki, space, page (or just space, page when not in multiwiki or when handling a ref not from the current wiki).
This is what Caty has done in the Search UI BTW. Thus I propose to reuse her idea and print this:
wiki >> space >> page
where >> is the HTML Å symbol.
You can check visually what I mean here: http://playground.myxwiki.org/xwiki/bin/view/Main/WebSearch?text=test&x=0&y=...
Thus applying this to the example above, we would have:
"Renaming Main >> ?."
And thus this removes the technical aspects: * no ":" or "." to separate wiki and space *no character escaping
WDYT? Any other idea to achieve the same result ?
Another idea: have a rectangle box drawn with 3 internal boxes, each for a reference part (wiki, space, page). Thanks -Vincent
On 03/31/2010 11:30 AM, Vincent Massol wrote:
On Mar 31, 2010, at 10:30 AM, Vincent Massol wrote:
Hi,
We need a consistent way to handle document references in UIs.
For example, on the rename template, the title is "Renaming<string serialization of a reference here>". Thus if the page is named "?." in the space "Main" for example we get: "Renaming Main.?\." Same for the wysiwyg editor's insert link dialog box (under the title we have the technical reference printed).
Proposal =======
Since references are technical I don't think we should print them in the UI.
Instead we should print its constituents: wiki, space, page (or just space, page when not in multiwiki or when handling a ref not from the current wiki).
This is what Caty has done in the Search UI BTW. Thus I propose to reuse her idea and print this:
wiki>> space>> page
where>> is the HTMLÅ symbol.
You can check visually what I mean here: http://playground.myxwiki.org/xwiki/bin/view/Main/WebSearch?text=test&x=0&y=...
Thus applying this to the example above, we would have:
"Renaming Main>> ?."
And thus this removes the technical aspects: * no ":" or "." to separate wiki and space *no character escaping
WDYT? Any other idea to achieve the same result ?
+1. Maybe / would be good as a separator. It's respecting the directory/file separator, it's also used in the URLs. it's familiar.
Another idea: have a rectangle box drawn with 3 internal boxes, each for a reference part (wiki, space, page).
I don't like this. Boxes are visual only, and borders aren't really good at being suggestive. -- Sergiu Dumitriu http://purl.org/net/sergiu/
On Mar 31, 2010, at 12:50 PM, Sergiu Dumitriu wrote:
On 03/31/2010 11:30 AM, Vincent Massol wrote:
On Mar 31, 2010, at 10:30 AM, Vincent Massol wrote:
Hi,
We need a consistent way to handle document references in UIs.
For example, on the rename template, the title is "Renaming<string serialization of a reference here>". Thus if the page is named "?." in the space "Main" for example we get: "Renaming Main.?\." Same for the wysiwyg editor's insert link dialog box (under the title we have the technical reference printed).
Proposal =======
Since references are technical I don't think we should print them in the UI.
Instead we should print its constituents: wiki, space, page (or just space, page when not in multiwiki or when handling a ref not from the current wiki).
This is what Caty has done in the Search UI BTW. Thus I propose to reuse her idea and print this:
wiki>> space>> page
where>> is the HTMLÅ symbol.
You can check visually what I mean here: http://playground.myxwiki.org/xwiki/bin/view/Main/WebSearch?text=test&x=0&y=...
Thus applying this to the example above, we would have:
"Renaming Main>> ?."
And thus this removes the technical aspects: * no ":" or "." to separate wiki and space *no character escaping
WDYT? Any other idea to achieve the same result ?
+1.
Maybe / would be good as a separator. It's respecting the directory/file separator, it's also used in the URLs. it's familiar.
"/" would be ok too but provided it's displayed in a different color and appropriate spacing between reference parts and "/". I have the feeling Å provides less ambiguity since it cannot appear easily in a document name while "/" is common. Thanks -Vincent
Another idea: have a rectangle box drawn with 3 internal boxes, each for a reference part (wiki, space, page).
I don't like this. Boxes are visual only, and borders aren't really good at being suggestive.
-- Sergiu Dumitriu
On 03/31/2010 01:29 PM, Vincent Massol wrote:
On Mar 31, 2010, at 12:50 PM, Sergiu Dumitriu wrote:
On 03/31/2010 11:30 AM, Vincent Massol wrote:
On Mar 31, 2010, at 10:30 AM, Vincent Massol wrote:
Hi,
We need a consistent way to handle document references in UIs.
For example, on the rename template, the title is "Renaming<string serialization of a reference here>". Thus if the page is named "?." in the space "Main" for example we get: "Renaming Main.?\." Same for the wysiwyg editor's insert link dialog box (under the title we have the technical reference printed).
Proposal =======
Since references are technical I don't think we should print them in the UI.
Instead we should print its constituents: wiki, space, page (or just space, page when not in multiwiki or when handling a ref not from the current wiki).
This is what Caty has done in the Search UI BTW. Thus I propose to reuse her idea and print this:
wiki>> space>> page
where>> is the HTMLÅ symbol.
You can check visually what I mean here: http://playground.myxwiki.org/xwiki/bin/view/Main/WebSearch?text=test&x=0&y=...
Thus applying this to the example above, we would have:
"Renaming Main>> ?."
And thus this removes the technical aspects: * no ":" or "." to separate wiki and space *no character escaping
WDYT? Any other idea to achieve the same result ?
+1.
Maybe / would be good as a separator. It's respecting the directory/file separator, it's also used in the URLs. it's familiar.
"/" would be ok too but provided it's displayed in a different color and appropriate spacing between reference parts and "/". I have the feelingÅ provides less ambiguity since it cannot appear easily in a document name while "/" is common.
Yes, of course it should have spacing and secondary color. An alternative is the solidus ⁄ http://en.wikipedia.org/wiki/Solidus_%28punctuation%29
Thanks -Vincent
Another idea: have a rectangle box drawn with 3 internal boxes, each for a reference part (wiki, space, page).
I don't like this. Boxes are visual only, and borders aren't really good at being suggestive.
-- Sergiu Dumitriu
-- Sergiu Dumitriu http://purl.org/net/sergiu/
participants (3)
-
Jerome Velociter -
Sergiu Dumitriu -
Vincent Massol