From vincent@massol.net Thu Jan  6 12:59:59 2011
From: Vincent Massol <vincent@massol.net>
To: xwiki-users@xwiki.org
Subject: Re: [xwiki-users] syntax nuances
Date: Thu, 06 Jan 2011 12:59:26 +0100
Message-ID: <0CA49A86-9503-488E-BA3C-659D8EDF81DF@massol.net>
In-Reply-To: <4D25AD22.2010204@gmx.net>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="===============0699707909846386799=="

--===============0699707909846386799==
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable


On Jan 6, 2011, at 12:53 PM, Andreas Hahn wrote:

> Am 06.01.2011 11:11, schrieb Vincent Massol:
>=20
> Yesss - so now I can remove the ugly {{html}} <a href=3D"....> {{/hmtl}}=20
> from my wiki.
> Maybe just an example on the Syntax page might help.
>=20
> However I'm still struggling to find a better way for customizing the=20
> visual appearance of my wiki.
> I just learned by accident that the parameters of an image=20
> [[image:myimage.png||theParamter=3D"hi"]] will go unparsed into the=20
> resulting <img  .. theParameter=3D"hi" />. That wasn't obvious to me=20
> either but it means that customization with a class=3D"myImage" should be=20
> easily possible. Also the scope of the Parameter - statement "(%" isn't=20
> completely clear to me - it seems to work on the subsequent syntax=20
> element - but not for [[image:...]] or it renders a paragraph <p> but if=20
> you want to render a <span> you need to use {{html }}<span=20
> class=3D"myclass">text</span>{{/html}} - right ?

I've tried this on my local wiki:

[[(% class=3D"myclass" %)[[image:XWikiLogo.png||width=3D"25" height=3D"25"]]>=
>http://xwiki.org]]

And it generates:

<p><span class=3D"wikiexternallink"><a href=3D"http://xwiki.org"><span class=
=3D"myclass"><img src=3D"http://localhost:8080/xwiki/bin/download/Sandbox/Web=
Home/XWikiLogo.png?width=3D25&amp;height=3D25" width=3D"25" height=3D"25" alt=
=3D"XWikiLogo.png"/></span></a></span></p>=20

So as you can see it does generate a <span>.

Now if you want the params to apply to the img tag you need to pass them as i=
mage params:

[[[[image:XWikiLogo.png||width=3D"25" height=3D"25" class=3D"myclass"]]>>http=
://xwiki.org]]

which generates:

<p><span class=3D"wikiexternallink"><a href=3D"http://xwiki.org"><img src=3D"=
http://localhost:8080/xwiki/bin/download/Sandbox/WebHome/XWikiLogo.png?width=
=3D25&amp;height=3D25" width=3D"25" height=3D"25" class=3D"myclass" alt=3D"XW=
ikiLogo.png"/></a></span></p>

Hope it's clear.

Thanks
-Vincent

>=20
> Well I'm sort of casual user and it takes time finding out.
>=20
> thanks a lot
>=20
> Andreas
>=20
>> On Jan 6, 2011, at 11:09 AM, Vincent Massol wrote:
>>=20
>>> Hi Andreas,
>>>=20
>>> On Jan 6, 2011, at 10:59 AM, Andreas Hahn wrote:
>>>=20
>>>> Seems I haven't yet understood all the nuances of XWiki syntax:
>>>>=20
>>>> According to http://platform.xwiki.org/xwiki/bin/view/Main/XWikiSyntax
>>>>=20
>>>> I can have a sized image with [[image:img.png||width=3D"25" height=3D"25=
"]]
>>>> I can have an image with a link [[image:img.png>>http://xwiki.org]]
>>>>=20
>>>> How can I have a sized image with a link ?
>>>> not working:
>>>> [[image:img.png||width=3D"25" height=3D"25">>http://xwiki.org]]
>>> not correct
>>>=20
>>>> [[image:img.png>>http://xwiki.org||width=3D"25" height=3D"25"]]
>>> not correct either
>>>=20
>>> You need:
>>>=20
>>> [[[[image:img.png||width=3D"25" height=3D"25"]]>>http://xwiki.org]]
>> What you need to understand is that you have wiki syntax inside a link lab=
el
>>=20
>> In [[linklabelhere>>reference]], linklabelhere is wiki syntax.
>>=20
>> The wiki syntax to specify an image with params is [[image:...||params]].
>>=20
>> Please let us know how to fix the doc to make it more obvious.
>>=20
>> Thanks
>> -Vincent
>>=20
>>> Hope it helps,
>>> -Vincent
>>>=20
>>>> not working either (with and without 'px'):
>>>> (% style=3D"height:25px;width:25px" %)
>>>> [[image:img.png>>http://xwiki.org]]
>>>>=20
>>>> and
>>>> (% style=3D"height:25px;width:25px"
>>>> [[image:img.png>>http://xwiki.org]]
>>>> %)
>>>>=20
>>>> Hmmm... Once again I may not see the obvious ...
>>>> How can I do it ?
>>>>=20
>>>> Thanks
>>>>=20
>>>> Andreas

--===============0699707909846386799==--