'' debido a que no es compatible con el mecanismo de cache para el elemento incluido (sidebar o menu), ver [[doku>template:arctic#enhancementwork_with_span_class_curid]]; de todos modos aparece [[doku>plugin:navilevel#tip|esta mención en la página del plugin navilevel]]. Tendríamos que ver si vale la pena sacrificar las ventajas del cache para nuestro caso.
==== "Speaking" block navigation ====
=== El concepto ===
En el artículo [[http://www.smashingmagazine.com/2008/02/26/navigation-menus-trends-and-examples/|Navigation Menus: Trends and Examples]] de Smashing Magazine se describe una técnica que me gusta, consistente en agregar unas palabras descriptivas al texto de cada ítem de un menú de navegación. Un buen ejemplo se ve en http://lonnroth.info/:
{{:notas:lonnroth.png|}}
/* Navigation */
#nav {
list-style: none;
width: 475px;
background: #3d2e2a;
overflow: hidden;
margin-left: 310px;
padding-left: 10px;
}
#nav li {
width: 155px;
float: left;
}
#nav li a.active {
outline: none;
}
#nav li a {
display: block;
text-decoration: none;
text-transform: uppercase;
font-size: 0.70em;
font-weight: normal;
color: #806650;
padding: 15px 0 15px 10px;
}
#nav li a strong {
display: block;
color: #f5e4cc;
font-size: 1.31em;
}
#nav li a:hover {
background: url('img/nav.gif') 0 0 repeat-x;
}
=== En DokuWiki ===
Queremos lograr esto en el wiki, preferentemente con el mecanismo de navegación que venimos usando: la topbar del [[doku>template:simple]]. Lo único que necesitamos es poder insertar formato (//strong//) dentro del texto de un link. No parece trivial, dado que el parser ignora formato dentro de un link, e.g. no podemos poner ''%%[[.:|**Bold text** normal text]]%%'' y obtener "Bold text" en negrita, aunque sí funciona esto: ''%%**[[.:|Bold text]]**%%''. Oficialmente, "The image formatting is the only formatting syntax accepted in link names." (fuente: [[doku>syntax]]).
Caminos posibles:
* Afectar (mediante plugin?) el comportamiento del parser para que permita formato en linksde manera general (tal vez tocando la class Doku_Parser_Mode_internallink en parser.php)
* Crear un plugin que defina una sintaxis específica para links con formato.
* Aplicar una solución ad hoc para el template que usamos; p.ej. un simple reemplazo con una expresión regular sobre el xhtml de la topbar:
php > $xhtml = 'Link **bold** text';
php > print $xhtml;
Link **bold** text
php > print preg_replace('/\*\*([^<]+)\*\*/','$1',$xhtml);
Link bold text
php > $xhtml = '
Esto último funciona bien.
==== Omitir sidebar con navi menu en "start" ====
2009-04-07. Luego de examinar el sitio con Paula Coscia, nos pareció conveniente que la portada de cada sección (e.g. ''gente:start'') no incluya la barra lateral con el menú de navegación asociado a esa sección (o namespace), y que ese menú aparezca como contenido de la página. Para lograrlo hay que hacer algunas modificaciones, no sé bien en qué partes del código.
Una primera y sucia solución, sin alterar el código, se puede lograr con CSS, ocultando el menú para páginas específicas. Para esto necesitamos poder reconocer la página "start" mediante el atributo id o class del body.
FIXME
==== Plugin alphaindex ====
2009-05-07: probé el [[doku>plugin:alphaindex]] para mostrar un índice de las materias en el namespace //guias:materias// de la Biblioteca.
FIXME El orden alfabético pone "é" antes que "a".
===== Tips varios =====
* En ''main.php'' del template, los atributos ''id'' que generamos llevan un doble guión bajo (''%%__%%''), para evitar posibles conflictos con los ''id'' que DokuWiki genera automáticamente para las secciones de una página; éstos nunca pueden contener ''%%__%%'' (tomado de [[doku>devel:css]]).
* En ''main.php'' del template añadir al ''body'' un atributo ''class='do_'.$ACT'' HECHO
===== Blog =====
Aplicar background al container del post en la lista de posts, ''''. ¿Imagen de fondo?
===== Favicons =====
Deberíamos tener un favicon por cada subsitio. Modificar ''main.php'' del template.
===== Direcciones de email =====
Ver cómo esconderlas. La opción [[doku>config:mailguard]] no parece suficiente protección (Sebastián prefiere reCaptcha). Ver en el foro http://forum.dokuwiki.org/thread/2167
En Wikipedia: [[wp>Address_munging]].
===== Formularios =====
Vamos a necesitar incluir algunos formularios en páginas específicas (además de los formularios para comentarios en el blog u otras páginas).
Ejemplos:
* Sugerencias sobre la biblioteca y sus servicios
* Pedidos: compra de libros, copias de artículos
* Consultas: búsquedas de información, etc.
Ver [[doku>plugin:bureaucracy]].
===== Sección para uso interno (staff) =====
El sitio tendrá una sección para ser leída y usada solamente por el personal de la Biblioteca. Si queremos que un link a esta sección aparezca en el menú principal de navegación, pero que sólo sea visible para usuarios logueados con permiso, habrá que investigar cómo hacerlo (los links que ponemos en ''topbar'' aparecen siempre, apunten o no a páginas de acceso público).
===== Experimento con wiki farm =====
Siguiendo las indicaciones de [[doku>tips:farm2]] estuve haciendo unas pruebas con una //granja de wikis//.
Esta es la estructura de carpetas para las pruebas:
~/www/html/dokufarm
/farm
/animal1.wikifarm.localhost <= datos del wiki "animal1"
/conf
/data
/animal2.wikifarm.localhost <= datos del wiki "animal2"
/conf
/data
/farmer <= el wiki maestro
/bin
/conf <= sólo se usa al crear nuevos animales
/data <= idem
/inc
/lib
/doku.php
Usé el setup basado en virtual hosts. Para eso, aprendí a [[http://ubuntuforums.org/showthread.php?p=3637593|crear subdominios de localhost]]. La línea inicial del archivo ''/etc/hosts'' queda así:
127.0.0.1 localhost wikifarm.localhost animal1.wikifarm.localhost animal2.wikifarm.localhost
Para dar de alta los virtual hosts en Apache, creo el archivo ''/etc/apache2/sites-available/dokuwiki-farm'':
NameVirtualHost *:80
ServerName wikifarm.localhost
ServerAlias *.wikifarm.localhost
DocumentRoot "/home/fernando/www/html/dokufarm/farmer/"
Order allow,deny
Allow from all
Options -Indexes
AllowOverride AuthConfig FileInfo Limit
y en el directorio ''/etc/apache2/sites-enabled/'' creo este link simbólico:
dokuwiki-farm -> ../sites-available/dokuwiki-farm
Luego de reiniciar Apache, tengo que ajustar los parámetros en ''preload.php'', y luego visito el animal1 (habiendo creado previamente la carpeta asociada):
http://animal1.wikifarm.localhost/
que me redirecciona a
http://animal1.wikifarm.localhost/doku.php
Si visito el animal2:
http://animal2.wikifarm.localhost/doku.php
(antes de crear el directorio correspondiente a animal2), recibo el mensaje:
DokuWiki Setup Error
Sorry! This Wiki doesn't exist!
Para crear el animal2 uso el script de [[doku>tips:farm2#using_a_script_to_setup_farms]]. (De paso, en ese script cambié cada uso incorrecto de "farm" por "animal".)
Resultado exitoso. Instalé dos templates en ''dokufarm/farmer/lib/tpl'', y ya tengo dos animales, cada uno con su propio template.
A partir de la versión 2009-02-14 de DokuWiki, el archivo ''conf/local.php'' del animal no necesita la línea
@include(DOKU_CONF.'local.protected.php');
pues ''inc/init.php'' se encarga de ese include.
===== Cómo encajar el OPAC en DokuWiki =====
Ver la página [[:opacmarc_en_dokuwiki]].
===== Feeds =====
Para generación de feeds desde DokuWiki, ver [[doku>syndication]], [[doku>plugin:feed]], [[doku>tips:blogging#feed_setup]]