Skip to content

Commit

Permalink
New translation guide & update Toha demo website french version (#282)
Browse files Browse the repository at this point in the history
* [create-pull-request] automated change

* Translate guides to french

* Translate guides to french

* Translate post in french

* Translate guides to french

* Initial translation to french

* Minor fix content

* Add Warning block to the content

* Add Warning block to the content

* Initial translation to french

* Fix internal french links

* Initial translation to french

* Initial translation in french

* Initial translation to french

* Translate post in french

* Replace Markdown Code in "Add Section Information"

* Update french translation and various fix

* Full alignment french post from last english post

* Minor update

* Initial translation in french

* Update index.fr.md

Add the translator to the front matter.

* Add minor fix

* Translate guide to french

* Update index.fr.md

Realign title of post and entry in the sidebar

* Minor fixes and add custom theme of mermaid

* Minor fixes and add custom theme of mermaid

* Minor fixes and add custom theme of mermaid

* [create-pull-request] automated change

* Deletion options block on gitGraph

* Initial translation in french

* Update french translation

* Initial translation to french

* Initial translation to french

* Update french translation

* Initial translation to french

* Initial translation to french

* Fix build due to incorrect image extension

Signed-off-by: hossainemruz <[email protected]>

* [create-pull-request] automated change

* Translate guide to french

* Update guide (minor fix)

* Translate guide to french

* Update guide (minor fix)

* Frontmatter fix  and update french translation

* Full realign with english version

* Full realign with english version

* Full realign with english version

* Fix title section in french

* Full realign with english version

* fix typo

* new fix typo

---------

Signed-off-by: hossainemruz <[email protected]>
Co-authored-by: niltied <[email protected]>
Co-authored-by: Emruz Hossain <[email protected]>
  • Loading branch information
3 people authored Mar 4, 2024
1 parent 0d60bc8 commit 0914716
Show file tree
Hide file tree
Showing 11 changed files with 242 additions and 64 deletions.
2 changes: 1 addition & 1 deletion assets/jsconfig.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"baseUrl": ".",
"paths": {
"*": [
"../../../../../../tmp/hugo_cache_runner/modules/filecache/modules/pkg/mod/github.com/hugo-toha/toha/[email protected].0/assets/*"
"../../../../../../tmp/hugo_cache_runner/modules/filecache/modules/pkg/mod/github.com/hugo-toha/toha/[email protected].1/assets/*"
]
}
}
Expand Down
138 changes: 138 additions & 0 deletions content/posts/contributing/index.fr.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,138 @@
---
title: "Comment contribuer ?"
date: 2024-01-19T02:30:00+06:00
description: Un guide sur comment contribuer à Toha
author:
name: Nicolas Dietlin
image: images/author/nicolas.jpg
menu:
sidebar:
name: Contribution
identifier: contributing
weight: 900
---

## Les manières de contribuer

Vous pouvez contribuer à ce thème de différentes manières.

### Code

Les Pull Requests sont les bienvenues et je serai heureux de les examiner. Suivez simplement les principes suivants:

- Gardez les simple.
- Gardez les cohérentes avec le design de l'UI.
- Utilisez le moins de dépendances possibles.
- Soyez patient.

### Tests et rapport des problèmes

- Vous pouvez signaler un [bug](https://github.com/hugo-toha/toha/issues/new?template=bug.md)
- Vous pouvez aussi faire une [demande de fonctionnalité](https://github.com/hugo-toha/toha/issues/new?template=feature_request.md)
- [Partager vos réflexions](https://github.com/hugo-toha/toha/issues/new?template=question.md)

### Documentation

Vous pouvez aussi contribuer à la documentation du thème par :

- L'ajout d'informations et de sections.
- Des corrections d'erreurs et de frappes.
- Des mises à jour de la documentation obsolète.
- La traduction de la documentation dans une nouvelle langue, ce [guide](/fr/posts/translation/content/) pourrait être utile.

### Traduction

Enfin, vous pouvez contribuer à la traduction du thème dans plusieurs langues, en complétant les mots manquants, ou par l'ajout d'une nouvelle langue. Vous pouvez suivre le guide [Comment ajouter un langage non supporté ?](/fr/posts/translation/new-language/) pour plus d'informations.

## Comment contribuer ?

Pour le développement local, vous pouvez apporter des changements dans le sous-module du thème et tester les changements sur votre propre site ou ce [site d'exemple](https://github.com/hugo-toha/hugo-toha.github.io) local.

### Cloner

D'abord, clonez [ce dépôt](https://github.com/hugo-toha/toha). Ensuite, suivre les étapes suivantes pour utiliser le thème cloné pour un développement local.

#### Lancer le thème cloné par rapport au site d'exemple

Si vous voulez vous lancer dans votre développement local par rapport au [site d'exemple](https://github.com/hugo-toha/hugo-toha.github.io), suivre les étapes suivantes:

```bash
# Se rendre dans le répertoire exampleSite
$ cd exampleSite
# installer les modules hugo
$ hugo mod tidy
# installer les dépendances
$ hugo mod npm pack
$ npm install
# Lancer le site exemple localement
$ hugo server -w
```

Maintenant, vous pouvez faire des changements dans le thème et ils seront immédiatement restitués sur le site en cours d'exécution. Si vous avez besoin de changer n'importe quelle configuration, vous pouvez faire cela dans le fichier `config.yaml` à l'intérieur du répertoire `exampleSite`. Si vous avez besoin d'ajouter n'importe quel contenu ou donnée, vous pouvez créer le dossier correspondant à l'intérieur du répertoire `exampleSite` et ajouter votre contenu ou donnée désirés.

#### Lancer le thème cloné par rapport à votre propre site

Si vous voulez exécuter votre développement local par rapport à votre propore site, suivez les étapes suivantes:

**Remplacer le module du thème:**

Ouvrez le fichier `go.mod` de votre site et remplacez le chemin `github.com/hugo-toha/toha/v4` par le chemin de votre dépôt cloné. Par exemple, si votre dépôt cloné est `github.com/<your-github-user>/toha`, alors remplacez le chemin `github.com/hugo-toha/toha/v4` par `github.com/<your-github-user>/toha/v4`.

```go
module github.com/hugo-toha/hugo-toha.github.io

go 1.19

require github.com/hugo-toha/toha/v4 v4.0.1-0.20231229170427-d3968ca711ef // indirect

replace(
github.com/hugo-toha/toha/v4 => github.com/<your-github-user>/toha/v4 <git branch>
)
```

Pour un développement intéractif, vous pouvez remplacer le thème par votre dépôt cloné. Par exemple, si vous avez cloné votre dépôt dans `/home/my-projects/toha`, alors remplacez le `github.com/hugo-toha/toha/v4` par `/home/my-projects/toha`.

```go
module github.com/hugo-toha/hugo-toha.github.io

go 1.19

require github.com/hugo-toha/toha/v4 v4.0.1-0.20231229170427-d3968ca711ef // indirect

replace(
github.com/hugo-toha/toha/v4 => /home/my-projects/toha
)
```

**Mise à jour des dépendances:**

```bash
# Mettre à jour les modules hugo
$ hugo mod tidy
# Installer les dépendances
$ hugo mod npm pack
$ npm install
```

**Lancez votre site en local:**

```bash
$ hugo server -w
```

A partir d'ici vous pouvez faire des changements au code source du thème tout en testant votre site Hugo en cours d'exécution ou le site d'exemple.

### Ouvrir une Pull Request

Lorsque les changements semblent corrects, validez et poussez-les vers votre dépôt cloné.

```bash
# Indexez tous les changements
$ git add .
# Validez vos changements avec un message complet sur ce que ça apporte
$ git commit -m "A meaningful commit message"
# Poussez le commit de votre branche
$ git push my-fork my-feature-branch
```

Ensuite, ouvrez une PR vers la branche `main` d'[hugo-toha/toha](https://github.com/hugo-toha/toha) depuis la branche `ma_branche_de_fonctionnalité` de votre dépôt cloné.
13 changes: 7 additions & 6 deletions content/posts/contributing/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,9 +21,9 @@ You can contribute to this theme in various ways.
Pull requests are most welcome and I will be happy to review. Just follow the following principles:

- Keep it simple.
- Keep it consistent with the design.
- Keep it consistent with the design of the UI.
- Use as few dependencies as possible.
- Have patience.
- Be patient.

### Testing and reporting issues

Expand All @@ -34,16 +34,17 @@ Pull requests are most welcome and I will be happy to review. Just follow the fo
### Documentation

You can also contribute to the theme documentation by:
- Adding information and sections
- Fixing errors and typos
- Updating obsolete documentation

- Adding information and sections.
- Fixing errors and typos.
- Updating obsolete documentation.
- Translating the documentation to a new language, [this](/posts/translation/content/) guide might be helpful.

### Translation

Finally, you can contribute to the translation of the theme to several languages, by completing missing words, or by adding a new language. You can follow the guide [How to add an unsupported language](/posts/translation/new-language/) for more information.

## How to contibute?
## How to contribute?

For local development, you can make changes in the theme submodule and test the changes against your own site or this [example site](https://github.com/hugo-toha/hugo-toha.github.io) locally.

Expand Down
1 change: 1 addition & 0 deletions content/posts/customizing/new-section/index.fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ Pour ajouter une nouvelle section à votre site, vous devez créer un fichier de
// Your custom HTML code here
</div>
```

### Etape 2: Ajouter des styles CSS

Si vous voulez ajouter un CSS personnalisé pour votre nouvelle section, vous pouvez le faire en ajouter le code CSS au fichier `assets/styles/overrides.scss` dans votre site. Ce fichier est automatiquement chargé par le thème et appliquera les styles personnalisés. Alternativement, vous pouvez créer un fichier SCSS séparé dans le répertoire `assets/styles` de votre dépôt et l'inclure dans le fichier `assets/styles/overrides.scss` en utilisant la syntaxe suivante:
Expand Down
68 changes: 45 additions & 23 deletions data/fr/sections/about.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -15,10 +15,11 @@ company:
url: "https://www.example.com"

# your resume. this file path should be relative to you "static" directory
resume: "files/resume.pdf"
# Dreprecated. Use resourceLinks instead.
# resume: "files/resume.pdf"

# a summary about you
summary: "Je suis un ingénieur en logiciel passionné, avec x années d'expérience professionnelle. J'ai construit des outils OSS pour [Kubernetes](https://kubernetes.io/) en utilisant GO. Mes outils aident les gens à déployer leurs charges de travail dans Kubernetes. Parfois, je travaille sur des projets amusants comme l'écriture d'un thème, etc."
summary: "Je suis un ingénieur logiciel passionné, avec x années d'expérience professionnelle. J'ai construit des outils OSS pour [Kubernetes](https://kubernetes.io/) en utilisant GO. Mes outils aident les gens à déployer leurs charges de travail dans Kubernetes. Parfois, je travaille sur des projets amusants comme l'écriture d'un thème, etc."

# your social links
# give as many as you want. use font-awesome for the icons.
Expand Down Expand Up @@ -47,32 +48,53 @@ socialLinks:
icon: "fab fa-facebook"
url: "#"

# your soft skills
# give the percentage between 50 to 100 with 5 intervals.
# currently supported colors: blue, yellow, pink, green, sky, orange
softSkills:
- name: Chef de projet
- name: Mastadon
icon: "fab fa-mastodon"
url: "#"
rel: "me noopener"

# You can put custom buttons to link your relevant resources.
# For example, you can put link for your resume.
resourceLinks:
- title: "My Resume"
url: "files/resume.pdf"

# Show your badges
# You can show your verifiable certificates from https://www.credly.com.
# You can also show a circular bar indicating the level of expertise on a certain skill
badges:
- type: certification
name: Certified Kubernetes Security Specialist
url: "https://www.credly.com/org/the-linux-foundation/badge/exam-developer-certified-kubernetes-security-specialist"
badge: "https://images.credly.com/size/680x680/images/f4bf92ed-8985-40b2-bc07-2f9308780854/kubernetes-security-specialist-logo-examdev.png"

- type: certification
name: Istio and IBM Cloud Kubernetes Service
url: "https://www.credly.com/org/the-linux-foundation/badge/exam-developer-certified-kubernetes-security-specialist"
badge: "https://images.credly.com/size/680x680/images/8d34d489-84bf-4861-a4a0-9e9d68318c5c/Beyond_basics_of_Istio_on_Cloud_v2.png"

- type: certification
name: Artificial Intelligence and Machine Learning
url: "https://www.credly.com/org/grupo-bancolombia/badge/artificial-intelligence-and-machine-learning"
badge: "https://images.credly.com/size/680x680/images/e027514f-9d07-4b29-862f-fe21a8aaebf1/ae.png"

- type: soft-skill-indicator
name: Leadership
percentage: 85
color: blue
- name: Travail d'équipe

- type: soft-skill-indicator
name: Team Work
percentage: 90
color: yellow
- name: Communication
percentage: 85
color: pink
- name: Persévérant
percentage: 85
color: green
- name: Autonome
percentage: 85
color: sky
- name: Logique

- type: soft-skill-indicator
name: Hard Working
percentage: 85
color: orange
# you can also provide color code instead of pre-defined color name
# - name: Example 1

# you can also provide color code instead of the color name
# - type: soft-skill-indicator
# name: Example 1
# percentage: 75
# color: "#00adb5"
# - name: Example 2
# percentage: 65
# color: "#8b8383"
24 changes: 12 additions & 12 deletions data/fr/sections/experiences.yaml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# section information
section:
name: Experiences
name: Expériences
id: experiences
enable: true
weight: 3
Expand All @@ -17,9 +17,9 @@ experiences:
location: Dhaka Branch
logo: /images/sections/experiences/company1.jpg
# company overview
overview: Example Co. est une entreprise largement reconnue pour le développement de l'utilisation des nuages. Elle construit des outils pour Kubernetes.
overview: Example Co. est une entreprise largement reconnue pour le développement cloud-native. Elle construit des outils pour Kubernetes.
positions:
- designation: Ingénieur logiciel senior
- designation: Ingénieur logiciel sénior
start: Nov 2019
# don't provide end date if you are currently working there. It will be replaced by "Present"
# end: Dec 2020
Expand All @@ -33,36 +33,36 @@ experiences:
start: Nov 2017
end: Oct 2019
responsibilities:
- Implémenter et tester la fonction xyz pour l'outil abc.
- Support client pour abc tool.
- Implémenter et tester la fonctionnalité xyz pour l'outil abc.
- Support client pour l'outil abc .
- Apprendre la technologie k,d,w pour xyz.

- company:
name: PreExample Co.
url: "https://example.com"
location: Nowhere
location: Quelque part
logo: /images/sections/experiences/company2.jpg
overview: PreExample Co. est une société passerelle pour entrer dans Example co. Donc, rien de spécial ici.
positions:
- designation: Ingénieur logiciel
start: Mars 2016
end: Mai 2017
responsibilities:
- Rédigez de nombreux exemples de codes.
- Ecrire de nombreux exemples de codes.
- Lire de nombreux exemples.
- Voir de nombreux exemples de vidéos.

- company:
name: Intern Counting Company (ICC).
url: "https://example.com"
location: Intern Land
location: Pays des stagiaires
logo: /images/sections/experiences/company3.jpg
overview: La Compagnie de comptage des stagiaires (ICC) est responsable du comptage des ingénieurs stagiaires du monde entier.
overview: La compagnie de comptage des stagiaires (ICC) est responsable du comptage des ingénieurs stagiaires du monde entier.
positions:
- designation: Stagiaire
start: Juin 2015
end: Jan 2016
responsibilities:
- Compte perdu des stagiaires.
- Comptez plus de stagiaires.
- Comptez-moi comme un stagiaire.
- Compte les stagiaires perdus.
- Compte plus de stagiaires.
- Me compte comme un stagiaire.
2 changes: 1 addition & 1 deletion data/fr/sections/recent-posts.yaml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# section information
section:
name: Posts recents
name: Billets récents
id: recent-posts
enable: true
weight: 5
Expand Down
Loading

0 comments on commit 0914716

Please sign in to comment.