Skip to content

Commit

Permalink
translation: update french translation (#105)
Browse files Browse the repository at this point in the history
translation: translate mappings article to french

translation: translate world type article to french
  • Loading branch information
c-leri authored Jun 28, 2024
1 parent 676798e commit c749e4e
Show file tree
Hide file tree
Showing 10 changed files with 317 additions and 51 deletions.
11 changes: 6 additions & 5 deletions src/lib/HtmlHead.svelte
Original file line number Diff line number Diff line change
@@ -1,14 +1,15 @@
<script lang="ts">
import { onMount } from "svelte";
import { currentDir } from "$l10n";
import { browser } from "$app/environment";
import prism_dark from "prismjs/themes/prism-tomorrow.min.css?url";
import prism_light from "prismjs/themes/prism.min.css?url";
import styles_dark from "quilt-bulma/dist/style-dark.min.css?url";
import styles_light from "quilt-bulma/dist/style-light.min.css?url";
import styles_dark_rtl from "quilt-bulma/dist/style-dark-rtl.min.css?url";
import styles_dark from "quilt-bulma/dist/style-dark.min.css?url";
import styles_light_rtl from "quilt-bulma/dist/style-light-rtl.min.css?url";
import styles_light from "quilt-bulma/dist/style-light.min.css?url";
import { onMount } from "svelte";
import { browser } from "$app/environment";
import { currentDir } from "$l10n";
//
// userPrefersDarkMode is simple, It's true if the user has dark mode enabled in their browser.
Expand Down
3 changes: 2 additions & 1 deletion src/routes/[[locale=locale]]/+page.svelte
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
<script lang="ts">
import { isRtl } from "$l10n";
import { localize } from "@nubolab-ffwd/svelte-fluent";
import { isRtl } from "$l10n";
export let data;
</script>

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
<script lang="ts">
import { currentLocale, isRtl } from "$l10n";
import { Localized, Overlay, localize } from "@nubolab-ffwd/svelte-fluent";
import { currentLocale, isRtl } from "$l10n";
export let data;
</script>

Expand Down
11 changes: 1 addition & 10 deletions wiki/introduction/getting-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
9 changes: 3 additions & 6 deletions wiki/misc/mappings/en.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## What are mappings?

Before a new Minecraft version jar is published to Mojang's servers, it goes through a process called *obfuscation*,
Before a new Minecraft version jar is published to Mojang's servers, it goes through a process called _obfuscation_,
where the human-readable class, field and method names are simplified to just a few letters, mainly to optimize the file
size. In addition, obfuscation makes code very difficult to understand, because those simplified names aren't just
contractions of the real names, they're completely random letters. This is where mappings come into play.
Expand Down Expand Up @@ -60,7 +60,7 @@ closing Enigma.
### Contributing the changes back to Quilt

To contribute your changes, you have to add and commit your changes, then push the changes to your fork of QM. This is
really easy to do with an IDE, as described in [the Setting Up article][setting-up], but if you want you can also do it
really easy to do with an IDE, as described in [the Setting Up article](../introduction/setting-up), but if you want you can also do it
from the command prompt or terminal with these commands.

```bash
Expand Down Expand Up @@ -105,15 +105,12 @@ their documentation or code to verify the version you want.
That's it! You can now reload gradle through your IDE to apply these changes, and use your new mappings when reading
Minecraft's code.


<!-- Links -->

[Quilt Mappings]: https://github.com/QuiltMC/quilt-mappings
[QM CONTRIBUTING.md]: https://github.com/QuiltMC/quilt-mappings/blob/HEAD/CONTRIBUTING.md
[Fork QM]: https://github.com/QuiltMC/quilt-mappings/fork
[QM PRs]: https://github.com/QuiltMC/quilt-mappings/pulls
[Enigma]: https://github.com/QuiltMC/enigma
[Enigma guide]: https://github.com/QuiltMC/quilt-mappings/blob/HEAD/GUIDE.md

[setting-up]: /en/introduction/setting-up

[Tiny V2]: https://fabricmc.net/wiki/documentation:tiny2
Loading

1 comment on commit c749e4e

@Cozy-GitHub
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

See preview on Cloudflare Pages: https://01688b24.developer-wiki.pages.dev

Please sign in to comment.