[pmwiki-devel] Wiki links with title/alt text attribute

[John Rankin]

On 5/05/11 11:42 PM, Petko Yotov wrote:
> On Wednesday 04 May 2011 22:56:51, John Rankin wrote :
>> [[page name"alt text" | link text]] and [[link text ->  page name"alt
>> text"]] look and feel acceptable to me.
> In the past, there have been discussions about link titles and the preferred
> format was [[link | text | title ]]. It is written on the roadmap.
>
> Alternatively, there is a LinkTitles recipe that uses [[link | text (title)]]
> and hides the thing in parentheses much like the regular [[page (link)]] does.
>
> The external link titles feature [[http://link"title"|text]] always existed
> but was initially hidden because the $UrlLinkFmt didn't have the attribute
> title='\$LinkAlt'. It was for a long time documented how to enable it, and it
> is now enabled.
>
> The image alt/title text always existed like http://site/image.jpg"alt" or
> Attach:im.jpg"alt".
>
> That's why I said Monday, I don't know yet if and how the [[internal link
> "with  quotes"]] should or shouldn't be changed in the core.
>
> Petko
Thank you for clarifying the situation. All 3 markup options have merit.

With [[page link | text | title]] and [[page link | text (title)]]:

a) How would the -> link option work?

I assume [[text | title -> page link]] and [[text (title) -> page link]]

b) How would an author specify a title while using 'page link' as the text?

[[page link | | title]] and [[page link | (title)]] ??

[[ | title -> page link]] and [[(title) -> page link]] ??

In my local customisation, I chose to interpret [[page link"title"]] so 
that 'page link' becomes
the text, although a case can be made that the link text ought to 
include the "title" part.

One problem I found with [[page link"title" | text]] is if title 
contains (brackets). I have coded
these as numeric entities, as I couldn't see a simple way to fix this 
without modifying the
core. The main reason I chose [[page link"title" | text]] was for 
consistency with existing link
alt text markup.

If this thread continues, perhaps we should move it to pmwiki-users, as 
the discussion has
moved out of the coding arena.

Thanks again.

JR

-- 
John Rankin
Affinity Limited
T 64 4 495 3737
F 64 4 473 7991
M 021 RANKIN
john.rankin at affinity.co.nz
www.affinity.co.nz