37
loading...
Comment J'ai Fait Mon Blog Bilingue
C'est le tout premier article sur mon site, et pour commencer je vais vous expliquer comment j'ai créé mon blog. Je vais essentiellement parler des technologies utilisées et comment j'ai internationalisé le site.
En tant que développeur React, je suis parti sur le framework Next.js pour mon blog. Cela fait plusieurs mois que je travaille avec et c'est juste incroyable. Plus besoin de passer du temps sur Webpack, les performances sont folles (e.g. regardez les statistiques sur ma dernière PR), mes pages sont dynamiquement générées en HTML, je peux utiliser les API Routes pour des besoins spécifiques comme du rendu d'images à la demande.
Bref, je suis totalement amoureux de ce framework ! D'ailleurs, n'oubliez pas de vous inscrire pour la Next.js Conf qui se tiendra en ligne.
Une des forces de Next.js c'est de pouvoir choisir sa méthode de récupération de données. Soit vous les récupérez au moment de build votre site (e.g. Static Site Generation), soit à la demande à chaque requête du site (e.g. Server Side Rendering).
J'ai choisi la première pour des raisons simples. Toutes les pages de mon site sont statiques. On peut donc les créer en amont et gagner en performance.
export const getStaticProps: GetStaticProps = async ({ locale }) => {
const language = await import(`../locales/${locale}.json`);
return {
props: {
lngDict: language.default,
},
};
};Laissez-moi vous dire que les API Routes c’est juste le feu ! Connaissant plutôt bien AWS Lambda, la tendance serverless est réelle et on devrait tous tester des outils comme les Lambdas ou les Cloudfare Workers. Du coup, le simple fait d’intégrer ce genre d’outil c’est la cerise sur le gâteau, à consommer abondamment.
Mes différentes façons d’utiliser cet outil :
Sur mon site, j’utilise les API Routes pour 2 choses. La première, cela me permet de faire des requêtes aux serveurs de GitHub pour récupérer mes projets préférés et le graphique de contribution. La deuxième, cela me permet de créer à la demande une image pour mes articles de blog avec puppeteer-core.
export default async (
req: NextApiRequest,
res: NextApiResponse,
): Promise<void> => {
const { slug } = req.query || {};
if (slug) {
const blogs = getBlogs();
if (!blogs.find((blog) => blog.replace(/\.mdx/, '') === slug)) {
return res.status(404).send('Not Found');
}
const html = generateBlogImageHTML(slug as string);
const file = await screenshot(html);
res.setHeader('Content-Type', `image/png`);
res.setHeader(
'Cache-Control',
`public, immutable, no-transform, s-maxage=31536000, max-age=31536000`,
);
return res.status(200).end(file);
}
return res.status(404).send('Not Found');
};Mon site est déployé sur Vercel. Au tout début, j’étais parti du postulat qu’étant à la création de Next.js, ce sont les mieux armés pour créer la meilleure intégration avec leur framework.
Après utilisation avec plusieurs sites, et après avoir testé d’autres intégrations (e.g. Netlify notamment), j’ai maintenant la certitude que c'est la meilleure option d'hébergement pour Next.js. En 2 cliques vous pouvez héberger, non seulement votre projet Next.js, mais aussi d’autres projets (e.g. Vue, Angular). Avec Next.js version 10, on peut avoir gratuitement, pour un projet, les Next.js Analytics. On peut y intégrer des noms de domaine. Leur outil de gestion de variables d’environnements secrètes fonctionne à merveille et sans couac. Et on peut faire des connexions avec des outils tiers comme des GitHubs Apps. Essayez par vous-mêmes, vous n’allez pas le regretter.
J’ai découvert Tailwind CSS en septembre dernier et depuis je ne peux m’en passer. Dès que je le peux, je l’utilise sans modération. Voilà mon humble avis sur le sujet :
Pour un développeur comme moi qui écrit du Markdown à longueur de journée, c’est tellement bien. Pour ceux qui ne le savent pas, si vous utilisez régulièrement GitHub et GitLab, pour les pulls requests ou pour les issues, vous en écrivez.
# Comment écrire le paragraphe du dessus en Markdown:
[MDX](https://mdxjs.com/), c’est ce qui fait que l’expérience en tant qu’auteur est si parfaite. C’est une extension du Markdown qui nous permet d’écrire du JSX dans des fichiers Markdown. Plus simplement, on peut écrire et bénéficier des composants React dans ces fichiers.
Pour un développeur comme moi qui écrit du Markdown à longueur de journée, c’est tellement bien. Pour ceux qui ne le savent pas, si vous utilisez régulièrement GitHub et GitLab, pour les pulls requests ou pour les issues, vous en écrivez.Ci-dessous, un exemple de MDX copié du site officiel :
# Hello, *world*!
Below is an example of JSX embedded in Markdown. <br /> **Try and change the background color!**
<div style={{ padding: '20px', backgroundColor: 'tomato' }}>
<h3>This is JSX</h3>
</div>Afin de faire fonctionner correctement Next.js avec des fichiers MDX, il faut pouvoir les compiler afin de les rendre utilisables en tant que composants React. Pour réaliser aux mieux cette tâche, j’utilise la nouvelle librairie mdx-bundler du célèbre Kent C. Dodds.
Je n’ai pas vraiment d’expériences avec les autres librairies (e.g. next-mdx-enhanced, next-mdx-remote) donc je ne me permettrais pas de juger les pour et les contre de chacun.
Afin de rendre l’expérience de lecture la plus agréable possible, j’ai essayé de customiser chaque composant de la page de l’article comme les titres et sous-titres, les images, les blocs de code ou les listes. D’autres composants viendront étoffer la liste au fur et à mesure.
Je me suis énormément inspiré de merveilleux blogs, notamment :
Ce blog n’aurait jamais vu le jour sans des meta données pour chaque article de blog. Et pour cela, j’utilise ce qu’on appelle les frontmatter.
Utiles pour l’UI ou encore le SEO, on y écrit des pairs de clés-valeurs. Personnellement, je m’en sers pour le titre, la description, la date de publication, les tags ou encore la langue utilisée.
Ci-dessous un exemple pour cet article de blog :
---
title: "Comment J'ai Fait Mon Blog Bilingue"
description: "Un tour d'horizon de comment j'ai créé mon blog bilingue. Je vais essentiellement parler des technologies utilisées et comment j'ai internationalisé le site."
locale: fr
alternate: /blog/my-multilingual-blog
isPublished: true
publishedAt: "2021-05-22"
tags:
- react
- nextjs
- tailwind
- mdx
---
Le reste du contenu ...Depuis le début, je me suis juré de faire ce blog à la fois en anglais et en français. Heureusement avec la version 10 de Next.js, le développement de sites internationaux a été énormément facilité.
On a simplement à ajouter dans le fichier
next.config.js la clé i18n avec les langues souhaitées. Next.js va alors automatiquement commencer à rediriger les utilisateurs sur les bons chemins du site (e.g /fr pour les francophones et / pour les anglophones) grâce aux headers Accept-Language de leur navigateur.// Configuration de mon site
module.exports = {
i18n: {
locales: ['en', 'fr'],
defaultLocale: 'en',
localeDetection: false,
}
}J’utilise next-localization pour afficher les bonnes traductions dans mes composants React.
Quand on travaille sur des sites internationaux, il faut énormément penser en amont à comment organiser le SEO (Search Engine Optimization). Il faut donc être rigoureux sur la façon dont on organise le tag
head dans son HTML.J’ai essayé d’aller au maximum sur l’intégration des différentes langues. J'ai exposé 2 versions de flux RSS et de webmanifests en suivant au mieux les bonnes pratiques de W3C et de Google Search Console. N’hésitez surtout pas à me laisser des commentaires.
Je vais continuer à améliorer mon site, du point de vue du lecteur et de l’auteur. Si vous avez des idées de modifications, vous pouvez ouvrir une PR sur GitHub.
Je viens à peine de commencer mon aventure de créateur de contenus et je remercie tous ceux que je suis sur les réseaux et avec qui j’apprends tous les jours :
37