Documentation (FR)

##Pré-requis

• Système d'exploitation : Linux Debian (et distributions basées sur Debian : Ubuntu, Linux Mint, etc.),
• Scanner reconnu par Sane, installé et configuré sur votre système,
• Compte de courrier électronique configuré sous Mozilla Thunderbird,
• Dépendances : sane, imagemagick, gzip, thunderbird, zenity & coreutils - Les dépendances seront installées si nécessaire par le paquet .deb.

##Utilisation basique

1. Lancez le programme,
2. Entrez le nom à donner au fichier à générer (sans extension),
3. Indiquez si vous souhaitez numériser un document en couleurs ou en noir et blanc,
4. Entrez le nombre de pages à numériser,
5. Changez les pages sur le scanner au fur et à mesure de la numérisation,
6. Le programme créée alors un nouveau mail où le document numérisé est déjà en pièce jointe. Composez et envoyez votre courrier électronique.

Vous n'avez aucun paramètre à régler, le logiciel est déjà optimisé pour des documents courant (textes et graphiques en A4). Vous pouvez toutefois changer les résolutions et la taille limite de pièce jointe dans le fichier de configuration.

##Détails techniques ###Taille limite des pièce jointes

La taille limite de pièce jointe configurée dans Scan2Thunderbird est 5 Mo. Cette valeur par défaut est la plus répandue chez les fournisseurs d'accès (Orange, Gmail, Hotmail) et garantira une bon fonctionnement du logiciel dans 95% des cas.

Elle peut être modifiée dans le fichier de configuration /opt/scan2thunderbird/scan2thunderbird.conf

###Résolution

Les documents de moins de 3 pages sont numérisés en 300 DPI/PPP. À partir de 4 pages, et pour les documents de moins de 3 pages dont la taille est supérieure à 5 Mo, la résolution utilisée est 150 DPI/PPP. Tous les documents sont automatiquement recadrés au format A4 Portrait.

###Qualité d'image

Les pages numérisées sont converties en JPEG et assemblées dans un seul fichier PDF. La qualité de compression JPEG utilisée par défaut est 90. Si le fichier final pèse plus de 5 Mo, le logiciel effectue une nouvelle compression en diminuant la qualité JPEG par pas de 1 tant que la limite de 5 Mo est dépassée.

Compression Gzip

Le fichier final porte l'extension .pdf.gzip et est compressé avec les algorithmes non destructifs les plus agressifs. Il devra être décompressé par votre interlocuteur avant d'être lu. Ceci a pour but d'économiser la bande passante.

###Fichiers temporaires

Les fichiers temporaires générés pendant la numérisation sont supprimés après l'envoi et écrasés par 35 passes de bits aléatoires pour éviter toute récupération. Aucun fichier n'est conservé et/ou récupérable sur l'ordinateur ayant servi à la numérisation, pour des raisons de sécurité. Ceci est utile notamment si vous transmettez du courrier arrivé par la Poste à une personne en voyage au bout du monde ;-)

##Développeurs

Le logiciel est composé de 3 programmes shell/bash :

• scan2thunderbird.sh, programme principal qui appelle les commandes externes des logiciels utilisés,
• scan2thunderbird.lang, qui contient les messages d'information et d'erreur avec leur traduction,
• scan2thunderbird.conf, fichier de configuration.

Toutes les fonctions sont commentées.

Le logiciel utilise scanimage (inclus dans sane-utils) pour numériser le document au format .tiff. ImageMagick convertit les images .tiff en .jpg et les assemble dans un PDF. Le tout est compressé avec Gzip puis placé en pièce jointe dans Thunderbird. Shred (inclus dans coreutils) supprime enfin les fichiers temporaires avec 35 passes de données aléatoires. L'interface graphique est fournie par Zenity, qui implémente les librairies Gtk dans un script shell.