diff --git a/src/fr/guides/index.yml b/src/fr/guides/index.yml new file mode 100644 index 0000000..3f09d27 --- /dev/null +++ b/src/fr/guides/index.yml @@ -0,0 +1 @@ +icon: book \ No newline at end of file diff --git a/src/fr/guides/netlify.md b/src/fr/guides/netlify.md new file mode 100644 index 0000000..f3473a7 --- /dev/null +++ b/src/fr/guides/netlify.md @@ -0,0 +1,45 @@ +--- +icon: /media/netlify.svg +label: Netlify +tags: guides +--- + + +# Configurer Netlify avec un sous-domaine is-a.dev + +Ce guide vous guidera pour créer un déploiement Netlify et y relier votre sous-domaine is-a.dev. + +## Créer un site Netlify + +Premièrement, vous devez créer un site sur Netlify. Suivez les instructions sur [Netlify Docs (En anglais)](https://docs.netlify.com/). + +### Créer le fichier du domaine + +Dans le dossier `domains`, créez un nouveau fichier JSON pour votre sous-domaine (`domains/sous-domaine.json`) et soumettez un pull request. Ce fichier doit contenir le JSON suivant : + +```json +{ + "description": "Décrivez l'utilité de ce sous-domaine", + "repo": "https://github.com/nom-d'utilisateur-github/référentiel-github", + "owner": { + "username": "nom-d'utilisateur-github", + "email": "votre-email@example.fr" + }, + "record": { + "A": ["75.2.60.5"] + } +} +``` + +**Note :** Dans la section *owner*, vous pouvez ajouter n'importe quel moyen de contact comme un nom d'utilisateur Discord. Si vous ajoutez un autre moyen de contact, vous pouvez omettre le champ email. Cependant, **le nom d'utilisateur GitHub est requis.** N'oubliez pas de fournir un aperçu de votre site dans votre pull request. + +## Configurer Netlify + +- Après que la pull request soit fusionnée, vous devez configurer votre site Netlify pour utiliser votre sous-domaine. Allez sur le tableau de bord de votre site Netlify. +- Naviguez vers **Site Settings > Domain Management > Custom Domains** et ajoutez `votre-domaine.is-a.dev` dans le champ donné. +- Netlify demandera une étape de vérification, nécessitant généralement d'ajouter un enregistrement DNS. Cette étape peut être ignorée si votre sous-domaine pointe déjà vers l'adresse IP de Netlify (`75.2.60.5`). + +### Dernières étapes + +- Attendez que le DNS se propage. Cela prend généralement quelques minutes (jusqu'à 24h). +- Votre site Netlify devrait être accessible à l'adresse `votre-domaine.is-a.dev`. diff --git a/src/fr/guides/railway.md b/src/fr/guides/railway.md new file mode 100644 index 0000000..36773ed --- /dev/null +++ b/src/fr/guides/railway.md @@ -0,0 +1,29 @@ +--- +icon: /media/railway.png +label: Railway +tags: guides +--- +**Ce guide est obsolète. Pour l'améliorer n'hésitez pas à ouvrir une [pull request](https://github.com/is-a-dev/docs)** +# Configurer Railway avec un sous-domaine is-a.dev + +## Obtenir l'enregistrement CNAME + +1. Rendez vous sur le [tableau de bord Railway](https://railway.app/dashboard) +1. Allez sur le *projet*. +1. Allez sur *Service*. +1. Chnagez vers l'onglet **Settings**. +1. Cliquez sur le bouton **+ Custom Domain**. +1. Entrez votre sous-domaine `votre-domaine.is-a.dev`. +1. Copiez le champ **Value**. + +*En cours d'édition* + +1. Go to the [register site](https://register.is-a.dev). +1. Choose **CNAME** record type from the dropdown menu. +1. Choose your desired subdomain. +1. Enter the value from clipboard in the **Record Value** field. +1. Click on the **Submit Query** button. +1. Wait for your pull request to be merged and the DNS records to update. + +**If the PR has been merged, the DNS records will be updated in a few minutes.** +**If the PR has been merged but the DNS records haven't updated and you have waited 48 hours, open a GitHub issue or a help thread in the is-a.dev discord server.** diff --git a/src/fr/guides/render.md b/src/fr/guides/render.md new file mode 100644 index 0000000..a800d65 --- /dev/null +++ b/src/fr/guides/render.md @@ -0,0 +1,46 @@ +--- +icon: /media/render.svg +label: Render +tags: guides +--- + +# Configurer Render avec un sous-domaine is-a.dev + +Ce guide vous guidera pour créer un déploiement Render et y relier votre sous-domaine is-a.dev. + + +## Créer un service Render + +Premièrement, vous devez créer un service sur Render. Suivez les instructions sur [Render Docs (en)](https://docs.render.com/). + +### Créer le fichier du domaine + +Dans le dossier domains, créez un nouveau fichier JSON pour votre sous-domaine (domains/sous-domaine.json) et soumettez un pull request. Ce fichier doit contenir le JSON suivant : + +```json +{ + "description": "Décrivez l'utilité de ce sous-domaine", + "repo": "https://github.com/nom-d'utilisateur-github/référentiel-github", + "owner": { + "username": "nom-d'utilisateur-github", + "email": "votre-email@example.fr" + }, + "record": { + "A": ["216.24.57.1"] + } +} +``` + +**Note :** Dans la section *owner*, vous pouvez ajouter n'importe quel moyen de contact comme un nom d'utilisateur Discord. Si vous ajoutez un autre moyen de contact, vous pouvez omettre le champ email. Cependant, **le nom d'utilisateur GitHub est requis.** N'oubliez pas de fournir un aperçu de votre site dans votre pull request. + + +## Configurer Render + +- Après que la pull request soit fusionnée, vous devez configurer votre service Render pour utiliser votre sous-domaine. Allez sur le tableau de bord de votre service Render. +- Naviguez vers **Settings > Custom Domains** et ajoutez `votre-domaine.is-a.dev` dans le champ donné. +- Render demandera une étape de vérification, nécessitant généralement d'ajouter un enregistrement DNS. Cette étape peut être ignorée si votre sous-domaine pointe déjà vers l'adresse IP de Render (`216.24.57.1`). + +### Dernières étapes + +- Attendez que le DNS se propage. Cela prend généralement quelques minutes (jusqu'à 24h). +- Votre service Render devrait être accessible à l'adresse `votre-domaine.is-a.dev`. diff --git a/src/fr/useful/index.yml b/src/fr/useful/index.yml new file mode 100644 index 0000000..a97dfd1 --- /dev/null +++ b/src/fr/useful/index.yml @@ -0,0 +1 @@ +icon: star