<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY klinkstatus "<application
>KLinkStatus</application
>">
  <!ENTITY kappname "&klinkstatus;"
><!-- Do *not* replace kappname-->
  <!ENTITY package "kdewebdev"
><!-- kdebase, kdeadmin, etc -->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % French "INCLUDE"
><!-- change language only here -->
]>

<book id="klinkstatus" lang="&language;">

<bookinfo>
<title
>Manuel de &klinkstatus;</title>

<authorgroup>
<author
><firstname
></firstname
> <othername
></othername
> <surname
>Paulo Moura Guedes</surname
> <affiliation
> <address
><email
>moura&#64;kdewebdev&#46;org</email
></address>
</affiliation>
</author>

&traducteurJulienMorot;&traducteurLudovicGrossard; 
</authorgroup>

<copyright>
<year
>2004</year>

<holder
>Paulo Moura Guedes</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>22/08/2011</date>
<releaseinfo
>0.7.0 (&kde; 4.7)</releaseinfo>

<abstract>
<para
>&klinkstatus; est un vérificateur de liens pour &kde;. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KLinkStatus</keyword>
<keyword
>vérificateur de liens</keyword>
<keyword
>validation</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introduction</title>

<para
>&klinkstatus; est un vérificateur de liens pour &kde;. Il vous permet de rechercher les liens internes et externes de tout votre site ou d'une simple page et de choisir la profondeur de recherche. Vous pouvez également vérifier des fichiers locaux, ftp, fish, &etc; car &klinkstatus; utilise KIO. Pour une meilleure rapidité, les liens peuvent être vérifiés en parallèle. </para>
<para
>Les possibilités de l'application peuvent être étendues avec le <ulink url="http://techbase.kde.org/Development/Tutorials/Kross/Introduction"
>scriptage Kross</ulink
>. </para>
</chapter>

<chapter id="using-klinkstatus">
<title
>Utilisation de &klinkstatus;</title>

<para
>Pour vérifier les liens sur un site web ou sur un fichier local, saisissez son adresse dans le champ <guilabel
>URL : </guilabel
> puis appuyez sur &Entree;. Vous pouvez également utiliser l'icône sur la droite représentant un dossier, pour naviguer vers l'adresse voulue en utilisant une interface graphique. </para>
<screenshot>
<screeninfo
>Voici une capture d'écran de &klinkstatus;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Capture d'écran</phrase>
	  </textobject>
	  <caption>
	    <para
>&klinkstatus; vérifie les liens sur le site web de KDevelop. Les liens brisés ou mal formés sont marqués en rouge. </para>
	  </caption>
	</mediaobject>
</screenshot>
<para
>Si l'accès aux données inspectées est restreint, vérifiez l'option <guilabel
>Identifiant</guilabel
>. Après avoir appuyé sur &Entree; dans le champ &URL; ou appuyé sur le bouton <guibutton
>Démarrer la recherche</guibutton
> dans la barre d'outils, la boîte de dialogue suivante sera affichée pour y saisir les paramètres de connexion. </para>
<screenshot>
<screeninfo
>Fenêtre d'authentification de &klinkstatus;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="login-dialog.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Fenêtre d'authentification de &klinkstatus;</phrase>
	  </textobject>
	  <caption>
	    <para
>&klinkstatus; vous demande de saisir vos paramètres de connexion. </para>
	  </caption>
	</mediaobject>
</screenshot>
<para
>Saisissez les paramètres de connexion et appuyez sur le bouton <guibutton
>Ok</guibutton
>. </para>
<para
>Vous pouvez restreindre l'étendue des liens à vérifier en décochant <guilabel
>Vérifier les liens externes</guilabel
> (si les liens externes ne doivent pas être vérifiés), ou saisir une expression rationnelle dans le champ <guilabel
>Ne pas vérifier les expressions rationnelles</guilabel
>. </para>
<para
>Les résultats de la recherche peuvent être filtrés en utilisant le champ <guilabel
>Recherche</guilabel
> ou la liste déroulante <guilabel
>État : </guilabel
> (<guimenuitem
>Tous les liens</guimenuitem
>, <guimenuitem
>Liens corrects</guimenuitem
>, <guimenuitem
>Liens cassés</guimenuitem
>, <guimenuitem
>Liens mal formés</guimenuitem
>, ou <guimenuitem
>Liens indéterminés</guimenuitem
>). </para>
<para
>Depuis le menu contextuel de chacun des éléments du résultat de la recherche, vous pouvez effectuer une <guimenuitem
>nouvelle vérification</guimenuitem
>, <guisubmenu
>éditer la page référente</guisubmenu
> dans l'éditeur par défaut, <guimenuitem
>ouvrir l'URL</guimenuitem
>, <guimenuitem
>ouvrir l'URL référente</guimenuitem
>, <guimenuitem
>copier l'URL</guimenuitem
>, <guimenuitem
>copier l'URL référente</guimenuitem
>, ou <guimenuitem
>copier le texte de la cellule</guimenuitem
>. </para>
<para
>Les résultats de vérification peuvent être enregistrés en une carte du site &XML; en utilisant l'élément de menu <menuchoice
><guimenu
>Fichier</guimenu
><guimenuitem
>Créer une carte du site...</guimenuitem
></menuchoice
>, ou exporté en &HTML; en utilisant <menuchoice
><guimenu
>Fichier</guimenu
><guisubmenu
>Exporter les résultats en HTML</guisubmenu
></menuchoice
>. Vous pouvez choisir d'exporter <guimenuitem
>Tout</guimenuitem
> ou juste les liens <guimenuitem
>cassés</guimenuitem
>. Il existe également une option <guimenuitem
>Télécharger de nouvelles feuilles de style</guimenuitem
> pour utiliser des feuilles de style du dépôt « obtenir les nouveautés ». </para>
<!--kde.org
Support several protocols (allowing fast checking of local documents): http, ftp, ssh (fish or sftp) and file.
Proxy support
Allows authentication when checking restricted documents
Limit the search depth
Pause/Resume of checking session
History of checked URLs
Kross Scripting
  -->
</chapter>
<!--
  How does scheduling auto link check work?
  starting klinkstatus via user crontab? apparently not!
  via a kded service?
  needs a running klinkstatus instance?
  is this unfinished work?

<chapter id="auto-check">
<title
>Automatic Site Checking</title>

<para>
  Using <menuchoice
><guimenu
>Tools</guimenu
><guimenuitem
>Schedule Link Checks...</guimenuitem
></menuchoice>
  opens the <guilabel
>Configure Site Check Automation</guilabel
> dialog.

  Here you can add, remove and edit sessions.
  Scheduling Weekly (how to set day?), Daily, Hourly

</para>

</chapter>
-->

<chapter id="config">
  <title
>Configuration de &klinkstatus;</title>
  <para
>Vous pouvez accéder aux options de configuration de &klinkstatus; en ouvrant la boîte de dialogue de configuration en choisissant <menuchoice
><guimenu
>Configuration</guimenu
><guimenuitem
>Configurer &klinkstatus;...</guimenuitem
> </menuchoice
> depuis le menu.</para>
    <screenshot>
      <screeninfo
>Boîte de dialogue de configuration de &klinkstatus;</screeninfo>
      <mediaobject>
	<imageobject>
	  <imagedata fileref="check-settings.png" format="PNG"/>
	</imageobject>
	<textobject>
	  <phrase
>vérification</phrase>
	</textobject>
      </mediaobject>
    </screenshot>
  <para
>Dans la page <guilabel
>Vérification</guilabel
>, vous pouvez modifier les paramètres de vérification par défaut. Cette page est divisée en trois panneaux (<guilabel
>Réseau</guilabel
>, <guilabel
>Limitations</guilabel
>, et <guilabel
>Quanta</guilabel
>) ainsi que la case à cocher <guilabel
>Mémoriser la configuration lors de la fermeture</guilabel
>. Si cette dernière est cochée, &klinkstatus; se souviendra de la configuration lorsque vous quittez &klinkstatus;, et les restaurera la prochaine fois que vous lancerez l'application. </para>
  <para
>Le panneau <guilabel
>Réseau</guilabel
> peut être utilisé pour choisir le <guilabel
>nombre de connexions simultanées</guilabel
> et le <guilabel
>délai d'expiration en secondes</guilabel
>. </para>
  <para
>Vous pouvez modifier le <guilabel
>nombre d'&URL; dans l'historique</guilabel
> (la valeur par défaut est 50) et la <guilabel
>profondeur</guilabel
> de la vérification (peut être écrasé par le réglage dans la fenêtre principale de &klinkstatus;, 0 pour <guilabel
>illimité</guilabel
>). Vous pouvez également choisir si &klinkstatus; doit <guilabel
>vérifier les dossiers parents</guilabel
> et <guilabel
>vérifier les liens externes</guilabel
> (peut être écrasé par le réglage dans la fenêtre principale de &klinkstatus;). </para>
  <para
>Le panneau <guilabel
>Quanta</guilabel
> est utilisé pour contrôler l'intégration de &klinkstatus; à &quantaplus;. Cochez <guilabel
>Utiliser le préfixe d'aperçu</guilabel
> si vous souhaitez utiliser le préfixe d'aperçu de &quantaplus; dans l'&URL; à vérifier. </para>
  <screenshot>
    <screeninfo
>Boîte de dialogue de configuration de &klinkstatus;</screeninfo>
    <mediaobject>
      <imageobject>
	<imagedata fileref="results-settings.png" format="PNG"/>
      </imageobject>
      <textobject>
	<phrase
>Résultats</phrase>
      </textobject>
    </mediaobject>
  </screenshot>
  <para
>Dans la page <guilabel
>Résultats</guilabel
>, vous pouvez choisir le format de la liste des résultats. <guilabel
>Arborescence</guilabel
> est la vue arborescente par défaut et <guilabel
>À plat</guilabel
> est la liste à plat (peut être plus rapide sur des machines bas de gamme). Vous pouvez également laisser &klinkstatus; <guilabel
>suivre le dernier lien vérifié</guilabel
> et définir la <guilabel
>feuille de style préférée</guilabel
> pour la liste de vérification. De nouvelles feuilles de styles peuvent être téléchargées depuis le dépôt « obtenir les nouveautés » en utilisant l'élément de menu <menuchoice
><guimenu
>Fichier</guimenu
><guisubmenu
>Exporter les résultats en HTML</guisubmenu
><guimenuitem
>Télécharger de nouvelles feuilles de style</guimenuitem
></menuchoice
>. </para>
  <screenshot>
    <screeninfo
>Boîte de dialogue de configuration de &klinkstatus;</screeninfo>
    <mediaobject>
      <imageobject>
	<imagedata fileref="identification-settings.png" format="PNG"/>
      </imageobject>
      <textobject>
	<phrase
>Identification</phrase>
      </textobject>
    </mediaobject>
  </screenshot>
  <para
>En utilisant la page <guilabel
>Identification</guilabel
>, vous pouvez configurer la façon dont &klinkstatus; se signale au serveur qui héberge la page vérifiée. Vous pouvez choisir d'<guilabel
>envoyer l'identification</guilabel
>. Utilisez le bouton <guibutton
>Par défaut</guibutton
> pour choisir l'identification par défaut à &konqueror;. Le panneau <guilabel
>Identité</guilabel
> peut être utilisé pour choisir votre identité pour l'authentification sur le serveur. </para>
  <screenshot>
    <screeninfo
>Boîte de dialogue de configuration de &klinkstatus;</screeninfo>
    <mediaobject>
      <imageobject>
	<imagedata fileref="mail-transport-settings.png" format="PNG"/>
      </imageobject>
      <textobject>
	<phrase
>Transport de courrier électronique</phrase>
      </textobject>
    </mediaobject>
  </screenshot>
  <para
>En utilisant la page <guilabel
>Transport de courrier électronique</guilabel
>, vous pouvez configurer un compte de messagerie qui recevra les résultats de vérifications planifiés de &klinkstatus;. </para>
</chapter>

<chapter id="credits">

<title
>Remerciements et licence</title>

<para
>&klinkstatus; </para>
<para
>Programme sous Copyright 2004 Paulo Moura Guedes <email
>pmg&#64;netcabo&#46;pt</email
> </para>
<para
>Documentation sous Copyright 2004 Paulo Moura Guedes <email
>pmg&#64;netcabo&#46;pt</email
> </para>

<para
>Traduction française par &JulienMorot; et &LudovicGrossard;.</para
> 
&underFDL; &underGPL; </chapter>

<chapter id="installation">
  
<title
>Compilation et installation</title>
&install.intro.documentation; &install.compile.documentation; </chapter>

&documentation.index;
</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=2:shiftwidth=2:expandtab
-->

