====== BookStack ======

Aplicación web para la organización y almacenamiento de información.

  * [[https://www.bookstackapp.com/|Web oficial]]

<WRAP center round todo 60%>
Añadir una captura de pantalla donde se vea el aspecto de la aplicación en funcionamiento
</WRAP>

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

  * Libre y de código abierto.
  * Interfaz sencilla y fácil de usar.
  * Buscador.
  * Personalizable. Se puede modificar el nombre, logo y las opciones de registro.
  * Requisitos bajos.
  * Ordenación, revisión de páginas, gestión de imágenes, sistema de permisos...
  * Multilenguaje
  * Editor Markdown (opcional)
  * Varios medios de autenticación (usuario/contraseña, GitHub...)

===== Instalación =====

==== Docker ====

Ejemplo de ''docker-compose.yml'' utilizando imágenes de LinuxServer.io:

<code yaml>
version: "2"
services:
  bookstack:
    image: ghcr.io/linuxserver/bookstack
    container_name: bookstack
    environment:
      - PUID=1000
      - PGID=1000
      - APP_URL=
      - DB_HOST=bookstack_db
      - DB_USER=bookstack
      - DB_PASS=bookstack
      - DB_DATABASE=bookstackapp
      - APP_LANG=es # Aplicación en español
    volumes:
      - ./data:/config
    ports:
      - 6875:80
    restart: unless-stopped
    depends_on:
      - bookstack_db
  bookstack_db:
    image: ghcr.io/linuxserver/mariadb
    container_name: bookstack_db
    environment:
      - PUID=1000
      - PGID=1000
      - MYSQL_ROOT_PASSWORD=bookstack
      - TZ=Europe/Madrid
      - MYSQL_DATABASE=bookstackapp
      - MYSQL_USER=bookstack
      - MYSQL_PASSWORD=bookstack
    volumes:
      - ./data:/config
    restart: unless-stopped
</code>

Las credenciales por defecto:

  * E-mail: ''admin@admin.com''
  * Contraseña: ''password''

===== Uso =====

Los principios que sigue BookStack a la hora de almacenar la información están basados en la idea una pila de libros. Igual que los libros, BookStack almacena libros que contienen capítulos y páginas. Partiríamos de la creación de un libro que actuaría como el nivel más alto de categorización. De forma ideal, cada libros trataría de una temática diferente.

Como en una biblioteca, en BookStack tenemos:

  * Estanterías (//shelves//)
  * Libros (//books//)
  * Capítulos (//chapters//)
  * Páginas (//pages//)