LuchoWiki

Cosas que debería hacer más a menudo

User Tools

Site Tools


desarrollo:dokuwiki:trucos-metaheaders

Trucos con Metaheaders

El plugin plugin:metaheaders para DokuWiki es bastante útil, ya que permite incorporar metainformación y enlaces especiales en un documento en el momento en que es parseado por el servidor.

En esta página almaceno algunos trucos e ideas que se pueden incorporar en una página por medio del uso de este plugin. Todos los trucos aquí están bajo Creative Commons, pero sólo como una forma de atribución ya que de seguro alguien los habrá pensado antes de manera independiente (¡hola, Nikola Tesla!).

Requisitos

  1. Un editor de texto capaz de editar UTF-8.
  2. Seguir las instrucciones en la página del plugin para crear un archivo metaheaders.conf.

Enlaces Tipo Libro

:rarrow: Enlaces Relacionados

Estos enlaces permiten acceso a la página padre, servicio de búsqueda, índice y página de créditos de una web en la barra de navegación (por ejemplo en Opera) al mezclar algunas características de DokuWiki y el plugin indexmenu.

Saltar al Contenido

En un navegador web y una pantalla grande, resulta fácil acceder a la información que está en al página (más aún usando templates como Arctic, el plugin que usa este sitio). Sin embargo, al estar utilizando un dispositivo móvil, de modo texto o de pantalla reducida es necesario en cada página hacer scroll para saltarse las cabeceras y menús y así llegar al contenido.

Con el pequeño ajuste que aquí presento se evita ese problema al colocar en los enlaces del sitio un acceso directo al contenido, indicado por el primer encabezado (ver config:useheading). Este enlace no es normalmente visible en el navegador, pero en aquellos sistemas que utilicen enlaces header, como el navegador de texto Links y varios navegadores móviles como Fennec, se mostrará un enlace en la parte superior de la página, junto a los enlaces de índice y principales, con el mensaje “Saltar al Contenido” o similar. Al hacer clic en este enlace el cursor es llevado inmediatamente al contenido de la primera sección.

/* Agrega un vínculo de acceso rápido al contenido
 * para visualizadores móviles o de texto */
$fh = p_get_first_heading($ID);
$sID = '#'. @sectionID($fh);
$headers['link'][] = array(
    'rel' => 'content',
    'title' => 'Saltarse Menú',
    'href' => $sID
    );

[El enlace "saltar directo al contenido" en un navegador de texto como //Elinks//]

Para probar cómo funciona este truco, basta con visitar esta misma página con un navegador en modo texto. Yo recomiendo Links (disponible en varias distribuciones de Linux).

Botón de Edición Universal

Ver también: universaleditbutton.

Las versiones de desarrollo de DokuWiki integran la característica del “Botón de Edición Universal” que permite acceder al modo de edición de una plataforma tipo Wiki con solamente un clic (en un botón apropiadamente llamado “botón de edición universal”). Para mi versión de DokuWiki que aparentemente no integra esta característica un poco de código agregado al metaheaders.conf.php soluciona el problema:

if(($ACT == 'show' || $ACT == 'search') && $INFO['writable']){
     $head['link'][] = array( 
          'rel'=>'alternate',
          'title'=> $lang['btn_edit'],
          'type' => 'application/x-wiki',
          'href'=> wl($ID,'do=edit',false,'&')
     );
     }

El código está esencialmente copy-paste-ado desde inc/template.php y modificado para que utilice el tipo mime y relación de documento del BEU. Por tanto el botón será funcional en todas las instancias en las cuales se presente normalmente el botón “Editar esta página” de la plantilla, respetando permisos, modos de visualización, ACL, etcétera.

Al estar habilitada la característica, los navegadores que lo soporten anunciarán con un icono o aviso que la página tiene disponible un Modo de Edición. En el caso de Opera, esto es anunciado con un indicador de Widget:

[El enlace para el "Botón de Edición Universal" como se ve con el navegador [[http://www.opera.com/|Opera|fetchname="tooltip"|favicon|]], usando la extensión para UEB.]


desarrollo/dokuwiki/trucos-metaheaders.txt · Last modified: 20120526 10:53 (external edit)