Tabla de Contenidos

Pasos
Migración de articulos desde MediaWiki
Traducciones
Interfaz, CSS
Permisos
Templates
Problemas encontrados
Mantenimiento
Bugs
crontab para actualizar la blacklist
Notas para una charla sobre DokuWiki

Instalación y configuración de Dokuwiki - Octubre de 2006

Servidor: Linux (biblioteca central)

catalis.uns.edu.ar Port 80

PHP 4.3.4 ATENCION: dice en el sitio de DokuWiki que “Because of some security issues [http://secunia.com/advisories/13481/] PHP 4.3.10 or higher is strictly recommended.”

Apache 1.3.29 (ATENCION: la versión más actual de Apache 1.3 es 1.3.37)

Leer requerimientos: http://wiki.splitbrain.org/wiki%3Arequirements

Versión de Dokuwiki: rc2006-09-28

Pasos

obtención del archivo dokuwiki-rc2006-09-28.tgz
cd htdocs
tar -xzvf dl/dokuwiki-rc2006-09-28.tgz ⇒ crea el directorio dokuwiki-rc2006-09-28
renombramos: mv dokuwiki-rc2006-09-28 dokuwiki
ll dokuwiki

drwxr-xr-x    2 catalis  catalis      4096 Sep 28 17:22 bin
drwxr-xr-x    2 catalis  catalis      4096 Sep 28 17:22 conf
-rw-r--r--    1 catalis  catalis     17992 Sep 28 17:22 COPYING
drwxr-xr-x    8 catalis  catalis      4096 Sep 28 17:22 data
-rw-r--r--    1 catalis  catalis      2027 Sep 28 17:22 doku.php
-rw-r--r--    1 catalis  catalis      6105 Sep 28 17:22 feed.php
drwxr-xr-x    6 catalis  catalis      4096 Sep 28 17:22 inc
-rw-r--r--    1 catalis  catalis       185 Sep 28 17:22 index.php
-rw-r--r--    1 catalis  catalis     14984 Sep 28 17:22 install.php
drwxr-xr-x    8 catalis  catalis      4096 Sep 28 17:22 lib
-rw-r--r--    1 catalis  catalis       264 Sep 28 17:22 README
-rw-r--r--    1 catalis  catalis        13 Sep 28 17:22 VERSION

Antes de proceder a la instalación, se recomienda leer un par de páginas sobre seguridad:

http://wiki.splitbrain.org/wiki:security
http://wiki.splitbrain.org/wiki:discussion:security

Edito el archivo conf/local.php

Muevo el directorio data a /home/catalis/dokuwiki-data (es un paso opcional)

ATENCION: esto hace que luego aparezca un error en el instalador!

Siguen otras recomendaciones, leerlas con atención (safe_mode, open_basedir, chown, etc)

Accedo a http://catalis.uns.edu.ar/dokuwiki/install.php ⇒ Internal Server Error

El problema está causado por el archivo .htaccess. Algo se explica en http://wiki.splitbrain.org/wiki:install_old

Comentando estas líneas (que son para impedir que se acceda a los .htaccess)

	<Files ~ "^[\._]ht">
  		Order allow,deny
  		Deny from all
  		Satisfy All
	</Files>

el problema desaparece. Y si quiero acceder al .htaccess

	http://catalis.uns.edu.ar/dokuwiki/.htaccess

el servidor responde:

	Forbidden
		You don't have permission to access /dokuwiki/.htaccess on this server.

así que todo bien.

Ahora hay que ajustar los permisos. El usuario asociado al servidor web (apache en RedHat, www-data en Ubuntu) necesita permiso de escritura en los directorios data (siempre) y conf (para instalación y configuración). Como apache está en el grupo catalis (`groups apache`), usamos chmod -R g+w sobre los directorios data y conf.

Hay un error del instalador relacionado con el directorio data. Lo muevo de $HOME a su ubicación original, y el error desaparece. Ahora sólo queda este error:

	For security reasons this script will only work with a new and unmodified Dokuwiki installation.
	You should either re-extract the files from the downloaded package or consult the complete Dokuwiki
	installation instructions

    * {DOCUMENT_ROOT}//dokuwiki/conf/local.php already exists

¿Entonces para qué me pidieron que edite local.php?

Retiro local.php, y ahora ya no quedan errores, aparece el formulario donde me piden nombre del wiki, datos del super-usuario, y la política de ACL inicial (elijo la opción “pública”; las otras son “abierta” y “cerrada”). Aquí es donde me permite elegir un idioma para la interfaz.

Responde con “Super-usuario - ilegal o valor vacío” si uso “Fernando”, pero anda bien si uso “fernando”.

“La configuración ha concluido exitosamente. Usted ahora puede eliminar el archivo install.php.”

La página inicial del wiki es http://catalis.uns.edu.ar/dokuwiki/doku.php, y lleva el nombre “start”.

Debo ingresar para poder hacer modificaciones.

Al solicitar los cambios recientes, aparece este mensaje:

	Warning: file(/var/www/html/catalis/dokuwiki/data/meta/_dokuwiki.changes): failed to open stream:
	No such file or directory in /var/www/html/catalis/dokuwiki/inc/changelog.php on line 107

¿Quizás debiera haber un archivo _dokuwiki.changes inicialmente vacío?

Estudiar URL Rewriting, http://wiki.splitbrain.org/wiki:rewrite

ATENCION:

rw-r–r– 1 apache apache 252 Oct 7 17:21 local.php

El archivo ahora sólo puede ser escrito por apache, de modo que no puedo modificarlo por fuera de la web, usando el Administrador de configuración.

Migración de articulos desde MediaWiki

Al script mediawiki2dokuwiki.sh le hice algunas correcciones, y aún faltan otras.

“ ::” se convierte en listas… (ver scripts .bat)

Generación del OPAC ⇒ REVISAR

Reordenamiento de campos y subcampos ⇒ IMAGENES

Modifiqué ./inc/geshi/dos.php para que resalte en DOS los comentarios que comienzan con :: pero no anduvo.

Revisar las firmas.

Traducciones

Hay varios textos que necesitan revisión en su versión en castellano.

ATENCION: antes de enviarlos, controlar la versión más reciente de la traducción.

OJO: El template Monobook no tiene traducción.

Este es un índice sobre todas las páginas disponibles ordenado por namespaces.
Traza (breadcrumb)
Has olvidado tu contraseña? Obten una nueva.
Login
¡Actualmente no estás identificado! Introduce abajo tus datos de identificación para abrir una sesión. Necesitas tener las cookies activadas para identificarte.
Conectado como : Fernando Gómez (sobra un espacio, y… ¿por qué me muestra el nombre real en vez del nombre de usuario?)
Puedes crearlo usando el botón Crea esta página. (pero el botón dice “Crear esta página”)
E-Mail ⇒ Email (en otras partes dice Correo electrónico)
otra vez ⇒ Otra vez
tareas de administración disponibles en Dokuwiki. ⇒ DokuWiki.
comprender completamente cómo funcionan el control de acceso.
Mira syntax para sintaxis Wiki. Por favor edita la página solo si puedes mejorarla. Si quieres testear algunas cosas aprende a dar tus primeros pasos en el playground.
Permitir debug deshabilítelo si no lo necesita!
Reveal full path of pages in the footer
Ofuscar direcciones de correo electrónico (?)
Edad máxima para archivos de lock (segundos)
Check for updates and security warnings? DokuWiki needs to contact splitbrain.org for this feature.
How many recent changes to keep (days)
Compression method for attic files
Borrador guardado automáticamente en 2006/10/08 12:01
Recuerda: no está guardado todavía!
eliminar el borrador guardado automáticament o cancelar
Para volver a una revisión antigua seleccionala de abajo
Notify user
New users will be added to the default group (user) if no group is specified.
Notification emails are only sent if the user is given a new password.
Confirma tu nueva contraseña: debe decir “contraseña actual” (current password)
Este tema no existe todavía (en general, el uso de “tema” con el sentido de “página” no me convence)
Revisiones Antiguas (título de página) vs. Revisiones anteriores (botón)
Tamañao máximo
Edita el resumen (Edit summary) ⇒ resumen de la edición

Interfaz, CSS

El nombre del wiki se ve en color muy claro. Quiero una imagen.
El botón “Cambios recientes” está muy cerca de la casilla de búsqueda.
Revisar los botoncitos del pie de página, en particular Licencia y Donación.
Ejemplos de interfaces modificadas: http://www.astro.ru.nl/lopes/doku.php
Agregar a GESHI: resaltado de PFT. Ver http://qbnz.com/highlighter/geshi-doc.html#language-files

Permisos

¿Cómo proteger ciertas páginas? Quizás ubicándolas en un namespace al cual se le apliquen restricciones.

Templates

Instalé monobook (versión del 07-oct-2006). Primer problema: al usar la casilla de búsquedas me envía a:

http://catalis.uns.edu.ar/wiki/doku.php?do=search&id=agrep&fulltext=Search

y la respuesta es:

 Not Found -- The requested URL /wiki/doku.php was not found on this server.

Donde dice “wiki” debe decir “dokuwiki”.

Interesante: http://tatewake.com/wiki/projects:multitemplate_for_dokuwiki

Multitemplate for DokuWiki, “allows you to use multiple templates in one DokuWiki installation, based on what the path to any particular page begins with.”

Hay varios templates que permiten el uso de una sidebar para mejorar la navegación.

Ver http://literalsystems.com/

Problemas encontrados

Al registrarse un nuevo usuario, no le llega la contraseña por mail (Claudia).

Modifiqué la config: $conf['autopasswd'] = 0

Igualmente, en la pantalla “Registro como nuevo usuario” dice: “Asegúrate que escribes una dirección de e-mail válida y que allí se enviará tu contraseña.”

Estudiar qué se necesita para que el wiki pueda enviar mails.

Marcado de definition lists? http://wiki.splitbrain.org/plugin:definitions

Mantenimiento

http://wiki.splitbrain.org/wiki:tips:maintenance

actualización periódica de la lista de spammers: wget http://blacklist.chongqed.org/ -O conf/wordblock.conf (ver abajo cómo lo hago con crontab)

backup de data y conf (añadir a crontab). Ver http://tatewake.com/wiki/projects:backuptool_for_dokuwiki y http://wiki.splitbrain.org/wiki:tips:backup_script

Cómo hacer actualizaciones: http://wiki.splitbrain.org/wiki:install:upgrade

cómo recibir UPGRADE notifications?

Bugs

geshi, en página “Crear una base MARC con registros de LC”, resaltado de “que queremos incorporar a la base”

página “instalacion_de_opacmarc”, clic en el botón “menos reciente »”, queda vacío el parámetro id, y entonces me muestra las revisiones viejas de Portada.

crontab para actualizar la blacklist

    [~/htdocs/dokuwiki]$ crontab -e
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    
    # ------------- minute (0 - 59)
    # | ----------- hour (0 - 23)
    # | | --------- day of month (1 - 31)
    # | | | ------- month (1 - 12)
    # | | | | ----- day of week (0 - 6) (Sunday=0)
    # | | | | |
    # * * * * * command to be executed
    
    # actualiza la lista negra anti-spam día por medio (o días pares?) a las 7:00 am
    0 7 */2 * * cd ~/htdocs/dokuwiki; wget http://blacklist.chongqed.org/ -O conf/wordblock.conf
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

RECIBO AVISO POR MAIL:

[~/htdocs/dokuwiki]$ mail
Mail version 8.1 6/6/93.  Type ? for help.
"/var/spool/mail/catalis": 5 messages 3 new 5 unread
 U  1 root@sibuns.bcentral  Mon Oct  9 15:39  21/895   "Cron <catalis@sibuns> date"
 U  2 root@sibuns.bcentral  Mon Oct  9 15:47  21/895   "Cron <catalis@sibuns> date"
>N  3 root@sibuns.bcentral  Mon Oct  9 16:01  25/1209  "Cron <catalis@sibuns> cd ~/ht"
 N  4 root@sibuns.bcentral  Mon Oct  9 16:02  25/1209  "Cron <catalis@sibuns> cd ~/ht"
 N  5 root@sibuns.bcentral  Tue Oct 10 07:00  32/1570  "Cron <catalis@sibuns> cd ~/ht"
& 5
Message 5:
From catalis@sibuns.bcentral.uns.edu.ar  Tue Oct 10 07:00:04 2006
Date: Tue, 10 Oct 2006 07:00:00 -0300
From: root@sibuns.bcentral.uns.edu.ar (Cron Daemon)
To: catalis@sibuns.bcentral.uns.edu.ar
Subject: Cron <catalis@sibuns> cd ~/htdocs/dokuwiki; wget http://blacklist.chongqed.org/ -O conf/wordblock.conf
X-Cron-Env: <SHELL=/bin/sh>
X-Cron-Env: <HOME=/home/catalis>
X-Cron-Env: <PATH=/usr/bin:/bin>
X-Cron-Env: <LOGNAME=catalis>

--07:00:00--  http://blacklist.chongqed.org/
           => `conf/wordblock.conf'
Resolving proxy-http.uns.edu.ar... done.
Connecting to proxy-http.uns.edu.ar[200.49.224.88]:1280... connected.
Proxy request sent, awaiting response... 200 OK
Length: unspecified [text/plain]

    0K .......... .......... .......... .......... ..........   29.33 KB/s
   50K .......... .......... .......... .......... ..........   75.08 KB/s
  100K .......... .......... .......... .......... ..........  118.76 KB/s
  150K .                                                         1.21 MB/s

07:00:04 (54.15 KB/s) - `conf/wordblock.conf' saved [154869]

&

Notas para una charla sobre DokuWiki

El wiki de DokuWiki

http://wiki.splitbrain.org/wiki:dokuwiki

Descarga

http://www.splitbrain.org/projects/dokuwiki

WikiMatrix

http://www.wikimatrix.org/show/DokuWiki

Support

Documentación disponible (para usuarios y desarrolladores)

FAQ

http://wiki.splitbrain.org/wiki:faq

Flat Files

why flatfiles are better than databases for wikis of up to about 20,000 records

http://www.pmwiki.org/wiki/PmWiki/FlatFileAdvantages

Se pueden crear páginas copiando un .txt en el directorio deseado.

Config

http://wiki.splitbrain.org/wiki:config

Configuración local

Estructura de directorios, permisos

ver el tip 'fixperms.php'(make webserver created files writable by everyone)

Manual

http://wiki.splitbrain.org/wiki%3Amanual

Control de acceso (ACL)

ver también el tip 'IP-based ACLs'

métodos de autenticación (bases de datos?)

Templates

http://wiki.splitbrain.org/wiki:tpl:templates

Control del diseño usando CSS (cómo se organizan los css)

http://wiki.splitbrain.org/wiki:faq

Where are those nice footer buttons from? How can I create my own ones?

http://wiki.splitbrain.org/wiki:faq

Apache Error 500 (Internal Server Error)

causado por .htaccess

http://wiki.splitbrain.org/wiki:faq

Error sending password email

http://wiki.splitbrain.org/wiki:faq

How can I make some pages non-writable?

Syntax

http://wiki.splitbrain.org/wiki:syntax

Plugins

http://wiki.splitbrain.org/wiki:plugins

Algunos que me interesan:

Action: tag, discussion

Admin: pagemove, BackupTool

Syntax:
- Formatting: boxes, definitions, Hidden Comment, important par, info, note, etc
- Formatting Replacements: Source
- Markup Schemes: latexrender, Math Plugin, MathMulti
- Media: Amazon, Gallery, GNUPlot, ISBN
- Behavior: GOTO (Easily create redirects inside your wiki.)

Timelines? Ploticus?

Tips and Tricks

http://wiki.splitbrain.org/wiki:tips

Antispam

Cómo crear una página

Matenimiento, cronjobs: backup, lista antispam, upgrades, playground

multiple (separate) installations sharing the codebase (multisite/wikifarm)

http://www.freelists.org/archives/dokuwiki/06-2006/msg00089.html

http://www.freelists.org/archives/dokuwiki/06-2005/msg00293.html

Envío de mails

Importar y exportar datos (páginas), e.g. desde MediaWiki, Word, OpenOffice, HTML

Diferencias con MediaWiki

páginas de discusión, páginas de usuarios, protección de páginas, categorías,

redirección

dokuwiki