Documentation: intégration bureau et utilisation Docker
- Section intégration bureau avec instructions Caja Actions - Détails sur options d'impression et dialogue interactif - Guide dépannage pour problèmes courants - Explications sur temps de build Docker
This commit is contained in:
syoul
145
README.md
145
README.md
@@ -13,6 +13,7 @@ Application CLI complète pour convertir des fichiers Markdown en PDF et les imp
|
||||
- **Gestion d'erreurs** complète avec codes de retour appropriés
|
||||
- **Système de logging** détaillé avec niveaux (DEBUG, INFO, WARN, ERROR)
|
||||
- **Interface en ligne de commande** avec options complètes
|
||||
- **Intégration bureau** : Menu contextuel MATE/Caja avec sélection multiple
|
||||
|
||||
## Installation
|
||||
|
||||
@@ -42,6 +43,14 @@ make install
|
||||
|
||||
### Installation avec Docker
|
||||
|
||||
**Note importante sur le temps de construction :**
|
||||
La première construction de l'image Docker peut prendre **5-10 minutes** car elle doit télécharger et installer les packages TeX Live (plusieurs centaines de MB). C'est normal et nécessaire pour la conversion PDF. Les constructions suivantes seront beaucoup plus rapides grâce au cache Docker.
|
||||
|
||||
**Pour accélérer la construction :**
|
||||
- Utilisez le cache Docker : ne reconstruisez que si nécessaire
|
||||
- Utilisez `docker build --cache-from md-to-print:latest` pour réutiliser le cache
|
||||
- Une fois construite, l'image est réutilisable indéfiniment
|
||||
|
||||
1. Construire l'image Docker:
|
||||
```bash
|
||||
make build
|
||||
@@ -133,6 +142,134 @@ make shell
|
||||
make clean
|
||||
```
|
||||
|
||||
## Utilisation de bureau (MATE/Caja)
|
||||
|
||||
MD_to_Print peut être intégré dans votre environnement de bureau MATE pour une utilisation via le menu contextuel (clic droit).
|
||||
|
||||
### Installation de l'intégration bureau
|
||||
|
||||
**IMPORTANT :** Caja nécessite l'extension **caja-actions** pour afficher les actions dans le menu contextuel.
|
||||
|
||||
1. **Installer caja-actions** (requis):
|
||||
```bash
|
||||
sudo apt-get install caja-actions
|
||||
```
|
||||
|
||||
2. **Installation automatique** (recommandée):
|
||||
```bash
|
||||
cd MD_to_print
|
||||
./desktop/install-desktop.sh
|
||||
```
|
||||
|
||||
3. **Configuration Caja Actions** (important):
|
||||
```bash
|
||||
# Ouvrir l'outil de configuration
|
||||
caja-actions-config-tool
|
||||
```
|
||||
|
||||
Dans l'outil de configuration :
|
||||
- Allez dans **Édition > Préférences**
|
||||
- Onglet **Préférences d'exécution**
|
||||
- **Désactivez** l'option "Créer un menu racine 'Caja-Actions'"
|
||||
- Cela permet aux actions d'apparaître directement dans le menu contextuel
|
||||
|
||||
4. **Redémarrer Caja** pour voir les nouvelles actions:
|
||||
```bash
|
||||
caja -q
|
||||
```
|
||||
|
||||
### Utilisation depuis le menu contextuel
|
||||
|
||||
Une fois installé, les actions suivantes sont disponibles dans le menu contextuel (clic droit) sur les fichiers `.md`:
|
||||
|
||||
- **"Imprimer avec MD_to_Print"** : Conversion + Impression directe
|
||||
- **"Convertir en PDF (MD_to_Print)"** : Conversion uniquement, sans impression
|
||||
- **"Prévisualiser avant impression"** : Conversion + Prévisualisation + Impression optionnelle
|
||||
|
||||
### Fonctionnalités
|
||||
|
||||
- ✅ **Sélection multiple** : Traitez plusieurs fichiers en une seule fois
|
||||
- ✅ **Notifications de bureau** : Feedback visuel pour chaque étape
|
||||
- ✅ **Détection automatique** : Utilise l'installation locale ou Docker selon disponibilité
|
||||
- ✅ **Gestion d'erreurs** : Messages clairs en cas de problème
|
||||
- ✅ **Confirmation** : Dialogue de confirmation pour traitement multiple
|
||||
|
||||
### Exemples d'utilisation
|
||||
|
||||
**Sélection unique :**
|
||||
1. Clic droit sur `document.md`
|
||||
2. Sélectionner "Imprimer avec MD_to_Print"
|
||||
3. Le fichier est converti et imprimé automatiquement
|
||||
|
||||
**Sélection multiple :**
|
||||
1. Sélectionner plusieurs fichiers `.md` (Ctrl+Clic)
|
||||
2. Clic droit → "Convertir en PDF (MD_to_Print)"
|
||||
3. Confirmer le traitement multiple
|
||||
4. Tous les fichiers sont convertis séquentiellement avec notifications
|
||||
|
||||
### Désinstallation
|
||||
|
||||
Pour désinstaller l'intégration bureau:
|
||||
```bash
|
||||
./desktop/install-desktop.sh --uninstall
|
||||
```
|
||||
|
||||
### Dépendances bureau
|
||||
|
||||
**Critique :**
|
||||
- `caja-actions` : Extension Caja pour les actions personnalisées (REQUIS)
|
||||
|
||||
**Optionnelles :**
|
||||
- `zenity` ou `yad` : Dialogues graphiques
|
||||
- `libnotify-bin` : Notifications (`notify-send`)
|
||||
- `caja` : Gestionnaire de fichiers MATE (déjà installé)
|
||||
|
||||
Installation des dépendances:
|
||||
```bash
|
||||
sudo apt-get install caja-actions zenity libnotify-bin
|
||||
```
|
||||
|
||||
### Dépannage menu contextuel
|
||||
|
||||
**Les actions n'apparaissent pas dans le menu :**
|
||||
```bash
|
||||
# 1. Vérifier que caja-actions est installé (CRITIQUE)
|
||||
dpkg -l | grep caja-actions
|
||||
# Si absent: sudo apt-get install caja-actions
|
||||
|
||||
# 2. Vérifier que les fichiers .desktop sont installés
|
||||
ls ~/.local/share/caja/actions/md-to-print-*.desktop
|
||||
|
||||
# 3. Ouvrir l'outil de configuration Caja Actions
|
||||
caja-actions-config-tool
|
||||
# Vérifier que les actions sont présentes et activées
|
||||
# Dans Préférences: désactiver "Créer un menu racine Caja-Actions"
|
||||
|
||||
# 4. Vérifier que les scripts sont dans le PATH
|
||||
which md_to_print_gui.sh
|
||||
|
||||
# 5. Redémarrer Caja
|
||||
caja -q
|
||||
```
|
||||
|
||||
**Erreur "md_to_print_gui.sh: command not found" :**
|
||||
```bash
|
||||
# Vérifier l'installation
|
||||
./desktop/install-desktop.sh
|
||||
|
||||
# Vérifier que ~/.local/bin est dans le PATH
|
||||
echo $PATH | grep -q ".local/bin" || echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
|
||||
```
|
||||
|
||||
**Notifications ne s'affichent pas :**
|
||||
```bash
|
||||
# Vérifier que libnotify est installé
|
||||
dpkg -l | grep libnotify-bin
|
||||
|
||||
# Tester manuellement
|
||||
notify-send "Test" "Les notifications fonctionnent"
|
||||
```
|
||||
|
||||
## Options disponibles
|
||||
|
||||
| Option | Description | Défaut |
|
||||
@@ -200,6 +337,14 @@ MD_to_print/
|
||||
├── docker-compose.yml # Configuration Docker Compose
|
||||
├── docker_run.sh # Wrapper Docker
|
||||
├── Makefile # Commandes Make
|
||||
├── desktop/ # Intégration bureau
|
||||
│ ├── md-to-print-print.desktop # Action "Imprimer"
|
||||
│ ├── md-to-print-convert.desktop # Action "Convertir"
|
||||
│ ├── md-to-print-preview.desktop # Action "Prévisualiser"
|
||||
│ └── install-desktop.sh # Script d'installation
|
||||
├── scripts/ # Scripts utilitaires
|
||||
│ ├── md_to_print_gui.sh # Wrapper GUI
|
||||
│ └── md_to_print_notify.sh # Script notifications
|
||||
├── .dockerignore # Fichiers à exclure du build Docker
|
||||
├── .gitignore # Fichiers à ignorer dans Git
|
||||
├── README.md # Documentation (ce fichier)
|
||||
|
||||
Reference in New Issue
Block a user