Skip to content

Commit

Permalink
i18n(fr): Update guides/integrations-guides/sitemap.mdx (#9008)
Browse files Browse the repository at this point in the history 
* i18n(fr): Update `guides/integrations-guides/sitemap.mdx`

Signed-off-by: Thomas Bonnet <thomasbnt@protonmail.com>

* Update src/content/docs/fr/guides/integrations-guide/sitemap.mdx

Co-authored-by: Armand Philippot <59021693+ArmandPhilippot@users.noreply.github.com>

* Update src/content/docs/fr/guides/integrations-guide/sitemap.mdx

Co-authored-by: Armand Philippot <59021693+ArmandPhilippot@users.noreply.github.com>

* Update src/content/docs/fr/guides/integrations-guide/sitemap.mdx

Co-authored-by: Armand Philippot <59021693+ArmandPhilippot@users.noreply.github.com>

* i18n(fr): fix link developers google about sitemaps

Signed-off-by: Thomas Bonnet <thomasbnt@protonmail.com>

---------

Signed-off-by: Thomas Bonnet <thomasbnt@protonmail.com>
Co-authored-by: Armand Philippot <59021693+ArmandPhilippot@users.noreply.github.com>
Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
Co-authored-by: Yan Thomas <yanthomas.b@gmail.com>
  • Loading branch information
@thomasbnt @ArmandPhilippot @yanthomasdev
4 people authored Aug 5, 2024
1 parent 3448cca commit 0775ced
Showing 1 changed file with 54 additions and 45 deletions.
99 changes: 54 additions & 45 deletions src/content/docs/fr/guides/integrations-guide/sitemap.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Cette **[intégration Astro][astro-integration]** génère un sitemap basé sur

## Pourquoi Astro Sitemap ?

Un plan du site est un fichier XML qui décrit toutes les pages, vidéos et fichiers de votre site. Les moteurs de recherche comme Google lisent ce fichier pour explorer votre site plus efficacement. [Pour en savoir plus, consultez les conseils de Google sur les sitemaps (https://developers.google.com/search/docs/advanced/sitemaps/overview).
Un plan du site est un fichier XML qui décrit toutes les pages, vidéos et fichiers de votre site. Les moteurs de recherche comme Google lisent ce fichier pour explorer votre site plus efficacement. [Pour en savoir plus, consultez les conseils de Google sur les sitemaps](https://developers.google.com/search/docs/advanced/sitemaps/overview).

Il est recommandé d'utiliser un fichier sitemap pour les grands sites multipages. Si vous n'utilisez pas de sitemap, la plupart des moteurs de recherche seront toujours en mesure de lister les pages de votre site, mais un sitemap est un excellent moyen de s'assurer que votre site est aussi convivial que possible pour les moteurs de recherche.

Expand Down Expand Up @@ -82,35 +82,70 @@ export default defineConfig({

## Utilisation

`@astrojs/sitemap` nécessite une URL de déploiement / site pour la génération. Ajoutez l'URL de votre site dans votre `astro.config.*` en utilisant la propriété `site`. Celle-ci doit commencer par `http:` ou `https:`.
`@astrojs/sitemap` a besoin de connaître l'URL déployée de votre site pour générer un sitemap.

```js title="astro.config.mjs" "'https://stargazers.club'"
Ajoutez l'URL de votre site comme option [`site`](/fr/reference/configuration-reference/#site) dans `astro.config.mjs`. Elle doit commencer par `http://` ou `https://`.

```js title="astro.config.mjs" {5}
import { defineConfig } from 'astro/config';
import sitemap from '@astrojs/sitemap';

export default defineConfig({
// ...
site: 'https://stargazers.club',
integrations: [sitemap()],
// ...
});
```

Notez que contrairement aux autres options de configuration, `site` est défini dans l'objet racine `defineConfig`, plutôt que dans l'appel à `sitemap()`.
Avec l'intégration du sitemap configurée, les fichiers `sitemap-index.xml` et `sitemap-0.xml` seront ajoutés à votre répertoire de sortie lors de la construction de votre site.

Maintenant, [construisez votre site pour la production](/fr/reference/cli-reference/#astro-build) via la commande `astro build`. Vous trouverez `sitemap-index.xml` et `sitemap-0.xml` dans le dossier `dist/` (ou dans votre [répertoire de sortie](/fr/reference/configuration-reference/#outdir) si vous l'avez défini).
`sitemap-index.xml` renvoie à tous les fichiers sitemap numérotés.
`sitemap-0.xml` liste les pages de votre site.
Pour les sites de très grande taille, il peut y avoir des fichiers numérotés supplémentaires comme `sitemap-1.xml` et `sitemap-2.xml`.

:::caution
Si vous oubliez d'ajouter un `site`, vous recevrez un avertissement amical lors de la construction, et le fichier `sitemap-index.xml` ne sera pas généré.
:::
<details>
<summary>Exemple de fichiers générés pour un site web de deux pages</summary>

```xml title="sitemap-index.xml"
<?xml version="1.0" encoding="UTF-8"?>
<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<sitemap>
<loc>https://stargazers.club/sitemap-0.xml</loc>
</sitemap>
</sitemapindex>
```

```xml title="sitemap-0.xml"
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:news="http://www.google.com/schemas/sitemap-news/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml" xmlns:image="http://www.google.com/schemas/sitemap-image/1.1" xmlns:video="http://www.google.com/schemas/sitemap-video/1.1">
<url>
<loc>https://stargazers.club/</loc>
</url>
<url>
<loc>https://stargazers.club/second-page/</loc>
</url>
</urlset>
```
</details>

### Découverte du plan du site

Vous pouvez faciliter la recherche de votre sitemap par les robots d'indexation en insérant des liens dans `<head>` et dans le fichier `robots.txt` de votre site.

Après avoir vérifié que les sitemaps sont construits, vous pouvez les ajouter au fichier `<head>` de votre site et au fichier `robots.txt` pour que les robots d'indexation les récupèrent.
#### Lien vers le plan du site dans l'élément `<head>`

Ajoutez un élément `<link rel="sitemap">` dans le `<head>` de votre site qui pointe vers le fichier index du sitemap :

```html title="src/layouts/Layout.astro" ins={2}
<head>
<link rel="sitemap" href="/sitemap-index.xml" />
</head>
```

#### Lien vers le plan du site dans le fichier `robots.txt`

Si vous avez un fichier `robots.txt` pour votre site web, vous pouvez ajouter l'URL de l'index du sitemap pour aider les robots d'indexation :

```txt ins={5}
# public/robots.txt
User-agent: *
Expand All @@ -119,54 +154,28 @@ Allow: /
Sitemap: https://<VOTRE SITE>/sitemap-index.xml
```

Pour générer `robots.txt` dynamiquement, ajoutez un fichier nommé `robots.txt.ts` avec le code suivant :
Si vous voulez réutiliser la valeur `site` de `astro.config.mjs`, vous pouvez aussi générer `robots.txt` dynamiquement.
Au lieu d'utiliser un fichier statique dans le répertoire `public/`, créez un fichier `src/pages/robots.txt.ts` et ajoutez le code suivant :

```ts title="src/pages/robots.txt.ts"
import type { APIRoute } from 'astro';

const robotsTxt = `
const getRobotsTxt = (sitemapURL: URL) => `
User-agent: *
Allow: /
Sitemap: ${new URL('sitemap-index.xml', import.meta.env.SITE).href}
`.trim();
Sitemap: ${sitemapURL.href}
`;

export const GET: APIRoute = () => {
return new Response(robotsTxt, {
headers: {
'Content-Type': 'text/plain; charset=utf-8',
},
});
export const GET: APIRoute = ({ site }) => {
const sitemapURL = new URL('sitemap-index.xml', site);
return new Response(getRobotsTxt(sitemapURL));
};

```

### Exemple de fichiers générés pour un site web de deux pages

```xml title="sitemap-index.xml"
<?xml version="1.0" encoding="UTF-8"?>
<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<sitemap>
<loc>https://stargazers.club/sitemap-0.xml</loc>
</sitemap>
</sitemapindex>
```

```xml title="sitemap-0.xml"
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:news="http://www.google.com/schemas/sitemap-news/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml" xmlns:image="http://www.google.com/schemas/sitemap-image/1.1" xmlns:video="http://www.google.com/schemas/sitemap-video/1.1">
<url>
<loc>https://stargazers.club/</loc>
</url>
<url>
<loc>https://stargazers.club/second-page/</loc>
</url>
</urlset>
```

## Configuration

Pour configurer cette intégration, passez un objet à l'appel de la fonction `sitemap()` dans `astro.config.mjs`.
Pour configurer cette intégration, passez un objet à la fonction `sitemap()` dans `astro.config.mjs`.

```js title="astro.config.mjs" {6-8}
import { defineConfig } from 'astro/config';
Expand Down

0 comments on commit 0775ced

Please sign in to comment.