2024-11-09 00:35:28 +08:00

2.5 KiB
Raw Blame History

title, author, createTime, permalink
title author createTime permalink
水印 Plume Theme 2024/06/17 15:37:18 /config/watermark/

概述

主题内置的 水印插件,为 全站,或者 单个页面 添加水印。

关联插件:@vuepress/plugin-watermark

使用

::: code-tabs @tab .vuepress/config.ts

import { defineUserConfig } from 'vuepress'
import { plumeTheme } from 'vuepress-theme-plume'

export default defineUserConfig({
  theme: plumeTheme({
    plugins: {
      // watermark: true,
      watermark: {
        // enabled: false,  // boolean 类型控制是否全局启用
        enabled: page => true, // function 类型 过滤哪些页面启用水印
        delay: 500, // 添加水印的延时。以毫秒为单位。

        /**
         * 是否全屏水印,默认为 `true`
         * 设置为 `false` 时,水印仅在 内容区域中显示。
         */
        fullPage: true,

        /** @see https://zhensherlock.github.io/watermark-js-plus/zh/config/ */
        watermarkOptions: {
          content: 'your watermark',
          // ...
        }
      }
    }
  })
})

:::

配置项

enabled

  • 类型: boolean | ((page: Page) => boolean)

  • 默认值: false

  • 详情:

    指定哪些页面需要添加水印。

    拥有 true 值的页面将会被添加水印。

watermarkOptions

  • 类型: WatermarkOptions

  • 默认值: undefined

  • 详情: 配置项请参考 watermark-js-plus

watermarkOptions.parent

  • 类型: string

  • 默认值: body

  • 详情:添加水印的父元素选择器。

    默认插入到 body 中,可以指定插入到页面的某个元素中。

delay

  • 类型: number

  • 默认值: 500

  • 详情:添加水印的延时。以毫秒为单位。

    延迟时间取决于页面过渡动画时间,可以根据实际情况调整。

    如果水印的父元素在切换页面时被重新渲染,那么延迟时间应该比页面过渡时间长一些。

Frontmatter

watermark

  • 类型: boolean | WatermarkOptions

  • 详情:

    当类型为 boolean 时,表示是否启用水印。

    当类型为 WatermarkOptions 时,表示当前页面水印配置。

    可以参考 watermark-js-plus

---
watermark:
  width: 200
  height: 200
  content: Your content
  opacity: 0.5
---