Diferencias

Muestra las diferencias entre dos versiones de la página.


desarrollo:dokuwiki:trucos-metaheaders [2012/05/26 10:53] (actual) – creado - editor externo 127.0.0.1
Línea 1: Línea 1:
 +===== Trucos con Metaheaders =====
 +
 +El plugin [[doku>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, [[wpes>Nikola Tesla]]!).
 +
 +==== Requisitos ====
 +
 +  - El [[doku>plugin:metaheaders|plugin "metaheaders"]].
 +  - Un editor de texto capaz de editar UTF-8.
 +  - Seguir las instrucciones en la página del plugin para crear un archivo ''metaheaders.conf''.
 +
 +==== Enlaces Tipo Libro ====
 +
 +:rarrow: **[[booknav-links]]**
 +
 +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 [[doku>template:arctic|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 [[doku>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.
 +
 +
 +<code php>
 +/* 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
 +    );
 +</code>
 +
 +[{{:desarrollo:dokuwiki:xterm-skiptocontent.png?300&direct|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: [[doku>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:
 +
 +<code php>
 +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,'&')
 +     );
 +     }
 +</code>
 +
 +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 **[color=red]Opera[/color]**, esto es anunciado con un indicador de //Widget//:
 +
 +[{{ :desarrollo:dokuwiki:opera-ueb-widget.png|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.}}]
 +
 +
 +----
 +
 +{{tag>trucos dokuwiki}}