From a3dd3cf54d7173be93852033c557a9faa13df93c Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 5 Nov 2023 13:54:43 +0100 Subject: [PATCH 01/35] Ajout du fichier index.fr.md --- content/posts/features/index.fr.md | 74 ++++++++++++++++++++++++++++++ 1 file changed, 74 insertions(+) create mode 100644 content/posts/features/index.fr.md diff --git a/content/posts/features/index.fr.md b/content/posts/features/index.fr.md new file mode 100644 index 00000000..e8699b96 --- /dev/null +++ b/content/posts/features/index.fr.md @@ -0,0 +1,74 @@ +--- +title: "Caractéristiques" +date: 2023-11-05T12:02:54+02:00 +description: Caractéristique du thème Hugo Toha +menu: + sidebar: + name: Caractéristiques + identifier: features + weight: 1 +--- + +[Test Link](/posts/getting-started/prepare-site/index.md) + +Ce thème a été conçu à partir d'un point de préférence personnel. En tant que développeur, je veux organiser mon portfolio de façon à ce qu'il reflète au mieux mes compétences. Donc, ce thème peut ou pas répondre à vos besoins, mais je serai heureux d'avoir vos commentaires. + +Ce billet vous donnera un aperçu des fonctionnalités intégrées à ce thème . + +### Design minimaliste + +Ce thème a été conçu pour être minimaliste et beau. Le schéma de couleur a été choisi pour être simple et puissant également. La page billet a été conçue pour être aussi distraillante que possible. Merci à [Anup Deb](https://dribbble.com/anupdeb) pour ses conseils en design. + +{{< img src="images/minimalist.png" width="900" align="center">}} + +{{< vs 3 >}} + +### Responsable + +Ce thème est totalement responsable. Il est beau et cohérent sur les ordinateurs de bureau, ordinateurs portables, Tablettes, et appareils Mobile. + +{{< img src="images/responsive.png" align="center" >}} + +{{< vs 3 >}} + +### Des cartes au design soigné + +Les cartes de compétence et de projet ont été soigneusement conçue pour donner les plus utiles informations. Elle donne également au spectacteur une idée de l'étendu des connaissances sur une compétence particulière. Les cartes de projets donnent une idée de la popularité de vos projets s'il s'agit de projets open source sur Github. + +{{< img src="images/cards.png" align="center" >}} + +{{< vs 3 >}} + +### Une chronologie de l'expérience qui représente vraiment vos expériences + +La chronologie de l'expérience a été conçue pour refléter votre parcours professionnel. Elle montre les responsabilités que vous avez assumées aux différentes étapes de votre carrière. + +{{< img src="images/experience-timeline.png" width="900" align="center" >}} + +{{< vs 3 >}} + +### Une galerie pour montrer vos réalisations + +La section galerie vous permet de montrer vos réalisations auprès du public. + +{{< img src="images/gallery.png" width="900" align="center" >}} + +{{< vs 3 >}} + +### Une barre latérale qui a du sens + +Vous êtes-vous déjà retrouvé à passer beaucoup de temps à retrouver un billet particulier sur un blog ? Je l'ai fait aussi. Ce thème comprend un menu en barre latérale qui classe vos billets dans différentes catégories et sous-catégories. + +{{< img src="images/sidebar.png" width="900" align="center" >}} + +{{< vs 3 >}} + +### Personnalisable & Extensible + +Il est facile de personnaliser ce thème sans changer ses codes. Il a été conçu pour être extensible et personnalisable. Vous pouvez facilement ajouter une nouvelle section ou remplacer le CSS de n'importe quelle section sans modifier le thème. + +Ca ne répond toujours pas à vos besoins ? Déposez une demande de fonctionnalité [ici](https://github.com/hossainemruz/toha). + +### Support multilingue + +Ce thème intègre le support de multiples langues. Vous pouvez traduire votre contenu dans de multiples langues facilement pour une meilleure accessibilité. \ No newline at end of file From 5ee3309b8f2e1d47d0259672954ddec05338d7a7 Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 5 Nov 2023 14:35:19 +0100 Subject: [PATCH 02/35] Delete test link --- content/posts/features/index.fr.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/content/posts/features/index.fr.md b/content/posts/features/index.fr.md index e8699b96..413062b7 100644 --- a/content/posts/features/index.fr.md +++ b/content/posts/features/index.fr.md @@ -9,8 +9,6 @@ menu: weight: 1 --- -[Test Link](/posts/getting-started/prepare-site/index.md) - Ce thème a été conçu à partir d'un point de préférence personnel. En tant que développeur, je veux organiser mon portfolio de façon à ce qu'il reflète au mieux mes compétences. Donc, ce thème peut ou pas répondre à vos besoins, mais je serai heureux d'avoir vos commentaires. Ce billet vous donnera un aperçu des fonctionnalités intégrées à ce thème . From 4a83cff878a5e0db5814fa044dca713a3a8aed96 Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 5 Nov 2023 14:35:34 +0100 Subject: [PATCH 03/35] Delete test link --- content/posts/shortcodes/index.fr.md | 133 +++++++++++++++++++++++++++ 1 file changed, 133 insertions(+) create mode 100644 content/posts/shortcodes/index.fr.md diff --git a/content/posts/shortcodes/index.fr.md b/content/posts/shortcodes/index.fr.md new file mode 100644 index 00000000..ced28079 --- /dev/null +++ b/content/posts/shortcodes/index.fr.md @@ -0,0 +1,133 @@ +--- +title: "Codes abrégés" +date: 2023-11-05T14:06:25+02:00 +description: "Codes abrégés" +menu: + sidebar: + name: "Code abrégés" + identifier: shortcodes + weight: 700 +hero: boat.jpg +--- +Ce billet échantillon est destiné à tester les éléments suivants : + +- Image de héros par défaut. +- Différents shortcodes. + +## Alerte + +Les alertes suivantes sont disponibles dans ce thème. + +{{< alert type="success" >}} +Voici une alerte avec `type="success"`. +{{< /alert >}} + +{{< alert type="danger" >}} +Voici une alerte avec `type="danger"`. +{{< /alert >}} + +{{< alert type="warning" >}} +Voici une alerte avec `type="warning"`. +{{< /alert >}} + +{{< alert type="info" >}} +Voici une alerte avec `type="info"`. +{{< /alert >}} + +{{< alert type="dark" >}} +Voici une alerte avec `type="dark"`. +{{< /alert >}} + +{{< alert type="primary" >}} +Voici une alerte avec `type="primary"`. +{{< /alert >}} + +{{< alert type="secondary" >}} +Voici une alerte avec `type="secondary"`. +{{< /alert >}} + +## Image + +#### Une image sans attributs. + +{{< img src="/posts/shortcodes/boat.jpg" title="A boat at the sea" >}} + +{{< vs 3 >}} + +#### Une image avec les attributs `height` et `width`. + +{{< img src="/posts/shortcodes/boat.jpg" height="400" width="600" title="A boat at the sea" >}} + +{{< vs 3 >}} + +#### Une image centrée avec les attributs `height` et `width`. + +{{< img src="/posts/shortcodes/boat.jpg" height="400" width="600" align="center" title="A boat at the sea" >}} + +{{< vs 3 >}} + +#### Une image avec l'attribut `float`. + +{{< img src="/posts/shortcodes/boat.jpg" height="200" width="500" float="right" title="A boat at the sea" >}} + +Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras egestas lectus sed leo ultricies ultricies. Praesent tellus risus, eleifend vel efficitur ac, venenatis sit amet sem. Ut ut egestas erat. Fusce ut leo turpis. Morbi consectetur sed lacus vitae vehicula. Cras gravida turpis id eleifend volutpat. Suspendisse nec ipsum eu erat finibus dictum. Morbi volutpat nulla purus, vel maximus ex molestie id. Nullam posuere est urna, at fringilla eros venenatis quis. + +Fusce vulputate dolor augue, ut porta sapien fringilla nec. Vivamus commodo erat felis, a sodales lectus finibus nec. In a pulvinar orci. Maecenas suscipit eget lorem non pretium. Nulla aliquam a augue nec blandit. Curabitur ac urna iaculis, ornare ligula nec, placerat nulla. Maecenas aliquam nisi vitae tempus vulputate. + +## Diviser + +Ce thème supporte le découpage de la page en autant de colonnes que vous le souhaitez. + +#### Diviser en 2 colonnes + +{{< split 6 6>}} + +##### Colonne de Gauche + +Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras egestas lectus sed leo ultricies ultricies. + +--- + +##### Colonne de Droite + +Fusce ut leo turpis. Morbi consectetur sed lacus vitae vehicula. Cras gravida turpis id eleifend volutpat. + +{{< /split >}} + +#### Diviser en 3 colonnes + +{{< split 4 4 4 >}} + +##### Colonne de Gauche + +Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras egestas lectus sed leo ultricies ultricies. + +--- + +##### Colonne du Milieu + +Aenean dignissim dictum ex. Donec a nunc vel nibh placerat interdum. + +--- + +##### Colonne de Droite + +Fusce ut leo turpis. Morbi consectetur sed lacus vitae vehicula. Cras gravida turpis id eleifend volutpat. + +{{< /split >}} + +## Espace vertical + +Donner un espace vertical entre deux lignes. + +Voici la ligne 1. +{{< vs 4>}} +Voici la ligne 2. Il devrait y avoir un espace vertical de `4rem` avec la ligne précédente. + +## Vidéo + +{{< video src="/videos/sample.mp4" >}} + + +Vidéo de [Rahul Sharma](https://www.pexels.com/@rahul-sharma-493988) sur [Pexels](https://www.pexels.com). + From 924073ae39fd35b3f06c8a771ec18b667148fcb4 Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 5 Nov 2023 14:44:35 +0100 Subject: [PATCH 04/35] Minor update --- content/posts/shortcodes/index.fr.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/content/posts/shortcodes/index.fr.md b/content/posts/shortcodes/index.fr.md index ced28079..c19f7808 100644 --- a/content/posts/shortcodes/index.fr.md +++ b/content/posts/shortcodes/index.fr.md @@ -11,7 +11,7 @@ hero: boat.jpg --- Ce billet échantillon est destiné à tester les éléments suivants : -- Image de héros par défaut. +- Manipulation d'une image. - Différents shortcodes. ## Alerte @@ -129,5 +129,4 @@ Voici la ligne 2. Il devrait y avoir un espace vertical de `4rem` avec la ligne {{< video src="/videos/sample.mp4" >}} -Vidéo de [Rahul Sharma](https://www.pexels.com/@rahul-sharma-493988) sur [Pexels](https://www.pexels.com). - +Vidéo de [Rahul Sharma](https://www.pexels.com/@rahul-sharma-493988) sur [Pexels](https://www.pexels.com). \ No newline at end of file From 898d9f7f654f3983fe1fd03a8f4df2e2dc66ffc7 Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 5 Nov 2023 14:45:23 +0100 Subject: [PATCH 05/35] Minor content update --- content/posts/shortcodes/index.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/posts/shortcodes/index.fr.md b/content/posts/shortcodes/index.fr.md index c19f7808..44504d51 100644 --- a/content/posts/shortcodes/index.fr.md +++ b/content/posts/shortcodes/index.fr.md @@ -4,7 +4,7 @@ date: 2023-11-05T14:06:25+02:00 description: "Codes abrégés" menu: sidebar: - name: "Code abrégés" + name: "Codes abrégés" identifier: shortcodes weight: 700 hero: boat.jpg From f9297cb825affe5c0279027e7e931b228c66d772 Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 5 Nov 2023 16:19:59 +0100 Subject: [PATCH 06/35] Traduction du README.md et du billet Quickstart --- README.md | 8 +- content/posts/quickstart/index.fr.md | 158 +++++++++++++++++++++++++++ 2 files changed, 165 insertions(+), 1 deletion(-) create mode 100644 content/posts/quickstart/index.fr.md diff --git a/README.md b/README.md index 49121fea..d9dd4e78 100644 --- a/README.md +++ b/README.md @@ -2,4 +2,10 @@ [![Netlify Status](https://api.netlify.com/api/v1/badges/3dac568a-bcdd-4b98-8a47-15ccf6dd8bd4/deploy-status)](https://app.netlify.com/sites/toha/deploys) ![Repository Size](https://img.shields.io/github/repo-size/hugo-toha/guides) ![Contributor](https://img.shields.io/github/contributors/hugo-toha/guides) ![Last Commit](https://img.shields.io/github/last-commit/hugo-toha/guides) ![Open Issues](https://img.shields.io/github/issues/hugo-toha/guides?color=important) ![Open Pull Requests](https://img.shields.io/github/issues-pr/hugo-toha/guides?color=yellowgreen) ![License](https://img.shields.io/github/license/hugo-toha/guides) ![Security Header](https://img.shields.io/security-headers?url=https%3A%2F%2Ftoha-guides.netlify.app) -Documentation site for Hugo theme [Toha](https://github.com/hugo-toha/toha). +La documentation pour le thème [Toha](https://github.com/hugo-toha/toha) pour hugo. + +## Les guides du thème Toha en langue française + +Ce dépôt est un fork du dépôt original de la documentation du thème Toha pour Hugo. Ce dépôt me sert de base de travail pour la traduction des billets en langue anglaise dans la langue française. Ils sont stockés dans le répertoire `content/posts`. + +Les articles déjà traduits en français sont présents dans les différents sous-répertoires et identifiables avec les caractères `fr` dans les noms des fichiers. \ No newline at end of file diff --git a/content/posts/quickstart/index.fr.md b/content/posts/quickstart/index.fr.md new file mode 100644 index 00000000..547a6362 --- /dev/null +++ b/content/posts/quickstart/index.fr.md @@ -0,0 +1,158 @@ +--- +title: "Démarrage rapide" +date: 2022-08-09T00:00:00+06:00 +description: "Guide de démarrage rapide pour le thème Toha" +menu: + sidebar: + name: "Démarrage rapide" + identifier: quickstart + weight: 2 +--- + +**Salutation !** Merci d'avoir décidé d'utiliser ce thème. Dans ce guide, Je vais vous montrer comment commencer rapidement avec ce thème. + +Ici, je vais supposer que vous voulez commencer un nouveau site Hugo en utilisant ce thème. Si vous utilisez déjà Hugo pour votre site, alors vous devez savoir comment utiliser un thème. Dans ce cas, veuillez suivre ce [dépôt échantillon](https://github.com/hugo-toha/hugo-toha.github.io) pour plus de détails. + +### Le nécessaire + +Pour exécuter ce thème localement, vous devez avoir les outils suivants installés. + +1. Hugo version `v0.118.x` (extended) ou plus. +2. Langage [Go](https://go.dev/doc/install) version `v1.18.x` or plus. +3. Node version `v18.x` et npm version `8.x` ou plus. + +Assurez-vous d'avoir les outils nécessaires dans les versions appropriées en utilisant les commandes suivantes. + +```bash +# Contrôle de la version de Hugo +➜ hugo version +hugo v0.118.2+extended linux/amd64 BuildDate=unknown + +# Contrôle de la version de Go +➜ go version +go version go1.19.4 linux/amd64 + +# Contrôle de la version de Node +➜ node -v +v18.12.1 + +# Contrôle de la version de NPM +➜ npm -v +8.19.2 +``` + +### Commencer + +Maintenant, revenons à notre mission. Suivez simplement les 5 étapes pour commencer avec votre site. + +#### Etape 1: Forker le dépôt d'exemple et renommer + +D'abord, **forkez** ce [dépôt échantillon](https://github.com/hugo-toha/hugo-toha.github.io) sur votre compte. Ensuite, renommez ce dépôt commme vous voulez. Si vous voulez utiliser les [Github Pages](https://pages.github.com/) pour déployer votre site, alors renommez le en `.github.io`. Ce dépôt échantillon fourni des Github Actions pré-configurés pour publier le site dans Github Pages et Netlify. + +#### Etape 2: Cloner le dépôt forké localement + +Lorsque vous avez forké et renommé votre dépôt d'échantillon, vous pouvez maintenant cloner le dépôt forké sur votre machine locale pour d'autres changements. + +```bash +git clone git@github.com:/ +``` + +#### Etape 3: Mettre à jour le fichier du module + +Vous devriez voir les fichiers `go.mod` et `go.sum` à la racine du dépôt. Mettez à jour la première ligne du fichier `go.mod` comme suit: +```bash +module github.com// +``` + +#### Etape 4: Modifier le fichier `config.yaml` + +Maintenant, ouvrez le dépôt dans un éditeur et modifiez les configurations dans votre fichier `config.yaml` situé à la racine de votre dépôt. + +##### Modifier le `baseURL` + +D'abord, modifiez le `baseURL` avec l'URL de votre site. Si vous voulez utilisez Github Pages pour héberger votre site, alors paramétrez comme suit: +```yaml +baseURL: https://.github.io +``` + +##### Modifier le `gitRepo` + +Maintenant, modifiez le `gitRepo` sous la section `params` pour pointer sur votre dépôt forké. Exemple, + +```yaml +gitRepo: https://github.com// +``` + +##### Désactiver l'analytique ou la configurer correctement + +Le dépôt d'échantillon fournit le service Google Analytics pre-configuré. L'identifiant analytics indique le site d'origine. Donc, soit vous désactivez les analyses ou bien vous les configurez correctement selon ce [guide](/posts/analytics/). + +Vous pouvez désactiver les analyses en paramètrant le champ suivant sous la section `params.features` : + +```yaml +analytics: + enabled: false +``` + +##### Désactiver la fonctionnalité de lettre d'information + +Le dépôt d'échantillon fournit un service de lettre d'information [mailchimp](https://mailchimp.com/) pré-configuré. Désactivez le en paramètrant le champ suivant sous la section `params.footer`. + +```yaml +newsletter: + enable: false +``` + +#### Step 5: Exécuter le site localement + +Maintenant, exécutez les commandes suivantes pour lancer votre site localement: + +a. Charger les modules Hugo + +```bash +hugo mod tidy +``` + +b. Installer les modules Node + +```bash +hugo mod npm pack +npm install +``` + +c. Exécuter le site + +```bash +hugo server -w +``` + +
+ +Si tout se passe bien, vous devriez voir une sortie similaire à ceci. +{{< img src="images/local_site.png" align="center" alt="Command to run site locally">}} + +Maintenant, allez sur [localhost:1313](http://localhost:1313/) dans votre navigateur et vous devriez voir vous site en cours d'exécution. + +#### Etape 6: Pousser les modifications sur Github + +Si vous êtes arrivé aussi loin, cela signifie que votre site s'exécute localement sans aucuns problèmes. Poussons ces modifications sur Github. + +```bash +# stage all the changes +git add . + +# commit the changes +git commit -m "Initial site setup" -s + +# push the changes to Github +git push origin HEAD +``` + +### Et ensuite ? + +- Personnaliser l'arrière-plan, le logo, et quelques autres choses de votre site en suivant [ce guide](/posts/configuration/site-parameters/). +- Ajouter des informations sur vous en suivant [ce guide](/posts/configuration/sections/about/). +- Ajouter les informations sur vos compétences en suivant [ce guide](/posts/configuration/sections/skills/). +- Ajouter les informations sur vos expériences en suivant [ce guide](/posts/configuration/sections/experiences). +- Déployer votre site sur Github Page en suivant le guide par [ici](/posts/getting-started/github-pages/). +- Déployer votre site sur Netlify en suivant le guide par [ici](/posts/getting-started/netlify/). \ No newline at end of file From 39be8ea763b45f481d36add3172b56377a8befe2 Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 5 Nov 2023 16:23:31 +0100 Subject: [PATCH 07/35] Correction mineure du billet Features --- content/posts/features/index.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/posts/features/index.fr.md b/content/posts/features/index.fr.md index 413062b7..1140a474 100644 --- a/content/posts/features/index.fr.md +++ b/content/posts/features/index.fr.md @@ -9,7 +9,7 @@ menu: weight: 1 --- -Ce thème a été conçu à partir d'un point de préférence personnel. En tant que développeur, je veux organiser mon portfolio de façon à ce qu'il reflète au mieux mes compétences. Donc, ce thème peut ou pas répondre à vos besoins, mais je serai heureux d'avoir vos commentaires. +Ce thème a été conçu à partir d'un point de préférence personnel. En tant que développeur, je veux organiser mon portfolio de façon à ce qu'il reflète au mieux mes compétences. Donc, ce thème peut ou non répondre à vos besoins, mais je serai heureux d'avoir vos commentaires. Ce billet vous donnera un aperçu des fonctionnalités intégrées à ce thème . From f58bf21f88df76e32ed164b9fbe7527f08d190b6 Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 5 Nov 2023 16:46:22 +0100 Subject: [PATCH 08/35] Correction mineure du billet Features --- content/posts/features/index.fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/posts/features/index.fr.md b/content/posts/features/index.fr.md index 1140a474..c3c1d419 100644 --- a/content/posts/features/index.fr.md +++ b/content/posts/features/index.fr.md @@ -11,7 +11,7 @@ menu: Ce thème a été conçu à partir d'un point de préférence personnel. En tant que développeur, je veux organiser mon portfolio de façon à ce qu'il reflète au mieux mes compétences. Donc, ce thème peut ou non répondre à vos besoins, mais je serai heureux d'avoir vos commentaires. -Ce billet vous donnera un aperçu des fonctionnalités intégrées à ce thème . +Ce billet vous donnera un aperçu des fonctionnalités intégrées à ce thème. ### Design minimaliste From 401d8ab7c8a4287cde5980dd217b24194d653cac Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 5 Nov 2023 16:46:47 +0100 Subject: [PATCH 09/35] =?UTF-8?q?R=C3=A9ecriture=20README.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index d9dd4e78..f1bf1207 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,17 @@ -# Toha Guides +# Les guides du thème Toha en langue française -[![Netlify Status](https://api.netlify.com/api/v1/badges/3dac568a-bcdd-4b98-8a47-15ccf6dd8bd4/deploy-status)](https://app.netlify.com/sites/toha/deploys) ![Repository Size](https://img.shields.io/github/repo-size/hugo-toha/guides) ![Contributor](https://img.shields.io/github/contributors/hugo-toha/guides) ![Last Commit](https://img.shields.io/github/last-commit/hugo-toha/guides) ![Open Issues](https://img.shields.io/github/issues/hugo-toha/guides?color=important) ![Open Pull Requests](https://img.shields.io/github/issues-pr/hugo-toha/guides?color=yellowgreen) ![License](https://img.shields.io/github/license/hugo-toha/guides) ![Security Header](https://img.shields.io/security-headers?url=https%3A%2F%2Ftoha-guides.netlify.app) +La documentation (VO) pour le thème [Toha](https://github.com/hugo-toha/toha) pour hugo. -La documentation pour le thème [Toha](https://github.com/hugo-toha/toha) pour hugo. +## Préambule -## Les guides du thème Toha en langue française +Ce dépôt est un fork du [dépôt original](https://github.com/hugo-toha/guides) de la documentation du thème Toha pour Hugo. Ce dépôt me sert de base de travail pour la traduction des billets en langue anglaise dans la langue française. **Je ne suis pas traducteur de métier, alors soyez indulgent avec mes traductions s'il vous plaît. Merci d'avance.** -Ce dépôt est un fork du dépôt original de la documentation du thème Toha pour Hugo. Ce dépôt me sert de base de travail pour la traduction des billets en langue anglaise dans la langue française. Ils sont stockés dans le répertoire `content/posts`. +Les articles français sont rangés dans le répertoire `content/posts` dans les différents sous-répertoires associés. Ils sont identifiables avec la chaine de caractères `fr` dans leurs noms de fichier. -Les articles déjà traduits en français sont présents dans les différents sous-répertoires et identifiables avec les caractères `fr` dans les noms des fichiers. \ No newline at end of file +## Les articles déjà traduits + +Au 05/11/2023, les billets intégralement traduits en français sont : + +- [x] Features/index.md +- [x] Quickstart/index.md +- [x] Shortcodes/index.md \ No newline at end of file From 08e68e6af22c1279ba8037bb410d498a46868b74 Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Mon, 6 Nov 2023 18:53:02 +0100 Subject: [PATCH 10/35] Ajout du fichier index.fr.md pour la traduction fr du billet support --- content/posts/supports/index.fr..md | 50 +++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 content/posts/supports/index.fr..md diff --git a/content/posts/supports/index.fr..md b/content/posts/supports/index.fr..md new file mode 100644 index 00000000..33c52771 --- /dev/null +++ b/content/posts/supports/index.fr..md @@ -0,0 +1,50 @@ +--- +title: "Supports Links" +date: 2022-03-14T06:00:23+06:00 +description: Adding support links in hugo theme Toha +menu: + sidebar: + name: Support Links + identifier: supports + weight: 660 +--- + +Ce thème supporte l'ajout de liens de soutien/donation sur votre site. Actuellement, les liens de soutien supportés sont: + +- [Ko-fi](https://ko-fi.com/) +- [Buy Me a Coffee](https://www.buymeacoffee.com/zicklam) + +## Ko-fi + +Vous pouvez ajouter votre button flottant ko-fi sur votre site web. Pour ajouter le button flottant, ajoutez une section `support` sous la section `params.features` dans votre fichier `config.yaml`: + +```yaml +params: + features: + support: + enabled: true + kofi: + user: + text: Tip Me + textColor: '#f9fafc' + backgroundColor: '#248aaa' +``` + +## Buy Me a Coffee + +Vous pouvez ajouter votre bouton flottant "Buy Me a Coffee" sur votre site web. Pour ajoutez une section `support` sous la section `params.features` dans votre fichier `config.yaml`: + +![bmacbutton](https://git-doc-files.s3.eu-central-1.amazonaws.com/github.com/hugo-toha/guides/buymeacoffe-button.png) +![bmacwidget](https://git-doc-files.s3.eu-central-1.amazonaws.com/github.com/hugo-toha/guides/buymeacoffe-widget.png) + +```yaml +params: + features: + support: + enabled: true + buymeacoffee: + user: + text: Support me on Buy me a coffee! + info: Buy me a coffee! + color: '#FFDD00' +``` \ No newline at end of file From 7d1a634015420cb19e43f9e41af9f54f53b4968e Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Mon, 6 Nov 2023 18:53:46 +0100 Subject: [PATCH 11/35] Ajout billet de support traduit --- README.md | 3 ++- content/posts/supports/index.md | 9 ++++----- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index f1bf1207..45fe12a3 100644 --- a/README.md +++ b/README.md @@ -14,4 +14,5 @@ Au 05/11/2023, les billets intégralement traduits en français sont : - [x] Features/index.md - [x] Quickstart/index.md -- [x] Shortcodes/index.md \ No newline at end of file +- [x] Shortcodes/index.md +- [x] Supports/_index.md \ No newline at end of file diff --git a/content/posts/supports/index.md b/content/posts/supports/index.md index a2fbe577..33c52771 100644 --- a/content/posts/supports/index.md +++ b/content/posts/supports/index.md @@ -9,14 +9,14 @@ menu: weight: 660 --- -This theme supports adding various support/donation links in your site. Currently, supported support links are: +Ce thème supporte l'ajout de liens de soutien/donation sur votre site. Actuellement, les liens de soutien supportés sont: - [Ko-fi](https://ko-fi.com/) - [Buy Me a Coffee](https://www.buymeacoffee.com/zicklam) ## Ko-fi -You can add your Ko-fi floating button in your website. To add the floating button, add the `support` section under `params.features` section of your sites `config.yaml` file: +Vous pouvez ajouter votre button flottant ko-fi sur votre site web. Pour ajouter le button flottant, ajoutez une section `support` sous la section `params.features` dans votre fichier `config.yaml`: ```yaml params: @@ -32,12 +32,11 @@ params: ## Buy Me a Coffee -You can add your "Buy Me a Coffee" floating button in your website. To add the floating button, add the `support` section under `params.features` section of your sites `config.yaml` file: +Vous pouvez ajouter votre bouton flottant "Buy Me a Coffee" sur votre site web. Pour ajoutez une section `support` sous la section `params.features` dans votre fichier `config.yaml`: ![bmacbutton](https://git-doc-files.s3.eu-central-1.amazonaws.com/github.com/hugo-toha/guides/buymeacoffe-button.png) ![bmacwidget](https://git-doc-files.s3.eu-central-1.amazonaws.com/github.com/hugo-toha/guides/buymeacoffe-widget.png) - ```yaml params: features: @@ -48,4 +47,4 @@ params: text: Support me on Buy me a coffee! info: Buy me a coffee! color: '#FFDD00' -``` +``` \ No newline at end of file From 38e38321790f2d790e4012430fa419a11dd2298f Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Mon, 6 Nov 2023 19:20:47 +0100 Subject: [PATCH 12/35] Renommage du fichier --- content/posts/supports/{index.fr..md => index.fr.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename content/posts/supports/{index.fr..md => index.fr.md} (100%) diff --git a/content/posts/supports/index.fr..md b/content/posts/supports/index.fr.md similarity index 100% rename from content/posts/supports/index.fr..md rename to content/posts/supports/index.fr.md From 22f48c184615dab8118c327c1028042f14616e78 Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Mon, 6 Nov 2023 19:26:20 +0100 Subject: [PATCH 13/35] MAJ mineure --- README.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 45fe12a3..8113ccce 100644 --- a/README.md +++ b/README.md @@ -10,9 +10,15 @@ Les articles français sont rangés dans le répertoire `content/posts` dans les ## Les articles déjà traduits -Au 05/11/2023, les billets intégralement traduits en français sont : +Au 06/11/2023, les billets intégralement traduits en français sont : - [x] Features/index.md - [x] Quickstart/index.md - [x] Shortcodes/index.md -- [x] Supports/_index.md \ No newline at end of file +- [x] Supports/index.md +- [ ] Getting-started/prepare-site/index.md +- [ ] Getting-started/github_pages/index.md +- [ ] Getting-started/netlify/index.md +- [ ] Getting-started/theme-update/index.md +- [ ] Configuration/site-parameters/index.md +- [ ] Configuration/sections/about/index.md \ No newline at end of file From 89eb1db46f19a903371a5ddeb2cab7a197a79cf1 Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Tue, 7 Nov 2023 23:02:25 +0100 Subject: [PATCH 14/35] MAJ de la traduction prepare your site --- .../getting-started/prepare-site/index.fr.md | 429 ++++++++++++++++++ 1 file changed, 429 insertions(+) create mode 100644 content/posts/getting-started/prepare-site/index.fr.md diff --git a/content/posts/getting-started/prepare-site/index.fr.md b/content/posts/getting-started/prepare-site/index.fr.md new file mode 100644 index 00000000..6e76224e --- /dev/null +++ b/content/posts/getting-started/prepare-site/index.fr.md @@ -0,0 +1,429 @@ +--- +title: "Préparer Votre Site" +date: 2023-11-06T21:44:20+02:00 +menu: + sidebar: + name: Prepare Site + identifier: getting-started-prepare-site + parent: getting-started + weight: 10 +--- + + +{{< alert type="danger" >}} +This doc is outdated. For up-to-date examples, please follow this sample [repo](https://github.com/hugo-toha/hugo-toha.github.io). +{{< /alert >}} + +Dans ce billet, nous allons créer un site hugo de zéro. Alors, nous le configurerons avec le thème `toha`, le rendre multilingue, ajouter quelques exemples de billets. A la fin de ce billet, vous devriez être capable d'exécuter pleinement un site Hugo avec le thème `Toha` localement. + +Si vous voulez un démarrage de la tête, vous pouvez juste forker le dépôt [hugo-toha/hugo-toha.github.io](https://github.com/hugo-toha/hugo-toha.github.io), renommez le et mettez le à jour avec vos propres données. Ce dépôt a déjà été configuré pour déployer sur [Github Pages](https://pages.github.com/) et [Netlify](https://www.netlify.com/). + +Si vous avez déjà un site hugo, sautez à la section [Ajouter un theme](#add-theme) + +### Créer un dépôt + +D'abord, créez un dépôt sur Github. Si vous voulez déployer ce site dans Github Pages, votre dépôt devrait être nommé `.github.io`. Clonez le dépôt dans votre machine locale et naviguez dedans. + +### Créer un site + +Maintenant, assurez-vous d'avoir [Hugo](https://gohugo.io/getting-started/installing/) installé. Ce thème devrait fonctionner avec hugo version `v0.68.0` et plus. Maintenant, lancez la commande suivante depuis la racine de votre dépôt pour initier un site web hugo. + +```console +$ hugo new site ./ -f=yaml --force +``` + +Cette commande créera une structure de base d'un site hugo. Ici, le flag `-f=yaml` indique à hugo de créer un fichier de configuration au format YAML et le flag `--force` force hugo à créer un site même si le répertoire cible n'est pas vide. + +### Initialiser le dépôt git + +Maintenant, il est temps d'ajouter git à votre site web. Initialisez le dépôt git en utilisant la commande suivante : + +``` +$ git init +``` + +### Ajouter un thème + +Maintenant, il est temps d'ajouter un thème dans votre site. Ajoutez le thème Toha comme un sous-module git de votre dépôt en utilisant la commande suivante: + +```console +$ git submodule add https://github.com/hugo-toha/toha.git themes/toha +``` + +{{< vs 1 >}} + +>N'utilisez pas l'URL SSH du thème durant son ajout en tant que sous-module git. Aussi, ne clonez pas le thème dans votre répertoire `themes` en utilisant `git clone`. Sinon, nous ne pourrons pas automatiser la publication du site en utilisant Github Action ou Netlify. + +### Lancer le site localement + +Maintenant, vous pouvez déjà exécuter votre site localement. Observons le site en mode veille en utilisant la commande suivante: + +```console +$ hugo server -t toha -w +``` + +Si vous naviguez sur `http://localhost:1313`, vous devriez voir un site de base avec le thème Toha. Dans la section suivante, nous allons configurer le site pour ressembler au [hugo-toha.github.io](https://hugo-toha.github.io/). Comme nous avons exécuté le serveur en mode veille, tous les changements que nous feront au site seront instantanément visibles dans le navigateur. + +### Configurer le site + +Maintenant, nous sommes prêt à configurer notre site. Dans cette section, nous allons ajouter les informations de l'auteur, différentes sections, et des echantillon de billets etc. + +#### Mise à jour du `config.yaml` + +Quand vous avez créé le site en utilisant la commande `hugo new site`, il a créé un fichier `config.yaml` à la racine de votre dépôt. Remplacer le contenu par défaut du fichier `config.yaml` avec ce qui suit: + +```yaml +baseURL: https://hugo-toha.github.io + +languageCode: en-us +title: "John's Blog" +theme: "toha" + +# Manage languages +# For any more details, you can check the official documentation: https://gohugo.io/content-management/multilingual/ +languages: + en: + languageName: English + weight: 1 + +# Control TOC depth +markup: + tableOfContents: + startLevel: 2 + endLevel: 6 + ordered: false + +# Enable global emoji support +enableEmoji: true + +# Site parameters +params: + # GitHub repo URL of your site + gitRepo: https://github.com/hugo-toha/hugo-toha.github.io + + # specify whether you want to write some blog posts or not + enableBlogPost: true + + # specify whether you want to show Table of Contents in reading page + enableTOC: true + + # Provide newsletter configuration. This feature hasn't been implemented yet. + # Currently, you can just hide it from the footer. + newsletter: + enable: true +``` + +Ici, vous voyez une configuration de base pour le thème Toha. Vous pouvez voir le fichier de configuration utilisé dans le formulaire du site d'exemple [ici](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/config.yaml). Pour des options de configurations plus détaillées, s'il vous plaît consulter [ce billet](https://toha-guides.netlify.app/posts/configuration/site-parameters/). + +#### Ajouter de données + +La plupart des contenus de ce thème sont pilotés par quelques fichiers YAML dans le répertoire `data`. Dans cette section, nous allons ajouter quelques échantillons de données. Puisque nous sommes en train de bâtir un site multilingue, noujs allons garder séparer les données de chaque langue dans leur propre répertoire local. + +D'abord, créons le répertoire `en` dans votre répertoire `data`. Ici, nous sommes en train d'ajouter des données pour la langue `anglaise`. + +##### Site Information + +Maintenant, créons un fichier `site.yaml` dans le répertoire `/data/en/` de votre dépôt. Ajoutons-y le contenu suivant: + +```yaml +# Copyright Notice +copyright: © 2020 Copyright. + +# Meta description de votre site. Ca aidera les moteurs de recherche à retrouver votre site. +description: Portfolio and personal blog of John Doe. +``` +Pour voir toutes les options disponibles pour les informations du site, consulter [cet extrait de fichier](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/site.yaml). + +##### Author Information + +Maintenant, créons un fichier `author.yaml` dans le répertoire `data/en` et ajoutez vos informations comme suit: + +```yaml +# Quelques informations à propos de vous. +name: "John Doe" +nickname: "John" +# Le message de salutation avant votre nom. Par défaut, ce sera "Hi, I am" s'il n'est pas fournit. +greeting: "Hi, I am" +image: "images/author/john.png" +# Donner vos informations de contact. Elles seront affichées dans le pied de page. +contactInfo: + email: "johndoe@example.com" + phone: "+0123456789" + stack-overflow: + icon: stack-overflow + url: "https://stackoverflow.com/users/1/exampleUser" + text: "ExampleUser" + +# Un résumé de ce que vous faites +summary: + - I am a Developer + - I am a Devops + - I love servers + - I work on open-source projects + - I love to work with some fun projects +``` + +##### Ajouter des sections + +Maintenant, nous allons ajouter différentes section dans notre page d'accueil. D'abord, créons un répertoire `sections` à l'intérieur de votre répertoire `data/en`. Ici, nous allons ajouter quelques sections avec des configurations minimales. Pour voir les options détaillées de configuration pour les sections, veuillez consulter [ici](https://toha-guides.netlify.app/posts/configuration/sections/). + +###### La section A propos + +Créons un fichier `about.yaml` dans votre répertoire `/data/en/sections`. Puis ajoutez le contenu suivant: + +```yaml +# section information +section: + name: About + id: about + enable: true + weight: 1 + showOnNavbar: true + template: sections/about.html + +# votre designation +designation: Software Engineer +# Les informations de votre société +company: + name: Example Co. + url: "https://www.example.com" + +# Votre Curriculum Vitae. Le chemin de ce fichier doit être relatif vers le répertoire "static" +resume: "files/resume.pdf" + +# Un résumé sur vous. +summary: 'I am a passionate software engineer with x years of working experience. I built OSS tools for [Kubernetes](https://kubernetes.io/) using GO. My tools help people to deploy their workloads in Kubernetes. Sometimes, I work on some fun projects such as writing a theme, etc.' + +# Vos liens sur les réseaux sociaux +# Mettez-en autant que vous voulez. Utilisez use font-awesome for the icons +socialLinks: +- name: Github + icon: "fab fa-github" + url: "https://www.github.com/example" + +# Vos compétences génériques. +# Donnez un pourcentage entre 50 et 100 avec des intervalles de 5 +# Les couleurs actuellement supportées : blue (bleu), yellow (jaune), pink (rose), green (vert), sky (ciel), orange (orange) +softSkills: +- name: Leadership + percentage: 85 + color: blue +- name: Team Work + percentage: 90 + color: yellow +``` +Mettre le fichier `resume.pdf` dans le répertoire `/static/files`. Vous pouvez trouver le fichier `about.yaml` utilisé dans le site exemple depuis [ici](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/sections/about.yaml). + +###### Section Compétences + +Créons un fichier `skills.yaml` dans votre répertoire `/data/en/sections`. Puis ajoutez le contenu suivant: + +```yaml +# section information +section: + name: Skills + id: skills + enable: true + weight: 2 + showOnNavbar: true + # En option : Possibilité de masquer le titre dans les sections + # hideTitle: true + +# Vos compétences +# Donnez un bref résumé pour chaque compétence dans le champ summary +skills: +- name: Kubernetes + logo: "/images/sections/skills/kubernetes.png" + summary: "Capable of deploying, managing application on Kubernetes. Experienced in writing Kubernetes controllers for CRDs." + url: "https://kubernetes.io/" + +- name: Go Development + logo: "/images/sections/skills/go.png" + summary: "Using as the main language for professional development. Capable of writing scalable, testable, and maintainable program." + url: "https://golang.org/" + +- name: Cloud Computing + logo: "/images/sections/skills/cloud.png" + summary: "Worked with most of the major clouds such as GCP, AWS, Azure etc." +``` + +Mettez vos images de compétences dans le répertoire `images/sections/skills` de votre dépôt. Vous trouverez les images [ici](https://github.com/hugo-toha/hugo-toha.github.io/tree/source/assets/images/sections/skills). Vous pouvez également trouver le fichier `skills.yaml` utilisé dans le site exemple par [là](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/sections/skills.yaml). + +###### Section Expériences + +Créons un fichier `experiences.yaml` dans votre répertoire `/data/en/sections`. Puis ajoutez le contenu suivant: + +```yaml +# section information +section: + name: Experiences + id: experiences + enable: true + weight: 3 + showOnNavbar: true + # En option : Possibilité de masquer le titre dans les sections + # hideTitle: true + +# Vos expériences +experiences: +- company: + name: Example Co. + url: "https://www.example.com" + location: Dhaka Branch + # company overview + overview: Example Co. is a widely recognized company for cloud-native development. It builds tools for Kubernetes. + positions: + - designation: Senior Software Engineer + start: Nov 2019 + # Si vous êtes toujours en poste, n'indiquez pas de date de fin. Ce sera remplacé par "Aujourd'hui" + # end: Dec 2020 + # Indiquez quelques éléments à propos de vos responsabilités au sein de l'entreprise. + responsibilities: + - Design and develop XYZ tool for ABC task + - Design, develop and manage disaster recovery tool [Xtool](https://www.example.com) that backup Kubernetes volumes, databases, and cluster's resource definition. + - Lead backend team. + +- company: + name: PreExample Co. + url: "https://example.com" + location: Nowhere + overview: PreExample Co. is a gateway company to enter into Example co. So, nothing special here. + positions: + - designation: Software Engineer + start: March 2016 + end: May 2017 + responsibilities: + - Write lots of example codes. + - Read lots of examples. + - See lots of example videos. +``` + +Vous pouvez trouver le fichier `experiences.yaml` utilisé dans le site exemple par [ici](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/sections/experiences.yaml). + +###### Section Projets + +Créons un fichier `projects.yaml` dans votre répertoire `/data/en/sections`. Puis ajoutez le contenu suivant: + +```yaml +# section information +section: + name: Projects + id: projects + enable: true + weight: 4 + showOnNavbar: true + # En option : Possibilité de masquer le titre dans les sections + # hideTitle: true + +# buttons de filtrage +buttons: +- name: All + filter: "all" +- name: Professional + filter: "professional" +- name: Academic + filter: "academic" +- name: Hobby + filter: "hobby" + +# vos projets +projects: +- name: Kubernetes + logo: /images/sections/projects/kubernetes.png + role: Contributor + timeline: "March 2018 - Present" + repo: https://github.com/kubernetes/kubernetes # Si votre projet est un dépôt public sur GitHub, alors fournissez le lien. Ca affichera le compteur d'étoile. + #url: "" # Si votre projet n'est pas public mais il a un site web or quelques urls externes, alors fournissez les ici. Ne fournissez pas "repo" et "url" simultanément. + summary: Production-Grade Container Scheduling and Management. + tags: ["professional", "kubernetes", "cloud"] + +- name: Tensorflow + logo: /images/sections/projects/tensorflow.png + role: Developer + timeline: "Jun 2018 - Present" + repo: https://github.com/tensorflow/tensorflow + #url: "" + summary: An Open Source Machine Learning Framework for Everyone. + tags: ["professional", "machine-learning","academic"] + +- name: Toha + logo: /images/sections/projects/toha.png + role: Owner + timeline: "Jun 2019 - Present" + repo: https://github.com/hossainemruz/toha + summary: A Hugo theme for personal portfolio. + tags: ["hobby","hugo","theme","professional"] +``` +Mettez les images des projets dans le répertoire `images/sections/projects/`. Vous trouverez les images [ici](https://github.com/hugo-toha/hugo-toha.github.io/tree/source/assets/images/sections/projects). Vous pouvez également trouver le fichier `projects.yaml` utilisé dans le site exemple par [là](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/sections/projects.yaml). + +###### Recent Posts Section + +Créons le fichier `recent-posts.yaml` dans votre répertoire `/data/en/sections/`. Puis ajoutez le contenu suivant: + +```yaml +# section information +section: + name: Recent Posts + id: recent-posts + enable: true + weight: 5 + showOnNavbar: true +``` + +Vous pouvez trouver le fichier `recent-posts.yaml` utilisé dans le site d'exemple [ici](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/sections/recent-posts.yaml). + +> Cette section sera vide jusqu'à ce que vous ajoutiez quelques billets dans votre site. + +###### Section Réalisation + +Créons un fichier `achievements.yaml` dans votre répertoire `/data/en/sections/`. Puis ajoutez le contenu suivant: + +```yaml +# section information +section: + name: Achievements + id: achievements + enable: true + weight: 6 + showOnNavbar: true + # En option : Possibilité de masquer le titre dans les sections + # hideTitle: true + +# Vos réalisations +achievements: +- title: Best Presenter + image: /images/sections/achievements/presenter.jpg + summary: Best presenter in the 2020 XYZ conference. +- title: Champion + image: /images/sections/achievements/sport.jpg + summary: Champion in cycling inter-city cycling championship 2020. +- title: Graduation + image: /images/sections/achievements/graduation-cap.jpg + summary: Received Bachelor of Science (B.Sc.) in Computer Science and Engineer from XYZ University. +- title: Award Winner + image: /images/sections/achievements/woman-winner.jpg + summary: Wined best paper award at IEE Conference 2020. +``` +Mettez les images des projets dans le répertoire `images/sections/achievements/`. Vous trouverez les images [ici](https://github.com/hugo-toha/hugo-toha.github.io/tree/source/assets/images/sections/achievements). Vous pouvez également trouver le fichier `achievements.yaml` utilisé dans le site exemple par [là](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/sections/achievements.yaml). + +#### Add Posts + +Now, we are ready add our first post into our site. Here, we are going to add this [introduction post](https://hugo-toha.github.io/posts/introduction/). + +- At first, create a `posts` folder inside `content` directory of your site. +- Then, create `_index.md` file inside the `posts` directory. Copy the content of [this file](https://raw.githubusercontent.com/hugo-toha/hugo-toha.github.io/source/content/posts/_index.md) file and paste into the newly created `_index.md` file. +- Create `introduction` folder inside your `posts` directory. +- Add the following [hero.svg](https://raw.githubusercontent.com/hugo-toha/hugo-toha.github.io/source/content/posts/introduction/hero.svg) inside your `introduction` folder. +- Now, create `index.md` file inside the `introduction` folder. This `index.md` file will hold the post contents. +- Add the following [sample contents](https://raw.githubusercontent.com/hugo-toha/hugo-toha.github.io/source/content/posts/introduction/index.md) in the newly created `index.md` file. + +Now, your post should appear at `http://localhost:1313/posts` and your `Recent Posts` section also should show this post card. For translating a post, just create a new file with name `index..md` in the same directory. Then, add the translated content there. + +For more sample posts, please visit [here](https://github.com/hugo-toha/hugo-toha.github.io/tree/source/content/posts). + +### What Next + +At this point, your site should look similar to the [example site](https://hugo-toha.github.io/). Now, it's time to deploy your site. You can follow the following deployments guides: + +- [Deploy in Github Pages](https://toha-guides.netlify.app/posts/getting-started/github-pages/) +- [Deploy in Netlify](https://toha-guides.netlify.app/posts/getting-started/netlify/) From 0531107155afd6dbaf162561c987fbcbbd6312d8 Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sat, 11 Nov 2023 10:52:56 +0100 Subject: [PATCH 15/35] =?UTF-8?q?Traduction=20FR=20suppl=C3=A9mentaire?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../getting-started/prepare-site/index.fr.md | 165 +++++++++++++----- 1 file changed, 121 insertions(+), 44 deletions(-) diff --git a/content/posts/getting-started/prepare-site/index.fr.md b/content/posts/getting-started/prepare-site/index.fr.md index 6e76224e..65045845 100644 --- a/content/posts/getting-started/prepare-site/index.fr.md +++ b/content/posts/getting-started/prepare-site/index.fr.md @@ -9,12 +9,7 @@ menu: weight: 10 --- - -{{< alert type="danger" >}} -This doc is outdated. For up-to-date examples, please follow this sample [repo](https://github.com/hugo-toha/hugo-toha.github.io). -{{< /alert >}} - -Dans ce billet, nous allons créer un site hugo de zéro. Alors, nous le configurerons avec le thème `toha`, le rendre multilingue, ajouter quelques exemples de billets. A la fin de ce billet, vous devriez être capable d'exécuter pleinement un site Hugo avec le thème `Toha` localement. +Dans ce billet, nous allons créer un site hugo de zéro. Nous le configurerons avec le thème `toha`, le rendre multilingue, ajouter quelques exemples de billets. A la fin de ce billet, vous devriez être capable d'exécuter pleinement un site Hugo avec le thème `Toha` localement. Si vous voulez un démarrage de la tête, vous pouvez juste forker le dépôt [hugo-toha/hugo-toha.github.io](https://github.com/hugo-toha/hugo-toha.github.io), renommez le et mettez le à jour avec vos propres données. Ce dépôt a déjà été configuré pour déployer sur [Github Pages](https://pages.github.com/) et [Netlify](https://www.netlify.com/). @@ -26,7 +21,7 @@ D'abord, créez un dépôt sur Github. Si vous voulez déployer ce site dans Git ### Créer un site -Maintenant, assurez-vous d'avoir [Hugo](https://gohugo.io/getting-started/installing/) installé. Ce thème devrait fonctionner avec hugo version `v0.68.0` et plus. Maintenant, lancez la commande suivante depuis la racine de votre dépôt pour initier un site web hugo. +Maintenant, assurez-vous d'avoir [Hugo](https://gohugo.io/getting-started/installing/) installé. Ce thème devrait fonctionner avec hugo version `v0.111.0` et plus. Maintenant, lancez la commande suivante depuis la racine de votre dépôt pour initier un site web hugo. ```console $ hugo new site ./ -f=yaml --force @@ -77,7 +72,20 @@ baseURL: https://hugo-toha.github.io languageCode: en-us title: "John's Blog" -theme: "toha" + +# Use Hugo modules to add theme +module: + imports: + - path: github.com/hugo-toha/toha/v4 + mounts: + - source: static/files + target: static/files + - source: ./node_modules/flag-icon-css/flags + target: static/flags + - source: ./node_modules/@fontsource/mulish/files + target: static/files + - source: ./node_modules/katex/dist/fonts + target: static/fonts # Manage languages # For any more details, you can check the official documentation: https://gohugo.io/content-management/multilingual/ @@ -85,14 +93,31 @@ languages: en: languageName: English weight: 1 + fr: + languageName: Français + weight: 2 -# Control TOC depth +# Force a locale to be use, really useful to develop the application ! Should be commented in production, the "weight" should rocks. +# DefaultContentLanguage: bn + +# Allow raw html in markdown file markup: + goldmark: + renderer: + unsafe: true tableOfContents: startLevel: 2 endLevel: 6 ordered: false +# At least HTML and JSON are required for the main HTML content and +# client-side JavaScript search +outputs: + home: + - HTML + - RSS + - JSON + # Enable global emoji support enableEmoji: true @@ -117,13 +142,13 @@ Ici, vous voyez une configuration de base pour le thème Toha. Vous pouvez voir #### Ajouter de données -La plupart des contenus de ce thème sont pilotés par quelques fichiers YAML dans le répertoire `data`. Dans cette section, nous allons ajouter quelques échantillons de données. Puisque nous sommes en train de bâtir un site multilingue, noujs allons garder séparer les données de chaque langue dans leur propre répertoire local. +La plupart des contenus de ce thème sont pilotés par quelques fichiers YAML dans le répertoire `data`. Dans cette section, nous allons ajouter quelques échantillons de données. Puisque nous sommes en train de bâtir un site multilingue, nous allons séparer les données de chaque langue dans leur propre répertoire local. -D'abord, créons le répertoire `en` dans votre répertoire `data`. Ici, nous sommes en train d'ajouter des données pour la langue `anglaise`. +D'abord, créez le répertoire `en` dans votre répertoire `data`. Ici, nous sommes en train d'ajouter des données pour la langue `anglaise`. ##### Site Information -Maintenant, créons un fichier `site.yaml` dans le répertoire `/data/en/` de votre dépôt. Ajoutons-y le contenu suivant: +Maintenant, créez un fichier `site.yaml` dans le répertoire `/data/en/` de votre dépôt. Ajoutez-y le contenu suivant: ```yaml # Copyright Notice @@ -134,9 +159,9 @@ description: Portfolio and personal blog of John Doe. ``` Pour voir toutes les options disponibles pour les informations du site, consulter [cet extrait de fichier](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/site.yaml). -##### Author Information +##### Auteur Information -Maintenant, créons un fichier `author.yaml` dans le répertoire `data/en` et ajoutez vos informations comme suit: +Maintenant, créez un fichier `author.yaml` dans le répertoire `data/en` et ajoutez vos informations comme suit: ```yaml # Quelques informations à propos de vous. @@ -197,20 +222,69 @@ summary: 'I am a passionate software engineer with x years of working experience # Vos liens sur les réseaux sociaux # Mettez-en autant que vous voulez. Utilisez use font-awesome for the icons socialLinks: +- name: Email + icon: "fas fa-envelope" + url: "example@gmail.com" + - name: Github icon: "fab fa-github" url: "https://www.github.com/example" -# Vos compétences génériques. -# Donnez un pourcentage entre 50 et 100 avec des intervalles de 5 -# Les couleurs actuellement supportées : blue (bleu), yellow (jaune), pink (rose), green (vert), sky (ciel), orange (orange) -softSkills: -- name: Leadership +- name: Stackoverflow + icon: "fab fa-stack-overflow" + url: "#" + +- name: LinkedIn + icon: "fab fa-linkedin" + url: "#" + +- name: Twitter + icon: "fab fa-twitter" + url: "#" + +- name: Facebook + icon: "fab fa-facebook" + url: "#" + +# Affichez vos badges +# Vous pouvez montrer vos certifications depuis https://www.credly.com +# Vous pouvez aussi afficher des barres circulaire indiquant le niveau d'expertise de certaines compétences +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: Team Work + +- type: soft-skill-indicator + name: Team Work percentage: 90 color: yellow + +- type: soft-skill-indicator + name: Hard Working + percentage: 85 + color: orange + +# Vous pouvez aussi fournir un code couleur à la place d'un nom de couleur +# - type: soft-skill-indicator +# name: Example 1 +# percentage: 75 +# color: "#00adb5" ``` Mettre le fichier `resume.pdf` dans le répertoire `/static/files`. Vous pouvez trouver le fichier `about.yaml` utilisé dans le site exemple depuis [ici](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/sections/about.yaml). @@ -251,7 +325,7 @@ Mettez vos images de compétences dans le répertoire `images/sections/skills` d ###### Section Expériences -Créons un fichier `experiences.yaml` dans votre répertoire `/data/en/sections`. Puis ajoutez le contenu suivant: +Créez un fichier `experiences.yaml` dans votre répertoire `/data/en/sections`. Puis ajoutez le contenu suivant: ```yaml # section information @@ -270,7 +344,7 @@ experiences: name: Example Co. url: "https://www.example.com" location: Dhaka Branch - # company overview + # Aperçu de l'entreprise overview: Example Co. is a widely recognized company for cloud-native development. It builds tools for Kubernetes. positions: - designation: Senior Software Engineer @@ -302,7 +376,7 @@ Vous pouvez trouver le fichier `experiences.yaml` utilisé dans le site exemple ###### Section Projets -Créons un fichier `projects.yaml` dans votre répertoire `/data/en/sections`. Puis ajoutez le contenu suivant: +Créez un fichier `projects.yaml` dans votre répertoire `/data/en/sections`. Puis ajoutez le contenu suivant: ```yaml # section information @@ -310,7 +384,7 @@ section: name: Projects id: projects enable: true - weight: 4 + weight: 5 showOnNavbar: true # En option : Possibilité de masquer le titre dans les sections # hideTitle: true @@ -356,9 +430,9 @@ projects: ``` Mettez les images des projets dans le répertoire `images/sections/projects/`. Vous trouverez les images [ici](https://github.com/hugo-toha/hugo-toha.github.io/tree/source/assets/images/sections/projects). Vous pouvez également trouver le fichier `projects.yaml` utilisé dans le site exemple par [là](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/sections/projects.yaml). -###### Recent Posts Section +###### Section Billets récents -Créons le fichier `recent-posts.yaml` dans votre répertoire `/data/en/sections/`. Puis ajoutez le contenu suivant: +Créez le fichier `recent-posts.yaml` dans votre répertoire `/data/en/sections/`. Puis ajoutez le contenu suivant: ```yaml # section information @@ -366,8 +440,11 @@ section: name: Recent Posts id: recent-posts enable: true - weight: 5 - showOnNavbar: true + weight: 6 + # Can optionally hide the title in sections + # hideTitle: true + +# no additional configuration is required ``` Vous pouvez trouver le fichier `recent-posts.yaml` utilisé dans le site d'exemple [ici](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/sections/recent-posts.yaml). @@ -376,7 +453,7 @@ Vous pouvez trouver le fichier `recent-posts.yaml` utilisé dans le site d'exemp ###### Section Réalisation -Créons un fichier `achievements.yaml` dans votre répertoire `/data/en/sections/`. Puis ajoutez le contenu suivant: +Créez un fichier `achievements.yaml` dans votre répertoire `/data/en/sections/`. Puis ajoutez le contenu suivant: ```yaml # section information @@ -384,7 +461,7 @@ section: name: Achievements id: achievements enable: true - weight: 6 + weight: 8 showOnNavbar: true # En option : Possibilité de masquer le titre dans les sections # hideTitle: true @@ -406,24 +483,24 @@ achievements: ``` Mettez les images des projets dans le répertoire `images/sections/achievements/`. Vous trouverez les images [ici](https://github.com/hugo-toha/hugo-toha.github.io/tree/source/assets/images/sections/achievements). Vous pouvez également trouver le fichier `achievements.yaml` utilisé dans le site exemple par [là](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/sections/achievements.yaml). -#### Add Posts +#### Ajout de billets -Now, we are ready add our first post into our site. Here, we are going to add this [introduction post](https://hugo-toha.github.io/posts/introduction/). +Maintenant, nous sommes prêts à ajouter nos premiers billet dans notre site. Ici, nous allons ajouter ce [billet d'introduction](https://hugo-toha.github.io/posts/introduction/). -- At first, create a `posts` folder inside `content` directory of your site. -- Then, create `_index.md` file inside the `posts` directory. Copy the content of [this file](https://raw.githubusercontent.com/hugo-toha/hugo-toha.github.io/source/content/posts/_index.md) file and paste into the newly created `_index.md` file. -- Create `introduction` folder inside your `posts` directory. -- Add the following [hero.svg](https://raw.githubusercontent.com/hugo-toha/hugo-toha.github.io/source/content/posts/introduction/hero.svg) inside your `introduction` folder. -- Now, create `index.md` file inside the `introduction` folder. This `index.md` file will hold the post contents. -- Add the following [sample contents](https://raw.githubusercontent.com/hugo-toha/hugo-toha.github.io/source/content/posts/introduction/index.md) in the newly created `index.md` file. +- D'abord, créez un répertoire `posts` à l'intérieur du répertoire `content` de votre site. +- Ensuite, créez un fichier `_index.md` à l'intérieur du répertoire `posts`. Copiez le contenu de ce [fichier](https://raw.githubusercontent.com/hugo-toha/hugo-toha.github.io/source/content/posts/_index.md) et collez le dans le nouveau fichier `_index.md` récemment créé. +- Créez un répertoire `introduction` à l'intérieur du répertoire `posts`. +- Ajoutez le [hero.svg](https://raw.githubusercontent.com/hugo-toha/hugo-toha.github.io/source/content/posts/introduction/hero.svg) suivant à l'intérieur de votre répertoire `introduction`. +- Maintenant, créez un fichier `index.md` à l'intérieur du répertoire `introduction`. Ce fichier `index.md` contiendra les contenus du billet. +- Ajoutez l'[extrait de contenus](https://raw.githubusercontent.com/hugo-toha/hugo-toha.github.io/source/content/posts/introduction/index.md) suivant dans le fichier `index.md` récemment créé. -Now, your post should appear at `http://localhost:1313/posts` and your `Recent Posts` section also should show this post card. For translating a post, just create a new file with name `index..md` in the same directory. Then, add the translated content there. +Maintenant, votre billet devrait apparaître à `http://localhost:1313/posts` et votre section `Billets Récents` devrait aussi afficher la carte de ce billet. Pour traduire ce billet, créez simplement un nouveau fichier `index..md` dans le même répertoire. Puis, ajoutez le contenu traduit dedans. -For more sample posts, please visit [here](https://github.com/hugo-toha/hugo-toha.github.io/tree/source/content/posts). +Pour plus d'échantillon de billets, [rendez-vous](https://github.com/hugo-toha/hugo-toha.github.io/tree/source/content/posts) par ici s'il vous plaît. -### What Next +### Et ensuite ? -At this point, your site should look similar to the [example site](https://hugo-toha.github.io/). Now, it's time to deploy your site. You can follow the following deployments guides: +A ce stade, votre site doit avoir une apparence similaire au [site d'exemple](https://hugo-toha.github.io/). Maintenant, il est temps de déployer votre site. Vous pouvez suivre les guides de déploiement ci-dessous: -- [Deploy in Github Pages](https://toha-guides.netlify.app/posts/getting-started/github-pages/) -- [Deploy in Netlify](https://toha-guides.netlify.app/posts/getting-started/netlify/) +- [Déployer dans Github Pages](https://toha-guides.netlify.app/posts/getting-started/github-pages/) +- [Déployer dans Netlify](https://toha-guides.netlify.app/posts/getting-started/netlify/) From bf8b606f3e85333f9566affefca3ae480767f8e0 Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sat, 11 Nov 2023 11:07:49 +0100 Subject: [PATCH 16/35] Modification des titres site et auteur information --- content/posts/getting-started/prepare-site/index.fr.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/posts/getting-started/prepare-site/index.fr.md b/content/posts/getting-started/prepare-site/index.fr.md index 65045845..62e9e4df 100644 --- a/content/posts/getting-started/prepare-site/index.fr.md +++ b/content/posts/getting-started/prepare-site/index.fr.md @@ -146,7 +146,7 @@ La plupart des contenus de ce thème sont pilotés par quelques fichiers YAML da D'abord, créez le répertoire `en` dans votre répertoire `data`. Ici, nous sommes en train d'ajouter des données pour la langue `anglaise`. -##### Site Information +##### Informations sur le site Maintenant, créez un fichier `site.yaml` dans le répertoire `/data/en/` de votre dépôt. Ajoutez-y le contenu suivant: @@ -159,7 +159,7 @@ description: Portfolio and personal blog of John Doe. ``` Pour voir toutes les options disponibles pour les informations du site, consulter [cet extrait de fichier](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/site.yaml). -##### Auteur Information +##### Informations sur l'auteur Maintenant, créez un fichier `author.yaml` dans le répertoire `data/en` et ajoutez vos informations comme suit: From c33b4a8f63d80b0ee8b68e46614833d5588b4060 Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sat, 11 Nov 2023 11:59:29 +0100 Subject: [PATCH 17/35] =?UTF-8?q?Ajout=20de=20nouvelles=20traductions=20et?= =?UTF-8?q?=20am=C3=A9liorations?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 6 +- .../getting-started/github-pages/index.fr.md | 128 ++++++++++++++++++ .../posts/getting-started/netlify/index.fr.md | 115 ++++++++++++++++ .../getting-started/prepare-site/index.fr.md | 24 ++-- 4 files changed, 258 insertions(+), 15 deletions(-) create mode 100644 content/posts/getting-started/github-pages/index.fr.md create mode 100644 content/posts/getting-started/netlify/index.fr.md diff --git a/README.md b/README.md index 8113ccce..7aa55c71 100644 --- a/README.md +++ b/README.md @@ -10,14 +10,14 @@ Les articles français sont rangés dans le répertoire `content/posts` dans les ## Les articles déjà traduits -Au 06/11/2023, les billets intégralement traduits en français sont : +Au 11/11/2023, les billets intégralement traduits en français sont : - [x] Features/index.md - [x] Quickstart/index.md - [x] Shortcodes/index.md - [x] Supports/index.md -- [ ] Getting-started/prepare-site/index.md -- [ ] Getting-started/github_pages/index.md +- [x] Getting-started/prepare-site/index.md +- [x] Getting-started/github_pages/index.md - [ ] Getting-started/netlify/index.md - [ ] Getting-started/theme-update/index.md - [ ] Configuration/site-parameters/index.md diff --git a/content/posts/getting-started/github-pages/index.fr.md b/content/posts/getting-started/github-pages/index.fr.md new file mode 100644 index 00000000..5253f12e --- /dev/null +++ b/content/posts/getting-started/github-pages/index.fr.md @@ -0,0 +1,128 @@ +--- +title: "Déployer dans Github Pages" +date: 2023-11-11T22:00:20+02:00 +menu: + sidebar: + name: Déployer dans Github Pages + identifier: getting-started-github + parent: getting-started + weight: 20 +--- + +Dans ce billet, nous allons déployer le site que nous avons créé dans le précédent billet dans [Github Pages](https://pages.github.com/). D'abord, assurez-vous que le nom de votre dépôt soit `.github.io`. Ensuite, commitez n'importe quelles modifications locales et pousser dans Github. + +#### Créer une branche `gh-pages` + +D'abord, créez une nouvelle branche nommée `gh-pages`. Github définira automatiquement les configurations pour Github Pages quand il verra une branche avec ce nom. + +```bash +# Création de la branche the gh-pages +$ git checkout -b gh-pages +# push de la branche source sur Github +$ git push gh-pages gh-pages +``` +#### Activer Github Action + +Nous allons automatiser le processus de déploiement en utilisant [Github Actions](https://github.com/features/actions). D'abord, assurez-vous que Github Action soit activé dans votre dépôt. Allez dans `Settings > Actions` de votre dépôt assurez-vous que `Action permissions` est configuré sur `Allow all actions`. Ici, une capture d'écran du paramètre décrit. + +{{< img src="images/enable_action.png" align="center" >}} + +#### Ajouter le flux de travail + +Nous allons utiliser [peaceiris/actions-hugo](https://github.com/peaceiris/actions-hugo) action pour configurer hugo et [peaceiris/actions-gh-pages](https://github.com/peaceiris/actions-gh-pages) pour déployer le site. Créez un répertoire `.github` à la racine de votre dépôt. Ensuite, créez un répertoire `workflows` à l'intérieur du répertoire `.github`. Enfin, créez un fichier `deploy-site.yaml` à l'intérieur du répertoire `workflows` et ajoutez-y le contenu suivant: + +```yaml +name: Deploy to Github Pages + +# run when a commit is pushed to "source" branch +on: + push: + branches: + - main + +jobs: + deploy: + runs-on: ubuntu-latest + steps: + # checkout to the commit that has been pushed + - uses: actions/checkout@v3 + + - name: Setup Hugo + uses: peaceiris/actions-hugo@v2.6.0 + with: + hugo-version: 'latest' + extended: true + + - name: Update Hugo Modules + run: hugo mod tidy + + - name: Setup Node + uses: actions/setup-node@v3 + with: + node-version: 18 + + - name: Install node modules + run: | + hugo mod npm pack + npm install + + - name: Build + run: hugo --minify + + # push the generated content into the `gh-pages` branch. + - name: Deploy + uses: peaceiris/actions-gh-pages@v3.9.0 + with: + github_token: ${{ secrets.GITHUB_TOKEN }} + publish_branch: gh-pages + publish_dir: ./public +``` + +Cette action s'exécutera à chaque push dans la branche `main`. Ca construira le site et commit le contenu généré dans la branche `gh-pages`. + +#### Déployer + +Si vous avez correctement suivi le guide, votre site devrait être prêt à être déployé dans Github Pages. Désormais, si vous poussez n'importe quel commit dans votre branche `main`, une Github Action démarrera et déploiera votre site automatiquement. + +Poussez un commit dans la branche `main` et allez dans l'onglet `Actions` de votre dépôt pour vérifier que l'action a démarré. + +{{< img src="images/action_running.png" align="center" >}} + +{{< vs 2 >}} + +Maintenant, attendez la fin des actions. Si elles se terminent avec succès, vous devriez voir une encoche verte indiquant que l'exécution réussie. + +{{< img src="images/action_completed.png" align="center" >}} + +{{< vs 2 >}} + +Une fois la Github Action terminée avec succès, vous pouvez parcourir votre site à `https://.github.io`. + +{{< img src="images/site_deployed.png" align="center" >}} + +#### Ajout d'un nom de domaine personnalisé + +Si vous possédez un nom de domaine et que vous souhaitez l'utiliser pour ce site, rendez-vous sur le site de votre fournisseur de nom de domaine. Ajoutez les enregistrements de ressources suivants: + +``` +@ 3600 IN A 185.199.108.153 +@ 3600 IN A 185.199.109.153 +@ 3600 IN A 185.199.110.153 +@ 3600 IN A 185.199.111.153 + +WWW 3600 IN A 185.199.108.153 +WWW 3600 IN A 185.199.109.153 +WWW 3600 IN A 185.199.110.153 +WWW 3600 IN A 185.199.111.153 +``` + +Pour vérifier votre domaine pour vous assurer que personne de Github ne puisse le réclamer à l'exception de vous, vous pouvez suivre les étapes contenues dans [ce guide](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site/verifying-your-custom-domain-for-github-pages). + +Enfin, créez un fichier `CNAME` à l'intérieur du répertoire `/static` de votre dépôt. Ajoutez votre nom de domaine là: + +``` +example.com +``` +Une fois la Github Action terminée avec succès, vous pouvez parcourir votre site à `https://`. + +Notez qu'en naviguant sur `https://.github.io`, il redirigera automatiquement sur `https://`. \ No newline at end of file diff --git a/content/posts/getting-started/netlify/index.fr.md b/content/posts/getting-started/netlify/index.fr.md new file mode 100644 index 00000000..bca436e5 --- /dev/null +++ b/content/posts/getting-started/netlify/index.fr.md @@ -0,0 +1,115 @@ +--- +title: "Déployer dans Netlify" +date: 2020-06-08T21:00:15+06:00 +menu: + sidebar: + name: Déployer dans Netlify + identifier: getting-started-netlify + parent: getting-started + weight: 30 +--- + +[Netlify](https://www.netlify.com/) offers an excellent and easy process for deploying hugo static site. You can deploy your site in matter of few clicks. Unlike Github Pages, you can name your repository whatever you want. You can also customize the site URL. + +In this post, we will show the step-by-step process of deploying a hugo site with netlify. + +### Add Netlify Configuration + +At first, create a `netlify.toml` file at the root of your repository and add the following configuration there: + +```toml +[build] +command = "hugo --gc --minify" +publish = "public" + +[context.production.environment] +HUGO_ENABLEGITINFO = "true" +HUGO_ENV = "production" +HUGO_VERSION = "0.120.1" +NODE_VERSION = "v18.12.1" +NPM_VERSION = "8.19.2" + +[context.split1] +command = "hugo mod tidy && hugo mod npm pack && npm install && hugo --gc --minify --enableGitInfo" + + [context.split1.environment] + HUGO_ENV = "production" + HUGO_VERSION = "0.120.1" + NODE_VERSION = "v18.12.1" + NPM_VERSION = "8.19.2" + +[context.deploy-preview] +command = "hugo mod tidy && hugo mod npm pack && npm install && hugo --gc --minify --buildFuture -b $DEPLOY_PRIME_URL" + + [context.deploy-preview.environment] + HUGO_VERSION = "0.120.1" + NODE_VERSION = "v18.12.1" + NPM_VERSION = "8.19.2" + +[context.branch-deploy] +command = "hugo mod tidy && hugo mod npm pack && npm install && hugo --gc --minify -b $DEPLOY_PRIME_URL" + + [context.branch-deploy.environment] + HUGO_VERSION = "0.120.1" + NODE_VERSION = "v18.12.1" + NPM_VERSION = "8.19.2" + +[context.next.environment] +HUGO_ENABLEGITINFO = "true" +``` + +Commit and push the `netlify.toml` file into Github. Now, you are ready to deploy your site with netlify. + +### Deploy Site + +Now, login into [netlify](https://www.netlify.com/). Then, go to `Sites` tab of your netlify dashboard and click `New site form Git` button. + +{{< img src="images/2.png" align="center" >}} + +{{< vs 2 >}} + +A new popup will open. Select `Github` and authenticate, with your Github account. + +{{< img src="images/3.png" align="center" >}} + +{{< vs 2 >}} + +After authenticating, it will ask to select your desired repository. Select the repository you are using for your site. + +{{< img src="images/4.png" align="center" >}} + +{{< vs 2 >}} + +Now, netlify will take you to the deployment page. Select the branch you want to deploy. Netlify should automatically populate the required fields from the `netlify.toml` file you created earlier in this post. When you are satisfied with the configurations, press the `Deploy` button. + +{{< img src="images/5.png" align="center" >}} + +{{< vs 2 >}} + +Now, netlify will start publishing your site immediately. Wait for the publishing process to complete. Once, the site has been published, you can browse your site at the URL automatically generated by netlify. The auto-generated URL has been pointed out by a red rectangle in the screenshot below. + +{{< img src="images/6.png" align="center" >}} + +### Customize URL + +You can easily customize the URL of your site with just few clicks as shown below. + +1. Click the `Domain Setting` button under `Site Overview` tab. + +{{< img src="images/7.png" align="center" >}} + +2. Now, you can either add your own domain by clicking on `Add custom domain` button or you can just use `.netlify.app` domain. Here, we are going with the later. Click the `options` dropdown and select `Edit site name`. + +{{< img src="images/8.png" align="center" >}} + +{{< vs 2 >}} + +3. Then, give your site whatever name you want. + +{{< img src="images/9.png" align="center" >}} + +{{< vs 2 >}} + +4. Once you have saved the new name, you will see the URL of your site has been updated instantly. Now, you can browse your site at the new URL. + +{{< img src="images/10.png" align="center" >}} diff --git a/content/posts/getting-started/prepare-site/index.fr.md b/content/posts/getting-started/prepare-site/index.fr.md index 62e9e4df..ff429416 100644 --- a/content/posts/getting-started/prepare-site/index.fr.md +++ b/content/posts/getting-started/prepare-site/index.fr.md @@ -3,7 +3,7 @@ title: "Préparer Votre Site" date: 2023-11-06T21:44:20+02:00 menu: sidebar: - name: Prepare Site + name: Prepare votre site identifier: getting-started-prepare-site parent: getting-started weight: 10 @@ -138,7 +138,7 @@ params: enable: true ``` -Ici, vous voyez une configuration de base pour le thème Toha. Vous pouvez voir le fichier de configuration utilisé dans le formulaire du site d'exemple [ici](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/config.yaml). Pour des options de configurations plus détaillées, s'il vous plaît consulter [ce billet](https://toha-guides.netlify.app/posts/configuration/site-parameters/). +Ici, vous voyez une configuration de base pour le thème Toha. Vous pouvez voir le fichier de configuration utilisé dans le site d'exemple [ici](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/config.yaml). Pour des options de configurations plus détaillées, s'il vous plaît consultez [ce billet](https://toha-guides.netlify.app/posts/configuration/site-parameters/). #### Ajouter de données @@ -197,7 +197,7 @@ Maintenant, nous allons ajouter différentes section dans notre page d'accueil. Créons un fichier `about.yaml` dans votre répertoire `/data/en/sections`. Puis ajoutez le contenu suivant: ```yaml -# section information +# Information de section section: name: About id: about @@ -220,7 +220,7 @@ resume: "files/resume.pdf" summary: 'I am a passionate software engineer with x years of working experience. I built OSS tools for [Kubernetes](https://kubernetes.io/) using GO. My tools help people to deploy their workloads in Kubernetes. Sometimes, I work on some fun projects such as writing a theme, etc.' # Vos liens sur les réseaux sociaux -# Mettez-en autant que vous voulez. Utilisez use font-awesome for the icons +# Mettez-en autant que vous voulez. Utilisez font-awesome pour les icônes socialLinks: - name: Email icon: "fas fa-envelope" @@ -293,7 +293,7 @@ Mettre le fichier `resume.pdf` dans le répertoire `/static/files`. Vous pouvez Créons un fichier `skills.yaml` dans votre répertoire `/data/en/sections`. Puis ajoutez le contenu suivant: ```yaml -# section information +# Information de section section: name: Skills id: skills @@ -328,7 +328,7 @@ Mettez vos images de compétences dans le répertoire `images/sections/skills` d Créez un fichier `experiences.yaml` dans votre répertoire `/data/en/sections`. Puis ajoutez le contenu suivant: ```yaml -# section information +# Information de section section: name: Experiences id: experiences @@ -379,7 +379,7 @@ Vous pouvez trouver le fichier `experiences.yaml` utilisé dans le site exemple Créez un fichier `projects.yaml` dans votre répertoire `/data/en/sections`. Puis ajoutez le contenu suivant: ```yaml -# section information +# Information de section section: name: Projects id: projects @@ -435,16 +435,16 @@ Mettez les images des projets dans le répertoire `images/sections/projects/`. V Créez le fichier `recent-posts.yaml` dans votre répertoire `/data/en/sections/`. Puis ajoutez le contenu suivant: ```yaml -# section information +# Information de section section: name: Recent Posts id: recent-posts enable: true weight: 6 - # Can optionally hide the title in sections + # En option : Possibilité de masquer le titre dans les sections # hideTitle: true -# no additional configuration is required +# Pas de configuration additionnelles requises ``` Vous pouvez trouver le fichier `recent-posts.yaml` utilisé dans le site d'exemple [ici](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/sections/recent-posts.yaml). @@ -456,7 +456,7 @@ Vous pouvez trouver le fichier `recent-posts.yaml` utilisé dans le site d'exemp Créez un fichier `achievements.yaml` dans votre répertoire `/data/en/sections/`. Puis ajoutez le contenu suivant: ```yaml -# section information +# Information de section section: name: Achievements id: achievements @@ -496,7 +496,7 @@ Maintenant, nous sommes prêts à ajouter nos premiers billet dans notre site. I Maintenant, votre billet devrait apparaître à `http://localhost:1313/posts` et votre section `Billets Récents` devrait aussi afficher la carte de ce billet. Pour traduire ce billet, créez simplement un nouveau fichier `index..md` dans le même répertoire. Puis, ajoutez le contenu traduit dedans. -Pour plus d'échantillon de billets, [rendez-vous](https://github.com/hugo-toha/hugo-toha.github.io/tree/source/content/posts) par ici s'il vous plaît. +Pour plus de billets d'échantillon, s'il vous plaît consultez [ici](https://github.com/hugo-toha/hugo-toha.github.io/tree/source/content/posts). ### Et ensuite ? From f2d5d6924d412b3540318be50b71e2e6e6cf308b Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 26 Nov 2023 15:30:53 +0100 Subject: [PATCH 18/35] Refresh prepare your site article --- .../getting-started/prepare-site/index.fr.md | 2 +- .../getting-started/prepare-site/index.md | 125 +++++++++++++++--- 2 files changed, 104 insertions(+), 23 deletions(-) diff --git a/content/posts/getting-started/prepare-site/index.fr.md b/content/posts/getting-started/prepare-site/index.fr.md index ff429416..0a7f264b 100644 --- a/content/posts/getting-started/prepare-site/index.fr.md +++ b/content/posts/getting-started/prepare-site/index.fr.md @@ -21,7 +21,7 @@ D'abord, créez un dépôt sur Github. Si vous voulez déployer ce site dans Git ### Créer un site -Maintenant, assurez-vous d'avoir [Hugo](https://gohugo.io/getting-started/installing/) installé. Ce thème devrait fonctionner avec hugo version `v0.111.0` et plus. Maintenant, lancez la commande suivante depuis la racine de votre dépôt pour initier un site web hugo. +Maintenant, assurez-vous d'avoir [Hugo](https://gohugo.io/getting-started/installing/) installé. Ce thème devrait fonctionner avec hugo version `v0.118.0` et plus. Maintenant, lancez la commande suivante depuis la racine de votre dépôt pour initier un site web hugo. ```console $ hugo new site ./ -f=yaml --force diff --git a/content/posts/getting-started/prepare-site/index.md b/content/posts/getting-started/prepare-site/index.md index 14d55a55..742f0d74 100644 --- a/content/posts/getting-started/prepare-site/index.md +++ b/content/posts/getting-started/prepare-site/index.md @@ -26,7 +26,7 @@ At first, create a repository in Github. If you want to deploy this site in Gith ### Create Site -Now, make sure that you have [Hugo](https://gohugo.io/getting-started/installing/) installed. This theme should work with hugo version `v0.68.0` and later. Now, run the following command in the root of your repository to initiate a hugo website. +Now, make sure that you have [Hugo](https://gohugo.io/getting-started/installing/) installed. This theme should work with hugo version `v0.118.0` and later. Now, run the following command in the root of your repository to initiate a hugo website. ```console $ hugo new site ./ -f=yaml --force @@ -76,7 +76,20 @@ baseURL: https://hugo-toha.github.io languageCode: en-us title: "John's Blog" -theme: "toha" + +# Use Hugo modules to add theme +module: + imports: + - path: github.com/hugo-toha/toha/v4 + mounts: + - source: static/files + target: static/files + - source: ./node_modules/flag-icon-css/flags + target: static/flags + - source: ./node_modules/@fontsource/mulish/files + target: static/files + - source: ./node_modules/katex/dist/fonts + target: static/fonts # Manage languages # For any more details, you can check the official documentation: https://gohugo.io/content-management/multilingual/ @@ -84,14 +97,31 @@ languages: en: languageName: English weight: 1 + fr: + languageName: Français + weight: 2 + +# Force a locale to be use, really useful to develop the application ! Should be commented in production, the "weight" should rocks. +# DefaultContentLanguage: bn -# Control TOC depth +# Allow raw html in markdown file markup: + goldmark: + renderer: + unsafe: true tableOfContents: startLevel: 2 endLevel: 6 ordered: false +# At least HTML and JSON are required for the main HTML content and +# client-side JavaScript search +outputs: + home: + - HTML + - RSS + - JSON + # Enable global emoji support enableEmoji: true @@ -148,10 +178,8 @@ image: "images/author/john.png" contactInfo: email: "johndoe@example.com" phone: "+0123456789" - stack-overflow: - icon: stack-overflow - url: "https://stackoverflow.com/users/1/exampleUser" - text: "ExampleUser" + github: johndoe + linkedin: johndoe # some summary about what you do summary: @@ -196,20 +224,69 @@ summary: 'I am a passionate software engineer with x years of working experience # your social links # give as many as you want. use font-awesome for the icons. socialLinks: +- name: Email + icon: "fas fa-envelope" + url: "example@gmail.com" + - name: Github icon: "fab fa-github" url: "https://www.github.com/example" -# your soft skills -# give the percentage between 50 to 100 with 5 intervals. -# currently supported colors: blue, yellow, pink, green, sky, orange -softSkills: -- name: Leadership +- name: Stackoverflow + icon: "fab fa-stack-overflow" + url: "#" + +- name: LinkedIn + icon: "fab fa-linkedin" + url: "#" + +- name: Twitter + icon: "fab fa-twitter" + url: "#" + +- name: Facebook + icon: "fab fa-facebook" + url: "#" + +# 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: Team Work + +- type: soft-skill-indicator + name: Team Work percentage: 90 color: yellow + +- type: soft-skill-indicator + name: Hard Working + percentage: 85 + color: orange + +# you can also provide color code instead of the color name +# - type: soft-skill-indicator +# name: Example 1 +# percentage: 75 +# color: "#00adb5" ``` Put the `resume.pdf` file in `/static/files` directory of your repository. You can find the `about.yaml` file used in the example site from [here](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/sections/about.yaml). @@ -233,17 +310,17 @@ section: # Give a summary of you each skill in the summary section. skills: - name: Kubernetes - logo: "/images/sections/skills/kubernetes.png" + logo: /images/sections/skills/kubernetes.png summary: "Capable of deploying, managing application on Kubernetes. Experienced in writing Kubernetes controllers for CRDs." url: "https://kubernetes.io/" - name: Go Development - logo: "/images/sections/skills/go.png" + logo: /images/sections/skills/go.png summary: "Using as the main language for professional development. Capable of writing scalable, testable, and maintainable program." url: "https://golang.org/" - name: Cloud Computing - logo: "/images/sections/skills/cloud.png" + logo: /images/sections/skills/cloud.png summary: "Worked with most of the major clouds such as GCP, AWS, Azure etc." ``` @@ -264,7 +341,7 @@ section: # Can optionally hide the title in sections # hideTitle: true -# Your experiences +# Yours experiences experiences: - company: name: Example Co. @@ -285,7 +362,7 @@ experiences: - company: name: PreExample Co. - url: "https://example.com" + url: "https://www.example.com" location: Nowhere overview: PreExample Co. is a gateway company to enter into Example co. So, nothing special here. positions: @@ -310,7 +387,7 @@ section: name: Projects id: projects enable: true - weight: 4 + weight: 5 showOnNavbar: true # Can optionally hide the title in sections # hideTitle: true @@ -344,7 +421,7 @@ projects: repo: https://github.com/tensorflow/tensorflow #url: "" summary: An Open Source Machine Learning Framework for Everyone. - tags: ["professional", "machine-learning","academic"] + tags: ["professional", "machine-learning"] - name: Toha logo: /images/sections/projects/toha.png @@ -366,8 +443,12 @@ section: name: Recent Posts id: recent-posts enable: true - weight: 5 + weight: 6 showOnNavbar: true + # Can optionally hide the title in sections + # hideTitle: true + +# no additional configuration is required ``` You can find the `recent-posts.yaml` file used in the example site from [here](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/sections/recent-posts.yaml). @@ -384,7 +465,7 @@ section: name: Achievements id: achievements enable: true - weight: 6 + weight: 8 showOnNavbar: true # Can optionally hide the title in sections # hideTitle: true From b2c571470f208e2b9b4db08794de0693be9e88bd Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 26 Nov 2023 15:36:03 +0100 Subject: [PATCH 19/35] Deletion warning message --- content/posts/getting-started/prepare-site/index.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/content/posts/getting-started/prepare-site/index.md b/content/posts/getting-started/prepare-site/index.md index 742f0d74..9fd94bb1 100644 --- a/content/posts/getting-started/prepare-site/index.md +++ b/content/posts/getting-started/prepare-site/index.md @@ -10,10 +10,6 @@ menu: --- -{{< alert type="danger" >}} -This doc is outdated. For up-to-date examples, please follow this sample [repo](https://github.com/hugo-toha/hugo-toha.github.io). -{{< /alert >}} - In this post, we are going to create a hugo site from scratch. Then, we will configure it with `Toha` theme, make it multilingual, add some example posts. At the end of this post, you should be able to run a fully functional hugo site with `Toha` theme locally. If you want a head start, you can just fork [hugo-toha/hugo-toha.github.io](https://github.com/hugo-toha/hugo-toha.github.io) repo, rename it and update with your own data. This repo has already been configured to deploy in [Github Pages](https://pages.github.com/) and [Netlify](https://www.netlify.com/). From 833f987133428d091ff40bb2f3375357c0b5815f Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 26 Nov 2023 15:40:58 +0100 Subject: [PATCH 20/35] Deletion of deprecated message --- content/posts/getting-started/prepare-site/index.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/posts/getting-started/prepare-site/index.md b/content/posts/getting-started/prepare-site/index.md index 9fd94bb1..437b605f 100644 --- a/content/posts/getting-started/prepare-site/index.md +++ b/content/posts/getting-started/prepare-site/index.md @@ -9,7 +9,6 @@ menu: weight: 10 --- - In this post, we are going to create a hugo site from scratch. Then, we will configure it with `Toha` theme, make it multilingual, add some example posts. At the end of this post, you should be able to run a fully functional hugo site with `Toha` theme locally. If you want a head start, you can just fork [hugo-toha/hugo-toha.github.io](https://github.com/hugo-toha/hugo-toha.github.io) repo, rename it and update with your own data. This repo has already been configured to deploy in [Github Pages](https://pages.github.com/) and [Netlify](https://www.netlify.com/). From 60f82668f008e579203004d1bd2033bd34f871c7 Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sat, 9 Dec 2023 13:43:04 +0100 Subject: [PATCH 21/35] Update README.md in English && Update supports article --- README.md | 25 +++---------------------- content/posts/supports/index.md | 10 +++++----- 2 files changed, 8 insertions(+), 27 deletions(-) diff --git a/README.md b/README.md index 7aa55c71..d33aca47 100644 --- a/README.md +++ b/README.md @@ -1,24 +1,5 @@ -# Les guides du thème Toha en langue française +# Toha Guides -La documentation (VO) pour le thème [Toha](https://github.com/hugo-toha/toha) pour hugo. +[![Netlify Status](https://api.netlify.com/api/v1/badges/3dac568a-bcdd-4b98-8a47-15ccf6dd8bd4/deploy-status)](https://app.netlify.com/sites/toha/deploys) ![Repository Size](https://img.shields.io/github/repo-size/hugo-toha/guides) ![Contributor](https://img.shields.io/github/contributors/hugo-toha/guides) ![Last Commit](https://img.shields.io/github/last-commit/hugo-toha/guides) ![Open Issues](https://img.shields.io/github/issues/hugo-toha/guides?color=important) ![Open Pull Requests](https://img.shields.io/github/issues-pr/hugo-toha/guides?color=yellowgreen) ![License](https://img.shields.io/github/license/hugo-toha/guides) ![Security Header](https://img.shields.io/security-headers?url=https%3A%2F%2Ftoha-guides.netlify.app) -## Préambule - -Ce dépôt est un fork du [dépôt original](https://github.com/hugo-toha/guides) de la documentation du thème Toha pour Hugo. Ce dépôt me sert de base de travail pour la traduction des billets en langue anglaise dans la langue française. **Je ne suis pas traducteur de métier, alors soyez indulgent avec mes traductions s'il vous plaît. Merci d'avance.** - -Les articles français sont rangés dans le répertoire `content/posts` dans les différents sous-répertoires associés. Ils sont identifiables avec la chaine de caractères `fr` dans leurs noms de fichier. - -## Les articles déjà traduits - -Au 11/11/2023, les billets intégralement traduits en français sont : - -- [x] Features/index.md -- [x] Quickstart/index.md -- [x] Shortcodes/index.md -- [x] Supports/index.md -- [x] Getting-started/prepare-site/index.md -- [x] Getting-started/github_pages/index.md -- [ ] Getting-started/netlify/index.md -- [ ] Getting-started/theme-update/index.md -- [ ] Configuration/site-parameters/index.md -- [ ] Configuration/sections/about/index.md \ No newline at end of file +Documentation site for Hugo theme [Toha](https://github.com/hugo-toha/toha). \ No newline at end of file diff --git a/content/posts/supports/index.md b/content/posts/supports/index.md index 33c52771..0b1208c2 100644 --- a/content/posts/supports/index.md +++ b/content/posts/supports/index.md @@ -9,14 +9,14 @@ menu: weight: 660 --- -Ce thème supporte l'ajout de liens de soutien/donation sur votre site. Actuellement, les liens de soutien supportés sont: +This theme supports adding various support/donation links in your site. Currently, supported support links are: - [Ko-fi](https://ko-fi.com/) - [Buy Me a Coffee](https://www.buymeacoffee.com/zicklam) ## Ko-fi -Vous pouvez ajouter votre button flottant ko-fi sur votre site web. Pour ajouter le button flottant, ajoutez une section `support` sous la section `params.features` dans votre fichier `config.yaml`: +You can add your Ko-fi floating button in your website. To add the floating button, add the `support` section under `params.features` section of your sites `config.yaml` file: ```yaml params: @@ -32,11 +32,12 @@ params: ## Buy Me a Coffee -Vous pouvez ajouter votre bouton flottant "Buy Me a Coffee" sur votre site web. Pour ajoutez une section `support` sous la section `params.features` dans votre fichier `config.yaml`: +You can add your "Buy Me a Coffee" floating button in your website. To add the floating button, add the `support` section under `params.features` section of your sites `config.yaml` file: ![bmacbutton](https://git-doc-files.s3.eu-central-1.amazonaws.com/github.com/hugo-toha/guides/buymeacoffe-button.png) ![bmacwidget](https://git-doc-files.s3.eu-central-1.amazonaws.com/github.com/hugo-toha/guides/buymeacoffe-widget.png) + ```yaml params: features: @@ -46,5 +47,4 @@ params: user: text: Support me on Buy me a coffee! info: Buy me a coffee! - color: '#FFDD00' -``` \ No newline at end of file + color: '#FFDD00' \ No newline at end of file From d3735ab8fac5c3f09ad954e12764cd2ab7f8161b Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sat, 9 Dec 2023 13:49:51 +0100 Subject: [PATCH 22/35] Rollback ton initial English Version --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index d33aca47..7401d1ad 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@ # Toha Guides -[![Netlify Status](https://api.netlify.com/api/v1/badges/3dac568a-bcdd-4b98-8a47-15ccf6dd8bd4/deploy-status)](https://app.netlify.com/sites/toha/deploys) ![Repository Size](https://img.shields.io/github/repo-size/hugo-toha/guides) ![Contributor](https://img.shields.io/github/contributors/hugo-toha/guides) ![Last Commit](https://img.shields.io/github/last-commit/hugo-toha/guides) ![Open Issues](https://img.shields.io/github/issues/hugo-toha/guides?color=important) ![Open Pull Requests](https://img.shields.io/github/issues-pr/hugo-toha/guides?color=yellowgreen) ![License](https://img.shields.io/github/license/hugo-toha/guides) ![Security Header](https://img.shields.io/security-headers?url=https%3A%2F%2Ftoha-guides.netlify.app) +[![Netlify Status](https://api.netlify.com/api/v1/badges/3dac568a-bcdd-4b98-8a47-15ccf6dd8bd4/deploy-status)](https://app.netlify.com/sites/toha/deploys) ![Repository Size](https://img.shields.io/github/repo-size/hugo-toha/guides) ![Contributor](https://img.shields.io/github/contributors/hugo-toha/guides) ![Last Commit](https://img.shields.io/github/last-commit/hugo-toha/guides) ![Open Issues](https://img.shields.io/github/issues/hugo-toha/guides?color=important) ![Open Pull Requests](https://img.shields.io/github/issues-pr/hugo-toha/guides?color=yellowgreen) ![License](https://img.shields.io/github/license/hugo-toha/guides) ![Security Header](https://img.shields.io/security-headers?url=https%3A%2F%2Ftoha-guides.netlify.app) -Documentation site for Hugo theme [Toha](https://github.com/hugo-toha/toha). \ No newline at end of file +Documentation site for Hugo theme [Toha](https://github.com/hugo-toha/toha). From a1ba50b981072a0f522b38e69a91cb41aa43859e Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 10 Dec 2023 11:37:03 +0100 Subject: [PATCH 23/35] Fix front matter page and a few things --- content/posts/supports/index.fr.md | 6 +++--- content/posts/supports/index.md | 3 +-- 2 files changed, 4 insertions(+), 5 deletions(-) diff --git a/content/posts/supports/index.fr.md b/content/posts/supports/index.fr.md index 33c52771..621a8037 100644 --- a/content/posts/supports/index.fr.md +++ b/content/posts/supports/index.fr.md @@ -1,5 +1,5 @@ --- -title: "Supports Links" +title: "Les liens de soutien" date: 2022-03-14T06:00:23+06:00 description: Adding support links in hugo theme Toha menu: @@ -9,7 +9,7 @@ menu: weight: 660 --- -Ce thème supporte l'ajout de liens de soutien/donation sur votre site. Actuellement, les liens de soutien supportés sont: +Ce thème supporte l'ajout de liens de soutien/donation sur votre site. Actuellement, les liens de soutien supportés sont: - [Ko-fi](https://ko-fi.com/) - [Buy Me a Coffee](https://www.buymeacoffee.com/zicklam) @@ -47,4 +47,4 @@ params: text: Support me on Buy me a coffee! info: Buy me a coffee! color: '#FFDD00' -``` \ No newline at end of file +``` diff --git a/content/posts/supports/index.md b/content/posts/supports/index.md index 0b1208c2..efe1e96e 100644 --- a/content/posts/supports/index.md +++ b/content/posts/supports/index.md @@ -37,7 +37,6 @@ You can add your "Buy Me a Coffee" floating button in your website. To add the f ![bmacbutton](https://git-doc-files.s3.eu-central-1.amazonaws.com/github.com/hugo-toha/guides/buymeacoffe-button.png) ![bmacwidget](https://git-doc-files.s3.eu-central-1.amazonaws.com/github.com/hugo-toha/guides/buymeacoffe-widget.png) - ```yaml params: features: @@ -47,4 +46,4 @@ params: user: text: Support me on Buy me a coffee! info: Buy me a coffee! - color: '#FFDD00' \ No newline at end of file + color: '#FFDD00' From 8a08432832220ea49306df9cd00931500e615608 Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 10 Dec 2023 11:39:36 +0100 Subject: [PATCH 24/35] Fix front matter page and a few things --- .../getting-started/prepare-site/index.fr.md | 24 +++++++++++-------- 1 file changed, 14 insertions(+), 10 deletions(-) diff --git a/content/posts/getting-started/prepare-site/index.fr.md b/content/posts/getting-started/prepare-site/index.fr.md index 0a7f264b..673ad5ea 100644 --- a/content/posts/getting-started/prepare-site/index.fr.md +++ b/content/posts/getting-started/prepare-site/index.fr.md @@ -3,17 +3,17 @@ title: "Préparer Votre Site" date: 2023-11-06T21:44:20+02:00 menu: sidebar: - name: Prepare votre site + name: Préparer votre site identifier: getting-started-prepare-site - parent: getting-started + parent: Démarrer weight: 10 --- Dans ce billet, nous allons créer un site hugo de zéro. Nous le configurerons avec le thème `toha`, le rendre multilingue, ajouter quelques exemples de billets. A la fin de ce billet, vous devriez être capable d'exécuter pleinement un site Hugo avec le thème `Toha` localement. -Si vous voulez un démarrage de la tête, vous pouvez juste forker le dépôt [hugo-toha/hugo-toha.github.io](https://github.com/hugo-toha/hugo-toha.github.io), renommez le et mettez le à jour avec vos propres données. Ce dépôt a déjà été configuré pour déployer sur [Github Pages](https://pages.github.com/) et [Netlify](https://www.netlify.com/). +Si vous voulez un démarrage de la tête, vous pouvez juste forker le dépôt [hugo-toha/hugo-toha.github.io](https://github.com/hugo-toha/hugo-toha.github.io), renommez-le et mettez-le à jour avec vos propres données. Ce dépôt a déjà été configuré pour déployer sur [Github Pages](https://pages.github.com/) et [Netlify](https://www.netlify.com/). -Si vous avez déjà un site hugo, sautez à la section [Ajouter un theme](#add-theme) +Si vous avez déjà un site hugo, sautez à la section [Ajouter un thème](#add-theme) ### Créer un dépôt @@ -33,7 +33,7 @@ Cette commande créera une structure de base d'un site hugo. Ici, le flag `-f=ya Maintenant, il est temps d'ajouter git à votre site web. Initialisez le dépôt git en utilisant la commande suivante : -``` +```console $ git init ``` @@ -61,9 +61,9 @@ Si vous naviguez sur `http://localhost:1313`, vous devriez voir un site de base ### Configurer le site -Maintenant, nous sommes prêt à configurer notre site. Dans cette section, nous allons ajouter les informations de l'auteur, différentes sections, et des echantillon de billets etc. +Maintenant, nous sommes prêt à configurer notre site. Dans cette section, nous allons ajouter les informations de l'auteur, différentes sections, et des echantillons de billets etc. -#### Mise à jour du `config.yaml` +#### Mise à jour du `config.yaml` Quand vous avez créé le site en utilisant la commande `hugo new site`, il a créé un fichier `config.yaml` à la racine de votre dépôt. Remplacer le contenu par défaut du fichier `config.yaml` avec ce qui suit: @@ -138,7 +138,7 @@ params: enable: true ``` -Ici, vous voyez une configuration de base pour le thème Toha. Vous pouvez voir le fichier de configuration utilisé dans le site d'exemple [ici](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/config.yaml). Pour des options de configurations plus détaillées, s'il vous plaît consultez [ce billet](https://toha-guides.netlify.app/posts/configuration/site-parameters/). +Ici, vous voyez une configuration de base pour le thème Toha. Vous pouvez voir le fichier de configuration utilisé dans le site d'exemple [ici](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/config.yaml). Pour des options de configurations plus détaillées, s'il vous plaît consultez [ce billet](https://toha-guides.netlify.app/posts/configuration/site-parameters/). #### Ajouter de données @@ -157,6 +157,7 @@ copyright: © 2020 Copyright. # Meta description de votre site. Ca aidera les moteurs de recherche à retrouver votre site. description: Portfolio and personal blog of John Doe. ``` + Pour voir toutes les options disponibles pour les informations du site, consulter [cet extrait de fichier](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/site.yaml). ##### Informations sur l'auteur @@ -190,7 +191,7 @@ summary: ##### Ajouter des sections -Maintenant, nous allons ajouter différentes section dans notre page d'accueil. D'abord, créons un répertoire `sections` à l'intérieur de votre répertoire `data/en`. Ici, nous allons ajouter quelques sections avec des configurations minimales. Pour voir les options détaillées de configuration pour les sections, veuillez consulter [ici](https://toha-guides.netlify.app/posts/configuration/sections/). +Maintenant, nous allons ajouter différentes sections dans notre page d'accueil. D'abord, créons un répertoire `sections` à l'intérieur de votre répertoire `data/en`. Ici, nous allons ajouter quelques sections avec des configurations minimales. Pour voir les options détaillées de configuration pour les sections, veuillez consulter [ici](https://toha-guides.netlify.app/posts/configuration/sections/). ###### La section A propos @@ -286,6 +287,7 @@ badges: # percentage: 75 # color: "#00adb5" ``` + Mettre le fichier `resume.pdf` dans le répertoire `/static/files`. Vous pouvez trouver le fichier `about.yaml` utilisé dans le site exemple depuis [ici](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/sections/about.yaml). ###### Section Compétences @@ -428,6 +430,7 @@ projects: summary: A Hugo theme for personal portfolio. tags: ["hobby","hugo","theme","professional"] ``` + Mettez les images des projets dans le répertoire `images/sections/projects/`. Vous trouverez les images [ici](https://github.com/hugo-toha/hugo-toha.github.io/tree/source/assets/images/sections/projects). Vous pouvez également trouver le fichier `projects.yaml` utilisé dans le site exemple par [là](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/sections/projects.yaml). ###### Section Billets récents @@ -481,6 +484,7 @@ achievements: image: /images/sections/achievements/woman-winner.jpg summary: Wined best paper award at IEE Conference 2020. ``` + Mettez les images des projets dans le répertoire `images/sections/achievements/`. Vous trouverez les images [ici](https://github.com/hugo-toha/hugo-toha.github.io/tree/source/assets/images/sections/achievements). Vous pouvez également trouver le fichier `achievements.yaml` utilisé dans le site exemple par [là](https://github.com/hugo-toha/hugo-toha.github.io/blob/source/data/en/sections/achievements.yaml). #### Ajout de billets @@ -494,7 +498,7 @@ Maintenant, nous sommes prêts à ajouter nos premiers billet dans notre site. I - Maintenant, créez un fichier `index.md` à l'intérieur du répertoire `introduction`. Ce fichier `index.md` contiendra les contenus du billet. - Ajoutez l'[extrait de contenus](https://raw.githubusercontent.com/hugo-toha/hugo-toha.github.io/source/content/posts/introduction/index.md) suivant dans le fichier `index.md` récemment créé. -Maintenant, votre billet devrait apparaître à `http://localhost:1313/posts` et votre section `Billets Récents` devrait aussi afficher la carte de ce billet. Pour traduire ce billet, créez simplement un nouveau fichier `index..md` dans le même répertoire. Puis, ajoutez le contenu traduit dedans. +Désormais, votre billet devrait apparaître à `http://localhost:1313/posts` et votre section `Billets Récents` devrait aussi afficher la carte de ce billet. Pour traduire ce billet, créez simplement un nouveau fichier `index..md` dans le même répertoire. Puis, ajoutez le contenu traduit dedans. Pour plus de billets d'échantillon, s'il vous plaît consultez [ici](https://github.com/hugo-toha/hugo-toha.github.io/tree/source/content/posts). From dcfb3f5e83948fc0682625c67e0f392cf68d00cb Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 10 Dec 2023 11:41:48 +0100 Subject: [PATCH 25/35] Fix a few markdown syntax & update french translation --- content/posts/quickstart/index.fr.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/content/posts/quickstart/index.fr.md b/content/posts/quickstart/index.fr.md index 547a6362..3a4f58dc 100644 --- a/content/posts/quickstart/index.fr.md +++ b/content/posts/quickstart/index.fr.md @@ -21,7 +21,7 @@ Pour exécuter ce thème localement, vous devez avoir les outils suivants instal 2. Langage [Go](https://go.dev/doc/install) version `v1.18.x` or plus. 3. Node version `v18.x` et npm version `8.x` ou plus. -Assurez-vous d'avoir les outils nécessaires dans les versions appropriées en utilisant les commandes suivantes. +Assurez-vous d'avoir les outils nécessaires dans les versions appropriées en utilisant les commandes suivantes. ```bash # Contrôle de la version de Hugo @@ -60,6 +60,7 @@ git clone git@github.com:/ #### Etape 3: Mettre à jour le fichier du module Vous devriez voir les fichiers `go.mod` et `go.sum` à la racine du dépôt. Mettez à jour la première ligne du fichier `go.mod` comme suit: + ```bash module github.com// ``` @@ -70,7 +71,8 @@ Maintenant, ouvrez le dépôt dans un éditeur et modifiez les configurations da ##### Modifier le `baseURL` -D'abord, modifiez le `baseURL` avec l'URL de votre site. Si vous voulez utilisez Github Pages pour héberger votre site, alors paramétrez comme suit: +D'abord, modifiez le `baseURL` avec l'URL de votre site. Si vous voulez utilisez Github Pages pour héberger votre site, alors paramètrez comme suit: + ```yaml baseURL: https://.github.io ``` @@ -85,7 +87,7 @@ gitRepo: https://github.com// ##### Désactiver l'analytique ou la configurer correctement -Le dépôt d'échantillon fournit le service Google Analytics pre-configuré. L'identifiant analytics indique le site d'origine. Donc, soit vous désactivez les analyses ou bien vous les configurez correctement selon ce [guide](/posts/analytics/). +Le dépôt d'échantillon fournit le service Google Analytics pré-configuré. L'identifiant analytics indique le site d'origine. Donc, soit vous désactivez les analyses, soit vous les configurez correctement selon ce [guide](/posts/analytics/). Vous pouvez désactiver les analyses en paramètrant le champ suivant sous la section `params.features` : @@ -96,7 +98,7 @@ analytics: ##### Désactiver la fonctionnalité de lettre d'information -Le dépôt d'échantillon fournit un service de lettre d'information [mailchimp](https://mailchimp.com/) pré-configuré. Désactivez le en paramètrant le champ suivant sous la section `params.footer`. +Le dépôt d'échantillon fournit un service de lettre d'information [mailchimp](https://mailchimp.com/) pré-configuré. Désactivez-le en paramètrant le champ suivant sous la section `params.footer`. ```yaml newsletter: @@ -124,9 +126,7 @@ c. Exécuter le site ```bash hugo server -w -``` - -
+``` Si tout se passe bien, vous devriez voir une sortie similaire à ceci. {{< img src="images/local_site.png" align="center" alt="Command to run site locally">}} @@ -155,4 +155,4 @@ git push origin HEAD - Ajouter les informations sur vos compétences en suivant [ce guide](/posts/configuration/sections/skills/). - Ajouter les informations sur vos expériences en suivant [ce guide](/posts/configuration/sections/experiences). - Déployer votre site sur Github Page en suivant le guide par [ici](/posts/getting-started/github-pages/). -- Déployer votre site sur Netlify en suivant le guide par [ici](/posts/getting-started/netlify/). \ No newline at end of file +- Déployer votre site sur Netlify en suivant le guide par [ici](/posts/getting-started/netlify/). From bee0f015413327070264a2a4fa19e3b054e3752f Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 10 Dec 2023 11:42:23 +0100 Subject: [PATCH 26/35] First translation into French --- .../posts/customizing/dark-theme/index.fr.md | 32 +++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 content/posts/customizing/dark-theme/index.fr.md diff --git a/content/posts/customizing/dark-theme/index.fr.md b/content/posts/customizing/dark-theme/index.fr.md new file mode 100644 index 00000000..26a9838e --- /dev/null +++ b/content/posts/customizing/dark-theme/index.fr.md @@ -0,0 +1,32 @@ +--- +title: "Activer le mode sombre" +date: 2022-06-12T01:30:50+06:00 +author: + name: Emruz Hossain + image: images/author/emruz.jpg +menu: + sidebar: + name: Activer le thème sombre + identifier: enable-dark-theme + parent: Personnalisation + weight: 405 +--- + +## Activation du mode sombre + +Toha `v3.6.0` a introduit un thème sombre. Un grand merci à [@donfiguerres](https://github.com/donfiguerres). Ce guide vous montrera comment l'activer. + +Tout d'abord, assurez-vous d'avoir mis à jour la version du thème en `v3.6.0` ou plus. Ensuite, ajoutez la section suivante sous la section `params` de votre fichier `config.yaml`. + +```yaml + darkMode: + enable: true + provider: darkreader + default: system +``` + +Ici, + +- **enable:** Spécifie ou non l'activation du mode sombre. +- **provider:** Spécifie le fournisseur sous-jacent qui sera utilisé pour fournir la fonctionnalité du mode sombre. Actuellement, il ne supporte que [darkreader](https://darkreader.org/). Nous pourrions soutenir d'autres fournisseurs dans le futur. +- **default:** Spécifie quel thème utiliser par défaut. Ca supporte les valeurs `system`, `light` et `dark`. From cf2d503ccdc8ea4dcd7081f0822c730cf56b3489 Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 10 Dec 2023 11:44:18 +0100 Subject: [PATCH 27/35] Fix markdown syntax and a few update of french translation --- content/posts/features/index.fr.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/posts/features/index.fr.md b/content/posts/features/index.fr.md index c3c1d419..41e4b6ac 100644 --- a/content/posts/features/index.fr.md +++ b/content/posts/features/index.fr.md @@ -23,7 +23,7 @@ Ce thème a été conçu pour être minimaliste et beau. Le schéma de couleur a ### Responsable -Ce thème est totalement responsable. Il est beau et cohérent sur les ordinateurs de bureau, ordinateurs portables, Tablettes, et appareils Mobile. +Ce thème est totalement responsable. Il est beau et cohérent sur les ordinateurs de bureau, ordinateurs portables, Tablettes, et appareils Mobile. {{< img src="images/responsive.png" align="center" >}} @@ -31,7 +31,7 @@ Ce thème est totalement responsable. Il est beau et cohérent sur les ordinateu ### Des cartes au design soigné -Les cartes de compétence et de projet ont été soigneusement conçue pour donner les plus utiles informations. Elle donne également au spectacteur une idée de l'étendu des connaissances sur une compétence particulière. Les cartes de projets donnent une idée de la popularité de vos projets s'il s'agit de projets open source sur Github. +Les cartes de compétence et de projet ont été soigneusement conçue pour donner les informations les plus utiles. Elle donne également au visiteur une idée de l'étendu des connaissances sur une compétence particulière. Les cartes de projets donnent une idée de la popularité de vos projets s'il s'agit de projets open source sur Github. {{< img src="images/cards.png" align="center" >}} @@ -69,4 +69,4 @@ Ca ne répond toujours pas à vos besoins ? Déposez une demande de fonctionnali ### Support multilingue -Ce thème intègre le support de multiples langues. Vous pouvez traduire votre contenu dans de multiples langues facilement pour une meilleure accessibilité. \ No newline at end of file +Ce thème intègre le support de multiples langues. Vous pouvez traduire votre contenu dans de multiples langues facilement pour une meilleure accessibilité. From 273293afda12cc069e170ca3a570684531e4eaf7 Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 10 Dec 2023 11:45:28 +0100 Subject: [PATCH 28/35] Fix front matter page and a few things --- .../posts/getting-started/github-pages/index.fr.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/content/posts/getting-started/github-pages/index.fr.md b/content/posts/getting-started/github-pages/index.fr.md index 5253f12e..82588469 100644 --- a/content/posts/getting-started/github-pages/index.fr.md +++ b/content/posts/getting-started/github-pages/index.fr.md @@ -5,11 +5,11 @@ menu: sidebar: name: Déployer dans Github Pages identifier: getting-started-github - parent: getting-started + parent: Démarrer weight: 20 --- -Dans ce billet, nous allons déployer le site que nous avons créé dans le précédent billet dans [Github Pages](https://pages.github.com/). D'abord, assurez-vous que le nom de votre dépôt soit `.github.io`. Ensuite, commitez n'importe quelles modifications locales et pousser dans Github. +Dans ce billet, nous allons déployer le site que nous avons créé dans le précédent billet dans [Github Pages](https://pages.github.com/). D'abord, assurez-vous que le nom de votre dépôt soit `.github.io`. Ensuite, commitez n'importe quelles modifications locales et poussez dans Github. #### Créer une branche `gh-pages` @@ -21,6 +21,7 @@ $ git checkout -b gh-pages # push de la branche source sur Github $ git push gh-pages gh-pages ``` + #### Activer Github Action Nous allons automatiser le processus de déploiement en utilisant [Github Actions](https://github.com/features/actions). D'abord, assurez-vous que Github Action soit activé dans votre dépôt. Allez dans `Settings > Actions` de votre dépôt assurez-vous que `Action permissions` est configuré sur `Allow all actions`. Ici, une capture d'écran du paramètre décrit. @@ -29,7 +30,7 @@ Nous allons automatiser le processus de déploiement en utilisant [Github Action #### Ajouter le flux de travail -Nous allons utiliser [peaceiris/actions-hugo](https://github.com/peaceiris/actions-hugo) action pour configurer hugo et [peaceiris/actions-gh-pages](https://github.com/peaceiris/actions-gh-pages) pour déployer le site. Créez un répertoire `.github` à la racine de votre dépôt. Ensuite, créez un répertoire `workflows` à l'intérieur du répertoire `.github`. Enfin, créez un fichier `deploy-site.yaml` à l'intérieur du répertoire `workflows` et ajoutez-y le contenu suivant: +Nous allons utiliser l'action [peaceiris/actions-hugo](https://github.com/peaceiris/actions-hugo) pour configurer hugo et [peaceiris/actions-gh-pages](https://github.com/peaceiris/actions-gh-pages) pour déployer le site. Créez un répertoire `.github` à la racine de votre dépôt. Ensuite, créez un répertoire `workflows` à l'intérieur du répertoire `.github`. Enfin, créez un fichier `deploy-site.yaml` à l'intérieur du répertoire `workflows` et ajoutez-y le contenu suivant: ```yaml name: Deploy to Github Pages @@ -104,7 +105,7 @@ Une fois la Github Action terminée avec succès, vous pouvez parcourir votre si Si vous possédez un nom de domaine et que vous souhaitez l'utiliser pour ce site, rendez-vous sur le site de votre fournisseur de nom de domaine. Ajoutez les enregistrements de ressources suivants: -``` +```console @ 3600 IN A 185.199.108.153 @ 3600 IN A 185.199.109.153 @ 3600 IN A 185.199.110.153 @@ -120,9 +121,10 @@ Pour vérifier votre domaine pour vous assurer que personne de Github ne puisse Enfin, créez un fichier `CNAME` à l'intérieur du répertoire `/static` de votre dépôt. Ajoutez votre nom de domaine là: -``` +```console example.com ``` + Une fois la Github Action terminée avec succès, vous pouvez parcourir votre site à `https://`. Notez qu'en naviguant sur `https://.github.io`, il redirigera automatiquement sur `https://`. \ No newline at end of file From ff9a82c08d3444941fba18f3fdd893512c380960 Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 10 Dec 2023 11:50:00 +0100 Subject: [PATCH 29/35] Initial file a French translation in Front Matter --- content/posts/getting-started/_index.fr.md | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 content/posts/getting-started/_index.fr.md diff --git a/content/posts/getting-started/_index.fr.md b/content/posts/getting-started/_index.fr.md new file mode 100644 index 00000000..2216ee91 --- /dev/null +++ b/content/posts/getting-started/_index.fr.md @@ -0,0 +1,8 @@ +--- +title: Démarrer +menu: + sidebar: + name: Démarrer + identifier: getting-started + weight: 10 +--- From a2e1c3883e7b2ebd6e8e0f65fcbb7f2068deea86 Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 10 Dec 2023 11:55:07 +0100 Subject: [PATCH 30/35] Initial file a French translation in Front Matter --- content/posts/customizing/_index.fr.md | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 content/posts/customizing/_index.fr.md diff --git a/content/posts/customizing/_index.fr.md b/content/posts/customizing/_index.fr.md new file mode 100644 index 00000000..a8561b94 --- /dev/null +++ b/content/posts/customizing/_index.fr.md @@ -0,0 +1,8 @@ +--- +title: Personnalisation +menu: + sidebar: + name: Personnalisation + identifier: customizing + weight: 400 +--- \ No newline at end of file From 6c9a742b7b7c45f9064d35a795539bdb2bb7257b Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 10 Dec 2023 11:59:50 +0100 Subject: [PATCH 31/35] Fixe Front Matter and fullfrench translation page --- .../posts/getting-started/netlify/index.fr.md | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/content/posts/getting-started/netlify/index.fr.md b/content/posts/getting-started/netlify/index.fr.md index bca436e5..adddc748 100644 --- a/content/posts/getting-started/netlify/index.fr.md +++ b/content/posts/getting-started/netlify/index.fr.md @@ -5,17 +5,17 @@ menu: sidebar: name: Déployer dans Netlify identifier: getting-started-netlify - parent: getting-started + parent: Démarrer weight: 30 --- -[Netlify](https://www.netlify.com/) offers an excellent and easy process for deploying hugo static site. You can deploy your site in matter of few clicks. Unlike Github Pages, you can name your repository whatever you want. You can also customize the site URL. +[Netlify](https://www.netlify.com/) offre un facile et excellent processus pour le déploiement d'un site statique hugo. Vous pouvez déployer votre site en quelques clics. Contrairement à Github Pages, vous pouvez nommer votre dépôt comme vous le souhaitez. Vous pouvez également personnaliser l'URL du site. -In this post, we will show the step-by-step process of deploying a hugo site with netlify. +Dans ce billet, nous montreons le processus pas-à-pas d'un déploiement de site hugo avec Netlify. -### Add Netlify Configuration +### Ajouter une configuration de Netlify -At first, create a `netlify.toml` file at the root of your repository and add the following configuration there: +D'abord, créons un ficher `netlify.toml` à la racine de votre dépôt et ajoutez-y la configuration suivante: ```toml [build] @@ -58,29 +58,29 @@ command = "hugo mod tidy && hugo mod npm pack && npm install && hugo --gc --mini HUGO_ENABLEGITINFO = "true" ``` -Commit and push the `netlify.toml` file into Github. Now, you are ready to deploy your site with netlify. +Commit et pousser le fichier `netlify.toml` dans Github. Maintenant, vous être prêt à déployer votre site sur Netlify. -### Deploy Site +### Déploiement du site -Now, login into [netlify](https://www.netlify.com/). Then, go to `Sites` tab of your netlify dashboard and click `New site form Git` button. +Maintenant, connectez-vous sur [netlify](https://www.netlify.com/). Ensuite, rendez-vous dans l'onglet `Sites` de votre tableau de bord et cliquez sur le bouton `New site form Git`. {{< img src="images/2.png" align="center" >}} {{< vs 2 >}} -A new popup will open. Select `Github` and authenticate, with your Github account. +Une nouvelle pop-up s'ouvrira. Sélectionnez `Github` et authentifiez-vous, avec votre compte Github. {{< img src="images/3.png" align="center" >}} {{< vs 2 >}} -After authenticating, it will ask to select your desired repository. Select the repository you are using for your site. +Après l'authentification, on vous demandera de sélectionnez le dépôt désiré. Sélectionnez le dépôt que vous utilisez pour votre site. {{< img src="images/4.png" align="center" >}} {{< vs 2 >}} -Now, netlify will take you to the deployment page. Select the branch you want to deploy. Netlify should automatically populate the required fields from the `netlify.toml` file you created earlier in this post. When you are satisfied with the configurations, press the `Deploy` button. +Maintenant, Netlify vous mènera à la page de déploiement. Sélectionnez la branche que vous voulez déployer. Netlify devrait remplir automatiquement les champs requis à partir du fichier `netlify.toml` que vous avez créé un peu plus tôt dans ce billet. Quand vous êtes satisfait des configurations, appuyez sur le bouton `Deploy` {{< img src="images/5.png" align="center" >}} @@ -90,7 +90,7 @@ Now, netlify will start publishing your site immediately. Wait for the publishin {{< img src="images/6.png" align="center" >}} -### Customize URL +### Personnalisation de l'URL You can easily customize the URL of your site with just few clicks as shown below. @@ -104,7 +104,7 @@ You can easily customize the URL of your site with just few clicks as shown belo {{< vs 2 >}} -3. Then, give your site whatever name you want. +3. Alors, donnez à votre site le nom que vous voulez {{< img src="images/9.png" align="center" >}} From 76697ce146d9dd130e8963d35f7559ff6e88042f Mon Sep 17 00:00:00 2001 From: Nicolas DIETLIN Date: Sun, 10 Dec 2023 12:44:07 +0100 Subject: [PATCH 32/35] Initial full french translation --- content/posts/comments/index.fr.md | 91 ++++++++++++++++++++++++++++++ 1 file changed, 91 insertions(+) create mode 100644 content/posts/comments/index.fr.md diff --git a/content/posts/comments/index.fr.md b/content/posts/comments/index.fr.md new file mode 100644 index 00000000..df073cf7 --- /dev/null +++ b/content/posts/comments/index.fr.md @@ -0,0 +1,91 @@ +--- +title: "Commentaires" +date: 2022-03-14T06:00:23+06:00 +description: Ajouter des commandes dans le thème Toha +menu: + sidebar: + name: Commentaires + identifier: comments + weight: 650 +--- +## Commentaires + +Ce thème supporte les commentaires dans les billets. Actuellement, il supporte les plugins de commentaires suivants: + +- [Disqus](https://disqus.com/) +- [Valine](https://valine.js.org/) +- [Utterances](https://utteranc.es/) +- [Giscus](https://giscus.app/) + +### Disqus + +Disqus est un plugin de commentaires très populaire. Après vous êtes inscrit sur [Disqus](https://disqus.com/) vous aurez besoin de fournir votre pseudonyme sous la section `params.features.comment` de votre fichier `config.yaml` comme ci-après: + +```yaml +params: + features: + comment: + enable: true + disqus: + shortName: +``` + +### Valine + +[Valine](https://valine.js.org/) semble être un plugin de commentaires chinois. Vous pouvez activer le plugin de commentaires `valine` en ajoutant une section `valine` sous `params.features.comments` de votre fichier `config.yaml` comme ci-après: + +```yaml +params: + features: + comment: + enable: true + valine: + appId: app-id + appKey: app-key + avatar: avatar + placeholder: placeholder + lang: lang + recordIP: recordIP + enableQQ: enableQQ +``` + +### Utterances + +Utterances utilise [GitHub Issues](https://docs.github.com/en/issues/tracking-your-work-with-issues/about-issues) pour stocker les commentaires de vos billets. Cela nécessite que vous ayez un dépôt publique, et l'applications Utterances utilise votre dépôt. Les instructions de configuration peuvent être trouvées sur la [page d'accueil d'Utterances](https://utteranc.es/) + +```yaml +params: + features: + comment: + enable: true + utteranc: + repo: your-repo/name + issueTerm: url + theme: light +``` + +### Giscus + +Giscus est basé sur Utterances, mais utilise [GitHub Discussions](https://docs.github.com/en/discussions) comme backend. Cela nécessite que vous ayez un dépôt public, et que l'application Giscus utilise votre dépôt. Les instructions de configuration peuvent être trouvées sur la [page d'accueil de Giscus](https://giscus.app/). + +Pour activer le plugin de commentaires de Giscus, allez d'abord sur [giscus.app](https://giscus.app/). Dans la section `configuration`, fournissez les informations nécessaires. Il vous donnera un script à inclure dans votre site. Vous avez juste besoin d'extraire les informations respectives du script et de les fournir sous la section `params.features.comment.giscus` ci-après: + +```yaml +params: + features: + comment: + enable: true + giscus: + repo: your-repo/name + repoID: your-repo-id + category: your-category + categoryID: your-category-id + # theme: light + # map: url + # reaction: 1 + # metadata: 0 + # inputPosition: bottom + # crossOrigin: anonymous +``` + +Les options commentées sont facultatives. Vous pouvez les utiliser pour personnaliser davantage l'expérience des commentaires. From 67905f15ba08bed20af4e82a275d354127e77621 Mon Sep 17 00:00:00 2001 From: Nicolas Date: Sat, 13 Jan 2024 12:21:23 +0100 Subject: [PATCH 33/35] Update French Translation --- .../configuration/site-parameters/index.fr.md | 211 ++++++++++++++++ .../posts/getting-started/netlify/index.fr.md | 16 +- .../getting-started/prepare-site/index.fr.md | 6 +- content/posts/quickstart/index.fr.md | 12 +- content/posts/shortcodes/index.fr.md | 169 +++++++++++-- content/posts/supports/index.fr.md | 4 +- .../writing-posts/markdown-syntax/index.fr.md | 156 ++++++++++++ content/posts/writing-posts/math/index.fr.md | 50 ++++ .../posts/writing-posts/mermaid/index.fr.md | 232 ++++++++++++++++++ 9 files changed, 821 insertions(+), 35 deletions(-) create mode 100644 content/posts/configuration/site-parameters/index.fr.md create mode 100644 content/posts/writing-posts/markdown-syntax/index.fr.md create mode 100644 content/posts/writing-posts/math/index.fr.md create mode 100644 content/posts/writing-posts/mermaid/index.fr.md diff --git a/content/posts/configuration/site-parameters/index.fr.md b/content/posts/configuration/site-parameters/index.fr.md new file mode 100644 index 00000000..6a7e36ed --- /dev/null +++ b/content/posts/configuration/site-parameters/index.fr.md @@ -0,0 +1,211 @@ +--- +title: "Configuration des paramètres du site" +date: 2020-06-08T06:20:55+06:00 +menu: + sidebar: + name: Paramètres du site + identifier: configuration-site-parameters + parent: configuration + weight: 105 +--- + +Après l'installation du thème, quand vous lancez le site pour la première fois, cela démarrera avec les paramètres par défaut. Cela devrait avoir l'apparence du site d'exemple excepté qu'il n'a pas de sections sur la page d'accueil. Ces sections sont ajoutées via quelques fichiers de données. Dans les prochains billets, je vais vous montrer comment vous pouvez ajouter ces sections en fournissant des fichiers de données. + +Dans ce billet, je vais vous montrer comment vous pouvez changer les paramètres du site pour modifier l'arrière plan, le logo, les informations de l'auteur, et activer/désactiver différentes fonctionnalités. + +### Ajouter une image d'arrière plan + +D'abord, on va paramètrer un arrière plan sur votre site. Mettez l'image d'arrière plan désirée dans le répertoire `assets/images`. Ensuite, ajoutez ce qui suit dans la section `params` de votre fichier `config.yaml`. + +```yaml +background: "images/" +``` + +### Ajouter un logo à votre site + +Maintenant, ajoutons un logo pour votre site. Vous devez fournir deux logos différents. Un pour la barre de navigation transparente et un autre pour la barre de navigation non transparente. Placez vos logos dans le répertoire `assets/images` et ajoutez ce qui suit dans la section `params` du fichier `config.yaml`. + +```yaml +# The inverted logo will be used in the initial transparent navbar and +# the main logo will be used in the non-transparent navbar. +logo: + main: images/main-logo.png + inverted: images/inverted-logo.png + favicon: images/favicon.png +``` + +### Activer les articles de blog + +Si vous voulez écrire quelques articles de blog, vous devez d'abord l'activer. Activons la publication d'articles de blog en ajoutant ce qui suit dans la section `params` de votre fichier `config.yaml`. + +```yaml +enableBlogPost: true +``` + +### Activer `Table Of Contents` + +Maintenant, si vous voulez afficher la section `Table Of Contents` dans votre article de blog, vous devez d'abord l'activer dans la section `params` de votre fichier `config.yaml`. + +```yaml +enableTOC: true +``` +Vous pouvez également contrôler le niveau de votre table des matières en ajoutant la configuration suivante dans la section `markup` de votre fichier `config.yaml`. + +```yaml +markup: + tableOfContents: + startLevel: 2 + endLevel: 6 + ordered: false +``` + +Ici, nous avons configuré notre table des matières pour montrer tous les titres à partir de `h2` jusqu'à `h6`. + +### Activer le bouton `` + +Si vous voulez fournir à vos visiteurs un moyen facile d'améliorer un article (par exemple une faute de frappe, un correctif d'indentation, etc.), vous pouvez activer le bouton `` en ajoutant l'URL de votre dépôt Git dans la section `params` de votre fichier `config.yaml`. + +```yaml +gitRepo: +``` + +Cela ajoutera un bouton labelisé `Improve This Page` au pied de chaque billet. Le bouton redirigera l'utilisateur directement vers le formulaire d'édition de Github de la page. + +Si vous branche par défaut ne s'appelle pas `main`, alors vous aurez besoin d'ajouter votre branche git par défaut dans la section `params` de votre fichier `config.yaml`. +```yaml +gitBranch: +``` + +### Activer/Désactiver la Newsletter + +La fonctionnalité de newsletter supporte seulement Mailchimp actuellement. +Ajoutez ce qui suit dans la section `params` du fichier `config.yaml`. + +```yaml +newsletter: + enable: true + provider: mailchimp + mailchimpURL: https://github.us1.list-manage.com/subscribe/post?u=19de52a4603135aae97163fd8&id=094a24c76e +``` + +Si vous ne voulez pas utliser la fonctionnalité de newsletter, vous pouvez la masquer en ajoutant ce qui suit dans la section `params` du fichier `config.yaml`. + +```yaml +newsletter: + enable: false +``` + +### Activer le RAW HTML dans le fichier Markdown + +Si vous voulez utiliser le RAW HTML dans vos fichiers markdown, vous devez activier le rendu non sécurisé. Sinon, Hugo n'affichera pas le rendu HTML. Vous pouvez activer le rendu markdown non sécurisé en ajoutant les paramètres `goldmark` suivants dans la section `markup` du fichier `config.yaml`. + +```yaml +markup: + goldmark: + renderer: + unsafe: true +``` + +### Ajouter les informations de l'auteur + +Maintenant, fournissons vos informations de base. Créez un fichier `author.yaml` dans le répertoire `/data` et ajoutez-y les informations sur l'auteur. + +```yaml +# some information about you +name: "John Doe" +nickname: "John" +# greeting message before your name. it will default to "Hi! I am" if not provided +greeting: "Hi, I am" +image: "images/author/john.png" +# give your some contact information. they will be used in the footer +contactInfo: + email: "johndoe@example.com" + phone: "+0123456789" + github: johndoe + linkedin: johndoe + +# some summary about what you do +summary: + - I am a Developer + - I am a Devops + - I love servers + - I work on open-source projects + - I love to work with some fun projects +``` + +> Note: Les paramètres `contactInfo` utiliseront le paramètre `icon` pour trouver l'icône. Ce paramètre doit correspondre au nom de l'icône géniale [examples](https://fontawesome.com/search?o=r&f=brands) + +### Ajouter l'avis du droit d'auteur + +On va jouter un avis de droit d'auteur pour votre site. Ca sera affiché en bas du pied de page. Créez un fichier `site.yaml` dans votre répertoire `data` et ajoutez-y la section suivante. + +```yaml +copyright: © 2020 Copyright. +``` + +### La description du site + +Maintenant, ajoutez une description de votre site qui aidera les moteurs de recherche à trouver votre site. Ajoutez une section de description dans votre votre fichier `site.yaml`. + +```yaml +# Meta description for your site. This will help the search engines to find your site. +description: Example site for hugo theme Toha. +``` + +### Ajout d'un menu personnalisé + +Si vous voulez ajouter quelques menus personnalisé dans la barre de navigation, vous pouvez facilement les ajouter par l'ajout de ce qui suit dans le fichier `site.yaml`. + +Les menus personnalisés sont visibles dans la barre de navigation par défaut. Pour les masquer, paramètrez `hideFromNavbar` sur `true`. Les menus personnalisés sont masqués par défaut dans la zone de navigation du pied de page. Pour afficher un élément de menu personnalisé dans le pied de page, paramètrez sa propriété `showOnFooter` sur `true`. + +```yaml +customMenus: +- name: Notes + url: https://hossainemruz.gitbook.io/notes/ + hideFromNavbar: false + showOnFooter: true +``` + +Cela peut être particulièrement utile lorsque vous souhaitez ajouter un lien vers un autre site dans votre barre de navigation. + +### Exemple de Section `params` + +Pour terminer, voici la section `params` utilisée dans le site d'exemple. + +```yaml +# Site parameters +params: + # background image of the landing page + background: "images/background.jpg" + + # Provide logos for your site. The inverted logo will be used in the initial + # transparent navbar and the main logo will be used in the non-transparent navbar. + # It will default to the theme logos if not provided. + logo: + main: images/main-logo.png + inverted: images/inverted-logo.png + favicon: images/favicon.png + + # GitHub repo URL of your site + gitRepo: https://github.com/hossainemruz/toha-example-site + + features: + # Enable and configure blog posts + blog: + enable: true + + # specify whether you want to show Table of Contents in reading page + toc: + enable: true + + # Show/hide newsletter section in the footer. Default is "true". + # Currently, it supports "mailchimp". + newsletter: + enable: false + # provider: mailchimp + # mailchimpURL: https://github.us1.list-manage.com/subscribe/post?u=19de52a4603135aae97163fd8&id=094a24c76e + + # Show/hide disclaimer notice in the footer. Default is "false". + disclaimer: + enable: true +``` diff --git a/content/posts/getting-started/netlify/index.fr.md b/content/posts/getting-started/netlify/index.fr.md index adddc748..a41b8d16 100644 --- a/content/posts/getting-started/netlify/index.fr.md +++ b/content/posts/getting-started/netlify/index.fr.md @@ -5,13 +5,13 @@ menu: sidebar: name: Déployer dans Netlify identifier: getting-started-netlify - parent: Démarrer + parent: getting-started weight: 30 --- [Netlify](https://www.netlify.com/) offre un facile et excellent processus pour le déploiement d'un site statique hugo. Vous pouvez déployer votre site en quelques clics. Contrairement à Github Pages, vous pouvez nommer votre dépôt comme vous le souhaitez. Vous pouvez également personnaliser l'URL du site. -Dans ce billet, nous montreons le processus pas-à-pas d'un déploiement de site hugo avec Netlify. +Dans ce billet, nous montrerons le processus pas-à-pas d'un déploiement de site hugo avec Netlify. ### Ajouter une configuration de Netlify @@ -86,30 +86,30 @@ Maintenant, Netlify vous mènera à la page de déploiement. Sélectionnez la br {{< vs 2 >}} -Now, netlify will start publishing your site immediately. Wait for the publishing process to complete. Once, the site has been published, you can browse your site at the URL automatically generated by netlify. The auto-generated URL has been pointed out by a red rectangle in the screenshot below. +Maintenant, netlify va commencer à publier votre site immédiatement. Attendez que le processus de publication soit achevé. Une fois le site publié, vous pouvez parcourir votre site à l'URL générée automatiquement par netlify. L'URL générée automatiquement a été indiqué par le rectangle rouge sur la capture d'écran ci-dessous. {{< img src="images/6.png" align="center" >}} ### Personnalisation de l'URL -You can easily customize the URL of your site with just few clicks as shown below. +Vous pouvez facilement personnaliser l'URL de votre site en quelques clics seulement comme indiqué ci-dessous. -1. Click the `Domain Setting` button under `Site Overview` tab. +1. Cliquez sur le bouton `Domain Setting` sous l'onglet `Site Overview`. {{< img src="images/7.png" align="center" >}} -2. Now, you can either add your own domain by clicking on `Add custom domain` button or you can just use `.netlify.app` domain. Here, we are going with the later. Click the `options` dropdown and select `Edit site name`. +2. Maintenant, soit vous ajoutez votre propre domaine en cliquant sur le bouton `Add custom domain` ou bien vous pouvez juste utiliser le domaine `.netlify.app`. Ici, c'est ce que nous feront après. Cliquez sur le bouton `options` et sélectionnez `Edit site name`. {{< img src="images/8.png" align="center" >}} {{< vs 2 >}} -3. Alors, donnez à votre site le nom que vous voulez +3. Ensuite, donnez à votre site le nom que vous voulez. {{< img src="images/9.png" align="center" >}} {{< vs 2 >}} -4. Once you have saved the new name, you will see the URL of your site has been updated instantly. Now, you can browse your site at the new URL. +4. Une fois que vous avez sauvegardé le nouveau nom, vous verrez que l'URL de votre site a été mise à jour instantanément. Maintenant, vous pouvez parcourir votre site à la nouvelle URL. {{< img src="images/10.png" align="center" >}} diff --git a/content/posts/getting-started/prepare-site/index.fr.md b/content/posts/getting-started/prepare-site/index.fr.md index 673ad5ea..15dda09c 100644 --- a/content/posts/getting-started/prepare-site/index.fr.md +++ b/content/posts/getting-started/prepare-site/index.fr.md @@ -5,7 +5,7 @@ menu: sidebar: name: Préparer votre site identifier: getting-started-prepare-site - parent: Démarrer + parent: getting-started weight: 10 --- @@ -24,10 +24,10 @@ D'abord, créez un dépôt sur Github. Si vous voulez déployer ce site dans Git Maintenant, assurez-vous d'avoir [Hugo](https://gohugo.io/getting-started/installing/) installé. Ce thème devrait fonctionner avec hugo version `v0.118.0` et plus. Maintenant, lancez la commande suivante depuis la racine de votre dépôt pour initier un site web hugo. ```console -$ hugo new site ./ -f=yaml --force +$ hugo new site ./ -f --format yaml ``` -Cette commande créera une structure de base d'un site hugo. Ici, le flag `-f=yaml` indique à hugo de créer un fichier de configuration au format YAML et le flag `--force` force hugo à créer un site même si le répertoire cible n'est pas vide. +Cette commande créera une structure de base d'un site hugo. Ici, le flag `--format yaml` indique à hugo de créer un fichier de configuration au format YAML et le flag `-f` force hugo à créer un site même si le répertoire cible n'est pas vide. ### Initialiser le dépôt git diff --git a/content/posts/quickstart/index.fr.md b/content/posts/quickstart/index.fr.md index 3a4f58dc..6616bde1 100644 --- a/content/posts/quickstart/index.fr.md +++ b/content/posts/quickstart/index.fr.md @@ -150,9 +150,9 @@ git push origin HEAD ### Et ensuite ? -- Personnaliser l'arrière-plan, le logo, et quelques autres choses de votre site en suivant [ce guide](/posts/configuration/site-parameters/). -- Ajouter des informations sur vous en suivant [ce guide](/posts/configuration/sections/about/). -- Ajouter les informations sur vos compétences en suivant [ce guide](/posts/configuration/sections/skills/). -- Ajouter les informations sur vos expériences en suivant [ce guide](/posts/configuration/sections/experiences). -- Déployer votre site sur Github Page en suivant le guide par [ici](/posts/getting-started/github-pages/). -- Déployer votre site sur Netlify en suivant le guide par [ici](/posts/getting-started/netlify/). +- Personnaliser l'arrière-plan, le logo, et quelques autres choses de votre site en suivant [ce guide](/posts/configuration/site-parameters/index.fr.md). +- Ajouter des informations sur vous en suivant [ce guide](/posts/configuration/sections/about/index.fr.md). +- Ajouter les informations sur vos compétences en suivant [ce guide](/posts/configuration/sections/skills/index.fr.md). +- Ajouter les informations sur vos expériences en suivant [ce guide](/posts/configuration/sections/experiences/index.fr.md). +- Déployer votre site sur Github Page en suivant le guide par [ici](/posts/getting-started/github-pages/index.fr.md). +- Déployer votre site sur Netlify en suivant le guide par [ici](/posts/getting-started/netlify/index.fr.md). diff --git a/content/posts/shortcodes/index.fr.md b/content/posts/shortcodes/index.fr.md index 44504d51..bdcd4755 100644 --- a/content/posts/shortcodes/index.fr.md +++ b/content/posts/shortcodes/index.fr.md @@ -1,73 +1,149 @@ --- -title: "Codes abrégés" +title: "Les Shortcodes" date: 2023-11-05T14:06:25+02:00 description: "Codes abrégés" menu: sidebar: - name: "Codes abrégés" + name: "Les Shortcodes" identifier: shortcodes weight: 700 hero: boat.jpg --- -Ce billet échantillon est destiné à tester les éléments suivants : +Ce billet d'échantillon est destiné à tester les éléments suivants : - Manipulation d'une image. - Différents shortcodes. ## Alerte -Les alertes suivantes sont disponibles dans ce thème. +Ce thème propose différents types d'alertes pour votre publication. Par exemple, si on ajoute le code ci-dessous : +``` {{< alert type="success" >}} -Voici une alerte avec `type="success"`. +This is sample alert with `type="success"`. {{< /alert >}} +``` +L'alerte qui apparaîtra ressemblera à ça: + +{{< alert type="success" >}} +This is sample alert with `type="success"`. +{{< /alert >}} + +Les alertes suivantes sont également disponible dans ce thème. +``` {{< alert type="danger" >}} -Voici une alerte avec `type="danger"`. +This is sample alert with `type="danger"`. {{< /alert >}} +``` +{{< alert type="danger" >}} +This is sample alert with `type="danger"`. +{{< /alert >}} + +``` {{< alert type="warning" >}} -Voici une alerte avec `type="warning"`. +This is sample alert with `type="warning"`. {{< /alert >}} +``` +{{< alert type="warning" >}} +This is sample alert with `type="warning"`. +{{< /alert >}} + +``` +{{< alert type="info" >}} +This is sample alert with `type="info"`. +{{< /alert >}} +``` {{< alert type="info" >}} -Voici une alerte avec `type="info"`. +This is sample alert with `type="info"`. +{{< /alert >}} + +``` +{{< alert type="dark" >}} +This is sample alert with `type="dark"`. {{< /alert >}} +``` {{< alert type="dark" >}} -Voici une alerte avec `type="dark"`. +This is sample alert with `type="dark"`. +{{< /alert >}} + +``` +{{< alert type="primary" >}} +This is sample alert with `type="primary"`. {{< /alert >}} +``` {{< alert type="primary" >}} -Voici une alerte avec `type="primary"`. +This is sample alert with `type="primary"`. {{< /alert >}} +``` {{< alert type="secondary" >}} -Voici une alerte avec `type="secondary"`. +This is sample alert with `type="secondary"`. +{{< /alert >}} +``` + +{{< alert type="secondary" >}} +This is sample alert with `type="secondary"`. {{< /alert >}} ## Image #### Une image sans attributs. +**Code:** + +```markdown +{{}} +``` + +**Résultat:** + {{< img src="/posts/shortcodes/boat.jpg" title="A boat at the sea" >}} {{< vs 3 >}} #### Une image avec les attributs `height` et `width`. +**Code:** + +```markdown +{{}} +``` + +**Résultat:** + {{< img src="/posts/shortcodes/boat.jpg" height="400" width="600" title="A boat at the sea" >}} {{< vs 3 >}} #### Une image centrée avec les attributs `height` et `width`. +**Code:** + +```markdown +{{}} +``` + +**Résultat:** + {{< img src="/posts/shortcodes/boat.jpg" height="400" width="600" align="center" title="A boat at the sea" >}} {{< vs 3 >}} #### Une image avec l'attribut `float`. +**Code:** + +```markdown +{{}} +``` + +**Résultat:** + {{< img src="/posts/shortcodes/boat.jpg" height="200" width="500" float="right" title="A boat at the sea" >}} Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras egestas lectus sed leo ultricies ultricies. Praesent tellus risus, eleifend vel efficitur ac, venenatis sit amet sem. Ut ut egestas erat. Fusce ut leo turpis. Morbi consectetur sed lacus vitae vehicula. Cras gravida turpis id eleifend volutpat. Suspendisse nec ipsum eu erat finibus dictum. Morbi volutpat nulla purus, vel maximus ex molestie id. Nullam posuere est urna, at fringilla eros venenatis quis. @@ -80,15 +156,34 @@ Ce thème supporte le découpage de la page en autant de colonnes que vous le so #### Diviser en 2 colonnes +**Code:** + +```markdown +{{}} +##### Colonne de gauche + +Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras egestas lectus sed leo ultricies ultricies. + +--- + +##### Colonne de droite + +Fusce ut leo turpis. Morbi consectetur sed lacus vitae vehicula. Cras gravida turpis id eleifend volutpat. + +{{}} +``` + +**Result:** + {{< split 6 6>}} -##### Colonne de Gauche +##### Colonne de gauche Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras egestas lectus sed leo ultricies ultricies. --- -##### Colonne de Droite +##### Colonne de droite Fusce ut leo turpis. Morbi consectetur sed lacus vitae vehicula. Cras gravida turpis id eleifend volutpat. @@ -96,21 +191,46 @@ Fusce ut leo turpis. Morbi consectetur sed lacus vitae vehicula. Cras gravida tu #### Diviser en 3 colonnes +**Code:** + +```markdown +{{}} +##### Colonne de gauche + +Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras egestas lectus sed leo ultricies ultricies. + +--- + +##### Colonne du milieu + +Aenean dignissim dictum ex. Donec a nunc vel nibh placerat interdum. + +--- + +##### Colonne de droite + +Fusce ut leo turpis. Morbi consectetur sed lacus vitae vehicula. Cras gravida turpis id eleifend volutpat. + +{{}} +``` + +**Result:** + {{< split 4 4 4 >}} -##### Colonne de Gauche +##### Colonne de gauche Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras egestas lectus sed leo ultricies ultricies. --- -##### Colonne du Milieu +##### Colonne du milieu Aenean dignissim dictum ex. Donec a nunc vel nibh placerat interdum. --- -##### Colonne de Droite +##### Colonne de droite Fusce ut leo turpis. Morbi consectetur sed lacus vitae vehicula. Cras gravida turpis id eleifend volutpat. @@ -120,12 +240,29 @@ Fusce ut leo turpis. Morbi consectetur sed lacus vitae vehicula. Cras gravida tu Donner un espace vertical entre deux lignes. +**Code:** + +```markdown +Voici la ligne 1. +{{< vs 4>}} +Voici la ligne 2. Il devrait y avoir un espace vertical de `4rem` avec la ligne précédente. +``` + +**Résultat:** + Voici la ligne 1. {{< vs 4>}} Voici la ligne 2. Il devrait y avoir un espace vertical de `4rem` avec la ligne précédente. ## Vidéo +**Code:** + +```markdown +{{}} +``` + +**Résultat:** {{< video src="/videos/sample.mp4" >}} diff --git a/content/posts/supports/index.fr.md b/content/posts/supports/index.fr.md index 621a8037..e92855aa 100644 --- a/content/posts/supports/index.fr.md +++ b/content/posts/supports/index.fr.md @@ -1,10 +1,10 @@ --- -title: "Les liens de soutien" +title: "Les liens de soutien/donation" date: 2022-03-14T06:00:23+06:00 description: Adding support links in hugo theme Toha menu: sidebar: - name: Support Links + name: Liens de soutien identifier: supports weight: 660 --- diff --git a/content/posts/writing-posts/markdown-syntax/index.fr.md b/content/posts/writing-posts/markdown-syntax/index.fr.md new file mode 100644 index 00000000..76580bc8 --- /dev/null +++ b/content/posts/writing-posts/markdown-syntax/index.fr.md @@ -0,0 +1,156 @@ +--- +title: "Guide Syntaxique Markdown" +date: 2020-06-08T06:15:40+06:00 +hero: /images/posts/writing-posts/code.svg +menu: + sidebar: + name: Guide Markdown + identifier: writing-post-md-guide + parent: writing-post + weight: 30 +--- + +Cet article propose un échantillon des syntaxes de base du Markdown qui peut être utilisé dans les fichiers de contenu d'Hugo, et montre également des balises HTML de base décorés avec CSS dans un thème Hugo. + + + +## En-têtes + +Les éléments HTML suivant `

`—`

` représentent six niveaux de titres de section. `

` est le niveau le plus élevé tandis que le `

` est le plus bas. + +# H1 +## H2 +### H3 +#### H4 +##### H5 +###### H6 + +## Paragraphe + +Xerum, quo qui aut unt expliquam qui dolut labo. Aque venitatiusda cum, voluptionse latur sitiae dolessi aut parist aut dollo enim qui voluptate ma dolestendit peritin re plis aut quas inctum laceat est volestemque commosa as cus endigna tectur, offic to cor sequas etum rerum idem sintibus eiur? Quianimin porecus evelectur, cum que nis nust voloribus ratem aut omnimi, sitatur? Quiatem. Nam, omnis sum am facea corem alique molestrunt et eos evelece arcillit ut aut eos eos nus, sin conecerem erum fuga. Ri oditatquam, ad quibus unda veliamenimin cusam et facea ipsamus es exerum sitate dolores editium rerore eost, temped molorro ratiae volorro te reribus dolorer sperchicium faceata tiustia prat. + +Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sapicia is sinveli squiatum, core et que aut hariosam ex eat. + +## Bloc de citation + +Les éléments blockquote représentent le contenu qui est coté à partir d'une autre source, éventuellement avec une citation qui doit être dans un élément `footer` ou `cite`, et éventuellement avec des changments en ligne tel que les annotations et les abrévations. + +#### Bloc de citation sans attribution + +> Tiam, ad mint andaepu dandae nostion secatur sequo quae. +> **Notez** que vous pouvez utiliser la *syntaxe Markdown* à l'intérieur d'un bloc de citation. + +#### Bloc de citation avec attribution + +> Don't communicate by sharing memory, share memory by communicating.

+> — Rob Pike[^1] + + +[^1]: The above quote is excerpted from Rob Pike's [talk](https://www.youtube.com/watch?v=PAAkCSZUG1c) during Gopherfest, November 18, 2015. + +## Tableaux + +Les tableaux ne font pas partie de la spécification de base du Markdown, mais Hugo les supportent hors-des-clous. + + | Name | Age | + | ----- | --- | + | Bob | 27 | + | Alice | 23 | + +#### Markdown en ligne dans les tableaux + +| Inline    | Markdown    | In    | Table | +| ------------------------ | -------------------------- | ----------------------------------- | ------ | +| *italics* | **bold** | ~~strikethrough~~    | `code` | + +## Blocs de code + +#### Bloc de code avec backticks + +``` +html + + + + + Example HTML5 Document + + +

Test

+ + +``` +#### bloc de code indenté avec quatre espaces + + + + + + Example HTML5 Document + + +

Test

+ + + +#### Bloc de code avec code abrégé de mise en évidence d'Hugo +{{< highlight html >}} + + + + + Example HTML5 Document + + +

Test

+ + +{{< /highlight >}} + +## Types de liste + +#### Liste ordonnée + +1. Première point +2. Second point +3. Troisième point + +#### Liste non ordonnée + +* Element de la liste +* Autre élément +* Et un autre élément + +#### listes imbriquées + +* Fruit + * Pomme + * Orange + * Banane +* Selle + * Lait + * Fromage + +## Autres Elements — abbr, sub, sup, kbd, mark + +Ici, vous trouverez d'autres balises HTML décorées par CSS: +``` +GIF est un format d'image bitmap. +``` +GIF est un format d'image bitmap. +``` +H2O +``` +H2O +``` +Xn + Yn = Zn +``` +Xn + Yn = Zn +``` +Pressez CTRL+ALT+Delete pour terminer la session. +``` +Pressez CTRL+ALT+Delete pour terminer la session. +``` +La plupart des salamandres sont nocturnes, et chassent les insectes, les vers, et d'autres petites créatures. +``` +La plupart des salamandres sont nocturnes, et chassent les insectes, les vers, et d'autres petites créatures. \ No newline at end of file diff --git a/content/posts/writing-posts/math/index.fr.md b/content/posts/writing-posts/math/index.fr.md new file mode 100644 index 00000000..ba47a2d6 --- /dev/null +++ b/content/posts/writing-posts/math/index.fr.md @@ -0,0 +1,50 @@ +--- +title: "Paramètres de type Maths" +date: 2020-06-08T06:15:35+06:00 +menu: + sidebar: + name: Paramètre de type Maths + identifier: writing-post-math-guide + parent: writing-post + weight: 40 +math: true +--- + +La notation Mathématique dans un projet Hugo peut être activé en utilisant des librairies JavaScript tierces. + + +Dans cet exemple, nous utiliserons [KaTeX](https://katex.org/) + +- Créez un partiel sous `/layouts/partials/math.html` +- A l'intérieur de cette référence de partiel, l'[Auto-render Extension](https://katex.org/docs/autorender.html) ou héberger ces scripts localement. +- Inclure le partiel dans votre template comme suit: + +``` +{{ if or .Params.math .Site.Params.math }} +{{ partial "math.html" . }} +{{ end }} +``` +- Pour activer KaText globalement mettez le paramètre `math` à `true` dans la configuration du projet. +- Pour activer KaTex par page, incluez le paramètre `math: true` dans le front matter de votre fichier de contenu. + +**Note:** Utilisez le référentiel en ligne des [Fonctions TeX supportées](https://katex.org/docs/supported.html) +{{< math.inline >}} +{{ if or .Page.Params.math .Site.Params.math }} + + + + +{{ end }} +{{}} + +### Exemples +{{< math.inline >}} +

+Inline math: \(\varphi = \dfrac{1+\sqrt5}{2}= 1.6180339887…\) +

+{{}} + +Bloc de math: +$$ + \varphi = 1+\frac{1} {1+\frac{1} {1+\frac{1} {1+\cdots} } } +$$ diff --git a/content/posts/writing-posts/mermaid/index.fr.md b/content/posts/writing-posts/mermaid/index.fr.md new file mode 100644 index 00000000..ccec77ab --- /dev/null +++ b/content/posts/writing-posts/mermaid/index.fr.md @@ -0,0 +1,232 @@ +--- +title: "Support de Mermaid" +date: 2022-03-14T06:15:35+06:00 +menu: + sidebar: + name: Mermaid + identifier: writing-post-mermaid + parent: writing-post + weight: 60 +mermaid: true +--- + +This theme comes with built in mermaid support powered by [maemaidj-js](https://mermaid-js.github.io/mermaid). To enable mermaid for a page, you have to put `mermaid: true` in your page front-matter. For example, this page has the following front-matter: + +```yaml +title: "Mermaid Support" +date: 2022-03-14T06:15:35+06:00 +menu: + sidebar: + name: Mermaid + identifier: writing-post-mermaid + parent: writing-post + weight: 60 +mermaid: true +``` + +Then, you can use `mermaid` short code to add your mermaid content. For example: + +```bash +{{}} + # your mermaid content here +{{}} +``` + +The `mermaid` short code accept the following parameters: + +- **align**: Let's you align your diagram at left, right, or center. The default alignment is center. +- **background:** Let's you change the background color of your diagram. + +## Examples + +Here, are few example of different diagram using mermaid. + +#### Graph + +```bash +{{}} +graph LR; + A[Hard edge] -->|Link text| B(Round edge) + B --> C{Decision} + C -->|One| D[Result one] + C -->|Two| E[Result two] +{{}} +``` + +{{< mermaid align="left" >}} +graph LR; + A[Hard edge] -->|Link text| B(Round edge) + B --> C{Decision} + C -->|One| D[Result one] + C -->|Two| E[Result two] +{{< /mermaid >}} + +
+ +#### Sequence Diagram + +```bash +{{}} +sequenceDiagram + participant Alice + participant Bob + Alice->>John: Hello John, how are you? + loop Healthcheck + John->>John: Fight against hypochondria + end + Note right of John: Rational thoughts
prevail! + John-->>Alice: Great! + John->>Bob: How about you? + Bob-->>John: Jolly good! +{{}} +``` + +{{< mermaid >}} +sequenceDiagram + participant Alice + participant Bob + Alice->>John: Hello John, how are you? + loop Healthcheck + John->>John: Fight against hypochondria + end + Note right of John: Rational thoughts
prevail! + John-->>Alice: Great! + John->>Bob: How about you? + Bob-->>John: Jolly good! +{{< /mermaid >}} + +
+ +#### Gantt diagram + +```bash +{{}} +gantt + dateFormat YYYY-MM-DD + title Adding GANTT diagram to mermaid + excludes weekdays 2014-01-10 + +section A section + Completed task :done, des1, 2014-01-06,2014-01-08 + Active task :active, des2, 2014-01-09, 3d + Future task : des3, after des2, 5d + Future task2 : des4, after des3, 5d +{{}} +``` + +{{< mermaid >}} +gantt + dateFormat YYYY-MM-DD + title Adding GANTT diagram to mermaid + excludes weekdays 2014-01-10 + +section A section + Completed task :done, des1, 2014-01-06,2014-01-08 + Active task :active, des2, 2014-01-09, 3d + Future task : des3, after des2, 5d + Future task2 : des4, after des3, 5d +{{< /mermaid >}} + +
+ +#### Class Diagram + +```bash +{{}} +classDiagram + Class01 <|-- AveryLongClass : Cool + Class03 *-- Class04 + Class05 o-- Class06 + Class07 .. Class08 + Class09 --> C2 : Where am i? + Class09 --* C3 + Class09 --|> Class07 + Class07 : equals() + Class07 : Object[] elementData + Class01 : size() + Class01 : int chimp + Class01 : int gorilla + Class08 <--> C2: Cool label +{{}} +``` + +{{< mermaid >}} +classDiagram + Class01 <|-- AveryLongClass : Cool + Class03 *-- Class04 + Class05 o-- Class06 + Class07 .. Class08 + Class09 --> C2 : Where am i? + Class09 --* C3 + Class09 --|> Class07 + Class07 : equals() + Class07 : Object[] elementData + Class01 : size() + Class01 : int chimp + Class01 : int gorilla + Class08 <--> C2: Cool label +{{< /mermaid >}} + +
+ +#### Git Graph + +```bash +{{}} +gitGraph: +options +{ + "nodeSpacing": 150, + "nodeRadius": 10 +} +end +commit +branch newbranch +checkout newbranch +commit +commit +checkout master +commit +commit +merge newbranch +{{}} +``` + +{{< mermaid background="black" align="right" >}} +gitGraph: +options +{ + "nodeSpacing": 150, + "nodeRadius": 10 +} +end +commit +branch newbranch +checkout newbranch +commit +commit +checkout master +commit +commit +merge newbranch +{{< /mermaid >}} + +
+ +#### ER Diagram + +```bash +{{}} +erDiagram + CUSTOMER ||--o{ ORDER : places + ORDER ||--|{ LINE-ITEM : contains + CUSTOMER }|..|{ DELIVERY-ADDRESS : uses +{{}} +``` + +{{< mermaid >}} +erDiagram + CUSTOMER ||--o{ ORDER : places + ORDER ||--|{ LINE-ITEM : contains + CUSTOMER }|..|{ DELIVERY-ADDRESS : uses +{{< /mermaid >}} From 8de106a8b7dd625f558b1878997b8516457a29ec Mon Sep 17 00:00:00 2001 From: Nico <92774152+niltied@users.noreply.github.com> Date: Sat, 13 Jan 2024 17:14:31 +0100 Subject: [PATCH 34/35] Update index.fr.md Fix minor --- content/posts/shortcodes/index.fr.md | 46 ++++++++++++++-------------- 1 file changed, 23 insertions(+), 23 deletions(-) diff --git a/content/posts/shortcodes/index.fr.md b/content/posts/shortcodes/index.fr.md index b6d2ba3e..e37428a2 100644 --- a/content/posts/shortcodes/index.fr.md +++ b/content/posts/shortcodes/index.fr.md @@ -20,10 +20,10 @@ Ce billet d'échantillon est destiné à tester les éléments suivants : Ce thème propose différents types d'alertes pour votre publication. Par exemple, si on ajoute le code ci-dessous : -``` -{{< alert type="success" >}} +```markdown +{{}} This is sample alert with `type="success"`. -{{< /alert >}} +{{}} ``` L'alerte qui apparaîtra ressemblera à ça: @@ -33,59 +33,59 @@ This is sample alert with `type="success"`. {{< /alert >}} Les alertes suivantes sont également disponible dans ce thème. -``` -{{< alert type="danger" >}} +```markdown +{{}} This is sample alert with `type="danger"`. -{{< /alert >}} +{{}} ``` {{< alert type="danger" >}} This is sample alert with `type="danger"`. {{< /alert >}} -``` -{{< alert type="warning" >}} +```markdown +{{}} This is sample alert with `type="warning"`. -{{< /alert >}} +{{}} ``` {{< alert type="warning" >}} This is sample alert with `type="warning"`. {{< /alert >}} -``` -{{< alert type="info" >}} +```markdown +{{< alert type="info" */>}} This is sample alert with `type="info"`. -{{< /alert >}} +{{}} ``` {{< alert type="info" >}} This is sample alert with `type="info"`. {{< /alert >}} -``` -{{< alert type="dark" >}} +```markdown +{{< alert type="dark" */>}} This is sample alert with `type="dark"`. -{{< /alert >}} +{{}} ``` {{< alert type="dark" >}} This is sample alert with `type="dark"`. -{{< /alert >}} +{{}} -``` -{{< alert type="primary" >}} +```markdown +{{}} This is sample alert with `type="primary"`. -{{< /alert >}} +{{}} ``` {{< alert type="primary" >}} This is sample alert with `type="primary"`. {{< /alert >}} -``` -{{< alert type="secondary" >}} +```markdown +{{}} This is sample alert with `type="secondary"`. -{{< /alert >}} +{{}} ``` {{< alert type="secondary" >}} @@ -270,4 +270,4 @@ Voici la ligne 2. Il devrait y avoir un espace vertical de `4rem` avec la ligne {{< video src="/videos/sample.mp4" >}} -Vidéo de [Rahul Sharma](https://www.pexels.com/@rahul-sharma-493988) sur [Pexels](https://www.pexels.com). \ No newline at end of file +Vidéo de [Rahul Sharma](https://www.pexels.com/@rahul-sharma-493988) sur [Pexels](https://www.pexels.com). From 8e33f2f5215eed2c57a2e17e88c1bc206fdd954b Mon Sep 17 00:00:00 2001 From: Nico <92774152+niltied@users.noreply.github.com> Date: Sat, 13 Jan 2024 18:39:32 +0100 Subject: [PATCH 35/35] Update index.fr.md minor fix --- content/posts/shortcodes/index.fr.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/posts/shortcodes/index.fr.md b/content/posts/shortcodes/index.fr.md index e37428a2..ec478b6b 100644 --- a/content/posts/shortcodes/index.fr.md +++ b/content/posts/shortcodes/index.fr.md @@ -54,7 +54,7 @@ This is sample alert with `type="warning"`. {{< /alert >}} ```markdown -{{< alert type="info" */>}} +{{}} This is sample alert with `type="info"`. {{}} ``` @@ -63,7 +63,7 @@ This is sample alert with `type="info"`. {{< /alert >}} ```markdown -{{< alert type="dark" */>}} +{{}} This is sample alert with `type="dark"`. {{}} ```