Boîte à outils de documents LibreOffice

# Boîte à outils de documents LibreOffice

Créez, modifiez et automatisez des documents Writer, Calc et Impress via un workflow LibreOffice unifié.

## Prérequis

- **LibreOffice** installé (7.x ou version ultérieure recommandée)
- LibreOffice doit être en cours d’exécution en **mode d’écoute** pour l’accès à l’API UNO :
  ```bash
  soffice --headless --accept="socket,host=localhost,port=2002;urp;" --norestore
  ```
- **Python 3** avec le module `uno` (fourni avec LibreOffice sur la plupart des systèmes)
- Plateformes prises en charge : Linux, macOS, Windows (LibreOffice + UNO disponible sur les trois)

### Vérification rapide de l’environnement

```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` échoue, assurez-vous que votre chemin Python inclut les site-packages de LibreOffice (par ex., `/usr/lib/libreoffice/program/`).

## Ce que fait ce plugin

Trois compétences pour les trois applications LibreOffice principales :

| Skill | Format | Capabilities |
|-------|--------|-------------|
| **Writer** | .odt | Text insertion, tables, images, metadata, paragraph styling |
| **Calc** | .ods | Cell operations, formulas, formatting, charts, named ranges, data validation |
| **Impress** | .odp | Slides, content placement, tables, charts, media, notes, master pages |

## Exemple complet : pipeline de rapport hebdomadaire

Une équipe automatise son workflow de reporting du vendredi — collecter les données dans un tableur, générer un résumé écrit, et produire un deck de présentation.

### Étape 1 : Calc — agréger les métriques hebdomadaires

```
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.
```

### Étape 2 : Writer — générer le rapport écrit

```
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.
```

### Étape 3 : Impress — construire le deck de présentation

```
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.
```

**Résultat :** Trois documents coordonnés (tableur, rapport, deck) générés à partir d’un seul workflow — aucune mise en forme manuelle, aucun copier-coller entre applications.

## Gestion des erreurs et récupération en cas d’échec

### LibreOffice non lancé

Si la connexion au socket UNO échoue :
```
Error: could not connect to socket on localhost:2002
```
**Correctif :** Démarrez l’écouteur headless :
```bash
soffice --headless --accept="socket,host=localhost,port=2002;urp;" --norestore &
```

### Module UNO introuvable

```
ModuleNotFoundError: No module named 'uno'
```
**Correctif :** Ajoutez Python LibreOffice à votre chemin :
```bash
# Linux
export PYTHONPATH=/usr/lib/libreoffice/program:$PYTHONPATH

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

### Modèle ou fichier introuvable

Si un fichier de modèle est référencé mais manquant, la compétence créera à la place un nouveau document vierge. Assurez-vous que les chemins des modèles sont absolus ou relatifs au répertoire de travail.

### Erreurs de permission lors de l’enregistrement

Si le répertoire de sortie n’est pas accessible en écriture, l’opération d’enregistrement échouera. Vérifiez les permissions d’écriture avant d’exécuter la génération de documents :
```bash
test -w ./output/ || mkdir -p ./output/
```

### Accès concurrent

LibreOffice UNO ne prend pas bien en charge les connexions concurrentes. Si plusieurs scripts tentent d’utiliser le même écouteur simultanément, les opérations peuvent échouer ou produire des sorties corrompues. Utilisez une seule connexion à la fois, ou démarrez des instances headless séparées sur des ports différents.