Skip to content

Commit

Permalink
translation: update french translation
Browse files Browse the repository at this point in the history
  • Loading branch information
c-leri committed May 22, 2024
1 parent 66abb9d commit 4457321
Show file tree
Hide file tree
Showing 4 changed files with 57 additions and 22 deletions.
2 changes: 1 addition & 1 deletion src/lib/translations/fr/wiki.json
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@
}
},
"items": {
"title": "Objets",
"title": "Items",
"armor": {
"title": "Ajouter une Armure"
},
Expand Down
11 changes: 1 addition & 10 deletions wiki/introduction/get-started/fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,11 @@ Pour commencer à modder Minecraft, vous aurez besoins de deux choses.

## Comment Utiliser ce Wiki

TODO: Create example code repository and put it here ([Issue #68](https://github.com/QuiltMC/developer-wiki/issues/68))
<!-- TODO: Create example code repository and put it here ([Issue #68](https://github.com/QuiltMC/developer-wiki/issues/68)) -->

Ce wiki contient des pages qu'il vaut mieux lire dans l'ordre. Nombre de ces articles, surtout ceux au début, suggèrent d'autres articles avec lesquels continuer.
La plupart des pages contiennent des extraits de code, et des exemples complets de mods sont prévus. (ça n'est pas encore fait)

Vous pourrez rencontrer des lignes qui commencent avec `TODO: `. Ce sont des notes pour les rédacteur·ice·s du wiki sur le travail qu'il reste à faire.
Vous pouvez les ignorer pour l'instant, sachez simplement que plus de contenu sera inséré à leur place plus tard.

Dans le prochain article, vous mettrez en place votre premier mod pour débuter avec le développement de mod.

Une fois cela fais, il est recommandé d'apprendre à [Créer votre Premier Item](../items/first-item). Puis, si vous êtes près, vous pouvez apprendre à [ajoutez des blocs](../blocks/first-block), ou à créer des items plus avancés, tels que de la [nourriture](../items/food), des [outils](../items/tools) et des [armures](../items/armor).
Expand Down Expand Up @@ -57,9 +54,3 @@ sont là pour que vous puissiez en apprendre, n'ayez pas peur de les utiliser !
Il y a de nombreux sujets dans le modding pour lesquels vous ne trouverez pas de tutoriels. Dans ces cas là vous devrez soit comprendre le code de Minecraft impliqué, soit regarder le code d'autres mods pour comprendre comment ils accomplissent des choses similaires à ce que vous essayez de faire. Si vous voulez regarder le code source de Minecraft, lancez la tâche Gradle `genSourcesWithVineFlower` dans la catégorie `fabric` ou ouvez n'importe quel fichier source de Minecraft dans IntelliJ IDEA et cliquez sur le bouton "download sources".

<!-- TODO: Is this todo fixed?: Levi write your thing about stealing code here -->

## Les différences entre Fabric et Quilt

Quilt est basé sur Fabric. Cependant, il y a des différences clés entre les deux.

TODO: Levi write your thing here
7 changes: 5 additions & 2 deletions wiki/introduction/setting-up/fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,10 @@ pour Minecraft qui est hautement recommandé. Vous pouvez l'obtenir ici :

Après avoir ouvert le projet, vous devriez voir une fenêtre qui ressembler vaguement à ça :

TODO: Embed screenshot
<picture>
<source media="(prefers-color-scheme: dark)" srcset="/introduction/template-mod-intellij-dark.png">
<img alt="IntelliJ IDEA open to the template mod" src="/introduction/template-mod-intellij-light.png">
</picture>

Vous pouvez voir des barres latérales de chaque côté de la fenêtre avec des icônes pour accéder à différents outils.
En voici quelques uns qui vous seront utiles :
Expand Down Expand Up @@ -238,4 +241,4 @@ Enfin, rechargez le projet Gradle en appuyant sur ce bouton dans le menu Gradle
</picture>

Après avoir complété toutes ces étapes, vous pouvez maintenant travailler sur votre mod !
Vous pouvez commencer par [Créer votre Premier Item](../items/first-item).
Vous pouvez commencer par ajouter du contenu avec les tutoriels ["Créer votre Premier Item"](../items/first-item) et [Ajouter un Bloc Simple](../blocks/first-block).
59 changes: 50 additions & 9 deletions wiki/items/first-item/fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,13 +13,20 @@ Les blocs, les entités, les items, les sons, les particules... tous ces différ

---

Premièrement, nous devons créer une instance de `net.minecraft.item.Item` avec les paramètres de notre item.
Premièrement, il faut que nous mettions en place un endroit pour les objets de notre mod. Créez une nouvelle classe nommée `ExampleModItems`, en renplaçant `ExampleMod` par le nom de votre mod, dans le même package que votre classe principale.
Cela nous aidera à rester organiser si jamais notre mod s'aggrandit et ajoute plus d'un item.

En théorie, nous pourrions faire ça directement dans la même ligne où nous enregistrons l'item,
Ensuite, on va déclarer une instance de `net.minecraft.item.Item` avec les paramètres pour notre item.

En théorie, nous pourrions passer cette étape et déclarer l'item en même temps qu'on lenregistre,
mais l'avoir dans une variable séparée nous permet d'y faire référence à d'autres endroit pour d'autres usages.

`src/main/com/example/example_mod/ExampleModItems`:

```java
public static final Item EXAMPLE_ITEM = new Item(new QuiltItemSettings());
public class ExampleModItems {
public static final Item EXAMPLE_ITEM = new Item(new QuiltItemSettings());
}
```

Ici, le `public static final` permet d'acceder à l'item ailleurs sans que l'on puisse changer la valeur de la variable en elle même,
Expand All @@ -32,11 +39,19 @@ mais dans notre cas nous utilisons simplement les paramètres par défaut.

---

Après avoir déclaré l'item, nous devons dire au registre des items du jeu de l'inclure dans ce dernier.
Pour ce faire nous ajoutons la ligne suivante dans le `ModInitializer` du mod (([Plus d'information sur les 'mod initializers' ici](../concepts/sideness#les-mod-initializers))) dans la méthode `onInitialize` :
Après avoir déclaré l'item, nous devons l'enregistrer pour l'inclure dans le jeu.
Nous allons mettre en place une méthode dans votre classe pour items responsable de l'enregistrement de tous vos items.
Vous pouvez voir que l'on prend le `ModContainer` du mod comme paramètre pour que l'on puisse l'utiliser pour récupérer l'ID du mod.

`src/main/com/example/example_mod/ExampleModItems`:

```java
Registry.register(Registries.ITEM, new Identifier(mod.metadata().id(), "example_item"), EXAMPLE_ITEM);
public class ExampleModItems {
// ...
public static void register(ModContainer mod) {
Registry.register(Registries.ITEM, new Identifier(mod.metadata().id(), "example_item"), EXAMPLE_ITEM);
}
}
```

`Registry.register()` prend trois arguments :
Expand All @@ -46,6 +61,22 @@ Registry.register(Registries.ITEM, new Identifier(mod.metadata().id(), "example_
suivi du nom de l'item en lui même. Seules les lettres minuscules, les chiffres, les underscores, les tirets, les points et les slashs sont autorisés.
- L'`Item` à enregistrer. Ici, on passe l'item déclaré plus tôt.

Enfin, nous devons nous assurer que la méthode `register()` est bien appelée pendant le démarrage du jeu.
On peut accomplir cela en appelant la méthode dans le `ModInitializer` du mod ([plus d'informations sur les mod initializers ici!](../concepts/sideness#les-mod-initializers)) dans la méthode `onInitialize`:

`src/main/com/example/example_mod/ExampleMod`:

```java
public class ExampleMod implements ModInitializer {
// ...
@Override
public void onInitialize(ModContainer mod) {
// ...
ExampleModItems.register(mod);
}
}
```

Une fois que vous avez fait tout ça, si on lance le jeu on peut voir que l'on peut se donner l'item avec la commande give : `/give @s simple_item_mod:example_item` !
Mais il n'apparait pas dans le menu du mode créatif, et il n'a pas de texture, et son nom n'a pas de traduction.
Comment réparer ça ?
Expand All @@ -59,10 +90,18 @@ en utilisant seulement les [Quilt Standard Libraries](../concepts/qsl-qfapi#les-
Grâce à la [Quilted Fabric API](../concepts/qsl-qfapi#la-quilted-fabric-api), qui est inclue dans le mod patron
et est téléchargée par les utilisateurs avec la QSL, on peut aussi l'utiliser avec Quilt :

`src/main/com/example/example_mod/ExampleModItems`:

```java
ItemGroupEvents.modifyEntriesEvent(ItemGroups.INGREDIENTS).register(entries -> {
entries.addItem(EXAMPLE_ITEM);
});
public class ExampleModItems {
// ...
public static void register(ModContainer mod) {
// ...
ItemGroupEvents.modifyEntriesEvent(ItemGroups.INGREDIENTS).register (entries -> {
entries.addItem(EXAMPLE_ITEM);
});
}
}
```

Ici on utilise l'API `ItemGroupEvents`. On récupère l'[événement](../concepts/events)
Expand Down Expand Up @@ -101,6 +140,8 @@ donc dans notre cas : `assets/simple_item_mod/textures/item/example_item.png`.
Enfin, on a besoin d'ajouter une traduction.
Mettez ceci dans `assets/simple_item_mod/lang/en_us.json`, en remplaçant l'identifiant du mod et le nom de l'item comme avant :

`assets/simple_item_mod/lang/en_us.json`;

```json
{
"item.simple_item_mod.example_item": "Example Item"
Expand Down

0 comments on commit 4457321

Please sign in to comment.