Debian-facile

Bienvenue sur Debian-Facile, site d'aide pour les nouveaux utilisateurs de Debian.

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 → ODT PDF Export

Yad

CE WIKI EST EN CONSTRUCTION… ;)

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

apt-get update
apt-get install yad

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)

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

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.
  • 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:

yad --calendar --center --title="Mon calendrier"

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:

yad \
--calendar \
--center \
--title="Mon calendrier"

Soit un mixte des deux méthodes ci-dessus:

yad --calendar \
--center --title="Mon calendrier"

Options boîtes de dialogue

Yad permet d'afficher 17 types de boite de dialogue.

Options
--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 Formulaire
--html Affiche une boite de dialogue HTLM
--list Affiche une liste
--multi-progress Affiche plusieurs barres de progressions
--notebook Affichage portable
--notification Affiche l'icône notification
--print Affichage d'impression
--progress Permet de suivre une progression
--text-info Affiche un texte d'information
--scale Choisir une valeur numérique à l'aide d'un curseur

Options générales

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.

Options
--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 Affiche l'indicateur de délai en position donnée. Les positions sont top (haut), bottom (bas), left (gauche) ou right (droit)e. le style indicateur peut être défini dans le fichier de gtkrc. Voir https://code.google.com/p/yad/wiki/TimeoutIndicator pour plus de détails.
--parent-win=XID Spécifie une fenêtre parent pour le dialogue. Cela rend YAD la possibilité d'utiliser comme outil graphique intégré.
--kill-parent[=SIGNAL] Envoie un signal au processus parent. La valeur par défaut de signal est un SIGTERM. SIGNAL peut être spécifié par son numéro ou le nom symbolique avec ou sans préfixe SIG. Voir https://www.mankier.com/7/signal pour plus de détails sur les signaux.
--plug=KEY Crée un onglet, voir option –netbook
--tabnum=NUMBER Définit le nombre d'onglet, voir option –netbook
--text=STRING Texte à l’intérieur de la boîte de dialogue
--text-align=TYPE Justification du texte, TYPE peut être left (gauche), right (droite), center (centre) or fill (rempli)
--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 Cache le widget principal avec extension. TEXTE est un argument optionnel avec l'étiquette de expandeur.
--button=BUTTON:ID Rajoute un bouton, cette option peut-être utilisé plusieurs fois. BUTTON peut être un nom gtk pour les boutons prédéfinis (comme gtk-close ou gtk-ok) ou un texte dans un formulaire LABEL[!ICON[!TOOLTIP]] où `! ' est un séparateur d'article. La liste complète des articles en mémoire peut être trouvé dans le programme gtk-demo, l'extrait est appelé «Stock Items and Icon Browser“. Si aucun bouton n'est spécifiés, les boutons OK et Annuler sont utilisés. Voir la section EXIT STATUS pour plus. ID est un code de sortie ou d'une commande. Si ID a une valeur non-numérique il traite ID comme une commande, le clique sur tel bouton ne ferme pas la boîte de dialogue.
--no-buttons Affiche aucun bouton
--buttons-layout=TYPE Set de boutons de disposition. Les types possibles sont: lspread, edge, start, end ou center. Par défaut est end.
--no-markup N'utilise pas la majoration pango dans le texte de dialogue.
--no-escape Ne fermez pas la boite de dialogue si Escape est pressé.
--always-print-result Imprime toujours le résultat
--dialog-sep Montre le séparateur entre la boite de dialogue et les boutons. Fonctionne uniquement avec gtk+-2.0.
--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.
--undecorated Fenêtre sans décoration (retire les titres et les bordures des fenêtres).
--skip-taskbar Ne affiche pas la fenêtre dans la barre des tâches et le pager.
--maximized Exécute en mode maximisée.
--fullscreen Exécute en mode plein écran. Cette option peut ne pas fonctionner sur tous les gestionnaires de fenêtres.
--splash Ouvre la boite de dialogue avec “SplashScreen” conseils de fenêtre. Pour plus de détails voir la description de _NET_WM_WINDOW_TYPE_SPLASH dans la spécification de EWMH. Le comportement avec cette option dépend fortement des paramètres du gestionnaire de fenêtre utilisées.
--no-focus Ne prend pas de focus
--geometry=WIDTHxHEIGHT+X+Y Utilise la notation de géométrie X Window standard pour placer la boite de dialogue. Lorsque cette option est utilisée, la largeur, la hauteur, la souris et les options centré sont ignorés.
--selectable-labels Si elle est définie, l'utilisateur peut sélectionner le texte de dialogue et le copier dans le presse-papiers. Cette option affecte également sur les champs d'étiquettes dans la boite de dialogue de formulaire.
--image-path=PATH Ajoute le chemin d'accès spécifié à la liste standard des répertoires pour la recherche d'icônes. Cette option peut être utilisée plusieurs fois.
--rest=FILENAME Lit les arguments supplémentaires à partir de fichier donné à la place de la ligne de commande. Chaque ligne du fichier sont traité comme un seul argument.
--gtkrc=FILENAME Lit et analyse les paramètres GTK+ supplémentaires du fichier de donnée.

Options spécifiques

--calendar

Options
--day=INT Jour par défaut
--month=INT Mois par défaut
--year=INT Année par défaut
--date-format=PATTERN Régle le format de retour de la date. Par défaut c'est `% x '
Pour plus info sur les formats de date voir man date.
--details=FILENAME Lit la description des jours du nom de fichier.
Le fichier avec les détails des jours doit avoir le format suivant: <date> <description>
Le champ de date est au format date spécifié avec –date-format. La description de la chaîne avec des détails de date, peuvent être inclut au balisage Pango.

Si aucun jour, mois, année est spécifiés c'est la date actuel qui est utilisé par défaut

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.

yad \
--calendar \
--width=250 \
--height=200 \
--title="Calendrier Yad" \
--day="30" --month="1" --year="2000" \
--date-format="%Y-%m-%d"

--color

Options
--init-color=COLOR Définit la valeur initiale de la couleur.
--gtk-palette Afficher la palette de couleur du système à l'intérieur de la boite dialogue.
--extra Affiche des informations supplémentaires à propos de la couleur dans la chaîne retournée.
--alpha Ajoute l'opacité à chaîne de couleur de sortie
--palette[=FILENAME] Affiche la palette et définit les couleurs prédéfinies du nom de fichier donné. Par défaut /etc/X11/rgb.txt est utilisé.
--expand-palette
--mode=MODE Régle le mode de couleur de sortie. Les valeurs possibles sont en hexadécimales ou RGB. Par défaut c'est en hexadécimal. Mode hexadécimal ressemble à #rrggbbaa, mode RVB - rgba (r, g, b, a). Dans le mode RGBA l'opacité ont des valeurs de 0.0 à 1.0.

--dnd

Options
--tooltip Utilise un texte de dialogue comme une bulle d'aide.
--command=CMD Lance 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ées 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.

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

--entry

Options
--entry-label=STRING Régle le texte de l'étiquette d'entrée. (équivalant à read en bash)
--entry-text=STRING Régle le texte de l'entrée initiale ou élément par défaut dans la liste déroulante.
--hide-text Cache le texte d'entrée.
--completion Utilise l'achèvement au lieu de combo-box.
--editable Autorise les modifications du texte dans la liste déroulante.
--numeric Utilise un bouton au lieu de la saisie de texte. Les paramètres supplémentaires en ligne de commande sont traité comme valeurs minimales et maximales, la valeur de l'étape et de précisions (dans cet ordre). Toutes ces valeurs sont facultatifs. Plage par défaut est entre 0 et 65535 à l'étape 1.
--licon=IMAGE Définit une icône sur un côté gauche de l'entrée.
--licon-action=CMD Spécifie une commande qui sera exécuté lorsque l'icône de gauche est cliqué. La sortie de la commande sera créée sous forme de texte d'entrée.
--ricon=IMAGE Définit une icône sur un côté droite de l'entrée.
--ricon-action=CMD Spécifie une commande qui sera exécuté lorsque l'icône de droite est cliqué. La sortie de la commande sera créée sous forme de texte d'entrée.
--num-sortie Indice de sortie de l'élément actif au lieu du texte d'entrée pour la combo-box. Toutes les données supplémentaires spécifiées dans la ligne de commande rajoute un des éléments de la liste déroulante à l'entrée, à l'exception du mode numérique. Si on ne donne pas d'icône indiquée et d'icône d'action, le clic sur l'icône retourne juste l'entrée. Les champs numériques sont ignorés par les icônes.

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.

yad \
--entry \
--title="Qui est-ce ?" \
--entry-label="Taper votre nom d'utilisateur" \
--editable \
--entry-text="$USER" "Toto" 

--icons

Options
--read-dir=PATH Liste les fichiers de type .desktop du répertoire spécifié.
--generic Utilise le nom générique du raccourci.
--sort-by-name Trie les icônes par ordre alphabétique
--descend Trie les éléments dans l'ordre décroissant. Si les données sont STDIN cette option est inutile sans –sort-by-name.
--listen Lit les données de l'entrée standard. Les données doivent être dans l'ordre -. Nom, Info-bulle, Icône, commande, interm séparés par un saut de ligne interm est insensible à la casse constante booléenne (VRAI ou FAUX).
--item-width Régle la largeur.
--compact Utilise le mode compact. l'icône et le nom de chaque élément est placé dans une seule rangée.
--single-click Active les éléments par simple clic de souris. Cette option ne fonctionne pas correctement en cas de mode compact.
--term Modèle pour terminal. Utilise par défaut ` xterm-e %s' où %s remplacé par la commande. Si les deux répertoires et stdin sont spécifiés, le contenu de iconbox sera lu à partir du répertoire.

Exemple

Ci-dessous une boite de dialogue de type icons, avec une largeur de 1000 et une hauteur de 900, comme titre “Mon menu”, qui nous permet de lancer une application par un simple double-clic.

yad \
--icons \
--title="Mon menu" \
--width=1000 \
--height=900 \
--read-dir=/usr/share/applications yad \
--sort-by-name

--file

Options
--filename=FILENAME Définit le nom du fichier.
--multiple Permet la sélection de plusieurs noms de fichiers.
--directory Active la sélection du répertoire uniquement
--save FIXME
--separator=STRING FIXME
--confirm-overwrite[=TEXT] FIXME
--quoted-output FIXME

--font

Options
--fontname=FONTNAME FIXME
--preview FIXME

--form

Options
--field=LABEL[:TYPE] FIXME
FIXME FIXME
FIXME FIXME
--align=TYPE FIXME
--columns=NUMBER FIXME
--separator=STRING FIXME
--item-separator=STRING FIXME
--date-format=PATTERN FIXME
--scroll FIXME
--quoted-output FIXME
--output-by-row FIXME
--num-output FIXME

--html

Options
--uri=URI FIXME
--browser FIXME
--print-uri FIXME
--mime=MIME FIXME
--encodintg=ENCODING FIXME

--list

Options
--column=STRING[:TYPE] FIXME
FIXME FIXME
FIXMEFIXME
--checklist FIXME
--radiolist FIXME
--separator=STRING FIXME
--multiple FIXME
--editable FIXME
--no-headers FIXME
--no-click FIXME
--no-rules-hint FIXME
--print-all FIXME
--print-column=NUMBER FIXME
--hide-column=NUMBER FIXME
--expand-column=NUMBER FIXME
--search-column=NUMBER FIXME
--tooltip-column=NUMBER FIXME
--sep-column=NUMBER FIXME
--sep-value=TEXT FIXME
--limit=NUMBER FIXME
--ellipsize=TYPE FIXME
--dclick-action=CMD FIXME
--regex-search FIXME
--listen FIXME
--quoted-output FIXME

--multi-progress

Options
--bar=LABEL[:TYPE] FIXME
--vertical FIXME
--align=TYPE FIXME

--notebook

Options
--key=KEY FIXME
--tab=TEXT FIXME
--tab-pos=TYPE FIXME
--tab-borders=NUMBER FIXME

--notification

Options
--command=CMD FIXME
--listen FIXME
--separator=STRING FIXME
--item-separator=STRING FIXME
--menu=STRING FIXME
--no-middle FIXME
--hidden FIXME

==== PANED ==== FIXME

Options
--key=KEY FIXME
--orient=TYPE FIXME
--splitter=POS FIXME

--print

Options
--type=TYPE FIXME
--filename=FILENAME FIXME
--headers FIXME
--add-preview FIXME
--fontname=FONTNAME FIXME

--progress

Options
--progress-text=TEXT FIXME
--percentage=NUMBER FIXME
--auto-close FIXME
--auto-kill FIXME
--pulsate FIXME
--enable-log[=TEXT] FIXME
--log-on-top FIXME
--log-expanded FIXME
--log-height FIXME

--text-info

Options
--filename=FILENAME FIXME
--editable FIXME
--fore=COLOR FIXME
--back=COLOR FIXME
--fontname=FONTNAME FIXME
--wrap FIXME
--justify=TYPE FIXME
--margins=NUMBER FIXME
--tail FIXME
--show-uri FIXME
--uri-color FIXME
--listen FIXME

--scale

Options
--value=VALUE FIXME
--min-value=VALUE FIXME
--max-value=VALUE FIXME
--step=VALUE FIXME
--page=VALUE FIXME
--print-partial FIXME
--hide-value FIXME
--vertical FIXME
--invert FIXME
--mark=[NAME]:VALUE FIXME

File Filters Options

Options
--file-filter=NAME | PATTERN1 PATTERN2 ... FIXME
--mime-filter=NAME | MIME1 MIME2 ... FIXME
--image-filter=[NAME] FIXME
--add-preview FIXME

Miscellaneous

Options
-?, --help FIXME
--about FIXME
--version FIXME
utilisateurs/slyfox/tutos/yad.txt · Dernière modification: 02/02/2016 22:32 par Slyfox

Pied de page des forums

Propulsé par FluxBB