Skip to content

开发者高级设置

开发者高级设置

image-20220325135037553

在这里,将主题的一些不常用,但是有的用户却可能使用到的配置放在这里:

json
{
  "show_post_last_date":false,
  "alt_show":false,
  "calendar_github":"ihewro",
  "rank_num":20
}

DANGER

每行一个,按照上面的格式可以添加新的配置,注意最后一行的后面不要有英文逗号

key对应的值的类型有三种:

  • true 或者 false
  • 数字
  • 字符串

DANGER

只有字符串需要用英文双引号"" 括起来,数字或者true/false 不需要

现在支持的配置有:

与文章相关

show_post_last_date 文章最后更新日期

默认为true, false则文章页面不显示最后更新日期

alt_show 文章页面的alt标签

默认为true, false 不显示文章页面的图片的a l t标签

loading_img 图片懒加载的占位图

如果开启了图片懒加载功能,此处可以配置图片加载中的图片地址(建议是透明背景的 svg 图片)

post_speech 文章朗读

默认为true,值为false 表示不开启文章朗读功能

默认为false,表示显示图标,值为true表示外链不自动添加「跳转」图标

off_star_post 文章点赞开关

默认为false,表示文章页面开启点赞,true表示关闭

off_star_page 独立页面点赞开关

默认为false,表示独立页面开启点赞,true表示关闭

off_star_comment 独立页面点赞开关

默认为false,表示当前页面的评论开启点赞,true表示关闭

off_read_mode 阅读模式关闭

默认为 false,表示文章页面开启阅读模式,true 表示关闭

与主题功能相关

left_location: 左侧边栏内容自动定位选中

默认true,当你进入你的博客某个内容页面(比如文章/页面/分类),会自动在左侧边栏中跟随选中(置顶导航和折叠导航下暂不支持) 设置false,则关闭该特性。

rank_num: 留言板的排行榜显示的最多人数数目

默认50 数字类型 "rank_num":20 修改为20

time_first_letter

默认为true,false则时光机页面的首文字不会放大

setting_only_day_mode:

默认为false,值为true表示当启动了设右侧边栏设置按钮,仅仅显示夜间模式的设置功能。

show_static 统计图表显示开关

默认为true,值为false 表示不显示图表统计

calendar_github 统计日历中显示GitHub数据

默认为空,表示不显示GitHub数据,值为GitHub的用户名则同时显示对应GitHub的提交记录。举例:"calendar_github":"ihewro"

global_player_lyric 全局播放器歌词显示

默认为true,表示打开首页就直接显示全局音乐播放器的歌词,false表示不显示

auto_global_player_lyric, 全局播放器自动显示歌词

默认为true,表示在播放音乐的时候才会显示歌词,暂停音乐的时候自动隐藏,false表示不会根据音乐播放状态显示/隐藏歌词。

comment_random_name 评论昵称随机骰子🎲开关

默认为 true,表示评论区域的”昵称“区域有随机填写昵称的按钮,false 表示关闭该按钮

lock_hide_title 加密文章显示标题开关

默认为 false,加密分类的文章默认显示文章标题,可以通过设置为 true 来隐藏标题。(注意:首页右侧的热门文章暂不会隐藏标题)

music_api主题播放器音乐 API 地址

除非你希望使用第三方、外部提供的音乐 API 地址,否则你不需要配置该项,默认是你的博客地址/action/handsome-meting-api?server=:server&type=:type&id=:id&auth=:auth&r=:r

close_left_resize 关闭左侧边栏拖拽开关

默认为false,true表示关闭左侧边栏拖拽开关,即使设置为false,左侧边栏开关仍然会在以下情况下关闭:

  • 页面宽度小于760px
  • 透明模式
  • 取消了固定导航
  • 开启了置顶导航
  • 开启了折叠导航

close_right_resize 关闭右侧边栏拖拽开关

默认为false,true表示关闭右侧边栏拖拽开关,即使设置为false,右侧边栏仍然会在页面尺寸小于984px的时候自动关闭。

video_external_api 自定义vplayer 云解析视频接口地址

默认为https://okjx.cc/?url=

only_login_comment 仅允许登录用户评论

默认为false,true表示禁止非登录用户评论文章

与主题样式相关

smaller_avatar 首页左侧边栏更小的头像样式

默认false, true,表示开启该功能,开启后,首页侧边栏的头像样式占据的空间会更小

no_index_post_auto_array 关闭首页文章自动并列

默认false,即首页的文章根据当前屏幕的宽度决定是否并列显示(只有图片样式/小头图/无需头图的文章会参与自动排列,大头图样式独占一行,不会参与并列)

true,表示禁止这种特性,任何时候,一行只显示一篇文章

small-dock: 小样式的置顶导航

默认为true,当在开启了「置顶导航」时,顶部导航栏图标和文字排列成一行,更紧凑一些。值为false,表示置顶导航中,文字和图标是两行

blur_opacity 炫酷透明磨砂

默认为true,表示当你在外观设置开启「炫酷透明模式」会在部分位置增加磨砂效果,此效果对显示器差的设备会带来滑动掉帧的问题。false表示关闭。注意仅当开启「炫酷透明模式」,该项设置才有效果。(在版本较低的浏览器中该项始终不生效)

index-title-show 首页导航栏下标题

默认为true,表示显示首页导航栏下的“标题”,false表示不显示

index-desc-show 首页导航栏下的介绍

默认为true,表示显示首页导航栏下的介绍,false表示不显示

first_screen_animate 首次打开网页动画

默认为 false,表示首次打开网页不显示加载动画,true 表示加载动画。

p_indent 文章段落缩进

默认为 false,表示文章的段落不缩进,true 表示文章的每一个段落的开头都会缩进两个字符

自定义代码高亮文件名称

  • light_codeStyle 自定义浅色模式下代码高亮文件名称
  • dark_codeStyle 自定义深色模式下代码高亮文件名称

在外观设置界面的浅色/深色模式下的代码高亮风格选择 下可以在部分文件中选择样式,如果你想要的样式不在该列表中可以手动填写该字段,同时确保该样式文件存在(一般不需要设置请忽略)

产品文档中心 · 文档即代码