Manuel de l'Utilisateur calibre

Manuel de lUtilisateur calibreVersion 3.17.0

Kovid Goyal

fvrier 09, 2018

Table des matires

1 LInterface Graphique Utilisateur 3

2 Ajouter votre site web favori dactualits 27

3 La visionneuse de livre numrique 59

4 Conversion de livre numrique 63

5 diter des livres numriques 81

6 Le Serveur de contenu calibre 115

7 Comparer des livres numriques 123

8 diter les mtadonnes dun livre numrique 127

9 Questions Frquemment Poses 131

10 Tutoriels 155

11 Personnaliser calibre 231

12 Interface en ligne de commande 267

13 Mise en place dun environnement de dveloppement calibre 303

14 Glossaire 327

Index des modules Python 329

Index 331

i

Manuel de lUtilisateur calibre, Version 3.17.0

calibre est un gestionnaire de bibliothque de livres numriques. Il peut visualiser, convertir et cataloguer des livresnumriques dans la plupart des principaux formats. Il peut aussi communiquer avec beaucoup de priphriques delecture de livre numrique. Il peut aller sur Internet et chercher des mtadonnes pour vos livres. Il peut tlchargerdes journaux et les convertir en livres numriques pour une lecture confortable. Il est multi-plateforme, fonctionnantsur Linux, Windows et Mac macOS .

Vous venez de commencer avec calibre. Quallez-vous faire maintenant ? Avant que calibre puisse faire quoique ce soitavec vos livres numriques, il faut dabord quil les connaisse. Glissez et dposez quelques fichiers de livre numriquedans calibre, ou cliquez sur le bouton Ajouter des livres et slectionnez les livres numriques avec lesquels vousvoulez travailler. Une fois que vous aurez ajout ces livres, ils apparatront dans lcran principal ressemblant quelquechose comme ceci :

Une fois que vous aurez admir avec satisfaction la liste des livres que vous venez dajouter, vous aurez probablementenvie de les lire. Pour ce faire, vous devrez convertir le livre dans un format que votre liseuse comprenne. Lors de lapremire ouverture de calibre, lAssistant de Bienvenue a dmarr et a paramtr calibre pour votre priphrique delecture. La conversion est un jeu denfant. Il suffit de slectionner le livre que vous voulez convertir, puis de cliquersur le bouton Convertir des livres . Ignorer toutes les options pour linstant et cliquez sur OK . La petite icnedans le coin en bas droite va commencer tourner. Une fois que cest fini, votre livre converti est prt. Cliquez sur lebouton Visualiser pour lire le livre.

Si vous voulez lire le livre sur votre liseuse, connectez-la lordinateur, attendez que calibre la dtecte (10-20 se-condes), puis cliquez sur le bouton Envoyer au priphrique . Une fois que licne sarrte de tourner nouveau,dconnectez votre liseuse et lisez tout de suite ! Si vous naviez pas converti le livre dans ltape prcdente, calibrelaura automatiquement fait pour que le livre soit dans un format que votre priphrique de lecture peut comprendre.

Pour vous lancer dans un usage plus avanc, vous devriez lire LInterface Graphique Utilisateur (page 3). Pour encoreplus de puissance et de polyvalence, apprenez Interface en ligne de commande (page 267). Vous trouverez la liste desQuestions Frquemment Poses (page 131) bien utile elle aussi.

Sections

Table des matires 1


2 Table des matires

CHAPITRE 1

LInterface Graphique Utilisateur

LInterface Graphique Utilisateur (GUI) permet daccder toute la gestion de la bibliothque et aux caractristiquesde conversion des formats de livre numrique. La mthode de travail basique pour lutilisation de calibre est daborddajouter des livres la bibliothque depuis votre disque dur. calibre essaiera de lire les mtadonnes des livres et lesajoutera sa base de donne interne. Une fois quils sont dans la base de donnes, vous pouvez effectuer diffrentesActions (page 4) sur ceux-ci incluant la conversion dun format un autre, transfrer vers le priphrique de lecture,visualiser sur votre ordinateur, et diter les mtadonnes. Cette dernire inclut la modification de la couverture, de ladescription et les tiquettes parmi dautres dtails. Notez que calibre cre des copies des fichiers que vous lui ajoutez.Vos fichiers originaux sont laisss intacts.

Linterface est divise en diffrentes sections :

Actions (page 4) Prfrences (page 10) Catalogues (page 11) Rechercher et trier (page 11) Linterface de recherche (page 12) Recherches sauvegardes (page 14) Bibliothques virtuelles (page 16) Deviner les mtadonnes partir des noms de fichier (page 16) Dtails du livre (page 17) Navigateur dtiquettes (page 19) Grille de couvertures (page 21) Navigateur de couvertures (page 22) Affichage rapide (page 22) Tches (page 23) Raccourcis clavier (page 23)

3


1.1 Actions

La barre doutils contient des raccourcis pratiques pour les actions couramment utilises. Si vous faites un clic droitsur les icnes, vous pouvez effectuer des variations de laction par dfaut. Notez que la barre doutils a une apparencelgrement diffrente selon que vous avez un lecteur de livre numrique connect votre ordinateur ou pas.

Ajouter des livres (page 4) Modifier les mtadonnes (page 5) Convertir des livres (page 5) Visualiser (page 6) Envoyer vers le priphrique (page 6) Rcuprer des informations (page 7) Bibliothque (page 7) Priphrique connect (page 8) Enregistrer sous. . . (page 8) Connecter/partager (page 9) Supprimer des livres (page 10)

1.1.1 Ajouter des livres

Laction Ajouter des livres a sept variations accessibles en faisant un clic droit sur le bouton.

1. Ajouter des livres partir dun rpertoire unique : ouvre une bote de dialogue de slection de fichiers etvous permet de spcifier quels livres doivent tre ajouts partir dun rpertoire. Cette action est sensible aucontexte, cest dire quelle dpend de quel catalogue (page 11) vous avez slectionn. Si vous avez slectionnla Bibliothque , les livres seront ajouts la bibliothque. Si vous avez slectionn le priphrique de lecturede livre numrique, les livres seront tlchargs sur le priphrique, et ainsi de suite.

2. Ajouter des livres partir dun rpertoire et sous-rpertoires (un livre par rpertoire, tous les fichierstant considrs comme tant le mme livre dans des formats diffrents) : permet de slectionner unrpertoire. Le rpertoire et tous ses sous-rpertoires sont analyss de manire rcursive et les livres numriquestrouvs sont ajouts la bibliothque. calibre suppose que chaque rpertoire contient un seul livre. Tous lesfichiers de livre numrique contenus dans un mme rpertoire sont supposs tre le mme livre dans diffrentsformats. Cette action est linverse de laction Enregistrer sous . . . (page 8) , cest dire que vous pouvez lesEnregistrer sous . . . , les supprimer et les ajouter nouveau sans perte dinformation lexception de la date(en supposant que vous navez chang aucun des rglages de laction Enregistrer sous. . . ).

3. Ajouter des livres partir dun rpertoire et sous-rpertoires (plusieurs livres par rpertoire, chaquefichier tant un livre diffrent) : Permet de slectionner un rpertoire. Le rpertoire et tous ses sous-rpertoiressont analyss de manire rcursive et les livres numriques trouvs sont ajouts la bibliothque. calibresuppose que chaque rpertoire contient de nombreux livres. Tous les fichiers de livre numrique avec le mmenom dans un rpertoire sont supposs tre le mme livre dans diffrents formats. Les livres numriques avecdes noms diffrents sont ajouts comme des livres diffrents.

4 Chapitre 1. LInterface Graphique Utilisateur


4. Ajouter de multiples livres partir dun dossier compress (ZIP/RAR) : vous permet dajouter de multipleslivres numriques qui sont stocks lintrieur des fichiers ZIP ou RAR slectionns. Cest un raccourcipratique qui vite de devoir dabord dcompresser des archives et puis dajouter les livres par lintermdiairedune des deux options ci-dessus.

5. Ajouter un livre vide (une entre de livre sans formats) : vous permet de crer un fichier livre vide. Cela peutservir remplir manuellement les informations sur un livre que vous navez pas encore dans votre collection.

6. Ajouter partir de lISBN : Vous permet dajouter un ou plusieurs livres en entrant leurs numros ISBN.7. Ajouter les fichiers aux enregistrements de livre slectionns : Vous permet dajouter ou de mettre les

fichiers jour lis un livre existant dans votre bibliothque.Laction Ajouter des livres peut lire les mtadonnes partir dune grande varit de formats de livres numriques. Enoutre, calibre essaie de deviner les mtadonnes du fichier. Voir la section Deviner les mtadonnes partir des nomsde fichier (page 16) pour apprendre comment configurer cela.

Pour ajouter un format additionnel un livre existant vous pouvez faire nimporte laquelle de ces trois actions :1. Glisser et dposer le fichier sur le panneau des dtails du livre sur le ct droit de la fentre principale.2. Faire un clic droit sur le bouton Ajouter des livres et choisir Ajouter des fichiers aux livres slectionns.3. Cliquer le bouton Ajouter des livres dans la partie suprieure droite de la bote de dialogue Modifier les mta-

donnes, accd par laction Modifier les mtadonnes (page 5).

1.1.2 Modifier les mtadonnes

Laction Modifier les mtadonnes a quatre variations accessibles en faisant un clic droit sur lebouton.

1. Modifier les mtadonnes individuellement : permet de modifier les mtadonnes des livres un par un, avecla possibilit de rcuprer des mtadonnes, y compris les couvertures, partir de lInternet. Il vous permetgalement dajouter ou de supprimer des formats de livres numriques particuliers pour ce livre.

2. Modifier les mtadonnes par lot : Permet de modifier les champs de mtadonnes communes plusieurslivres, de manire simultane. Cela fonctionne pour tous les livres que vous avez slectionns dans la Vuebibliothque (page 11).

3. Tlcharger les mtadonnes et les couvertures : Tlcharge les mtadonnes et les couvertures (si dispo-nible) pour les livres qui sont slectionns dans la liste de livres.

4. Fusionner les enregistrements de livres : Vous donne la possibilit de fusionner les mtadonnes et lesformats de deux ou plusieurs enregistrements de livres. Vous pouvez choisir de supprimer ou de conserverles enregistrements qui nont pas t cliqu en premier.

Pour plus de dtails voir diter les mtadonnes dun livre numrique (page 127).

1.1.3 Convertir des livres

Les livres numriques peuvent tre convertis partir dun certain nombre de formats dans leformat que votre liseuse prfre. De nombreux livres numriques disponibles lachat seront protgs par la technolo-

1.1. Actions 5


gie Digital Rights Management 1 (DRM). calibre ne sait pas convertir ces livres numriques. Il est facile de supprimerles DRM de nombreux formats, mais cest illgal, vous devrez trouver vous-mme des outils pour dverrouiller voslivres et utiliser ensuite calibre pour les convertir.

Pour la plupart des gens, la conversion devrait tre laffaire dun simple clic. Si vous voulez en savoir plus sur leprocessus de conversion, voir Conversion de livre numrique (page 63).

Laction Convertir des livres a trois variations accessibles en faisant un clic droit sur le bouton.1. Convertir individuellement : Vous permet de spcifier les options de conversion pour personnaliser la conver-

sion de chaque livre numrique slectionn.2. Convertir par lot : Vous permet de spcifier des options quune seule fois pour convertir un certain nombre

de livres numriques en mme temps.3. Crer un catalogue des livres de votre bibliothque calibre : Vous permet de gnrer une liste complte

des livres dans votre bibliothque, en y prcisant les mtadonnes, et ce dans plusieurs formats tels que XML,CSV, BiBTeX, EPUB et MOBI. Le catalogue contiendra tous les livres se trouvant visibles ce moment dansla vue bibliothque. Cela vous permet dutiliser les fonctions de recherche pour limiter les livres cataloguer.En outre, si vous slectionnez plusieurs livres avec la souris, seuls les livres slectionns seront compris dansle catalogue. Si vous gnrez le catalogue dans un format de livre numrique comme EPUB, MOBI ou AZW3,la prochaine fois que vous connecterez votre lecteur de livre numrique, le catalogue sera envoy automatique-ment au priphrique. Pour avoir plus dinformations sur comment fonctionne les catalogues lisez Cration decatalogues AZW3 EPUB MOBI (page 222).

1.1.4 Visualiser

Laction Visualiser affiche le livre dans un programme de visualisation de livre numrique. calibrea une visionneuse intgre qui fonctionne pour de nombreux formats de livre numrique. Pour dautres formats, ilutilise lapplication du systme dexploitation par dfaut. Vous pouvez configurer les formats qui doivent souvrir avecla visionneuse interne via PrfrencesIntervaceComportement. Si un livre a plus dun format, vous pouvez voirun format particulier en faisant un clic droit sur le bouton.

1.1.5 Envoyer vers le priphrique

Laction Envoyer vers le priphrique dispose de huit variations, accessibles en faisant un clicdroit sur le bouton.

1. Envoyer vers la mmoire principale : Les livres slectionns sont transfrs vers la mmoire principale dulecteur de livre numrique.

2. Envoyer vers la carte mmoire (A) : Les livres slectionns sont transfrs vers la carte de stockage (A) dulecteur de livre numrique.

3. Envoyer vers la carte mmoire (B) : Les livres slectionns sont transfrs vers la carte de stockage (B) dulecteur de livre numrique.

1. https://drmfree.calibre-ebook.com/about#drm


https://drmfree.calibre-ebook.com/about#drm


4. Envoyer un format spcifique vers : Les livres slectionns sont transfrs vers lemplacement de stockageslectionn du priphrique, dans le format que vous spcifiez.

5. jecter le priphrique : Dtache le priphrique de calibre.6. **Indiquer laction par dfaut pour envoyer au dispoitif ** : Vous permet de spcifier laquelle des options, 1

5 ci-dessus ou 7 ci-dessous, sera laction par dfaut lorsque vous cliquez sur le bouton principal.7. Envoyer et effacer de la bibliothque : Les livres slectionns sont transfrs vers lemplacement de stockage

slectionn sur le priphrique, et puis supprimes de la bibliothque.8. Rcuprer les annotations (exprimental) : Transfre des annotations que vous avez faites sur un livre nu-

mrique depuis votre priphrique, vers la mtadonne commentaires du livre dans la bibliothque calibre.Vous pouvez contrler le nom du fichier et la structure du dossier des fichiers envoys au priphrique en mettanten place un modle dans PrfrencesImporter/exporterEnvoyer des livres aux priphriques. Voir galement Lelangage de modle calibre (page 163).

1.1.6 Rcuprer des informations

Laction Rcuprer des Actualits permet de tlcharger des actualits de divers sites web et deles convertir en un livre numrique qui peut tre lu sur votre liseuse. Normalement, le livre numrique nouvellementcr est ajout votre bibliothque, mais si un lecteur de livre numrique est connect au moment o se termine letlchargement, les actualits sont galement automatiquement tlcharges sur le lecteur.

Laction Rcuprer des Actualits utilise une simple recette (10-15 lignes de code) pour chaque site dactualit. Pourapprendre crer des recettes pour vos propres sources dinformations, voir Ajouter votre site web favori dactualits(page 27).

Laction Rcuprer des informations a trois variations accessibles en faisant un clic droit sur le bouton.1. Planifier le tlchargement des informations : Permet de programmer le tlchargement de vos sources

dactualits slectionnes partir dune liste de centaines disponibles. La planification peut tre rgle demanire particulire pour chaque source dactualits que vous slectionnez et la planification est flexible vouspermettant de slectionner certains jours de la semaine ou une frquence de jours entre les tlchargements.

2. Ajouter une source personnalise dactualits : Vous permet de crer une recette simple pour tlchargerdes nouvelles dun site dinformation personnalis auquel vous souhaitez accder. La cration de la recettepeut tre aussi simple que de spcifier un flux dactualits RSS, ou vous pouvez tre plus normatif en crantun code sur base Python pour la tche. Pour plus dinformation voir Ajouter votre site web favori dactualits(page 27).

3. Tlcharger toutes les sources dactualits planifies : entrane que calibre se met immdiatement tl-charger toutes les sources dinformation que vous avez programmes.

1.1.7 Bibliothque

Laction Bibliothque vous permet de crer, de basculer entre, de renommer ou de supprimer unebibliothque. calibre vous permet de crer autant de bibliothques que vous le souhaitez. Vous pourriez par exemple,

1.1. Actions 7


crer une bibliothque fiction, une bibliothque non-fiction, une bibliothque de langue trangre, une bibliothqueprojet, ou toute structure qui conviendrait vos besoins. Les bibliothques sont les plus hautes structures organisa-tionnelles dans calibre. Chaque bibliothque a son propre ensemble de livres, tiquettes, catgories et emplacement destockage de base.

1. Basculer/crer une bibliothque. . . . Vous permet de ; a) vous connecter une bibliothque calibre prexis-tante un autre emplacement, b) crer une bibliothque vide un nouvel emplacement ou, c) dplacer labibliothque existante un emplacement nouvellement spcifi.

2. Bascule rapide : Vous permet de basculer entre des bibliothques qui ont t enregistre ou cre dans calibre.3. Renommer un bibliothque : Vous permet de renommer une Bibliothque.4. Supprimer une bibliothque : Vous permet de ds-enregistrer une bibliothque de calibre.5. : Les actions 5, 6 etc. . . vous donne un accs en basculement immdiat entre les

diffrentes bibliothques que vous avez cres ou attaches. La liste contient uniquement les 5 bibliothquesles plus frquemment utilises. Pour la liste complte, utiliser le menu Bascule Rapide.

6. Maintenance de la bibliothque : Vous permet de vrifier les problmes de consistance de la bibliothquecourante et restaure la base de donne de la bibliothque depuis des sauvegardes.

Note : Les mtadonnes concernant vos livres numriques, par ex. titre, auteur, et tiquettes sont stockes dans unseul fichier dans votre rpertoire de bibliothque calibre appel metadata.db. Si ce fichier se corrompt (un vnementtrs rare), vous perdez les mtadonnes. Heureusement, calibre sauvegarde automatiquement les mtadonnes pourchaque livre individuel dans le rpertoire du livre en tant que fichier OPF. En utilisant laction Restaurer la base dedonnes sous Maintenance de la bibliothque dcrite ci-dessus, calibre peut reconstruire le fichier metadata.db depuisles fichiers individuels OPF pour vous.

Vous pouvez copier ou dplacer des livres entre les diffrentes bibliothques (une fois que vous avez install plusdune bibliothque) en faisant un clic-droit sur le livre et en slectionnant laction Copier dans la bibliothque.

1.1.8 Priphrique connect

Laction Priphrique vous permet de consulter les livres de la mmoire principale ou des cartes destockage de votre priphrique de lecture, ou djecter le priphrique (le dtacher de calibre). Cette icne apparatautomatiquement dans la barre doutils principale de calibre lorsque vous connectez un priphrique pris en charge.Vous pouvez cliquer sur licne pour voir les livres qui sont sur votre priphrique. Vous pouvez galement faireglisser et dposer des livres de votre bibliothque calibre sur licne Priphrique pour les transfrer sur votre liseuse.Inversement, vous pouvez glisser et dposer des livres partir de votre priphrique sur licne de la bibliothque dela barre doutils pour transfrer des livres partir de votre priphrique vers la bibliothque calibre.

1.1.9 Enregistrer sous. . .

Laction Enregistrer sous. . . a cinq variations, accessibles en faisant un clic droit sur le bouton.



1. Enregistrer sous. . . : sauve les livres slectionns vers le disque organiss en rpertoires. La structuredu rpertoire ressemble

Author_(sort)Title

Book Files

Vous pouvez contrler le nom du fichier et la structure des rpertoires des fichiers lors de la copie sur ledisque en mettant en place un modle dans PrfrencesImporter/exporterSauvegarde de livres sur ledisque. Voir aussi Le langage de modle calibre (page 163).

2. Enregistrer sur le disque dans un seul rpertoire : Enregistre les livres slectionns vers le disquedans un rpertoire unique.

Pour 1. et 2., tous les formats disponibles, ainsi que les mtadonnes, sont stocks sur le disque pourchaque livre slectionn. Les mtadonnes sont stockes dans un fichier OPF. Livres enregistrs peuventtre rimports dans la bibliothque sans aucune perte dinformation en utilisant laction Ajouter des livres(page 4).

3. Enregistrer seulement ** sur le disque : Enregistre les livres slec-tionns sur le disque dans la structure de rpertoire comme montre en (1), mais seulementpour votre format de livre numrique prfr. Vous pouvez dfinir votre format prfr dansPrfrencesInterfaceComportementFormat de sortie prfr.

4. Enregistrer seulement ** sur le disque dans un rpertoire unique :Enregistre les livres slectionns sur le disque dans un rpertoire unique, mais seulementdans votre format de livre numrique prfr. Vous pouvez dfinir votre format prfr dansPrfrencesInterfaceComportementFormat de sortie prfr.

5. Enregistrer un seul format vers le disque. . . : Enregistre les livres slectionns sur le disque dans lastructure de rpertoire comme montre en (1), mais seulement dans le format que vous slectionnezdans la liste contextuelle.

1.1.10 Connecter/partager

Laction Connecter/partager vous permet de vous connecter manuellement un priphrique ouun dossier sur votre ordinateur. Il vous permet galement de mettre en place laccs votre bibliothque calibre via unnavigateur web ou par courriel.

Laction Connecter/partager a quatre variations, accessibles en faisant un clic-droit sur le bouton.

1. Connectez au dossier : Vous permet de vous connecter nimporte quel dossier de votre ordinateurcomme sil sagissait dun priphrique et dutiliser pour ce dossier toutes les fonctionnalits quecalibre utilise avec les priphriques. Utile si votre priphrique ne peut pas tre pris en charge parcalibre, mais est disponible en tant que disque USB.

2. Dmarrer le Serveur de contenu : Dmarre le serveur web intgr de calibre. Au dmarrage, votrebibliothque calibre sera accessible via un navigateur Web partir dInternet (si vous le voulez). Vouspouvez configurer la faon dont le serveur Web est accessible en dfinissant des prfrences dansPrfrencesPartagerPartager via Internet

3. Configurer le partage des livres par courriel : Permet de partager des livres et des fils dinformationpar courriel. Aprs la mise en place des adresses courriel pour cette option, calibre enverra les mises jour des actualits et les mises jour de livres au carnet dadresses de messagerie saisies. Vous pouvez

1.1. Actions 9


configurer la faon dont calibre envoie un courriel en dfinissant des prfrences dans PrfrencesPartager Partager des livres par courriel. Une fois que vous avez mis en place une ou plusieursadresses courriel, cette entre de menu sera remplace par des entres de menu pour envoyer deslivres aux adresses de messagerie configures.

1.1.11 Supprimer des livres

Laction Supprimer des livres supprime les livres de manire permanente aussi utilisez-laavec prcaution. Il est sensible au contexte, cest dire quil dpend de quel catalogue (page 11) vous avez slectionn.Si vous avez slectionn Bibliothque, les livres seront retirs de la bibliothque. Si vous tes sur la liste des livresde votre liseuse, les livres seront retirs du priphrique. Pour supprimer uniquement un format particulier pour unlivre donn, utiliser laction Modifier les mtadonnes (page 5). Supprimer des livres a galement cinq variations quipeuvent tre accessibles en faisant un clic-droit sur le bouton.

1. Supprimer les livres slectionns : Vous permet de supprimer dfinitivement tous les livres qui sont slec-tionns dans la liste de livres.

2. Supprimer les fichiers dun format spcifique pour les livres slectionns . . . : Permet de supprimer dfi-nitivement un fichier de livre numrique dun format spcifi pour ceux qui sont slectionns dans la liste delivres.

3. Supprimer tous les formats pour les livres slectionns, except. . . : Vous permet de supprimer dfini-tivement les fichiers de livres numriques de nimporte quel format sauf celui spcifi pour ceux qui sontslectionns dans la liste de livres.

4. Supprimer tous les formats des livres slectionns : Vous permet de supprimer dfinitivement tous lesformats pour les livres qui sont slectionns dans la liste de livres. Seules les mtadonnes seront conserves.

5. Supprimer les couvertures des livres slectionns : Vous permet de supprimer dfinitivement des fichiersde couverture des livres qui sont slectionns dans la liste de livres.

6. Supprimer les livres correspondants du priphrique : Vous permet de supprimer les livres numriquesdun priphrique connect qui correspondent ceux slectionns dans la liste de livres,

Note : Notez que quand vous utilisez Supprimer les livres pour retirer des livres de votre bibliothque calibre, lenre-gistrement du livre est dfinitivement supprim, mais sur Windows et macOS, les fichiers sont placs dans la corbeille.Cela vous permet de les rcuprer si vous changez davis.

1.2 Prfrences

Laction Prfrences vous permet de modifier de diverses faons la manire dont calibre fonc-tionne. Elle dispose de quatre variations, accessibles en faisant un clic droit sur le bouton.

1. Prfrences : vous permet de modifier de diverses faons la manire dont calibre fonctionne. Cliquer sur lebouton effectue aussi cette action.



2. Dmarrer lassistant de bienvenue : Vous permet de dmarrer lAssistant de Bienvenue qui apparat la pre-mire fois que vous avez dmarr calibre.

3. Obtenir des extensions pour amliorer calibre : Ouvre une nouvelle fentre qui affiche les extensions pourcalibre. Ces extensions sont dveloppes par des parties tierces pour tendre les fonctionnalits de calibre.

4. Redmarrer en mode dpannage : Vous permet dactiver mode de dpannage qui peut assister les dve-loppeurs de calibre rsoudre des problmes que vous rencontrez avec le programme. Pour la plupart desutilisateurs ceci devraient rester dsactiv moins dune instruction dun dveloppeur pour lactiver.

1.3 Catalogues

Un catalogue est une collection de livres. calibre peut grer deux types de catalogues diffrents :

1. Bibliothque : Cest une collection de livres stocks dans votre bibliothque calibre sur votre ordinateur.2. Priphrique : Cest une collection de livres stocks dans votre lecteur de livre numrique. Elle sera disponible

lorsque vous connecterez le lecteur votre ordinateur.

De nombreuses oprations, telles que lajout des livres, la suppression, la visualisation, etc., sont sensibles au contexte.Ainsi, par exemple, si vous cliquez sur le bouton Visualiser quand vous avez le catalogue du Priphrique slectionn,calibre va ouvrir le fichier sur le priphrique. Si vous avez slectionn le catalogue de la Bibliothque slectionne,le fichier de votre bibliothque calibre sera ouvert la place.

1.4 Rechercher et trier

Loption rechercher et trier vous permet deffectuer un certain nombre dactions puissantes sur votre collection delivres.

1.3. Catalogues 11


Vous pouvez les trier par titre, auteur, date, note, etc. en cliquant sur les titres des colonnes. Vous pouvezgalement faire des tri sur plusieurs cls, cest dire un tri sur plusieurs colonnes. Par exemple, si vous cliquezsur la colonne titre, puis la colonne auteur, le livre sera tri par auteur, puis toutes les entres pour un mmeauteur seront tries par titre.

Vous pouvez rechercher un livre ou un ensemble de livres en utilisant la Barre de recherche. Plus de dtailsci-dessous ce propos.

Vous pouvez rapidement et facilement modifier les mtadonnes en slectionnant lentre que vous souhaitezmodifier dans la liste et en appuyant sur la touche E.

Vous pouvez effectuer des Actions (page 4) sur des ensembles de livres. Pour slectionner de multiples livresvous pouvez soit : Maintenir la touche Ctrl enfonce et cliquer sur tous les livres que vous voulez slectionner Maintenir la touche Shift enfonce et cliquer sur le premier puis sur le dernier livre dun ventail de

livres que vous voulez slectionner. Vous pouvez configurer quels champs (colonnes) vous souhaitez afficher en utilisant le dialogue Prfrences

(page 10).

1.5 Linterface de recherche

Vous pouvez faire des recherches sur toutes les mtadonnes en entrant des termes de recherche dans la Barre derecherche. Les recherches sont insensibles la casse. Par exemple :

Asimov Foundation format:lrf

Cela correspondra tous les livres dans votre bibliothque qui ont les mots Asimov et Fondation dans leurs mtadon-nes et qui sont disponibles dans le format LRF. Quelques exemples de plus :

author:Asimov and not series:Foundationtitle:"The Ring" or "This book is about a ring"format:epub publisher:feedbooks.com

Les recherches sont par dfaut contains. Un lment correspond si la chane de recherche apparat nimporte o dansles mtadonnes indiques. Deux autres types de recherches sont disponibles : recherche de lgalit et recherche enutilisant des expressions rgulires 2.

Les recherches sur lgalit sont indiques en prfixant la chane de recherche avec le signe gal (=). Par exemple, larequte tag:"=science" ne prendra que les livres dont ltiquette sera gale science , mais pas sciencefiction ou science exacte . Les recherches avec des expressions rgulires sont indiques en prfixant la chanede recherche avec un tilde (~). Toutes les expressions rgulires compatibles Python 3 peuvent tre utilises. Notezque les barres obliques utilises pour grer certains caractres spciaux dans les expressions rgulires doivent tredoubles parce que les barres simples seront supprims lors de lanalyse des requtes. Par exemple, pour correspondre une parenthse ouvrante vous devez saisir \\(. Les recherches avec des expressions rgulires sont des recherchescontient moins que lexpression contienne des ancres.

Si vous avez besoin de rechercher une chane contenant le signe gal ou un tilde, faites prcder la chane dune barreoblique inverse.

Mettez les chanes de recherche entre guillemets ( ) si la chane contient des parenthses ou des espaces. Parexemple, pour rechercher ltiquette Science Fiction vous aurez besoin de rechercher aprs tag:"=sciencefiction". Si vous chercher aprs tag:=science fiction vous trouverez tous les livres avec ltiquettescience et avec le mot fiction dans toutes les mtadonnes.

2. https://fr.wikipedia.org/wiki/Regular_expression3. https://docs.python.org/2/library/re.html


https://fr.wikipedia.org/wiki/Regular_expressionhttps://docs.python.org/2/library/re.html


Vous pouvez crer facilement des requtes de recherche avances en utilisant Bote de dialogue recherche avance

accessible en cliquant sur le bouton .

Les champs disponibles pour la recherche sont : tag, title, author, publisher, series,series_index, rating, cover, comments, format, identifiers, date, pubdate,search, size, vl et les colonnes personnalises. Si un priphrique est connect, le champ ondevice devientdisponible, en recherchant la vue bibliothque de calibre. Pour trouver le nom de recherche (appele actuellement laconsultation de nom) pour une colonne personnalise, placez votre souris au dessus de lentte de colonne dans la vuebibliothque.

La syntaxe pour rechercher des dates est :

pubdate:>2000-1 Will find all books published after Jan, 2000date:10daysagodate:1.1M Will find books with a format larger than 1.1MBsize: (plus grand que), >= (plus grand queou gal ), < (plus petit que), =3 trouvera les livres nots 3 ou suprieur.

Vous pouvez chercher le nombre dlments dans des champs valeur multiple comme les tiquettes. Ces recherchescommencent avec le caractre #, et ensuite utilisent la mme syntaxe que les champs numriques. Par exemple, pourtrouver tous les livres avec plus de 4 tiquettes utilisez tags:#>4. Pour trouver tous les livres avec exactement 10tiquettes utilisez tags:#=10.

Les indices des sries peuvent faire lobjet dune recherche. Pour les sries standard, le nom de recherche est se-ries_index. Pour les colonnes personnalises de sries, utilisez le nom de recherche de la colonne suivit par _index.Par exemple, pour rechercher les indices pour une colonne de sries personnalise #my_series, vous devrez utiliserle nom de recherche #my_series_index. Les indices de sries sont des nombres, donc vous pouvez utiliser lesoprateurs relationnels dcrits plus haut.

Le champ spcial search est utilis pour les recherches enregistres. Donc, si vous enregistrez une recherche avec lenom Les livres de mon conjoint vous pouvez entrer ensuite search:"Les livres de mon conjoint"dans la Barre de recherche pour rutiliser la recherche enregistre. Plus dinformations au sujet des recherches sauve-gardes ci-dessous.

Le champ spcial vl est utilis pour chercher des livres dans une bibliothque virtuelle. Par exemple, vl:Lu trouveratous les livres dans la bibliothque virtuelle Lu. La recherche vl:Lu and vl:"Science Fiction" trouvera

1.5. Linterface de recherche 13


tous les livres qui sont tant dans les bibliothques virtuelles Lu que Science Fiction. La valeur suivant vl: doit trele nom dune bibliothque virtuelle. Si le nom de la bibliothque virtuelle contient des espaces entourez-le alors avecdes guillemets.

Vous pouvez rechercher une prsence ou une absence dans un champ en utilisant les valeurs spciales true et false . Par exemple :

cover:false will give you all books without a coverseries:true will give you all books that belong to a seriescomments:false will give you all books with an empty commentformat:false will give you all books with no actual files (empty records)

Les colonnes personnalises oui/non peuvent faire lobjet dune recherche. Faire une recherche false, empty, oublank trouvera tous les livres avec des valeurs indfinies dans la colonne. Faire une recherche true trouvera leslivres qui nont pas de valeurs indfinies dans la colonne. Faire une recherche yes ou checked trouvera tous leslivres avec Yes dans la colonne. Faire une recherche no ou unchecked trouvera tous les livres avec No dans lacolonne. Notez que les mots yes, no, blank, empty, checked et unchecked sont traduits ; vous pouvez utilisersoit utiliser le mot quivalent dans la langue courante ou le mot anglais. Les mots true et false et les valeursspciales _yes, _no, et _empty ne sont pas traduits.

Les lments hirarchiques (par exemple A.B.C) utilisent une syntaxe tendue pour faire correspondre les partiesinitiales de la hirarchie. Il faut ajouter un point entre lindicateur de correspondance dgalit(=) et le texte. Parexemple, requte tags:=.A trouvera les tiquettes A et A.B`, mais pas les tiquettes AA ou AA.B. La requte ``tags:=.A.B va trouver les tiquettes A.B et A.B.C, mais pas ltiquette A.

Les identifiants (par exemple, isbn, doi, iccn etc) utilisent galement cette syntaxe. Tout dabord, notez quun iden-tifiant le format type:value, comme dans isbn:123456789. La syntaxe tendue vous permet de spcifierde faon indpendante quel type et quelle valeur rechercher. Le type et la valeur de la requte peuvent utiliser lescorrespondances galit, contientou expression rgulire. Exemples :

identifiers:true trouvera les livres avec nimporte quel identifiant. identifiers:false trouvera les livres sans identifiant. identifiers:123 recherchera des livres de nimporte quel type qui ont une valeur contenant 123. identifiers:=123456789 recherchera des livres de nimporte quel type qui ont une valeur gale

123456789. identifiers:=isbn: et identifiers:isbn:true trouvera les livres avec un type gal isbn et

ayant nimporte quelle valeur indentifiers:=isbn:false trouvera les livres avec un type nquivalant pas isbn. identifiers:=isbn:123 trouvera les livres avec un type gal isbn ayant une valeur contenant 123. identifiers:=isbn:=123456789 trouvera les livres avec un type gal isbn et ayant une valeur gale

123456789. identifiers:i:1 trouvera les livres avec un type contenant un i ayant une valeur contenant un 1.

1.6 Recherches sauvegardes

calibre vous permet de sauvegarder une recherche frquemment utilise sous une dnomination spciale et ensuitede rutiliser cette recherche avec un simple clic. Pour ce faire, crez votre recherche soit en tapant dans la Barre derecherche ou en utilisant le Navigateur dtiquettes. Ensuite, tapez le nom que vous souhaitez donner la recherchedans la zone Recherches Sauvegardes, droite de la Barre de recherche. Cliquez sur licne + ct de la boterecherches enregistres pour sauver la recherche.

Maintenant, vous pouvez accder votre recherche sauvegarde dans le Navigateur dtiquettes sous la rubrique Recherches . Un simple clic vous permettra de rutiliser facilement toute recherche complexe, sans avoir larecrer.



Fig. 1.1 Bote de dialogue recherche avance

1.6. Recherches sauvegardes 15


1.7 Bibliothques virtuelles

Une Bibliothque virtuelle est une manire de prtendre que votre bibliothque calibre a seulement quelques livresplutt que sa collection complte. Cest une excellente manire de partitionner votre large collection de livres endes entits plus petites, mieux grable. Pour apprendre comment crer et utiliser des bibliothques virtuelles, voir letutoriel : Bibliothques virtuelles (page 227).

1.8 Deviner les mtadonnes partir des noms de fichier

Normalement, calibre lit les mtadonnes partir du fichier livre, il peut tre configur pour lire les mtadonnes partir du nom de fichier, via PrfrencesImporter/exporterAjouter des livresLire les mtadonnes partir ducontenu du fichier.

Vous pouvez aussi contrler comment les mtadonnes sont lues partir du nom de fichier en utilisant les expressionsrgulires (voir Tout propos de lutilisation des expressions rgulires dans calibre (page 194)). Dans la sectionAjouter des Livres de la bote de configuration, vous pouvez spcifier une expression rgulire que calibre utiliserapour essayer et deviner les mtadonnes partir des noms de fichier des livres numriques que vous ajoutez votrebibliothque. Lexpression rgulire par dfaut est :

title - author

c.--d., il suppose que tous les caractres jusquau premier - sont le titre du livre et les caractres suivants sontlauteur du livre. Par exemple, le nom de fichier

Foundation and Earth - Isaac Asimov.txt

sera interprt avoir le titre Foundation and Earth et lauteur : Isaac Asimov

Astuce : Si le nom de fichier ne contient pas de trait dunion, lexpression rgulire ci-dessus chouera.



1.9 Dtails du livre

Lcran Dtails du livre affiche la couverture et toutes les mtadonnes pour le livre actuellement slectionn. Il peut

1.9. Dtails du livre 17


tre cach par lintermdiaire du bouton Disposition en bas droite de la fentre principale calibre. Le nom de lauteuraffich dans le panneau Dtail du livre peut tre cliqu, il vous mnera vers la page Wikipedia au sujet de lauteur.Ceci peut tre personnalis en faisant un clic droit sur le nom de lauteur et en slectionnant Grer cet auteur.

Similairement, si vous tlchargez des mtadonnes pour le livre, panneau Dtail du Livre vous affichera des lienspointant vers les pages web du livre sur Amazon, worldcat, etc. depuis o les mtadonnes ont t tlcharges.

Vous pouvez faire un clic droit sur les formats individuels de livre dans le panneau Dtail du livre pour les supprimer,les comparer leurs versions originales, les sauvegarder sur le disque, les ouvrir avec un programme extrieur etc.

Vous pouvez changer la couverture du livre simplement en glissant et dposant une image sur le panneau Dtails duLivre. Si vous voulez utiliser un programme tiers pour diter limage de couverture, faites un simple clic droit dessuset choisissez Ouvrir avec.

Vous pouvez aussi ajouter des fichiers de livre numrique au livre courant en glissant et dposant les fichiers sur lepanneau Dtails du livre.

Double cliquer sur le panneau de Dtails de livre louvrira dans une fentre distincte.

Pour finir, vous pouvez personnaliser exactement quelle information est affiche dans le panneau Dtails du livre parlintermdiaire de PrfrencesApparenceDtails du livre.



1.10 Navigateur dtiquettes

Le Navigateur dtiquettes vous permet de parcourir facilement votre collection par Auteur/tiquettes/ Srie etc. Sivous cliquez sur nimporte quel lment dans le Navigateur dtiquettes, par exemple sur le nom dauteur Isaac Asi-mov, la liste des livres se limitera laffichage des livres de cet auteur. Vous pouvez galement cliquer sur les catgo-ries. Par exemple, si vous cliquez sur Sries vous affichera tous les livres de nimporte quelle srie.

Le premier clic sur un lment permet de limiter la liste des livres ceux qui contiennent ou correspondent cetlment. En reprenant lexemple ci-dessus, en cliquant sur Isaac Asimov vous aurez tous les livres de cet auteur. Encliquant nouveau sur llment, le rsultat dpend si llment a des sous-lments ou non (voir les sous-catgorieset les lments hirarchiques ci-dessous). En continuant lexemple dIsaac Asimov en cliquant nouveau sur IsaacAsimov, vous allez obtenir les livres qui ne sont pas dIsaac Asimov. Un troisime clic va supprimer la restriction,et vous aurez de nouveau tous les livres. Si vous maintenez enfonce la touche Ctrl ou Maj et cliquez sur plusieurslments, la liste prendra en compte toutes les conditions. Par exemple, vous pourriez maintenir la touche Ctrl et cli-quez sur les catgories Histoire et Europe pour trouver des livres sur lhistoire europenne. Le Navigateur dtiquettesfonctionne en construisant des expressions de recherche qui sont entres automatiquement dans la barre de recherche.En regardant ce que le Navigateur dtiquettes gnre vous pourrez facilement apprendre construire des expressions

1.10. Navigateur dtiquettes 19


de recherche de base.

Les lments du Navigateur dtiquettes ont leurs icnes partiellement colores. La quantit de couleur dpend de lanote moyenne des livres dans cette catgorie. Ainsi, par exemple si les livres dIsaac Asimov ont une moyenne dequatre toiles, licne Isaac Asimov dans le Navigateur dtiquettes sera colore au 4/5e. Vous pouvez passer votresouris sur licne pour voir la note moyenne.

Les articles des niveaux externes dans le Navigateur dtiquettes, comme Auteurs et Sries, sont appels catgories.Vous pouvez crer vos propres catgories, appeles Catgories utilisateur, qui sont utiles pour organiser les lments.Par exemple, vous pouvez utiliser lditeur de catgories utilisateur (cliquer le bouton Configurer en bas gauche duNavigateur dtiquettes et choisissez Grer les auteurs, sries, etcCatgories utilisateur) pour crer une Catgorieutilisateur appele Auteurs favoris , mettez alors vos lments favoris dans la catgorie. Les Catgories utilisateurpeuvent avoir des sous catgories. Par exemple, la Catgorie utilisateur Favoris.Auteurs est une sous catgorie deFavoris. Vous pouvez aussi crer Favoris.Sries , dans ce cas il y aura deux sous catgories sous Favoris. Les souscatgories peuvent tre cres en faisant un clic droit sur une Catgorie utilisateur, choisir Ajouter une sous catgorie . . . , et entrer le nom de la sous catgorie ; ou en utilisant lditeur de catgories utilisateur et en entrant les nomscomme lexemple des Favoris ci-dessus.

Vous pouvez rechercher les Catgories utilisateurs de la mme manire que les catgories intgres, en cliquant dessus. Il y a quatre recherches diffrentes faits un cycle en cliquant sur :

1. tout ce qui correspond llment dans la catgorie indique par un seul signe plus vert.

2. tout ce qui correspond llment de la catgorie ou de ses sous-catgories indiqu par deux signesplus verts.

3. tout ce qui ne correspond pas llment dans la catgorie indique par un seul signe moins rouge.

4. tout ce qui ne correspond pas llment dans la catgorie ou dans ses sous-catgories indiques pardeux signes moins rouges.

Il est galement possible de crer des hirarchies lintrieur de certaines catgories texte comme les tiquettes, lessries et les colonnes personnalises. Ces hirarchies apparaissent avec un petit triangle, permettant aux sous lmentsdtre masqus. Pour utiliser les hirarchies dlments dans une catgorie, vous devez vous rendre tout daborddans PrfrencesInterfaceApparenceNavigateur dtiquettes et entrer le(s) nom(s) de catgorie dans la case Catgories avec des articles hirarchiques . Une fois que cest fait, les lments dans cette catgorie qui contiennentdes subdivisions seront affichs en utilisant le petit triangle. Par exemple, prsumons que vous crez une colonnepersonnalise appele Genre et indiquez quelle contient des lments hirarchiques. Une fois fait, les lmentstels que Mystre.Thriller et Mystre.Anglais safficheront comme Mystre avec le petit triangle leur suite. Cliquersur le triangle affichera Thriller et Anglais comme sous lments. Voir Grer des sous groupes de livres, par exemple genre (page 155) pour plus dinformation.

Les lments hirarchiques (lments avec des sous-lments) utilisent les quatre recherches cliquez dessus iden-tiques celles des Catgories utilisateurs. Les lments qui nont pas de sous-lments utilisent deux des recherches : tout ce qui correspond et tout ce qui ne correspond pas .

Vous pouvez glisser et dposer des lments dans le Navigateur dtiquettes sur les Catgories dutilisateurs ajouter cette catgorie. Si la source est une Catgorie utilisateur, maintenez la touche Maj tout en dplaant larticle versla nouvelle catgorie. Vous pouvez aussi glisser et dposer des livres depuis la liste de livres sur les lments duNavigateur dtiquettes ; dposer un livre sur des lments dans le Navigateur dtiquettes entranera que cet lmentsappliquera automatiquement au livre dpos. Par exemple, glisser un livre sur Isaac Asimov tablira lauteur pour celivre Isaac Asimov. Dposer le sur ltiquette Histoire ajoutera ltiquette Histoire aux tiquettes du livre.

Vous pouvez trouver facilement nimporte quel lment dans le Navigateur dtiquettes en cliquant le bouton derecherche en bas droite. En complment, vous pouvez faire un clic droit sur nimporte quel lment et choisir unedes diverses oprations. Certains exemples sont de le cacher, de le renommer, ou douvrir une bote de dialogue Grerx qui vous permet de grer des lments de ce type. Par exemple, la bote de dialogue Grer les auteurs permetde renommer les auteurs et de contrler comment leurs noms sont tris.

Vous pouvez contrler comment les lments sont tris dans le Navigateur dtiquettes par lintermdiaire du boutonConfigurer en bas gauche du Navigateur dtiquettes. Vous pouvez choisir de trier par nom, note moyenne ou popu-



larit (popularit est le nombre de livres avec un lment dans votre bibliothque ; par exemple, la popularit dIsaacAsimov est le nombre de livres par Isaac Asimov dans votre bibliothque).

1.11 Grille de couvertures

calibre peut vous afficher une grille de couvertures la place de la liste de livres. Si vous prfrez plutt naviguer dansvotre collection par couvertures. La Grille de couvertures est active en cliquant sur le bouton Disposition grille dansle coin infrieur droit de la fentre principale de calibre. Vous pouvez personnaliser la taille des couvertures et larrireplan de la Grille de couvertures via PrfrencesInterfaceApparenceGrille de couvertures. calibre peut mmeafficher nimporte quel champ en dessous des couvertures, comme titre, auteurs ou note ou une colonne personnalisede votre propre invention.

1.11. Grille de couvertures 21


1.12 Navigateur de couvertures

En complment de la grille de couvertures dcrite plus haut, calibre peut aussi afficher les couvertures en une simpleligne. Ceci est activ par lintermdiaire dun bouton Disposition dans le coin infrieur droit de la fentre principale.Dans PrfrencesApparenceNavigateur de couvertures vous pouvez changer le nombre de couvertures affiches,et mme avoir le navigateur de couverture safficher dans une fentre distincte.

1.13 Affichage rapide

Parfois vous voulez slectionner un livre et rapidement obtenir une liste de livres avec la mme valeur dans une certainecatgorie (auteurs, tiquettes, diteur, sries, etc.) comme le livre actuellement slectionn, mais sans changer la vueactuelle de votre bibliothque. Vous pouvez faire cela avec Affichage rapide. Affichage rapide ouvre une deuximefentre affichant la liste des livres correspondants la valeur intresse. Par exemple, supposons que vous voulez voirune liste de tous les livres avec un ou plus des auteurs du livre actuellement slectionn. Cliquer dans la cellule delauteur qui vous intresse et appuyez sur la touche Q ou cliquez sur licne Affichage rapide dans la section miseen page de la fentre calibre. Une fentre ou un panneau souvrira avec tous les auteurs pour ce livre sur la gauche ettous les livres pour lauteur slectionn sur la droite.

Quelques exemples des utilisations dAffichage Rapide : voir rapidement que dautres livres : ont certaine(s) tiquette(s) applique(s) au livre actuellement slectionn, sont dans la mme srie que le livre actuel ont les mmes valeurs dans une colonne personnalise que le livre actuel sont crits par lun des mmes auteurs que le livre actuel partager les valeurs dans une colonne personnalise

Il y deux choix pour o faire apparatre linformation Affichage Rapide :

1. Il peut souvrir ancr : au dessus de la fentre calibre et il restera ouvert jusqu ce que vous le fermiezexplicitement.

2. Il peut souvrir dsancr : comme un panneau dans la section liste de livres de la fentre principale decalibre.

Vous pouvez dplacer comme bon vous semble la fentre de verrouill dverrouill en utilisant le bouton An-crer/Dsancrer .



La panneau Affichage rapide peut tre laiss ouvert en permanence, dans ce cas il suivra les mouvements de la liste delivres. Par exemple, si dans la vue bibliothque calibre vous cliquez sur une colonne de catgorie (tiquettes, sries,diteur, auteur, etc.) pour un livre, le contenu de la fentre Affichage rapide changera pour vous montrer dans lepanneau de gauche les lments dans cette catgorie pour le livre slectionn (par exemple, les tiquettes pour celivre). Le premier lment dans cette liste sera slectionn, et Affichage rapide vous montrera dans le panneau dedroite tous les livres dans votre bibliothque qui utilisent cet valeur. Cliquer sur une valeur diffrente dans le panneaude gauche pour voir les livres avec cette valeur diffrente.

Double cliquez sur un livre dans la fentre Affichage rapide pour slectionner ce livre dans la vue bibliothque. Cecichangera aussi les lments dans la fentre Affichage rapide (panneau de gauche) pour montrer les lments dans lelivre nouvellement slectionn.

Shift- ou Ctrl- double clic sur un livre dans la fentre Affichage rapide pour ouvrir la bote de dialogue modifierles mtadonnes de ce livre dans la fentre calibre. Le livre modifi sera Affich rapidement quand vous fermerez laboite de dialogue Modifier les mtadonnes.

Vous pouvez voir si une colonne peut tre Affiche Rapidement en passant votre souris sur lentte de la colonne et enregardant linfo-bulle pour cet entte. Vous pouvez aussi le savoir en faisant un clic droit sur lentte de colonne pourvoir si loption Affichage rapide apparat dans le menu, dans un tel cas choisir cette option Affichage rapide estquivalent appuyer Q dans la cellule actuelle.

Options (dans :guilabel :Prfrences->Apparence et prsentation->Affichage rapide) : Affichage rapide respecte (ou non) la bibliothque virtuelle actuelle. Si coch, alors Affichage rapide montre

uniquement les livres dans la bibliothque virtuelle actuelle. Par dfaut : respecte les bibliothques virtuelles Changer le contenu de la fentre Affichage rapide quand la colonne est change dans la liste de livres en

utilisant les touches curseur. Par dfaut : ne suit pas les changements effectus avec les touches curseur Changer la colonne qui est Affich rapidement quand une cellule dans la fentre Affichage rapide est double

clique. Autrement le livre est chang mais la colonne examine ne lest pas. Par dfaut : changer la colonne Changer la colonne qui est Affiche rapidement vers la colonne actuelle quand la touche retour est appuye

dans le panneau Affichage rapide. Autrement le livre est chang mais la colonne qui est examine ne lest pas.Par dfaut : changer la colonne

Choisir quelles colonnes sont affiches dans la/le fentre/panneau Affichage rapide

1.14 Tches

Le panneau des Travaux montre le nombre des tches en cours. Les travaux sont des tches qui sexcutent dansun processus spar. Ils incluent la conversion de livres numriques et les changes avec votre liseuse. Vous pouvezcliquer sur le panneau des tches pour accder la liste des tches. Une fois quune tche est termine vous pouvezvoir un journal dtaill de cette tche en la double cliquant dans cette liste. Ceci est utile pour dpanner des tches quine se sont pas termines avec succs.

1.15 Raccourcis clavier

calibre a plusieurs raccourcis clavier pour vous faire gagner du temps et du dplacement de souris. Ces raccourcissont disponibles depuis la liste des livres (quand vous ntes pas occup diter les dtails dun livre particulier), et laplupart dentre eux affectent le titre que vous avez slectionn. La visionneuse de livre numrique calibre a ses propresraccourcis qui peuvent tre personnaliss en cliquant sur le bouton Prfrences dans la visionneuse .

1.14. Tches 23


Note : Remarque : Les raccourcis clavier calibre ne requirent pas de touche modificatrice (Command, Option,Control, etc.) sauf si cela est spcialement indiqu. Vous avez seulement besoin dappuyer la touche de lettre. Par ex. :E pour diter.

Tableau 1.1: Raccourcis clavier pour le programme principal de calibreRaccourciclavier

Action

F2(EnterdansmacOS)

Editer les mtadonnes du champ actuellement slectionn dans la liste de livres.

A Ajouter des livresShift+AAjouter des Formats aux livres slectionnsC Convertir les Livres slectionnsD Envoyer vers le priphriqueDel Supprimer les Livres slectionnsE Editer les mtadonnes des livres slectionnsG Obtenir des livresI Afficher Dtails du livreK Modifier la table des matiresM Fusionner les enregistrements slectionnsAlt+M Fusionner les enregistrements slectionns, garder les originauxO Ouvrir le rpertoire contenantP Polir des livresS Enregistrer sous. . .T Editer le livreV VisualiserAlt+V/Cmd+VdansmacOS

Visualiser un format spcifique

Alt+Shift+JAfficher/Masquer la liste des tchesAlt+Shift+BAfficher/Masquer le Navigateur de CouverturesAlt+Shift+DAfficher/Masquer le panneau des Dtails du LivreAlt+Shift+TAfficher/Masquer Le Navigateur dtiquetteAlt+Shift+GAfficher/Masquer la grille de couverturesAlt+A Afficher les livres du mme auteur que le livre actuelAlt+T Afficher des livres avec les mmes tiquettes que le livre actuelAlt+P Afficher des livres avec le mme diteur que le livre actuelAlt+Shift+SAfficher des livres dans la mme srie que le livre actuel/,Ctrl+F

Focalisez la barre de recherche

Shift+Ctrl+FOuvrir la bote de dialogue recherche avanceEsc Vider la recherche couranteShift+EscCiblez la liste des livresCtrl+EscNettoyez la bibliothque virtuelleAlt+EscNettoyez la restriction additionnelleCtrl+* Crer une bibliothque virtuelle temporaire base sur la recherche actuelleCtrl+DroitSlectionne le prochain volet de la bibliothque virtuelle

Continued on next page



Tableau 1.1 continued from previous pageRaccourciclavier

Action

Ctrl+GaucheSlectionne le volet prcdent de la bibliothque virtuelleN ouF3

Trouver le livre suivant qui correspond la recherche actuelle (fonctionne uniquement si la la mise envidence de la recherche est active dans les prfrences de recherche)

Shift+NouShift+F3

Trouver le livre prcdent qui correspond la recherche actuelle (fonctionne uniquement si la la mise envidence de la recherche est active dans les prfrences de recherche)

Ctrl+D Tlcharger les mtadonnes et les couverturesCtrl+R Redmarrer calibreCtrl+Shift+RRedmarrer calibre en mode dpannageShift+Ctrl+EAjouter des livres calibreCtrl+M Basculer entre le statut marqus/dmarqus sur les livres slectionnsQ Ouvre la fentre dAffichage Rapide pour voir les livres en rapport aux sries/tiquettes/etc.Shift+QSe concentre sur le panneau dAffichage Rapide ouvertShift+SEffectue une recherche dans le panneau dAffichage RapideCtrl+Q Quitter calibre

1.15. Raccourcis clavier 25

CHAPITRE 2

Ajouter votre site web favori dactualits

calibre contient une structure de cration puissante, flexible et facile utiliser pour tlcharger des actualits surInternet et les convertir en livre numrique. Ce qui suit vous montrera, au moyen dexemples, comment obtenir lesactualits de divers sites web.

Pour avoir une comprhension de la faon demployer cette structure de cration, suivez les exemples ci-dessous danslordre :

Rcupration entirement automatique (page 27) Le blog calibre (page 28) bbc.co.uk (page 29)

Personnaliser le processus de rcupration (page 29) Utilisation de la version imprimable de bbc.co.uk (page 29) Remplacer les styles darticle (page 31) Dcouper et mincer (page 31) Exemple de la vie relle (page 45)

Astuces pour dvelopper de nouvelles recettes (page 48) Lectures recommandes (page 48) Documentation de lAPI (page 49)

2.1 Rcupration entirement automatique

Si votre source dactualit est assez simple, calibre est capable den effectuer la rcupration de manire compltementautomatique. Tout ce que vous avez faire est de fournir lURL. calibre recueille toutes les informations ncessairespour tlcharger une source dactualits dans une recette. Pour intgrer calibre une nouvelle source dactualit, vousdevez crer une recette pour celle-ci. Voyons quelques exemples :

27


2.1.1 Le blog calibre

Le blog calibre est un blog de postes qui dcrivent beaucoup de fonctionnalits utiles de calibre dune manire simpleet accessible pour les nouveaux utilisateurs de calibre. Pour pouvoir tlcharger ce blog dans un livre numrique, nousnous rfrons au flux RSS du blog :

https://blog.calibre-ebook.com/feeds/posts/default

Jai obtenu lURL RSS en regardant sous Subscribe to en bas de la page du blog et en choisissant PostsAtom.Pour faire en sorte que calibre tlcharge les flux et les convertissent en livre numrique, vous devrez faire une clicdroit sur le bouton Rcuprer des actualits et puis le bouton Ajouter une source personnalise dinformations. Uneboite de dialogue semblable celle montre ci-dessous devrait souvrir.

Tout dabord entrez Blog calibre dans le champ Titre de la recette. Ceci sera le titre du livre numrique qui seracr partir des articles des flux ci-dessus.

Les deux champs suivants (Article le plus ancien et Max. Nombre darticles par flux) donnent la possibilit de contrlercombien darticles pourront tre tlchargs de chaque flux. Ils sont assez explicites.

Pour ajouter les flux la recette, entrer le titre du flux et lURL du flux et cliquez sur le bouton Ajouter un flux. Une

28 Chapitre 2. Ajouter votre site web favori dactualits


fois que vous avez ajout le flux, cliquez simplement sur le bouton Sauvegarder et vous avez fini ! Fermez la bote dedialogue.

Pour tester votre nouvelle recette, cliquez le bouton Rcuprer des informations et dans le sous menu Personnaliserles sources dactualits cliquez guilabel :Blog calibre. Aprs quelques minutes, le nouveau livre numrique de postesde blog apparatra dans la vue de la bibliothque principale (si votre lecteur est connect, il sera dpos sur le lecteurplutt que dans la bibliothque). Slectionnez-le et appuyer le bouton Visualiser pour le lire !

La raison pour laquelle cela fonctionne si bien, avec si peu defforts, est parce que le blog fournit un flux RSS contenuplein, cest dire, dont le contenu de larticle est inclut dans le flux lui-mme. Pour la plupart des sites dactualitsqui fournissent des actualits de cette faon, avec des flux contenu plein, vous navez pas besoin de faire beaucoupplus defforts pour les convertir en livres numriques. Maintenant nous allons regarder des sources dactualits quine fournissent pas des flux contenu plein. Dans de tels flux, Larticle complet est une page web et le flux contientuniquement un lien vers la page web avec un petit rsum de larticle.

2.1.2 bbc.co.uk

Essayons les deux flux suivant de The BBC :

1. News Front Page : https://newsrss.bbc.co.uk/rss/newsonline_world_edition/front_page/rss.xml

2. Science/Nature : https://newsrss.bbc.co.uk/rss/newsonline_world_edition/science/nature/rss.xml

Suivez la procdure comme expose dans Le blog calibre (page 28) pour crer une recette pour The BBC (en utilisantles flux ci-dessus). Regardez le livre numrique tlcharg,nous voyons que calibre a ralis un travail honorabledextraire seulement le contenu qui vous intresse depuis la page web de chaque article. Cependant, le processusdextraction nest pas parfait. Parfois il laisse du contenu indsirable comme des menus et des aides la navigation ouenlve du contenu qui aurait d apparatre seul, comme des titres darticle. Pour obtenir une extraction parfaite, nousaurons besoin dadapter le processus de rcupration, tel que dcrit dans la section suivante.

2.2 Personnaliser le processus de rcupration

Quand vous voulez perfectionner le processus de tlchargement, ou tlcharger du contenu dun site web particuli-rement complexe, vous pouvez vous servir de toutes la puissance et de la flexibilit de la structure recette. Afin defaire cela, dans la bote de dialogue Ajouter des sources dactualits personnalises, cliquez simplement sur le boutonBasculer vers le mode Avanc.

La personnalisation la plus facile et souvent la plus productive est demployer la version imprimable des articles enligne. La version imprimable est habituellement moins compliqu et se traduit beaucoup plus souplement en un livrenumrique. Essayons demployer la version imprimable des articles de The BBC.

2.2.1 Utilisation de la version imprimable de bbc.co.uk

La premire tape est de regarder le livre numrique que nous avons prcdemment tlcharg depuis bbc.co.uk(page 29). A la fin de chaque article, dans le livre numrique il y a un petit texte de prsentation vous indiquantdo larticle a t tlcharg. Copier et coller cette URL dans un navigateur. Maintenant sur la page Web de larticlerecherchez un lien qui pointe vers la version imprimable . Cliquez le pour voir la version imprimable de larticle. Ilparait beaucoup plus ordonn ! Comparez maintenant les deux URLs. Pour moi elles taient :

URL darticle https://news.bbc.co.uk/2/hi/science/nature/7312016.stmURL de version imprimable https://newsvote.bbc.co.uk/mpapps/pagetools/print/news.bbc.co.uk/2/hi/

science/nature/7312016.stm

Aussi il semble que pour obtenir la version imprimable, nous avons besoin de prfixer que URL darticle avec :

newsvote.bbc.co.uk/mpapps/pagetools/print/

2.2. Personnaliser le processus de rcupration 29

https://newsrss.bbc.co.uk/rss/newsonline_world_edition/front_page/rss.xmlhttps://newsrss.bbc.co.uk/rss/newsonline_world_edition/science/nature/rss.xmlhttps://news.bbc.co.uk/2/hi/science/nature/7312016.stmhttps://newsvote.bbc.co.uk/mpapps/pagetools/print/news.bbc.co.uk/2/hi/science/nature/7312016.stmhttps://newsvote.bbc.co.uk/mpapps/pagetools/print/news.bbc.co.uk/2/hi/science/nature/7312016.stm


Maintenant dans le Mode Avanc de la bote de dialogue Personnaliser les sources dactualits, vous devriez voirquelque chose comme (rappeler vous de slectionner la recette The BBC avant de basculer vers le mode avanc) :

Vous pouvez voir que les champs du Mode de base ont t traduits en code de Python dune faon simple. Nous devonsajouter des instructions cette recette pour employer la version imprimable des articles. Tout ce qui est ncessaire estdajouter les deux lignes suivantes :

def print_version(self, url):return url.replace('https://', 'https://newsvote.bbc.co.uk/mpapps/pagetools/print/

')

Cest du Python, donc lindentation est importante. Aprs que vous ayez ajout les lignes, elles devraient ressembler :

Ci-dessus, def print_version(self, url) dfinit une mthode qui est appele par calibre pour chaque ar-ticle. url est lURL de larticle original. Ce que print_version fait est de prendre cette url et de la remplaceravec lURL qui pointe vers la version imprimable de larticle. Pour apprendre propos de Python 4 voir le tutoriel 5.

Maintenant, cliquez sur le bouton Ajouter/Mettre jour la recette et vos changements seront enregistrs. Tlchargez nouveau le livre numrique. Vous devriez obtenir un livre numrique beaucoup plus amlior. Un des problmesavec la nouvelle version est que les polices sur la page Web de la version imprimable sont trop petites. Ceci estautomatiquement fix en convertissant en livre numrique, mais mme aprs le processus de fixation, la taille de lapolice des menus et la barre de navigation peut tre trop grande relativement au texte darticle. Pour fixer ceci, nousferons encore plus de personnalisation dans la prochaine section.

4. https://www.python.org5. https://docs.python.org/2/tutorial/


https://www.python.orghttps://docs.python.org/2/tutorial/


2.2.2 Remplacer les styles darticle

Dans la section prcdente, nous avons vu que la taille de la police pour des articles de la version imprimable de TheBBC tait trop petite. Dans la plupart des sites Web, le The BBC inclus, cette taille de la police est place au moyen defeuilles de style CSS. Nous pouvons dsactiver la rcupration de telles feuilles de style n ajoutant la ligne :

no_stylesheets = True

La recette ressemble maintenant :

La nouvelle version parait assez bonne. Si vous tes un perfectionniste, vous voudrez lire la prochaine section, quitraite de modifier rellement le contenu tlcharg.

2.2.3 Dcouper et mincer

calibre a des capacits trs puissantes et flexibles quand il sagit de manipuler le contenu tlcharg. Pour montrerquelques uns de ces derniers, regardons encore notre vieille amie la recette The BBC (page 31). Regardez le codesource (HTML) de quelques articles (version imprimable), nous voyons quil contient un pied de page qui napporteaucune information utile

...

Ceci peut tre supprim en ajoutant :

remove_tags = [dict(name='div', attrs={'class':'footer'})]

la recette. Finalement, remplaons certains des CSS que nous avons dsactivs plus tt, avec notre propre CSS quiest plus adapt pour la conversion en livre numrique :

extra_css = '.headline {font-size: x-large;} \n .fact { padding-top: 10pt }'

Avec ces ajouts, notre recette est devenue une production de qualit , en effet ele est trs proche de la recette relleutilise par calibre pour la BBC, montre ci-dessous :

### Title: BBC News, Sport, and Blog Calibre Recipe# Contact: mattst - [email protected]### License: GNU General Public License v3 - http://www.gnu.org/copyleft/gpl.html



# Copyright: mattst - [email protected]### Written: November 2011# Last Edited: 2011-11-19##

__license__ = 'GNU General Public License v3 - http://www.gnu.org/copyleft/gpl.html'__copyright__ = 'mattst - [email protected]'

'''BBC News, Sport, and Blog Calibre Recipe'''

# Import the regular expressions module.import re

# Import the BasicNewsRecipe class which this class extends.from calibre.web.feeds.recipes import BasicNewsRecipe

def classes(classes):q = frozenset(classes.split(' '))return dict(attrs={

'class': lambda x: x and frozenset(x.split()).intersection(q)})

class BBCNews(BasicNewsRecipe):

## **** IMPORTANT USERS READ ME ****## First select the feeds you want then scroll down below the feeds list# and select the values you want for the other user preferences, like# oldest_article and such like.### Select the BBC rss feeds which you want in your ebook.# Selected feed have NO '#' at their start, de-selected feeds begin with a '#'.## Eg. ("News Home", "http://feeds.bbci.co.uk/... - include feed.# Eg. #("News Home", "http://feeds.bbci.co.uk/... - do not include feed.## There are 68 feeds below which constitute the bulk of the available rss# feeds on the BBC web site. These include 5 blogs by editors and# correspondents, 16 sports feeds, 15 'sub' regional feeds (Eg. North West# Wales, Scotland Business), and 7 Welsh language feeds.## Some of the feeds are low volume (Eg. blogs), or very low volume (Eg. Click)# so if "oldest_article = 1.5" (only articles published in the last 36 hours)# you may get some 'empty feeds' which will not then be included in the ebook.## The 15 feeds currently selected below are simply my default ones.## Note: With all 68 feeds selected, oldest_article set to 2,# max_articles_per_feed set to 100, and simultaneous_downloads set to 10,# the ebook creation took 29 minutes on my speedy 100 mbps net connection,# fairly high-end desktop PC running Linux (Ubuntu Lucid-Lynx).



# More realistically with 15 feeds selected, oldest_article set to 1.5,# max_articles_per_feed set to 100, and simultaneous_downloads set to 20,# it took 6 minutes. If that's too slow increase 'simultaneous_downloads'.## Select / de-select the feeds you want in your ebook.#feeds = [

("News Home", "http://feeds.bbci.co.uk/news/rss.xml"),("UK", "http://feeds.bbci.co.uk/news/uk/rss.xml"),("World", "http://feeds.bbci.co.uk/news/world/rss.xml"),# ("England", "http://feeds.bbci.co.uk/news/england/rss.xml"),# ("Scotland", "http://feeds.bbci.co.uk/news/scotland/rss.xml"),# ("Wales", "http://feeds.bbci.co.uk/news/wales/rss.xml"),# ("N. Ireland", "http://feeds.bbci.co.uk/news/northern_ireland/rss.xml"),# ("Africa", "http://feeds.bbci.co.uk/news/world/africa/rss.xml"),# ("Asia", "http://feeds.bbci.co.uk/news/world/asia/rss.xml"),# ("Europe", "http://feeds.bbci.co.uk/news/world/europe/rss.xml"),# ("Latin America", "http://feeds.bbci.co.uk/news/world/latin_america/rss.xml

"),# ("Middle East", "http://feeds.bbci.co.uk/news/world/middle_east/rss.xml"),("US & Canada", "http://feeds.bbci.co.uk/news/world/us_and_canada/rss.xml"),("Politics", "http://feeds.bbci.co.uk/news/politics/rss.xml"),("Science/Environment","http://feeds.bbci.co.uk/news/science_and_environment/rss.xml"),("Technology", "http://feeds.bbci.co.uk/news/technology/rss.xml"),("Magazine", "http://feeds.bbci.co.uk/news/magazine/rss.xml"),("Entertainment/Arts","http://feeds.bbci.co.uk/news/entertainment_and_arts/rss.xml"),# ("Health", "http://feeds.bbci.co.uk/news/health/rss.xml"),# ("Education/Family", "http://feeds.bbci.co.uk/news/education/rss.xml"),("Business", "http://feeds.bbci.co.uk/news/business/rss.xml"),("Special Reports", "http://feeds.bbci.co.uk/news/special_reports/rss.xml"),("Also in the News", "http://feeds.bbci.co.uk/news/also_in_the_news/rss.xml"),# ("Newsbeat", "http://www.bbc.co.uk/newsbeat/rss.xml"),# ("Click", "http://newsrss.bbc.co.uk/rss/newsonline_uk_edition/programmes/

click_online/rss.xml"),# ("Blog: Mark D'Arcy (Parliamentary Correspondent)", "http://feeds.bbci.co.

uk/news/correspondents/markdarcy/rss.sxml"),# ("Blog: Robert Peston (Business Editor)", "http://feeds.bbci.co.uk/news/

correspondents/robertpeston/rss.sxml"),# ("Blog: Stephanie Flanders (Economics Editor)", "http://feeds.bbci.co.uk/

news/correspondents/stephanieflanders/rss.sxml"),("Sport Front Page","http://newsrss.bbc.co.uk/rss/sportonline_uk_edition/front_page/rss.xml"),# ("Football", "http://newsrss.bbc.co.uk/rss/sportonline_uk_edition/football/

rss.xml"),# ("Cricket", "http://newsrss.bbc.co.uk/rss/sportonline_uk_edition/cricket/

rss.xml"),# ("Rugby Union", "http://newsrss.bbc.co.uk/rss/sportonline_uk_edition/rugby_

union/rss.xml"),# ("Rugby League", "http://newsrss.bbc.co.uk/rss/sportonline_uk_edition/rugby_

league/rss.xml"),# ("Tennis", "http://newsrss.bbc.co.uk/rss/sportonline_uk_edition/tennis/rss.

xml"),# ("Golf", "http://newsrss.bbc.co.uk/rss/sportonline_uk_edition/golf/rss.xml

"),# ("Motorsport", "http://newsrss.bbc.co.uk/rss/sportonline_uk_edition/

motorsport/rss.xml"),



# ("Boxing", "http://newsrss.bbc.co.uk/rss/sportonline_uk_edition/boxing/rss.xml"),

# ("Athletics", "http://newsrss.bbc.co.uk/rss/sportonline_uk_edition/athletics/rss.xml"),

# ("Snooker", "http://newsrss.bbc.co.uk/rss/sportonline_uk_edition/other_sports/snooker/rss.xml"),

# ("Horse Racing", "http://newsrss.bbc.co.uk/rss/sportonline_uk_edition/other_sports/horse_racing/rss.xml"),

# ("Cycling", "http://newsrss.bbc.co.uk/rss/sportonline_uk_edition/other_sports/cycling/rss.xml"),

# ("Disability Sport", "http://newsrss.bbc.co.uk/rss/sportonline_uk_edition/other_sports/disability_sport/rss.xml"),

# ("Other Sport", "http://newsrss.bbc.co.uk/rss/sportonline_uk_edition/other_sports/rss.xml"),

# ("Olympics 2012", "http://newsrss.bbc.co.uk/rss/sportonline_uk_edition/other_sports/olympics_2012/rss.xml"),

# ("N. Ireland Politics", "http://feeds.bbci.co.uk/news/northern_ireland/northern_ireland_politics/rss.xml"),

# ("Scotland Politics", "http://feeds.bbci.co.uk/news/scotland/scotland_politics/rss.xml"),

# ("Scotland Business", "http://feeds.bbci.co.uk/news/scotland/scotland_business/rss.xml"),

# ("E. Scotland, Edinburgh & Fife", "http://feeds.bbci.co.uk/news/scotland/edinburgh_east_and_fife/rss.xml"),

# ("W. Scotland & Glasgow", "http://feeds.bbci.co.uk/news/scotland/glasgow_and_west/rss.xml"),

# ("Highlands & Islands", "http://feeds.bbci.co.uk/news/scotland/highlands_and_islands/rss.xml"),

# ("NE. Scotland, Orkney & Shetland", "http://feeds.bbci.co.uk/news/scotland/north_east_orkney_and_shetland/rss.xml"),

# ("South Scotland", "http://feeds.bbci.co.uk/news/scotland/south_scotland/rss.xml"),

# ("Central Scotland & Tayside", "http://feeds.bbci.co.uk/news/scotland/tayside_and_central/rss.xml"),

# ("Wales Politics", "http://feeds.bbci.co.uk/news/wales/wales_politics/rss.xml"),

# ("NW. Wales", "http://feeds.bbci.co.uk/news/wales/north_west_wales/rss.xml"),

# ("NE. Wales", "http://feeds.bbci.co.uk/news/wales/north_east_wales/rss.xml"),

# ("Mid. Wales", "http://feeds.bbci.co.uk/news/wales/mid_wales/rss.xml"),# ("SW. Wales", "http://feeds.bbci.co.uk/news/wales/south_west_wales/rss.xml

"),# ("SE. Wales", "http://feeds.bbci.co.uk/news/wales/south_east_wales/rss.xml

"),# ("Newyddion - News in Welsh", "http://feeds.bbci.co.uk/newyddion/rss.xml"),# ("Gwleidyddiaeth", "http://feeds.bbci.co.uk/newyddion/gwleidyddiaeth/rss.xml

"),# ("Gogledd-Ddwyrain", "http://feeds.bbci.co.uk/newyddion/gogledd-ddwyrain/

rss.xml"),# ("Gogledd-Orllewin", "http://feeds.bbci.co.uk/newyddion/gogledd-orllewin/

rss.xml"),# ("Canolbarth", "http://feeds.bbci.co.uk/newyddion/canolbarth/rss.xml"),# ("De-Ddwyrain", "http://feeds.bbci.co.uk/newyddion/de-ddwyrain/rss.xml"),# ("De-Orllewin", "http://feeds.bbci.co.uk/newyddion/de-orllewin/rss.xml"),

]

# **** SELECT YOUR USER PREFERENCES ****



# Title to use for the ebook.#title = 'BBC News'

# A brief description for the ebook.#description = u'BBC web site ebook created using rss feeds.'

# The max number of articles which may be downloaded from each feed.# I've never seen more than about 70 articles in a single feed in the# BBC feeds.#max_articles_per_feed = 100

# The max age of articles which may be downloaded from each feed. This is# specified in days - note fractions of days are allowed, Eg. 2.5 (2 and a# half days). My default of 1.5 days is the last 36 hours, the point at# which I've decided 'news' becomes 'old news', but be warned this is not# so good for the blogs, technology, magazine, etc., and sports feeds.# You may wish to extend this to 2-5 but watch out ebook creation time will# increase as well. Setting this to 30 will get everything (AFAICT) as long# as max_articles_per_feed remains set high (except for 'Click' which is# v. low volume and its currently oldest article is 4th Feb 2011).#oldest_article = 1.5

# Number of simultaneous downloads. 20 is consistantly working fine on the# BBC News feeds with no problems. Speeds things up from the defualt of 5.# If you have a lot of feeds and/or have increased oldest_article above 2# then you may wish to try increasing simultaneous_downloads to 25-30,# Or, of course, if you are in a hurry. [I've not tried beyond 20.]#simultaneous_downloads = 20

# Timeout for fetching files from the server in seconds. The default of# 120 seconds, seems somewhat excessive.#timeout = 30

# The format string for the date shown on the ebook's first page.# List of all values: http://docs.python.org/library/time.html# Default in news.py has a leading space so that's mirrored here.# As with 'feeds' select/de-select by adding/removing the initial '#',# only one timefmt should be selected, here's a few to choose from.## [Fri, 14 Nov 2011] (Calibre default)timefmt = ' [%a, %d %b %Y]'# timefmt = ' [%a, %d %b %Y %H:%M]' # [Fri, 14 Nov 2011 18:30]# timefmt = ' [%a, %d %b %Y %I:%M %p]' # [Fri, 14 Nov 2011 06:30 PM]# timefmt = ' [%d %b %Y]' # [14 Nov 2011]# timefmt = ' [%d %b %Y %H:%M]' # [14 Nov 2011 18.30]# timefmt = ' [%Y-%m-%d]' # [2011-11-14]# timefmt = ' [%Y-%m-%d-%H-%M]' # [2011-11-14-18-30]

## **** IMPORTANT ****#



# DO NOT EDIT BELOW HERE UNLESS YOU KNOW WHAT YOU ARE DOING.## DO NOT EDIT BELOW HERE UNLESS YOU KNOW WHAT YOU ARE DOING.## I MEAN IT, YES I DO, ABSOLUTELY, AT YOU OWN RISK. :)## **** IMPORTANT ****#

# Author of this recipe.__author__ = 'mattst'

# Specify English as the language of the RSS feeds (ISO-639 code).language = 'en_GB'

# Set tags.tags = 'news, sport, blog'

# Set publisher and publication type.publisher = 'BBC'publication_type = 'newspaper'

# Disable stylesheets from site.no_stylesheets = True

# Specifies an override encoding for sites that have an incorrect charset# specified. Default of 'None' says to auto-detect. Some other BBC recipes# use 'utf8', which works fine (so use that if necessary) but auto-detecting# with None is working fine, so stick with that for robustness.encoding = None

# Sets whether a feed has full articles embedded in it. The BBC feeds do# not.use_embedded_content = False

# Removes empty feeds - why keep them!?remove_empty_feeds = Trueignore_duplicate_articles = {'title', 'url'}resolve_internal_links = True

# Create a custom title which fits nicely in the Kindle title list.# Requires "import time" above class declaration, and replacing# title with custom_title in conversion_options (right column only).# Example of string below: "BBC News - 14 Nov 2011"## custom_title = "BBC News - " + time.strftime('%d %b %Y')

# Conversion options for advanced users. Avoid setting 'linearize_tables'# as that plays havoc with the 'old style' table based pages.conversion_options = {

# 'title' : title,# 'comments' : description,# 'tags' : tags,# 'language' : language,# 'publisher' : publisher,# 'authors' : publisher,'smarten_punctuation' : True

}



# Specify extra CSS - overrides ALL other CSS (IE. Added last).extra_css = 'body { font-family: verdana, helvetica, sans-serif; } \

.introduction, .first { font-weight: bold; } \

.cross-head { font-weight: bold; font-size: 125%; } \

.cap, .caption { display: block; font-size: 80%; font-style: italic;} \

.cap, .caption, .caption img, .caption span { display: block; text-align: center; margin: 5px auto; } \

.byl, .byd, .byline img, .byline-name, .byline-title, .author-name, .author-position, \

.correspondent-portrait img, .byline-lead-in, .name, .bbc-role {display: block; \

text-align: center; font-size: 80%; font-style: italic; margin:1px auto; } \

.story-date, .published { font-size: 80%; } \table { width: 100%; } \td img { display: block; margin: 5px auto; } \ul { padding-top: 10px; } \ol { padding-top: 10px; } \li { padding-top: 5px; padding-bottom: 5px; } \h1 { text-align: center; font-size: 175%; font-weight: bold; } \h2 { text-align: center; font-size: 150%; font-weight: bold; } \h3 { text-align: center; font-size: 125%; font-weight: bold; } \h4, h5, h6 { text-align: center; font-size: 100%; font-weight: bold;

}'

# Remove various tag attributes to improve the look of the ebook pages.remove_attributes = ['border', 'cellspacing', 'align', 'cellpadding', 'colspan',

'valign', 'vspace', 'hspace', 'alt', 'width', 'height']

# Remove the (admittedly rarely used) line breaks, "", which sometimes# cause a section of the ebook to start in an unsightly fashion or, more# frequently, a "" will muck up the formatting of a correspondant's byline.# "" and "" are far more frequently used on the table formatted# style of pages, and really spoil the look of the ebook pages.preprocess_regexps = [(re.compile(r'', re.IGNORECASE), lambda m: ''),

(re.compile(r'', re.IGNORECASE), lambda m: '')]

# Create regular expressions for tag keeping and removal to make the matches more# robust against minor changes and errors in the HTML, Eg. double spaces, leading# and trailing spaces, missing hyphens, and such like.# Python regular expression ('re' class) page:# http://docs.python.org/library/re.html

# ***************************************# Regular expressions for keep_only_tags:# ***************************************

# The BBC News HTML pages use variants of 'storybody' to denote the section of aHTML

# page which contains the main text of the article. Match storybody variants:'storybody',

# 'story-body', 'story body','storybody ', etc.storybody_reg_exp = '^.*story[_ -]*body.*$'

# The BBC sport and 'newsbeat' (features) HTML pages use 'blq_content' to holdthe title



# and published date. This is one level above the usual news pages which have thetitle

# and date within 'story-body'. This is annoying since 'blq_content' must also bekept,

# resulting in a lot of extra things to be removed by remove_tags.blq_content_reg_exp = '^.*blq[_ -]*content.*$'

# The BBC has an alternative page design structure, which I suspect is an out-of-date

# design but which is still used in some articles, Eg. 'Click' (technology),'FastTrack'

# (travel), and in some sport pages. These alternative pages are table based(which is

# why I think they are an out-of-date design) and account for -I'm guesstimaking-less

# than 1% of all articles. They use a table class 'storycontent' to hold thearticle

# and like blq_content (above) have required lots of extra removal by# remove_tags.story_content_reg_exp = '^.*story[_ -]*content.*$'

# Keep the sections of the HTML which match the list below. The HTML page createdby

# Calibre will fill with those sections which are matched. Note that the# blq_content_reg_exp must be listed before storybody_reg_exp in keep_only_tags

due to# it being the parent of storybody_reg_exp, that is to say the div class/id

'story-body'# will be inside div class/id 'blq_content' in the HTML (if 'blq_content' is

there at# all). If they are the other way around in keep_only_tags then blq_content_reg_

exp# will end up being discarded.keep_only_tags = [dict(name='table', attrs={'class': re.compile(story_content_reg_

exp, re.IGNORECASE)}),dict(name='div', attrs={'class': re.compile(

blq_content_reg_exp, re.IGNORECASE)}),dict(name='div', attrs={'id': re.compile(

blq_content_reg_exp, re.IGNORECASE)}),dict(name='div', attrs={'class': re.compile(

storybody_reg_exp, re.IGNORECASE)}),dict(name='div', attrs={'id': re.compile(storybody_reg_exp,

re.IGNORECASE)})]

# ************************************# Regular expressions for remove_tags:# ************************************

# Regular expression to remove share-help and variant tags. The share-help class# is used by the site for a variety of 'sharing' type links, Eg. Facebook,

delicious,# twitter, email. Removed to avoid page clutter.share_help_reg_exp = '^.*share[_ -]*help.*$'

# Regular expression to remove embedded-hyper and variant tags. This class isused to

# display links to other BBC News articles on the same/similar subject.embedded_hyper_reg_exp = '^.*embed*ed[_ -]*hyper.*$'



# Regular expression to remove hypertabs and variant tags. This class is used to# display a tab bar at the top of an article which allows the user to switch to# an article (viewed on the same page) providing further info., 'in depth'

analysis,# an editorial, a correspondant's blog entry, and such like. The ability to handle# a tab bar of this nature is currently beyond the scope of this recipe and# possibly of Calibre itself (not sure about that - TO DO - check!).hypertabs_reg_exp = '^.*hyper[_ -]*tabs.*$'

# Regular expression to remove story-feature and variant tags. Eg. 'story-feature',

# 'story-feature related narrow', 'story-feature wide', 'story-feature narrow'.# This class is used to add additional info. boxes, or small lists, outside of# the main story. TO DO: Work out a way to incorporate these neatly.story_feature_reg_exp = '^.*story[_ -]*feature.*$'

# Regular expression to remove video and variant tags, Eg. 'videoInStoryB',# 'videoInStoryC'. This class is used to embed video.video_reg_exp = '^.*video.*$'

# Regular expression to remove audio and variant tags, Eg. 'audioInStoryD'.# This class is used to embed audio.audio_reg_exp = '^.*audio.*$'

# Regular expression to remove pictureGallery and variant tags, Eg.'pictureGallery'.

# This class is used to embed a photo slideshow. See also 'slideshow'# below.picture_gallery_reg_exp = '^.*picture.*$'

# Regular expression to remove slideshow and variant tags, Eg. 'dslideshow-enclosure'.

#

Documents

Manuel de l'Utilisateur calibre