Difference between revisions of "Dokuwiki (Español)"

From ArchWiki
Jump to: navigation, search
(Instalación)
(Instalación de Plugins)
(10 intermediate revisions by the same user not shown)
Line 9: Line 9:
  
 
[http://www.dokuwiki.org/ ¿Le gustaría ver un ejemplo en funcionamiento?]
 
[http://www.dokuwiki.org/ ¿Le gustaría ver un ejemplo en funcionamiento?]
 
{{Nota|Dokuwiki usa una sintaxis muy similar a la de MediaWiki, aunque a diferencia de este software, la información se almacena en archivos de texto planos, por lo que no requiere el uso de una base de datos.}}
 
  
 
== Notas iniciales==  
 
== Notas iniciales==  
Line 27: Line 25:
  
 
Alternativamente, si desea puede realizar la instalación con el archivo .tgz, se puede instruir en http://www.dokuwiki.org/Install. Generalmente, el procedimiento es el mismo que el anterior. En lugar de usar pacman, tendrá que descargar el [http://www.splitbrain.org/projects/dokuwiki  archivo .tgz], descomprimirlo a la raíz del servidor para los documentos (por ejemplo, {{ic|/srv/http/dokuwiki}}) y ejecutar el comando chown para dar permisos al usuario adecuado (por ejemplo, "http").
 
Alternativamente, si desea puede realizar la instalación con el archivo .tgz, se puede instruir en http://www.dokuwiki.org/Install. Generalmente, el procedimiento es el mismo que el anterior. En lugar de usar pacman, tendrá que descargar el [http://www.splitbrain.org/projects/dokuwiki  archivo .tgz], descomprimirlo a la raíz del servidor para los documentos (por ejemplo, {{ic|/srv/http/dokuwiki}}) y ejecutar el comando chown para dar permisos al usuario adecuado (por ejemplo, "http").
 +
 +
== Configuración ==
 +
 +
=== Apache ===
 +
 +
En primer lugar, cree el archivo {{ic|/etc/httpd/conf/extra/dokuwiki.conf}} con el siguiente contenido:
 +
 +
{{bc|
 +
Alias /dokuwiki /usr/share/webapps/dokuwiki
 +
<Directory /usr/share/webapps/dokuwiki/>
 +
    Options +FollowSymLinks
 +
    AllowOverride All
 +
    order allow,deny
 +
    allow from all
 +
    php_admin_value open_basedir "/srv/http/:/home/:/tmp/:/usr/share/pear/:/usr/share/webapps/:/etc/webapps/dokuwiki/:/var/lib/dokuwiki/"
 +
</Directory>
 +
}}
 +
 +
Incluya el archivo recién creado en la configuración de Apache poniendo la siguiente línea al final de {{ic|/etc/httpd/conf/httpd.conf}}:
 +
{{bc|
 +
Include conf/extra/dokuwiki.conf
 +
}}
 +
 +
Asegúrese de que las carpetas {{ic|/etc/webapps/dokuwiki}} y {{ic|/var/lib/dokuwiki}} son propiedad del usuario y del grupo «http». Puede reubicar estos directorios si lo desea, siempre y cuando actualizar las referencias en {{ic|/etc/httpd/conf/extra/dokuwiki.conf}} respectivamente.
 +
 +
Después reinicie Apache:
 +
  # systemctl restart httpd.service
 +
 +
Por último, finalice la instalación ejecutando el script ''dokuwiki/install.php'' en su navegador.
  
 
===Configuración específica para lighttpd===
 
===Configuración específica para lighttpd===
  
Edite el archivo {{ic|/etc/lighttpd/lighttpd.conf}}  como se indica en [http://www.dokuwiki.org/install:instrucciones dokuwiki lighttpd] (puede contener información actualizada).
+
Edite el archivo {{ic|/etc/lighttpd/lighttpd.conf}}  como se indica en [https://www.dokuwiki.org/install:lighttpd dokuwiki en lighttpd] (puede contener información actualizada).
  
 
Bajo la línea:
 
Bajo la línea:
Line 39: Line 66:
 
</pre>
 
</pre>
  
añadir lo siguiente:
+
añada lo siguiente:
  
 
<pre>
 
<pre>
Line 60: Line 87:
 
</pre>
 
</pre>
  
''Estas entradas dan algo de seguridad básica para DokuWiki''. Lighttpd no usa archivos .htaccess como Apache. Se '''pueden''' instalar con en éste, pero '''no''' es recomendable.
+
''Estas entradas dan algo de seguridad básica para DokuWiki''. Lighttpd no usa archivos .htaccess como Apache. Se PUEDEN instalar con este, pero NO es recomendable.
 +
 
 +
{{bc|1=
 +
alias.url += ("/dokuwiki" => "/usr/share/webapps/dokuwiki/")
 +
}}
 +
Añada un alias en algún lugar de lighttpd o un archivo conf de fastcgi
  
 
Reinicie lighttp:
 
Reinicie lighttp:
   # /etc/rc.d/lighttpd restart
+
   # systemctl restart lighttpd
  
 
== Post-instalación==
 
== Post-instalación==
Line 72: Line 104:
 
   # rm /srv/http/dokuwiki/install.php
 
   # rm /srv/http/dokuwiki/install.php
  
===Instalación Plugins===
+
===Instalación de Plugins===
  
 
Muchos plugins creados por la comunidad se pueden encontrar [http://www.dokuwiki.org/plugins aquí]
 
Muchos plugins creados por la comunidad se pueden encontrar [http://www.dokuwiki.org/plugins aquí]
  
Se pueden añadir a través de la interfaz web (así como actualizarlos) a través del menú Admin.
+
Se pueden añadir a través de la interfaz web (así como actualizarlos) a través del menú Admin. Algunos plugins no se pueden descargar, si se quieren obtener a través de ssl (por ejemplo git). Descomente la siguiente línea en {{ic|/etc/php/php.ini}}:
 +
{{bc|1=
 +
extension=openssl.so
 +
}}
  
 
===Realizar copias de seguridad===  
 
===Realizar copias de seguridad===  
Line 82: Line 117:
 
Es muy trivial hacer copia de seguridad de DokuWiki, ya que no hay ninguna base de datos. Todas las páginas están en texto plano, y sólo requieren un simple tar, o rsync.
 
Es muy trivial hacer copia de seguridad de DokuWiki, ya que no hay ninguna base de datos. Todas las páginas están en texto plano, y sólo requieren un simple tar, o rsync.
  
Un rápido resumen de los directorios de interés en el actual versión (2012-01-25b):
+
Un rápido resumen de los directorios de interés en la actual versión (2012-01-25b):
 
   /dokuwiki/data/        => Todos los Datos creados por el usuario
 
   /dokuwiki/data/        => Todos los Datos creados por el usuario
 
   /dokuwiki/lib/plugins/  => Todos los Plugins añadidos por el usuario
 
   /dokuwiki/lib/plugins/  => Todos los Plugins añadidos por el usuario

Revision as of 13:33, 5 October 2013

"DokuWiki es un sistema de Wiki de uso sencillo y compatible con los estándares. Orientado a crear documentación de cualquier tipo dentro de grupos de desarrollo, grupos de trabajo y pequeñas empresas. Su sintaxis es simple y potente, facilita la creación de textos estructurados, y permite que los archivos generados sean legibles incluso fuera del Wiki. Todos los datos se guardan en archivos de texto plano, de tal forma que no se necesita base de datos para su funcionamiento."

"Las revisiones ilimitadas de páginas permiten, no obstante, la restauración a cualquier versión de la página anterior; y con los datos almacenados en archivos de texto plano, las bases de datos son innecesarias. Una arquitectura basada en plugins de gran variedad permite la ampliación y mejora del sistema central. Vea la sección de características para obtener una descripción completa de lo que DokuWiki puede ofrecerle". [1]

En otras palabras, DokuWiki es un Wiki escrito en PHP y no requiere base de datos.

¿Le gustaría ver un ejemplo en funcionamiento?

Notas iniciales

DokuWiki debería funcionar en cualquier servidor web que soporte PHP 5.1.2 o posterior. Dado que los requisitos pueden cambiar con el tiempo, debe consultar los requerimientos para DokuWiki a fin de obtener detalles adicionales.

Es muy recomendable que lea las secciones correspondientes a la seguridad de las páginas de Dokuwiki para el servidor web. Los servidores web más populares están cubiertos, pero hay instrucciones genéricas también.

El paquete de [community] descomprime DokuWiki en /srv/http/dokuwiki, luego, proceda a cambiar la propiedad del mismo al usuario "http". Ésto debería hacer que funcionara bien el empaquetado de Arch en los servidores web más populares.

Instalación

  1. Instalar el servidor web de su elección (por ejemplo, Apache o lighttpd) y configurarlo para PHP. Como se mencionó anteriormente, DokuWiki no tiene necesidad de un servidor database, por lo que puede omitir los pasos para configurar este último en su servidor web.
  2. Instalar dokuwiki desde [community] con pacman.
  3. Con el navegador web de su elección, abra http://<su-servidor>/dokuwiki/install.php y continue con la instalación desde ahí.

Alternativamente, si desea puede realizar la instalación con el archivo .tgz, se puede instruir en http://www.dokuwiki.org/Install. Generalmente, el procedimiento es el mismo que el anterior. En lugar de usar pacman, tendrá que descargar el archivo .tgz, descomprimirlo a la raíz del servidor para los documentos (por ejemplo, /srv/http/dokuwiki) y ejecutar el comando chown para dar permisos al usuario adecuado (por ejemplo, "http").

Configuración

Apache

En primer lugar, cree el archivo /etc/httpd/conf/extra/dokuwiki.conf con el siguiente contenido:

Alias /dokuwiki /usr/share/webapps/dokuwiki
<Directory /usr/share/webapps/dokuwiki/>
    Options +FollowSymLinks
    AllowOverride All
    order allow,deny
    allow from all
    php_admin_value open_basedir "/srv/http/:/home/:/tmp/:/usr/share/pear/:/usr/share/webapps/:/etc/webapps/dokuwiki/:/var/lib/dokuwiki/"
</Directory>

Incluya el archivo recién creado en la configuración de Apache poniendo la siguiente línea al final de /etc/httpd/conf/httpd.conf:

Include conf/extra/dokuwiki.conf

Asegúrese de que las carpetas /etc/webapps/dokuwiki y /var/lib/dokuwiki son propiedad del usuario y del grupo «http». Puede reubicar estos directorios si lo desea, siempre y cuando actualizar las referencias en /etc/httpd/conf/extra/dokuwiki.conf respectivamente.

Después reinicie Apache:

 # systemctl restart httpd.service

Por último, finalice la instalación ejecutando el script dokuwiki/install.php en su navegador.

Configuración específica para lighttpd

Edite el archivo /etc/lighttpd/lighttpd.conf como se indica en dokuwiki en lighttpd (puede contener información actualizada).

Bajo la línea:

 
$HTTP["url"] =~ "\.pdf$" {
  server.range-requests = "disable"
}

añada lo siguiente:

# subdirectorio de dokuwidi
# comprende el subdirectorio y el directorio raiz donde está instalado dokuwiki
# en este caso el directorio raiz es el directorio base más /htdocs/
# Nota: tener cuidado con barra final al unir cadenas.
# todo el contenido de este servidor de ejemplo se sirve de htdocs/ up.
# var.dokudir = var.basedir + "/dokuwiki"
var.dokudir = server.document-root + "/dokuwiki"

# asegurarse de que se sirve siempre a través de fastcgi y nunca de archivos estáticos
# negar el acceso completamente a éstos
$HTTP["url"] =~ "/\.ht" { url.access-deny = ( "" ) }
$HTTP["url"] =~ "/_ht" { url.access-deny = ( "" ) }
$HTTP["url"] =~ "^" + var.dokudir + "/bin/"  { url.access-deny = ( "" ) }
$HTTP["url"] =~ "^" + var.dokudir + "/data/" { url.access-deny = ( "" ) }
$HTTP["url"] =~ "^" + var.dokudir + "/inc/"  { url.access-deny = ( "" ) }
$HTTP["url"] =~ "^" + var.dokudir + "/conf/" { url.access-deny = ( "" ) }

Estas entradas dan algo de seguridad básica para DokuWiki. Lighttpd no usa archivos .htaccess como Apache. Se PUEDEN instalar con este, pero NO es recomendable.

alias.url += ("/dokuwiki" => "/usr/share/webapps/dokuwiki/")

Añada un alias en algún lugar de lighttpd o un archivo conf de fastcgi

Reinicie lighttp:

  # systemctl restart lighttpd

Post-instalación

Limpiando

¡Después de configurar el servidor elimine el archivo install.php!

 # rm /srv/http/dokuwiki/install.php

Instalación de Plugins

Muchos plugins creados por la comunidad se pueden encontrar aquí

Se pueden añadir a través de la interfaz web (así como actualizarlos) a través del menú Admin. Algunos plugins no se pueden descargar, si se quieren obtener a través de ssl (por ejemplo git). Descomente la siguiente línea en /etc/php/php.ini:

extension=openssl.so

Realizar copias de seguridad

Es muy trivial hacer copia de seguridad de DokuWiki, ya que no hay ninguna base de datos. Todas las páginas están en texto plano, y sólo requieren un simple tar, o rsync.

Un rápido resumen de los directorios de interés en la actual versión (2012-01-25b):

 /dokuwiki/data/         => Todos los Datos creados por el usuario
 /dokuwiki/lib/plugins/  => Todos los Plugins añadidos por el usuario

Lecturas recomendadas

La web de DokuWiki tiene toda la información y ayuda que usted pueda necesitar.

Véase también

DokuWiki HowTo Install and Upgrade