Mike Frysinger wrote:
> often when i'm writing docs i like to throw in links to wikipedia as it 
> contains a wealth of information that i dont even want to try to duplicate
> 
> rather than having to do like <uri 
> link="http://en.wikipedia.org/wiki/Foo">FOO</uri> all the time, would it be 
> possible to get a new tag implemented ?  say something like:
> <wikipedia topic="Foo">FOO</uri>
> -mike

A few people noted why they thought this wasn't a good idea. The salient points 
as I saw them were:

  - Jesse: "Imagine trying to find all the URI links in a document when every 
domain has it's own tag."
  - Xavier: "Besides, using your tag makes it impossible for translators to 
link to the translated version when available."

Let me suggest an alternative:

<uri link="http://en.wikipedia.org/wiki/Foo">FOO</uri>
becomes
<uri preset="wikipedia">FOO</uri>

It remains a uri tag, but extensible. The authors could create a list of 
Frequently Linked Sites as long as there's a simple transformation between the 
text() of the uri tag and what the actual uri would turn out to be.

Now for the benefits:

  - It's still a uri tag.
  - Translators can simply tweak the transformation to point to the page in the 
right language.
  - It's flexible: if the author wants to add a new preset or tweak one, it's easy.

Peace,
Mike
-- 
gentoo-doc@g.o mailing list