diff --git a/src/fr/guides/cloudflare-pages.md b/src/fr/guides/cloudflare-pages.md new file mode 100644 index 0000000..0ab6be2 --- /dev/null +++ b/src/fr/guides/cloudflare-pages.md @@ -0,0 +1,36 @@ +--- +label: Cloudflare Pages +icon: /media/cloudflare.svg +tags: guides +--- +# Configurer Cloudflare Pages avec un sous-domaine is-a.dev + +Ce guide vous guidera pour créer un site Cloudflare Pages et y relier votre sous-domaine is-a.dev. + +## Créer un site Cloudflare Pages + +Premièrement, vous devez créer un site sur Cloudflare Pages. Suivez les instructions du [Guide de démarrage de Cloudflare Pages (en)](https://developers.cloudflare.com/pages/get-started/guide/). + +### Rediriger votre sous-domaine vers votre site Cloudflare Pages + +Ensuite, vous devez rediriger votre sous-domaine is-a.dev vers votre site Cloudflare pages. Suivez les instructions du [Guide des domaines personnalisés de Cloudflare Pages (en)](https://developers.cloudflare.com/pages/configuration/custom-domains/#add-a-custom-subdomain). Suivez uniquement la section *"Add a custom subdomain"*, puis revenez à ce guide pour les étapes suivantes. + +### 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 +{ + "owner": { + "username": "nom-d'utilisateur-github", + "email": "votre-email@example.fr" + }, + "record": { + "CNAME": "votre-site.pages.dev" + } +} +``` + +### Votre site est en ligne ! + +Si vous arrivez jusqu'ici, votre site devrait être en ligne après que votre pull request ait été fusionné. diff --git a/src/fr/guides/discord-verification.md b/src/fr/guides/discord-verification.md new file mode 100644 index 0000000..e97f482 --- /dev/null +++ b/src/fr/guides/discord-verification.md @@ -0,0 +1,47 @@ +--- +label: Profile Discord +icon: /media/discord.svg +tags: guides +--- + +# Ajouter votre domaine is-a.dev à votre profil Discord +## Récupérez votre texte de vérification + +1. Ouvrez votre application Discord et sélectionnez `Paramètres`. + ![](../media/discord/etape_1.png) + +1. Ouvrez la section `Connections`. + ![](../media/discord/etape_2.png) + +1. Pressez le bouton `Voir plus`. + ![](../media/discord/etape_3.png) + +1. Cliquez sur le globe (bouton domaine) + ![](../media/discord/etape_4.png) + +1. Dans le champ qui apparait, insérez votre domaine is-a.dev (e.g. `example.is-a.dev`). + ![](../media/discord/etape_5.png) + +1. Récupérez votre texte de vérification + ![](../media/discord/etape_6.png) + +### Créer le fichier de domaine + +Créez dans le dossier `domains/` un fichier JSON appelé `domains/_discord.example.json` contenant le texte suivant : + +```json +{ + "owner": { + "username": "github-username", + "email": "email@address" + }, + "record": { + "TXT": "discord-verification-string" + } +} +``` + +## Configuration + +Après que votre Pull Request ait été fusionnée, refaite les étapes pour obtenir le texte de vérification et cliquez sur le bouton `Vérifier`. +Si l'erreur *"Impossible de vérifier votre domaine"* apparait, attendez quelques minutes (parfois jusqu'à 24 heures) la mise à jour du DNS. diff --git a/src/fr/guides/github-pages.md b/src/fr/guides/github-pages.md new file mode 100644 index 0000000..75cfb1e --- /dev/null +++ b/src/fr/guides/github-pages.md @@ -0,0 +1,82 @@ +--- +label: GitHub Pages +icon: mark-github +tags: guides +--- + +## Utiliser Github Pages avec un sous-domaine is-a.dev + +Ce guide vous guidera étape par étape pour créer un site sur Github Pages et y relier votre sous-domaine is-a.dev. + +### Créer un référentiel Github Pages + +Tout d'abord, vous devez créer un site sur Github Pages. Suivez les instructions du guide ["Bien démarrer avec GitHub Pages"](https://docs.github.com/fr/pages/getting-started-with-github-pages). + +### Créer le fichier du domaine + +Créez un fichier JSON dans le dossier `domains` (`domains/subdomain.json`) avec le contenu suivant et créez une pull request: + +```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": { + "CNAME": "nom-d'utilisateur-github.github.io" + } +} +``` + +### Configuration + +- Après que la pull request soit fusionnée, vous pouvez apercevoir une erreur **404** sur `sous-domaine.is-a.dev` ou le mauvais site. Pour réparer ceci, allez dans votre référentiel Github Pages **Settings > GitHub pages > Custom Domain** et ajoutez `sous-domaine.is-a.dev` dans l'emplacement donné. _Faites ceci uniquement **après** que votre pull request soit fusionnée._ +- Cochez la case **Enforce HTTPS** en dessous de l'entrée "Custom Domain". +- Attendez quelque temps et votre site sera en ligne ! + +## Vérifiez votre domaine is-a.dev avec Github Pages + +### Récupérez le texte de vérification + +1. Ouvrez GitHub, cliquez sur votre icône de profile en haut à droite, et cliquez sur `Settings`. + +![](../../media/github_pages_verification/step_1.png) + +2. Cliquez sur `Pages`. + +![](../../media/github_pages_verification/step_2.png) + +3. Cliquez sur `Add a domain`. + +![](../../media/github_pages_verification/step_3.png) + +4. Dans le champ qui apparaît, écrivez le nom de votre domaine is-a.dev (e.g. `myname.is-a.dev`) et cliquez sur `Add domain`. + +![](../../media/github_pages_verification/step_4.png) + +5. Copiez le nom d'hôte et le texte de vérification. + +![](../../media/github_pages_verification/step_5.png) + +### Créer le fichier du domaine + +Créer un fichier JSON dans le dossier `domains/` appellé `domains/nom-d'hôte.json` en utilisant le nom d'hôte que vous aurez copié dans l'étape 5 avec le contenu suivant et soumettez ensuite une pull request: + +```json +{ + "owner": { + "username": "nom-d'utilisateur-github", + "email": "votre-email@example.fr" + }, + "record": { + "TXT": "texte-de-vérification-github" + } +} +``` + +### Configuration + +Après que votre pull request aura été fusionnée, répétez les étapes pour obtenir le texte de vérification et pressez le bouton `Verify`. +Si une erreur similaire à `Unable to verify your domain` s'affiche, essayez d'attendre quelque minutes (des fois jusqu'à 24 heures) que le DNS se mette à jour. diff --git a/src/fr/index.md b/src/fr/index.md index 63ac4df..8df0897 100644 --- a/src/fr/index.md +++ b/src/fr/index.md @@ -1,13 +1,13 @@ ![](../media/banner.png) # Documentation du service is-a.dev -Ici, vous trouverez des guides, la structure des fichiers JSON à respecter et plus. Si vous voulez contribuer à la documentation, vous pouvez visiter [le référentiel Github (En anglais)](https://github.com/is-a-dev/docs). +Ici, vous trouverez des guides, la structure des fichiers JSON à respecter et d'autres informations. Si vous voulez contribuer à la documentation, vous pouvez visiter [le référentiel Github (En anglais)](https://github.com/is-a-dev/docs). ## Comment enregistrer un domaine -Vous pouvez trouver le guide sur la structure des fichiers JSON pour enregistrer un domaine [ici](useful/domain-structure). _En cours de traduction_ +Vous pouvez trouver le guide sur la structure des fichiers JSON pour enregistrer un domaine [ici](useful/domain-structure). *En cours de traduction* ## Guides -_En cours de traduction_ +*En cours de traduction* - [Cloudflare Pages](guides/cloudflare-pages) - [DanBot Hosting](guides/dbh) - [Vérification de domaine Discord](guides/discord-verification) @@ -22,15 +22,16 @@ _En cours de traduction_ - [Vercel](guides/vercel) ## Utile -_En cours de traduction_ - - [Structure des fichiers JSON pour enregistrer un domaine](useful/domain-structure) - - [FAQ](useful/faq) - - [Ressources](useful/resources) + +*En cours de traduction* + - [Enregistrement d'un domaine](useful/domain-structure) + - [FAQ](utile/faq) + - [Ressources](utile/ressources) ## Sous-domaines officiels Voici les domaines utilisés par l'administration de is-a.dev -- is-a.dev (Le domaine principal, utilisé pour le site web, la documentation et les E-Mails) +- is-a.dev (Le domaine principal, utilisé pour le site web, la documentation et les e-mails) - data.is-a.dev (Site web de données, hébergé par [@wdhdev](https://github.com/wdhdev)) - docs.is-a.dev (Ce site web) - owl.is-a.dev (Service de confidentialité des utilisateurs [Beta], hébergé par [@andrewstech](https://github.com/andrewstech) et [@wdhdev](https://github.com/wdhdev)) @@ -39,6 +40,6 @@ Voici les domaines utilisés par l'administration de is-a.dev - team.is-a.dev (Documentation pour l'administration) - www.is-a.dev (Redirige au domaine principal) -**Ne faites confiance à AUCUN site web qui prétend être affilié à is-a.dev n'étant pas listé ici. Si vous en trouvez un, nous vous prions de le signaler à [security@is-a.dev](mailto:security@is-a.dev).** +**Ne faites confiance à AUCUN site web prétendant être affilié à is-a.dev n'étant pas listé ici. Si vous en trouvez un, merci de le signaler à [security@is-a.dev](mailto:security@is-a.dev).** -*Nous n'envoyons pas d'E-Mails non sollicités aux utilisateurs, ne faites confiance à aucun E-Mail envoyé qui affirme être affilié à l'équipe. Signalez tous les E-Mails non sollicités à [security@is-a.dev](mailto:security@is-a.dev).* +*Nous n'envoyons pas d'e-mails non sollicités aux utilisateurs, ne faites confiance à aucun e-mail reçu affirmant être affilié à l'équipe. Signalez tous les e-mails non sollicités à [security@is-a.dev](mailto:security@is-a.dev).* diff --git a/src/fr/media/discord/etape_1.png b/src/fr/media/discord/etape_1.png new file mode 100644 index 0000000..71116d5 Binary files /dev/null and b/src/fr/media/discord/etape_1.png differ diff --git a/src/fr/media/discord/etape_2.png b/src/fr/media/discord/etape_2.png new file mode 100644 index 0000000..9607d96 Binary files /dev/null and b/src/fr/media/discord/etape_2.png differ diff --git a/src/fr/media/discord/etape_3.png b/src/fr/media/discord/etape_3.png new file mode 100644 index 0000000..57c7460 Binary files /dev/null and b/src/fr/media/discord/etape_3.png differ diff --git a/src/fr/media/discord/etape_4.png b/src/fr/media/discord/etape_4.png new file mode 100644 index 0000000..76b5981 Binary files /dev/null and b/src/fr/media/discord/etape_4.png differ diff --git a/src/fr/media/discord/etape_5.png b/src/fr/media/discord/etape_5.png new file mode 100644 index 0000000..32e275b Binary files /dev/null and b/src/fr/media/discord/etape_5.png differ diff --git a/src/fr/media/discord/etape_6.png b/src/fr/media/discord/etape_6.png new file mode 100644 index 0000000..fb7bcb7 Binary files /dev/null and b/src/fr/media/discord/etape_6.png differ