# Manuel de &knewsticker;

Frerich
Raabe

    raabe@kde.org

Jonathan
Singer
Relecteur

    jsinger@genome.wi.mit.edu

&traducteurYvesDessertine;
2001
Frerich Raabe
&FDLNotice;
2002-04-10
1.00.00

&knewsticker; est une applet téléscripteur de nouvelles pour le tableau de bord de &kde; (connu aussi sous le nom de &kicker;).

KDE
KNewsTicker
kdenetwork
téléscripteur de nouvelles
applet

## Introduction

&knewsticker; est une applet pour le tableau de bord de &kde; 2.x (connu aussi sous le nom de &kicker;) qui fournit un moyen facile et commode d'accéder aux nouvelles reportées par de nombreux sites de nouvelles (tels Slashdot, Linux Weekly News ou Freshmeat).

Pour y parvenir, &knewsticker; requiert un fichier spécial RDF ou RSS de la part des sites de nouvelles, qui contient les titres des nouvelles ainsi que les liens correspondant aux articles complets. De tels fichiers sont très courants ces temps-ci, et &knewsticker; est fourni avec une sélection de bonnes sources de nouvelles fournissant de tels fichiers.

### Brève information à propos des fichiers RDF

Les fichiers RDF sont en train de devenir de plus en plus populaires ces derniers temps, et cette applet n'est pas la première application à les utiliser. Mais que sont les fichiers RDF ? Cette section tente de donner une réponse courte à cette question, ainsi que des liens vers d'autres sources pour une référence complémentaire.

RDF est l'acronyme de Resource Definition Framework . Il a été inventé par le World Wide Web Consortium et est une des premières applications du Extensible Markup Language ( XML)). Les fichiers RDF (ainsi que les très similaires fichiers RSS) définissent et décrivent des données appelées méta-données &cad; l'information à propos de l'information.

Les fichiers RDF peuvent être utilisés pour tous les types de méta-données, et pas uniquement des nouvelles. Cependant, ils sont devenus très populaires parmi les sites de nouvelles, parce qu'ils fournissent un moyen propre, simple et portable de distribuer des nouvelles. Les sites de nouvelles fournissent un fichier RDF qui contient en fait un jeu d'enregistrements, et chaque enregistrement est composé d'un titre et d'une URL pointant vers l'article complet. Le fichier RDF contient aussi le nom officiel de site de nouvelles ainsi que d'autres informations générales qui sont lues et interprétées par &knewsticker;.

Bien sûr, ceci n'est qu'un essai d'explication court et fortement incomplet des idées basiques derrière les fichiers RDF et les meta-données. Si vous êtes intéressé par ce sujet, vous pourriez vouloir suivre les liens qui pointent vers des sources complémentaires et plus complètent sur ce sujet :

http://www.oasis-open.org/cover/rdf.html

  Cette page est une bonne description du Resource Definition Framework et fournit une grande liste de liens vers d'autres sites traitant de ce sujet. Aucune connaissance spéciale n'est nécessaire pour comprendre cette page, et elle est très à jour.

http://www.ccil.org/~cowan/XML/RDF-made-easy.html

  Ici, vous trouverez un point de vue plus pratique sur le Resource Definition Framework. Cette page démontre l'usage des fichiers RDF et montre pourquoi et quand ils sont appropriés. Le lecteur devrait être familier avec le standard XML 1.0 défini par le World Wide Web Consortium avant de lire ce texte.

http://www.andrew.cmu.edu/user/mingfai/rdf/

  Ceci est une liste de sites traitant de fichiers RDF grande et très complète. Vous pouvez envisager de conserver l'adresse de cette page dans vos signets pour une référence complémentaire, elle est aussi assez à jour et ne liste virtuellement aucun lien mort.

http://www.w3.org/RDF/

  La source qui fait autorité directement depuis le World Wide Web Consortium. Elle comprend une liste de liens complète vers d'autres sites sur le sujet ainsi qu'un historique du développement du RDF, une vue d'ensemble de l'architecture, une archive contenant des articles à propos du RDF, ainsi qu'une liste soigneusement élaborée d'outils destinés aux développeurs qui auraient l'intention de travailler avec du RDF.

Si vous trouvez d'autres sites ou documents sur ce sujet, n'hésitez pas à les envoyer à Frerich Raabe raabe@kde.org de sorte qu'ils puissent être inclus dans ce document et qu'ils aident tout le monde.

Merci beaucoup !

## Démarrage de &knewsticker;

Voici une capture d'écran de &knewsticker; dans le tableau de bord de &kde;
Voici une capture d'écran de &knewsticker; dans le tableau de bord de &kde;

&knewsticker; est démarré comme n'importe quelle autre applet &kicker;. Vous avez juste à l'ajouter dans le tableau de bord (ou dans un mini tableau de bord). Pour cela, choisissez simplement Téléscripteur dans le sous-menu Applet de &kicker;.

Voici une capture d'écran de &knewsticker; dans son propre mini tableau de bord.
Voici une capture d'écran de &knewsticker; dans son propre mini tableau de bord.

Une autre bonne façon d'utiliser &knewsticker; est de le placer dans son propre mini tableau de bord. Ajoutez simplement un mini tableau de bord en sélectionnant Ajouter Extension Mini tableau de bord depuis le menu contextuel de &kicker;. Maintenant, vous pouvez simplement changer &knewsticker; dans le mini tableau de bord comme expliqué ci-dessus.

## Configuration de &knewsticker;

Comme l'un des objectifs de &knewsticker; est une intégration étroite dans le système, il y a plus d'une façon d'ajuster la manière dont il travaille.

Avec le &centreConfiguration;

  Lancez le &centreConfiguration; en cliquant sur le bouton dans le tableau de bord de &kde; ou choisissez l'entrée correspondante dans le menu K. Puis, explorez le module &knewsticker; dans la vue arborescente sur la gauche en choisissant Afficheur de nouvelles dans le sous-menu Personnalisation.

Avec le &BDS;

  Vous pouvez faire apparaître le menu contextuel de &knewsticker; en cliquant dessus avec le &BDS; ou en cliquant sur le bouton comportant une flèche et en choisissant l'entrée marquée Préférences dans le menu.

### Configuration générale

#### Options générales

Voici à quoi ressemble l'onglet Général de la boîte de dialogue préférences, lorsqu'elle est ouverte depuis le &centreConfiguration;.
Voici à quoi ressemble l'onglet Général de la boîte de dialogue préférences, lorsqu'elle est ouverte depuis le &centreConfiguration;.

Quelle que soit la manière que vous avez choisie pour accéder à la boîte de dialogue de configuration, nous vous présenterons le premier onglet de la boîte de dialogue préférences, appelé Général. Ici, vous pouvez définir à quelle vitesse le texte doit défiler, à quoi il doit ressembler, ainsi que d'autres options de l'applet. Voici une brève information sur ce que régissent les cases à cocher et les boutons de cet onglet :

Intervalle des requêtes de nouvelles

  Vous pouvez ici définir l'intervalle de temps entre deux requêtes des serveurs de nouvelles pour les titres des nouvelles. Cela dépend généralement de la vitesse à laquelle vous voulez être informé des nouvelles et de la charge que vous voulez placer sur le réseau. :

  - Une valeur faible (moins de 15 minutes) vous permet d'être informé très rapidement des nouvelles si vous le voulez ou le nécessitez. Veuillez noter que cela augmente considérablement la charge du réseau. Toutefois, de tels intervalles courts ne devraient pas être utilisés si vous interrogez des serveurs de nouvelles très populaires (tels que Slashdot ou Freshmeat), puisqu'ils ont généralement déjà de travail en traitant les requêtes entrantes.

  - Une valeur élevée (plus de 45 minutes) ne vous permettra pas d'être informé des nouvelles aussi rapidement. Ceci est recommandé pour des applications pour lesquelles le temps n'est pas critique. L'aspect positif est que seule une toute petite charge est placée sur le réseau ; ceci économise les ressources et les nerfs, pour vous et les administrateurs système des serveur de nouvelles que vous interrogez.

  La valeur par défaut (30 minutes) devrait être appropriée et raisonnable dans la majorité des cas.

Utiliser les noms personnalisés pour les nouveaux sites

  Cochez cette case pour faire en sorte que l'afficheur de nouvelles utilise les noms que vous avez spécifié dans la liste des sources de nouvelles (disponible sur l'onglet appelé Sources de nouvelles) au lieu de ceux reportés par les serveurs de nouvelles eux-mêmes. Ceci peut être pratique pour les serveurs de nouvelles qui reportent un nom très long ou inutile.

Défilement indéfini

  Cochez cette case pour éviter cet arrêt horrible à la fin du défilement (lorsque tous les titres sont apparus une fois). Si le défilement indéfini est activé et que le dernier titre à été affiché, &knewsticker; va attacher le premier titre à la fin du texte qui défile.

Faire défiler seulement les titres les plus récents

  Cochez cette case pour afficher seulement les titres les plus récents de chaque serveur de nouvelles, au lieu d'afficher tous les titres disponibles sur tous les serveurs de nouvelles.

#### Options de défilement

Vitesse de défilement

  Cette glissière vous permet de définir à quelle vitesse le texte doit défiler. Si vous avez relativement peu d'espace dans votre barre des tâches, (et toutefois un afficheur de nouvelles plutôt petit), vous devriez probablement régler cette valeur sur une valeur plus faible, de sorte que vous ayez une chance de lire les titres. Pour les afficheurs de nouvelles plus larges (et les meilleurs yeux), une vitesse de défilement du texte plus importante est probablement plus appropriée pour que vous ayez à attendre le prochain titre le moins longtemps possible.

  Cette valeur détermine le temps au bout duquel le texte doit défiler un petit peu, &cad; que cette valeur n'est pas proportionnelle. Cela signifie que des valeurs plus petites font défiler le texte plus rapidement.

Direction du déplacement

  Ces options vous permettent de définir dans quelle direction le texte doit défiler, &pex; vers le haut, vers la droite, vers le haut ou vers le bas.

Police

  Cliquez sur le bouton à droite intitulé «Choisir la police...» pour choisir la police qui va être utilisée pour le texte qui défile.

  Certaines polices sont plus difficiles à lire que d'autres, plus particulièrement lorsqu'elles sont utilisées pour un texte qui défile. Vous devriez donc choisir une police facilement lisible même lorsqu'elle est en mouvement.

Couleur de l'avant-plan

  Cliquez sur ce bouton pour ouvrir une boîte de dialogue pratique de sélection de couleur qui vous permettra de choisir la couleur utilisée pour l'avant-plan du texte qui défile (&cad; la couleur du texte lui-même).

Couleur du fond

  Cliquez sur ce bouton pour ouvrir une boîte de dialogue pratique de sélection de couleur qui vous permettra de choisir la couleur utilisée pour l'arrière-plan du texte qui défile.

Couleur de surbrillance

  Cliquez sur ce bouton pour ouvrir une boîte de dialogue pratique de sélection de couleur qui vous permettra de choisir la couleur utilisée pour les titres mis en surbrillance (lorsque passez le pointeur de la souris dessus).

Souligner les titres en surbrillance

  Cochez cette case pour que le titre actuellement mis en surbrillance (&cad; le titre qui est actuellement sous le pointeur de la souris) soit souligné.

### Configuration des sources de nouvelles

Voici à quoi peut ressembler l'onglet Sources de nouvelles de la boîte de dialogue de préférences lorsqu'elle est appelée avec l'option Préférences du menu contextuel de &knewsticker;.
Voici à quoi peut ressembler l'onglet Sources de nouvelles de la boîte de dialogue de préférences lorsqu'elle est appelée avec l'option Préférences du menu contextuel de &knewsticker;.

En plus des options disponibles sur l'onglet Général, il y a encore d'autres moyens de personnaliser &knewsticker; de sorte qu'il corresponde à vos besoins, disponibles sur l'onglet Sources des nouvelles. Cette page est composée principalement d'un tableau qui vous permet de ménager et de maintenir la liste des sites de nouvelles que &knewsticker; interroge. Cliquez sur n'importe quelle entrée avec le &BDS; pour ouvrir un menu contextuel vous permettant de supprimer l'entrée actuelle, ou d'ajouter une entrée avec les propriétés de l'entrée sélectionnée.

En bas, vous trouverez aussi deux boutons avec une flèche vers le haut et un autre avec une flèche vers le bas. Ces deux boutons vous permettent de déplacer les entrées vers le haut ou vers le bas, ce qui est pratique si vous voulez définir un ordre spécifique dans lequel &knewsticker; doit charger les nouvelles des sites.

Si l'applet est démarrée, vous pouvez jouer avec ces paramètres maintenant. Cliquez sur Appliquer pour faire en sorte que l'applet utilise les nouveaux paramètres immédiatement. Vous n'avez pas à la redémarrer.

#### Ajout d'un site de nouvelles

Il y a quatre moyens d'ajouter un site de nouvelles à la liste :

- Vous pouvez cliquer sur le bouton en bas intitulé Ajouter.

- Vous pouvez cliquer avec le &BDS; dans le tableau et sélectionner Ajouter une source de nouvelles. Ceci ajoute une nouvelle entrée et ajuste son nom sur Inconnu.

- Vous pouvez cliquer avec le &BDS; sur n'importe quelle entrée de la liste et choisir Ajouter une source de nouvelles pour ajouter une nouvelle entrée ayant les mêmes propriétés que l'entrée sur laquelle vous avez cliqué.

- Vous pouvez glisser-déposer n'importe quel fichier RDF ou RSS depuis une autre application (telle que &konqueror;) sur le tableau. Ceci ajoute une nouvelle entrée à la liste, ajuste son nom sur Inconnu et ajuste le nombre maximum d'articles à 10.

Il y a en fait une autre façon, la cinquième, d'ajouter un site de nouvelles à la liste : vous pouvez cliquer sur n'importe quel fichier RDF ou RSS dans le gestionnaire de fichiers &konqueror; pour qu'il soit immédiatement ajouté à la liste.

#### Modification d'un site de nouvelles existant

Pour modifier une entrée existante dans la liste, vous pouvez utiliser les zones de texte à droite, qui sont dans la boîte intitulée Général. Ils sont normalement désactivés tant que vous n'avez pas sélectionné d'entrée dans la liste. Dès que vous en avez sélectionnée une, les zones de texte sont normalement activées et vous pouvez modifier les propriétés du site de nouvelles sélectionné comme vous le souhaitez :

- Le champ le plus en haut intitulé Nom : vous permet d'éditer le nom du site de nouvelles. Le nom défini ici sera utilisé si l'applet est incapable de se connecter au site de nouvelles, ou si la case à cocher Utiliser les noms personnalisés pour les nouveaux sites (dans l'onglet Général) est cochée.

- Le champ situé en dessous vous permet d'éditer l'URL qui pointe vers le fichier RDF ou RSS qui va être utilisé pour cette entrée. Vous pouvez changer cette chaîne de caractères soit à la main (&cad; en saisissant dans le champ) ou en cliquant sur le petit bouton sur la droite (qui comporte une icône de dossier). Ce bouton ouvre une fenêtre de sélection fichier pratique qui vous permet de parcourir les fichiers pour trouver le fichier désiré.

- En dernière position se trouve un champ pour définir le nombre d'articles que &knewsticker; doit télécharger et conserver depuis le site de nouvelles. La valeur par défaut est de 10 articles, mais il pourrait être raisonnable d'ajuster cette valeur pour certains sites de nouvelles.

Lorsque vous changez le texte ou la valeur de l'un de ces champs, vous pouvez voir le changement prendre effet immédiatement dans la liste.

#### Suppression d'un site de nouvelles

Vous voudrez évidemment un jour supprimer un site de nouvelles de votre liste. Pour cela, vous pouvez soit

- cliquer avec le &BDS; sur l'entrée que vous voulez supprimer et choisir Effacer la source de nouvelles depuis le menu contextuel.

- sélectionner l'entrée que vous voulez supprimer avec le &BGS; et cliquer sur le bouton en bas de la liste intitulé Supprimer.

Dans les deux cas, une boîte de dialogue de confirmation apparaîtra. Assurez-vous de ne pas avoir sélectionné une mauvaise entrée.

## Utilisation de &knewsticker;

L'utilisation de &knewsticker; est assez simple et ne devrait pas vous poser de gros problèmes, en partant du fait que vous avez déjà configuré &knewsticker;. Si vous exécutez &knewsticker; dans le tableau de bord ou dans un mini tableau de bord, il apparaît toujours comme une surface avec un texte en défilement et un bouton avec une petite flèche à côté de celui-ci.

### L'applet

La surface (elle est blanche par défaut, mais vous pouvez changer la couleur d'arrière-plan facilement en utilisant la boîte de dialogue de préférences) avec le texte en défilement est appelée afficheur de nouvelles. Il fait défiler les titres téléchargés en continu (ou uniquement les titres les plus récents) et vous donne un accès facile aux articles. Si vous voyez un article intéressant, cliquez simplement dessus pour ouvrir le navigateur Web &konqueror;, affichant l'article complet appartenant au titre sur lequel vous avez cliqué. Si vous sentez qu'un titre potentiellement intéressant vient juste de défiler hors de votre vue, vous disposez de plusieurs moyens d'influencer le défilement :

- Vous pouvez cliquer sur l'afficheur de nouvelles avec le &BGS; et déplacer la souris (tout en gardant le &BGS; appuyé). L'afficheur de nouvelles retrouvera son défilement habituel une fois que vous relâcherez le &BGS;.

- Si vous avez une souris appelée souris à molette, vous pouvez utiliser la molette de votre souris pour faire défiler les titres vers l'avant ou l'arrière.

Il existe aussi un menu contextuel très puissant, auquel vous pouvez accéder soit en cliquant avec le &BDS; sur l'afficheur de nouvelles, ou en cliquant sur le bouton comportant une flèche avec le &BGS;. Ce menu contextuel est la partie la plus intéressante de l'applet, parce qu'il contient à peu près toutes les fonctionnalités.

### Le menu contextuel

Voici à quoi ressemble le menu contextuel de &knewsticker;, si vous utilisez uniquement les sites de nouvelles par défaut.
Voici à quoi ressemble le menu contextuel de &knewsticker;, si vous utilisez uniquement les sites de nouvelles par défaut.

Le menu contextuel est principalement scindé en deux parties :

La partie supérieure montre la liste des entrées, chaque entrée ayant une icône telle que celle-ci à côté d'elle. Cette liste représente la liste des sites de nouvelles actuellement configurés. Vous pouvez cliquer sur n'importe quelle source de nouvelles pour ouvrir un autre menu qui contient une liste des titres disponibles pour ce site de nouvelles en particulier ainsi qu'une entrée intitulée Vérifier les nouvelles pour rafraîchir la liste des titres pour ce site de nouvelles. Chacun des titres a une icône à côté de lui indiquant que vous avez déjà lu cet article ou l'icône si vous ne l'avez pas encore lu.

La partie inférieure montre actuellement quatre entrées (expliquées de haut en bas) :

Vérifier les nouvelles

  Cette entrée comporte une petite à côté d'elle. Si vous voulez forcer &knewsticker; à vérifier si les sites de nouvelles configurés ont des nouveaux articles, vous pouvez cliquer ici.

  Ceci ne réinitialise pas le chronomètre interne qui interroge les sites de nouvelles automatiquement en suivant un intervalle pour savoir s'il existe de nouveaux articles.

Mode hors ligne

  Cette entrée de menu n'a pas d'icône associée. Cliquez sur cette entrée pour activer un mode hors ligne spécial, qui met le chronomètre de vérification de nouvelles en pause et empêche le téléchargement automatique de nouveaux titres. Le mode déconnexion devient pratique si vous devez laisser votre ordinateur un moment pendant lequel votre système n'est pas connecté à l'Internet, parce qu'il vous épargne tous les messages d'erreur qui apparaissent lorsque l'ordinateur ne peut pas se connecter à l'un des sites de nouvelles.

  Vous pouvez forcer un rechargement pour un seul site de nouvelles aussi bien que pour tous les sites de nouvelles en sélectionnant l'entrée Vérifier les nouvelles respective.

Aide

  Cette entrée est marquée par un petit . Le fait de cliquer sur cette entrée ouvrira la documentation de &knewsticker; (que vous êtes en train de lire en ce moment) qui détaille toutes les fonctions et capacités de &knewsticker;.

À propos

  Cette entrée est, elle aussi, marquée par un petit . La sélectionner ouvre une petite boîte de dialogue qui liste les collaborateurs à &knewsticker; ainsi que le copyright et la licence.

Préférences

  Cette entrée est facilement reconnaissable grâce à l'icône à côté d'elle. Sélectionnez cette entrée pour ouvrir la boîte de dialogue de préférences qui vous permet de personnaliser toutes les propriétés de &knewsticker;.

## Questions fréquemment posées

&reporting.bugs;

Où puis-je trouver un fichier RDF pour un site de nouvelles XY :

Il est possible que le site de nouvelles auquel vous vous référerez ne fournisse aucun fichier RDF ou RSS ! Vous pouvez vous rendre à http://www.webreference.com/services/news pour trouver une liste plus ou moins complète de sites proposant un fichier RDF ou RSS. Une autre merveilleuse source de fichiers RDF est http://www.xmltree.com, où vous pouvez trouver des centaines de fichiers RDF et RSS, triés par langue et/ou par sujet.

Si vous trouvez des sites de nouvelles intéressants fournissant de tels fichiers, n'hésitez pas à les envoyer à Frerich Raabe raabe@kde.org de sorte qu'ils puissent êtres inclus dans les prochaines versions. Merci !

## Remerciements et licence

&knewsticker;

Programme copyright 2000, 2001 par Frerich Raabe raabe@kde.org

Collaborateurs :

- Malte Starostik malte.starostik@t-online.de

- Wilco Greven greven@linux.org

Documentation copyright 2001 par Frerich Raabe raabe@kde.org

&underFDL; &underBSDLicense;

## Glossaire

Ce chapitre est prévu pour expliquer les différents acronymes qui ont été utilisés tout au long de la documentation de &knewsticker;. Si vous sentez que certains acronymes ou termes sont absents, n'hésitez pas à envoyer un courrier électronique à Frerich Raabe raabe@kde.org de sorte qu'ils puissent être ajoutés. Merci.

RDF

  Resource Description Framework. Un langage dérivé du XML qui décrit les métadonnées. Souvent utilisé pour les articles et autres publications. Pour des informations plus détaillées sur les fichiers RDF, vous pouvez consulter la section brève information à propos des fichiers RDF, ou vous rendre directement à la page officielle du format RDF sur le site du World Wide Web Consortium.

RSS

  Le sommaire de site RDF ("RDF Site Summary") est actuellement une extension du langage RDF. D'après la spécification officielle RSS v1.0 :

  RDF Site Summary (RSS) est un format de description et de publication de métadonnées léger, extensible et multiutilisations. Le RSS est une application du XML, conforme à la Spécification RDF du W3C et est extensible par espace de nom XML et/ou modularisation fondée sur le RDF.

XML

  Le langage balisé extensible (eXtensible Markup Language) est le format universel pour les documents et données structurés sur le Web. C'est un dérivé du SGML adapté aux besoins du Web. Vous pouvez vous rendre à la page du Extensible Markup Language sur le site Internet du World Wide Web Consortium pour plus d'informations.

W3C

  Une abréviation pour World Wide Web Consortium. D'après la page officielle du W3C, Le World Wide Web Consortium (W3C) développe des technologies interopérables (spécifications, directives, logiciels, et outils) pour pousser le Web à son potentiel maximum comme forum pour le commerce, la communication, et le savoir collectif.

&URL;

  &URL; signifie Uniform Resource Locator, une chaîne de caractères d'un format spécial pouvant référencer des ressources telles des images, des documents et d'autres choses sur Internet. Veuillez vous référer à la page Web s'y rapportant pour des informations plus détaillées à ce sujet.

DCOP

  Le protocole de communication de bureau («Desktop COmmunication Protocol») est une façon pour les applications de communiquer entre elles. Par exemple, la boîte de dialogue de configuration de &knewsticker; utilise DCOP pour indiquer à l'applet elle-même la configuration courante. Pour des informations plus détaillées à propos de DCOP, vous pouvez vous rendre à http://developer.kde.org/documentation/library/2.0-api/dcop/HOWTO.html pour une explication complète du DCOP.

## Installation

### Comment obtenir &knewsticker;

&install.intro.documentation;

### Programmes requis

Si vous voulez installer &knewsticker;, vous aurez besoin d'au moins une installation de &kde; 2.1.

Si vous avez l'intention de compiler et installer &knewsticker; vous-même, vous devrez vous assurer que les programmes suivants sont présents sur votre système :

- g++ 2.8 / egcs 1.0.3 (ou compatible)

- GNU make

- autoconf 2.1

- automake 1.4

- Qt 2.2.x

- KDE 2.1

### Compilation et installation

&knewsticker; fait partie du paquetage kdenetwork de &kde; 2.1 et est installé en même temps que celui-ci. En général, il n'y a aucun besoin pour l'utilisateur de compiler le code source de &knewsticker; à la main. Si vous avez toutefois l'intention de procéder ainsi ou que vous n'avez que le code source disponible, la compilation et l'installation se font, comme d'habitude sous &Linux;, en saisissant :

&install.compile.documentation;

## Informations pour les développeurs et les utilisateurs avancés

&knewsticker; n'est muni que d'une interface DCOP relativement limitée mais en constante augmentation. Elle n'est pas seulement utilisée pour communiquer avec d'autres applications, mais il est aussi bien possible de contrôler &knewsticker; à l'aide d'un script shell. Plus l'interface est étendue, plus elle deviendra pratique et plus &knewsticker; sera flexible et contrôlable depuis un script.

Pour utiliser les fonctions DCOP, vous pouvez soit utiliser l'application en ligne de commandes dcop, ou utiliser l'application plus conviviale KDCOP. Les deux applications fournissent les mêmes fonctionnalitées, le programme que vous préférerez est donc uniquement une question de goût. :-)

Ce chapitre part du principe que vous utilisez le programme en ligne de commandes dcop. Pour accéder aux fonctions DCOP de &knewsticker;, assurez-vous que &knewsticker; est lancé et saisissez quelque chose comme cela dans la console :

    % dcop knewsticker KNewsTicker [fonction]

Si un message d'erreur apparaît disant que `dcop` est introuvable, veuillez vérifier que le fichier `dcop` existe dans `$KDEDIR/bin` et assurez-vous que ses permissions ont correctement configurées.

Dans cette ligne de commande, remplacez simplement [fonction] par le nom de la fonction, &pex; saisissez

    % dcop knewsticker KNewsTicker updateNews

pour faire en sorte que &knewsticker; vérifie s'il y a des nouveaux articles et les télécharge si nécessaire.

### Référence DCOP

Voici (pour finir) une liste complète de toutes les fonctions DCOP que &knewsticker; fournit :

`updateNews`

  Cette fonction force &knewsticker; à mettre à jour sa liste d'articles interne (&cad; qu'il interroge les serveurs de nouvelles configurés dans sa liste et télécharge les nouveaux articles si nécessaire).

  Ceci fonctionne également si &knewsticker; est en mode hors ligne.

  Exemple :

      % dcop knewsticker KNewsTicker updateNews

`reparseConfig`

  La commande `reparseConfig` fait en sorte que &knewsticker; recharge sa configuration depuis le fichier de configuration. Cette fonction est utilisée par la boîte de dialogue de configuration pour demander communiquer avec &knewsticker;, mais vous pouvez l'utiliser au cas où vous auriez modifié le fichier de configuration à la main.

  Le fichier de configuration est enregistré dans `~/.kde/share/config/knewstickerrc`

  Exemple :

      % dcop knewsticker KNewsTicker reparseConfig

`setOfflineMode [bool]`

  Vous pouvez appeler cette fonction pour définir si &knewsticker; est actuellement en mode hors ligne ou non (&cad; si &knewsticker; doit interroger les sites de nouvelles configurés pour de nouveaux articles.

  Exemple :

      % dcop knewsticker KNewsTicker setOfflineMode true

  pour activer le mode hors ligne, ou saisissez

      % dcop knewsticker KNewsTicker setOfflineMode false

  pour désactiver le mode hors ligne.

&documentation.index;