vite-ssg-sitemap

Sitemap generator working with vite-ssg using sitemap-ts

Getting Started

Vue

Install:

npm install -D vite-ssg
npm install -D vite-ssg-sitemap

Vite config

Add to your vite.config.js:

import generateSitemap from 'vite-ssg-sitemap'

export default {
  plugins: [
    Vue(),
  ],
  ssgOptions: {
    onFinished() { generateSitemap() },
  },
}

Now, run npm build and this will generate sitemap.xml and robots.txt files on your dist folder.

hostname

• undefinedType: string
• undefinedDefault: 'http://localhost/'

Base URI.

dynamicRoutes

• undefinedType: string[]
• undefinedDefault: []

Array of strings with manual dynamic routes.

export default {
  plugins: [
    Vue(),
  ],
  ssgOptions: {
    onFinished() {
      const users = await api.get('/users')
      const dynamicRoutes = users.map(user => `/users/${user.name}`)
      generateSitemap({ dynamicRoutes })
    },
  },
}

exclude

• undefinedType: string[]
• undefinedDefault: []

Array of strings with excluded routes.

export default {
  plugins: [
    Vue(),
  ],
  ssgOptions: {
    onFinished() {
      generateSitemap({
        exclude: ['/admin', '/private']
      })
    },
  },
}

You can find a working example in example folder.

externalSitemaps

• undefinedType: string[]
• undefinedDefault: []

Array of strings with other sitemaps paths or urls.

generateSitemap({
  externalSitemaps: ['sitemap_1', 'sitemap_2', 'subpath/sitemap_3', 'https://site.com/sitemap.xml']
})

outDir

• undefinedType: string
• undefinedDefault: 'dist'

Output directory.

extensions

• undefinedType: string | string[]
• undefinedDefault: 'html'

File extensions that need to be generated.
Example: [‘html’, ‘md’]

changefreq

• undefinedType: string | RoutesOptionMap<string>
• undefinedDefault: 'daily'

Change frequency option for sitemap.

priority

• undefinedType: number | RoutesOptionMap<number>
• undefinedDefault: 1

Priority option for sitemap.

lastmod

• undefinedType: Date | RoutesOptionMap<Date>
• undefinedDefault: new Date()

Last modification option for sitemap.

RoutesOptionMap<Type>

• undefinedType: { [route: string]: Type }

Used for changing changefreq, priority, or lastmod on a by-route level.
The (optional) route '*' is used as default.

readable

• undefinedType: boolean
• undefinedDefault: false

Converts XML into a human readable format

i18n

• undefinedType: { defaultLanguage?: string, languages: string[], strategy?: 'suffix' | 'prefix' }
• undefinedDefault: undefined, strategy: 'suffix'

Add i18n support defining alternate links.
defaultLanguage will use this language with / and languages with /language.
strategy specifies if the language code is a suffix to the path or a prefix. ‘suffix’ is default. Example: http://localhost/mypage/en or http://localhost/en/mypage

generateRobotsTxt

• undefinedType: boolean
• undefinedDefault: true

Enables robots.txt file generation

robots

• undefinedType: RobotOption[]
• undefinedDefault: [{ userAgent: '*', allow: '/' }]

RobotOption:

• undefineduserAgent: string
• undefinedallow?: string | string[]
• undefineddisallow?: string | string[]
• undefinedcrawlDelay?: number
• undefinedcleanParam?: string

License

MIT License © 2022 jbaubree