[i18n-FR] Translated some files to french #1897

.github/workflows/build_documentation.yaml

@@ -13,6 +13,6 @@ jobs:
     with:
       commit_sha: ${{ github.sha }}
       package: huggingface_hub
-      languages: en de hi ko
+      languages: en de hi ko fr
     secrets:
       hf_token: ${{ secrets.HF_DOC_BUILD_PUSH }}

.github/workflows/build_pr_documentation.yaml

@@ -14,4 +14,4 @@ jobs:
       commit_sha: ${{ github.event.pull_request.head.sha }}
       pr_number: ${{ github.event.number }}
       package: huggingface_hub
-      languages: en de hi ko
+      languages: en de hi ko fr

docs/source/en/guides/download.md

@@ -191,7 +191,7 @@ If you are running on a machine with high bandwidth, you can increase your downl
 
 <Tip>
 
-Progress bars are supported in `hf_transfer` starting from version `0.1.4`. Consider upgrading (`pip install -U hf-transfer`) if you plan to enable faster downloads.
+Progress bars are supported in `hf_transfer` starting from version `0.1.4`. Consider upgrading (`pip install -U hf_transfer`) if you plan to enable faster downloads.
 
 </Tip>
 

docs/source/fr/_toctree.yml

@@ -0,0 +1,84 @@
+- title: "Get started"
+  sections:
+    - local: index
+      title: Home
+    - local: quick-start
+      title: Introduction rapide
+    - local: installation
+      title: Installation
+- title: "Guides"
+  sections:
+    - local: guides/overview
+      title: Vue d'ensemble
+    - local: guides/download
+      title: Télécharger des fichiers
+    - local: guides/upload
+      title: Upload des fichiers
+    - local: guides/cli
+      title: Utiliser le CLI
+    - local: guides/hf_file_system
+      title: HfFileSystem
+    - local: guides/repository
+      title: Dépôts
+    - local: guides/search
+      title: Rechercher
+    - local: guides/inference
+      title: Inférence
+    - local: guides/inference_endpoints
+      title: Inference Endpoints
+    - local: guides/community
+      title: Community Tab
+    - local: guides/collections
+      title: Collections
+    - local: guides/manage-cache
+      title: Cache
+    - local: guides/model-cards
+      title: Model cards
+    - local: guides/manage-spaces
+      title: Gérez vos Spaces
+    - local: guides/integrations
+      title: Intégrer une librairie
+    - local: guides/webhooks_server
+      title: Webhooks
+- title: "Concepts"
+  sections:
+    - local: concepts/git_vs_http
+      title: Git ou HTTP?
+- title: "Référence"
+  sections:
+    - local: package_reference/overview
+      title: Vue d'ensemble
+    - local: package_reference/login
+      title: Connexion et déconnexion
+    - local: package_reference/environment_variables
+      title: Variables d'environnement
+    - local: package_reference/repository
+      title: Gérer les dépôts locaux et en ligne
+    - local: package_reference/hf_api
+      title: Hugging Face Hub API
+    - local: package_reference/file_download
+      title: Téléchargement des fichiers
+    - local: package_reference/mixins
+      title: Mixins & méthodes de sérialisations
+    - local: package_reference/inference_client
+      title: Inference Client
+    - local: package_reference/inference_endpoints
+      title: Inference Endpoints
+    - local: package_reference/hf_file_system
+      title: HfFileSystem
+    - local: package_reference/utilities
+      title: Utilitaires
+    - local: package_reference/community
+      title: Discussions et Pull Requests
+    - local: package_reference/cache
+      title: Système de cache
+    - local: package_reference/cards
+      title: Repo Cards et metadata
+    - local: package_reference/space_runtime
+      title: Space runtime
+    - local: package_reference/collections
+      title: Collections
+    - local: package_reference/tensorboard
+      title: Logger Tensorboard
+    - local: package_reference/webhooks_server
+      title: Webhooks

docs/source/fr/concepts/git_vs_http.md

@@ -0,0 +1,68 @@
+<!--⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+-->
+
+# Git ou HTTP?
+
+`huggingface_hub` est une librairie qui permet d'intéragir avec le Hub Hugging Face,
+qui est une collection de dépots Git (modèles, datasets ou spaces).
+Il y a deux manières principales pour accéder au Hub en utilisant `huggingface_hub`.
+
+La première approche, basée sur Git, appelée approche "git-based", est rendue possible par la classe [`Repository`].
+Cette méthode utilise un wrapper autour de la commande `git` avec des fonctionnalités supplémentaires conçues pour intéragir avec le Hub. La deuxième option, appelée approche "HTTP-based" , consiste à faire des requêtes HTTP en utilisant le client [`HfApi`]. Éxaminions
+les avantages et les inconvénients de ces deux méthodes.
+
+## Repository: L'approche hstorique basée sur git
+
+Initialement, `huggingface_hub` était principalement construite autour de la classe [`Repository`]. Elle fournit des
+wrappers Python pour les commandes `git` usuelles, telles que `"git add"`, `"git commit"`, `"git push"`,
+`"git tag"`, `"git checkout"`, etc.
+
+Cette librairie permet aussi de définir les données d'identification et de suivre les fichiers volumineux, qui sont souvent utilisés dans les dépôts Git de machine learning. De plus, la librairie vous permet d'exécuter ses
+méthodes en arrière-plan, ce qui la rend utile pour upload des données pendant l'entrainement des modèles.
+
+L'avantage principal de [`Repository`] est que cette méthode permet de garder une
+copie en local du dépot Git sur votre machine. Cela peut aussi devenir un désavantage,
+car cette copie locale doit être mise à jour et maintenue constamment. C'est une méthode
+analogue au développement de logiciel classique où chaque développeur maintient sa propre copie locale
+et push les changements lorsqu'il travaille sur une nouvelle fonctionnalité.
+Toutefois, dans le contexte du machine learning, elle n'est pas toujours pertinente car
+les utilisateurs ont parfois juste besoin d'avoir
+les poids des modèles pour l'inférence ou de convertir ces poids d'un format à un autre sans avoir à cloner
+tout le dépôt.
+
+<Tip warning={true}>
+
+[`Repository`] est maintenant obsolète et remplacée par les alternatives basées sur des requêtes HTTP. Étant donné son adoption massive par les utilisateurs,
+la suppression complète de [`Repository`] ne sera faite que pour la version `v1.0`.
+
+</Tip>
+
+## HfApi: Un client HTTP plus flexible
+
+La classe [`HfApi`] a été développée afin de fournir une alternative aux dépôts git locaux,
+qui peuvent être peu pratiques à maintenir, en particulier lors de l'utilisation de gros modèles ou de datasets volumineux.
+La classe [`HfApi`]  offre les mêmes fonctionnalités que les approches basées sur Git,
+telles que le téléchargement et le push de fichiers ainsi que la création de branches et de tags, mais sans
+avoir besoin d'un fichier local qui doit être constamment synchronisé.
+
+En plus des fonctionnalités déjà fournies par `git`, La classe [`HfApi`] offre des fonctionnalités
+additionnelles, telles que la capacité à gérer des dépôts, le téléchargement des fichiers
+dans le cache (permettant une réutilisation), la recherche dans le Hub pour trouver
+des dépôts et des métadonnées, l'accès aux fonctionnalités communautaires telles que, les discussions,
+les pull requests et les commentaires.
+
+## Quelle méthode utiliser et quand ?
+
+En général, **l'approche HTTP est la méthode recommandée** pour utiliser `huggingface_hub`
+[`HfApi`] permet de pull et push des changements, de travailler avec les pull requests, les tags et les branches, d'intéragir avec les discussions
+et bien plus encore. Depuis la version `0.16`, les méthodes HTTP-based peuvent aussi être exécutées en arrière-plan, ce qui constituait le
+dernier gros avantage  de la classe [`Repository`].
+
+Toutefois, certaines commandes restent indisponibles en utilisant [`HfApi`].
+Peut être que certaines ne le seront jamais, mais nous essayons toujours de réduire le fossé entre ces deux approches.
+Si votre cas d'usage n'est pas couvert, nous serions ravis de vous aider. Pour cela, ouvrez 
+[une issue sur Github](https://github.com/huggingface/huggingface_hub)! Nous écoutons tous les retours nous permettant de construire
+l'écosystème 🤗 avec les utilisateurs et pour les utilisateurs.
+
+Cette préférence pour l'approche basée sur [`HfApi`] plutôt que [`Repository`] ne signifie pas que les dépôts stopperons d'être versionnés avec git sur le Hugging Face Hub. Il sera toujours possible d'utiliser les commandes `git` en local lorsque nécessaire.