4 Sep
2008
4 Sep
'08
6:13 p.m.
On Sep 4, 2008, at 5:57 PM, Sergiu Dumitriu wrote:
The order in XWiki Syntax 1.0 is: label > reference > target
I'm proposing to keep that order but to replace target by a generic
list of parameters. Actually this proposal doesn't come out of the
void. It's the way it's handled by wikimodel and would be very
difficult to change.
My preference would have been what I had proposed earlier, i.e.:
[[wiki syntax here>reference>target]]
where wiki syntax can be any valid wiki syntax such as
[[{{image:my.png}}>reference]] or [[this is **bold**>reference]]
But this is not supported currently by wikimodel and Mikhail says it's
too hard to change for now. We could still do it but we'll have lots
of problems (which I can explain if someone is interested but it's a
bit lengthy) so right now I went to the path of least resistance and
which sounds good enough.
We
could also keep ':' as a generic separator, but it will require all
links to also include the wiki name.
Another more complex idea would be to have something like:
part1=value1:part2=value2:part3=value3...
For example:
space=Space:document=Doc:version=4.2
wiki
=
incubator:space
=
Some.Deep.Space:document=Doc:attachment=file.svg:attachmentVersion=1.4
space=SpaceName:document=DocName:attachment=archive.zip:path=/path/
inside/archive/index.html
Of course, this is the long version, and the short version, if the
part
name is not specified, is:
first part = wiki
second part = Space.document
third part = attachment
This all ties to the email I had sent about Document identity and how
to represent a document name.
However since this is for 1.6 final I wanted to do something simple to
start with that will use the current document naming, i.e.
wiki:Space.Page and just augment it to specify the attachment. We need
to think more about how we want to represent document names. I'll need
to read again the DocumentName and DocumentNameFactory email on this.
Anyway I'm currently finishing definitions lists so I won't have time
to work on this before tomorrow and I'll be busy on other things
tomorrow (independent of my good will) and till tuesday included so
this won't make it for 1.6M2 :(
Thus there's a risk this dosn't make it in 1.6, in which case it would
be for 1.7.
Thanks
-Vincent
Jean-Vincent Drean wrote:
> On Wed, Sep 3, 2008 at 9:38 PM, Vincent Massol <vincent(a)massol.net>
> wrote:
>> Hi,
>>
>> This has been slightly discussed in other thread but not clearly so
>> here's the clear proposal I'd like to implement:
>>
>> 1) Linking to an attachment:
>>
>> [[label>attachment:my.doc]] or simply [[attachment:my.doc]]
>
> Could we use "=" instead of ":" is already used for the wiki
prefix
> (as in xwiki:Main.WebHome) ?
The reference supports URI and what I'm proposing is to make
attachment an URI similar to mailto:xxx. So the delimiter symbol for
URIs is ":".
> To be able to write
[label>attachment=xwiki:Main.WebHome^my.doc]
>
>> 2) Image link:
>>
>> [[label>reference>image=my.png]] or simply
>> [[reference>image=my.png]]
>
> "reference" is a wiki page here ?
reference can be:
* a URI
* a URL
* a wiki page name
If so I'd
be in favor of keeping the target element as the last
element of the link : [[image=my.png>reference]].
I'm not sure about this, traditionally the target was the second
parameter, and I think it would be better to keep it that way: label,
target, extra parameters. >> [snip]
>>
>> Note 2: The value for attachment:xxx is an attachment name (as in
>> my.doc) or the qualified name of an attachment. I'm proposing
>> "wiki:space.page^attachment" for now.
>> Note 3: The value for image can be: a full URL, an image attachment
>> name (as in my.png) or the qualified name of the image as in:
>> "wiki:space.page^imagename" (same as above).
>
> I'm not a fan of "^" or "/" but I don't have any
suggestion, choices
> are very limited!
The reason I use ^ was only because this is what is used by Confluence
already. I'm open to any character.