====== Conky : les fonctions ======
Les fonctions passées à conky déterminent sa position, ses dimensions, la police de caractères utilisée... bref, comment s'affiche conky. Cette page est une traduction (à compléter) de celle du manpage de Conky_1.8.0.\\

^Fonctions^Arguments^Définitions^
|alignment|top_left,top_right,top_middle,\\ bottom_left,bottom_right,bottom_middle,\\ middle_left,middle_middle,middle_right.|position de conky sur l'écran.|
|apend_file|adresse_du_fichier|prend en compte un fichier: les fonctions seront rejoutées à celles du conky en cours.|
|background|yes ou no|si yes, conky sera lancé en "background": il vous rendra la main.|
|border_inner_margin|nombre (pixels)|espace en pixels entre le texte et la bordure.|
|border_outer_margin|nombre (pixels)|espace en pixels entre la bordure et le bord de la fenêtre.|
|border_width|nombre (pixels)|épaisseur de la bordure en pixels.|
|colorN(0->9)|hexadecimal "XXXXXX" sans "#"|couleur prédéfinie (de 0 à 9) à utiliser dans la zone **TEXT**.|
|cpu_avg_samples|nombre|échantillon à prendre en compte pour le monitoring du cpu.|
|default_bar_size|nombre(pixels) hauteur longueur|dimensions par défaut des barres, ex: 'default_bar_size 4 10'\\ très utile pour les fonctions execbar et execibar.|
|default_color|hexadécimal/couleur|couleur par défaut du texte et des bordures, ex: 'default_color ffffff'\\ ou 'default_color white'.|
|default_gauge_size|(pixels) hauteur longueur|dimensions par défaut des compteurs, ex 'default_gauge_size 15 15'\\ très utile pour les fonctions execgauge et execigauge.|
|default_graph-size|(pixels) hauteur longueur|dimensions par défaut des graphiques, ex 'default_graph-size 4 10'\\ très utile pour les fonctions execgraph et execigraph.|
|default_outline_color|hexadécimal/couleur|couleur par défaut du contour de la police.|
|default_shade_color|hexadécimal/couleur|couleur par défaut de l'ombre de la police et des graphiques.|
|disable_auto_reload|yes ou no|si yes, conky ne recharge pas son fichier de configuration après une modification.|
|diskio_avg_samples|nombre|échantillon à prendre en compte pour le monitoring du la lecture/écriture.|
|display|--|choix de l'écran pour l'affichage.|
|double_buffer|yes ou no|si yes, utilise l'extension Xdbe: permet d'éliminer le clignotement.\\ Il est recommandé d'utiliser une fenêtre propre pour Conky afin de limiter la taille du double tampon.|
|draw_borders|yes ou no|si yes, conky affiche une bordure autour du texte.|
|draw_graph_borders|yes ou no|si yes, conky dessine une bordure autour des graphiques.|
|draw_outline|yes ou no|si yes, conky utilise la police avec un contour.|
|draw_shades|yes ou no|si yes, conky affiche les ombres sous le texte et les graphiques.|
|extra_newline|yes ou no|si yes et si 'out_to_console yes', conky rajoute une ligne en fin de fichier. Utile pour "piper" conky dans une wibox d'awesome.|
|font|nom_de_la_police|détermine la police utilisée par conky. //__obsolète>>voir xftfont__//.|
|format_human_readable|yes ou no|si yes, conky tente d'afficher les valeurs dans un format lisible (Kib,Mib,Gib).\\ si no, conky affiche toutes les valeurs en bytes.|
|gap_x|nombre (pixels)|marge en pixels entre le bord de l'écran et le coté droit/gauche de la fenêtre conky.|
|gap_y|nombre (pixels)|marge en pixels entre le bord de l'écran et le haut/bas de la fenêtre conky.|
|hddtemp_host|XXX.X.X.X|hôte sur lequel se connecte hddtemp, défaut: 127.0.0.1|
|hddtemp_port|--|port utilisé par hddtemp, défaut: 7634|
|if_up_sctrictness|up, link, address|détermine comment conky évalue la connexion réseau.|
|imap|serveur gloal IMAP; arguments : "host user pass [-i interval] [-f folder] [-p port] [-e command]".\\ Port par défaut: 143, dossier par défaut: 'INBOX', intervalle par défaut: 5 minutes.\\ Si le mot de passe est '*', il vous sera demandé au démarrage de Conky.||
|imlib_cache_flush_interval|nombre(secondes)|intervalle de rafraichissement du cache imlib en secondes.|
|imlib_cache_size|nombre (bytes)|taille du cache imlib, par défaut: 4MiB. Si conky affiche de nombreuses images,\\ il est conseillé de le désactiver avec 'imlib_cache_size 0'.|
|lua_draw_hook_post|nom_de_la_fonction|FIXME|
|lua_draw_hook_pre|nom_de_la_fonction|FIXME|
|lua_load|adresse du/des script(s)|conky charge le(s) script(s) lua, ex: 'lua_load ~/.conky/clock.lua'.|
|lua_shutdown_hook|nom_de_la_fonction|vide le cache de la 'fonction' afin préserver le système à l'extinction.|
|lua_startup_hook|nom_de_la_fonction|FIXME|
|mail_spool|--|mail spool pour la vérification des mails.|
|max_port_monitor_connections|nombre|nombre maximum de scan par port, par défaut 256.|
|max_specials|nombre|nombre maximal de variables spéciales; fonts, offsets, aligns... par défaut 512.|
|max_user_text|nombre (bytes)|taille maximale du buffer utilisateur, par défaut 16384 bytes.|
|maximum_width|nombre (pixels)|largeur maximale de la fenêtre conky en pixels.|
|minimum_size|(pixels) largeur hauteur|dimension minimale de la fenêtre conky, ex: 'minimum_size 200 500'.|
|mpd_host|--|hôte pour mpd //music player daemon//.|
|mpd_password|--|mot de passe du serveur mpd.|
|mpd_port|--|port pour mpd.|
|music_player_interval|nombre (seconds)|intervalle de vérification des données des lecteurs audio, par défaut: celui de conky.|
|net_avg_samples|nombre|échantillon à prendre en compte pour le monitoring du net.|
|no_buffers|yes ou no|si oui, conky ne prend pas en compte le buffer dans le calcul de l'utilisation mémoire.|
|out_to_console|yes ou no|si yes, envoi des informations de conky au STDOUT. Utile pour "piper" conky dans une statusbar.|
|out_to_ncurses|yes ou no|si yes, comme 'out_to_console' mais avec un rafraichissement de l'affichage au lieu d'une succession d'informations.|
|out_to_stderr|yes ou no|si yes, envoi des informations de conky au STDERR.|
|out_to_x|yes ou no|si no, pas d'affichage dans X: vérifier qu'aucune fonction graphique ne soit enclenchée,\\ et vérifier l'envoi des informations vers STDOUT ou STDERR.|
|override_utf8_locale|yes ou no|si yes, conky force l'encodage local utf-8. requiert XFT.|
|overwrite_file|adresse_du_fichier|écrase le fichier donné en argument.|
|own_window|yes ou no|si yes, conky dessine sa propre fenêtre.|
|own_window_class|nom 'WM_CLASS'|determine manuellement le 'WM-CLASS' de conky, par défaut: Conky.|
|own_window_color|hexadécimal/couleur|couleur de la fenêtre conky, ex: 'own_window_color 000000' ou 'own_window_color black'.|
|own_window_hints|undecorated,below,above,sticky,\\ skip_taskbar,skip_pager.|si 'own_window yes', configure les propriétés de conky dans le WM.\\ si 'own_window_type desktop', certaines valeurs sont définies par défaut.\\ si 'own_window_type override', ces valeurs sont ignorées.|
|own_window_title|titre|determine manuellement le titre de la fenêtre conky, par défaut: '<hôte> - conky'.|
|own_window_argb_visual|yes ou no|ARGB est utilisé pour les effets de transparence. Notez que vous aurez besoin d'un gestionnaire composite pour cela. Cette option fonctionne avec la fonction 'own_window_type override'.|
|own_window_argb_value|nombre (0->255)|niveau de transparence pour conky, où 0=transparent et 255=opaque.\\ Notez que si 'own_window_transparent yes', cette fonction n'a pas d'effet.|
|own_window_transparent|yes ou no|si yes, conky est transparent: comme 'own_window_argb_value 0'.|
|own_window_type|normal,desktop,dock,panel,override|si '**own_window yes**', determine le type de fenêtre utilisé par conky, par défaut: '**normal**': conky est traité comme les autre fenêtres et est controlé par le WM.\\ '**desktop**': aucune décoration, toujours visible, pas dans la barre des taches, visible sur tous les bureaux virtuels.\\ '**dock**': conky est placé dans le dock et en prend les propriétés, utile pour les wm possédant cette option (*box, pekwm..).\\ '**panel**': conky adopte les propriétés d'une barre de tache: pas de décoration, toujours visible, non-recouvrable par les fenêtres maximisées, visible sur tous les bureaux.\\ '**override**': conky n'est pas contrôlé par le WM, les 'hints'(conseils) sont ignorés. Cette option peut être utile pour les tilingWM (dwm,awesome,xmonad...).|
|pad_percents|FIXME||
|pop3|serveur global POP3; arguments : "host user pass [-i interval] [-p port] [-e command]".\\ Port par défaut : 110, intevalle par défaut : 5 minutes. Si le mot de passe est '*', il vous sera demandé au démarrage de Conky.||
|short_units|yes ou no|réduit l'affichage des unités: kiB=k, GiB=G, ... 'no' par défaut.|
|show_graph_range|yes ou no|si yes, conky affiche l'amplitude des graphiques. 'no'par défaut.|
|show_graph_scale|yes ou no|si yes, affiche la valeur maximale dans les graphiques.|
|stippled_borders|nombre (pixels)|si 'draw_borders yes', taille en pixels des pointillés de la bordure de conky.|
|temperature_unit|farenheit ou celsius|détermine les unités de température, par défaut: celsius.|
|templateN|nombre (0->9)|determine un modèle à utiliser après TEXT.FIXME expliquer la syntaxe des modèles.|
|text_buffer_size|nombre (bytes)|taille du buffer utilisé par conky, par défaut/minimum: 256. Ce tampon est utilisé pour stocker les informations renvoyées par les variables. tester plusieurs valeurs pour choisir entre la quantité de variables affichées et les performances de conky.|
|times_in_seconds|yes ou no|si yes, les variables de temps sont affichées en secondes. cette fonctions n'affecte pas $time, $tztime, ou $utime.|
|top_cpu_separate|yes ou no|si yes, la variable 'top' renvoie l'usage d'un processeur.\\ si no, 'top' renvoi l'usage des processeurs combinés.|
|top_name_width|nombre|longueur des noms des processus renvoyés par 'top', par défaut: 15.|
|total_run_times|nombre|nombre de rechargements de conky avant de quitter. Zéro fait tourner conky indéfiniment.|
|update_interval|nombre (secondes)|fréquence de rafraichissement de conky.|
|update_interval_on_battery|nombre (secondes)|fréquence de rafraichissement de conky sur battery.|
|uppercase|yes ou no|si yes, affiche les caractères en majuscules.|
|use_spacer|left,right,none|ajoute un espace avant ou après certaines variables pour les empêcher de bouger. **ne fonctionne qu'avec une police à chasse fixe**.|
|use_xft|yes ou no|si yes, conky utilise les polices 'xft', active l'anti-crenelage...|
|xftalpha|nombre (0->1)|opacité de la police définie par 'xftfont', 0=transparent, 1=opaque.|
|xftfont|nom_de_la_police:size=nombre|si '**use_xft yes**', détermine la police par défaut utilisée par conky.\\ ex: 'xftfont Terminus:pixelsize=10' - 'xftfont Aller:size=8:bold'.|
^TEXT|ici commence l'affichage des [[personaliser:conky:variables|variables]].||