Merge pull request #62 from SkyExploreWasTaken/main

Finishing the Guides section.

src/fr/guides/codeberg-pages.md

@@ -0,0 +1,37 @@
+---
+label: Codeberg Pages
+icon: /media/codeberg.svg
+tags: guides
+---
+
+# Mise en place de Codeberg Pages avec le sous-domaine is-a.dev
+
+Ce guide vous guidera tout au long du processus de mise en place d'un site Codeberg Pages pour ensuite pointer votre sous-domaine is-a.dev vers ce dernier.
+
+## Création d'un site Codeberg Pages
+
+En premier lieu, vous devrez créer un site sur Codeberg Pages. Suivez les instructions du [Guide Codeberg Pages](https://docs.codeberg.org/codeberg-pages/).
+
+### Création du fichier du domaine
+
+Créez un fichier JSON dans le dossier `domains` (domains/subdomain.json) avec le contenu suivant et soumettez une pull request :
+
+```json
+{
+    "owner": {
+        "username": "votre-nom-d-utilisateur-codeberg",
+        "email": "votre-email"
+    },
+    "record": {
+        "CNAME": "pages.votre-nom-d-utilisateur.codeberg.page"
+    }
+}
+```
+
+### Ajout du fichier `.domains`
+
+Quand votre PR est fusionnée, créez un fichier `.domains` pour pointer votre site vers votre nouveau sous-domaine is-a.dev et ajoutez votre sous-domaine (`votre-sous-domaine.is-a.dev`) à celui-ci.
+
+### Terminé!
+
+Si vous avez suivi correctement la documentation tout devrait être correct et bien fonctionner :)

src/fr/guides/hashnode.md

@@ -0,0 +1,45 @@
+---
+icon: /media/hashnode.svg
+label: Hashnode
+tags: guides
+---
+
+# Blog Hashnode
+
+Quand vous créez votre blog Hashnode, Hashnode vous fournit un sous-domaine gratuit `hashnode.dev` pour vous. Cependant, vous pouvez configurer votre propre sous-domaine `is-a.dev`.
+
+Dans cette guide, vous apprendrez à accomplir cela.
+
+---
+
+1. Connectez vous à votre compte Hashnode.
+
+2. Cliquez sur votre **avatar** en bas à gauche de la page sur **ordinateur** ou en haut à droite sur **mobile**.
+   ![Hashnode's Feed](https://cdn.hashnode.com/res/hashnode/image/upload/v1614932849541/cBNDGKXMj.png?auto=compress)
+
+3. Cliquez sur l'option **Blog Dashboard** dans le popup modal pour accéder à votre tableau de bord de blog.
+   ![Hashnode's Feed](https://cdn.hashnode.com/res/hashnode/image/upload/v1614937218081/InvxVHXDy.png?auto=compress)
+
+4. Naviguez ensuite vers l'onglet **Domains** et entrez votre domaine sans le préfixe **www** ou **https://** dans le champ de texte fourni. Ensuite, cliquez sur le bouton **Update** pour continuer.
+   ![Hashnode's Blog Domain Tab](https://cdn.hashnode.com/res/hashnode/image/upload/v1614937377176/0cwddAywO.png?auto=compress)
+
+5. Allez dans votre fork du dépôt `is-a-dev/register`, éditez le fichier JSON de votre sous-domaine, assurez-vous de supprimer tous les anciens enregistrements, puis ajoutez ce qui suit à la clé `record` et créez une PR:
+
+```json
+"CNAME": "hashnode.network"
+```
+
+## Configuration
+
+Quand ce sera fini, votre blog Hashnode devrait être configuré pour utiliser votre sous-domaine. Ces changements peuvent prendre de 1 heure à environ 48 heures, donc veuillez patienter. Il sera probablement prêt dans moins d'une heure.
+
+Quand les DNS auront été propagés, vous pourrez commencer à profiter de votre blog Hashnode avec votre sous-domaine `.is-a.dev`!
+
+## Encore besoin d'aide ?
+
+Si vous rencontrez des problèmes ou avez besoin d'aide supplémentaire, considérez les ressources suivantes :
+
+- [Hashnode Domain Mapping Guide](https://support.hashnode.com/docs/mapping-domain/): Cet articles de support fournit des instructions détaillées sur comment lier votre domaine à Hashnode.
+- [Hashnode Support Center](https://support.hashnode.com/): Pour une aide plus générale liée à Hashnode, visiter leur Centre D'Assistance.
+
+Veuillez noter que is-a.dev n'est pas affilié avec Hashnode. Si vous rencontrez des problèmes avec votre blog Hashnode, veuillez demander de l'aide auprès de leurs canaux de support. Nous ne pouvons pas vous aider avec des problèmes spécifiques à Hashnode.

src/fr/guides/improvmx.md

@@ -0,0 +1,38 @@
+---
+label: ImprovMX
+icon: /media/improvmx.svg
+tags: guides
+---
+
+# Mise en place d'ImprovMX avec un sous-domaine is-a.dev
+
+Ce guide vous guidera tout au long du processus d'installation d'ImprovMX avec votre sous-domaine is-a.dev.
+
+## Ce dont vous aurez besoin avant de continuer.
+
+1. Avoir un compte ImprovMX. Si vous n'en avez pas, veuillez aller sur [leur site](https://improvmx.com) et en créer un.
+2. Vous devriez avoir déjà fait un fork du [référentiel is-a.dev](https://github.com/is-a-dev/register). Si vous ne l'avez pas fait, faites un fork en utilisant [ce lien](https://github.com/is-a-dev/register/fork).
+
+## Création du fichier
+
+En premier lieu, allez dans le fork que vous avez fait, puis allez dans le dossier `domains` et créez un fichier. Le fichier devrait être nommé comme ceci: `sous-domaine`. (Remplacez `sous-domaine` par le nom de sous-domaine que vous voulez.)
+
+Après avoir créé le fichier vous devez le remplir comme suit:
+```json
+{
+    "owner": {
+        "username": "nom-d-utilisateur-github",
+        "email": "[email protected]"
+    },
+    "record": {
+        "MX": ["mx1.improvmx.com", "mx2.improvmx.com"],
+        "TXT": ["v=spf1 include:spf.improvmx.com ~all"]
+    }
+}
+```
+
+**Après avoir fait le fichier, vous devez faire une pull request sur le [référentiel is-a.dev](https://github.com/is-a-dev/register).**s
+
+## Configuration
+
+Après avoir été fusionné, il devrait commencer à fonctionner automatiquement. Si vous n'avez pas configuré le domaine auparavant, veuillez aller sur le [tableau de bord ImprovMX](https://app.improvmx.com/) et ajouter le domaine.

src/fr/guides/other.md

@@ -0,0 +1,17 @@
+---
+label: Other services
+icon: server
+tags: guides
+---
+
+# Mise en place d'autre services avec is-a.dev
+
+## Mise en place des enregistrements DNS
+
+Lisez la [structure des fichiers de domaine](../useful/domain-structure) et configurez les enregistrements DNS en conséquence.
+
+## Configuration du serveur
+
+Après que la pull request sera fusionnée, configurez votre serveur (apache, nginx, etc.) pour fonctionner avec `sous-domaine.is-a.dev`. Si vous ne savez pas comment configurer votre serveur, vous pouvez créer une issue pour un support sur le référentiel Github, ou vous pouvez aller sur le [serveur Discord](https://discord.gg/is-a-dev-830872854677422150).
+
+Vous devriez aussi inclure `sous-domaine.is-a.dev` dans votre certificat SSL pour éviter les erreurs de certificat.

src/fr/guides/replit.md

@@ -0,0 +1,39 @@
+---
+icon: /media/replit.svg
+label: Replit
+tags: guides
+---
+
+# Mise en place de Replit avec votre sous-domaine is-a.dev
+
+## Création du projet
+
+Suivez les instructions du [guide Replit Workspace](https://docs.replit.com/programming-ide/introduction-to-the-workspace#how-to-create-a-repl) sur "Comment créer un projet".
+
+### Connexion de votre repl à votre sous-domaine is-a.dev
+
+Suivez les instructions du [guide Replit Custom Domains](https://docs.replit.com/hosting/custom-domains#connecting-your-domain-to-your-repl).
+
+Suivez uniquement la section "Connexion de votre domaine à votre repl" puis retournez sur ce guide pour les étapes suivantes.
+
+### Création du fichier du domaine
+
+Créez un fichier JSON dans le répertoire `domains` (`domains/sous-domaine.json`) avec le contenu suivant:
+
+**Note:** N'ajoutez pas d'enregistrements TXT, même si Replit vous demande de le faire.
+
+```json
+{
+    "owner": {
+        "username": "nom-d-utilisateur-github",
+        "email": "[email protected]"
+    },
+    "record": {
+        "CNAME": "id-de-site.id.repl.co"
+    }
+}
+```
+
+## Finish
+
+Once your pull request has been merged you should be able to visit your new is-a.dev subdomain connected to your Replit site!

src/fr/guides/vercel.md

@@ -0,0 +1,81 @@
+---
+icon: /media/vercel.svg
+label: Vercel
+tags: guides
+---
+
+# Mise en place avec un sous-domaine is-a.dev
+
+Ce guide vous guidera tout au long du processus de mise en place d'un site Vercel pour pointer votre sous-domaine is-a.dev vers ce dernier.
+
+## Vérifiez que vous avez un site Vercel
+
+If you haven't made a Vercel site, make sure to make one. Follow the instructions in [Vercel's Docs](https://vercel.com/docs/getting-started-with-vercel).
+Si vous n'avez pas fait de site Vercel, assurez-vous de le faire. Suivez les instructions dans la [documentation Vercel](https://vercel.com/docs/getting-started-with-vercel).
+
+### Création du fichier de domaine
+
+En premier lieu, allez dans votre tableau de bord Vercel, puis allez dans votre projet, puis allez dans Custom Domains et mettez-y le sous-domaine is-a.dev que vous voulez.
+
+**Vous aurez besoin de faire deux fichiers pour que ce processus se déroule correctement**. Nous allons passer dans l'ordre pour cette section.
+
+1. Créez un fichier pour la vérification TXT Vercel
+   Quand vous connectez le domaine, vous serez accueilli avec une chaîne de vérification TXT. Pour faire le fichier pour ce dernier, le TXT record doit être placé dans `_vercel.sous-domaine.json` dans le **répertoire des domaines** (remplacez sous-domaine par le domaine que vous voulez) et le fichier devrait être comme ceci:
+!!!
+Vous pouvez également remplacer l'e-mail par n'importe quelle forme de réseau social (comme Discord, Twitter, Bluesky, Mastodon etc.).
+!!!
+
+```json
+{
+    "owner": {
+        "username": "nom-d-utilisateur-github",
+        "email": "[email protected]"
+    },
+    "record": {
+        "TXT": "insérer-la-chaine-de-vérification-ici"
+    }
+}
+```
+
+!!!
+**_NE PAS FAIRE DE PULL REQUEST MAITENANT_**, nous avons encore un autre fichier à faire. Si vous aviez fait une pull request à ce stade, nous rejetterions votre domaine car vous essayez de faire un sous-domaine imbriqué sur un sous-domaine que vous ne possédez pas encore. Veuillez passer à l'étape suivante.
+!!!
+
+1. Créez un fichier pour le domaine principal
+   Maintenant, vous devez faire un fichier pour le domaine principal, nous avons deux façons de le faire : des enregistrements CNAME et A. Nous allons avoir deux différents fichiers pour ceux-là et expliquer ce que vous devez faire.
+
+Créez `sous-domaine.json` dans le **répertoire des domaines** (remplacez sous-domaine par le domaine que vous avez choisi) et mettez-y l'un de ces types :
+
+**Enregistrement CNAME**: Si vous utilisez un enregistrement CNAME, vous n'avez pas besoin de fournir une prévisualisation, car vous utilisez le site comme le CNAME, mais vous ne pouvez pas utiliser d'autre enregistrement (comme des enregistrements MX et TXT). **Cette option est idéale pour ceux qui ne veulent que leur domaine pour leur site**.
+
+```json
+{
+    "owner": {
+        "username": "nom-d-utilisateur-github",
+        "email": "[email protected]"
+    },
+    "record": {
+        "CNAME": "nom-de-domaine.vercel.app"
+    }
+}
+```
+
+**Enregistrement A**: Si vous utilisez un enregistrement A, vous devrez fournir une prévisualisation soit en plaçant un lien dans la section de commentaire de la PR, en le plaçant dans la description, soit en fournissant une capture d'écran de votre site web. **Cette option est idéale pour ceux qui veulent utiliser leur domaine pour leur site et leur email**.
+
+```json
+{
+    "owner": {
+        "username": "nom-d-utilisateur-github",
+        "email": "[email protected]"
+    },
+    "record": {
+        "A": ["76.76.21.21"]
+    }
+}
+```
+
+### Création de votre pull request
+
+Quand vous aurez fait ces deux fichiers, vous pourrez faire une pull request dans le [dépôt principal](https://github.com/is-a-dev/register), puis vous devrez patienter jusqu'à qu'elle soit fusionnée. Si vous voulez une change que votre PR soit fusionnée plus rapidement, rejoignez notre [serveur Discord](https://discord.gg/is-a-dev-830872854677422150).
+
+Quand votre PR aura été fusionnée, votre site devrait fonctionner. Si ce n'est pas le cas, effacez votre cache.