<?xml version='1.0' encoding='UTF-8'?>
<!-- $Id: conky-howto.xml,v 1.4 2012/06/30 18:42:54 swift Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">

<guide disclaimer="obsolete" lang="nl">
<title>Gentoo Linux Conky Howto</title>

<author title="Author">
  <mail link="admin@sdesign.us">Bill Woodford</mail>
</author>
<author title="Editor">
  <mail link="brenden@rty.ca">Brenden Matthews</mail>
</author>
<author title="Vertaler">
  <mail link="jonas@belandi.be">Jonas Drieghe</mail>
</author>
<author title="Vertaler">
  <mail link="diox@gentoo.org">Dimitry Bradt</mail>
</author>

<abstract>
Dit document omschrijft hoe je de systeemmonitor Conky installeert en
configureert.
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>

<version>1.2</version>
<date>2006-11-02</date>

<chapter>
<title>Achtergrond</title>
<section>
<title>Inleiding op Conky</title>
<body>

<p>Je hebt eindelijk je Gentoo machine en je hebt reeds 30 verschillende
commando's geleerd om de diverse aspecten van wat je computer aan het doen is
te monitoren. Wat doe je nu?  Is er geen eenvoudigere manier om de
systeemperformance te monitoren, om te zien wat het systeem aan het doen is en
om na te gaan welke bronnen je systeem in welke mate voor deze taken gebruikt?
Jawel, die is er. Dit is wat een systeemmonitor zoals Conky voor jou kan doen.
</p>

</body>
</section>
<section>
<title>Wat het doet</title>
<body>

<p>
In tegenstelling tot andere systeemmonitoren zoals top, kan Conky draaien als
een venster in een X sessie, of door rechtstreeks te schrijven naar het root
venster (er is ook de optie om de informatie van Conky naar stdout te schrijven,
maar dat bespreken we hier niet).  Conky geeft de verzamelde informatie weer in
de vorm van text, vooruitgangsbalken en grafieken.  Daarenboven is de Conky
uitvoer volldig door de gebruiker te configureren (in tegenstelling tot top).
Naast het monitoren van het systeem zelf kan Conky ook informatie geven over
verscheidene muziekspelers (zoals BMPx, Music Player Daemon en Audacious).
Conky kan je ook vertellen hoeveel nieuwe berichten in er jouw mail spool
zitten, en nog zoveel meer.  Als de functionaliteit die jij wenst nog niet in
Conky zit, kan je heel eenvoudig zelf een script schijven om de gewenste
informatie op te halen.  Enkele reeds uitgewerkte voorbeelden hiervaan zijn RSS
feeds, POP3 e-mail berichten teller, lokaal weerbericht, boinc status en zelfs
de status van portage.
</p>

</body>
</section>
</chapter>

<chapter>
<title>Conky installeren</title>
<section>
<title>Basis installatie</title>
<body>

<p>
Gentoo voorziet een ebuild om Conky snel en eenvoudig te installeren.  Hierbij
moet je vooral aandacht hebben voor de USE flags. Hoogstwaarschijnlijk wil je
X11 ondersteuning(<c>X</c>).  Daarnaast selecteer je best ook de USE flag voor
elke mediaspeler (naast MPD) die je wil gebruiken, zoals Audacious
(<c>audacious</c>). Als je de TCP poort monitor wil gebruiken moet je zeker de
<c>ipv6</c> USE flag uitschakelen. Dit is nodig omdat de poort monitor enkel
voor ipv4 systemen werkt.
</p>

<p>
In addition, the <c>truetype</c> USE flag compiles support for TrueType fonts
with the use of Xft. Most users will want this as well.
</p>

<pre caption="/etc/portage/package.use">
<comment>(Gebruik hetvolgende als een voorbeeld)</comment>
# <i>echo app-admin/conky truetype audacious -infopipe -ipv6 >> /etc/portage/package.use</i>
</pre>

<p>
Wanneer je de correcte USE flags hebt ingesteld is het tijd om Conky te
installeren !
</p>

<pre caption="Conky Installeren">
# <i>emerge -av conky</i>
</pre>

<p>
Je kan Conky testen om te bekijken hoe het er uit zal zien door envoudig weg het
commando <c>conky</c> uit te voeren in een terminal. Dit zal je een goed beeld
geven van hoe het er uit zal zien en wat je wil veranderen, toevoegen of zelfs
verwijderen.
</p>

<pre caption="Conky voor de eerste maal starten">
$ <i>conky</i>
</pre>

<note>
Conky heeft Double Buffer Extension (DBE) ondersteuning nodig van de X server
om flikkeringen te voorkomen. Dit komt omdat Conky het wenster niet snel genoeg
kan verversen zonder DBE.  Dit kan ingeschakeld worden in
<path>/etc/X11/xorg.conf</path> met de <c>Load "dbe"</c> lijn in <b>Section
"Module"</b>.
</note>

<p>
Wanneer je een idee hebt over hoe Conky er uit ziet kan je overschakelen tot de
configuratie!
</p>

</body>
</section>
<section>
<title>Conky configureren</title>
<body>

<p>
Standaard zal Conky zoeken voor het configuratiebestand <path>~/.conkyrc</path>
in de home map van de gebruiker.  Dit bestand bevat alle configuratie opties en
de statische tekst, kleuren en andere variabelen die bepalen welke data aan de
gebruiker wordt weergegeven.  Conky voorziet ook een schitterende
voorbeeldconfiguratie in
<path>/usr/share/doc/&lt;conky-version&gt;/Conkyrc.sample.gz</path>  Vervang
&lt;conky-version&gt; door de specifieke versie van Conky die jij hebt
geïnstalleerd.
</p>

<pre caption="De voorbeeldconfiguratie kopiëren naar jouw home map">
<comment>(Vervang <b>1.4.0-r1</b> door de versienummer van Conky)</comment>
$ <i>zcat /usr/share/doc/conky-1.4.0-r1/conkyrc.sample.gz >> ~/.conkyrc</i>
</pre>

<p>
Open nu de voorbeeldconfiguratie in een textverwerker naar keuze.  Je zal
opmerken dat er twee afzonderlijke delen in het configuratiebestand zijn.  Het
eerste deel van het bestand bevat de programmaconfiguratie en bepaalt hoe Concky
zich gedraagt.  Dit bevat ondermeer opties zoals <c>update_interval</c>, wat
bepaalt hoe dikwijls Conky de informate op het scherm zal actualiseren.  Het
tweede deel bevat de effectieve tekst, grafieken en variabelen die op het scherm
zullen worden weergegeven.  Dit deel bevat onderandere dingen zoals systeem
uptime (<c>$uptime</c>), cpu gebruik (<c>$cpu</c>) en alle andere dingen die jij
op je scherm wil zien.  Het eerste deel van het bestand start aan het het begin.
Het tweede deel bestaat uit alles achter de lijn <c>TEXT</c>.  Commentaar in het
bestand start met <c>#</c>, maar hou in het achterhoofd dat wanneer een
lijn in commentaar is gezet in het tweede deel van het bestand, de tekst toch
naar het scherm zal worden geschreven.
</p>

<p>
Een lijst van alle mogelijke configuratie opties en variabelen is te vinden op
<uri>http://conky.sourceforge.net/config_settings.html</uri> en
<uri>http://conky.sourceforge.net/variables.html</uri>. Daarnaast zijn er een
aantal mooie screenshots, enkele voorbeeldconfiguraties en een aantal scripts
terug te vinden op <uri>http://conky.sourceforge.net/screenshots.html</uri>.
</p>

</body>
</section>
</chapter>

<chapter>
<title>Conky uitbreiden</title>
<section>
<title>Meer dan enkel de ingebouwde variabelen</title>
<body>

<p>
Je bent al een heel eind opgeschoten met Conky en je hebt alle documentatie
uitgepluisd op zoek naar die extra variabele die Conky blijkbaar niet bezit...
Geen paniek!  Conky voorziet enkele variabelen die exact hiervoor zijn
gecreëerd.  <c>$exec</c> Zal een commando uitvoeren telkens wanneer Conky
actualiseert, <c>$execi</c> zal een commando uitvoeren op een gekozen interval
en <c>$texeci</c> zal een commando uitvoeren in zijn eigen thread op een gekozen
interval.
</p>

<pre caption="Script voorbeelden">
<i>${exec grep 'sudo' /var/log/messages | tail -n 4}</i>
<i>${execi 30 ~/scripts/emerge-status.sh</i>
<i>${texeci 600 ~/scripts/gmail.pl}</i>
</pre>

<note>
Hoewel elk commando dat in een shell werkt ook in elk van deze variabelen werkt
is het belangrijk om te onthouden dat het commando MOET eindigen. Dit wil
zeggen dat commando's zoals <c>tail -f</c> die blijven draaien <e>niet</e>
correct functionneren.
</note>

</body>
</section>
</chapter>
</guide>
