====== zathura ======
* Objet : zathura : un visualisateur de document pdf avec une interface légère et minimaliste
* Niveau requis : {{tag>débutant avisé}}
* Commentaires : Attention, l’essayer c’est l’adopter :-D.
* Débutant, à savoir : [[:doc:systeme:commandes:le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là !.]] :-)
* Suivi :
* Création par [[user>Philou92]] 03/07/2020
* Testé par [[user>TyZef]] le 04/05/2023
* Commentaires sur le forum : [[https://debian-facile.org/viewtopic.php?pid=337694#p337694 | Lien vers le forum concernant ce tuto]] ((N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !))
===== Introduction =====
Zathura est un lecteur de document pdf avec une interface très légère (idéal pour les machines peu puissantes).\\
Il se pilote entièrement au clavier à la mode des commandes et raccourcis de « [[doc:editeurs:vim:vim|vim]] ».\\
Pratiquement tous les réglages à partir du clavier sont personnalisables.\\
En installant les plugins suggérés, il est possible de lire des documents du type djvu, PostScript et cb (Comic Book). Non testés, ces plugins ne seront pas abordés.
Autre atout pour les utilisateurs de Latex, il fourni (comme evince) la synchronisation SyncTex dans les deux sens (même ouvert dans zathura, toute modification du fichier pdf est automatiquement affichée).\\
Que les nostalgiques de la souris se rassurent, ils pourront quand même faire du « scrolling » vertical dans le document voire plein d’autres choses…\\
===== Installation =====
Pour l’installer rien de plus simple :
On [[doc:systeme:apt|actualise la liste des paquets disponibles de son système]] ((actualisation de la liste des paquets disponibles de son système https://debian-facile.org/doc:systeme:apt:apt#mettre-a-jour-la-liste-des-paquets)) :
apt update
et ensuite on installe zathura
apt install zathura
===== Utilisation =====
==== Ouvrir un document ====
Par exemple s’il est intitulé ''mondocument.pdf'' :
zathura mondocument.pdf
Par la suite, si vous le souhaitez, vous pouvez décider que zathura devienne le lecteur par défaut de votre interface graphique.
Il existe deux modes principaux :
* Un mode normal qui permet de naviguer dans le document et changer la forme et l’aspect de la fenêtre etc…
* Un mode commande pour imprimer, ouvrir un autre document, afficher les infos etc…
Les commandes au clavier suivent pratiquement la même logique que celles de vim. Notamment, pour ne citer que les plus couramment utilisées :\\
==== Le mode « normal » ====
=== Pour naviguer dans le document ===
^ Touches ^ Actions ^
|gg| aller en haut du fichier |
|maj+G| aller à la fin du fichier |
|10 maj+G | aller à la page 10 |
|maj+J ou PgDn | aller à la prochaine page |
|maj+K ou PgUp | aller à la page précédente |
|← → | scroll horizontal |
|↑ ↓ | scroll vertical |
^ Souris ^ Actions ^
|Roulette|scroll vertical ou horizontal|
=== Pour faire une recherche ===
^ Commandes ^ Actions ^
|/toto| chercher le texte « toto » dans tout le document (note : /toto s’affiche dans la ligne de commande)|
^ Touches ^ Actions ^
|n ou maj+N | continuer la recherche en avant ou en arrière dans le document|
=== Voir le sommaire (mode index) ===
^ Touches ^ Actions ^
|Tab|Montrer ou fermer l’index (sommaire) dans un menu contextuel en mode index|
|k et ↑ ou j et ↓| monter ou descendre dans les index du sommaire|
|l et →|développer les index inférieurs|
|L|développer tous les index|
|h et ←|réduire l’index|
|H|réduire tous les index|
|Espace ou Entrée|montrer la page de l’index sélectionné|
=== Pour changer l’aspect de l’affichage ===
^ Touches ^ Actions ^
|a ou s | ajuster l’image à la taille ou à la largeur d’une page |
|r | rotation de 90° (renversant :-) )|
|CTRL+R | Inverser les couleurs (écritures blanc sur noir). Idéal contre la fatigue occulaire |
|F5 | bascule entre l’affichage présentation et normal |
|F11 | bascule entre l’affichage plein écran et normal|
|d | bascule entre l’affichage double page et simple page|
|+ ou -|agrandir ou diminuer la taille de l’affichage|
^ Souris ^ Actions ^
|CTRL+Roulette|agrandir ou diminuer la taille de l’affichage|
=== Pour utiliser les liens ===
^ Touches ^ Actions ^
|f | suivre un lien |
|maj+F | afficher les liens |
=== Pour fermer zathura ===
^ Touches ^ Actions ^
|q | quitter zathura |
==== Le mode « commande » ====
Les commandes sont rédigées dans le bas de la fenêtre dans une ligne d’édition de commande. Elles sont toujours précédées, comme dans vim, du caractère « : » (deux points).
Pour nous épargner de la peine, comme dans un [[doc:systeme:terminal|terminal]], il est possible de :
* faire appel à l’auto-complétion à l’aide de la touche Tab.
* naviguer dans l’historique des dernières commandes à l’aide des touches clavier ↑ et ↓.
=== Opération sur les fichiers ===
^ Commandes ^ Actions ^
|:open ~/document/monfichier.pdf|ouvre le fichier monfichier.pdf|
|:close|ferme le fichier en cours|
|:print|ouvre le menu contextuel d’impression du document|
|:info|affiche les informations sur le fichier|
=== Marque page ===
^ Commandes ^ Actions ^
|:bmark toto|enregistre un marque page de nom « toto » sur la page en cours|
|:blist|affiche la liste des marques pages|
|:blist toto|ouvre la page marquée « toto »|
|:bdelete toto|supprime le marque page « toto »|
=== Quitter le mode commande ===
^ Touche ^ Actions ^
|ESC|quitte le mode commande|
Pour découvrir plein d’autres fonctionnalités :
man zathura
===== Personnalisation de zathura =====
Le comportement de zathura est hautement personnalisable grâce au fichier de configuration zathurarc. \\
Ce fichier se situe normalement dans le répertoire ''/etc/zathurarc'' (pour la configuration par défaut de tous les utilisateurs) ou ''/home//.config/zathura/zathurarc'' pour la configuration de l’utilisateur .
Si ce dernier n’existe pas il suffit de le créer.
La syntaxe est relativement simple, il suffit de faire une commande ''set'' suivi d’une option et éventuellement d’une valeur.
Le manuel de zathura décrit clairement les options et la personnalisation du comportement des touches (mapping).
Ci-dessous un exemple de fichier de configuration pour fixer les dimensions de la fenêtre et le contenu de l’affichage.
# Fichier de configuration de zathura
#
# Ici le rapport hauteur/largeur choisi correspond au mode paysage au
# format Ax, pour un affichage le plus large possible dans un écran de
# dimension 1920x1080.
#
# Ajuste la largeur de la fenêtre (en pixel).
set window-width 1415
# Ajuste la hauteur de la fenêtre (en pixel).
set window-height 1000
# Étend l’affichage selon la largeur du document
set adjust-open width
Pour voir le manuel du fichier de configuration
man zathurarc
===== Lien =====
[[https://pwmt.org/projects/zathura/]]