Kit de herramientas de documentos de LibreOffice

# Kit de herramientas de documentos de LibreOffice

Crea, edita y automatiza documentos de Writer, Calc e Impress mediante un flujo de trabajo unificado de LibreOffice.

## Requisitos previos

- **LibreOffice** instalado (se recomienda 7.x o posterior)
- LibreOffice debe estar ejecutándose en **modo de escucha** para el acceso a la API UNO:
  ```bash
  soffice --headless --accept="socket,host=localhost,port=2002;urp;" --norestore
  ```
- **Python 3** con el módulo `uno` (incluido con LibreOffice en la mayoría de los sistemas)
- Plataformas compatibles: Linux, macOS, Windows (LibreOffice + UNO disponibles en los tres)

### Comprobación rápida del entorno

```bash
# Verify LibreOffice is installed
soffice --version

# Start headless listener (background)
soffice --headless --accept="socket,host=localhost,port=2002;urp;" --norestore &

# Verify UNO connection
python3 -c "import uno; print('UNO available')"
```

Si `import uno` falla, asegúrate de que tu ruta de Python incluya los site-packages de LibreOffice (p. ej., `/usr/lib/libreoffice/program/`).

## Qué hace este plugin

Tres skills para las tres aplicaciones principales de LibreOffice:

| Skill | Format | Capabilities |
|-------|--------|-------------|
| **Writer** | .odt | Inserción de texto, tablas, imágenes, metadatos, estilo de párrafos |
| **Calc** | .ods | Operaciones de celdas, fórmulas, formato, gráficos, rangos con nombre, validación de datos |
| **Impress** | .odp | Diapositivas, colocación de contenido, tablas, gráficos, medios, notas, páginas maestras |

## Ejemplo completo: flujo de trabajo de informe semanal

Un equipo automatiza su flujo de informes de los viernes: recopila datos en una hoja de cálculo, genera un resumen escrito y produce una presentación.

### Paso 1: Calc — Agregar métricas semanales

```
Create a new Calc spreadsheet "weekly-metrics.ods".
Sheet 1 "Revenue": columns Date, Product, Units, Revenue with sample data for Mon-Fri.
Sheet 2 "Summary": use SUMIF formulas to total revenue by product.
Add a bar chart on Sheet 2 visualizing revenue by product.
Format header rows as bold with blue background.
```

### Paso 2: Writer — Generar informe escrito

```
Create a Writer document "weekly-report.odt".
Title: "Weekly Report — March 10, 2026"
Section 1: Executive Summary (2 paragraphs summarizing metrics from the spreadsheet).
Section 2: Key Highlights (bulleted list of top 3 achievements).
Section 3: Next Week Priorities (numbered list).
Insert a table with the summary totals from the spreadsheet.
Set font to Liberation Serif 12pt, headings 16pt bold.
```

### Paso 3: Impress — Crear la presentación

```
Create an Impress presentation "weekly-deck.odp".
Slide 1: Title slide — "Weekly Review Q1 W10" with date subtitle.
Slide 2: Metrics Overview — insert a table with revenue by product.
Slide 3: Highlights — bullet points of top achievements.
Slide 4: Next Steps — numbered priorities.
Slide 5: Thank You slide.
Add speaker notes on slides 2-4 with talking points.
```

**Resultado:** Tres documentos coordinados (hoja de cálculo, informe, presentación) generados desde un único flujo de trabajo — sin formato manual, sin copiar y pegar entre aplicaciones.

## Manejo de errores y recuperación de fallos

### LibreOffice no está en ejecución

Si la conexión del socket UNO falla:
```
Error: could not connect to socket on localhost:2002
```
**Solución:** Inicia el listener headless:
```bash
soffice --headless --accept="socket,host=localhost,port=2002;urp;" --norestore &
```

### Módulo UNO no encontrado

```
ModuleNotFoundError: No module named 'uno'
```
**Solución:** Añade Python de LibreOffice a tu ruta:
```bash
# Linux
export PYTHONPATH=/usr/lib/libreoffice/program:$PYTHONPATH

# macOS
export PYTHONPATH="/Applications/LibreOffice.app/Contents/Frameworks/:$PYTHONPATH"
```

### Plantilla o archivo no encontrado

Si se hace referencia a un archivo de plantilla que falta, la skill creará un documento en blanco nuevo en su lugar. Asegúrate de que las rutas de las plantillas sean absolutas o relativas al directorio de trabajo.

### Errores de permisos al guardar

Si el directorio de salida no tiene permisos de escritura, la operación de guardado fallará. Verifica los permisos de escritura antes de ejecutar la generación de documentos:
```bash
test -w ./output/ || mkdir -p ./output/
```

### Acceso concurrente

LibreOffice UNO no admite bien conexiones concurrentes. Si varios scripts intentan usar el mismo listener simultáneamente, las operaciones pueden fallar o producir salidas corruptas. Usa una conexión a la vez o inicia instancias headless separadas en diferentes puertos.