vite-ssg-sitemap


> Sitemap generator working with vite-ssg using sitemap-ts

Getting Started

$3

Install:

``bash
npm install -D vite-ssg
npm install -D vite-ssg-sitemap
`

$3

Add to your vite.config.js:

`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.

$3

- Type: string
- Default: 'http://localhost/'

Base URI.

$3

- Type: string[]
- Default: []

Array of strings with manual dynamic routes.

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

$3

- Type: string[]
- Default: []

Array of strings with excluded routes.

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

You can find a working example in example folder.

$3

- Type: string[]
- Default: []

Array of strings with other sitemaps paths or urls.

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

$3

- Type: string
- Default: 'dist'

Output directory.

$3

- Type: string | string[]
- Default: 'html'

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

$3

- Type: string | RoutesOptionMap
- Default: 'daily'

Change frequency option for sitemap.

$3

- Type: number | RoutesOptionMap
- Default: 1

Priority option for sitemap.

$3

- Type: Date | RoutesOptionMap
- Default: new Date()

Last modification option for sitemap.

$3

- Type: { [route: string]: Type }

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

$3

- Type: boolean
- Default: false

Converts XML into a human readable format

$3

- Type: { defaultLanguage?: string, languages: string[], strategy?: 'suffix' | 'prefix' }
- Default: 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

$3

- Type: boolean
- Default: true

Enables robots.txt file generation

$3

- Type: NSArgs
- Default: undefined

Trim the xml namespace
See https://www.npmjs.com/package/sitemap#options-you-can-pass
Type: https://github.com/ekalinin/sitemap.js/blob/0af656e6a4a7b1403c9b3af23603261bd9cf94d3/lib/sitemap-stream.ts#L20

$3

- Type: RobotOption[]
- Default: [{ userAgent: '*', allow: '/' }]

RobotOption:

- userAgent: string
- allow?: string | string[]
- disallow?: string | string[]
- crawlDelay?: number
- cleanParam?: string`

License

MIT License © 2022 jbaubree