InterWiki = “Entre Wikis”
El concepto original de Interwiki es el de una Wiki distribuida sobre la red; sin embargo ha evolucionado para convertirse en vez de eso, en una forma cómoda de enlazar de una wiki a otra utilizando una sintaxis simple.
En Dokuwiki esto se logra anteponiendo los destinos de los enlaces con un atajo especial delimitado por el caracter >
(“mayor que”).
Ejemlos:
[[wp>Wiki]] enlaza al artículo "Wiki" en la Wikipedia en Inglés [[google>Wiki]] enlaza a una búsqueda en Google [[go>dokuwiki]] parecido al anterior, pero directo al primer resultado (Voy a Tener Suerte) [[doku>es:interwiki]] enlaza a esta página
Un atajo especialmente reservado es la palabra clave this
. Esta palabra clave siempre enlaza al directorio del servidor sobre el cual DokuWiki está instalado. De esta forma es posible construir URL relativas.
Observa el siguiente ejemplo para enlazar siempre al feed XML local: feed.php — el formato es [[this>feed.php]]
Más información sobre el concepto de Interwiki:
Los atajos InterWiki están definidos en el archivo conf/interwiki.conf
. El archivo por defecto contiene las reglas de InterWikis utilizadas en la instalación de DokuWiki que usa como base los atajos en http://usemod.com/intermap.txt. Para construir tus propias reglas puedes copiar el archivo a una copia local llamada conf/interwiki.local.conf
, de modo que tus cambios no se pierdan al reinstalar o actualizar DokuWiki.
Para colocar tus propios iconos a los enlaces InterWiki, simplemente copia tu icono a un archivo llamado de la misma forma que la palabra clave a la carpeta lib/images/interwiki
. Los iconos deben tener el formato PNG o GIF y una resolución de 16×16 pixeles.
El formato del archivo de configuración de InterWiki es como sigue:
<atajo> <regla>
Donde atajo
es la palabra clave que quieres utilizar para definir el enlace InterWiki, y regla
es la construcción de la URL resultante, utilizando variables especialmente definidas de esta tabla:
Variable | Contenido |
---|---|
{URL} | Wikinombre de la URL |
{NAME} | Wikinombre sin codificación (la parte que es agregada a la URL en interwiki.local.conf ) |
{SCHEME} | schema si una URL ha sido entregada como wikinombre |
{HOST} | host si una URL ha sido entregada como wikinombre |
{PORT} | puerto si una URL ha sido entregada como wikinombre |
{PATH} | ruta si una URL ha sido entregada como wikinombre |
{QUERY} | consulta si una URL ha sido entregada como wikinombre |
Los últimos cinco parámetros son útiles para crear enlaces InterWiki a sistemas de caché. Para observar su uso chequea el atajo coral
en el archivo conf/interwiki.conf
(por defecto en DokuWiki).
Por ejemplo, los usuarios de Dokuwiki en Español quizá quieran agregar un enlace InterWiki a la Wikipedia en Español a su colección de enlaces InterWiki:
conf/interwiki.local.conf
wpes http://es.wikipedia.org/wiki/
Para actualizar el icono:
lib/images/interwiki/
wp.gif
a wpes.gif
.data/cache/
. Más información y consejos