📦 plugin-sitemap

검색 엔진 크롤러가 여러분의 사이트를 정확하게 수집할 수 있도록 사이트맵을 만들어주는 플러그인입니다.

production only

해당 플러그인은 빌드 산출물에서만 작동하기 때문에 개발 중에는 비활성화되고 제품 빌드 시에만 활성화됩니다.

설치

npm

npm install --save @docusaurus/plugin-sitemap

Yarn

yarn add @docusaurus/plugin-sitemap

pnpm

pnpm add @docusaurus/plugin-sitemap

팁

@docusaurus/preset-classic을 설치한 경우에는 플러그인을 따로 설치할 필요는 없습니다.

프리셋 옵션에서 플러그인을 설정할 수 있습니다.

설정

설정할 수 있는 필드

옵션명	타입	기본값	설명
changefreq	string	'weekly'	사이트맵 문서를 참조하세요.
priority	number	0.5	사이트맵 문서를 참조하세요.
ignorePatterns	string[]	[]	glob 패턴 목록입니다. 일치하는 라우트 경로는 사이트맵에서 필터링됩니다. 여기에 base URL을 포함해야 할 수도 있습니다.
filename	string	sitemap.xml	출력 디렉토리를 기준으로 생성된 사이트맵 파일 경로입니다. 두 개의 파일을 출력하는 두 개의 플러그인 인스턴스가 있는 경우 유용합니다.

정보

이 플러그인은 일부 사이트 설정을 유지합니다.

• noIndex: 사이트맵을 생성하지 않습니다.
• trailingSlash: 사이트맵 URL에 트레일링 슬래시가 있는지 확인합니다.

설정 예시

프리셋 옵션이나 플러그인 옵션에서 플러그인을 설정할 수 있습니다.

팁

대부분의 도큐사우루스 사용자는 프리셋 옵션을 사용해 플러그인을 설정합니다.

Preset options

If you use a preset, configure this plugin through the preset options:

docusaurus.config.js

module.exports = {
  presets: [
    [
      '@docusaurus/preset-classic',
      {
        sitemap: {
          changefreq: 'weekly',
          priority: 0.5,
          ignorePatterns: ['/tags/**'],
          filename: 'sitemap.xml',
        },
      },
    ],
  ],
};

Plugin options

If you are using a standalone plugin, provide options directly to the plugin:

docusaurus.config.js

module.exports = {
  plugins: [
    [
      '@docusaurus/plugin-sitemap',
      {
        changefreq: 'weekly',
        priority: 0.5,
        ignorePatterns: ['/tags/**'],
        filename: 'sitemap.xml',
      },
    ],
  ],
};

/sitemap.xml에서 사이트맵을 확인할 수 있습니다.