Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-doc
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-doc@g.o
From: "Michael A. Smith" <michael@...>
Subject: Re: adding support for wikipedia links
Date: Sat, 02 Sep 2006 12:26:31 -0400
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


References:
adding support for wikipedia links
-- Mike Frysinger
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Re: adding support for wikipedia links
Next by thread:
Request for gentoo installer translation help
Previous by date:
Re: 2006.1 Handbooks Status
Next by date:
Request for gentoo installer translation help


Updated Jun 17, 2009

Summary: Archive of the gentoo-doc mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.