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 Prochaine révision Les deux révisions suivantes | ||
|
utilisateurs:slyfox:tutos:yad [15/11/2015 10:09] Slyfox [Utilisation] |
utilisateurs:slyfox:tutos:yad [21/11/2015 18:09] Slyfox [Règles d'utilisation] |
||
|---|---|---|---|
| Ligne 18: | Ligne 18: | ||
| ==== Jessie stable==== | ==== Jessie stable==== | ||
| - | Apparemment il n'exsite pas de paquet pour 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) | Nous allons devoir l'installer par compilation. (la version actuelle est la 0.25.1) | ||
| <code root>apt-get update | <code root>apt-get update | ||
| Ligne 34: | Ligne 34: | ||
| - | ===== Utilisation ===== | + | ===== Règles d'utilisation ===== |
| - | ==== Boîte de dialogue ==== | + | * Yad s'utilise en ligne de commande via un terminal ou dans un script. |
| - | Yad permet d'afficher 13 types de boîte de dialogue- | + | * La ligne de commande doit commencer par yad suivit des options (voir chapitre "Options générales" et "Options spécifiques"). |
| - | ^ Argument ^ Description ^ | + | * L'ordre dans lequel interviennent le ou les options n'ont pas d'importance. |
| - | |''%%--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 | | + | |
| + | * Si une option spécifique n'est pas mentionnée c'est la valeur par défaut qui sera automatique appliqué par yad. | ||
| - | ==== Option général ==== | + | * Chaque option doit être précédée par 2 tirets "--". |
| - | A la suite du type de la boite de dialogue, nous pouvons choisir aucune, une ou plusieurs options générales qui peuvent s'appliquer pour tous les types de boîtes des dialogues ci-dessus. | + | * 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> | ||
| - | <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. | + | 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> | ||
| - | Voici un exemple avec une boite de dialogue du type calendrier et avec l'option ''%%--title=TITLE%%'' . \\ | + | Soit un mixte des deux méthodes ci-dessus: |
| - | <code user>yad --calendar --title="Mon calendrier Yad"</code></note> | + | |
| - | ^ option ^ Description ^ | + | <file bash> |
| - | |''%%--title=TITLE%%'' | Titre de la boîte de dialogue | | + | yad --calendar \ |
| - | |''%%--window-icon=ICONPATH%%'' | Chemin de l'icône | | + | --center --title="Mon calendrier" |
| - | |''%%--width=WIDTH%%'' | Hauteur de la boite de dialogue | | + | </file> |
| - | |''%%--height=HEIGHT%%'' | Largeur de la boite de dialogue | | + | |
| - | |''%%--timeout=TIMEOUT%%'' | Temps d'affichage | | + | |
| - | |''%%--timeout-indicator=POSITION%%'' | Voir le manuel pour plus d'information | | + | |
| - | |''%%--kill-parent%%'' | Envoie SIGTERM au processus parent | | + | |
| - | |''%%--text=STRING%%'' | Texte à l'interieur de la boite 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 = THÈME%%'' | Utilise une icône du thème GTK au lieu de celle utilisé par défaut | | + | |
| + | ===== Options boîtes de dialogue ===== | ||
| - | |''%%--expander=TEXT%%'' | Afficher une notification dans la zone prévue à cet effet | | + | Yad permet d'afficher 13 types de boite de dialogue. |
| - | |''%%--icon-theme=THEME%%'' | Permet de suivre une progression | | + | |
| - | |''%%--button=BUTTON:ID%%'' | Affiche un texte dans une fenêtre | | + | |
| - | |''%%--no-buttons%%'' | Choisir une valeur numérique à l'aide d'un curseur | | + | ^ Options ^ Descriptions |
| - | |''%%--no-markup%%'' | Affiche un calendrier | | + | |**%%--calendar%%** | Affiche un calendrier | |
| - | |''%%--always-print-result%%'' | Sélection de couleurs | | + | |**%%--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 | | ||
| - | |''%%--dialog-sep%%'' | Boîte drag-and-drop | | ||
| - | |''%%--borders=NUM%%'' | Permet la saisie de caractères | | ||
| - | |''%%--sticky%%'' | Boîte d'affichage avec icônes de raccourci | | ||
| - | |''%%--fixed%%'' | Sélection de fichiers ou/et dossiers | | ||
| - | |''%%--center%%'' | Sélection de la police | | ||
| - | |''%%--mouse%%'' | Permet la saisie de caractères | | ||
| - | |''%%--on-top%%'' | Affiche une liste | | + | ===== Options générales ===== |
| - | |''%%--skip-taskbar%%'' | Afficher une notification dans la zone prévue à cet effet | | + | |
| - | |''%%--geometry=WIDTHxHEIGHT+X+Y%%'' | Permet de suivre une progression | | + | |
| - | |''%%--selectable-labels%%'' | Affiche un texte dans une fenêtre | | + | |
| + | <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 comme titre "Qui est-ce ?". 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="Qui est-ce ?" --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 | | ||
