====== 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) Order allow,deny Deny from all Satisfy All 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 date" U 2 root@sibuns.bcentral Mon Oct 9 15:47 21/895 "Cron date" >N 3 root@sibuns.bcentral Mon Oct 9 16:01 25/1209 "Cron cd ~/ht" N 4 root@sibuns.bcentral Mon Oct 9 16:02 25/1209 "Cron cd ~/ht" N 5 root@sibuns.bcentral Tue Oct 10 07:00 32/1570 "Cron 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 cd ~/htdocs/dokuwiki; wget http://blacklist.chongqed.org/ -O conf/wordblock.conf X-Cron-Env: X-Cron-Env: X-Cron-Env: X-Cron-Env: --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 {{tag>dokuwiki}}