Content Search
Local Search
Overview
Adds local search functionality to the site.
For feature details, please refer to Search Feature
Related plugin: @vuepress-plume/plugin-search
Default configuration:
import { defineUserConfig } from 'vuepress'
import { plumeTheme } from 'vuepress-theme-plume'
export default defineUserConfig({
theme: plumeTheme({
search: {
provider: 'local',
// more options...
},
})
})For configuration entry priority information, please refer to Plugin Configuration Entry.
Configuration
interface SearchOptions {
/**
* Local search internationalization
*/
locales?: {
[locale: string]: SearchBoxLocale
}
/**
* Whether articles are searchable, defaults to `() => true`
*
* Note: encrypted pages (matched by `encrypt.rules` or having a page `password`)
* are never indexed, because the search index is shipped as a public static asset
* and indexing them would leak their content.
*/
isSearchable?: (page: Page) => boolean
}
interface SearchBoxLocale {
placeholder: string
buttonText: string
resetButtonTitle: string
backButtonTitle: string
noResultsText: string
/**
* Text shown when the search index is missing or fails to load
*/
searchIndexErrorText?: string
/**
* Fallback text shown when JavaScript is disabled
*
* It is rendered inside `<noscript>`, so it must be plain text without
* HTML-escaped characters
*/
noscriptText?: string
footer: {
selectText: string
selectKeyAriaLabel: string
navigateText: string
navigateUpKeyAriaLabel: string
navigateDownKeyAriaLabel: string
closeText: string
closeKeyAriaLabel: string
}
}Algolia DocSearch
Overview
A site content search plugin powered by Algolia DocSearch
Related plugin: @vuepress/plugin-docsearch
Refer to Algolia DocSearch Reference for more information.
Enable
import { defineUserConfig } from 'vuepress'
import { plumeTheme } from 'vuepress-theme-plume'
export default defineUserConfig({
theme: plumeTheme({
search: {
provider: 'algolia',
appId: 'YOUR_APP_ID',
apiKey: 'YOUR_API_KEY',
indexName: 'YOUR_INDEX_NAME', // more options
},
})
})For configuration entry priority information, please refer to Plugin Configuration Entry.
