GNU wget

[dessin de la tête d'un GNU] [ Anglais Français ]

Table des matières


Introduction à GNU wget

GNU Wget est un logiciel libre pour récupérer des fichiers via HTTP, HTTPS et FTP, les deux protocoles les plus utilisées sur Internet. C'est un outil en ligne de commande non iteractive, qui peut donc être facilement appelé par des scripts, des tâches cron, des terminaux sans support X, etc.

Wget a de nombreuses fonctionnalités pour télécharger de gros fichiers ou effectuer un mirror complet d'un site web ou FTP facilement, incluant:

Nouvelles

La dernière version stable de Wget est la 1.9. Cette révision fixe plusieurs bogues de la série 1.8 et ajoute de nouvelles fonctionnalités.

Télécharger GNU wget

Le point principal de distribution pour Wget est l'archive des logiciels GNU. Veuillez choisir le site mirroir le plus proche de chez vous. Le répertoire principal est ftp://ftp.gnu.org/pub/gnu/wget/.

Les binaires Microsoft Windows sont disponibles sur le serveur FTP SunSITE ici ftp://sunsite.dk/projects/wget/windows/ ou là http://space.tin.it/computer/hherold/. Ceux-ci ont été gentillement fournis par Heiko Herold. Un exécutable MS-DOS conçu pour être utilisé tout seul sous DOS (incluant une couche réseau) a été réalisé par Doug Kaufman. Cela est disponible à http://www.rahul.net/dkaufman/. Antinode.org offre un port VMS de Wget.

Les dernières sources du développement pour Wget sont toujours disponible via CVS anonyme. Les versions des sources et binaires patchés pour la compilation dans l'environnment MS Windows sont fournis par Heiko Herold aussi et disponible aux urls mentionnées ci-dessus.

Documentation

A cette heure, la documentation pour Wget 1.5.3 est disponible dans tous les formats communs de www.gnu.org. Espérons que cela sera bientôt mis à jour pour utiliser la documentation de Wget 1.8.

La documentation pour Wget 1.5.2 au format d'aide de Windows est disponible sur le serveur FTP SunSITE Denmark avec une copie du makeinfo pour Win32, qui peut être utilisé pour construire le fichier d'aide de Windows.

Listes de diffusion

La liste de diffusion Wget est gentillement hébergé par SunSITE Danemark grâce à Karsten Thygesen. Ils utilisent le serveur de listes ezmlm. Pour s'inscrire à celles-ci, veuillez envoyer un email à nom_de_la_liste-subscribe@sunsite.dk. Par exemple, pour s'inscrire à la liste wget-patches, veuillez envoyer un mail à:

wget-patches-subscribe@sunsite.dk

Pour poster sur une liste, envoyer votre mail nom_de_la_liste@sunsite.dk. Les listes sont ouvertes (droit de poster) aussi aux non-inscrits. Si vous envoyez une lettre à la liste et que vous n'êtes pas inscris, veuillez inclure une note signifiant que vous voulez être mis en cc pour les retours. Sinon les autres utilisateurs supposeront que vous êtes inscris et supprimeront votre adresse lors du retour afin d'éviter de vous l'envoyer en double.

Pour récupérer certaines lettres, veuillez envoyer un email à nom_de_la_liste-getpremier_dernier@sunsite.dk. Le serveur de mail limite le nombre de lettres retournées à 100, donc demander plus ne retournera que les lettres dans l'intervalle premier - premier+99. Par exemple, envoyer un email à l'adresse suivante retournera les lettres de 3500 de 3517:

wget-get.3500_3517@sunsite.dk

Pour se désinscrire de la liste, envoyez un email à nom_de_la_liste-unsubscribe@sunsite.dk. Pour plus d'informations sur les commandes de la liste, envoyez un email à nom_de_la_liste-help@sunsite.dk.

Les listes de diffusion suivantes relatives à Wget sont sur SunSITE:

wget
C'est la liste de discussion principale pour Wget. Actuellement l'adresse pour les rapports de bug Wget, bug-wget@gnu.org, renvoie simplement à cette liste.

En plus des commandes de ezmlm décrites ci-dessus pour récupérer les anciennes lettres, il y a les archives de la liste principale Wget à:

La liste Wget est bidirectionnellement synchronisé à sunsite.wget, un forum de nouvelles local sur sunsite.dk.

wget-patches
Si vous soumettez un patch pour Wget pour corriger un bogue ou ajouter une fonctionnalité, veuillez l'envoyer à cette liste. Pour plus d'informations, veuillez lire la section Développement de Wget.
wget-cvs
Les lettres à cette liste sont générés automatiquement. Chaque fois qu'un développeur valide des sources dans CVS, un email est envoyé à la liste avec le nom des fichiers, les versions et le commentaire écrit. Les personnes trés intéressées dans le développement de Wget peuvent trouver tous les détails en s'inscrivant à cette liste.
wget-website-cvs
C'est pareil que la liste wget-cvs, mais pour le module CVS wget-website au lieu du module wget.

Ajouts

Plusieurs personnes ont contribuées à Wget et maintiennent une page oueb sur celui-ci:

Interfaces

Autres logiciels

Articles

Développement

Si vous voulez juste, naviguer dans les sources CVS, vous pouvez utilisez l'interface cvsweb. C'est commode pour visionner l'historique des fichiers "commités" (engagés), une version particulière du fichier et les différences entre une version et une autre.

Si vous voulez aider au développement de Wget, assurez-vous de vous inscrire à la liste de diffusion Wget. C'est généralement mieux d'utiliser les dernières sources du CVS comme base pour votre développement, plutôt que la dernière version stable. Pour récupérer les dernières sources:

  1. Si vous ne l'avez pas déjà, récupérer le logiciel CVS.
  2. Créer un répertoire où résidera votre copie CVS que nous appelerons CVS. Changer de répertoire:
    %  cd CVS
  3. Se logguer sur le serveur CVS:
    %  cvs -d :pserver:cvs@sunsite.dk:/pack/anoncvs login
    CVS password:  cvs
  4. Télécharger une copie des sources:
    %  cvs -d :pserver:cvs@sunsite.dk:/pack/anoncvs checkout wget

    Dans le cas inhabituel où le développement de Wget a été séparé en plusieurs branches pour permettre de sortir un pré-version bloquée sur les focntionnalités pendant que le développement continue dans la branche principale, vous pouvez télécharger la branche séparée en utilisant le paramètre -r pour les commandes checkout ou update. Par exemple, vous pouvez télécharger la branche qui a été coupée anticipant la version 1.6 avec:
    %  cvs -d :pserver:cvs@sunsite.dk:/pack/anoncvs checkout -r release-1_6 wget

Pour réduire la bande passante et des mises à jour inutiles, l'arbre CVS ne contient pas de fichiers générés automatiquement, même lorsque ceux-ci sont normalement présents dans la distribution tar.

Pour constuire Wget à partir des sources CVS, vous avez besoin d'avoir les logiciels GNU suivants (autoconf, gettext et texinfo) installés sur votre système pour générer automatiquement le fichier .configure.

Pour ceux qui ne savent pas quoi faire une fois que les sources CVS ont été récupéres, considérant que configure et Makefile n'existe pas encore à ce moment, un fichier nommé Makefile.cvs est fourni et peut-être utilisé comme suit make -f Makefile.cvs. Actuellement ce makefile appelle juste autoconf, aprés lequel vous êtes prêt pour compiler Wget à la mode habituelle avec configure and make.

Pour résumer, aprés avoir télécharger les sources CVS comme au-dessus, vous devez procéder comme ceci:

  1. Changer de répertoire pour se placer à la racine du projet Wget:
    %  cd wget
  2. Générer certains fichiers automatiquement qui sont requis pour la configuration du produit:
    %  make -f Makefile.cvs
  3. Configurer le logiciel et le compiler
    %  ./configure [some_parameters]
    %  make
  4. Hacker, compiler, tester, hacker, compiler, tester...

Correctifs

Les patchs pour Wget doivent être mailés à wget-patches@sunsite.dk. Chaque patch sera vérifié par les développeurs puis validés et enfin ajouter à la distribution ou bien rejeté avec une explication.

Pour augmenter les chances que votre patch soit accepté, veuillez vérifier qu'il s'applique correctement aux dernières sources CVS. Pour mettre à jour à la dernière version:

  1. Aller dans le répertoire où réside votre version CVS de Wget:
    %  cd CVS/wget
  2. Demander à CVS de mettre à jour les sources
    %  cvs update -d

Si vous avez changer des fichiers de votre arbre de sources, la mise à jour ne les écrasera pas, donc vous devriez déplacer ou renommer les fichiers modifés pendant icelle, ou récupérer une copie séparée de l'abre de sources.

Il y a deux méthodes pour écrire un patch (le répertoire courant est toujours CVS/wget):

  1. Sauvegarder votre fichier originel file.c comme file.c.orig et générer le patch en utlisant les options "unified diff" ou "context diff" du programme diff (utiliser l'option ordinaire de différence sans contexte est notoirement reconnu comme source d'erreur, car les numéros de lignes tendent à changer lorsque les autres font des changements dans le même fichier source). Créer le patch à la racine du projet Wget (CVS/wget dans cet exemple) de la façon suivante:
    %  diff -u path/to/file.c.orig path/to/file.c > file.patch
    ou, si votre diff ne supporte pas l'option -u,
    %  diff -c path/to/file.c.orig path/to/file.c > file.patch
  2. Une autre méthode, généralement plus facile est d'utiliser la commande diff de CVS:
    %  cvs diff -u > name.patch
    et si cela ne marche pas:
    %  cvs diff -c > name.patch

Si votre programme de mail ou le proxy est enclin à altérer les patchs, cad en modifiant les fin de lignes, envoyez-les en pièce attachée. Sinon, les patchs simplement insérés dans un email sont bons.

Chaque patch devrait être accompagné par une mise à jour dans le fichier ChangeLog approprié, mais veuillez ne pas l'envoyer par mail à ChangeLog lui-même car ils ont un fort taux d'erreur. Envoyez-nous juste la nouvelle partie que vous avez ajouté dans le ChangeLog. Les recommendations pour écrire les entrées dans le ChangeLog sont définis par GNU coding standards.

Si vous ajoutez ou modifiez des fonctionnalités, veuillez aussi fournir les différences du fichier de documentation wget.texi. Finalement, tout changement significatif visible par l'utilisateur final doit être mentionné dans le haut du fichier NEWS.

Si vous êtes intéressé, vous trouverez ici une description plus détaillée sur le processus de modification de Wget:

  1. Tous les changements sémantiques visibles dans les sources vont vers la liste des patchs, incluant les changements écrits par les développeurs de Wget avec les accés en écriture sur le référentiel CVS. Toutes les personnes intéressées peuvent s'inscrire à la liste de diffusion des patchs wget-patches-subscribe@sunsite.dk, et sont invitées à commenter les patchs. Cependant les discussions générales sur l'implémentation de Wget doivent être dirigées vers la liste principale de Wget (wget@sunsite.dk).
  2. Tous les fervents développeurs ont un accés CVS en écriture et peuvent appliqués des patchs dés qu'ils les postent sur la liste patch. Si d'autres développeurs sont en profond désaccord avec ce patch, il peut être retiré ultérieurement.
  3. Les contributeurs extérieur enverront simplement les patchs à la liste de diffusion des patchs. Une fois la-bàs, le patch doit être approuvé par au moins une personne avant d'être appliqué dans le CVS. La personne qui applique le patch ne doit pas être la même personne que celle qui l'approuve.

Les personnes qui veulent avoir l'évolution des commits CVS au fur et à mesure, peuvent s'inscrire à la liste de diffusion wget-cvs.

Traduction

Si vous pouvez fournir des traductions du fichier de messages pour un autre langage que l'anglais, veuillez consulter la TranslationProject page for Wget où est coordoné de tels efforts.

Module CVS pour le site oueb de Wget ("wget-website")

Pour faciliter la maintenance du site oueb de Wget, un module CVS lui est dédié, avec un accés en écriture pour les mêmes personnes qui ont un tel accés sur le projet principal. Le module CVS est nommé, sans surprise, wget-website. Comme pour le module principal wget, il y a une interface cvsweb pour le module wget-website.

Pour les personnes qui n'ont pas d'accés en écriture sur le CVS et veulent envoyer des changements sur le site oueb, doivent envoyer leur patch à wget-patches@sunsite.dk, comme pour les modifications sur le module principal.

[ Anglais Français ]

Retourner à la page principale GNU.

Veuillez envoyer vos requêtes et questions concernant FSF & GNU à gnu@gnu.org. Il y a aussi d'autres moyens de contacter la FSF.

Veuillez envoyer vos commentaires sur ces pages oueb à webmasters@gnu.org, envoyer les autres questions à gnu@gnu.org.

Copyright (C) 2001 Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA

La reproduction exacte et la distribution intégrale de cet article est permise sur n'importe quel support d'archivage, pourvu que cette notice soit préservée.

Mis à jour: $Id: wget-fr.html,v 1.5 2003/11/05 15:29:16 rsaliou Exp $