Debian
Debian-France
Debian-Facile
Debian-fr.org
Forum-Debian.fr
Debian ?
Communautés
Vous n'êtes pas identifié(e).
L'icône rouge permet de télécharger chaque page du wiki visitée au format
PDF et la grise au format ODT →
Ci-dessous, les différences entre deux révisions de la page.
| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
|
utilisateurs:slyfox:tutos:yad [21/11/2015 18:03] Slyfox [Entry] |
— (Version actuelle) | ||
|---|---|---|---|
| Ligne 1: | Ligne 1: | ||
| - | ====== Yad ====== | ||
| - | |||
| - | * Objet : Installtion et utilisation de yad | ||
| - | * Niveau requis : {{tag>avançé}} | ||
| - | * Commentaires : //Contexte d'utilisation du sujet du tuto. // FIXME | ||
| - | * Débutant, à savoir : [[:doc:systeme:commandes:le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là !.]] :-) | ||
| - | |||
| - | ===== Introduction ===== | ||
| - | |||
| - | Yad nous permet d'afficher des boîtes de dialogue GTK via des lignes de commande ou des scripts shell. Il est semblable à Zenity mais avec plus d'options. | ||
| - | |||
| - | ===== Installation ===== | ||
| - | |||
| - | ==== SID et Stretch==== | ||
| - | <code root>apt-get update | ||
| - | apt-get install yad</code> | ||
| - | |||
| - | ==== Jessie stable==== | ||
| - | |||
| - | Apparemment il n’existe pas de paquet pour jessie stable. | ||
| - | Nous allons devoir l'installer par compilation. (la version actuelle est la 0.25.1) | ||
| - | <code root>apt-get update | ||
| - | apt-get install build-essential intltool xz-utils fakeroot checkinstall | ||
| - | wget https://yad.googlecode.com/files/yad-0.25.1.tar.xz | ||
| - | tar -xJf yad-0.25.1.tar.xz | ||
| - | cd yad-0.25.1 | ||
| - | ./configure | ||
| - | make | ||
| - | checkinstall make install | ||
| - | </code> | ||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | ===== Règles d'utilisation ===== | ||
| - | |||
| - | * Yad s'utilise en ligne de commande via un terminal ou dans un script. | ||
| - | |||
| - | * La ligne de commande doit commencer par yad suivit des options (voir chapitre "Options générales" et "Options spécifiques"). | ||
| - | |||
| - | * L'ordre dans lequel interviennent le ou les options n'ont pas d'importance. \\ Remarque: dans ce wiki nous utiliserons en premier l'option de boîte puis les options générales puis les options spécifiques. ;-) | ||
| - | |||
| - | * Si une option spécifique n'est pas mentionnée c'est la valeur par défaut qui sera automatique appliqué par yad. | ||
| - | |||
| - | * Chaque option doit être précédée par 2 tirets "--". | ||
| - | |||
| - | * Il existe plusieurs méthodes pour écrire une commande Yad. | ||
| - | Soit le tout sur une ligne: | ||
| - | <file bash> | ||
| - | yad --calendar --center --title="Mon calendrier" | ||
| - | </file> | ||
| - | |||
| - | Soit en colonne dans ce cas avant chaque retour à ligne il faut insérer __un espace__ à la fin de l'option suivit par __un antislash__ "\" sauf à la dernier ligne: | ||
| - | <file bash> | ||
| - | yad \ | ||
| - | --calendar \ | ||
| - | --center \ | ||
| - | --title="Mon calendrier" | ||
| - | </file> | ||
| - | |||
| - | Soit un mixte des deux méthodes ci-dessus: | ||
| - | |||
| - | <file bash> | ||
| - | yad --calendar \ | ||
| - | --center --title="Mon calendrier" | ||
| - | </file> | ||
| - | |||
| - | ===== Options boîtes de dialogue ===== | ||
| - | |||
| - | Yad permet d'afficher 13 types de boite de dialogue. | ||
| - | |||
| - | ^ Options ^ Descriptions | ||
| - | |**%%--calendar%%** | Affiche un calendrier | | ||
| - | |**%%--color%%** | Sélection de couleurs | | ||
| - | |**%%--dnd %%** | Boîte drag-and-drop | | ||
| - | |**%%--entry%%** | Permet la saisie de caractères | | ||
| - | |**%%--icons%%** | Boîte d'affichage avec icônes de raccourci | | ||
| - | |**%%--file%%** | Sélection de fichiers ou/et dossiers | | ||
| - | |**%%--font%%** | Sélection de la police | | ||
| - | |**%%--form%%** | Permet la saisie de caractères | | ||
| - | |**%%--list%%** | Affiche une liste | | ||
| - | |**%%--notification%%** | Afficher une notification dans la zone prévue à cet effet | | ||
| - | |**%%--progress%%** | Permet de suivre une progression | | ||
| - | |**%%--text-info%%** | Affiche un texte dans une fenêtre | | ||
| - | |**%%--scale%%** | Choisir une valeur numérique à l'aide d'un curseur | | ||
| - | |||
| - | |||
| - | |||
| - | ===== Options générales ===== | ||
| - | |||
| - | <note> | ||
| - | Si l'option est suivit par = et des lettres en majuscule, il suffit de les remplacer par la valeur que nous voulons lui donner et cela entre 2 guillemets. | ||
| - | </note> | ||
| - | |||
| - | ^ Options ^ Descriptions | ||
| - | |**%%--title=TITLE%%** | Titre de la boîte de dialogue | | ||
| - | |**%%--window-icon=ICONPATH%%** | Chemin de l'icône | | ||
| - | |**%%--width=WIDTH%%** | Hauteur de la boîte de dialogue | | ||
| - | |**%%--height=HEIGHT%%** | Largeur de la boîte de dialogue | | ||
| - | |**%%--timeout=TIMEOUT%%** | Temps d'affichage | | ||
| - | |**%%--timeout-indicator=POSITION%%** | FIXME | | ||
| - | |**%%--kill-parent%%** | Envoie SIGTERM au processus parent | | ||
| - | |**%%--text=STRING%%** | Texte à l’intérieur de la boîte de dialogue | | ||
| - | |**%%--image=IMAGE%%** | Image qui apparaît sur le côté gauche de la boîte de dialogue. \\ IMAGE peut être un nom de fichier ou le nom de l'icône du thème d'icônes courant.| | ||
| - | |**%%--image-on-top%%** | Place l'image au-dessus, doit-être utilisé avec l'option %%--image%% | | ||
| - | |**%%--icon-theme = THEME%%** | Utilise une icône du thème GTK au lieu de celle utilisé par défaut | | ||
| - | |**%%--expander=TEXT%%** | FIXME | | ||
| - | |**%%--button=BUTTON:ID%%** | Rajoute en bouton, ID correspond au code de sortie | | ||
| - | |**%%--no-buttons%%** | Affiche aucun bouton | | ||
| - | |**%%--no-markup%%** | FIXME | | ||
| - | |**%%--always-print-result%%** | Imprime toujours le résultat | | ||
| - | |**%%--dialog-sep%%** | FIXME | | ||
| - | |**%%--borders=NUM%%** | Définit les bordures de la boîte de dialogue | | ||
| - | |**%%--sticky%%** | Affiche la boîte de dialogue sur tous les bureaux | | ||
| - | |**%%--fixed%%** | Verrouille la hauteur et la largeur de la boîte de dialogue | | ||
| - | |**%%--center%%** | Place la boîte de dialogue à son ouverture au centre de l'écran | | ||
| - | |**%%--mouse%%** | Place la boîte dialogue à son ouverture sous la position de la souris | | ||
| - | |**%%--on-top%%** | Place la boîte dialogue à son ouverture par-dessus les autre fenêtre. | | ||
| - | |**%%--skip-taskbar%%** | N'affiche pas la boîte de dialogue dans la barre de tâche ou le pager | | ||
| - | |**%%--geometry=WIDTHxHEIGHT+X+Y%%** | FIXME | | ||
| - | |**%%--selectable-labels%%** | FIXME | | ||
| - | |||
| - | ===== Options spécifiques ===== | ||
| - | |||
| - | ==== Calendrier ==== | ||
| - | |||
| - | ^ Options ^ Descriptions | ||
| - | |**%%--day=INT%%** | Jour par défaut | | ||
| - | |**%%--month=INT%%** | Mois par défaut | | ||
| - | |**%%--year=INT%%** | Année par défaut | | ||
| - | |**%%--date-format=MOTIF%%** | Régler le format de retour la date. Par défaut c'est `% x ' \\ Pour plus info sur les format de date faire man date| | ||
| - | |**%%--details = FILENAME%%** | FIXME | | ||
| - | |**%%--init-color=COULEUR%%** | Définit une valeur initiale de la couleur. | | ||
| - | |**%%--extra%%** | FIXME | | ||
| - | |**%%--palette[= fichier]%%** | FIXME | | ||
| - | |||
| - | <note>Si aucun jour, mois, année est spécifiés c'est la date actuel qui est utilisé par défaut</note> | ||
| - | |||
| - | === Exemple === | ||
| - | |||
| - | Ci-dessous une boite de dialogue de type calendrier, avec une largeur de 250 et une hauteur de 200, comme titre "Calendrier Yad", date par défaut le 30 janvier 2000 et comme format de retour Année-Mois-Jour. | ||
| - | |||
| - | <file bash> | ||
| - | yad \ | ||
| - | --calendar \ | ||
| - | --width=250 \ | ||
| - | --height=200 \ | ||
| - | --title="Calendrier Yad" \ | ||
| - | --day="30" --month="1" --year="2000" \ | ||
| - | --date-format="%Y-%m-%d" | ||
| - | </file> | ||
| - | |||
| - | {{/file-R272fce0547b743152a543eb046f5aaef.png}} | ||
| - | |||
| - | ==== Drag-and-Drop ==== | ||
| - | |||
| - | ^ Options ^ Descriptions | ||
| - | |**%%--tooltip%%** | Utiliser un texte de dialogue comme une bulle d'aide. | | ||
| - | |**%%--command=CMD%%** | Lancer la commande lorsque les données sont reçues. Les chaînes de données passent comme la commande d'un argument. \\ Par défaut les données sont imprimé sur la sortie standard. | | ||
| - | |||
| - | |||
| - | === Exemple === | ||
| - | Ci-dessous une boite de dialogue de type Drag-and-Drop, avec une largeur de 400 et une hauteur de 100 avec comme titre "Drag & Drop Yad / Mplayer" qui nous permet de lancer une vidéo juste en glissant la vidéo sur la fenêtre. (Il faut au préalable avoir installer Mplayer). \\ | ||
| - | Si on passe avec le curseur sur la boite de dialogue l'info-bulle s'affiche. | ||
| - | |||
| - | <file bash> | ||
| - | yad \ | ||
| - | --dnd \ | ||
| - | --width=400 \ | ||
| - | --height=100 \ | ||
| - | --title "Drag & Drop Yad / Mplayer" \ | ||
| - | --text "Glisser ici le fichier vidéo à lire" \ | ||
| - | --image "insert-object" \ | ||
| - | --command=mplayer \ | ||
| - | --tooltip | ||
| - | </file> | ||
| - | |||
| - | {{/file-R8d6aaf1191e3a1dd0ad35e38247bb657.png}} | ||
| - | |||
| - | ===== Entry ===== | ||
| - | |||
| - | ^ Options ^ Descriptions | ||
| - | |**%%--entry-label=STRING%%** |Texte devant l'étiquette d'entrée. (équivalant à read en bash)| | ||
| - | |**%%--entry-text=STRING%%** |Text de défaut de l'étiquette| | ||
| - | |**%%--hide-text%%** |Cache le texte d'entrée. | | ||
| - | |**%%--completion%%** |Utilise l'achèvement lieu de combo-box. | | ||
| - | |**%%--editable%%** |Autorisation d'apporter des modifications au texte dans la liste déroulante. | | ||
| - | |**%%--numeric%%** |FIXME | | ||
| - | |**%%--licon=IMAGE%%** |Icône sur le côté gauche de l'entrée. | | ||
| - | |**%%--licon-action=CMD%%** |Commande qui sera exécuté lors d'un clique sur l'icône de gauche. La commande de sortie sera créée sous forme de texte d'entrée. | | ||
| - | |**%%--ricon=IMAGE%%** |Icône sur le côté droite de l'entrée. | | ||
| - | |**%%--ricon-action=CMD%%** |Commande qui sera exécuté lors d'un clique sur l'icône de droite. La commande de sortie sera créée sous forme de texte d'entrée. | | ||
| - | |**%%--num-sortie%%** |FIXME | | ||
| - | |||
| - | === Exemple === | ||
| - | |||
| - | Ci-dessous une boite de dialogue de type entry, avec une largeur de 400 et une hauteur de 100, comme titre "Yad Entry". Cette boite nous demande de taper le nom de l'utilisateur, nous pouvons soit taper le nom de l'utilisateur ou choisir un nom dans la liste déroulante. | ||
| - | |||
| - | <file bash> | ||
| - | yad / | ||
| - | --entry / | ||
| - | --title="Yad Entry" | ||
| - | --width=400 \ | ||
| - | --height=100 \ | ||
| - | --entry-label="Taper votre nom d'utilisateur" / | ||
| - | --editable / | ||
| - | --entry-text="$USER" " Toto" | ||
| - | </file> | ||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | |||
| - | ==== Options boite de dialogue icons ==== | ||
| - | |||
| - | ^ Options ^ Descriptions | ||
| - | |**%%--read-dir=PATH%%** | FIXME | | ||
| - | |**%%--generic%%** | FIXME | | ||
| - | |**%%--sort-by-name%%** | FIXME | | ||
| - | |**%%--descend%%** | FIXME | | ||
| - | |**%%--listen%%** | FIXME | | ||
| - | |**%%--item-width%%** | FIXME | | ||
| - | |**%%--compact%%** | FIXME | | ||
| - | |**%%--single-click%%** | FIXME | | ||
| - | |**%%--term%%** | FIXME | | ||
| - | |||
| - | ==== Options boite de dialogue file ==== | ||
| - | |||
| - | ^ Options ^ Descriptions | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |||
| - | |||
| - | ==== Options boite de dialogue font ==== | ||
| - | |||
| - | ^ Options ^ Descriptions | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |||
| - | |||
| - | ==== Options boite de dialogue form ==== | ||
| - | |||
| - | ^ Options ^ Descriptions | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |||
| - | |||
| - | ==== Options boite de dialogue list ==== | ||
| - | |||
| - | ^ Options ^ Descriptions | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |||
| - | |||
| - | ==== Options boite de dialogue notification ==== | ||
| - | |||
| - | ^ Options ^ Descriptions | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |||
| - | |||
| - | ==== Options boite de dialogue progress ==== | ||
| - | |||
| - | ^ Options ^ Descriptions | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |||
| - | |||
| - | ==== Options boite de dialogue text-info ==== | ||
| - | |||
| - | ^ Options ^ Descriptions | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |||
| - | ==== Options boite de dialogue scale ==== | ||
| - | |||
| - | ^ Options ^ Descriptions | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |**%%--xxxx%%** | FIXME | | ||
| - | |||
| - | |||
