配置项

注意

所有配置需要配置在 window.cnblogsConfig 里。

提示

Url 类型的配置，请尽量配置支持 Https 的地址！

信息

JavaScript 对象是被命名值的容器。值以名称:值对的方式来书写（名称和值由冒号分隔）。

示例配置

例如我原配置为：

html

<script type="text/javascript">
    window.cnblogsConfig = {
        info: {
            name: 'userName',
            startDate: '2021-01-01',
            avatar: 'http://xxxx.png',
        },
    }
</script>

我需要新增关于主页图片的配置，新增配置为：

html

<script type="text/javascript">
    window.cnblogsConfig = {
        info: {
            name: 'userName',
            startDate: '2021-01-01',
            avatar: 'http://xxxx.png',
        },
        banner: {
            home: {
                background: [
                    "https://x1.jpg",
                    "https://x2.jpg",
                    "https://x3.jpg",
                ],
            },
        }
    }
</script>

info - 基础信息

name - 用户昵称

类型：String
默认值：{默认抓取博客园用户名}

用户昵称。

javascript

window.cnblogsConfig = {
  info: {
    name: 'userName',
  },
}

avatar - 用户头像

类型：Url
默认值：""

用户头像图片 Url。

javascript

window.cnblogsConfig = {
  info: {
    avatar: 'https://x1.jpg',
  },
}

startDate - 入园时间

类型：Date
默认值：2021-01-01

入园时间，年-月-日，入园时间查看方法：鼠标停留园龄时间上，会显示入园时间。

javascript

window.cnblogsConfig = {
  info: {
    startDate: '2021-01-01',
  },
}

blogIcon - 网站图标

类型：Url
默认值：""

网站图标图片 Url。

javascript

window.cnblogsConfig = {
  info: {
    blogIcon: 'https://x1.jpg',
  },
}

navList - 菜单导航

类型：Array
默认值：[]

自定义菜单导航，显示在默认导航下方。

javascript

window.cnblogsConfig = {
  sidebar: { // 列表数据 ['导航名称', '链接', 'icon']
    navList: [
        ['我的博客1', 'https://www.cnblogs.com/bndong/', 'icon-github'],
        ['我的博客2', 'https://www.cnblogs.com/bndong/', 'icon-github'],
    ],
  },
}

customList - 菜单数据

类型：Object
默认值：{}

自定义菜单数据，显示在默认数据上方。

javascript

window.cnblogsConfig = {
  sidebar: { // 列表数据 ['导航名称', '链接', 'icon']
    customList: {
        "title1": { // 标题
            "data": [ // 列表数据 ['列表', '链接']
                ['我的博客1', 'https://www.cnblogs.com/bndong/'],
                ['我的博客2', 'https://www.cnblogs.com/bndong/'],
                ['我的博客3', 'https://www.cnblogs.com/bndong/'],
                ['我的博客4', 'https://www.cnblogs.com/bndong/'],
                ['我的博客5', 'https://www.cnblogs.com/bndong/'],
            ],
            "icon": "icon-brush_fill" // 配置图标，参考文档：字体图标
        },
        "title2": { // 标题
            "data": [ // 列表数据 ['列表', '链接']
                ['我的博客6', 'https://www.cnblogs.com/bndong/'],
                ['我的博客7', 'https://www.cnblogs.com/bndong/'],
                ['我的博客8', 'https://www.cnblogs.com/bndong/'],
                ['我的博客9', 'https://www.cnblogs.com/bndong/'],
                ['我的博客10', 'https://www.cnblogs.com/bndong/'],
            ],
            "icon": "icon-brush_fill" // 配置图标，参考文档：字体图标
        },
    },
  },
}

infoBackground - 个人信息背景

类型：Url
默认值：""

< v2.1.0 为侧边栏个人信息背景图片Url。
>= v2.1.0 为侧边栏背景图片。

javascript

window.cnblogsConfig = {
  sidebar: {
    infoBackground: 'https://x1.jpg',
  },
}

titleMsg - 侧边栏title信息 v2.1.0

类型：String
默认值："欢迎访问本博客~"

配置侧边栏 title 信息。

javascript

window.cnblogsConfig = {
  sidebar: {
      titleMsg: '欢迎访问本博客~',
  },
}

submenu - 侧边栏是否展开配置 v2.1.3 (#387)

类型：Object
默认值：{}

默认都不展开，设置为 true 则展开。

javascript

window.cnblogsConfig = {
    sidebar: {
        submenu: {
            // 积分排行
            pointsRank: false,
            // 最新随笔
            latestPosts: false,
            // 我的标签
            myTags: false,
            // 随笔分类
            postsClassify: false,
            // 文章分类
            articleClassify: false,
            // 阅读排行
            readRank: false,
            // 推荐排行
            recommendRank: false,
            // 帖子档案
            postsArchive: false,
            // 文章档案
            articleArchive: false,
            // 自定义列表
            customList: false,
            // 最新评论
            latestComment: false,
        },
    },
}

home - 主页

类型：Array
默认值：[]

主页 Banner 图片 URL，推荐尺寸 >= 1920*1080，支持多张，每次刷新随机设置一张。

javascript

window.cnblogsConfig = {
    banner: {
        home: {
            background: [
                "https://x1.jpg",
                "https://x2.jpg",
                "https://x3.jpg",
            ],
        },
    },
}

类型：String or Array
默认值：""

主页 Banner 上的标语，设置此选项会显示自定义文字，默认为空，自动获取一句。

设置文字，会固定显示该文字。
设置数组，随机从数组中获取一条文字显示。

javascript

window.cnblogsConfig = {
    banner: {
        home: {
            title: '每一个不曾起舞的日子，都是对生命的辜负。',
        },
    },
}

javascript

window.cnblogsConfig = {
    banner: {
        home: {
            title: [
                '每一个不曾起舞的日子，都是对生命的辜负。',
                '公主死去了，屠龙的少年还在燃烧'
            ],
        },
    },
}

类型：String
默认值："jinrishici"

主页 Banner 上的标语获取源，默认为 jinrishici 每次刷新随机获取一句古诗词。

javascript

window.cnblogsConfig = {
    banner: {
        home: {
            titleSource: 'one',
        }
    },
}

/** 所有可配置项
jinrishici：每次刷新随机获取一句古诗词。
one：每日获取一句话
*/

article - 文章页

类型：Array
默认值：[]

文章页 Banner 图片 URL，推荐尺寸 >= 1920*1080，支持多张，每次刷新随机设置一张。

javascript

window.cnblogsConfig = {
    banner: {
        article: {
            background: [
                "https://x1.jpg",
                "https://x2.jpg",
                "https://x3.jpg",
            ],
        },
    },
}

loading - Loading

类型：Object
默认值：

json5

{
    rebound: {
        tension: 16,
        friction: 5,
    },
    spinner: {
        id: 'spinner',
        radius: 90,
        sides: 3,
        depth: 4,
        colors: {
            background: '#f0f0f0',
            stroke: '#272633',
            base: null,
            child: '#272633',
        },
        alwaysForward: true, // When false the spring will reverse normally.
        restAt: 0.5,         // A number from 0.1 to 0.9 || null for full rotation
        renderBase: false,
    }
}

页面加载 Loading。

javascript

window.cnblogsConfig = {
    loading: {
         rebound: {
             tension: 16,
         },
         spinner: {
             id: 'spinner',
             radius: 90,
         }
    },
}

fontIconExtend - 字体图标库扩展

类型：Url
默认值：""

字体图标库扩展Css的Url。

javascript

window.cnblogsConfig = {
    fontIconExtend: "//at.alicdn.com/t/font_xxxxxxxxxx.css",
}

progressBar - 顶部进度条

类型：Object
默认值：

json5

{
    id      : 'top-progress-bar', // 请勿修改该值
    color   : '#77b6ff',
    height  : '2px',
    duration: 0.2,
}

进度条配置，显示在页面顶部。

javascript

window.cnblogsConfig = {
    progressBar: {
         color   : '#77b6ff',
    },
}

title - 页面标签

onblur - 失去焦点标签文字

类型：String
默认值：(oﾟvﾟ)ノ Hi

当页面失去焦点，页面 title 显示的文字。

javascript

window.cnblogsConfig = {
  title: {
    onblur: '(oﾟvﾟ)ノ Hi',
  },
}

onblurTime - 失去焦点变化延时

类型：Number
默认值：500

当页面失去焦点，页面 title 变化的延时时间，单位毫秒。

该配置值为 -1 时，当页面失去焦点，页面 title 显示的文字不会变化。

javascript

window.cnblogsConfig = {
  title: {
    onblurTime: 500,
  },
}

focus - 获取焦点标签文字

类型：String
默认值：(*´∇｀*) 欢迎回来！

当页面获取焦点，页面 title 显示的文字；显示后，延时恢复原 title。

javascript

window.cnblogsConfig = {
  title: {
    focus: '(*´∇｀*) 欢迎回来！',
  },
}

focusTime - 获取焦点变化延时

类型：Number
默认值：1000

当页面获取焦点，页面 title 变化的延时时间，单位毫秒。

该配置值为 -1 时，当页面获取焦点，页面 title 显示的文字不会变化。

javascript

window.cnblogsConfig = {
  title: {
    focusTime: 1000,
  },
}

style - 页脚样式

类型：Number
默认值：2

页脚样式：

style: 1

style: 2

javascript

window.cnblogsConfig = {
  footer: {
    style: 1,
  },
}

text - 页脚标语

left - 页脚标语左侧文字

类型：``String`
默认值：""

页脚标语左侧文字。

javascript

window.cnblogsConfig = {
  footer: {
    text: {
      left: '好好学习',
    },
  },
}

right - 页脚标语右侧文字

类型：String
默认值：""

页脚标语右侧文字。

javascript

window.cnblogsConfig = {
  footer: {
    text: {
      right: '天天向上',
    },
  },
}

iconFont - 页脚标语中间图标

类型：Object
默认值：{}

json

{
    icon:  "icon-xl", // iconfont 图标名称
    color: "red", // 图标颜色
    fontSize: "16px" // 图标大小
}

页脚标语中间字体图标。

javascript

window.cnblogsConfig = {
  footer: {
    text: {
      iconFont: {
        icon:  "icon-xl",
        color: "red",
        fontSize: "16px"
      }
    },
  },
}

aplayer - 音乐播放器 v2.1.3 (#388)

类型：Object
默认值：

json5

{
    enable: false,
    cdn: {
        aplayer: 'https://lf26-cdn-tos.bytecdntp.com/cdn/expire-1-y/aplayer/1.10.1/APlayer.min.js',
        aplayercss: 'https://lf9-cdn-tos.bytecdntp.com/cdn/expire-1-y/aplayer/1.10.1/APlayer.min.css',
        meting: 'https://cdn.staticfile.org/meting/2.0.1/Meting.min.js'
    },
    options: {
        id: '3778678',
        server: 'netease',
        type: 'playlist',
        auto: 'netease',
        fixed: 'true',
        mini: 'true',
        autoplay: 'false',
        theme: '#2980b9',
        loop: 'all',
        order: 'random',
        preload: 'auto',
        volume: '0.7',
        mutex: 'true',
        lrcType: '0',
        listFolded: 'true',
        listMaxHeight: '340px',
        storageName: 'cnblogsTheme',
    }
}

音乐播放器

aplayer.cdn

引入的外部播放器脚本文件地址，可自行修改。

aplayer.options:

option	default	description
id	require	song id / playlist id / album id / search keyword
server	require	music platform: `netease`, `tencent`, `kugou`, `xiami`, `baidu`
type	require	`song`, `playlist`, `album`, `search`, `artist`
auto	options	music link, support: `netease`, `tencent`, `xiami`
fixed	`true`	enable fixed mode
mini	`false`	enable mini mode
autoplay	`false`	audio autoplay
theme	`#2980b9`	main color
loop	`all`	player loop play, values: 'all', 'one', 'none'
order	`random`	player play order, values: 'list', 'random'
preload	`auto`	values: 'none', 'metadata', 'auto'
volume	`0.7`	default volume, notice that player will remember user setting, default volume will not work after user set volume themselves
mutex	`true`	prevent to play multiple player at the same time, pause other players when this player start play
lrcType	`0`	lyric type , Don't display lyrics when the value is 0
listFolded	`true`	indicate whether list should folded at first
listMaxHeight	`340px`	list max height
storageName	`cnblogsTheme`	localStorage key that store player setting
api	`https://api.i-meto.com/meting/api?server=:server&type=:type&id=:id&r=:r`	When there is a problem with the API, you can use a different API instead

javascript

window.cnblogsConfig = {
    footer: {
        aplayer: {
            enable: false,
        },
    },
}

links - 友情链接

类型：Array
默认值：[]

页脚友链。

javascript

window.cnblogsConfig = {
  links: {
    footer: [
        ["申请坑位", 'https://msg.cnblogs.com/send/BNDong'],
        ["申请坑位", 'https://msg.cnblogs.com/send/BNDong'],
        ["申请坑位", 'https://msg.cnblogs.com/send/BNDong'],
        ["申请坑位", 'https://msg.cnblogs.com/send/BNDong'],
        ["申请坑位", 'https://msg.cnblogs.com/send/BNDong'],
    ],
  },
}

page - 友链页

类型：Array
默认值：[]

友链页。需要在页面源码中添加 <input id="linkListFlg" type="hidden" />

javascript

window.cnblogsConfig = {
  links: {
    page: [
      {
        name: 'BNDong', // 昵称
        introduction: 'IT技术类博客', // 简介
        avatar: 'https://blog.dbnuo.com/images/avatar.gif', // 头像
        url: 'https://blog.dbnuo.com' // 友链地址
      },
    ],
  },
}

rtMenu - 右下角菜单

qrCode - 二维码

类型：Url
默认值：""

二维码图片 URL。

javascript

window.cnblogsConfig = {
  rtMenu: {
    qrCode: 'https://x1.jpg',
  },
}

reward - 赞赏

类型：Object
默认值：

json5

{
  alipay: '', // 支付宝收款码
  wechatpay: '' // 微信收款码
}

赞赏。

javascript

window.cnblogsConfig = {
  rtMenu: {
    reward: {
      alipay: 'https://x1.jpg',
      wechatpay: 'https://x2.jpg'
    },
  },
}

downScrollDom - 跳至底部位置定义

类型：String
默认值：""

跳至底部位置定义，配置为 JQuery 选择器。

javascript

window.cnblogsConfig = {
  rtMenu: {
    downScrollDom: '#blog_post_info_block',
  },
}

switchDayNight - 日/夜间模式

类型：Object
默认值：

json5

{
    enable: true,       // 是否开启日/夜间模式切换按钮
    nightMode: false,   // 强制夜间模式 （版本 >= v2.0.6）
    auto: {             // 自动切换相关配置
        enable: false,  // 开启自动切换
        dayHour: 5,     // 日间模式开始时间，整数型，24小时制
        nightHour: 19   // 夜间模式开始时间，整数型，24小时制
    }
}

提示

nightMode 配置项要求，版本 >= v2.0.1

日/夜间模式配置。页面使用日/夜间模式优先级：用户设置 > 自动切换 > 默认。

javascript

window.cnblogsConfig = {
    switchDayNight: {
        enable: true,
        auto: {
            enable: true
        }
    },
}

animate - 动效

注意

版本 v2.0.3 及之后，所有动效默认配置为关闭。
动效会消耗 GPU，可能会导致页面卡顿，请大家按需谨慎选择开启！！！

类型：Object
默认值：

json5

{
    enable: false // 是否开启动效
}

主页 banner 上 name 的动效（鼠标移入显示）

javascript

window.cnblogsConfig = {
    animate: {
        homeBannerTitle: {
            enable: true
        },
    },
}

类型：Object
默认值：

json5

{
    enable: false, // 是否开启动效
    options: {
        radius: 15,
        density: 0.2,
        color: 'rgba(255,255,255, .2)', // 颜色设置，“random” 为随机颜色
        clearOffset: 0.3
    }
}

主页 Banner 动效配置。

javascript

window.cnblogsConfig = {
  animate: {
    homeBanner: {
      enable: true,
      options: {
        radius: 15,
      }
    },
  }
}

articleTitle - 文章页标题动效 v2.0.7

类型：Object
默认值：

json5

{
    enable: true // 是否开启动效
}

文章页标题动效配置。

javascript

window.cnblogsConfig = {
  animate: {
    articleTitle: {
      enable: true
    },
  }
}

articleBanner - 文章页 Banner 动效

类型：Object
默认值：

json5

{
    enable: false // 是否开启动效
}

文章页 Banner 动效配置。

javascript

window.cnblogsConfig = {
  animate: {
    articleBanner: {
      enable: true
    },
  }
}

background - 背景动效

类型：Object
默认值：

json5

{
  enable: false,
  options: {
    colorSaturation: "60%",
    colorBrightness: "50%",
    colorAlpha: 0.5,
    colorCycleSpeed: 5,
    verticalPosition: "random",
    horizontalSpeed: 200,
    ribbonCount: 3,
    strokeSize: 0,
    parallaxAmount: -0.2,
    animateSections: true
  }
}

背景动效。

javascript

window.cnblogsConfig = {
  animate: {
    background: {
      enable: true,
    },
  }
}

类型：Object
默认值：

json5

{
  enable: false, // 是否开启
  options: {
    itemNum: 5, // 图片拆分成几列
    current: 0, // 初始图片的下标，如果为负数则为随机
    sort: 1, // 1 代表每次向下加载一个图片，-1 代表每次向上加载一个图片
    time: 30000 // 每次切换间隔时间，单位：毫秒
  }
}

Banner 背景图自动切换动效。

javascript

window.cnblogsConfig = {
  animate: {
    bannerImages: {
      enable: true,
    },
  }
}

backgroundMouse - 背景动效 v2.0.8

类型：Object
默认值：

json5

{
  enable: false // 是否开启
}

背景动效，颜色比较浅不影响阅读，鼠标移动有简单动偏移动画。

javascript

window.cnblogsConfig = {
  animate: {
    backgroundMouse: {
      enable: true
    },
  }
}

mouse - 跟随鼠标动效 v2.0.8

类型：Object
默认值：

json5

{
  enable: false, // 是否开启
  options: {
    size: 8, // 中心圆点的大小，单位 px
    sizeF: 36 // 外部边框的大小，单位 px
  }
}

跟随鼠标动效。

提示

不会隐藏原鼠标，如果想隐藏原鼠标可以自行添加css样式 html {cursor: none;}

javascript

window.cnblogsConfig = {
  animate: {
    mouse: {
      enable: true,
    },
  }
}

season - 花瓣飘落动效 v2.1.3 (#382)

类型：Object
默认值：

json5

{
    "enable": false,
    "options": {
      // 默认为一个花瓣图片
      "img": "data:image/jpg;base64,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",
      "size": 40
    }
}

提示

img 建议使用 base64 转码后的图片，素材建议透明背景素材

javascript

window.cnblogsConfig = {
  animate: {
    season: {
        enable: false
    }
  }
}

avatar - 头像旋转动效 v2.1.3 (#383)

类型：Object
默认值：

json5

{
  enable: false // 是否开启
}

javascript

window.cnblogsConfig = {
    animate: {
        avatar: {
            enable: false
        },
    },
}

typing - 评论框打字动效 v2.1.5 (#431)

类型：Object
默认值：

json5

{
    enable: false, // 是否开启
    options: {
        colorful: true,  // 是否多彩
        shake: false, // 是否震动
    }
}

javascript

window.cnblogsConfig = {
    animate: {
        typing: {
            enable: false
        },
    },
}

code - 代码

type - 代码渲染类型

类型：String
默认值：""

使用何种方式渲染代码。

javascript

window.cnblogsConfig = {
  code: {
    type: 'hljs',
  }
}

/** 所有可配置项
cnblogs: 使用博客园默认代码高亮样式。
hljs: 使用 Highlighting 插件渲染代码高亮样式。
*/

options - 代码配置

hljs - Highlighting 插件样式配置

类型：Object
默认值：

json5

{
    theme: 'atom-one-dark-reasonable',
    languages: []
}

只有 code.type 为 hljs 时，此配置才生效。

theme：代码高亮主题。

/** 所有可配置项
default、a11y-dark、a11y-light、agate、an-old-hope、androidstudio、arduino-light、arta、ascetic
、atelier-cave-dark、atelier-cave-light、atelier-dune-dark、atelier-dune-light、atelier-estuary-dark
、atelier-estuary-light、atelier-forest-dark、atelier-forest-light、atelier-heath-dark
、atelier-heath-light、atelier-lakeside-dark、atelier-lakeside-light、atelier-plateau-dark、atelier-plateau-light
、atelier-savanna-dark、atelier-savanna-light、atelier-seaside-dark、atelier-seaside-light
、atelier-sulphurpool-dark、atelier-sulphurpool-light、atom-one-dark-reasonable、atom-one-dark、atom-one-light
、brown-paper、codepen-embed、color-brewer、darcula、dark、darkula、docco、dracula、far
、foundation、github-gist、github、gml、googlecode、grayscale、gruvbox-dark、gruvbox-light、hopscotch
、hybrid、idea、ir-black、isbl-editor-dark、isbl-editor-light、kimbie.dark、kimbie.light、lightfair
、magula、mono-blue、monokai-sublime、monokai、nord、obsidian、ocean、paraiso-dark、paraiso-light、pojoaque
、purebasic、qtcreator_dark、qtcreator_light、railscasts、rainbow、routeros、school-book、shades-of-purple
、solarized-dark、solarized-light、sunburst、tomorrow-night-blue、tomorrow-night-bright
、tomorrow-night-eighties、tomorrow-night、tomorrow、vs、vs2015、xcode、xt256、zenburn
*/

languages：语言识别范围，不配置默认不限制，支持语言。

javascript

window.cnblogsConfig = {
  code: {
    type: 'hljs',
    options: {
      hljs: {
        theme: 'atom-one-dark-reasonable',
        languages: ['Bash', 'CSS', 'Dockerfile', 'Go', 'HTML', 'XML', 'HTTP']
      },
    },
  },
}

maxHeight - 代码框高度限制

类型：String
默认值：""

限制高度。例如：70vh、70%

javascript

window.cnblogsConfig = {
  code: {
    options: {
      maxHeight: '70vh',
    },
  },
}

line - 代码行号渲染

类型：Boolean
默认值：false

是否渲染代码行号，如开启会在代码框左侧增加行号显示，默认不开启。不与博客园行号渲染兼容，如果博客园添加代码时勾选显示行号并同时开启此配置，会出现双行号的现象。大家自己权衡使用此配置。

javascript

window.cnblogsConfig = {
  code: {
    options: {
      line: true,
    },
  },
}

macStyle - Mac 风格代码框

类型：Boolean
默认值：true

Mac 风格代码框样式。

javascript

window.cnblogsConfig = {
  code: {
    options: {
      macStyle: true,
    },
  },
}

fontSize - 代码字体大小 v2.1.1

类型：Number
默认值：14

代码字体大小，数值类型，单位px。

javascript

window.cnblogsConfig = {
  code: {
    options: {
        fontSize: 20,
    },
  },
}

articleDirectory - 文章目录

position - 文章目录定位 v2.0.6

类型：String
默认值："right"

用于设置文章目录显示在文章的左侧还是右侧，配置项：right、left

javascript

window.cnblogsConfig = {
    articleDirectory: {
        position: 'right',
    },
}

minBodyWeight - 文章目录隐藏宽度 v2.0.7

类型：Number
默认值：900

文章目录在屏幕宽度到多少像素及以内时开始隐藏；例如：配置成 1000，当屏幕宽度 <= 1000 时，隐藏目录（可通过右下角按钮显示）

javascript

window.cnblogsConfig = {
    articleDirectory: {
        minBodyWeight: 1400,
    },
}

autoWidthScroll - 文章目录横向滚动条 v2.0.8

类型：Boolean
默认值：false

文章目录中标题过长时候是否显示横向滚动条。

javascript

window.cnblogsConfig = {
    articleDirectory: {
        autoWidthScroll: true,
    },
}

articleComment - 文章评论

background - 文章评论背景 v2.1.3 (#386)

类型：Object
默认值：

json5

    {
      enable: false,
      options: {
        day: 'rgba(0, 0, 0, 0) url("images/comment_bg_day.png") no-repeat scroll 100% 31% / 35% padding-box border-box',
        night: 'rgba(0, 0, 0, 0) url("images/comment_bg_dark.png") no-repeat scroll 100% 31% / 35% padding-box border-box',
      },
    }

文章评论背景

javascript

window.cnblogsConfig = {
    articleComment: {
        background: {
            enable: false,
        },
    },
}

articleContent - 文章内容

prefixIcon - 文章标题前图标 v2.1.3 (#379)

类型：Object
默认值：

json5

{
    enable: false,
    options: {
        // iconfont 地址
        link: "https://at.alicdn.com/t/c/font_3628204_t6n3fw8b1zn.js",
        // 用于展示的iconfont名称
        iconfontArr: [
            'hebaodan','bingtanghulu','kesong','qianceng','fengmi','feiyuguantou','shengjian','youtiao','yuzijiang','zhutongfan','doujiang','sanmingzhi',
            'paofu','shanbei','dangaojuan','futejia','huangyou','xiangchang','banji','danta','qingning','lajiao','shizi','mojituo','pijiu','putaojiu',
            'kouxiangtang','xiangcaobingqilin','jiaozi','tilamisu','huoguo','hongshu','bingkuai','mianhuatang','paobing','meishikafei','mantou','qishui',
            'ganlan','jiroujuan','guodong','baozi','pingguo','chengzi','qingjiao','jidan','xihongshi','mangguo','baocai','niunai','mianbao','huluobu','zhangyu',
            'pangxie','longxia','yangcong','rou','jitui','huage','xianyu','mogu','qiezi','xilanhua','ningmeng','liulian','banli','sanwenyu','tudou','xigua','nangua',
            'huolongguo','fantuan','zhusun','shuiluobu','shanzhu','lanmei','shiliu','yezi','tiangua','mihoutao','boluo','kaixinguo','hetao','xiaweiyiguo','huasheng',
            'bigenguo','kuihuazi','songzi','xiguazi','badanmu','yaoguo','danhuangsu','dangao','binggan','buding','tangguo','qiaokeli','hongzao','candou','putaogan',
            'manyuemei','taozi','xiangjiao','caomei','niuyouguo','hamigua','chelizi','li','bale','kafei1','shutiao','zhenzhunaicha','xuegao','nailao','kele','tiantong',
            'hanbao','xiezishousi','baomihua','regou','makalong','tianfuluo','juzi','baixiangguo','putao','shaomai','yumi','pipa','yangtao','youzi','lianwu','wuhuaguo',
            'paomian','wandou','huanggua','suantou','tiantianquan','shupian','huafubing','bangbangtang','shousi','lizhi','doufu','mocha','boluomi','zhouzi','bingsha',
            'suannai','pisa','haixing','haizhe','tongluoshao','nuomici','kuangquanshui','roujiamo','cha','zhangyuxiaowanzi','chengzhi','yuancaitou','baicai'
        ],
    }
}

标题前的图标，便于区分内容和标题

javascript

window.cnblogsConfig = {
    articleContent: {
        prefixIcon: {
            enable: false,
            options: {
                link: '',
                iconfontArr: [],
            }
        }
    },
}

articleSuffix - 文章后缀

imgUrl - 左侧图片 v2.0.1

类型：Url
默认值：""

文章后缀左侧图片，不配置使用用户头像配置 info.avatar，用户头像没配置使用主题默认头像。

javascript

window.cnblogsConfig = {
  articleSuffix: {
    imgUrl: 'https://x1.jpg',
  },
}

aboutHtml - 关于博主

类型：String
默认值：""

关于博主，支持 HTML 代码，不配置使用默认。

javascript

window.cnblogsConfig = {
    articleSuffix: {
        aboutHtml: "I am a good person",
    },
}

copyrightHtml - 版权声明

类型：String
默认值：""

javascript

window.cnblogsConfig = {
    articleSuffix: {
        copyrightHtml: "版权...",
    },
}

supportHtml - 声援博主

类型：String
默认值：""

声援博主，支持 HTML 代码，不配置使用默认。

javascript

window.cnblogsConfig = {
    articleSuffix: {
        supportHtml: "声援...",
    },
}

copyInfo - 文章复制携带版权信息 v2.1.5 (#429)

类型：Object
默认值：

json5

{
    enable: false, // 是否开启
    length: 100, // 当文章页面上选中多少文字后开始生效
    copyright: '', //  复制携带版权信息，默认为 copyrightHtml
}

文章页上，鼠标选中文字进行复制携带版权信息。

javascript

window.cnblogsConfig = {
    articleSuffix: {
        copyInfo: {
            enable: true,
            length: 100,
            copyright: '',
        }
    }
}

memorialDays - 国家公祭日和自定义缅怀的日期 v2.1.5 (#439)

类型：Array
默认值：[]

国家公祭日和自定义缅怀的日期，日期配置为带有前导零的月日，格式 MM-DD

javascript

window.cnblogsConfig = {
    memorialDays: [
        '07-04',
        '12-13'
    ],
}

consoleList - 控制台输出

类型：Array
默认值：[]

控制台输出。

javascript

window.cnblogsConfig = {
    consoleList: [
         ['BNDong CNBlogs', 'https://www.cnblogs.com/bndong'],
         ['BNDong GitHub', 'https://github.com/BNDong'],
         ['BNDong Email', 'dbuo@foxmail.com'],
    ],
}

配置项 ​

info - 基础信息 ​

name - 用户昵称 ​

avatar - 用户头像 ​

startDate - 入园时间 ​

blogIcon - 网站图标 ​

sidebar - 侧边栏 ​

navList - 菜单导航 ​

customList - 菜单数据 ​

infoBackground - 个人信息背景 ​

titleMsg - 侧边栏title信息 v2.1.0 ​

submenu - 侧边栏是否展开配置 v2.1.3 (#387) ​

banner - Banner ​

home - 主页 ​

background - 主页 Banner 图片 ​

title - 主页 Banner 标语 ​

titleSource - 主页 Banner 标语获取源 ​

article - 文章页 ​

background - 文章页 Banner 图片 ​

loading - Loading ​

fontIconExtend - 字体图标库扩展 ​

progressBar - 顶部进度条 ​

title - 页面标签 ​

onblur - 失去焦点标签文字 ​

onblurTime - 失去焦点变化延时 ​

focus - 获取焦点标签文字 ​

focusTime - 获取焦点变化延时 ​

footer - 页脚 ​

style - 页脚样式 ​

text - 页脚标语 ​

left - 页脚标语左侧文字 ​

right - 页脚标语右侧文字 ​

iconFont - 页脚标语中间图标 ​

aplayer - 音乐播放器 v2.1.3 (#388) ​

links - 友情链接 ​

footer - 页脚友链 ​

page - 友链页 ​

rtMenu - 右下角菜单 ​

qrCode - 二维码 ​

reward - 赞赏 ​

downScrollDom - 跳至底部位置定义 ​

switchDayNight - 日/夜间模式 ​

animate - 动效 ​

homeBannerTitle - 主页banner上name的动效 v2.1.3 ​

homeBanner - 主页 Banner 动效 ​

articleTitle - 文章页标题动效 v2.0.7 ​

articleBanner - 文章页 Banner 动效 ​

background - 背景动效 ​

bannerImages - Banner 背景图自动切换 v2.0.8 ​

backgroundMouse - 背景动效 v2.0.8 ​

mouse - 跟随鼠标动效 v2.0.8 ​

season - 花瓣飘落动效 v2.1.3 (#382) ​

avatar - 头像旋转动效 v2.1.3 (#383) ​

typing - 评论框打字动效 v2.1.5 (#431) ​

code - 代码 ​

type - 代码渲染类型 ​

options - 代码配置 ​

hljs - Highlighting 插件样式配置 ​

maxHeight - 代码框高度限制 ​

line - 代码行号渲染 ​

macStyle - Mac 风格代码框 ​

fontSize - 代码字体大小 v2.1.1 ​

articleDirectory - 文章目录 ​

position - 文章目录定位 v2.0.6 ​

minBodyWeight - 文章目录隐藏宽度 v2.0.7 ​

autoWidthScroll - 文章目录横向滚动条 v2.0.8 ​

articleComment - 文章评论 ​

background - 文章评论背景 v2.1.3 (#386) ​

articleContent - 文章内容 ​

prefixIcon - 文章标题前图标 v2.1.3 (#379) ​

articleSuffix - 文章后缀 ​

imgUrl - 左侧图片 v2.0.1 ​

aboutHtml - 关于博主 ​

copyrightHtml - 版权声明 ​

supportHtml - 声援博主 ​

copyInfo - 文章复制携带版权信息 v2.1.5 (#429) ​

memorialDays - 国家公祭日和自定义缅怀的日期 v2.1.5 (#439) ​

consoleList - 控制台输出 ​

配置项

info - 基础信息

name - 用户昵称

avatar - 用户头像

startDate - 入园时间

blogIcon - 网站图标

sidebar - 侧边栏

navList - 菜单导航

customList - 菜单数据

infoBackground - 个人信息背景

titleMsg - 侧边栏title信息 v2.1.0

submenu - 侧边栏是否展开配置 v2.1.3 (#387)

banner - Banner

home - 主页

background - 主页 Banner 图片

title - 主页 Banner 标语

titleSource - 主页 Banner 标语获取源

article - 文章页

background - 文章页 Banner 图片

loading - Loading

fontIconExtend - 字体图标库扩展

progressBar - 顶部进度条

title - 页面标签

onblur - 失去焦点标签文字

onblurTime - 失去焦点变化延时

focus - 获取焦点标签文字

focusTime - 获取焦点变化延时

footer - 页脚

style - 页脚样式

text - 页脚标语

left - 页脚标语左侧文字

right - 页脚标语右侧文字

iconFont - 页脚标语中间图标

aplayer - 音乐播放器 v2.1.3 (#388)

links - 友情链接

footer - 页脚友链

page - 友链页

rtMenu - 右下角菜单

qrCode - 二维码

reward - 赞赏

downScrollDom - 跳至底部位置定义

switchDayNight - 日/夜间模式

animate - 动效

homeBannerTitle - 主页banner上name的动效 v2.1.3

homeBanner - 主页 Banner 动效

articleTitle - 文章页标题动效 v2.0.7

articleBanner - 文章页 Banner 动效

background - 背景动效

bannerImages - Banner 背景图自动切换 v2.0.8

backgroundMouse - 背景动效 v2.0.8

mouse - 跟随鼠标动效 v2.0.8

season - 花瓣飘落动效 v2.1.3 (#382)

avatar - 头像旋转动效 v2.1.3 (#383)

typing - 评论框打字动效 v2.1.5 (#431)

code - 代码

type - 代码渲染类型

options - 代码配置

hljs - Highlighting 插件样式配置

maxHeight - 代码框高度限制

line - 代码行号渲染

macStyle - Mac 风格代码框

fontSize - 代码字体大小 v2.1.1

articleDirectory - 文章目录

position - 文章目录定位 v2.0.6

minBodyWeight - 文章目录隐藏宽度 v2.0.7

autoWidthScroll - 文章目录横向滚动条 v2.0.8

articleComment - 文章评论

background - 文章评论背景 v2.1.3 (#386)

articleContent - 文章内容

prefixIcon - 文章标题前图标 v2.1.3 (#379)

articleSuffix - 文章后缀

imgUrl - 左侧图片 v2.0.1

aboutHtml - 关于博主

copyrightHtml - 版权声明

supportHtml - 声援博主

copyInfo - 文章复制携带版权信息 v2.1.5 (#429)

memorialDays - 国家公祭日和自定义缅怀的日期 v2.1.5 (#439)

consoleList - 控制台输出