Herramientas de usuario

Herramientas del sitio


informatica:software:aplicaciones_web:wiki.js

Diferencias

Muestra las diferencias entre dos versiones de la página.

Enlace a la vista de comparación

Ambos lados, revisión anteriorRevisión previa
Próxima revisión
Revisión previa
informatica:software:aplicaciones_web:wiki.js [2023/08/17 12:23] – [Wiki.js] tempwininformatica:software:aplicaciones_web:wiki.js [2024/09/19 16:48] (actual) – [Recursos] tempwin
Línea 13: Línea 13:
   * Una interfaz de usuario moderna y fácil de usar   * Una interfaz de usuario moderna y fácil de usar
   * Soporte para múltiples idiomas   * 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)   * Integración con sistemas de gestión de contenido (CMS)
   * Soporte para plugins y extensiones   * Soporte para plugins y extensiones
   * Posibilidad de crear wikis privados o públicos   * Posibilidad de crear wikis privados o públicos
   * Compatible con PostgreSQL, MySQL, MariaDB, MS SQL Server y SQLite.   * Compatible con PostgreSQL, MySQL, MariaDB, MS SQL Server y SQLite.
 +  * Posibilidad de añadir comentarios sobre el contenido creado.
   * Open source   * 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]]
informatica/software/aplicaciones_web/wiki.js.1692267825.txt.gz · Última modificación: por tempwin