Gentoo Archives: gentoo-doc

From: "Michael A. Smith" <michael@××××××××.com>
To: gentoo-doc@l.g.o
Subject: Re: [gentoo-doc] adding support for wikipedia links
Date: Sat, 02 Sep 2006 16:28:37
Message-Id: 44F9B0B7.5070506@smith-li.com
In Reply to: [gentoo-doc] adding support for wikipedia links by Mike Frysinger
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