Skip to content

Commit f567f7f

Browse files
l0ck3shahidhk
authored andcommitted
re-organise translations, add french (hasura#1922)
1 parent bfe53e9 commit f567f7f

14 files changed

+632
-29
lines changed

Diff for: CONTRIBUTING.md

+5
Original file line numberDiff line numberDiff line change
@@ -80,5 +80,10 @@ aforementioned sections).
8080

8181
- Don't add a period/dot (.) at the end of the summary line.
8282

83+
## Translations
84+
85+
This document is available in the following translations:
86+
87+
- [French :fr:](translations/CONTRIBUTING.french.md)
8388

8489
(Credits: Some sections are adapted from https://github.com/PostgREST/postgrest/blob/master/.github/CONTRIBUTING.md)

Diff for: README.md

+9-6
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Hasura GraphQL Engine is a blazing-fast GraphQL server that gives you **instant,
1212

1313
Hasura helps you build GraphQL apps backed by Postgres or incrementally move to GraphQL for existing applications using Postgres.
1414

15-
Read more at [hasura.io](https://hasura.io) and the [docs](https://docs.hasura.io).
15+
Read more at [hasura.io](https://hasura.io) and the [docs](https://docs.hasura.io).
1616

1717
------------------
1818

@@ -28,7 +28,7 @@ Read more at [hasura.io](https://hasura.io) and the [docs](https://docs.hasura.i
2828

2929
* **Make powerful queries**: Built-in filtering, pagination, pattern search, bulk insert, update, delete mutations
3030
* **Realtime**: Convert any GraphQL query to a live query by using subscriptions
31-
* **Merge remote schemas**: Access custom GraphQL schemas for business logic via a single GraphQL Engine endpoint. [**Read more**](remote-schemas.md).
31+
* **Merge remote schemas**: Access custom GraphQL schemas for business logic via a single GraphQL Engine endpoint. [**Read more**](remote-schemas.md).
3232
* **Trigger webhooks or serverless functions**: On Postgres insert/update/delete events ([read more](event-triggers.md))
3333
* **Works with existing, live databases**: Point it to an existing Postgres database to instantly get a ready-to-use GraphQL API
3434
* **Fine-grained access control**: Dynamic access control that integrates with your auth system (eg: auth0, firebase-auth)
@@ -61,7 +61,7 @@ Read more at [hasura.io](https://hasura.io) and the [docs](https://docs.hasura.i
6161

6262
<!-- markdown-toc end -->
6363

64-
## Quickstart:
64+
## Quickstart:
6565

6666
### One-click deployment on Heroku
6767

@@ -138,7 +138,7 @@ Check out all the example applications in the
138138
- [Browse APIs](https://realtime-chat.demo.hasura.app/console)
139139

140140
- Live location tracking app that shows a running vehicle changing current GPS
141-
coordinates moving on a map.
141+
coordinates moving on a map.
142142
- [Try it out](https://realtime-location-tracking.demo.hasura.app/)
143143
- [Tutorial](community/examples/realtime-location-tracking)
144144
- [Browse APIs](https://realtime-location-tracking.demo.hasura.app/console)
@@ -199,7 +199,7 @@ badge to your applications built using Hasura. ❤️
199199

200200
## License
201201

202-
The core GraphQL Engine is available under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0) (Apache-2.0).
202+
The core GraphQL Engine is available under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0) (Apache-2.0).
203203

204204
All **other contents** (except those in [`server`](server), [`cli`](cli) and
205205
[`console`](console) directories) are available under the [MIT License](LICENSE-community).
@@ -210,4 +210,7 @@ directories.
210210

211211
This readme is available in the following translations:
212212

213-
- [Japanese :jp:](README.japanese.md) (:pray: [@moksahero](https://github.com/moksahero))
213+
- [Japanese :jp:](translations/README.japanese.md) (:pray: [@moksahero](https://github.com/moksahero))
214+
- [French :fr:](translations/README.french.md) (:pray: [@l0ck3](https://github.com/l0ck3))
215+
216+
Translations for other files can be found [here](translations).

Diff for: SECURITY.md

+5
Original file line numberDiff line numberDiff line change
@@ -30,3 +30,8 @@ A public disclosure date is negotiated by the Hasura product security team and t
3030

3131
(Some sections have been inspired and adapted from [https://github.com/kubernetes/website/blob/master/content/en/docs/reference/issues-security/security.md](https://github.com/kubernetes/website/blob/master/content/en/docs/reference/issues-security/security.md))
3232

33+
## Translations
34+
35+
This document is available in the following translations:
36+
37+
- [French :fr:](translations/SECURITY.french.md)

Diff for: code-of-conduct.md

+6
Original file line numberDiff line numberDiff line change
@@ -71,3 +71,9 @@ This Code of Conduct is adapted from the [Contributor Covenant][homepage], versi
7171
available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
7272

7373
[homepage]: https://www.contributor-covenant.org
74+
75+
## Translations
76+
77+
This document is available in the following translations:
78+
79+
- [French :fr:](translations/code-of-conduct.french.md)

Diff for: event-triggers.md

+6
Original file line numberDiff line numberDiff line change
@@ -98,3 +98,9 @@ Propagate event-driven and asynchronous information to UI clients easily with Gr
9898
![Reactive apps architecture](assets/reactive-apps-arch.png)
9999

100100
**Watch**: [Building a reactive app with an async backend](https://youtu.be/kTSOxRrtCeI) (*04:15 mins*)
101+
102+
## Translations
103+
104+
This document is available in the following translations:
105+
106+
- [French :fr:](translations/event-triggers.french.md)

Diff for: remote-schemas.md

+4
Original file line numberDiff line numberDiff line change
@@ -77,4 +77,8 @@ These limitations will be addressed in upcoming versions.
7777

7878
Read the complete [documentation](https://docs.hasura.io/1.0/graphql/manual/remote-schemas/index.html).
7979

80+
## Translations
8081

82+
This document is available in the following translations:
83+
84+
- [French :fr:](translations/remote-schemas.french.md)

Diff for: translations/CONTRIBUTING.french.md

+82
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
# Contribuer à Hasura graphql-engine
2+
3+
*Premièrement*: si vous n'êtes pas certain ou avez des craintes au sujet de quoi que ce soit,
4+
il vous suffit de poser une question, ou de soumettre une issue ou pull request malgré tout.
5+
Personne ne vous grondera alors que vous faites de votre mieux.
6+
Le pire serait que l'on vous demande poliment de modifier quelque chose.
7+
Nous apprécions toute contribution, et ne voulons pas qu'une muraille de règles entrave cela.
8+
9+
Cependant, pour ceux qui souhaitent un peu plus d'accompagnement sur la meilleure
10+
manière de contribuer au projet, lisez plus loin. Ce document traite du sujet qui
11+
vous intéresse. En répondant à tous les critères que nous recherchons, les chance que
12+
nous puissions intégrer ou traiter vos contributions augmenteront.
13+
14+
## Vue d'ensemble
15+
16+
[hasura/graphql-engine](https://github.com/hasura/graphql-engine) est un mono-repo
17+
consistant en 3 composants. Chacun ayant son propre guide de contribution:
18+
19+
1. [Server (Haskell)](../server/CONTRIBUTING.md)
20+
2. [CLI (Go)](../cli/CONTRIBUTING.md)
21+
3. [Console (JavaScript)](../console/README.md#contributing-to-hasura-console)
22+
23+
Chacun de ces trois composants possède une version unique, désignée soit par le tag git, soit par une
24+
combinaison du nom de la branche et du SHA de commit git.
25+
26+
Pour toutes les contributions, un CLC (Contat de Licence de Contributeur) doit être signé [ici](https://cla-assistant.io/hasura/graphql-engine) avant (ou après) que la pull request ait été soumise. Un bot demandera si nécessaire aux contributeurs de signer le CLC au moyen d'un commentaire de pull request.
27+
28+
29+
### Documentation
30+
31+
Le guide de contribution pour la documentation peut être trouvé sur [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md).
32+
33+
### Contenu communautaire
34+
35+
Il n'existe aucun guide spécifique pour la contribution au contenu communautaire.
36+
N'importe quoi pouvant aider la communauté ou les utilisateurs du GraphQL Engine
37+
peut faire partie de cette section. Nous avons identifié [boilerplates](../community/boilerplates),
38+
[sample-apps](../community/sample-apps) et [outils](../community/tools) comme candidats principaux.
39+
N'hésitez pas à soumettre une pull request si vous avez quelque chose à ajouter (n'appartenant
40+
pas forcément aux sections mentionnées ci-dessus).
41+
42+
## Problèmes
43+
44+
### Rapporter un Problème
45+
46+
- Soyez certains de tester avec la dernière version disponible. Il est possible que
47+
le bug que vous rencontrez ait déja été corrigé.
48+
49+
- Précisez les étapes à suivre pour reproduire le problème, en incluant la version
50+
de Postgres, la version de graphql-engine et la plateforme sur laquelle vous les
51+
exécutez (Heroku, Docker, etc ...).
52+
53+
- Veuillez inclure les logs du server, si nécessaire.
54+
55+
56+
## Directives communes
57+
58+
- Soyez certain qu'il y a une issue associée avec le travail que vous êtes en train de réaliser.
59+
60+
- Si vous travaillez sur une issue, veuillez commenter ce que vous faites pour éviter une duplication
61+
du travail par d'autres.
62+
63+
- Veuillez "squasher" vos commits et ajouter une référence à l'issue en ajoutant `fix #<issue-no>`
64+
ou `close #<issue-no>` dans le message de commit, à la fin.
65+
Par exemple `resolve answers to everything (fix #42)` ou `resolve answers to everything, fix #42`
66+
67+
- Rebasez master avec votre branche avant de soumettre une pull request.
68+
69+
## Messages de commit
70+
71+
- La première ligne doit être un résumé des changements, ne dépassant pas 50 caractères, suivi
72+
par une section optionnelle contenant plus de détails au sujet des modifications.
73+
Référez vous à [ce lien](https://github.com/erlang/otp/wiki/writing-good-commit-messages)
74+
pour plus d'informations à propos de l'écriture de bons messages de commit.
75+
76+
- Utilisez l'impératif présent: "add/fix/change", et non "added/fixed/changed" ou "adds/fixes/changes".
77+
78+
- Ne mettez pas la première lettre de la ligne de résumé en majuscule.
79+
80+
- N'ajoutez pas de point (.) à la fin de la ligne de résumé.
81+
82+
(Credits: Certaines sections sont adaptées de https://github.com/PostgREST/postgrest/blob/master/.github/CONTRIBUTING.md)

Diff for: translations/README.french.md

+197
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,197 @@
1+
# Hasura GraphQL Engine
2+
3+
[![Docs](https://img.shields.io/badge/docs-v1.0-brightgreen.svg?style=flat)](https://docs.hasura.io)
4+
[![CircleCI](https://circleci.com/gh/hasura/graphql-engine.svg?style=shield)](https://circleci.com/gh/hasura/graphql-engine)
5+
6+
7+
<a href="https://discord.gg/vBPpJkS"><img src="https://img.shields.io/badge/chat-discord-brightgreen.svg?logo=discord&style=flat"></a>
8+
<a href="https://twitter.com/intent/follow?screen_name=HasuraHQ"><img src="https://img.shields.io/badge/Follow-HasuraHQ-blue.svg?style=flat&logo=twitter"></a>
9+
<a href="https://eepurl.com/dBUfJ5"><img src="https://img.shields.io/badge/newsletter-subscribe-yellow.svg?style=flat"></a>
10+
11+
Hasura GraphQL Engine est un serveur GraphQL ultra-rapide qui vous permet de créer **instantanément, des APIs GraphQL basées sur Postgres**, avec des [**déclencheurs de webhoook**](event-triggers.french.md) pour la logique métier.
12+
13+
Hasura vous aide à construire des applications GraphQL basées sur Posgres ou à adopter graduellement GraphQL pour des applications existantes utilisant Postgres.
14+
15+
16+
Plus d'informations sur [hasura.io](https://hasura.io) et dans la [documentation](https://docs.hasura.io).
17+
18+
------------------
19+
20+
![Démo Hasura GraphQL Engine](../assets/demo.gif)
21+
22+
------------------
23+
24+
![Démo Hasura GraphQL Engine Realtime](../assets/realtime.gif)
25+
26+
-------------------
27+
28+
## Fonctionnalités
29+
30+
* **Réalisez des requêtes avancées**: filtrage intégré, pagination, recherche par patterns, mutations d'insertions en masse, mises-à-jour et suppression.
31+
* **Temps réel**: Convertissez n'importe quelle requête GraphQL en requête temps-réel en uttilisant les `subscriptions`.
32+
* **Fusionnez des schémas distants**: Accédez à vos propres schémas GraphQL pour votre logique métier, via un point d'accès GraphQL unique. [Plus d'informations](remote-schemas.french.md).
33+
* **Déclenchez des webhooks ou des fonctions serverless**: En réactions aux évènements Postgres insert/update/delete ([Plus d'informations](event-triggers.french.md))
34+
* **Fonctionne avec les bases de données existantes**: Pointez GraphQL Engine vers une base de données Postgres existante afin d'obtenir instantanément une API GraphQL prête à l'emploi.
35+
* **Contrôle d'accès détaillé**: Contrôle d'accès dynamique qui s'intègre avec votre système d'authentification (ex: auth0, firebase-auth)
36+
* **Haute performance & faible impact**: Image Docker de ~15MB; ~50MB RAM @ 1000 req/s; prise en compte du multi-core
37+
* **Interface d'administration & Migrations**: Interface d'administration & migrations de schéma à la Rails
38+
* **Postgres** ❤️: Supporte les types Postgres (PostGIS/geo-location, etc.), transforme les vues en *graphs*, déclenche des procédures ou fonctions stockées via les mutations
39+
40+
Plus d'informations sur [hasura.io](https://hasura.io) et dans la [documentation](https://docs.hasura.io).
41+
42+
## Table des matières
43+
<!-- markdown-toc start - Don't edit this section. Run M-x markdown-toc-refresh-toc -->
44+
**Table des matières**
45+
46+
- [Démarrage rapide](#quickstart)
47+
- [Déploiement sur Heroku en un click](#one-click-deployment-on-heroku)
48+
- [Autres méthodes de déploiement](#other-deployment-methods)
49+
- [Architecture](#architecture)
50+
- [Outils côté client](#client-side-tooling)
51+
- [Ajout de logique métier](#add-business-logic)
52+
- [Schémas distants](#remote-schemas)
53+
- [Déclenchez des webhooks sur des evènements de base de donnée](#trigger-webhooks-on-database-events)
54+
- [Demos](#demos)
55+
- [Applications temps-réel](#realtime-applications)
56+
- [Videos](#videos)
57+
- [Support & Dépannage](#support--troubleshooting)
58+
- [Contribuer](#contributing)
59+
- [Elements de marque](#brand-assets)
60+
- [Licence](#license)
61+
62+
<!-- markdown-toc end -->
63+
64+
## Démarrage rapide:
65+
66+
### Déploiement sur Heroku en un click
67+
68+
La manière la plus rapide d'essayer Hasura est via Heroku.
69+
70+
1. Cliquez sur le bouton ci-dessous pour déployer GraphQL Engine sur Heroku avec l'add-on Postgres gratuit:
71+
72+
[![Déployer sur Heroku](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/hasura/graphql-engine-heroku)
73+
74+
2. Ouvrez la console Hasura
75+
76+
Visitez `https://<app-name>.herokuapp.com` (*remplacez \<app-name\> par le nom de votre application*) pour ouvrir la console d'administration.
77+
78+
3. Réalisez votre première requête GraphQL
79+
80+
Créez une table et réalisez votre première requête. Suivez ce [guide](https://docs.hasura.io/1.0/graphql/manual/getting-started/first-graphql-query.html).
81+
82+
### Autres méthodes de déploiement
83+
84+
Pour les méthodes de déploiement basées sur Docker et les options de configuration avancées, consultez les [guides de déploiement](https://docs.hasura.io/1.0/graphql/manual/getting-started/index.html) ou les [manifestes d'installation](../install-manifests).
85+
86+
## Architecture
87+
88+
Hasura GraphQL Engine se place en frontal d'une base de données Postgres et peut accepter les requêtes GraphQL de vos applications clientes. Il peut être configuré pour fonctionner avec votre système d'authentification existant et peut gérer le contrôle d'accès au niveau des champs grâce a des règles, avec des variables dynamiques provenant du système d'authentification.
89+
90+
Vous pouvez également fusionner des schémas GraphQL distants et fournir une API GraphQL unifiée.
91+
92+
![Architecture de Hasura GraphQL Engine](../assets/hasura-arch.svg)
93+
94+
## Outils côté client
95+
96+
Hasura fonctionne avec n'importe quel client GraphQL. Nous recommandons l'utilisation d'[Apollo Client](https://github.com/apollographql/apollo-client). Consultez [awesome-graphql](https://github.com/chentsulin/awesome-graphql) pour une liste de clients.
97+
98+
## Ajout de logique métier
99+
100+
GraphQL Engine fournit plusieurs méthodes claires, évolutives et performantes pour ajouter votre propre logique métier à votre backend:
101+
102+
### Schémas distants
103+
104+
Ajoutez vos propres resolvers dans un schéma distant en plus du schéma dérivé de Postgres d'Hasura. Idéal pour des cas d'utilisation tels que l'implémentation d'une API de paiement, ou le requêtage de donnée ne se trouvant pas dans votre base de données - [plus d'informations](remote-schemas.french.md).
105+
106+
### Déclenchez des webhooks sur des évènements de base de données
107+
108+
Ajoutez de la logique métier asynchrone, déclenchée par des évènements de base de données.
109+
Idéal pour les notifications, les pipelines de données de Postgres ou les
110+
traitements asynchrones - [plus d'informations](event-triggers.french.md).
111+
112+
### Données dérivée ou transformations de données
113+
114+
Transformez les données dans Postgres ou exécutez de la logique métier dessus pour en deriver un autre jeu de données qui peut être requêté à l'aide de GraphQL Engine - [plus d'informations](https://docs.hasura.io/1.0/graphql/manual/queries/derived-data.html).
115+
116+
## Démos
117+
118+
Consultez toutes les applications d'example dans le répertoire
119+
[community/sample-apps](../community/sample-apps).
120+
121+
### Applications temps-réel
122+
123+
- Application de messagerie de groupe développée avec React, incluant un indicateur de frappe, les utilisateurs connectés & les
124+
notifications de nouveaux messages.
125+
- [Essayez la](https://realtime-chat.demo.hasura.app/)
126+
- [Tutoriel](../community/examples/realtime-chat)
127+
- [Explorez les APIs](https://realtime-chat.demo.hasura.app/console)
128+
129+
- Application de localisation en temps-réel montrant un véhicule dont les coordonnées GPS évoluent
130+
se déplacer sur une carte.
131+
- [Essayez la](https://realtime-location-tracking.demo.hasura.app/)
132+
- [Tutoriel](../community/examples/realtime-location-tracking)
133+
- [Explorez les APIs](https://realtime-location-tracking.demo.hasura.app/console)
134+
135+
- Un tableau de bord temps-réel pour l'aggrégation de données en constante évolution.
136+
- [Essayez la](https://realtime-poll.demo.hasura.app/)
137+
- [Tutoriel](../community/examples/realtime-poll)
138+
- [Explorez les APIs](https://realtime-poll.demo.hasura.app/console)
139+
140+
### Vidéos
141+
142+
* [Ajoutez GraphQL à une instance GitLab auto-hébergée](https://www.youtube.com/watch?v=a2AhxKqd82Q) (*3:44 mins*)
143+
* [Application de liste de tâches avec Auth0 et un backend GraphQL](https://www.youtube.com/watch?v=15ITBYnccgc) (*4:00 mins*)
144+
* [API GraphQL sur GitLab intégrée avec l'authentification GitLab](https://www.youtube.com/watch?v=m1ChRhRLq7o) (*4:05 mins*)
145+
* [Tableau de bord pour 10 millions de trajets avec géolocalisation (PostGIS, Timescale)](https://www.youtube.com/watch?v=tsY573yyGWA) (*3:06 mins*)
146+
147+
## Support & Dépannage
148+
149+
La documentation et la communauté vous aideront à résoudre la plupart des problèmes. Si vous avez rencontré un bug ou avez besoin de nous contacter, vous pouvez nous joindre au travers des canaux suivants:
150+
151+
* Support & retours: [Discord](https://discord.gg/vBPpJkS)
152+
* Problèmes & remontées de bugs: [GitHub issues](https://github.com/hasura/graphql-engine/issues)
153+
* Suivez les mise à jour du produit: [@HasuraHQ](https://twitter.com/hasurahq)
154+
* Parlez nous sur la [messagerie du site Web](https://hasura.io)
155+
156+
Nous nous impliquons dans le développement d'un environnement ouvert et accueillant dans la communauté. Veuillez consulter le [Code de Conduite](code-of-conduct.french.md).
157+
158+
159+
Si vous souhaitez rapporter un problème de sécurité, veuillez [lire ceci](SECURITY.french.md).
160+
161+
## Contribuer
162+
163+
Consultez notre [guide de contribution](CONTRIBUTING.french.md) pour plus de détails.
164+
165+
## Elements de marque
166+
167+
Les élements de marque Hasura (logos, mascotte Hasura, badges "powered by" etc...) peuvent être
168+
trouvés dans le répertoire [assets/brand](../assets/brand). N'hésitez pas à les utiliser dans votre
169+
application/site Web etc... Nous serions ravis si vous ajoutiez le badge "Powered by Hasura"
170+
à votre application développée à l'aide d'Hasura. ❤️
171+
172+
<div style="display: flex;">
173+
<img src="../assets/brand/powered_by_hasura_black.svg" width="150px"/>
174+
<img src="../assets/brand/powered_by_hasura_white.svg" width="150px"/>
175+
</div>
176+
177+
```html
178+
<!-- Pour les fonds clairs -->
179+
<a href="https://hasura.io">
180+
<img width="150px" src="https://graphql-engine-cdn.hasura.io/img/powered_by_hasura_black.svg" />
181+
</a>
182+
183+
<!-- Pour les fonds foncés -->
184+
<a href="https://hasura.io">
185+
<img width="150px" src="https://graphql-engine-cdn.hasura.io/img/powered_by_hasura_white.svg" />
186+
</a>
187+
```
188+
189+
## Licence
190+
191+
Le GraphQL Engine est disponible sous [Apache License
192+
2.0](https://www.apache.org/licenses/LICENSE-2.0) (Apache-2.0).
193+
194+
Tous les **autres contenus** (à l'exception de ceux dans les répertoires
195+
[`server`](../server), [`cli`](../cli) et [`console`](../console)) sont
196+
disponibles sous [Licence MIT](../LICENSE-community). Cela inclut tout le
197+
contenu des répertoires [`docs`](../docs) et [`community`](../community).

0 commit comments

Comments
 (0)