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 |