Skip to content

Commit 788e422

Browse files
raphael-asSkyExploreWasTaken
raphael-as
and
SkyExploreWasTaken
authored
Useful traduction FR (#63)
* Add files via upload * Update domain-structure.md --------- Co-authored-by: SkyExploreWasTaken <[email protected]>
1 parent 88f8d75 commit 788e422

File tree

4 files changed

+362
-1
lines changed

4 files changed

+362
-1
lines changed

‎src/fr/useful/domain-structure.md‎

Lines changed: 216 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,216 @@
1+
---
2+
icon: file-code
3+
route: /domain-structure
4+
tags: useful
5+
---
6+
# Structure de Domaine
7+
Pour enregistrer un sous-domaine, vous devez créer un nouveau fichier JSON dans le répertoire `domains` via une pull request. Par exemple, pour enregistrer `example.is-a.dev`, vous devez créer un fichier nommé `example.json` dans le répertoire `domains`. Le chemin complet serait `domains/example.json`.
8+
9+
## Nom du fichier
10+
11+
**Remarque** : Vous pouvez inclure des `.` (points) dans votre nom de fichier pour enregistrer un sous-sous-domaine (par exemple, `blog.example.is-a.dev`). Cependant, chaque segment de votre sous-domaine doit respecter les critères suivants :
12+
13+
Le nom de fichier :
14+
15+
- Doit être alphanumérique, en minuscules, avec des tirets comme séparateurs.
16+
- Doit contenir au moins 1 caractère.
17+
- Doit avoir une extension `.json`.
18+
19+
### Exemples de noms de fichiers invalides
20+
- `.json` (le nom du fichier contient moins d’un caractère)
21+
- `A.json` (le nom du fichier contient des lettres majuscules)
22+
- `a..json` (le nom du fichier contient des points consécutifs)
23+
- `.a.json` (le nom du fichier commence par un point)
24+
- `a .json` (le nom du fichier contient un espace)
25+
- `a$.json` (le nom du fichier contient un caractère non alphanumérique)
26+
- `a.json.json` (le nom du fichier contient plus d’une extension `.json`)
27+
- `a.is-a.dev.json` (le nom du fichier contient `.is-a.dev`)
28+
29+
### Exemples de noms de fichiers valides
30+
Tous les noms de fichiers ci-dessous respectent les critères. La raison indiquée entre parenthèses est un exemple d’un critère qu’ils remplissent.
31+
32+
- `a.json` (au moins 1 caractère de long)
33+
- `example.json` (alphanumérique et en minuscules)
34+
- `blog.example.json` (inclut des points pour enregistrer un sous-sous-domaine)
35+
- `my-blog.json` (utilise des tirets comme séparateurs, ce qui est recommandé)
36+
37+
**REMARQUE :** Afin d’empêcher une personne d’avoir un monopole sur les sous-domaines d’une seule lettre, nous limitons chacun à un seul sous-domaine d’une lettre.
38+
39+
### Exemple de fichier JSON
40+
`domains/docs.json`
41+
42+
```json
43+
{
44+
"description": "Site web de documentation pour is-a.dev",
45+
"repo": "https://github.com/is-a-dev/docs",
46+
"owner": {
47+
"username": "is-a-dev",
48+
"email": "[email protected]"
49+
},
50+
"record": {
51+
"CNAME": "is-a-dev-docs.pages.dev"
52+
},
53+
"proxied": true
54+
}
55+
```
56+
57+
## Structure
58+
59+
### Owner (obligatoire)
60+
Vous devez spécifier certaines informations vous concernant ici. Cela permet de vous contacter si nécessaire.
61+
Dans l’objet owner, les champs `username` et `email` sont obligatoires. Vous pouvez ajouter plus d’informations dans cet objet si vous le souhaitez.
62+
```json
63+
{
64+
"owner": {
65+
"username": "github-username"
66+
}
67+
}
68+
```
69+
70+
### Description
71+
Décrivez votre nom de domaine et son utilisation. Ceci est uniquement à des fins de documentation et est optionnel.
72+
73+
### Repo
74+
Ceci est un lien vers le dépôt de votre site Web ou votre compte GitHub. Ceci est uniquement à des fins de documentation et est optionnel.
75+
76+
### Record (obligatoire)
77+
Cette section est l’endroit où vous spécifiez les enregistrements DNS.
78+
79+
Vous pouvez voir une liste des types pris en charge [ici](./faq#which-records-are-supported).
80+
81+
Vous trouverez ci-dessous quelques exemples pour les types d’enregistrements donnés :
82+
83+
- **Enregistrement CNAME** : Il doit s’agir d’un nom d’hôte (`quelquechose.tld`). Il ne peut pas être utilisé en même temps que d’autres types d’enregistrements. Il est généralement utilisé pour mapper votre domaine à un serveur spécifique.
84+
```json
85+
{
86+
"record": {
87+
"CNAME": "nom-utilisateur-github.github.io"
88+
}
89+
}
90+
```
91+
- **Enregistrement A** : Il doit s’agir d’une liste d’adresses IPv4. Ces adresses pointent votre domaine vers un serveur spécifique.
92+
```json
93+
{
94+
"record": {
95+
"A": [
96+
"192.0.2.1",
97+
"198.51.100.1",
98+
"203.0.113.1"
99+
]
100+
}
101+
}
102+
```
103+
- **Enregistrement AAAA** : Il doit s’agir d’une liste d’adresses IPv6. Comme l’enregistrement A, ces adresses pointent votre domaine vers un serveur spécifique.
104+
```json
105+
{
106+
"record": {
107+
"AAAA": [
108+
"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
109+
"2001:0db8:85a3:0000:0000:8a2e:0370:7335",
110+
"2001:0db8:85a3:0000:0000:8a2e:0370:7336"
111+
]
112+
}
113+
}
114+
```
115+
- **Enregistrement URL** : Celui-ci redirige votre domaine vers une autre URL.
116+
```json
117+
{
118+
"record": {
119+
"URL": "https://exemple.com"
120+
}
121+
}
122+
```
123+
- **Enregistrement MX** : Il doit s’agir d’une liste de noms d’hôte. Ces noms d’hôte spécifient les serveurs de messagerie qui gèrent les e-mails pour votre domaine.
124+
```json
125+
{
126+
"record": {
127+
"MX": [
128+
"mx1.improvmx.com",
129+
"mx2.improvmx.com"
130+
]
131+
}
132+
}
133+
```
134+
- **Enregistrement TXT** : Il peut s’agir soit d’une seule chaîne de caractères, soit d’une liste de chaînes. Les enregistrements TXT sont souvent utilisés à diverses fins, telles que la vérification de la propriété du domaine et la sécurisation des e-mails.
135+
```json
136+
{
137+
"record": {
138+
"TXT": "Hello World!"
139+
}
140+
}
141+
```
142+
```json
143+
{
144+
"record": {
145+
"TXT": ["Hello", "World!"]
146+
}
147+
}
148+
```
149+
- **Enregistrement NS** : Il doit s’agir d’une liste de noms d’hôte. Ces noms d’hôte spécifient les serveurs DNS faisant autorité pour votre domaine.
150+
```json
151+
{
152+
"record": {
153+
"NS": [
154+
"ns1.exemple.com",
155+
"ns2.exemple.com"
156+
]
157+
}
158+
}
159+
```
160+
**Remarque** : Veuillez consulter la [foire aux questions](https://docs.is-a.dev/faq/) pour des précisions sur ce que nous acceptons ou non en matière d’enregistrements NS. Si vous souhaitez voir un exemple de ce que nous attendons comme justification, vous pouvez consulter [cette PR](https://github.com/is-a-dev/register/pull/16758).
161+
162+
- **Enregistrement SRV** : Il doit s’agir d’une liste d’enregistrements de service. Chaque enregistrement spécifie la priorité, le poids, le port et la cible d’un service sur votre domaine. Les enregistrements SRV sont souvent utilisés pour des services tels que la VoIP, la messagerie, et plus encore.
163+
```json
164+
{
165+
"record": {
166+
"SRV": [
167+
{
168+
"priority": 10,
169+
"weight": 5,
170+
"port": 8080,
171+
"target": "srv.exemple.com"
172+
},
173+
{
174+
"priority": 20,
175+
"weight": 10,
176+
"port": 9090,
177+
"target": "srv2.exemple.com"
178+
}
179+
]
180+
}
181+
}
182+
```
183+
- **Enregistrement CAA** : Il doit s’agir d’une liste d’enregistrements d’autorisation de certification (CAA). Chaque enregistrement spécifie l’autorité autorisée à émettre des certificats SSL pour votre domaine, avec des champs pour `flags`, `tag` et `value`.
184+
```json
185+
{
186+
"record": {
187+
"CAA": [
188+
{
189+
"flags": 0,
190+
"tag": "issue",
191+
"value": "letsencrypt.org"
192+
},
193+
{
194+
"flags": 0,
195+
"tag": "issuewild",
196+
"value": "comodoca.com"
197+
}
198+
]
199+
}
200+
}
201+
```
202+
- **Enregistrement DS** : Il doit s’agir d’une liste d’enregistrements de type Delegation Signer (DS). Chaque enregistrement vérifie l’authenticité de la zone (sous-domaine) avec les champs `key_tag`, `algorithm`, `digest_type` et `digest`.
203+
```json
204+
"DS": [{
205+
"key_tag": 2371,
206+
"algorithm": 13,
207+
"digest_type": 2,
208+
"digest": "C2074462471B81206F792AEC23469EF33DDC53538E8580DCCC92FD130C9A6096"
209+
}]
210+
```
211+
212+
### proxied (*optionnel*)
213+
Active la protection via le proxy Cloudflare pour votre domaine. Désactivé par défaut. Pour l’activer, ajoutez cette ligne de code :
214+
```json
215+
"proxied": true
216+
```

‎src/fr/useful/faq.md‎

Lines changed: 103 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,103 @@
1+
---
2+
icon: question
3+
label: FAQ
4+
route: /faq
5+
tags: useful
6+
---
7+
8+
# Foire Aux Questions (FAQ)
9+
10+
## Quels types d'enregistrements sont pris en charge ?
11+
12+
- A
13+
- AAAA
14+
- CAA
15+
- CNAME
16+
- DS
17+
- **Remarque :** Ces enregistrements ne peuvent être utilisés qu'en combinaison avec des enregistrements NS, qui sont utilisés pour DNSSEC.
18+
- MX
19+
- NS
20+
- **Remarque :** Ces enregistrements ne sont attribués que dans des cas spécifiques. Consultez [`Qui peut utiliser les enregistrements NS ?`](#qui-peut-utiliser-les-enregistrements-ns) pour plus d'informations.
21+
- SRV
22+
- TXT
23+
- URL
24+
- **Remarque :** Ces enregistrements utilisent Cloudflare pour la redirection, ce n'est pas un véritable type d'enregistrement DNS.
25+
26+
## Pourquoi mon domaine redirige-t-il toujours vers le site is-a.dev ?
27+
Cela est généralement dû à la mise en cache de votre navigateur. [Vider le cache de votre navigateur](https://support.google.com/accounts/answer/32050) devrait résoudre le problème.
28+
29+
## Puis-je utiliser un enregistrement CNAME avec d'autres enregistrements ?
30+
Vous ne pouvez pas demander un sous-domaine ni soumettre des modifications contenant un enregistrement CNAME avec d'autres enregistrements (A, AAAA, MX, TXT, etc...).
31+
32+
## Combien de temps faut-il pour que ma PR soit fusionnée ?
33+
Cela dépend. Nous essayons de traiter les PRs aussi rapidement que possible, mais les mainteneurs ne peuvent pas être en ligne en permanence. Nous avons des études et du travail, ce projet est seulement une activité secondaire. Soyez patient, nous y arriverons dès que possible !
34+
Pour augmenter vos chances d'obtenir une révision plus rapide, postez votre PR dans [#pull-requests](https://discord.com/channels/830872854677422150/1130858271620726784) sur notre [serveur Discord](https://discord.gg/is-a-dev-830872854677422150).
35+
36+
## Quels services prenez-vous en charge ?
37+
Nous prenons en charge presque tous les services, mais voici les principaux services utilisés avec is-a.dev :
38+
39+
- Cloudflare Pages
40+
- GitHub Pages
41+
- Netlify
42+
- Railway
43+
- Vercel
44+
45+
## Puis-je créer des sous-domaines imbriqués (sous-sous-domaines) ?
46+
Oui, c'est possible ! Il suffit de créer un fichier tel que `blog.example.json` et de suivre les mêmes instructions que pour `example.json`.
47+
Cependant, pour enregistrer `blog.example.is-a.dev`, vous devez déjà posséder `example.is-a.dev`.
48+
49+
## Comment puis-je modifier mon domaine ?
50+
Vous pouvez modifier le fichier JSON de votre domaine et soumettre une pull request pour effectuer la modification.
51+
52+
## Comment puis-je supprimer mon domaine ?
53+
Vous pouvez supprimer le fichier JSON de votre domaine et soumettre une pull request pour le supprimer.
54+
55+
## Je rencontre une erreur SSL avec GitHub Pages, comment la corriger ?
56+
Accédez aux paramètres GitHub Pages de votre dépôt de site web (probablement nommé `github-username.github.io`) et assurez-vous que l'option **"Enforce HTTPS"** est activée pour éviter cette erreur.
57+
58+
## Puis-je devenir mainteneur / rejoindre l'équipe ?
59+
Non, nous sélectionnons nous-mêmes les membres de notre équipe. Vous pouvez augmenter vos chances d'être choisi en aidant les autres sur nos forums d'assistance.
60+
61+
## J'ai accidentellement divulgué des informations sensibles dans ma PR, comment la supprimer ?
62+
Si votre PR **n'a pas encore été fusionnée**, vous pouvez envoyer un e-mail à [[email protected]](mailto:[email protected]) ou contacter [williamharrison sur Discord](https://discord.com/users/853158265466257448) en message privé.
63+
Si votre PR a **déjà été fusionnée**, nous ne pouvons malheureusement rien faire.
64+
65+
## Puis-je utiliser mon domaine pour un serveur Minecraft ?
66+
Oui, vous pouvez. Vous devez utiliser un enregistrement A combiné avec un enregistrement SRV.
67+
68+
Consultez [cet article](https://www.namecheap.com/support/knowledgebase/article.aspx/9765/2208/how-can-i-link-my-domain-name-to-a-minecraft-server) de Namecheap pour plus d'informations.
69+
70+
## Qui peut utiliser les enregistrements NS ?
71+
Nous autorisons les enregistrements NS uniquement dans les cas suivants :
72+
73+
- **Utilisation d'une zone privée** : Lorsque vous utilisez une adresse IP domestique via **un enregistrement A ou AAAA** derrière un service de proxy tel que Cloudflare. **Vous devez fournir une preuve d'utilisation pour que cette demande soit approuvée.**
74+
- **Services tiers nécessitant des enregistrements NS spécifiques** : Par exemple, Aternos, Wix ou Squarespace. Si vous ne pouvez pas gérer directement les enregistrements DNS sous ce domaine, vous devez fournir :
75+
- Une documentation ou une preuve provenant du service tiers indiquant clairement cette exigence.
76+
- Une preuve qu'aucune alternative (CNAME, A, AAAA, etc.) ne peut aboutir au même résultat.
77+
78+
Nous **n'autorisons pas** les enregistrements NS pour les raisons suivantes :
79+
80+
- **Par convenance** : Lorsque des alternatives comme A, AAAA ou CNAME sont suffisantes.
81+
- **Utilisation non opérationnelle** : Configurations esthétiques, tests ou usages non fonctionnels.
82+
- **Données invérifiables** : Toute configuration sans preuve claire et concrète de nécessité.
83+
- **Configurations trompeuses** : Tentatives d'usurpation d'identité, de fraude ou de manipulation d'utilisateurs.
84+
- **Risques de sécurité** : Toute configuration introduisant des vulnérabilités ou des risques pour la sécurité.
85+
86+
***Nous nous réservons le droit de refuser les enregistrements NS à notre seule discrétion, quelle que soit la raison invoquée.***
87+
88+
## Pourquoi êtes-vous si stricts avec les enregistrements NS ?
89+
Nous devons être stricts, car ces enregistrements permettent à l'utilisateur final de faire pratiquement *tout ce qu'il veut* avec son sous-domaine.
90+
91+
Comme vous pouvez l'imaginer, cela ouvre la porte à de nombreux abus, c'est pourquoi nous ne les attribuons pas librement.
92+
93+
Si nous le pouvions, nous autoriserions les enregistrements NS pour tout le monde, mais ce n'est pas possible dans le monde réel.
94+
95+
## Comment puis-je modifier mon sous-domaine is-a.dev ?
96+
1. **Ouvrez votre fichier JSON** : Rendez-vous dans le répertoire `domains` de votre fork et ouvrez le fichier JSON correspondant à votre sous-domaine (`domains/sous-domaine.json`).
97+
2. **Apportez vos modifications** : Modifiez ou supprimez le fichier JSON pour refléter les changements souhaités.
98+
3. **Validez vos modifications** : Une fois les modifications effectuées, validez-les dans votre fork.
99+
4. **Poussez vos modifications** : Envoyez vos modifications vers votre dépôt forké sur GitHub.
100+
5. **Soumettez une pull request** : Rendez-vous sur votre dépôt forké sur GitHub et ouvrez une pull request.
101+
6. **Attendez la fusion de votre PR** : Une fois votre pull request soumise, attendez qu'elle soit examinée et fusionnée. Une fois fusionnée, vos modifications seront appliquées !
102+
103+
**Remarque :** Surveillez votre PR en cas de demande de modifications.

‎src/fr/useful/index.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
icon: star
1+
icon: star

‎src/fr/useful/resources.md‎

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
---
2+
icon: browser
3+
route: /resources
4+
tags: useful
5+
---
6+
7+
# Ressources
8+
9+
Cette page propose une collection de ressources pour vous aider à comprendre les concepts clés liés à la gestion des domaines, tels que le DNS, les enregistrements, et bien plus encore.
10+
11+
## Demander de l'aide
12+
13+
- [Comment poser une bonne question ?](https://stackoverflow.com/help/how-to-ask) - Un guide de Stack Overflow sur la manière de poser une bonne question.
14+
- [Comment poser des questions de manière intelligente](http://catb.org/~esr/faqs/smart-questions.html) - Un guide détaillé d'Eric Steven Raymond et Rick Moen sur l'art de poser les bonnes questions.
15+
16+
## JSON
17+
18+
- [JSON pour les débutants](https://www.freecodecamp.org/news/what-is-json-a-json-file-example/) - Explication de JSON (JavaScript Object Notation) en termes simples par Tapas Adhikary.
19+
- [JSON Formatter](https://jsonformatter.org/) - Un outil de formatage et de validation JSON.
20+
- [JSON expliqué](https://www.youtube.com/watch?v=cj3h3Fb10QY) - Une vidéo explicative sur JSON par Hostinger Academy.
21+
22+
## Système de Noms de Domaine (DNS)
23+
24+
- [Qu'est-ce que le DNS ?](https://www.cloudflare.com/learning/dns/what-is-dns/) - Une introduction au DNS accessible aux débutants par Cloudflare.
25+
- [Comment fonctionne le DNS](https://howdns.works/) - Une explication ludique et illustrée du fonctionnement du DNS sous forme de bande dessinée.
26+
- [Le DNS expliqué](https://www.youtube.com/watch?v=72snZctFFtA) - Une vidéo explicative sur le DNS sur YouTube.
27+
28+
## Enregistrements DNS
29+
30+
- [Comprendre les types d'enregistrements DNS](https://www.cloudflare.com/learning/dns/dns-records/) - Un guide des différents types d'enregistrements DNS par Cloudflare.
31+
- [Types d'enregistrements DNS](https://wizardzines.com/comics/dns-record-types/) - Une explication illustrée des types d'enregistrements DNS courants.
32+
- [Les enregistrements DNS expliqués](https://www.youtube.com/watch?v=VMKbwYMoxX4) - Une vidéo explicative sur les enregistrements DNS.
33+
34+
## Git et GitHub
35+
36+
- [Le guide simple de Git](https://rogerdudler.github.io/git-guide/) - Un guide simple sur Git, sans complexité inutile.
37+
- [Penser comme un Git](https://think-like-a-git.net/) - Un guide pour mieux comprendre Git.
38+
39+
## Autres
40+
41+
- [Comment vider le cache du navigateur](https://www.hostinger.com/tutorials/clear-browser-cache) - Un guide simple pour vider le cache des navigateurs populaires.
42+
- [Comment fonctionne HTTPS](https://howhttps.works/) - Une explication illustrée du fonctionnement de HTTPS sous forme de bande dessinée.

0 commit comments

Comments
 (0)