docs: French version

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,7 @@
+## Attention
+
+Vous vous apprêtez à ouvrir une issue sur le projet de traduction francophone de la documentation de SvelteKit.
+
+Ce projet est uniquement dédié à de la traduction, et nous n'accepterons donc que les issues dont l'objet est l'ajout ou la modification de traductions, ou tout outillage associé.
+
+Pour toute issue liée au projet SvelteKit en lui-même, merci de les ouvrir sur le [repository officiel](https://github.com/sveltejs/kit/issues).

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,18 +1,7 @@
-<!-- Your PR description here -->
+## Attention
 
----
+Vous vous apprêtez à ouvrir une PR sur le projet de traduction francophone de la documentation de SvelteKit.
 
-### Please don't delete this checklist! Before submitting the PR, please make sure you do the following:
-- [ ] It's really useful if your PR references an issue where it is discussed ahead of time. In many cases, features are absent for a reason. For large changes, please create an RFC: https://github.com/sveltejs/rfcs
-- [ ] This message body should clearly illustrate what problems it solves.
-- [ ] Ideally, include a test that fails without this PR but passes with it.
+Ce projet est uniquement dédié à de la traduction, et nous n'accepterons donc que les PRs dont l'objet est l'ajout ou la modification de traductions, ou tout outillage associé.
 
-### Tests
-- [ ] Run the tests with `pnpm test` and lint the project with `pnpm lint` and `pnpm check`
-
-### Changesets
-- [ ] If your PR makes a change that should be noted in one or more packages' changelogs, generate a changeset by running `pnpm changeset` and following the prompts. Changesets that add features should be `minor` and those that fix bugs should be `patch`. Please prefix changeset messages with `feat:`, `fix:`, or `chore:`.
-
-### Edits
-
-- [ ] Please ensure that 'Allow edits from maintainers' is checked. PRs without this option may be closed.
+Pour toute PR liée au projet SvelteKit en lui-même, merci de les ouvrir sur le [repository officiel](https://github.com/sveltejs/kit/pulls).

.github/workflows/track-docs.yml

@@ -0,0 +1,34 @@
+name: Docs tracker
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: '0 3 * * *'
+
+jobs:
+  track-docs:
+    runs-on: ubuntu-latest
+    name: Checking Docs
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+      - name: Svelte docs new commits
+        uses: AlexxNB/track-commits-to-issue@master
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          owner: sveltejs
+          repo: kit
+          dir: documentation
+  track-site:
+    runs-on: ubuntu-latest
+    name: Checking Site
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+      - name: Svelte docs new commits
+        uses: AlexxNB/track-commits-to-issue@master
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          owner: sveltejs
+          repo: kit
+          dir: sites/kit.svelte.dev

README.md

@@ -42,6 +42,12 @@ Svelte is an MIT-licensed open source project with its ongoing development made
 
 Funds donated via Open Collective will be used for compensating expenses related to Svelte's development such as hosting costs. If sufficient donations are received, funds may also be used to support Svelte's development more directly.
 
+## Translating SvelteKit docs
+
+This is the french version of the SvelteKit docs.
+
+Read more about this was done [here](i18n.md).
+
 ## License
 
 [MIT](https://github.com/sveltejs/kit/blob/main/LICENSE)

documentation/docs/10-getting-started/10-introduction.md

@@ -2,26 +2,26 @@
 title: Introduction
 ---
 
-## Before we begin
+## Avant de commencer
 
-> If you're new to Svelte or SvelteKit we recommend checking out the [interactive tutorial](https://learn.svelte.dev).
+> Si vous débutez avec Svelte ou SvelteKit, nous vous recommandons de jeter un œil au [tutoriel interactif](PUBLIC_LEARN_SITE_URL).
 >
-> If you get stuck, reach out for help in the [Discord chatroom](https://svelte.dev/chat).
+> Si vous êtes bloqué•e, n'hésitez pas à demander de l'aide sur le forum du [Discord francophone](PUBLIC_SVELTE_SITE_URL/chat), ou bien du [Discord officiel](https://svelte.dev/chat).
 
-## What is SvelteKit?
+## C'est quoi SvelteKit ?
 
-SvelteKit is a framework for rapidly developing robust, performant web applications using [Svelte](https://svelte.dev/). If you're coming from React, SvelteKit is similar to Next. If you're coming from Vue, SvelteKit is similar to Nuxt.
+SvelteKit est un <span class="vo">[framework](PUBLIC_SVELTE_SITE_URL/docs/web#framework)</span> permettant de développer des applications web robustes et performantes avec [Svelte](PUBLIC_SVELTE_SITE_URL). Si vous êtes habitué•e à React, SvelteKit est comparable à Next. Si vous êtes habitué•e à Vue, SvelteKit est comparable à Nuxt.
 
-To learn more about the kinds of applications you can build with SvelteKit, see the [FAQ](/docs/faq#what-can-i-make-with-sveltekit).
+Pour en apprendre plus sur les types d'application que vous pouvez construire avec SvelteKit, rendez-vous sur la [FàQ](/docs/faq#quoi-sert-sveltekit)
 
-## What is Svelte?
+## C'est quoi Svelte ?
 
-In short, Svelte is a way of writing user interface components — like a navigation bar, comment section, or contact form — that users see and interact with in their browsers. The Svelte compiler converts your components to JavaScript that can be run to render the HTML for the page and to CSS that styles the page. You don't need to know Svelte to understand the rest of this guide, but it will help. If you'd like to learn more, check out [the Svelte tutorial](https://svelte.dev/tutorial).
+Pour faire court, Svelte est un moyen d'écrire des composants d'interface visuelle — comme une barre de navigation, une section de commentaires, ou un formulaire de contact — que les utilisateurs et utilisatrices voient et utilisent dans leurs navigateurs. Le compilateur Svelte convertit vos composants en du code JavaScript qui peut être exécuté pour afficher le HTML des pages, ainsi qu'en CSS qui applique le style des pages. Vous n'avez pas besoin de connaître Svelte pour comprendre le reste de ce guide, mais cela peut définitivement aider. Si vous souhaitez en savoir plus, n'hésitez pas à aller faire le [tutoriel dédié à Svelte](PUBLIC_SVELTE_SITE_URL/tutorial)
 
 ## SvelteKit vs Svelte
 
-Svelte renders UI components. You can compose these components and render an entire page with just Svelte, but you need more than just Svelte to write an entire app.
+Svelte affiche des composants visuels. Vous pouvez composer ces composants et construire des pages entières juste avec Svelte, mais vous aurez besoin d'autres outils que Svelte pour construire une application complète.
 
-SvelteKit helps you build web apps while following modern best practices and providing solutions to common development challenges. It offers everything from basic functionalities — like a [router](glossary#routing) that updates your UI when a link is clicked — to more advanced capabilities. Its extensive list of features includes [build optimizations](https://vitejs.dev/guide/features.html#build-optimizations) to load only the minimal required code; [offline support](service-workers); [preloading](link-options#data-sveltekit-preload-data) pages before user navigation; [configurable rendering](page-options) to handle different parts of your app on the server via [SSR](glossary#ssr), in the browser through [client-side rendering](glossary#csr), or at build-time with [prerendering](glossary#prerendering); [image optimization](images); and much more. Building an app with all the modern best practices is fiendishly complicated, but SvelteKit does all the boring stuff for you so that you can get on with the creative part.
+SvelteKit vous permet de construire des applications web en suivant les bonnes pratiques modernes et en fournissant des solutions aux problématiques courantes de développement. SvelteKit propose un environnement de développement clé en main, depuis des outils basiques — comme un [routeur](glossary#routing) qui met à jour l'interface lorsqu'un lien est cliqué — jusqu'à des fonctionnalités plus avancées. L'étendue de ses fonctionnalités inclut l'[optimisation des builds](https://vitejs.dev/guide/features.html#build-optimizations) pour ne charger que la quantité de code strictement nécessaire ; le [support hors-ligne](service-workers) ; le [pré-chargement](link-options#data-sveltekit-preload-data) des pages avant que la navigation ne soit initiée ; la [configuration de rendu](page-options) qui vous permet de construire différents morceaux de votre application sur le serveur avec du [SSR](glossary#ssr), dans le navigateur avec du [rendu côté client](glossary#csr), ou au moment de la compilation avec du [pré-rendu](glossary#pr-rendu) ; [l'optimisation des images](images) ; et bien d'autres choses. Construire une application web en suivant toutes les bonnes pratiques est diaboliquement compliqué, mais SvelteKit s'occupe de toutes ces choses pénibles afin que vous vous concentriez sur les parties plus créatives.
 
-It reflects changes to your code in the browser instantly to provide a lightning-fast and feature-rich development experience by leveraging [Vite](https://vitejs.dev/) with a [Svelte plugin](https://github.com/sveltejs/vite-plugin-svelte) to do [Hot Module Replacement (HMR)](https://github.com/sveltejs/vite-plugin-svelte/blob/main/docs/config.md#hot).
+SvelteKit reflète les changements de votre code instantanément dans le navigateur pour vous offrir une expérience de développement riche et efficace en utilisant [Vite](https://vitejs.dev/) au travers d'un [plugin Svelte](https://github.com/sveltejs/vite-plugin-svelte), permettant ainsi le [Hot Module Replacement (HMR)](https://github.com/sveltejs/vite-plugin-svelte/blob/main/docs/config.md#hot).

documentation/docs/10-getting-started/20-creating-a-project.md

@@ -1,8 +1,8 @@
 ---
-title: Creating a project
+title: Créer un projet
 ---
 
-The easiest way to start building a SvelteKit app is to run `npm create`:
+La façon la plus simple de commencer une application SvelteKit est d'utiliser `npm create` :
 
 ```bash
 npm create svelte@latest my-app
@@ -11,15 +11,17 @@ npm install
 npm run dev
 ```
 
-The first command will scaffold a new project in the `my-app` directory asking you if you'd like to set up some basic tooling such as TypeScript. See [integrations](./integrations) for pointers on setting up additional tooling. The subsequent commands will then install its dependencies and start a server on [localhost:5173](http://localhost:5173).
+La première commande va générer un nouveau projet dans le dossier `my-app`, en vous proposant d'utiliser de l'outillage de base comme TypeScript.
+Vous trouverez des indications pour installer d'autres outils sur la page d'[intégrations](./integrations). Les autres commandes installent ensuite les dépendances du projet, et lancent un serveur de développement sur [localhost:5173](http://localhost:5173).
 
-There are two basic concepts:
+SvelteKit a deux principes de base :
 
-- Each page of your app is a [Svelte](https://svelte.dev) component
-- You create pages by adding files to the `src/routes` directory of your project. These will be server-rendered so that a user's first visit to your app is as fast as possible, then a client-side app takes over
+- Chaque page de votre application est un composant [Svelte](PUBLIC_SVELTE_SITE_URL)
+- Vous créez des pages en ajoutant des fichiers dans le dossier `src/routes` de votre projet. Ces pages seront d'abord rendues sur le serveur afin que la première visite d'un utilisateur ou d'une utilisatrice soit aussi rapide que possible, puis une application côté client prend le relais
 
-Try editing the files to get a feel for how everything works.
+Essayez de modifier les fichiers pour vous faire une idée de comment les choses fonctionnent.
 
-## Editor setup
+## Éditeurs
+
+Il est recommandé d'utiliser [Visual Studio Code (aka VS Code)](https://code.visualstudio.com/download) avec [l'extension Svelte](https://marketplace.visualstudio.com/items?itemName=svelte.svelte-vscode), mais [d'autres éditeurs sont également supportés](https://sveltesociety.dev/resources#editor-support).
 
-We recommend using [Visual Studio Code (aka VS Code)](https://code.visualstudio.com/download) with [the Svelte extension](https://marketplace.visualstudio.com/items?itemName=svelte.svelte-vscode), but [support also exists for numerous other editors](https://sveltesociety.dev/resources#editor-support).