[ADD][i18n][Docs] French translation of getting started page (#1040)

* [ADD][i18n][Docs] French translation of getting started page

- Add Sidebar translated menus
- Add lang code fr to language selection
- Add french translated getting-started page

* [ADD][i18n][Docs] Adding 'fr' key to known langs for automatic redirect
This commit is contained in:
Philippe L'ATTENTION 2021-08-06 22:20:36 +04:00 committed by GitHub
parent 2360e2c8a2
commit b71ccc2b9d
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
4 changed files with 70 additions and 1 deletions

View file

@ -73,6 +73,9 @@ const LanguageSelect: FunctionalComponent<{ lang: string }> = ({ lang }) => {
<option value="bg">
<span>Български</span>
</option>
<option value="fr">
<span>Français</span>
</option>
</select>
</div>
);

View file

@ -69,6 +69,10 @@ export const SIDEBAR = {
{ text: 'Главни', header: true },
{ text: 'Започваме!', link: 'bg/getting-started' },
],
fr: [
{ text: 'Bienvenue', header: true },
{ text: 'Bien Démarrer', link: 'fr/getting-started' },
],
};
export const SITE = {

View file

@ -0,0 +1,62 @@
---
layout: ~/layouts/MainLayout.astro
title: Bien démarrer
lang: fr
---
Astro est un générateur de site statique moderne. Comprenez ce qu'est Astro en visitant [notre page d'accueil](https://astro.build/) ou [notre annonce de sortie](https://astro.build/blog/introducing-astro). Cette page est une vue d'ensemble de la documentation d'Astro et de toutes les ressources associées.
Vous cherchez un rapide condensé de ce qu'offre Astro? [Visitez notre page d'accueil.](https://astro.build)
## Essayer Astro
La manière la plus simple d'essayer Astro est de lancer `npm init astro` à partir d'un nouveau dossier depuis votre machine. Notre utilitaire CLI vous assistera dans la création d'un nouveau projet Astro.
Pour bien débuter avec Astro en 5 étapes rapides et faciles, visitez notre [Guide de démarrage rapide](quick-start).
Autrement, lisez notre [Guide d'installation](/installation) pour un accompagnement pas-à-pas sur la mise en place d'Astro.
### Terrains de jeu en ligne (Online Playground)
Si vous voulez tester Astro directement dans votre navigateur, vous pouvez utiliser un playground en ligne. Essayez notre modèle "Hello World!" sur [CodeSandbox](https://codesandbox.io/s/astro-template-hugb3).
_Note: quelques-unes des fonctionnalités (ex : Rafraîchissement Rapide) sont pour le moment limitées sur CodeSandbox._
## Apprendre Astro
Une multitude de personnes viennent sur Astro avec bagages d'expériences distincts apportant donc avec eux des styles d'apprentissage différents. Que vous préfériez une approche plutôt théorique ou pratique, nous espérons que vous trouverez l'aide qu'il vous faut dans cette section.
- Si vous préférez une **approche pratique**, commencez avec notre [librairie d'exemples](https://github.com/snowpackjs/astro/tree/main/examples).
- Si vous préférez **apprendre les concepts étape par étape**, commencez avec nos [fondamentaux et guides](/core-concepts/project-structure).
Comme toute nouvelle technologie, Astro possède une courbe d'apprentissage modérée. Malgré cela, avec de la pratique et de la patience, nous savons, que _vous_ allez prendre la main, en très peu de temps.
### Apprendre la Syntaxe `.astro`
Quand vous débutez l'apprentissage d'Astro, vous allez rencontrer beaucoup de fichier avec l'extension `.astro`. C'est la **Syntaxe des Composants Astro**: des fichiers particuliers avec un format similaire au HTML qu'Astro utilise comme template. Ils ont été conçus pour être familiers à toute personne ayant une expérience avec le HTML ou le JSX.
Notre guide utile sur les [composants Astro](/core-concepts/astro-components) vous introduit à la syntaxe Astro et reste la meilleure façon d'apprendre.
### Documentation de l'API
Cette documentation vous sera utile si vous souhaitez comprendre en détails certaines API d'Astro. Par exemple, [Documentation de la Configuration](/reference/configuration-reference) liste toutes les options de configuration à votre disposition. [Documentation des Composants de base](/reference/builtin-components) liste tous les composants disponibles de base, comme `<Markdown />` et `<Prism />`.
### Documentation Versionnée
Cette documentation reflète toujours la dernière version stable d'Astro. Dès que nous auront atteint l'étape de la v1.0, nous ajouterons la possibilité de parcourir la documentation versionnée.
## Rester Informé
Le compte Twitter [@astrodotbuild](https://twitter.com/astrodotbuild) est la source officielle de mise à jour par l'équipe Astro.
Nous publions également les annonces de nouvelles versions sur notre [Communauté Discord](https://astro.build/chat) dans le channel #announcements.
Toutes les releases d'Astro ne requièrent pas leur propre article de blog, mais vous pouvez trouver un changelog détaillé de toutes les releases dans le [fichier `CHANGELOG.md` du dépôt Astro](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md).
## Quelque chose vous manque?
Si vous pensez que quelque chose manque dans la documentation ou si vous en trouvez une partie déroutante, veuillez [créer une "issue" sur le dépôt de la documentation](https://github.com/snowpackjs/astro/issues/new/choose) avec vos suggestions d'amélioration, ou bien mentionnez le compte [@astrodotbuild](https://twitter.com/astrodotbuild) sur Twitter. Nous adorons avoir de vos nouvelles!
## Crédits
Ce guide de démarrage est basé sur le guide "Bien débuter" de [React](https://reactjs.org/).

View file

@ -6,7 +6,7 @@ import Layout from '../layouts/MainLayout.astro';
// This is some wip redirect code based on the browser language.
// A vercel.json redirect is enforced in production, so no user should ever see this page.
// Remove the vercel.json redirect when this is ready.
const KNOWN_LANGUAGES = ['bg', 'de','en','es','fi','nl','pt-br','zh-CN','zh-TW'];
const KNOWN_LANGUAGES = ['bg', 'de','en','es','fi','nl','pt-br','zh-CN','zh-TW', 'fr'];
let newLangWithRegion = (window.navigator.userLanguage || window.navigator.language || 'en-US').substr(0, 5);
let newLang = newLangWithRegion.substr(0, 2);
if (newLang === 'en') {