95 lines
4.8 KiB
Markdown
95 lines
4.8 KiB
Markdown
# 📝 sld-blocknotes - Sistema Moderno de Notas en Bloques y Gestión de Comandos
|
|
|
|
> **🌐 Idiomas disponibles**: [🇬🇧 English](README.md) | [🇮🇹 Italiano](README.it.md) | [🇪🇸 Español](README.es.md) | [🇫🇷 Français](README.fr.md)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Una potente y moderna aplicación web sin dependencias externas para organizar notas estructuradas en bloques, comandos de terminal, fragmentos de código e instrucciones. Desarrollada en **Pure PHP**, **Vanilla CSS**, **Vanilla JS** y **MySQL/MariaDB**.
|
|
|
|
URL del Repositorio: [https://gitea.sld-server.org/sld-admin/sld-blocknotes](https://gitea.sld-server.org/sld-admin/sld-blocknotes)
|
|
|
|
---
|
|
|
|
## ✨ Características Principales
|
|
|
|
- 📑 **Notas en Bloques y Subnotas Estructuradas**:
|
|
- Organiza tus notas dentro de blocknotes personalizados.
|
|
- Las notas contienen título, descripción y múltiples subnotas.
|
|
- **Notas Plegables**: Las notas están plegadas por defecto para optimizar el espacio vertical, con botones globales de **Expandir Todas / Contraer Todas**.
|
|
|
|
- ⚡ **Subnotas de Tipo Comando de Terminal**:
|
|
- Renderizado diferenciado entre subnotas de texto genérico y comandos de terminal.
|
|
- **Botón Copiar en 1 Clic**: Copia instantáneamente comandos al portapapeles con retroalimentación visual (`✓ ¡Copiado!`).
|
|
- Cuadro estilo IDE/Terminal de alto contraste con barra de desplazamiento vertical.
|
|
|
|
- 🔍 **Búsqueda en Tiempo Real**:
|
|
- Filtra títulos de notas, descripciones, subnotas y contenido de comandos en tiempo real dentro del blocknote activo.
|
|
- Expande automáticamente los bloques coincidentes durante la búsqueda.
|
|
|
|
- 📥 / 💾 **Importación y Exportación JSON**:
|
|
- Descarga el archivo JSON de cualquier blocknote con un clic (`export_blocknote.php`).
|
|
- Importador JSON interactivo compatible con formato estándar y formato antiguo.
|
|
|
|
- 🌐 **Interfaz Multilingüe (IT, EN, ES, FR)**:
|
|
- Localización completa en **Italiano 🇮🇹, Inglés 🇬🇧, Español 🇪🇸 y Francés 🇫🇷**.
|
|
- Selector de idioma rápido en la barra de navegación para visitantes y usuarios conectados.
|
|
- El idioma preferido de cada usuario se guarda en su perfil para futuros accesos.
|
|
|
|
- 🏠 **Página de Inicio Personalizable**:
|
|
- Elige entre acceder directamente al **Panel Principal (Todos los Blocknotes)** o abrir un **Blocknote Predeterminado específico** al iniciar sesión.
|
|
|
|
- 👑 **Rol Único de Propietario y Jerarquía Avanzada (`owner` > `admin` > `user`)**:
|
|
- **Cuenta de Propietario Inmune**: La cuenta inicial de Propietario (`owner`) no puede ser eliminada por ningún administrador ni por sí misma.
|
|
- Los administradores estándar no pueden degradar ni modificar el rol del Propietario.
|
|
|
|
- ⚙️ **Personalización del Sitio (Exclusivo Propietario)**:
|
|
- Cambia el **Título Global de la Aplicación**.
|
|
- Sube y valida un **Favicon de Alta Resolución** (mínimo 64x64px) con vista previa en tiempo real.
|
|
|
|
- 🚀 **Asistente de Configuración Inicial (`first_start.php`)**:
|
|
- Instalador automático para configurar credenciales MySQL, crear tablas y registrar los primeros usuarios privilegiados (`owner` y `admin`).
|
|
- Completamente multilingüe en los 4 idiomas.
|
|
|
|
---
|
|
|
|
## 🚀 Guía de Instalación
|
|
|
|
### Requisitos
|
|
- Servidor Web (Apache, Nginx, o servidor CLI integrado de PHP)
|
|
- PHP 7.4 o 8.x (con extensión `mysqli` habilitada)
|
|
- MySQL 5.7+ o MariaDB 10.x+
|
|
|
|
### Instalación Paso a Paso
|
|
|
|
1. **Clona el Repositorio**:
|
|
```bash
|
|
git clone https://gitea.sld-server.org/sld-admin/sld-blocknotes.git
|
|
cd sld-blocknotes
|
|
```
|
|
|
|
2. **Inicia el Servidor Web**:
|
|
Puedes utilizar el servidor integrado de PHP:
|
|
```bash
|
|
php -S localhost:8000
|
|
```
|
|
|
|
3. **Ejecuta el Asistente de Configuración**:
|
|
Abre tu navegador en `http://localhost:8000/`.
|
|
El sistema detectará el primer inicio y abrirá automáticamente `first_start.php`:
|
|
- Introduce los datos de tu **Base de Datos MySQL** (Host, Nombre, Usuario, Contraseña).
|
|
- Configura las credenciales de la **Cuenta de Propietario**.
|
|
- Configura las credenciales de la **Primera Cuenta de Admin**.
|
|
- Haz clic en **⚡ Completar Instalación y Configurar Sistema**.
|
|
|
|
4. **Inicia Sesión**:
|
|
Al finalizar, serás redirigido a la página de inicio de sesión `index.php?page=login`.
|
|
|
|
---
|
|
|
|
## 📄 Licencia
|
|
|
|
Este proyecto se distribuye bajo la licencia open-source [MIT License](LICENSE).
|