-
Notifications
You must be signed in to change notification settings - Fork 1k
add fr getting started page #2245
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
@apointeau Thanks for the contribution. I can't review this myself, but I created @scala/docs-fr team who might be able to. Maybe you could ping other French speakers you know of. |
@eed3si9n Hello, the page you link "@scala/docs-fr" results to a 404 error for me. I'm not very familiar with the contribution world, so it's hard for me to find someone else to review. I planed to traduct all the tour in french and some other pages. I took the time I need for high quality traduction, I hope that the review will be "easy". |
I used to be able to add random ppl on the GitHub team, but I seem to have lost the authorization to do so. I'm going to mention a few ppl. @Duhemm, @alexarchambault, @julienrf, @jto, @jeantil, @xbucchiotty, @Viewtiful Let us know if you could review French documentation translation. If you don't I'll find a Canadian person who would and you won't like it. |
It reads mostly ok for me. I suggested a few changes to fix typos mostly. |
Un grand merci Jean! Antoine has opened like 8 PRs so maybe you and others could take a look at those too (it's late so later probably)? 🙏 https://github.com/scala/docs.scala-lang/pulls |
Co-authored-by: Jean Helou <[email protected]>
Co-authored-by: Jean Helou <[email protected]>
Co-authored-by: Jean Helou <[email protected]>
Co-authored-by: Jean Helou <[email protected]>
Co-authored-by: Jean Helou <[email protected]>
Co-authored-by: Jean Helou <[email protected]>
Co-authored-by: Jean Helou <[email protected]>
Co-authored-by: Jean Helou <[email protected]>
Co-authored-by: Jean Helou <[email protected]>
Co-authored-by: Jean Helou <[email protected]>
Co-authored-by: Jean Helou <[email protected]>
@jeantil Thank you very much, there was many small dumb mistakes, I will try to better reread the next times. |
@apointeau thanks for your work, it's always easier to spot these when you didn't write them :) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
La traduction est vraiment superbe! Merci beaucoup pour votre travail!
Co-authored-by: Meriam Lachkar <[email protected]>
Co-authored-by: Meriam Lachkar <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks again!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I've found a few typos and made a few suggestions. Thanks @apointeau !
|
||
1. `cd` dans un répertoire vide. | ||
1. Lancez la commande `sbt new scala/scala3.g8` pour créer un projet Scala 3, ou `sbt new scala/hello-world.g8` pour créer un projet Scala 2. | ||
Cela va télécharger un projet template depuis Github. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Cela va télécharger un projet template depuis Github. | |
Cela va télécharger un projet modèle depuis Github. |
En plus de gérer les JVMs, `cs setup` installe aussi des utilitaires en ligne de commande : | ||
|
||
- Un JDK (si vous n'en avez pas déjà un) | ||
- L'outil de construction de package [sbt](https://www.scala-sbt.org/) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
According to Wikipedia, the french translation of "build tool" is "moteur de production". I don't think this is necessarily clearer, but that avoids franglais. I'm sure @sjrd has a better suggestion?
- src | ||
- main | ||
- scala (tout votre code Scala doit être placé ici) | ||
- Main.scala (Programme point d'entrée) <-- c'est tout ce dont nous avons besoin pour le moment |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- Main.scala (Programme point d'entrée) <-- c'est tout ce dont nous avons besoin pour le moment | |
- Main.scala (Point d'entrée du programme) <-- c'est tout ce dont nous avons besoin pour le moment |
## Ouvrir le projet hello-world | ||
|
||
Utilisons un IDE pour ouvrir le projet. Les plus populaires sont IntelliJ et VSCode. | ||
Il proposent tout deux des fonctionnalités riches, mais vous pouvez utiliser d'[autres éditeurs.](https://scalameta.org/metals/docs/editors/overview.html) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Il proposent tout deux des fonctionnalités riches, mais vous pouvez utiliser d'[autres éditeurs.](https://scalameta.org/metals/docs/editors/overview.html) | |
Il proposent tout deux des fonctionnalités avancées, mais vous pouvez utiliser d'[autres éditeurs.](https://scalameta.org/metals/docs/editors/overview.html) |
## Ouvrir le projet hello-world | ||
|
||
Utilisons un IDE pour ouvrir le projet. Les plus populaires sont IntelliJ et VSCode. | ||
Il proposent tout deux des fonctionnalités riches, mais vous pouvez utiliser d'[autres éditeurs.](https://scalameta.org/metals/docs/editors/overview.html) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I find the second part of the sentence "..., mais vous pouvez utiliser d'autres éditeurs." a bit weird, as it reads like a restriction or negation.
Il proposent tout deux des fonctionnalités riches, mais vous pouvez utiliser d'[autres éditeurs.](https://scalameta.org/metals/docs/editors/overview.html) | |
Il proposent tout deux des fonctionnalités riches. D'[autres éditeurs.](https://scalameta.org/metals/docs/editors/overview.html) sont également disponibles. |
|
||
1. Téléchargez [VSCode](https://code.visualstudio.com/Download) | ||
1. Installez l'extension Metals depuis [la marketplace](https://marketplace.visualstudio.com/items?itemName=scalameta.metals) | ||
1. Ensuite, ouvrez le repertoire contenant le fichier `build.sbt` (cela doit être le dossier `hello-world` si vous avez suivi les instructions précédentes). Choisissez *Import build* lorsque cela vous est demandé. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
1. Ensuite, ouvrez le repertoire contenant le fichier `build.sbt` (cela doit être le dossier `hello-world` si vous avez suivi les instructions précédentes). Choisissez *Import build* lorsque cela vous est demandé. | |
1. Ensuite, ouvrez le `répertoire` contenant le fichier `build.sbt` (cela doit être le dossier `hello-world` si vous avez suivi les instructions précédentes). Choisissez *Import build* lorsque cela vous est demandé. |
1. Installez l'extension Metals depuis [la marketplace](https://marketplace.visualstudio.com/items?itemName=scalameta.metals) | ||
1. Ensuite, ouvrez le repertoire contenant le fichier `build.sbt` (cela doit être le dossier `hello-world` si vous avez suivi les instructions précédentes). Choisissez *Import build* lorsque cela vous est demandé. | ||
|
||
> [Metals](https://scalameta.org/metals) est un "Serveur de langage Scala" qui fourni une aide pour écrire du code Scala dans VSCode et d'autres éditeurs [Atom, Sublime Text, autres ...](https://scalameta.org/metals/docs/editors/overview.html), en utilisant le protcole de langage serveur. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
> [Metals](https://scalameta.org/metals) est un "Serveur de langage Scala" qui fourni une aide pour écrire du code Scala dans VSCode et d'autres éditeurs [Atom, Sublime Text, autres ...](https://scalameta.org/metals/docs/editors/overview.html), en utilisant le protcole de langage serveur. | |
> [Metals](https://scalameta.org/metals) est un "Serveur de langage Scala" qui fournit une aide pour écrire du code Scala dans VSCode et d'autres éditeurs [Atom, Sublime Text, autres ...](https://scalameta.org/metals/docs/editors/overview.html), en utilisant le [Language Server Protocol (LSP)](https://microsoft.github.io/language-server-protocol/). |
- _build.sbt_ | ||
- _src/main/scala/Main.scala_ | ||
|
||
Quand vous allez lancer votre projet dans l'étape suivante, la configuration dans _build.sbt_ sera utilisé pour lancer le code dans _src/main/scala/Main.scala_. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Quand vous allez lancer votre projet dans l'étape suivante, la configuration dans _build.sbt_ sera utilisé pour lancer le code dans _src/main/scala/Main.scala_. | |
Quand vous lancerez votre projet à l'étape suivante, la configuration dans _build.sbt_ sera utilisée pour lancer le code dans _src/main/scala/Main.scala_. |
|
||
1. `cd` vers `hello-world`. | ||
1. Lancez `sbt`. Cela va ouvrir la console sbt. | ||
1. Ecrivez `~run`. Le symbole `~` est optionel, il va relancer l'application à chaque sauvegarde de fichier. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
1. Ecrivez `~run`. Le symbole `~` est optionel, il va relancer l'application à chaque sauvegarde de fichier. | |
1. Ecrivez `~run`. Le symbole `~` est optionnel, il va relancer l'application à chaque sauvegarde de fichier. |
|
||
Une fois que vous avez terminé le tutoriel ce dessus, vous pouvez consulter : | ||
|
||
* [The Scala Book](/scala3/book/introduction.html) ([Lien](/overviews/scala-book/introduction.html) vers la version Scala 2), qui fourni un ensemble de courtes leçons et introduit les fonctionnalités principales de Scala. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
* [The Scala Book](/scala3/book/introduction.html) ([Lien](/overviews/scala-book/introduction.html) vers la version Scala 2), qui fourni un ensemble de courtes leçons et introduit les fonctionnalités principales de Scala. | |
* [The Scala Book](/scala3/book/introduction.html) ([Lien](/overviews/scala-book/introduction.html) vers la version Scala 2), qui fournit un ensemble de courtes leçons et introduit les fonctionnalités principales de Scala. |
@Duhemm I will add your suggestions to a new PR! |
* add fr getting started page * add small fixes * add contribution author * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update index.md * Update _fr/getting-started/index.md Co-authored-by: Meriam Lachkar <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Meriam Lachkar <[email protected]> Co-authored-by: Jean Helou <[email protected]> Co-authored-by: Meriam Lachkar <[email protected]>
* add fr getting started page * add small fixes * add contribution author * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Jean Helou <[email protected]> * Update index.md * Update _fr/getting-started/index.md Co-authored-by: Meriam Lachkar <[email protected]> * Update _fr/getting-started/index.md Co-authored-by: Meriam Lachkar <[email protected]> Co-authored-by: Jean Helou <[email protected]> Co-authored-by: Meriam Lachkar <[email protected]>
No description provided.