aboutsummaryrefslogtreecommitdiff
path: root/docs/fr/developers/01_First_steps.md
diff options
context:
space:
mode:
authorGravatar Alexandre Alapetite <alexandre@alapetite.fr> 2022-01-08 21:58:55 +0100
committerGravatar GitHub <noreply@github.com> 2022-01-08 21:58:55 +0100
commit1acd3ab09be1b65bfd6122ee351490c3b5527bb8 (patch)
treef11de558e7a09522a45d1c155d9707ecda6bf1eb /docs/fr/developers/01_First_steps.md
parent916df412f5b6f7fb9bcfb705a3c8c23e35304410 (diff)
Use typographic quotes (#4133)
* Use typographic quotes * A few fixes * Fix * Fix not saved * Implement feedback * Detail * Revert spoken English fixes Left for a future dedicated discussion * More reverts * Final reverts * Final minor
Diffstat (limited to 'docs/fr/developers/01_First_steps.md')
-rw-r--r--docs/fr/developers/01_First_steps.md66
1 files changed, 33 insertions, 33 deletions
diff --git a/docs/fr/developers/01_First_steps.md b/docs/fr/developers/01_First_steps.md
index 59b475ffa..6c02b5058 100644
--- a/docs/fr/developers/01_First_steps.md
+++ b/docs/fr/developers/01_First_steps.md
@@ -3,38 +3,38 @@
## Configurer son environnement (Docker)
FreshRSS est construit en PHP et utilise le framework Minz. Les
-dépendancessont directement incluses dans le code source, donc vous n'avez
-pas besoin d'utiliser Composer.
+dépendancessont directement incluses dans le code source, donc vous n’avez
+pas besoin d’utiliser Composer.
Il existe plusieurs façons de configurer votre environnement
dedéveloppement. La méthode la plus simple et la plus supportée est basée
-surDocker. C'est la solution qui est documentée ci-dessous. Si vous avez
-déjà unenvironnement PHP fonctionnel, vous n'en avez probablement pas
+surDocker. C’est la solution qui est documentée ci-dessous. Si vous avez
+déjà unenvironnement PHP fonctionnel, vous n’en avez probablement pas
besoin.
Nous supposons ici que vous utilisez une distribution GNU/Linux, capable
-d'exécuter Docker. Sinon, vous devrez adapter les commandes en conséquence.
+d’exécuter Docker. Sinon, vous devrez adapter les commandes en conséquence.
Les commandes qui suivent doivent être exécutées dans une console. Ils
commencent par `$` quand les commandes doivent être exécutées en tant
-qu'utilisateur normal, et par `#` quand elles doivent être exécutées en tant
-qu'utilisateur root. Vous n'avez pas besoin de taper ces caractères. Un
-chemin d'accès peut être indiqué devant ces caractères pour vous aider à
+qu’utilisateur normal, et par `#` quand elles doivent être exécutées en tant
+qu’utilisateur root. Vous n’avez pas besoin de taper ces caractères. Un
+chemin d’accès peut être indiqué devant ces caractères pour vous aider à
identifier où ils doivent être exécutés. Par exemple, `app$ echo 'Hello
World'` indique que vous devez exécuter la commande `echo` dans le
répertoire `app/`.
-Tout d'abord, vous devez installer
+Tout d’abord, vous devez installer
[Docker](https://docs.docker.com/install/linux/docker-ce/ubuntu/).
-Une fois que c'est fait, clonez le dépôt de code de la manière suivante :
+Une fois que c’est fait, clonez le dépôt de code de la manière suivante :
```sh
git clone https://github.com/FreshRSS/FreshRSS.git
cd FreshRSS
```
-Notez que, pour contribuer, vous devrez d'abord « forker » ce dépôt de code
+Notez que, pour contribuer, vous devrez d’abord « forker » ce dépôt de code
(ou dépôt de code référent) et cloner votre « fork » à la place de ce
dépôt. Adaptez les commandes en conséquence.
@@ -44,12 +44,12 @@ Ensuite, la seule commande que vous devez connaître est la suivante :
make start
```
-Cela peut prendre un certain temps pour que Docker télécharge l'image
+Cela peut prendre un certain temps pour que Docker télécharge l’image
utilisée. Dans le cas où la commande échoue pour un problème de droit, il
faudra soit ajouter votre utilisateur au groupe `docker`, soit relancer la
commande en la préfixant par `sudo`.
-**Vous pouvez maintenant accéder à FreshRSS à [http://localhost:8080](http://localhost:8080).** Suivez simplement le processus d'installation et sélectionnez la base de données SQLite.
+**Vous pouvez maintenant accéder à FreshRSS à [http://localhost:8080](http://localhost:8080).** Suivez simplement le processus d’installation et sélectionnez la base de données SQLite.
Vous pouvez arrêter les conteneurs en tapant <kbd>Control</kbd> + <kbd>c</kbd> ou avec la commande suivante, dans un autre terminal:
@@ -60,9 +60,9 @@ make stop
Si la configuration vous intéresse, les commandes `make' sont définies dans
le fichier [`Makefile`](/Makefile).
-Si vous avez besoin d'utiliser une image Docker identifiée par un tag
+Si vous avez besoin d’utiliser une image Docker identifiée par un tag
différent (par défaut `alpine`), vous pouvez surcharger de la manière
-suivante la variable d'environnement `TAG` au moment de l'exécution de la
+suivante la variable d’environnement `TAG` au moment de l’exécution de la
commande :
```sh
@@ -72,7 +72,7 @@ TAG=arm make start
Vous pouvez trouver la liste complète des tags disponibles [sur le hub
Docker](https://hub.docker.com/r/freshrss/freshrss/tags).
-Si vous voulez construire l'image Docker, vous pouvez lancer la commande
+Si vous voulez construire l’image Docker, vous pouvez lancer la commande
suivante :
```sh
@@ -81,7 +81,7 @@ make build
TAG=arm make build
```
-La valeur de la variable `TAG` peut contenir n'importe quelle valeur (par
+La valeur de la variable `TAG` peut contenir n’importe quelle valeur (par
exemple `local`). Vous pouvez cibler une architecture spécifique en ajoutant
`-alpine` ou `-arm` à la fin du tag (par exemple `local-arm`).
@@ -92,13 +92,13 @@ exemple `local`). Vous pouvez cibler une architecture spécifique en ajoutant
## Extensions
Si vous souhaitez créer votre propre extension FreshRSS, consultez la
-[documentation de l'extension](03_Backend/05_Extensions.md).
+[documentation de l’extension](03_Backend/05_Extensions.md).
## Style de codage
Si vous désirez contribuer au code, il est important de respecter le style
de codage suivant. Le code actuel ne le respecte pas entièrement mais il est
-de notre devoir à tous de le changer dès que l'occasion se présente.
+de notre devoir à tous de le changer dès que l’occasion se présente.
Aucune nouvelle contribution ne respectant pas ces règles ne sera acceptée
tant que les corrections nécessaires ne sont pas appliquées.
@@ -107,11 +107,11 @@ tant que les corrections nécessaires ne sont pas appliquées.
#### Indentation
-L'indentation du code doit être faite impérativement avec des tabulations.
+L’indentation du code doit être faite impérativement avec des tabulations.
#### Alignement
-Une fois l'indentation faite, il peut être nécessaire de faire un alignement
+Une fois l’indentation faite, il peut être nécessaire de faire un alignement
pour simplifier la lecture. Dans ce cas, il faut utiliser les espaces.
```php
@@ -129,9 +129,9 @@ Il est possible de vérifier la présence de caractères blancs en fin de ligne
grâce à Git avec la commande suivante :
```sh
-# commande à lancer avant l'ajout des fichiers dans l'index
+# commande à lancer avant l’ajout des fichiers dans l’index
git diff --check
-# commande à lancer après l'ajout des fichiers dans l'index mais avant le commit
+# commande à lancer après l’ajout des fichiers dans l’index mais avant le commit
git diff --check --cached
```
@@ -141,11 +141,11 @@ Chaque fichier doit se terminer par une ligne vide.
#### Le cas de la virgule, du point et du point-virgule
-Il n'y a pas d'espace avant ces caractères, il y en a un après.
+Il n’y a pas d’espace avant ces caractères, il y en a un après.
#### Le cas des opérateurs
-Chaque opérateur est entouré d'espaces.
+Chaque opérateur est entouré d’espaces.
```php
if ($a == 10) {
@@ -157,9 +157,9 @@ echo $a ? 1 : 0;
#### Le cas des parenthèses
-Il n'y a pas d'espaces entre des parenthèses. Il n'y a pas d'espaces avant
-une parenthèse ouvrante sauf si elle est précédée d'un mot-clé. Il n'y a pas
-d'espaces après une parenthèse fermante sauf si elle est suivie d'une
+Il n’y a pas d’espaces entre des parenthèses. Il n’y a pas d’espaces avant
+une parenthèse ouvrante sauf si elle est précédée d’un mot-clé. Il n’y a pas
+d’espaces après une parenthèse fermante sauf si elle est suivie d’une
accolade ouvrante.
```php
@@ -177,7 +177,7 @@ if ((int)$a == 10) {
Ce cas se présente le plus souvent en Javascript. Quand on a des fonctions
chainées, des fonctions anonymes ainsi que des fonctions de rappels, il est
très facile de se perdre. Dans ce cas là, on ajoute une indentation
-supplémentaire pour toute l'instruction et on revient au même niveau pour
+supplémentaire pour toute l’instruction et on revient au même niveau pour
une instruction de même niveau.
```javascript
@@ -198,7 +198,7 @@ shortcut.add("shift+" + shortcuts.mark_read, function () {
### Longueur des lignes
Les lignes ne doivent pas dépasser 80 caractères. Il est cependant autorisé
-exceptionnellement de dépasser cette limite s'il n'est pas possible de la
+exceptionnellement de dépasser cette limite s’il n’est pas possible de la
respecter mais en aucun cas, les lignes ne doivent dépasser les 100
caractères.
@@ -214,7 +214,7 @@ function ma_fonction($param_1, $param_2,
### Nommage
-L'ensemble des éléments du code (fonctions, classes, méthodes et variables)
+L’ensemble des éléments du code (fonctions, classes, méthodes et variables)
doivent être nommés de manière à décrire leur usage de façon concise.
#### Fonctions et variables
@@ -278,8 +278,8 @@ fermante.
#### Tableaux
-Lors de l'écriture de tableaux sur plusieurs lignes, tous les éléments
-doivent être suivis d'une virgule (même le dernier).
+Lors de l’écriture de tableaux sur plusieurs lignes, tous les éléments
+doivent être suivis d’une virgule (même le dernier).
```php
$variable = [