2025-01-21 12:00:06 +08:00

176 lines
5.8 KiB
TypeScript

import type { App, PluginConfig } from 'vuepress/core'
import type { PlumeThemeLocaleOptions, PlumeThemePluginOptions } from '../../shared/index.js'
import { contentUpdatePlugin } from '@vuepress-plume/plugin-content-update'
import { fontsPlugin } from '@vuepress-plume/plugin-fonts'
import { searchPlugin } from '@vuepress-plume/plugin-search'
import { shikiPlugin } from '@vuepress-plume/plugin-shikiji'
import { isPlainObject } from '@vuepress/helper'
import { cachePlugin } from '@vuepress/plugin-cache'
import { commentPlugin } from '@vuepress/plugin-comment'
import { docsearchPlugin } from '@vuepress/plugin-docsearch'
import { gitPlugin } from '@vuepress/plugin-git'
import { markdownHintPlugin } from '@vuepress/plugin-markdown-hint'
import { markdownImagePlugin } from '@vuepress/plugin-markdown-image'
import { markdownIncludePlugin } from '@vuepress/plugin-markdown-include'
import { markdownMathPlugin } from '@vuepress/plugin-markdown-math'
import { nprogressPlugin } from '@vuepress/plugin-nprogress'
import { photoSwipePlugin } from '@vuepress/plugin-photo-swipe'
import { readingTimePlugin } from '@vuepress/plugin-reading-time'
import { seoPlugin, type SeoPluginOptions } from '@vuepress/plugin-seo'
import { sitemapPlugin, type SitemapPluginOptions } from '@vuepress/plugin-sitemap'
import { watermarkPlugin } from '@vuepress/plugin-watermark'
import { mdEnhancePlugin } from 'vuepress-plugin-md-enhance'
import { markdownPowerPlugin } from 'vuepress-plugin-md-power'
export interface SetupPluginOptions {
app: App
pluginOptions: PlumeThemePluginOptions
hostname?: string
cache?: false | 'memory' | 'filesystem'
}
export function getPlugins(
options: PlumeThemeLocaleOptions,
{
app,
pluginOptions,
hostname,
cache,
}: SetupPluginOptions,
): PluginConfig {
const isProd = app.env.isBuild
const plugins: PluginConfig = [
fontsPlugin(),
contentUpdatePlugin(),
markdownHintPlugin({ hint: true, alert: true, injectStyles: false }),
]
if (pluginOptions.readingTime !== false) {
plugins.push(readingTimePlugin({
locales: {
'/zh/': {
word: '$word 字',
less1Minute: '小于 1 分钟',
time: '约 $time 分钟',
},
},
...pluginOptions.readingTime,
}))
}
if (pluginOptions.nprogress !== false) {
plugins.push(nprogressPlugin())
}
if (pluginOptions.git ?? isProd) {
const excludes = ['home', 'friends', 'page', 'custom', false]
const changelogOptions = isPlainObject(options.changelog) ? options.changelog : {}
plugins.push(gitPlugin({
createdTime: false,
updatedTime: options.lastUpdated !== false,
contributors: isPlainObject(options.contributors) || options.contributors === true
? {
avatar: true,
...options.contributors === true ? {} : options.contributors,
}
: false,
changelog: options.changelog && (options.docsRepo || changelogOptions.repoUrl)
? { repoUrl: options.docsRepo, ...changelogOptions }
: false,
filter(page) {
if (page.frontmatter.home || excludes.includes(page.frontmatter.pageLayout as string))
return false
return true
},
}))
}
if (pluginOptions.photoSwipe !== false) {
plugins.push(photoSwipePlugin({
selector: '.plume-content > img, .plume-content :not(a) > img',
}))
}
if (pluginOptions.docsearch) {
if (pluginOptions.docsearch.appId && pluginOptions.docsearch.apiKey)
plugins.push(docsearchPlugin(pluginOptions.docsearch))
else
console.error('docsearch plugin: appId and apiKey are both required')
}
else if (pluginOptions.search !== false) {
plugins.push(searchPlugin(pluginOptions.search || {}))
}
const shikiOption = pluginOptions.shiki
let shikiTheme: any = { light: 'vitesse-light', dark: 'vitesse-dark' }
if (shikiOption !== false) {
shikiTheme = shikiOption?.theme ?? shikiTheme
plugins.push(shikiPlugin({
theme: shikiTheme,
...(shikiOption ?? {}),
}))
}
if (pluginOptions.markdownEnhance !== false)
plugins.push(mdEnhancePlugin(pluginOptions.markdownEnhance))
if (pluginOptions.markdownPower !== false) {
plugins.push(markdownPowerPlugin({
fileTree: true,
plot: true,
icons: true,
...pluginOptions.markdownPower || {},
repl: pluginOptions.markdownPower?.repl
? { theme: shikiTheme, ...pluginOptions.markdownPower?.repl }
: pluginOptions.markdownPower?.repl,
}))
}
if (pluginOptions.markdownMath !== false) {
plugins.push(markdownMathPlugin(pluginOptions.markdownMath ?? { type: 'katex' }))
}
if (pluginOptions.markdownImage) {
plugins.push(markdownImagePlugin(pluginOptions.markdownImage))
}
if (pluginOptions.markdownInclude !== false) {
plugins.push(markdownIncludePlugin(isPlainObject(pluginOptions.markdownInclude) ? pluginOptions.markdownInclude : {}))
}
if (pluginOptions.watermark) {
plugins.push(watermarkPlugin({
delay: 300,
enabled: true,
...isPlainObject(pluginOptions.watermark) ? pluginOptions.watermark : {},
}))
}
if (pluginOptions.comment) {
plugins.push(commentPlugin(pluginOptions.comment))
}
if (pluginOptions.sitemap !== false && isProd) {
const sitemapOptions = isPlainObject(pluginOptions.sitemap) ? pluginOptions.sitemap : {}
sitemapOptions.hostname ||= hostname
if (sitemapOptions.hostname)
plugins.push(sitemapPlugin(sitemapOptions as SitemapPluginOptions))
}
if (pluginOptions.seo !== false && hostname && isProd) {
const seoOptions = isPlainObject(pluginOptions.seo) ? pluginOptions.seo : {}
seoOptions.hostname ||= hostname
if (seoOptions.hostname)
plugins.push(seoPlugin(seoOptions as SeoPluginOptions))
}
if (cache !== false) {
plugins.push(cachePlugin({ type: cache || 'filesystem' }))
}
return plugins
}