View source for Basic Tips for conky/fr

<languages/>
__TOC__
==Installation==
Conky peut être installé en utilisant le gestionnaire de paquets
{{UserCmd|command=pamac install conky}}

===Configuration===
Tout fichier ayant un nom commençant par un point <code>.</code> est un fichier caché. Si vous voulez voir ces fichiers, il faudra les rendre visibles. Activez l'option le permettant dans votre explorateur de fichier (ce qui peut être fait avec Ctrl+h dans certains).
====Fichiers de configuration====
Les fichiers de configuration par défaut sont présents dans {{ic|/usr/share/doc/conky-1.11.5_pre/conky.conf}}, pensez juste à changer le numéro de version par le vôtre. 
Conky ne crée pas de fichiers ou de dossiers de configuration locaux à l'utilisateur, il faudra donc créer d'abord le dossier avec :
{{UserCmd|command=mkdir -p ~/.config/conky}}
Et ensuite copier le fichier de configuration à l'intérieur
{{UserCmd|command=cp /usr/share/doc/conky-1.11.5_pre/conky.conf ~/.config/conky/conky.conf}}
Ce fichier est un bête document texte respectant la [[https://www.lua.org/ |syntaxe LUA]], et possède la propriété d'être découpé en deux parties bien distinctes.

* La configuration
* Du texte

===Configuration de Conky===
La partie la plus haute contient tous les éléments nécessaires à la configuration de conky, par exemple la position sur l'écran, la transparence, la gestion des bords, la fréquence de rafraîchissement ou encore la gestion de la police. Toutes les règles de configuration se trouvent alors dans des accolades comme ci-dessous
{{File|file=~/.config/conky/conky.conf|
content=<pre>conky.config = {
};</pre>
Il y a cependant quelques règles

* Chaque ligne doit finir par une virgule <code>,</code>
* Les valeurs qui ne sont ni des nombres ni des booléens (True/False) doivent être placé entre guillemets <code>'</code>
* Un commentaire commence par <code>--</code>
}}
===Exemples===
'''1.''' L'exemple ci-dessous donnera une couleur blanche au texte de Conky. Accessoirement, <code>color1</code> permet grâce au [http://html-color-codes.info/ code couleur HTML] d'obtenir un bleu assez clair :
{{File|file=~/.config/conky/conky.conf|
content=<pre>conky.config = {
...
    default_color = 'white',    -- Blanc par défaut
    color1 = '0ab1ff',          -- Bleu clair
...
};</pre>
}}
'''2.''' Ici, nous activons Xft, changeons la police de base (LiberationMono), la mettons en gras et changeons sa taille (8):
{{File|file=~/.config/conky/conky.conf|
content=<pre>conky.config = {
...
    use_xft = true,
    font = 'LiberationMono:bold:size=8',
...
};</pre>
}}
'''3.''' Afin de changer la position de Conky sur votre écran, modifiez les valeurs suivantes :
{{File|file=~/.config/conky/conky.conf|
content=<pre>conky.config = {
...
    alignment = 'top_right',     -- Pour le placer dans le coin en haut à droite
    gap_x 18,                    -- avec un écart horizontal de 18 pixels (par apport au coin)
    gap_y 20,                    -- et un écart vertical de 20 pixel (toujours par apport au coin).
...
};</pre>
}}
'''4.''' Dans certaines situations, il se peut que vous ayez plusieurs valeurs pour un seul paramètre. Il faudra alors les séparer avec une virgule, comme suit :
{{File|file=~/.config/conky/conky.conf|
content=<pre>conky.config = {
...
    own_window_hints = 'undecorated,sticky,skip_taskbar,skip_pager,below',
...
};</pre>
}}
On le répétera jamais assez, mais le manuel est votre meilleur allié : <code>man conky</code>, jetez un œil sous '''CONFIGURATION SETTINGS''' pour voir toutes les options disponibles.

===Texte affiché par Conky===
La seconde partie contient le code qui sera affiché par Conky. Chaque ligne correspond à une indication qui figurera sur Conky. Il y en a tout un tas et nous ne pourrons toutes les exposer ici, alors vous savez que seule le manuel pourra vous guider entièrement dans cette tâche infernale : <code>man conky</code>, regardez en-deçà de '''OBJECTS/VARIABLES''' pour connaître toutes les options et variables disponibles.
{{BoxInfo|Info|Les lignes à l'intérieur de '''conky.text''' seront imprimées à l'identique. Ex : si vous laissez une ligne vide dans le fichier, Conky affichera une ligne vide.}}

Le code complet doit être placé entre ces deux paires de crochets :
{{File|file=~/.config/conky/conky.conf|
content=<pre>conky.text = [[
]];</pre>
}}
===Examples===
'''1.''' You can choose the color of your font using one of the following variables:
{{File|file=~/.config/conky/conky.conf|
content=<pre>conky.text = [[
...
${color}
${color1}
...
]];</pre>
}}

Chaque variable commence par un signe <code>$</code> et est entourée d'accolades <code>{ }</code> (nécessaires si la variable contient plusieurs mots).

'''2.''' Vous pouvez utiliser la police par défaut (et la taille de lettre qui va avec) en utilisant :
{{File|file=~/.config/conky/conky.conf|
content=<pre>conky.text = [[
...
$font
...
]];</pre>
}}
Si vous préférez une autre police (DejaVuSerif par exemple) et une autre taille de lettre (9, pour continuer l'exemple) dans votre conky, utilisez ces lignes dans votre code <code>.conf</code>:
{{File|file=~/.config/conky/conky.conf|
content=<pre>conky.text = [[
...
${font DejaVuSerif:size=9}
...
]];</pre>
}}
'''3.''' Cette ligne de code affiche "Kernel: " et le kernel que vous utilisez (l'utilisation de <code>$alignr</code> permet uniquement de mieux formater le texte (aligner vers la droite), ce n'est pas nécessaire) :
{{File|file=~/.config/conky/conky.conf|
content=<pre>conky.text = [[
Kernel: ${alignr}${kernel}
]];</pre>
}}
'''4.''' Cette variable vous donne les titres des trois derniers articles parrus sur le blog de Manjaro (avec RSS). Elle se met à jour toutes les 60 minutes.
{{File|file=~/.config/conky/conky.conf|
content=<pre>conky.text = [[
${rss http://manjaro.org/feed/ 60 item_titles 3}
]];</pre>
}}
'''5.''' Des informations sur la racine (<code>/</code>) de votre système Manjaro peuvent être affichées avec :
{{File|file=~/.config/conky/conky.conf|
content=<pre>conky.text = [[
Root: ${alignr}${fs_used /} of ${fs_size /}
]];</pre>
}}
'''6.''' À la place de l'exemple 3, vous pouvez utiliser les lignes suivantes pour le même objectif :
{{File|file=~/.config/conky/conky.conf|
content=<pre>conky.text = [[
Kernel: ${alignr}${execi 3600 uname -r}
]];</pre>
}}

===execi===
La variable <code>${execi 3600 XXXX}</code> lance la commande bash <code>XXXX</code> dans votre terminal toutes les 3600 secondes (1h) et affiche le résultat dans Conky. Le résultat de la commande <code>uname -r</code> est le nom de votre kernel actuel. 

Utilisez n'importe quelle commande à la place de <code>XXXX</code>, la seule limite est votre imagination. La commande peut être aussi longue et tortureuse que vous le désirez. 

{{BoxInfo|Warning|Utilisez des commandes plus compliquées (utilisant d'autres programmes, ou écrivant dans des fichiers volumineux par exemple), dans des intervalles relativement courts (ex : <code>${execi 2 XXXX}</code> lance <code>XXXX</code> toutes les 2 secondes et affiche le résultat dans Conky), peut amener à des consommations intensives de ressources, voir geler l'ordinateur.}}

===Lancer conky===
Si vous voulez affichez un widget Conky sur votre bureau, un fichier {{ic|~/.config/conky/conky.conf}} avec du code est requis. Si vous en avez un, ouvrez un terminal et lancer Conky de sorte qu'il utilise ce fichier :
{{UserCmd|command=conky -c ~/.config/conky/conky.conf}}
La commande précédente reste figée sur les potentielles erreurs que peut renvoyer Conky. Pour lancer Conky en arrière-plan (comme un daemon), utilisez :
{{UserCmd|command=conky -d -c ~/.config/conky/conky.conf}}

Pour démarrer Conky automatiquement à chaque initialisation du système, il vous faudra trouver comment faire sur votre [[Special:MyLanguage/Desktop_Environments_and_Window_Managers | environnement de bureau]]. Les exemples suivant illustrent comment lancer Conky depuis votre fichier folder/file/script/command.
<code>sleep 20</code> et <code>-p 20</code> décale le lancement de Conky de 20 secondes après celui de l'environnement de Bureau. Ajustez cette valeur à votre convenance.

{{UserCmd|command=conky -c ~/.config/conky/conky.conf &}}
{{UserCmd|command=sleep 20 && conky -c ~/.config/conky/conky.conf &}}

Lorsque vous changez le fichier de configuration Conky en cours d'exécution, Conky redémarrera. Mais si vous changez un de vos scripts (ex : vous voulez voir le résultat d'un changement de variable), vous devrez alors recharger Conky :
{{UserCmd|command=killall conky && conky -c ~/.config/config/conky.conf}}

===Dépannage et Conseils===

====Rings manquant====

<div lang="en" dir="ltr" class="mw-content-ltr">
To be able to use LUA scripts to execute drawing functions like clock rings - you will a conky package compiled with LUA support. Either build the package the package {{ic|conky-lua}} from [[Arch_User_Repository|AUR]] or install the {{ic|conky-lua-nv}} from the official repo.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
====Missing network information====
If network information is missing like download speed or network name (SSID), you need to replace the network interfaces in the configuration file with your network interface name. To get the names of your interfaces - open a terminal and execute
{{UserCmd|command=ip a | grep ' state UP' | cut -d' ' -f2 | cut -d':' -f1}}
Use the output from the command. Interface names starting with <code>en</code> is ethernet interface and names starting with <code>wl</code> is wireless interfaces. Replace all network interfaces names with (e.g. <code>wlan0</code>, <code>eth0</code>) in your <code>.conf</code> text section with the interface name(s) you retrieved from the above command.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Conky Manager===
An application named Conky manager exist but has not been updated for years and the configurations found in the package may work or they may not. You may install it - it can be a used as an inspiration but you should not rely on it. If you still think you it is a must have - you can build the package {{ic|conky-manager}} using [[Arch_User_Repository|AUR]]
{{UserCmd|command=pamac build conky-manager}}
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==See Also==
* The [https://github.com/brndnmtthws/conky/wiki Conky website]
* The [https://wiki.archlinux.org/index.php/conky Arch Wiki] page for Conky
</div>
[[Category:Contents Page{{#translation:}}]]
[[Category:Applications{{#translation:}}]]