DokuWiki (Español)

From ArchWiki
Revision as of 21:12, 16 August 2017 by Arlesy (talk | contribs) (→‎Instalación: Actualizado)
Jump to navigation Jump to search

Tango-preferences-desktop-locale-modified.pngThe translation of this article or section does not reflect the original text.Tango-preferences-desktop-locale-modified.png

Reason: Esta página no refleja el contenido original (Discuss in Talk:DokuWiki (Español)#)

"DokuWiki es un wiki que cumple con los estándares, simple de usar y que permite a los usuarios crear ricos repositorios de documentación. Además permite a los individuos, equipos y empresas crear y colaborar utilizando una sintaxis sencilla pero potente que garantiza que los archivos de datos permanezcan estructurados y legible fuera del wiki".

"Las revisiones de página ilimitadas permiten la restauración de cualquier versión anterior de la página, y con los datos almacenados en archivos de texto sin formato, además no se requiere ninguna base de datos. Una poderosa arquitectura de complementos permite la extensión y la mejora del sistema central. Vea la sección de características para una descripción completa de lo que DokuWiki tiene para ofrecer." [1]

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

Notas iniciales

DokuWiki debería funcionar en cualquier servidor web que soporte PHP 5.6 o posterior. Como los requisitos pueden cambiar con el tiempo, debe consultar la página de requisitos de DokuWiki para obtener más detalles.

Se recomienda encarecidamente leer las secciones apropiadas de la página de seguridad de DokuWiki para su servidor web. La mayoría de los servidores web más populares están cubiertos, pero también hay instrucciones genéricas.

El paquete en [community] descomprime DokuWiki en /usr/share/webapps/dokuwiki con los archivos de configuración en /etc/webapps/dokuwiki y los archivos de datos en /var/lib/dokuwiki/data. También cambia la propiedad de los archivos relevantes al usuario "http". Esto debería funcionar bien para la mayoría de los servidores web más populares, tal como están empaquetados para Arch.

Instalación

  1. Instale un servidor web de su elección (por ejemplo, Apache, nginx o lighttpd) y configúrelo para PHP. Como se mencionó anteriormente, DokuWiki no tiene necesidad de un servidor de base de datos por lo que puede ser capaz de saltar esos pasos al configurar su servidor
  2. Instalar dokuwiki desde [community] con pacman.
  3. Configure el servidor web para DokuWiki (consulte la sección siguiente)
  4. Con su navegador web de su elección, abra http://<your-server>/dokuwiki/install.php y continúe la instalación desde allí. Para nginx la URL es http://<your-server>/install.php.

Alternativamente, si desea instalar desde un tarball, puede leerlo en http://www.dokuwiki.org/Install . Generalmente el procedimiento es el mismo que el anterior. En lugar de usar pacman, necesitará descargar el tarball, descomprimirlo en la raíz del documento del servidor (por ejemplo, /srv/http/dokuwiki), y cambie los permisos al usuario apropiado (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).

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