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
1 Mike Frysinger wrote:
2 > often when i'm writing docs i like to throw in links to wikipedia as it
3 > contains a wealth of information that i dont even want to try to duplicate
4 >
5 > rather than having to do like <uri
6 > link="http://en.wikipedia.org/wiki/Foo">FOO</uri> all the time, would it be
7 > possible to get a new tag implemented ? say something like:
8 > <wikipedia topic="Foo">FOO</uri>
9 > -mike
10
11 A few people noted why they thought this wasn't a good idea. The salient points
12 as I saw them were:
13
14 - Jesse: "Imagine trying to find all the URI links in a document when every
15 domain has it's own tag."
16 - Xavier: "Besides, using your tag makes it impossible for translators to
17 link to the translated version when available."
18
19 Let me suggest an alternative:
20
21 <uri link="http://en.wikipedia.org/wiki/Foo">FOO</uri>
22 becomes
23 <uri preset="wikipedia">FOO</uri>
24
25 It remains a uri tag, but extensible. The authors could create a list of
26 Frequently Linked Sites as long as there's a simple transformation between the
27 text() of the uri tag and what the actual uri would turn out to be.
28
29 Now for the benefits:
30
31 - It's still a uri tag.
32 - Translators can simply tweak the transformation to point to the page in the
33 right language.
34 - It's flexible: if the author wants to add a new preset or tweak one, it's easy.
35
36 Peace,
37 Mike
38 --
39 gentoo-doc@g.o mailing list