WordPress免费主题:Document,让阅读变得更加方便
- Wordpress
- 2022-06-13
- 1750热度
- 80评论
😁作为一个程序员,在日常的工作、生活、学习的过程中基本都有很多需要做笔记的地方;做笔记的主要目的之一是为了“温故而知新”,另一个则是为了在下一次遇到的时候,不需要再次耗费精力去找解决方法;
回顾自己之前写的那个主题,不管是写还是查都不怎么方便,最终下定决心重写一个主题;以 “方便记、方便查、简约”作为设计核心;
开源地址
Github:https://github.com/friend-nicen/theme-document
Gitee:https://gitee.com/friend-nicen/theme-document
2023-01-02更新
- 后台主题设置新增调用媒体库设置banner和logo
- 新增文章特色图片位置切换(左或者右侧显示)
- 新增站内跳转时,记住正在浏览的动态栏目
- 文章列表小工具新增【热门文章】,按照阅读量进行排序展示
- 修复调色板无法关闭的问题
- 更新首页banner小工具的样式,新增移动端是否显示banner的选项
- 首页和文章页从统一侧边栏,拆分成两个侧边栏,可在小工具页面进行设置
- 新增最新评论小工具
- 文章内容标题样式优化
- 新增Cravatar镜像服务器(wordpress头像)
- 修改一堆小BUG(不记得了)
2022-10-25更新
1.经典编辑器新增表格插件(Tinymce自身的table插件)
表格列 | 表格列 | 表格列 |
表格列 | 表格列 | 表格列 |
表格列 | 表格列 | 表格列 |
2.新增快捷下划线
这是下划线,这是下划线,这是下划线
2022-10-11更新
更新到2.0版本,风格不变,代码差不多都重构优化了一下,新增了很多实用的功能,后台截图如下(点击图片放大查看),时间有限其它的就不叙述了:




安装主题
直接将整个Github仓库下载,然后上传到wordpress的/wp-content/themes目录,然后在后台启用主题即可。启用后通过后台左侧菜单【主题选项】进行相关配置 。
安装完了肯定跟 nicen.cn是不一样的,你需要进行如下的一些配置。
安装之后
主题默认启用经典文章编辑器、经典小部件编辑器,同时对经典文章编辑器进行了增强。
主题对JS、CSS全局进行了压缩,同时在主题内提供了未压缩的源文件。
1.关于文章目录
文章目录由后端生成,默认读取【h1】、【h2】、【h3】元标签(编辑器内的小插件可直接插入)。主题已对经典编辑器进行插件增强,请自行体验哈。
2.主题后台修改基本信息
主题后台可以自定义如下内容:
- 博客副标题
- 博客页面关键字
- 博客页面描述
- 博客logo链接
- 留言板链接
- 文章聚合链接
- 赞赏码
- 百度站长推送Token
- ICP备案号
- Gravatar镜像服务器
- 页脚附加代码
3.新增页面模板
主题具有 文章聚合、留言两个文章模板,在后台添加页面时选择对应模板发布后,可将导航栏内的文章聚合、留言页面链接修改为你创建的链接。
- 新建页面
- 选择留言板或者文字聚合模板
- 发布
- 复制链接,
- 修改主题选项为这俩页面
4.顶部菜单
主题具有顶部文章分类、快速阅读两个菜单,文章分类用于展示文章类别,快速阅读用于添加常用的一些链接,快速访问。
- 新建菜单
- 添加菜单项
- 发布到顶部菜单
5.小部件、侧边栏
主题具有文章信息、作者信息、最新文章、最近更新 四个小部件(小部件自带配置,可在添加的时候填写),添加后默认在文章页面的右侧边栏显示。
- 关闭之前主题自带的小工具
- 拖入document主题的小部件
- 保存修改
- 不保存的话,会显示之前主题的小部件导致样式错乱
6.邮箱SMTP配置
wordpress自带的邮件发送服务不太友好,你可以在主题选项开启主题自带的邮件服务,使用自己的邮箱服务
- 开启后,新评论通知站长
- 评论回复通知被回复评论的用户
- 评论审核通知通知发布评论的用户
2022-06-03
端午节,在style.css里敲下了第一段代码,描述主题。🤣然后初步确定主要需要具备的一些功能:
/*
Theme Name: Document
Theme URI: https://nicen.cn
Author: 友人a丶
Author URI: https://nicen.cn
Description: 一个基于文档类型的博客主题,更加方便的记录、查询学习笔记
Version: 1.0
License: GNU General Public License v2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Text Domain: Document
Tags: 文档,自适应,主题切换,阅读进度跟随
*/
1.文章目录导航
能够根据文章内容自动生成文章目录,虽然这个前端实现比较方便,但是考虑到需要seo所以直接在后端生成;
文章目录导航需要自动跟随阅读进度,点击文章目录导致自动跳转到对应的内容;
文章目录最小高度为屏幕的一半,悬浮在文章左侧;
2. 黑夜、白天阅读模式切换、主题色切换
支持黑夜、白天阅读模式,主题色切换,悬浮在屏幕右下角,附带一个屏幕滚动进度;
3. 主题前端元素
- 代码高亮
- 代码块一键复制
resolve: { alias: { compiler: resolve('src/compiler'), }
- 成功文字块、失败文字块、警告文字块成功文字块这是成功文字块警告文字块这是警告文字块失败文字块这是失败文字块
- 文字标记
this is <code>
- 图片灯箱
图片灯箱 - 一级、二级、三级标题
- 作者信息卡片
- 文章信息卡片
- 评论区
- 最新文章
- 文章导航
- 文章底部赞赏
- 站点底部信息
- 导航栏菜单
- 导航栏搜索
- 上一篇、下一篇文章
- 一键回到顶部
- 主题色、阅读模式切换
- 文章点赞、踩
- 文章浏览、评论、发布时间、作者信息显示
4. 主题前端优化
- 文章页右边栏正常高度时,跟随文章滚动,滚动高度超出侧边栏高度时自动悬浮,保持右边侧边栏始终存在元素,不会空白;
- 访问首页时显示自定义的站点描述,文章页时自动截取文章内容作为网页描述;
- 优化Gavatar头像,改为国内镜像服务器;
5. 主题后端优化
- 自动切换到经典编辑器。
- 去除后台加载的无用代码。
- 增加后台设置,可设置主题的基本信息:关键词、主题描述、作者信息等;
- 增加编辑器插件:代码高亮、一级、二级、三级标题、成功文字块、错误文字块、失败文字块、图片灯箱、文字标记
- 新增元标签:一级、二级、三级标题、成功文字块、错误文字块、失败文字块、图片灯箱、文字标记
- 自定义顶部菜单
- 404页面
- 搜索空结果页面
- 文章密码权限控制
20220617更新
- 修复窗口大小改变时,固定状态下的左右侧边栏位置没有同步变动,导致样式错乱的问题;
20220628更新
- 新增文章归档页面模板,新建页面时可选。
- 新增百度站长一键提交URL功能。
- 新增移动端、平板页面自适应。
20220701更新
- 压缩css、js,源文件分别保存在同级目录,css源文件为scss文件。
- 修复已知的一些UI样式问题。
20220709更新
- 重构侧边栏,拆分成四个可自定义的小部件。
- 增加文章顶部的面包屑导航。
- 修复因为QQ、微信浏览器不支持16进制透明颜色导致阴影失效的BUG。
20220710更新
- 修改了Github仓库地址
- 新增自定义Smtp邮件发送功能,开启后用户评论、回复时自动会发送邮件通知。
20220724更新
- 首页变成两栏显示
- 优化了大屏和小屏显示的字体大小
- 调整了移动端的UI样式
- 下滑阅读时自动隐藏导航栏,上滑时自动显示。
- 修复主题logo无法修改的问题(由于未register注册该选项导致)
20220725更新
- 新增主题选项:设置首页显示单、双栏
大哥,那个写文章时表格工具条总是在中间挡着视线,这个大概修改思路是什么样的,实在是看不懂这块代码



/wp-content/themes/destination/common/plugins/table.js,跟这个文件的代码有关,具体逻辑还得分析分析


我确实是在看这个文件,越看越懵
请问支持PHP8.0吗?
然后我看每个页面的keywords,都是统一的?
不能调用标签词当keywords关键词的吗?
PHP8我没试过,应该没啥问题。关键字这个去看了一下,确实是🤣,下次更新的时候我改改
大哥,我每次删除媒体库中附件时总是弹出“删除附件时发生错误”,刷新浏览器后文件确实是被删除了,这是私密原因呢
我这也是,影响不大也没去找过原因


我终于找到问题所在了,主题的functions中,加载的所有方法中,结尾不能有“?>”,发现/include/class/CommentsWalker.php结尾有,删掉即可,这样不报错了,同时编辑图片的功能也正常了
强啊,还真是
这么强,我去试试
大哥我有个建议,把文章导航换成分类导航,换成分类导航,自动拉取后台的分类多级目录(不是菜单里面一个一个设置那个),和笔记软件那样,文章多了以后,这个文章导航就没有用过,需要保留文章导航的话,可以把分类里面的文章也加载到分类里。这样这个主题就真的就是笔记主题了,大哥是否考虑
主题代码我基本都写了注释的
,你完全可以读懂,然后进行私人订制


明白
,大哥注释没得说,很详细
我不太懂PHP
我是写C++的,php能看懂个大概,目前我已经修改的有,
1、在theme-document-master/template/index/article-header.php里面加了,当前登录用户是否为作者,是就显示编辑按钮,编辑链接找到一个get_edit_post_link这个给函数
2、作者信息小工具最下面,加了两个按钮,一个“发布文章”、一个“用户中心”
3、经典编辑器默认的图片居中,局左环绕,和居右环绕,不生效,是style样式里缺了,加进去就好了
4、文章发布时间错误,应该是你当时看到后台健康检测提示重复时区设置,你把function里的时区去掉导致的,我查了一下,这个去掉是对的,目前wordpress统一用UTC时区,后台设置好时长就行,通过他指定的函数获取就行,问题就出在在/include/functions/common.php,函数nicen_theme_timeToString里,strtotime这个函数获取的是UTC时间戳,time()获取的服务器本地时间,时间差就出来了,把time()改为wordpress提供时间获取函数current_time( ‘timestamp’,false )了
5、我还加了一个类似朋友圈的微言微语功能,每日记录,作为我老了的时候当回忆录看的,这个网上有好多教程,我给融合到你首页分栏那里了
我改的挺乱的
这个主题完全是为了方便我自己做笔记、查资料开发的,所以可能更加符合我个人的习惯

你这个实现起来倒也不难,但是我觉得意义不是很大。
首先这个功能满足的需求,跟我顶部这个配置好的文章分类差别并不大,而且文章量级上来之后,也不见得会有多方便
。
最后,我觉得页面上的文章导航,肯定是跟页面相关联的,你说的这种,在博客的世界里,还是栏目更大众化。
我弄这个文章导航的初衷是为了方便概览一下文章列表。


13884215011
加个微信吧聊起来方便
救命。我把左侧栏弄丢了,但是鼠标放上去它还在那里。它隐身了。
网站找了个插件nicen-localize-image,结果没想到是你创作的。
闲的时候顺手写的😅😅😅
通过近几天的测试网站搭建好了,主题非常喜欢。虽然安装遇到波折,还是想用这个主题。
感谢作者分享。
当前遇到问题:
发布文章显示-474分钟前 是个负数。不知道啥原因。我业余刚搞定网站,界面还没搭建好。希望多指点
主题安装进入wp-login会出现空白
查了些资料是php.ini需要开通
在PHP.INI中,有两个跟缓冲区紧密相关的配置项
1.output_buffering
该配置直接影响的是php本身的缓冲区,有3种配置参数。on/off/xK(x为某个整型数值);
on – 开启缓冲区
off – 关闭缓冲区
256k – 开启缓冲区,而且当缓冲区的内容超过256k的时候,自动刷新缓冲区(把数据发送到apache);
2.implicit_flush
该配置直接影响apache的缓冲区,有2种配置参数。 on/off
on – 自动刷新apache缓冲区,也就是,当php发送数据到apache的缓冲区的时候,不需要等待其他指令,直接就把输出返回到浏览器
off – 不自动刷新apache缓冲区,接受到数据后,等待刷新指令
到上午再来解决,您加微信good7341,到时候直接问我就行。
这个还没来的急弄,logo做好了。也是很喜欢你的logo高仿了一个。
下载后,创建主题目录为theme-document ,进入主题logo加载错误,logo目录为document
重新设置一下logo,或者修改一下主题目录名
没有友情链接模块吗
下个版本加一个….
老大您好!仓库下载安装的主题版本1.2.5,好像不是最新版本1.2.8?谢谢您。
版本号忘改了,仓库已经是最新代码了


这是后台主题设置里的显示:
版本信息:当前版本(1.2.5)/ 最新版本(1.2.8)
谢谢。
你好 总于找到我想要的笔记主题了,但没有手机端界面吗?就像PC端那样显示目录,这样手机端和PC端一样使用效果了,如果手机端也有目录(左侧)或者(右侧,最好左侧)可以伸缩和悬浮,就完美了。
大哥我又来提简易了,我在文章信息插件里面添加了一个编辑文章的按钮,可以点击一下就快速编辑正在阅读的文章,这样就不用去后台翻找文章来修改了,我还在悬浮工具条上加了一个写文章的按钮,一件抵达后台创建新文章,我感觉这样方便了很多,大哥是否考虑后面版本加上
文章信息,是指的那个小工具对吧。
,说的有道理,我每次都得翻
,OK,没问题的!
是的,就是那个小工具,我没研究过wordpress二次开发,只是在你那个小工具那里加了一句<a href="”>编辑文章</a>这个,先凑活着用着
评论不了PHP代码
没事,我已经懂了
大哥,那个表格的小工具条还是占用最后一行表格的问题没有修复呢
好的,好的,大哥辛苦
头像可以使用https://cravatar.cn/,这是litepress项目的衍生产品,可以完美解决国内头像的问题。
收到,下次更新的时候我集成一下。
非常感谢大佬制作的主题,满足了我需要写长文的问题。不过有一个小的疑问,因为需要文章目录的一般是长文,有的时候分享给他人,或者引入的时候,需要复制指定目录层级的地址,我看大佬的主题分类目录点击跳转目录没有地址生成,请问这个是故意设置的还是?可以自己修改实现吗,谢谢
文件位置:/document/common/main.js
第58行:e.preventDefault(); //阻止默认事件
把这行注释掉就行(PS:仓库源代码已更新)😁
感谢大佬,您这效率没谁了,厉害~
文章聚合,留言板按步骤操作
文章聚合有内容页面没有样式
留言板有内容,没有侧栏以及评论区域
这是建在网站2级目录下的
到你的站点看了一下,确实是有问题,要不你直接把后台给我,我去测测问题
留言区域没问题了,然后文章聚合。样式需要修改文件么?
找到了一个BUG…修好了,判断页面使用的哪个模板的时候,那个函数有点问题,导致判断结果为false,所以没加载样式,和二级目录没关系。
好的,谢了
留言页面不显示评论是因为wordpress默认关闭页面的评论,在编辑页面的时候 点击右上角 【显示选项】-【勾选讨论】-【滑到下面的讨论】-【显示评论】,这样就好了。
源码上面都没有css引入404这个文件夹了吗?
昨天发现搜索文章错误页面的样式在源码上面都没有,还是从你的demo上面下载的。然后文章详情页面旁边的liststyle会多出的黑点没去掉。可能有部分样式也没有加载吧
刚刚把仓库重新同步了一下开发版源码(demo站点主题源码),现在应该好了,样式丢失,可能是之前的修改遗忘了…🤦♂️🤦♂️
右边导航栏样式还是没有hover效果,我安装网站顶级目录用新下的版本也是没有效果呀
顶部的那个导航栏菜单吗?
我看说明调整好了,原来还需要调整的
😆😆😆菜单是后台自定义添加的,没有固定写死😁
顶部的没有分类内容,然后右边的没有鼠标效果
后台添加菜单了吗
在域名下一级目录安装的博客,这个主题搜索,路径报错如何修改呢
请问报错的时候有错误日志输出吗,有的话还请发一下🤦♂️
我用的内网小主机,穿透的域名访问不了的。只能用自己设的虚拟域名。我先研究一下源码吧,主要是发送请求的源码链接处理好就行了
if (event.keyCode == “13”) {
location.href = location.origin + “?s=” + that.val();
}
文章搜索的js,在document/common/main.js文件的这一段,默认是直接从一级目录进行拼接的,如果是下级目录确实会出问题,你可以手动在这个默认的搜索路径加上你的二级目录名;
location.origin这段不用拼接,让它根据当前目录搜索就行了。谢谢提醒
没有错误日记,就是点击评论跳转链接直接是域名加处理的php文件。缺少中间的目录名,找不到正确的php文件处理请求
有可以让我复现这个问题的站点吗。。。。。🐱🐉
大佬,主题很棒,请问你和友人C是啥关系?
我也不熟🤣🤣🤣
Parse error: syntax error, unexpected ‘[‘ in wp-content/themes/theme-document-master/index.php on line 35,你好,请问这个问题怎么解决呢?我打开这个文件看过了,貌似没有语法问题。
我尝试了一下,复现不出这个问题…现在咋样了🤣🤣🤣
哈哈,我还是没进去。刚刚您说是分类问题,然后我尝试把文章全部删除重试,还是进不去。
你的PHP是几点几的版本
更换版本解决了,谢谢大佬!
🤣🤣🤣wordpress最新版本好像已经不支持5.x了。
5.6很低。大佬您这么一说可能我php版本不行,我更新一下试试。
主题很棒!一直想要这样的主题!