Skip to content

Commit

Permalink
Added French locale to docs (#53)
Browse files Browse the repository at this point in the history
Didn't translate protocol/p2p because it contains a lot of technical information so I prefer avoiding any translation mistakes
  • Loading branch information
CornetPanique86 authored Oct 11, 2023
1 parent ae457b0 commit 81c2424
Show file tree
Hide file tree
Showing 16 changed files with 841 additions and 101 deletions.
1 change: 1 addition & 0 deletions docs/fr/guide/app.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
> Rédaction en cours
34 changes: 34 additions & 0 deletions docs/fr/guide/appearance.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# Guide d'apparence

> Rédaction en cours
## Palette de couleurs et Thèmes

XMCL prend en charge les couleurs personnalisées, notamment :

- Couleur de la carte
- Couleur de la barre supérieure
- Couleur de la barre latérale
- Couleur de l'arrière plan
- Couleur de surbrillance des composants de base
- Couleur d'erreur

XMCL a aussi 2 schémas de couleurs par défaut : `Light mode` (mode clair) et `Dark mode` (mode sombre).

:::tip
Les couleurs du mode sombre et du mode clair sont stockées séparément dans chaque mode, et le changement de mode changera la palette de couleurs globale.
:::

## Effets d'arrière-plan

Les arrière-plans XMCL prennent en charge les paramètres suivants :

- Image
- Vidéo
- Effets de particules

:::warning Remarque
Le launcher n'enregistrera que le chemin du fichier de la vidéo d'arrière-plan. Si la vidéo est déplacée après la sélection, le paramètre d'arrière-plan sera invalide.

Ce n'est pas un problème avec les images, car les données d'image sont stockées.
:::
49 changes: 49 additions & 0 deletions docs/fr/guide/install.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
# Guide d'installation

Le launcher fournit plusieurs formats d'installation, dont certains sont moins courants. Ici, nous nous concentrerons sur l'introduction des fonctionnalités de format **moins courantes** ou **spéciales**.

## APPX

APPX est un format de **package d'installation** fourni par Windows 10 qui permet aux programmes de s'exécuter dans un environnement virtualisé/sandbox. Les programmes installés via APPX s'exécuteront tous dans le bac à sable Windows.

Le plus grand avantage pour les utilisateurs est que les fichiers cache de l'application, les modifications du registre et les autres opérations seront isolées - lorsque vous désinstallez l'application, le cache et les modifications du registre seront supprimés aussi.

:::info Bonne nouvelle
Ne vous inquiétez pas si le programme modifie le registre, étant donné que le seul ajout au registre par XMCL puisse être l'association d'extension de fichier.
:::

AppX est mis à jour via le mécanisme appinstaller. Selon la stratégie de [mise à jour automatique](https://learn.microsoft.com/fr-fr/windows/msix/app-installer/auto-update-and-repair--overview#automatic-updates) intégrée à appinstaller, XMCL vérifie les mises à jour lorsque l'utilisateur **lance l'application**, et s'il y a une mise à jour, elle sera mise à jour au prochain lancement.

:::tip Bonne nouvelle
Les mises à jour automatiques d'APPX prennent en charge la **livraison d'optimisation** et les **mises à jour incrémentielles** de Windows - ne mettant à jour que le contenu modifié.
:::

## Installation en ligne (appinstaller)

`appinstaller` est essentiellement le même que le format `APPX`. `appinstaller` lui-même est un fichier texte `XML` qui contient l'`URL` de `APPX`. Lorsque l'interface d'installation s'affiche, elle tente de télécharger `APPX` et de l'installer. Par conséquent, son mécanisme de mise à jour est le même que APPX.

## AppImage

AppImage est un format d'application Linux qui peut s'exécuter sur n'importe quel bureau Linux sans installation. Le fichier AppImage est exécutable, il suffit de double-cliquer ou de l'exécuter depuis le terminal.

C'est le seul programme de non-installation fourni par XMCL (~~en fait, je ne veux pas le supporter~~). Par conséquent, son mécanisme de mise à jour est différent des autres formats et les utilisateurs doivent télécharger eux-mêmes une nouvelle AppImage pour effectuer la mise à jour.

## Autres formats

Actuellement, d'autres formats d'installation prennent en charge les [mises à jour à chaud] ou prennent en charge la méthode de mise à jour fournie par electron-builder. Ce mode de mise à jour ne nécessite généralement pas trop d'attention (~~si vous ne pouvez pas mettre à jour, vous pouvez simplement télécharger à nouveau le launcher~~).

:::tip Hot update
Une mise à jour "Hot update" signifie que le launcher remplace le fichier asar principal (~30Mo) par lui-même, sans avoir besoin d'un nouveau téléchargement complet du launcher.
:::

## Annexe : Choisir le répertoire des données du jeu

Lors de l'installation initiale, les utilisateurs doivent choisir le `Game Data Directory`. XMCL placera les `assets` téléchargées, les `libraries`, les `versions`, etc. dans ce répertoire.

:::warning Remarque
Comme mentionné sur la page de configuration, en raison de la structure de fichier spéciale de XMCL, il n'est pas recommandé d'utiliser le répertoire de jeu **raw** Minecraft comme répertoire de données de XMCL.
:::

Ici, il est recommandé de choisir un nouveau dossier comme `Game Data Directory` de XMCL.

Pour plus d'informations sur la structure du répertoire des données du jeu, veuillez consulter le [Guide de gestion des données](/fr/guide/manage.md#minecraft-related-data).
53 changes: 53 additions & 0 deletions docs/fr/guide/manage.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
# Stockage de données

Les données XMCL sont divisées en deux parties :

1. XMCL en tant que cache et base de données générée par chromium
2. Données liées à Minecraft

## Cache et base de données XMCL

Le cache lié à XMCL lui-même est stocké dans le chemin d'accès système appdata, qui est différent sur différentes plates-formes.

::: code-group
```cmd[Windows]
%AppData%\xmcl
```
```cmd [Windows (APPX/appinstaller)]
%LocalAppData%\Packages\XMCL_ncdvebj03zfcm\LocalCache\Roaming\xmcl
# Version >= 0.34
%LocalAppData%\Packages\XMCL_68mcaawk44tpj\LocalCache\Roaming\xmcl
```
```sh [macOS]
~/Library/Application Support/xmcl
```
```sh [Linux]
~/.config/xmcl
```
:::

:::warning Remarque
Ne supprimez pas les fichiers ici à moins que vous ne sachiez ce que vous faites.
:::

Vous trouverez ici quelques fichiers "json" utilisés pour stocker diverses configurations, et la base de données sera également stockée ici.

- [Données utilisateur](../protocol/user.md). Stocke les comptes des utilisateurs, les liens de skin, etc. Stocké dans le fichier `/user.json`.
- [Paramètres globaux](../protocol/setting.md). Paramètres globaux, tels que la langue, l'URL du proxy, le node de téléchargement, etc. Stockés dans le fichier `/settings.json`.
- [Cache d'instance](../protocol/instance.md). Enregistre le dernier chemin d'instance sélectionné et les chemins de toutes les instances connues. Stocké dans le fichier `/instances.json`.
- [Cache Java](../protocole/java.md). Enregistre les chemins Java détectés, les informations de version, etc. Stocké dans le fichier `/java.json`.
- [Base de données des ressources](../protocol/resources.md). Métadonnées pour les fichiers de ressources, telles que les informations de mod analysés. Stocké au format `leveldb`, dans le dossier `/resources-v2`.
- [Journaux](../protocol/logs.md). Journaux historiques XMCL. Stocké dans le dossier `/logs`.

## Données liées à Minecraft

Je pense que vous connaissez très bien la structure des répertoires des données Minecraft.
Le répertoire de données de XMCL est légèrement différent de celui de Minecraft :

<script setup>
import CentraProjectTree from '../../../src/components/CentraProjectTree.vue'
</script>

<CentraProjectTree />

La plupart du contenu est en fait le même que Minecraft, parmi lesquels le dossier `instances` contient tous les fichiers d'instance.
5 changes: 5 additions & 0 deletions docs/fr/guide/modpack.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Package d'intégration

## Importer le package d'intégration

## Exporter le package d'intégration
33 changes: 33 additions & 0 deletions docs/fr/guide/p2p.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# Guide multijoueur

> Rédaction en cours
## Démarrage rapide

Accédez à la page `Multijoueur sur LAN`.

![](../../assets/multiplayer.jpg)

Cliquez sur le bouton `Rejoindre/Créer un groupe` en haut à droite.

![](../../assets/multiplayer-join.jpg)

Vous pouvez créer un groupe si votre connexion Internet est bonne. Cliquez sur `Group ID` pour le copier.

![](../../assets/multiplayer-joined.jpg)

Votre pair doit saisir cet "identifiant de groupe" pour rejoindre votre groupe. Une fois qu'il s'est inscrit, vous devriez voir son statut de connexion ci-dessous.

![](../../assets/multiplayer-connected.jpg)

Ensuite, vous devez démarrer le jeu et ouvrir le jeu sur LAN, et votre ami devrait voir votre jeu même si vous n'êtes pas dans le même LAN.

![](../../assets/multiplayer-lan.jpg)

## Comment utiliser les services de transfert

> Rédaction en cours
## Skins hors ligne

> Rédaction en cours
51 changes: 51 additions & 0 deletions docs/fr/guide/update.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
# Guide de mise à jour

> Rédaction en cours
Comme le launcher est encore au stade `beta`, la sauvegarde des données est particulièrement importante... Ici, nous allons vous présenter comment résoudre les problèmes rencontrés lors des mises à jour et comment effectuer une sauvegarde si vous souhaitez réinstaller.

## La mise à jour APPX nécessite une réinstallation

Étant donné que l'ancien launcher de version du format `APPX` a des certificats expirés, lors de la mise à niveau de l'ancienne version vers la nouvelle version, il faudra désinstaller l'ancienne version. Dans ce cas, veuillez sauvegarder votre dossier de données XMCL.

Supposons que `foo` soit votre nom d'utilisateur :

::: code-group
```[Windows (APPX)]
%LocalAppData%\Packages\XMCL_ncdvebj03zfcm\LocalCache\Roaming\xmcl
```
:::

Vous pouvez le copier et le mettre sur le bureau. Après la réinstallation, la nouvelle version de XMCL devrait avoir le chemin de fichier suivant :

::: code-group
```[Windows (APPX)]
%LocalAppData%\Packages\XMCL_68mcaawk44tpj\LocalCache\Roaming\xmcl
```
:::

Remettez simplement vos fichiers de sauvegarde.

## Échec de la mise à jour APPX

La mise à jour APPX devrait également ouvrir un dossier contenant un fichier `xmcl.appinstaller` téléchargé. Vous pouvez double-cliquer manuellement sur ce fichier pour installer la mise à jour.

## D'autres mises à jour nécessitant une réinstallation

Cette situation ne nécessite pas réellement de backup, car seul `APPX` effacera les fichiers de données de XMCL. Bien sûr, vous pouvez sauvegarder une backup si vous le souhaitez, et les fichiers de données seront situés aux emplacements suivants :

::: code-group
```cmd [Windows]
%AppData%\xmcl
```
```sh [macOS]
~/Library/Application Support/xmcl
```
```sh [Linux]
~/.config/xmcl
```
:::

## La mise à jour d'une autre version a échoué

Il suffit de retélécharger le launcher...
34 changes: 34 additions & 0 deletions docs/fr/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
---
layout: home

hero:
name: Documentation XMCL
text: J'espère que vous trouverez les réponses à vos questions sur XMCL ici
tagline: Si vous ne pouvez pas... vous êtes plus que bienvenu d'envoyer des pull requests afin d'améliorer la documentation !
image:
src: /logo.png
alt: X Minecraft Launcher
actions:
- theme: brand
text: Guide d'Installation
link: /fr/guide/install
- theme: alt
text: Lien GitHub
link: https://github.com/voxelum/x-minecraft-launcher

features:
- icon: 📥
title: Guide d'Apparence XMCL
details: Comment embellir l'interface visuelle XMCL ?
link: /fr/guide/appearance
- icon: ⚡️
title: Protocole en ligne P2P expliqué
details: Le protocole P2P utilisé par XMCL sera introduit en détail.
link: /fr/protocol/p2p
- icon: 📚
title: Format des données stockées par XMCL
details: Comment XMCL stocke les données ?
link: /fr/guide/manage
---


109 changes: 109 additions & 0 deletions docs/fr/protocol/instance.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,109 @@
# Format de stockage des instances

> Rédaction en cours
XMCL, similaire à MultiMC, stocke des informations pour chaque instance.

Ces informations sont stockées dans le [répertoire de données XMCL](/fr/guide/manage#xmcl-cache-and-database)

<!-- ```bash
.
├─ instances
│ ├─ .vitepress
│ │ └─ config.js
│ ├─ api-examples.md
│ ├─ markdown-examples.md
│ └─ index.md
└─ package.json
``` -->

```sh
Répertoire de données XMCL
└─ 📜instances.json # Fichier de configuration d'instance globale
```

Ainsi que le [répertoire de données de jeu XMCL](/fr/guide/manage#minecraft-related-data)

```sh
Répertoire de données de jeu XMCL
└─📂instances # Contient des fichiers pour les instances
├─📂instance-a
│ └─ 📜instance.json # Fichier de configuration pour l'instance A
└─ 📂instance-b
└─ 📜instance.json # Fichier de configuration pour l'instance B
```

## Format du fichier de Configuration Globale

Ici, nous supposons que vos données XMCL sont stockées dans `/path/to/xmcl`.

```json5
{
// Ceci est la dernière instance sélectionnée. Le launcher sélectionnera celle-ci lors de son lancement.
"selectedInstance": "/chemin/vers/xmcl/instances/instance-a",
// Il s'agit d'une liste en cache de toutes les instances. Les chemins d'instances externes importés seront également stockés ici. Ils seront indisponibles si le launcher est supprimé.
"instances": [
"/path/to/xmcl/instances/instance-a",
"/path/to/xmcl/instances/instance-b",
// Instances externes
"/external/.minecraft"
]
}
```

## Fichier de configuration de l'instance

Supposons que vous en ayez créé un dans `/path/to/xmcl/instances/mc.hypixel.com`.

```json5
{
// C'est le nom affiché dans le launcher
"name": "mc.hypixel.com",
// Non implémenté actuellement. Définit la résolution du jeu d'instance
"resolution": { "width": 800, "height": 400, "fullscreen": false },
// Mémoire minimale
"minMemory": 0,
// Mémoire maximale
"maxMemory": 0,
// Paramètres de démarrage supplémentaires JVM
"vmOptions": [],
// Paramètres de démarrage supplémentaires MC
"mcOptions": [],
"url": "",
// URL de l'icône de l'instance
"icon": "",
// Indique si XMCL affichera une fenêtre de journal (log) après le lancement
"showLog": false,
// Indique s'il faut masquer le launcher après le lancement
"hideLauncher": true,
// Version requise pour l'instance, une chaîne de caractères vide représente non requis
"runtime": {
"minecraft": "1.16.3",
"forge": "",
"liteloader": "",
"fabricLoader": "",
"yarn": "",
"optifine": "",
"quiltLoader": ""
},
// Chemin Java, vide représente la détection automatique
"java": "",
// Version de lancement spécifiée manuellement, vide représente un calcul basé sur l'exécution
"version": "",
// Adresse du serveur, si présente le launcher se connectera directement à ce serveur
"server": { "host": "mc.hypixel.net", "port": 25565 },
// Auteur du modpack
"auteur": "ci010",
// Description
"description": "",
"lastAccessDate": 1661774086015,
"creationDate": 1602514422594,
"modpackVersion": "",
"fileApi": "",
"tags": [],
"assignMemory": false,
// S'il faut lancer rapidement
"fastLaunch": false
}

```
Loading

0 comments on commit 81c2424

Please sign in to comment.