====== Configuración de Dokuwiki ======

Descripción de los pasos seguidos para instalar esta Wiki.

La wiki está instalada provisionalmente en el dominio ''comacero.com'', se migrará a un dominio adecuado en cuanto sea posible.
===== Instalación de la wiki en Docker =====

Usamos un contenedor //Docker// configurado via ''docker-compose'' con el siguiente fichero ''docker-compose.yml'':
<code yaml>
---
version: "3.9"
networks:
  frontend:
    external: true
services:
  dokuwiki:
    image: ghcr.io/linuxserver/dokuwiki
    container_name: dokuwiki
    environment:
      - PUID=1001
      - PGID=1001
    volumes:
      - /etc/timezone:/etc/timezone:ro
      - ./config:/config
    # ports:
    #   - 8080:80
    #   - 8443:443 #optional
    restart: unless-stopped
    networks:
      frontend:
        ipv4_address: 172.21.0.200
    labels:
      - "traefik.enable=true"
      - "traefik.docker.network=frontend"
      - "traefik.http.routers.dokuwiki-secure.entrypoints=https"
      - "traefik.http.routers.dokuwiki-secure.rule=Host(`dk.comacero.com`)"
      - "traefik.http.routers.dokuwiki-secure.service=dokuwiki"
      - "traefik.http.services.dokuwiki.loadbalancer.server.port=80"
</code>

  * El contenedor de //Dokuwiki//  va a estar detrás de un proxy inverso implementado con //Traefik//
  * El contenedor está en la red ''frontend'' (la misma que //Traefik//)
  * Los parámetros adicionales de //Traefik// en ''comacero.com'' pueden consultarse en [[https://comacero.gitlab.io/notes_traefik|este enlace]]. 
  * Una vez configurado el contenedor es necesario añadir el subdominio ''dk.comacero.com'' a la //DNS Zone// correspondiente.
 

===== Configuración inicial =====

Una vez instalado el contenedor tenemos que hacer la configuración inicial de la wiki visitando la página [[http://dk.comacero.com/install.php]] En este paso configuramos el Título de la Wiki, el idioma por defecto y la licencia de contenido por defecto. Una vez realizada la configuración básica instalamos los siguientes plugins de //Dokuwiki//:

  * **ckgedit**\\ Para editar el //markdown// de //Dokuwiki// directamente sin //wysiwyg//
  * **Searchindex Manager**\\ Para regenerar el índice de búsquedas manualmente 
  * **Translation**\\ Para tener páginas en varios idiomas 
  * **Wrap**\\ Para poder insertar avisos con formatos especiales en el texto 
  * **nspages**\\ Para poder organizar la barra lateral con ayuda de los //namespaces// de //Dokuwiki//

Se dejan creados los usuarios administradores: 

  * **wikisu** 
  * **raivenra** 
  * **salvari** 

Como último paso cambiamos en //Administración::Ajustes de Plantilla// el ancho de página de la wiki desde el valor ''75em'' al valor ''100%''

===== Configuración de la barra lateral =====

<WRAP center round important 60%> ¡Debe seleccionarse el editor estándar (DW Edit) antes de editar la página, de lo contrario con editores WYSIWYG (CKG Edit) se perderá el formato irremediablemente!! </WRAP>

Crea un menú con todos los //namespaces//  existentes a partir de los //namespaces//  de secciones. Se utiliza el //plugin nspages//. Este menú se muestra en la parte izquierda del navegador. El código actual a falta de depurar categorías a ocultar.

<code dokuwiki>
[[start|Página Principal]]

**Guías** <nspages -h1 guias -simpleList -textPages="">

~~NOCACHE~~


</code>

Esta página aparece oculta a los usuarios fuera del grupo //admin//.