Diferencias

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

--- informatica:software:aplicaciones_web:shaarli [2023/01/04 09:19] – [Shaarli] tempwin
+++ informatica:software:aplicaciones_web:shaarli [2023/12/05 15:35] (actual) – [Temas] tempwin
@@ Línea 1: / Línea 1: @@
 ====== Shaarli ======
-[[informatica:software:aplicaciones_web:gestor_de_marcadores|Gestor de marcadores]]/favoritos.
+[[informatica:software:aplicaciones_web:gestor_de_marcadores|Gestor de marcadores]] / favoritos. Desarrollado en [[informatica:programacion:php|PHP]].
   * [[https://github.com/shaarli/Shaarli|Repositorio oficial]]
+  * [[https://shaarli.readthedocs.io/en/master/|Documentación]]
 No es multiusuario.
+{{https://medevel.com/content/images/2022/04/WWPfSj0.png |}}
+===== Características =====
+  * No require base de datos.
+  * Buscador
+  * Uso de etiquetas (//tags//).
+  * API REST.
+  * Suscripción RSS.
+  * Soporte de plugins y temas.
+  * Enlaces únicos (//permalinks//)
+  * Importación y exportación de marcadores.
+  * Limpieza automática de URL (eliminación de ''?utm_source=...'', ''fb='', etc)
+===== Casos de uso =====
+  * Compartir, comentar y guardar enlaces interesantes.
+  * Guardar enlaces útiles o frecuentes y compartirlos entre ordenadores
+  * Plataforma de microblogging.
+  * Lista de tareas o de leer después (//read it later//)
+  * Bloc de notas para preparar artículos, posts o ideas.
+  * Base de conocimiento para guardar notas, documentación o trozos de código (//code snippets//)
+  * Pastebin / bloc de notas / portapapeles compartido.
+  * Gestión de playlists para multimedia online
+  * Repositorio para otros blogs, agregadores, redes sociales...
 ===== Instalación =====
@@ Línea 15: / Línea 42: @@
 <code bash>
 chown -R nginx:nginx /var/www/shaarli/data
+chown -R nginx:nginx /var/www/shaarli/cache
 </code>
@@ Línea 26: / Línea 54: @@
 services:
   shaarli:
-    image: shaarli/shaarli
+    image: ghcr.io/shaarli/shaarli
     container_name: shaarli
     volumes:
@@ Línea 33: / Línea 61: @@
 </code>
+===== Configuración =====
+==== Temas ====
+Shaarli permite modificar la apariencia de su interfaz mediante temas.
+Uno bastante bueno es [[https://github.com/kalvn/Shaarli-Material|Material]]. Para instalarlo, nos situamos en el directorio ''/var/www/shaarli/tpl '' y descargamos el tema:
+<code>
+wget https://github.com/kalvn/Shaarli-Material/releases/download/v0.12.1/shaarli-material.v0.12.1.zip
+</code>
+Descomprimimos:
+<code>
+unzip shaarli-material.v0.12.1.zip
+</code>
+Nos vamos a sección de configuración de Shaarli y en **Theme** ya podremos seleccionar **Material**
+{{https://raw.githubusercontent.com/kalvn/Shaarli-Material/master/screenshots/home.png |}}
+Otro tema bastante actualizado es [[https://github.com/RolandTi/shaarli-stack/|Stack for Shaarli]]:
+{{ https://raw.githubusercontent.com/RolandTi/shaarli-stack/main/screenshots/stack_sml.png |}}
+==== Exportar marcadores ====
+Desde el menú **Tools**, elegimos la opción **Export**.
+==== Importar marcadores ====
+===== Copia de seguridad =====
+Todos los datos y configuración de Shaarli se almacena en el directorio ''data''.
+Si queremos hacer copias de seguridad:
+<code>
+rsync -avzP my.server.com:/var/www/shaarli.mydomain.org/data ~/backups/shaarli-data-$(date +%Y-%m-%d_%H%M)
+</code>
+Para restaurar una copia de seguridad, basta sobrescribir el directorio ''data'' con el contenido de la copia de seguridad.
+  * [[https://shaarli.readthedocs.io/en/master/Backup-and-restore/|Backup and restore]] (Documentación oficial)
+===== API REST =====
+Shaarli expone una API para poder interactuar con la aplicación de forma externa.
+Existe un cliente hecho en Python para usar esta API: [[https://github.com/shaarli/python-shaarli-client|python-shaarli-client]]
+En //Settings// -> //Configuration// podemos encontrar (y modificar) la clave para acceder a la API de la instancia de Shaarli: **API secret**.