Aller au contenu principal

Mode d'emploi FR

Traduire le site

Il y a plusieurs cas de figures. Dans tous les cas, il faut importer la bibliothèque correspondante:

/* to import translate and Translate */
import Translate, { translate } from '@docusaurus/Translate';

/* to import only translate */
import Translate from '@docusaurus/Translate';

/* to import only Translate */
import Translate from '@docusaurus/Translate';

Traduire directement du texte en HTML :

On ajoute directement la balise Translate :

<Translate
id="header.transation.id"
description="the header description"
>
This header will be translated
</Translate>

Traduire à l'intérieur d'une balise HTML :

<Button 
title='Semester Hinzufügen'
text="Neues Semester"
...

devient:

<Button
title={translate({
message : "blablab",
id:'...' ,
description:'...
})}
text={translate...}
...

Traduire dans un objet JS :

messages={{
next: translate({
message : "Nächste",
id:'calendar.button.nextWeek',
description:'button to show the next week on the calendar'
}),
...
}}

Traduire dans un objet Dicosaurus :

<TabItem
value='reviewed'
label={translate({
message: 'Review',
id: 'my-events.tab.review'
})}
>

Traduire avec un opérateur ternaire JS :

Avant:

title={store.fullscreen ? "Verlasse Vollbildschirm" : "Vollbildschirm"}

Après :

title={store.fullscreen ?
translate({
message : "Verlasse Vollbildschirm",
id : "shared.fullscreenbutton.exitfullscreen"
})
:
translate({
message : "Vollbildschirm",
id : "shared.fullscreenbutton.gofullscreen"
})
}

Autre exemple avec plusieurs imbrications :

text={showText 
? event.isDirty
? translate({
message : 'Verwerfen',
id : "components.event.actions.discard",
description : "Text of the button discard"
})
: translate({
message : 'Abbrechen',
id : "components.event.actions.cancel",
description : "Text of the button cancel"
})
: undefined
}

Traduire dans un objet JS avec variable

setErrorMessages([`Abteilung "${token.charAt(2)}" nicht gefunden`]);

devient :

setErrorMessages([
translate(
{
message : `Abteilung "{letter}" nicht gefunden`,
id : "share.audiencePicker.classSelector.errormsg.department",
description : "Error message department not found"
},

{letter : token.charAt(2)}
)
]);

et dans fr/code.json :

```tsx
"..."" : {
"message" : "Abteilung \"{letter}\" nicht gefunden",
"description" : "..."
}

Travailler sur une nouvelle branche sur le dépôt original

git clone git@github.com:lebalz/events-app.git events-app
cd events-app
git checkout -b "nom-de-la-nouvelle-branche"
# Maintenant sur la nouvelle branche
# travailler et faire des commits
# et lors du premier push
git push -u origin neuer-branch-name
# continuer à travailler...
# pour les push suivants :
git push

Continuer à travailler lorsque la branche a été fusionnée sur le dépôt original

# Revenir sur la branche principale
git checkout main
# Mettre la branche à jour
git pull
# Supprimer l'ancienne branche
git branch -d nom-ancienne-branche
# Supprimer la branche fusionnée également sur GitHub
# Créer une nouvelle branche pour un nouveau développement
git checkout -b "nom-de-la-nouvelle-branche"