French docs version

.github/ISSUE_TEMPLATE.md

@@ -1,28 +1,7 @@
----
-Before filing an issue we'd appreciate it if you could take a moment to ensure
-there isn't already an open issue or pull-request.
----
+## Attention
 
-If there's an existing issue, please add a :+1: reaction to the description of
-the issue. One way we prioritize issues is by the number of :+1: reactions on
-their descriptions. Please DO NOT add `+1` or :+1: comments.
+Vous vous apprêtez à ouvrir une issue sur le projet de traduction francophone de la documentation de Svelte.
 
-### Feature requests and proposals
+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é.
 
-We're excited to hear how we can make Svelte better. Please add as much detail
-as you can on your use case. To propose an implementation of a large feature or
-change, please create an [RFC](https://github.com/sveltejs/rfcs).
-
-### Bugs
-
-If you're filing an issue about a bug please include as much information
-as you can including the following.
-
-- Your browser and the version: (e.x. Chrome 52.1, Firefox 48.0, IE 10)
-- Your operating system: (e.x. OS X 10, Windows XP, etc)
-- Svelte version (Please check you can reproduce the issue with the latest release!)
-- Whether your project uses Webpack or Rollup
-
-- _Repeatable steps to reproduce the issue_
-
-## Thanks for being part of Svelte!
+Pour toute issue liée au projet Svelte en lui-même, merci de les ouvrir sur le [repository officiel](https://github.com/sveltejs/svelte/issues).

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,14 +1,7 @@
-## Svelte compiler rewrite
+## Attention
 
-Please note that [the Svelte codebase is currently being rewritten](https://svelte.dev/blog/runes). Thus, it's best to hold off on new features or refactorings for the time being.
+Vous vous apprêtez à ouvrir une PR sur le projet de traduction francophone de la documentation de Svelte.
 
-### Before submitting the PR, please make sure you do the following
+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é.
 
-- [ ] 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
-- [ ] Prefix your PR title with `feat:`, `fix:`, `chore:`, or `docs:`.
-- [ ] This message body should clearly illustrate what problems it solves.
-- [ ] Ideally, include a test that fails without this PR but passes with it.
-
-### Tests and linting
-
-- [ ] Run the tests with `pnpm test` and lint the project with `pnpm lint`
+Pour toute PR liée au projet Svelte en lui-même, merci de les ouvrir sur le [repository officiel](https://github.com/sveltejs/svelte/pulls).

.github/workflows/track-docs.yml

@@ -0,0 +1,47 @@
+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: svelte
+ dir: documentation
+ track-site:
+ runs-on: ubuntu-latest
+ name: Checking Site
+ steps:
+ - name: Checkout code
+ uses: actions/checkout@v3
+ - name: Svelte site new commits
+ uses: AlexxNB/track-commits-to-issue@master
+ with:
+ token: ${{ secrets.GITHUB_TOKEN }}
+ owner: sveltejs
+ repo: svelte
+ dir: sites/svelte.dev
+ track-svelte:
+ runs-on: ubuntu-latest
+ name: Checking Svelte core
+ steps:
+ - name: Checkout code
+ uses: actions/checkout@v3
+ - name: Svelte new commits
+ uses: AlexxNB/track-commits-to-issue@master
+ with:
+ token: ${{ secrets.GITHUB_TOKEN }}
+ owner: sveltejs
+ repo: svelte
+ dir: packages/svelte/src

README.md

@@ -72,6 +72,12 @@ The source code for https://svelte.dev lives in the [sites](https://github.com/s
 
 Probably not, but it's possible. If you can't seem to access any `.dev` sites, check out [this SuperUser question and answer](https://superuser.com/q/1413402).
 
+## Translating Svelte docs
+
+This is the french version of the Svelte website.
+
+Read more about this was done [here](i18n.md).
+
 ## License
 
 [MIT](LICENSE.md)

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

@@ -2,13 +2,18 @@
 title: Introduction
 ---
 
-Welcome to the Svelte reference documentation! This is intended as a resource for people who already have some familiarity with Svelte and want to learn more about using it.
+Bienvenue sur la documentation Svelte de référence ! Ces pages sont pensées comme une ressource utile pour des personnes ayant déjà une certaine familiarité avec Svelte, et souhaitant en apprendre davantage.
 
-If that's not you (yet), you may prefer to visit the [interactive tutorial](https://learn.svelte.dev) or the [examples](/examples) before consulting this reference. You can try Svelte online using the [REPL](/repl). Alternatively, if you'd like a more fully-featured environment, you can try Svelte on [StackBlitz](https://sveltekit.new).
+Si ce n'est pas (encore) le cas pour vous, vous préférerez probablement jeter un oeil au [tutoriel interactif](/tutorial) ou aux [exemples](/examples) avant de consulter cette section. Vous pouvez essayez Svelte en ligne en utilisant le [REPL](/repl), ou bien sur [StackBlitz](https://sveltekit.new) si vous préférez un environnement de développement plus complet.
 
-## Start a new project
+> Cette documentation en français, ainsi que l'intégralité du contenu en français de ce site, sont une **traduction bénévole et non officielle** de la [documentation](PUBLIC_SVELTE_SITE_URL/docs) et du [site](PUBLIC_SVELTE_SITE_URL) officiels (en anglais), qui restent la référence. N'hésitez pas à y jeter un oeil. Vous pouvez aussi [nous faire part de vos suggestions de traduction](https://github.com/PUBLIC_GITHUB_ORG/svelte/issues) si celles que vous trouverez dans ces pages ne vous conviennent pas.
+>
+> Vous trouverez parfois des termes non traduits, comme <span class="vo">[falsy](/docs/javascript#falsy-truthy-falsy)</span> ou encore
+> <span class="vo">[bundler](/docs/web#bundler-packager)</span>. Ces termes sont en général utilisés tels quels en français, et nous avons choisi de les laisser ainsi dans la documentation française. N'hésitez pas à suivre les liens proposés, qui vous dirigeront vers un glossaire fournissant quelques explications.
 
-We recommend using [SvelteKit](https://kit.svelte.dev/), the official application framework from the Svelte team:
+## Démarrer un nouveau projet
+
+Nous recommandons d'utiliser [SvelteKit](PUBLIC_KIT_SITE_URL/), le <span class="vo">[framework](/docs/web#framework)</span> d'application officiel créé par l'équipe Svelte :
 
 ```
 npm create svelte@latest myapp
@@ -17,18 +22,18 @@ npm install
 npm run dev
 ```
 
-SvelteKit will handle calling [the Svelte compiler](https://www.npmjs.com/package/svelte) to convert your `.svelte` files into `.js` files that create the DOM and `.css` files that style it. It also provides all the other pieces you need to build a web application such as a development server, routing, deployment, and SSR support. [SvelteKit](https://kit.svelte.dev/) uses [Vite](https://vitejs.dev/) to build your code.
+SvelteKit se charge d'exécuter [le compilateur Svelte](https://www.npmjs.com/package/svelte) pour convertir vos fichiers `.svelte` en fichiers `.js` qui créent le DOM, et en fichiers `.css` qui le stylisent. Il fournit également tout ce dont vous avez besoin pour créer une application web, comme un serveur de développement, du <span class="vo">[routing](/docs/web#routing)</span>, et des outils de déploiement. [SvelteKit](PUBLIC_KIT_SITE_URL/) utilise [Vite](https://vitejs.dev/) pour empaqueter votre code.
 
-### Alternatives to SvelteKit
+### Alternatives à SvelteKit
 
-If you don't want to use SvelteKit for some reason, you can also use Svelte with Vite (but without SvelteKit) by running `npm create vite@latest` and selecting the `svelte` option. With this, `npm run build` will generate HTML, JS and CSS files inside the `dist` directory. In most cases, you will probably need to [choose a routing library](/faq#is-there-a-router) as well.
+Si vous ne souhaitez pas utiliser SvelteKit, vous pouvez aussi utiliser Svelte (sans SvelteKit) avec Vite en exécutant `npm create vite@latest`, puis en choisissant l'option `svelte`. De cette manière, `npm run build` génèrera les fichiers HTML, JS et CSS dans le dossier `dist`. Dans la plupart des cas, vous aurez aussi probablement besoin de [choisir une librairie de routing](/faq#is-there-a-router).
 
-Alternatively, there are [plugins for all the major web bundlers](https://sveltesociety.dev/tools#bundling) to handle Svelte compilation — which will output `.js` and `.css` that you can insert into your HTML — but most others won't handle SSR.
+Il existe également des [plugins pour les bundlers web majeurs](https://sveltesociety.dev/tools#bundling) pour gérer la compilation Svelte — qui génèreront les `.js` et `.css` à insérer dans votre HTML — mais la plupart ne gèreront pas pas le <span class="vo">[rendu côté serveur (SSR)](/docs/web#server-side-rendering)</span>.
 
-## Editor tooling
+## Outillage d'éditeur
 
-The Svelte team maintains a [VS Code extension](https://marketplace.visualstudio.com/items?itemName=svelte.svelte-vscode) and there are integrations with various other [editors](https://sveltesociety.dev/tools#editor-support) and tools as well.
+L'équipe Svelte maintient une extension [VS Code](https://marketplace.visualstudio.com/items?itemName=svelte.svelte-vscode), et des intégrations existent également pour d'autres [éditeurs](https://sveltesociety.dev/tools#editor-support) ou outils.
 
-## Getting help
+## Obtenir de l'aide
 
-Don't be shy about asking for help in the [Discord chatroom](https://svelte.dev/chat)! You can also find answers on [Stack Overflow](https://stackoverflow.com/questions/tagged/svelte).
+Si vous rencontrez des difficultés, vous trouverez de l'aide sur le [Discord officiel](PUBLIC_SVELTE_SITE_URL/chat) ou sur le [Discord francophone](/chat). Vous trouverez également des réponses sur [StackOverflow](https://stackoverflow.com/questions/tagged/svelte).

documentation/docs/01-getting-started/meta.json

@@ -1,3 +1,3 @@
 {
-"title": "Getting Started"
+"title": "Bien commencer"
 }