====== Wiki.js ======

Aplicación [[informatica:software:wiki|wiki]] autoalojada creada con [[informatica:software:node.js|Node.js]].

  * [[https://js.wiki/|Web]]
  * [[https://github.com/Requarks/wiki|Repositorio de código]]
  * [[https://docs.requarks.io|Documentación]]

{{https://js.wiki/img/wiki-screenshot.3d2d7f34.png | }}

===== Características =====

  * Una interfaz de usuario moderna y fácil de usar
  * Soporte para múltiples idiomas
  * Edición visual, con código HTML, [[informatica:markdown|Markdown]] o AsciiDoc.
  * Integración con sistemas de gestión de contenido (CMS)
  * Soporte para plugins y extensiones
  * Posibilidad de crear wikis privados o públicos
  * Compatible con PostgreSQL, MySQL, MariaDB, MS SQL Server y SQLite.
  * Posibilidad de añadir comentarios sobre el contenido creado.
  * Open source

===== Páginas =====

==== Nombres reservados ====

Las siguientes rutas de una sola letra están reservadas por Wiki.js para acceder a varias partes de la wiki:

  * ''a'': Área de administración
  * ''c'': Comentarios
  * ''e'': Editor de página
  * ''f'': Gestor de medios
  * ''h'': Historial de página
  * ''i'': Navegación de página por ID
  * ''p'': Perfil de usuario.
  * ''s'': Código fuente de la página
  * ''t'': Etiquetas (//tags//)
  * ''u'': Endpoint para subidas (API)
  * ''w'': Wiki personal
===== Instalación =====

==== Docker ====

Ejemplo de ''docker-compose.yml'' para instalar con [[informatica:sistemas_operativos:virtualizacion:docker:docker_compose|Docker Compose]] con SQLite:

<WRAP center round important 60%>
No se recomienda una instalación distinta de PostgreSQL porque otros motores de bases de datos (MySQL, MariaDB, MS SQL Server and SQLite) dejarán de soportarse en la versión 3 de Wiki.js. De todos modos, prometieron que harían una herramienta para importar y exportar cuando llegase el momento.
</WRAP>

<code yaml>
---
version: "3"
services:

  wiki:
    image: ghcr.io/requarks/wiki:2
    environment:
      DB_TYPE: sqlite
      DB_FILEPATH: /wiki/database.sqlite
    volumes:
      - ./data/database.sqlite:/wiki/database.sqlite
    restart: unless-stopped
    ports:
      - "8030:3000"
</code>

<WRAP center round info 60%>
linuxserver.io también [[https://hub.docker.com/r/linuxserver/wikijs|tiene su propio contenedor]] para Wiki.js.
</WRAP>

Ejemplo utilizando **PostgreSQL**:

<code yaml>
version: "3"
services:

  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: wiki
      POSTGRES_PASSWORD: wikijsrocks
      POSTGRES_USER: wikijs
    logging:
      driver: "none"
    restart: unless-stopped
    volumes:
      - db-data:/var/lib/postgresql/data

  wiki:
    image: ghcr.io/requarks/wiki:2
    depends_on:
      - db
    environment:
      DB_TYPE: postgres
      DB_HOST: db
      DB_PORT: 5432
      DB_USER: wikijs
      DB_PASS: wikijsrocks
      DB_NAME: wiki
    restart: unless-stopped
    ports:
      - "80:3000"

volumes:
  db-data:
</code>

Tras arrancar el contenedor, al acceder a ''http://tudominiowikijs.ext/'' se abrirá un asistente para finalizar la instalación de Wiki.js.
===== Administración =====

==== Idioma ====

Desde la sección de administración, en la página **Locale**, hay una parte en la que podemos descargar un archivo de traducción al idioma que queramos y luego lo seleccionaríamos en los ajustes y aplicaríamos para que toda la wiki se vea en dicho idioma.

==== Comentarios ====

Wiki.js permite que otros usuarios puedan añadir comentarios sobre las páginas. Desde el área de administración se pueden elegir varios módulos de comentarios:

  * Interno (por defecto)
  * Disqus
  * Commento
  * Artalk

Que se puedan ver o añadir comentarios depende de los permisos que les demos a los grupos de usuarios.

==== Modificar la posición de la tabla de contenidos de la página ====

Por defecto, el índice con el contenido de la página se muestra a la izquierda.

Para cambiarlo, vamos a **Administración** -> **Tema**. En las **Opciones del tema** veremos una opción que es "Table of Contents Position". Por defecto está a la izquierda (//left//). Ahí podemos cambiarlo a la derecha (//right//) u ocultarla (//hidden//).

===== Recursos =====

  * [[https://github.com/requarks/wiki/discussions/6584|A lot of examples to inspire your own wiki.js]]
  * [[https://github.com/requarks/wiki/discussions/5497|Markdown Syntax Wiki Page]]