Skip to content

Commit

Permalink
chore: sync translations
Browse files Browse the repository at this point in the history
  • Loading branch information
task-bot authored Nov 14, 2023
1 parent fb506ac commit 2d5de95
Show file tree
Hide file tree
Showing 9 changed files with 69 additions and 69 deletions.
2 changes: 1 addition & 1 deletion docs/i18n/fr-FR/docusaurus-plugin-content-blog/authors.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Original file line number Diff line number Diff line change
Expand Up @@ -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é}
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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 ;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand All @@ -223,7 +223,7 @@ tasks:
echo "some other complex logic"
done'
# good
# Correct
version: '3'

tasks:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand All @@ -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'
Expand All @@ -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'
Expand All @@ -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'
Expand All @@ -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'
Expand All @@ -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'
Expand All @@ -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'
Expand All @@ -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'
Expand All @@ -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'
Expand All @@ -212,24 +212,24 @@ 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:
cmds:
- 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`

<!-- prettier-ignore-start -->

Expand Down

0 comments on commit 2d5de95

Please sign in to comment.