LuchoWiki

Cosas que debería hacer más a menudo

User Tools

Site Tools


desarrollo:dokuwiki:plugin-powerlinks

plugin:powerlinks

Resumen

El plugin powerlinks1) extiende la sintaxis de enlaces externos en DokuWiki ([[http://dominio.tld/enlace|texto]]) para permitir acceder a algunas funcionalidades en el código de DokuWiki que no son normalmente accesibles desde la sintaxis.

Entre estas características están: enlaces al servidor, recuperar el nombre (título) de un enlace externo, determinar si el enlace externo es accesible, tooltip, nofollow y favicon.

Uso

El plugin sigue la misma sintaxis de enlaces de DokuWiki pero añade un parámetro o lista de parámetros requerida para diferenciarla de la sintaxis normal y no interferir con ella.

Por ejemplo:

Enlaces Externos:

Para crear un enlace externo a la página de el Team 24, el cual presentará automáticamente el título de la página y siempre abrirá en una nueva ventana:

[[http://team24chile.blogspot.com/|Team24|Página del Team 24|fetchname|target="_blank"|]]

Comparar un enlace externo normal:

Enlaces a Servidor: El siguiente enlace dirige a la sección de “Mochila” en nuestro mismo servidor de Alumnos de Informática. Este enlace es resuelto por el programa servidor web por lo que siempre estará correcto independiente que el servidor cambie de nombre o se use el protocolo HTTPS en vez de HTTP:

[[@/mochila/|Nuestra "Mochila"|doa|]]

Enlaces Interwiki:

Para crear un enlace externo al artículo de Nintendo en Wikipedia, el cual presentará como tooltip el nombre del artículo y abrirá en una nueva ventana:

[[wpes>Nintendo|Artículo de Nintendo||fetchname="tooltip"|doa]]

Este ejemplo está adaptado directamente de la página de DokuWiki sobre interwiki usando la wiki de C++:

[[cpp>stl:map:|C++ Reference on STL Maps|Ejemplo de Interwiki de C++|]]

Comparar un enlace interwiki normal:


El enlace a continuación apunta a la web del Grupo de Usuarios Gulix del cual formo parte; incorpora el favicon además de la recuperación automática de título, y presentará una ayuda visual en caso que la página no esté disponible; esta característica se llama “dead or alive”:

[[http://www.gulix.cl/|Gulix|Grupo de Linux de mi ciudad|doa|fetchname|favicon|]]

El siguiente enlace usa el modo “dead or alive”, pero dado que la web de destino no existe, siempre debiera mostrar la indicación visual de falla:

[[http://ryan.gulix.cl/lost-is-better-than-24.html|Página que no existe|doa|]]

Detalles

La construcción general de la sintaxis es como sigue:

Para enlaces externos:

[[http://www.dominio.tld/ruta/a/destino|Texto a mostrar|parametro1=valor1|parametro2=valor2|....|]]

Para enlaces al mismo servidor:

[[@/ruta/a/destino|Texto a mostrar|parametro1=valor1|parametro2=valor2|....|]]

Los parámetros aceptados por el plugin se muestran en la sección inferior.

Parametros

Parámetro Significado
title=“texto El subtítulo o “tooltip” que aparecerá al posar el ratón sobre el enlace; si no se especifica, se sigue la regla general de utilizar el texto de título como subtítulo.
target=… Determina la forma de abrir el enlace. Acepta los valores “_blank” o “blank” para abrir en una nueva ventana, y “_self” o “self” para abrir en la misma ventana. El valor por defecto es el que especifique la configuración de DokuWiki.
fetchname Si está presente, se recupera el título desde la página para mostrarlo como texto de título; si por alguna razón el texto no se puede recuperar y no se encuentra en caché, el título normal (obligatorio) se usa en su lugar.
doa Si está presente, se ejecuta una prueba para ver si la página web es accesible; en caso que la prueba de negativo, una indicación visual se presenta para indicar que la página no está disponible.

Fetchname

Cuando el parámetro fetchname se ha especificado, el plugin tratará de recuperar el título de la página web (como es especificado en las etiquetas <TITLE>…</TITLE>). Una vez recuperado el título es depositado en una cache'que se actualiza al menos cada 7 días.

Si se ha especificado el parámetro pero no se ha podido recuperar el título y no se encuentra en la caché, DokuWiki utilizará el título especificado en la sintaxis (el segundo parámetro del enlace) como si fuera un wikienlace normal.

Dead-or-Alive

Cuando el parámetro doa2) se ha especificado, el plugin tratará de determinar si es posible recuperar la página exitosamente. En caso de no ser posible, ya sea por un problema de resolución de DNS o un error de HTTP (como un 404), se mostrará un apoyo visual para indicar que la página no se encuentra disponible.

Favicon

TOBEDONE

Opciones de Configuración

TOBEDONE

Pruebas y Bugs

1)
nombre derivado de powertools
2)
“dead-or-alive”
desarrollo/dokuwiki/plugin-powerlinks.txt · Last modified: 20120526 10:53 (external edit)