diff --git a/docs/i18n/fr-FR/docusaurus-plugin-content-blog/authors.yml b/docs/i18n/fr-FR/docusaurus-plugin-content-blog/authors.yml index c41c91352d..03c3d4a543 100644 --- a/docs/i18n/fr-FR/docusaurus-plugin-content-blog/authors.yml +++ b/docs/i18n/fr-FR/docusaurus-plugin-content-blog/authors.yml @@ -5,6 +5,6 @@ andreynering: image_url: https://github.com/andreynering.png pd93: name: Pete Davison - title: Maintainer of Task + title: Mainteneur de Task url: https://github.com/pd93 image_url: https://github.com/pd93.png diff --git a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/community.md b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/community.md index ccfe208e54..f7bb5d635e 100644 --- a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/community.md +++ b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/community.md @@ -9,7 +9,7 @@ Certains travaux d'amélioration de l'écosystème Task sont réalisés par la c ## Traductions -We use [Crowdin](https://crowdin.com/project/taskfile) to translate our document. +Nous utilisons [Crowdin](https://crowdin.com/project/taskfile) pour traduire nos documents. ## Intégrations diff --git a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/deprecations/deprecations.md b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/deprecations/deprecations.md index 965b26d117..ab3d235302 100644 --- a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/deprecations/deprecations.md +++ b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/deprecations/deprecations.md @@ -3,10 +3,10 @@ slug: /deprecations/ sidebar_position: 7 --- -# Deprecations +# Dépréciations -As Task evolves, it occasionally outgrows some of its functionality. This can be because they are no longer useful, because another feature has replaced it or because of a change in the way that Task works internally. +Au fur et à mesure que Task évolue, certaines de ses fonctionnalités peuvent se montrer obsolètes. Cela peut être dû au fait qu'elles ne sont plus utiles, parce qu'une autre fonctionnalité l'a remplacée ou à cause d'un changement dans la façon dont la tâche fonctionne. -When this happens, we mark the functionality as deprecated. This means that it will be removed in a future version of Task. This functionality will continue to work until that time, but we strongly recommend that you do not implement this functionality in new Taskfiles and make a plan to migrate away from it as soon as possible. +Lorsque cela se produit, nous marquons la fonctionnalité comme obsolète. Cela signifie que sera supprimé dans une future version de Task. La fonctionnalité continuera de fonctionner en attendant, mais il vous est fortement recommandé de ne plus l'utiliser et de planifier un plan de migration pour changer toutes les tâches pouvant l'utiliser. -You can view a full list of active deprecations in the "Deprecations" section of the sidebar. +Vous pouvez afficher une liste complète des dépréciations actives dans la section "Dépréciations" de la barre latérale. diff --git a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/deprecations/template.md b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/deprecations/template.md index 43ed4d3b6a..c8332e74b7 100644 --- a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/deprecations/template.md +++ b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/deprecations/template.md @@ -6,12 +6,12 @@ sidebar_position: -1 #Always push to the top draft: true #Hide in production --- -# {Name of Deprecated Feature} +# {Nom de la fonctionnalité obsolète} - Issue: [#{issue}](https://github.com/go-task/task/issues/{issue}) - Breaks: - - {list any existing functionality that will be broken by this experiment} + - {lister toutes les fonctionnalités qui vont être brisées par ce changement} -{Short description of the feature/behavior and why it is being deprecated} +{Description rapide de la fonctionnalité et de la raison de sa dépréciation} -{Short explanation of any replacement features/behaviors and how users should migrate to it} +{Courte explication des fonctionnalités à utiliser à la place, et comment les utilisateurs peuvent migrer vers cette autre fonctionnalité} diff --git a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/donate.md b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/donate.md index c5ebd58047..18bb2a1bea 100644 --- a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/donate.md +++ b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/donate.md @@ -13,7 +13,7 @@ Les entreprises qui font un don d'au moins 50$/mois seront présentées comme un ## Sponsors GitHub -La façon préférée de faire un don aux mainteneurs du projet est d'utiliser les sponsors GitHub. Just use the following links to do your donation. We suggest a 50/50 split to each maintainer of the total amount you plan to donate to the project. +La façon préférée de faire un don aux mainteneurs du projet est d'utiliser les sponsors GitHub. Vous pouvez utiliser le lien suivant pour faire votre don. Nous suggérons de donner 50% à chaque mainteneur du montant total que vous prévoyez de donner. - [@andreynering](https://github.com/sponsors/andreynering) - [@pd93](https://github.com/sponsors/pd93) diff --git a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/experiments/experiments.md b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/experiments/experiments.md index b32a757072..1e76dcac75 100644 --- a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/experiments/experiments.md +++ b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/experiments/experiments.md @@ -3,23 +3,23 @@ slug: /experiments/ sidebar_position: 6 --- -# Experiments +# Expérimentations :::caution -All experimental features are subject to breaking changes and/or removal _at any time_. We strongly recommend that you do not use these features in a production environment. They are intended for testing and feedback only. +Toutes les fonctionnalités expérimentales sont sujettes à des changements brisant la fonctionnalité et/ou à la suppression de cette dernière _à tout moment _. Nous vous recommandons fortement de ne pas utiliser ces fonctionnalités dans en production. Ils sont seulement destinés à être testés et obtenir des retours dessus. ::: -In order to allow Task to evolve quickly, we roll out breaking changes to minor versions behind experimental flags. This allows us to gather feedback on breaking changes before committing to a major release. This document describes the current set of experimental features and their status in the [workflow](#workflow). +Afin de permettre à Task d'évoluer rapidement, nous déployons des changements cassants sur des versions mineures activables par des options expérimentales. Cela nous permet d'obtenir des retours sur des changements brisants des fonctionnalités avant de les livrer dans une version majeure. Ce document décrit l'ensemble actuel de fonctionnalités expérimentales et leur statut dans le [workflow](#workflow). -You can view a full list of active experiments in the "Experiments" section of the sidebar. +Vous pouvez consulter une liste complète des expérimentations en cours dans la section "Expérimentations" de la barre latérale . -You can enable an experimental feature by: +Vous pouvez activer une fonctionnalité expérimentale par: -1. Using the relevant environment variable in front of a task command. For example, `TASK_X_{FEATURE}=1 task {my-task}`. This is intended for one-off invocations of Task to test out experimental features. -1. Using the relevant environment variable in your "dotfiles" (e.g. `.bashrc`, `.zshrc` etc.). This is intended for permanently enabling experimental features in your environment. -1. Creating a `.env` file in the same directory as your root Taskfile that contains the relevant environment variables. e.g. +1. Utiliser la variable d'environnement pertinente devant une commande Task. Par exemple, `TASK_X_{FEATURE}=1 task {my-task}`. Ceci est prévu pour faire appel à une expérimentation durant une seule commande Task afin de tester une fonctionnalité expérimentale. +1. Utiliser la variable d'environnement pertinente dans vos "dotfiles" (par exemple `.bashrc`, `.zshrc` etc.). Ceci est destiné à l'activation permanente des fonctionnalités expérimentales dans votre environnement. +1. Création d'un fichier `.env` dans le même répertoire que votre fichier Taskfile contenant les variables d'environnement pertinentes pour vos tests. Par exemple : ```shell # .env diff --git a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/intro.md b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/intro.md index 2e2f429adc..bc66fc41cc 100644 --- a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/intro.md +++ b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/intro.md @@ -30,7 +30,7 @@ Et appelez-le en exécutant `task hello` depuis votre terminal. L'exemple ci-dessus n'est que le début, vous pouvez jeter un coup d'œil au [guide d'utilisation](/usage) pour vérifier la documentation complète du schéma et les fonctionnalités de Task. -## Features +## Fonctionnalités - [Installation facile](installation.md): il suffit de télécharger un seul binaire, ajoutez le à `$PATH` et vous avez terminé ! Ou vous pouvez également installer en utilisant [Homebrew][homebrew], [Snapcraft][snapcraft] ou [Scoop][scoop] si vous le souhaitez. - Disponible sur les CIs: en ajoutant [cette commande simple](installation.md#install-script) à installer sur votre script CI, vous êtes prêt à utiliser Task dans le cadre de votre pipeline CI ; diff --git a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/styleguide.md b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/styleguide.md index 01c9826435..a05fda329a 100644 --- a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/styleguide.md +++ b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/styleguide.md @@ -208,10 +208,10 @@ tasks: C'est aussi fait automatiquement quand vous incluez des Taskfiles. -## Prefer external scripts over complex multi-line commands +## Préférer les scripts externes à des commandes complexes à plusieurs lignes ```yaml -# bad +# Incorrect version: '3' tasks: @@ -223,7 +223,7 @@ tasks: echo "some other complex logic" done' -# good +# Correct version: '3' tasks: diff --git a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/taskfile_versions.md b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/taskfile_versions.md index 1c9b552e9c..d80013254c 100644 --- a/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/taskfile_versions.md +++ b/docs/i18n/fr-FR/docusaurus-plugin-content-docs/current/taskfile_versions.md @@ -3,28 +3,28 @@ slug: /taskfile-versions/ sidebar_position: 5 --- -# Taskfile Versions +# Versions Taskfile -The Taskfile syntax and features changed with time. This document explains what changed on each version and how to upgrade your Taskfile. +La syntaxe et les fonctionnalités du fichier Taskfile changent avec le temps. Ce document explique quels sont les changments pour chacune des versions et comment vous pouvez mettre à jour votre Taskfile. -## What the Taskfile version mean +## Qu'est-ce que la version de Taskfile signifie -The Taskfile version follows the Task version. E.g. the change to Taskfile version `2` means that Task `v2.0.0` should be release to support it. +La version de Taskfile suit la version de Task. Par exemple : Le changement pour la version `2` dans Taskfile signifie que la version `v2.0.0` de Task doit être publiée pour pouvoir le supporter. -The `version:` key on Taskfile accepts a semver string, so either `2`, `2.0` or `2.0.0` is accepted. If you choose to use `2.0` Task will not enable future `2.1` features, but if you choose to use `2`, then any `2.x.x` features will be available, but not `3.0.0+`. +Le paramètrre `version:` dans Taskfile accepte une version suivant la nomenclature semver. Donc `2`, `2.0` et `2.0.0` sont acceptés. Si vous choisissez d'utiliser la version `2.0`, Task ne va pas activer les fonctionnalités des versions `2.1` et celles d'après. Mais si vous choississez d'utiliser la version `2`, alors toutes les fonctionnalités des versions `2.x.x` seront disponibles, et non celles des versions `3.0.0` et celles d'après. -## Version 3 ![latest](https://img.shields.io/badge/latest-brightgreen) +## Version 3 ![Dernier](https://img.shields.io/badge/latest-brightgreen) -These are some major changes done on `v3`: +Voici quelques modifications majeures effectuées sur `v3`: -- Task's output will now be colored -- Added support for `.env` like files -- Added `label:` setting to task so one can override how the task name appear in the logs -- A global `method:` was added to allow setting the default method, and Task's default changed to `checksum` -- Two magic variables were added when using `status:`: `CHECKSUM` and `TIMESTAMP` which contains, respectively, the XXH3 checksum and greatest modification timestamp of the files listed on `sources:` -- Also, the `TASK` variable is always available with the current task name -- CLI variables are always treated as global variables -- Added `dir:` option to `includes` to allow choosing on which directory an included Taskfile will run: +- Les logs de Task dans le terminal sont colorés +- Ajout du support des fichiers `.env` et similaires +- Ajout du paramètre `label:` dans les tâches pour que l'on puisse renommer la tâche dans les logs +- Le paramètre global `method:` a été ajouté pour permettre de définir la méthode par défault, et la valeur par défaut de Task a été changée pour `checksum` +- Deux variables magiques ont été ajoutées lors de l'utilisation de `status:`: `CHECKSUM` et `TIMESTAMP` qui contiennent respectivement le checksum XXH3 et le plus récent timestamp de modification des fichiers répertoriés dans `sources:` +- Aussi, la variable `TASK` est toujours disponible avec le nom de la tâche courante +- Les variables CLI sont toujours traitées comme des variables globales +- Ajout de l'option `dir:` dans `includes` pour permettre de choisir dans quel dossier un Taskfile doit être exécuté : ```yaml includes: @@ -33,7 +33,7 @@ includes: dir: ./docs ``` -- Implemented short task syntax. All below syntaxes are equivalent: +- Implémentation de syntaxes courtes. Toutes les syntaxes ci-dessous sont équivalentes: ```yaml version: '3' @@ -59,21 +59,21 @@ tasks: print: echo "Hello, World!" ``` -- There was a major refactor on how variables are handled. They're now easier to understand. The `expansions:` setting was removed as it became unnecessary. This is the order in which Task will process variables, each level can see the variables set by the previous one and override those. - - Environment variables - - Global + CLI variables - - Call variables - - Task variables +- Il y a eu une réécriture majeure sur la manière dont les variables sont gérées. C'est maintenant plus simple à comprendre. Les paramètres `expansions:` ont été retirées vu qu'ils n'étaient plus nécessaires. C'est l'ordre dans lequel Task va traiter les variables, chaque niveau peut voir les variables définies par la précédente et les remplacer. + - Variables d'environnement + - Variables globales + CLI + - Variables d'appel + - Variables Task ## Version 2.6 :::caution -v2 schema support is [deprecated][deprecate-version-2-schema] and will be removed in a future release. +Le support du schéma v2 est [déprécié][deprecate-version-2-schema] et sera retiré dans une future version. ::: -Version 2.6 comes with `preconditions` stanza in tasks. +La version 2.6 vient avec des `preconditions` dans les tâches. ```yaml version: '2' @@ -86,17 +86,17 @@ tasks: - aws s3 cp .env s3://myenvironment ``` -Please check the [documentation][includes] +Veuillez consulter la [documentation][includes] ## Version 2.2 :::caution -v2 schema support is [deprecated][deprecate-version-2-schema] and will be removed in a future release. +Le support du schéma v2 est [déprécié][deprecate-version-2-schema] et sera retiré dans une future version. ::: -Version 2.2 comes with a global `includes` options to include other Taskfiles: +La version 2.2 est fournie avec une option globale `includes` pour inclure d'autres Taskfiles : ```yaml version: '2' @@ -110,11 +110,11 @@ includes: :::caution -v2 schema support is [deprecated][deprecate-version-2-schema] and will be removed in a future release. +Le support du schéma v2 est [déprécié][deprecate-version-2-schema] et sera retiré dans une future version. ::: -Version 2.1 includes a global `output` option, to allow having more control over how commands output are printed to the console (see [documentation][output] for more info): +La version 2.1 inclut une option globale `output` permettant d'avoir plus de contrôle sur la manière dont les logs sont affichés dans la console (voir la [documentation][output] pour plus d'informations): ```yaml version: '2' @@ -128,7 +128,7 @@ tasks: prefix: server ``` -From this version it's also possible to ignore errors of a command or task (check documentation [here][ignore_errors]): +À partir de cette version, il est également possible d'ignorer les erreurs d'une commande ou d'une tâche (vérifiez la documentation [ici][ignore_errors] ) : ```yaml version: '2' @@ -151,11 +151,11 @@ tasks: :::caution -v2 schema support is [deprecated][deprecate-version-2-schema] and will be removed in a future release. +Le support du schéma v2 est [déprécié][deprecate-version-2-schema] et sera retiré dans une future version. ::: -At version 2, we introduced the `version:` key, to allow us to evolve Task with new features without breaking existing Taskfiles. The new syntax is as follows: +À la version 2, nous avons introduit le paramètre `version:` pour nous permettre d'évoluer vers de nouvelles fonctionnalités avec sans casser les fichiers de tâches existants. La nouvelle syntaxe est la suivante: ```yaml version: '2' @@ -166,7 +166,7 @@ tasks: - echo "Hello, World!" ``` -Version 2 allows you to write global variables directly in the Taskfile, if you don't want to create a `Taskvars.yml`: +La version 2 vous permet d'écrire des variables globales directement dans le fichier Taskfile, si vous ne voulez pas créer un fichier `Taskvars.yml`: ```yaml version: '2' @@ -180,15 +180,15 @@ tasks: - echo "{{.GREETING}}" ``` -The variable priority order changed to the following: +A présent, l'ordre de priorité des variables est : -1. Task variables -2. Call variables -3. Taskfile variables -4. Taskvars file variables -5. Environment variables +1. Variables Task +2. Variables d'appel +3. Variables Taskfile +4. Variables du fichier Taskvars +5. Variables d'environnement -A new global option was added to configure the number of variables expansions (which default to 2): +Une nouvelle option globale a été ajoutée pour configurer le nombre d'extensions de variables (par défaut 2): ```yaml version: '2' @@ -212,11 +212,11 @@ tasks: :::caution -v1 schema support was removed in Task >= v3.0.0. +Le support du schéma v1 a été supprimé de Task >= v3.0.0. ::: -In the first version of the `Taskfile`, the `version:` key was not available, because the tasks was in the root of the YAML document. Like this: +Dans la première version du `Taskfile`, le champ `version:` n'était pas disponible, parce que les tâches étaient à la racine du document YAML. Comme ceci: ```yaml echo: @@ -224,12 +224,12 @@ echo: - echo "Hello, World!" ``` -The variable priority order was also different: +L'ordre de priorité de la variable était également différent : -1. Call variables -2. Environment -3. Task variables -4. `Taskvars.yml` variables +1. Variables d'appel +2. Variables d'environnement +3. Variables Task +4. Variables `Taskvars.yml`