{"id":15519161,"url":"https://github.com/friend-nicen/theme-document","last_synced_at":"2025-04-12T20:46:07.789Z","repository":{"id":44331550,"uuid":"512079627","full_name":"friend-nicen/theme-document","owner":"friend-nicen","description":"Document主题，一款专为做笔记而开发的wordpress主题","archived":false,"fork":false,"pushed_at":"2025-03-11T12:28:16.000Z","size":4521,"stargazers_count":257,"open_issues_count":5,"forks_count":35,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-04T00:46:14.195Z","etag":null,"topics":["wordpress","wordpress-theme"],"latest_commit_sha":null,"homepage":"https://nicen.cn","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/friend-nicen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-07-09T03:02:45.000Z","updated_at":"2025-03-27T10:19:23.000Z","dependencies_parsed_at":"2023-11-07T14:46:23.825Z","dependency_job_id":"6ccd6c66-f04e-42fd-b3a1-714e64f66602","html_url":"https://github.com/friend-nicen/theme-document","commit_stats":{"total_commits":90,"total_committers":2,"mean_commits":45.0,"dds":0.0888888888888889,"last_synced_commit":"da58176a6660d28d72a84600299ef97b39f046c9"},"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/friend-nicen%2Ftheme-document","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/friend-nicen%2Ftheme-document/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/friend-nicen%2Ftheme-document/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/friend-nicen%2Ftheme-document/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/friend-nicen","download_url":"https://codeload.github.com/friend-nicen/theme-document/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248631702,"owners_count":21136559,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["wordpress","wordpress-theme"],"created_at":"2024-10-02T10:20:26.483Z","updated_at":"2025-04-12T20:46:07.764Z","avatar_url":"https://github.com/friend-nicen.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"😁作为一个程序员，在日常的工作、生活、学习的过程中基本都有很多需要做笔记的地方；做笔记的主要目的之一是为了“温故而知新”，另一个则是为了在下一次遇到的时候，不需要再次耗费精力去找解决方法；\r\n\r\n回顾自己之前写的那个主题，不管是写还是查都不怎么方便，最终下定决心重写一个主题；以 “方便记、方便查、简约”作为设计核心；\r\n\r\n本文则记录主题从诞生至今所有的开发记录；\r\n\r\n进入友人a的笔记预览主题：[nicen.cn](https://nicen.cn/)\r\n\r\n# 开源地址\r\n\r\nGithub：[https://github.com/friend-nicen/theme-document](https://github.com/friend-nicen/theme-document)\r\n\r\nGitee：[https://gitee.com/friend-nicen/theme-document](https://gitee.com/friend-nicen/theme-document)\r\n\r\n使用帮助看这里：[https://nicen.cn/1552.html](https://nicen.cn/1552.html)\r\n\r\n\u003e 😁，加我微信【good7341】或机器人微信【nicen_friend】拉你进交流群！\r\n\r\n# 打赏记录\r\n\r\n不定时更新..........,感谢：\r\n\r\n| 时间         | 昵称          | 金额    |\r\n|------------|-------------|-------|\r\n| 2024-04-08 | 黯星丶         | 36.6  |\r\n| 2024-04-18 | 桩白墨 plough  | 25    |\r\n| 2024-11-13 | Laumy       | 66.0  |\r\n| 2025-01-13 | Jason zhang | 100.0 |\r\n| 2025-02-13 | 法律人@海       | 66.0  |\r\n\r\n# 打赏\r\n\r\n乐意的话，打赏一下也行，不打赏也没关系，如果打赏记得备注一下大名哦，~.~\r\n\r\n![img.png](https://weixin.nicen.cn/images/weixin.jpg)\r\n\r\n# 插件推荐\r\n\r\n## Wordpress免费远程图片本地化插件\r\n\r\nwordpress插件后台搜索nicen-localize-image\r\n\r\nGithub：[https://github.com/friend-nicen/nicen-localize-image](https://github.com/friend-nicen/nicen-localize-image)\r\n\r\nGitee：[https://gitee.com/friend-nicen/nicen-localize-image](https://gitee.com/friend-nicen/nicen-localize-image)\r\n\r\n## Wordpress用户行为回放插件\r\n\r\nGithub：\u003chttps://github.com/friend-nicen/nicen-replay\u003e\r\n\r\nGitee：\u003chttps://gitee.com/friend-nicen/nicen-replay\u003e\r\n\r\n# 2025-03-09\r\n\r\n1. 新增友情链接页面\r\n\r\n# 2025-03-08\r\n\r\n1. 新增主题后台可以自定义背景色\r\n2. 新增主题后台可设置是否禁用古腾堡编辑器\r\n\r\n# 2024-11-22\r\n\r\n1. 新增编辑文章时，可单独指定是否保存文章内的反斜杠\r\n\r\n# 2024-11-20\r\n\r\n1. 新增编辑文章、页面时可以定义关键词和描述\r\n\r\n# 2024-11-19\r\n\r\n1. 新增文章阅读目录可以展开/折叠\r\n2. 新增文章目录顶部图标批量展开/折叠阅读目录\r\n3. 新增图片懒加载\r\n\r\n# 2024-11-16\r\n\r\n1. 修复文章目录在html模式下跳转异常的问题\r\n\r\n# 2024-08-31更新\r\n\r\n1. 修复白天/黑夜模式切换，后台设置显示、隐藏无效的问题\r\n2. 更换灯箱插件（https://fengyuanchen.github.io/viewerjs/）\r\n3. 部分页面样式微调，修复部分BUG\r\n\r\n# 2024-04-22更新\r\n\r\n1. 修复动态分页时偶发重复加载的问题\r\n\r\n# 2024-04-08更新\r\n\r\n1. 修复文章目录在html模式下跳转异常的问题\r\n\r\n# 2024-03-23更新\r\n\r\n1. 修复主题接口和wordpress数据导出操作冲突的问题\r\n2. 修复文章目录html解析模式无法正常点击跳转的问题\r\n3. 修改文章推荐小工具内的匿名函数使用方法\r\n4. 修复文章数量过多时，百度推送报错的问题，将百度站长工具链接推送调整为分批推送\r\n\r\n# 2024-02-06更新\r\n\r\n1. 新增可选文章目录解析模式（元标签 \u0026 HTML）\r\n2. 优化文章字数统计\r\n3. 优化部分样式\r\n\r\n# 2023-11-07更新\r\n\r\n1. 新增是否开启文章保留反斜杠的开关\r\n2. 新增管理员访问带密码的文章时忽略密码直接访问\r\n3. 针对历史遗留问题（踩了Wp时间函数的坑）优化时区校准开关\r\n4. 新增几处功能说明的Tips\r\n\r\n# 2023-10-23更新\r\n\r\n1. 修复文章保存后反斜杠被当做转义符导致丢失的问题\r\n2. 调整几处css\r\n3. 新增时区校正\r\n\r\n# 2023-01-07更新\r\n\r\n1. 新增文章推荐小工具\r\n2. 新增动态分页时，滚动到底部时自动加载（可设置是否开启）\r\n3. 新增开启/关闭显示Logo或标题的选项\r\n4. 新增支持修改站点部分功能默认的URL规则的功能。\r\n5. 新增文章底部版权信息、打赏按钮是否显示的选项。\r\n6. 新增自定义文章底部版权信息的功能，提供获取文章标题、固定链接、作者信息等标签\r\n7. 新增设置文章上/下一篇的相关文章的来源选项（所有文章和同栏目文章）\r\n\r\n# 2023-01-02更新\r\n\r\n1. 后台主题设置新增调用媒体库设置banner和logo\r\n2. 新增文章特色图片位置切换（左或者右侧显示）\r\n3. 新增站内跳转时，记住正在浏览的动态栏目\r\n4. 文章列表小工具新增【热门文章】，按照阅读量进行排序展示\r\n5. 修复调色板无法关闭的问题\r\n6. 更新首页banner小工具的样式，新增移动端是否显示banner的选项\r\n7. 首页和文章页从统一侧边栏，拆分成两个侧边栏，可在小工具页面进行设置\r\n8. 新增最新评论小工具\r\n9. 文章内容标题样式优化\r\n10. 新增Cravatar镜像服务器（wordpress头像）\r\n11. 更换评论区域的默认头像\r\n12. 修改一堆小BUG（不记得了）\r\n\r\n# 2022-10-25更新\r\n\r\n1. 评论可以添加表情\r\n2. 编辑器可以插入表格\r\n3. 编辑器新增快捷下划线\r\n\r\n预览 - [https://nicen.cn/1552.html](https://nicen.cn/1552.html)\r\n\r\n# 2022-10-11更新\r\n\r\n更新到2.0版本，风格不变，代码差不多都重构优化了一下，新增了很多实用的功能，后台截图如下（点击图片放大查看），时间有限其它的就不叙述了：\r\n![基本设置](https://nicen.cn/wp-content/uploads/2022/06/1665419985715.png)\r\n![首页设置](https://nicen.cn/wp-content/uploads/2022/06/1665419976060.png)\r\n![页脚设置](https://nicen.cn/wp-content/uploads/2022/06/1665419953959.png)\r\n![导航栏设置](https://nicen.cn/wp-content/uploads/2022/06/1665419985715.png)\r\n\r\n# 安装之前\r\n\r\n通过重新安装空白的wordpress使用本主题进行测试，按照如下步骤安装后，未发现问题。\r\n显示的页面与 [nicen.cn](https://nicen.cn) 别无二致，如您发现任何问题，欢迎反馈。\r\n\r\n# 安装主题\r\n\r\n直接将整个Github仓库下载，然后上传到wordpress的/wp-content/themes目录，然后在后台启用主题即可。启用后通过后台左侧菜单【主题选项】进行相关配置\r\n。\r\n\r\n安装完了肯定跟 [nicen.cn](https://nicen.cn/) 是不一样的，你需要进行如下的一些配置。\r\n\r\n## 关于主题\r\n\r\n大部分代码都有注释，作为学习wordpress主题开发学习的主题模板应该是很OK的\r\n\r\n## 使用须知\r\n\r\n主题默认启用经典文章编辑器、经典小部件编辑器，同时对经典文章编辑器进行了增强。\r\n\r\n主题对JS、CSS全局进行了压缩，同时在主题内提供了未压缩的源文件。\r\n\r\n# 安装之后\r\n\r\n## 1.关于文章目录\r\n\r\n文章目录由后端生成，默认读取【h1】、【h2】、【h3】元标签（编辑器内的小插件可直接插入）。主题已对经典编辑器进行插件增强，请自行体验哈。\r\n\r\n## 2.主题后台修改基本信息\r\n\r\n主题后台提供了超强的自定义功能，你可以通过自定义做出自己真正喜欢的主题。\r\n\r\n## 3.新增页面模板\r\n\r\n主题具有 文章聚合、留言两个文章模板，在后台添加页面时选择对应模板发布后，可将导航栏内的文章聚合、留言页面链接修改为你创建的链接。\r\n\r\n1. 新建页面\r\n2. 选择留言板或者文字聚合模板\r\n3. 发布\r\n4. 复制链接，\r\n5. 修改主题选项为这俩页面\r\n\r\n## 4.顶部菜单\r\n\r\n1. 新建菜单\r\n2. 添加菜单项\r\n3. 发布到顶部菜单\r\n\r\n主题采集支持无限级的菜单，下级菜单会自动作为下拉菜单出现；\r\n\r\n## 5.小部件、侧边栏\r\n\r\n主题具有文章信息、作者信息、最新文章、最近更新 四个小部件（小部件自带配置，可在添加的时候填写），添加后默认在文章页面的右侧边栏显示。\r\n\r\n1. 关闭之前主题自带的小工具\r\n2. 拖入document主题的小部件\r\n3. 保存修改\r\n4. 不保存的话，会显示之前主题的小部件导致样式错乱\r\n\r\n## 6.邮箱SMTP配置\r\n\r\nwordpress自带的邮件发送服务不太友好，你可以在主题选项开启主题自带的邮件服务，使用自己的邮箱服务\r\n\r\n1. 开启后，新评论通知站长\r\n2. 评论回复通知被回复评论的用户\r\n3. 评论审核通知通知发布评论的用户\r\n\r\n# 2022-10-14\r\n\r\n1. 新增首页文章导航\r\n2. 修改目录跳转偶发错误的BUG\r\n\r\n# 2022-10-11\r\n\r\n1. 根据配置动态生成主题设置的表单页面\r\n2. 根据配置动态生成主题所有的选项\r\n3. 将页面内容jusitify-center改为flex-start，指定margin-left偏移进行居中，防止flex加载过程中导致闪烁;同时考虑没有侧边栏时该怎么处理;\r\n4. 修改动态加载文章列表只在首页显示\r\n5. 新增页面模板配置，根据配置自动增加页面模板\r\n6. 添加主题超强自定义功能\r\n7. 新增顶部导航栏自定义\r\n8. 修复白天、暗黑、自定义主题的样式优先级问题\r\n9. logo与主题内容大小对齐\r\n10. 新增首页、栏目页不同分页类型设置\r\n11. 新增og协议元数据显示\r\n12. 底部内容页结构化数据\r\n13. 修复 #loadnext 导致动态翻页失效的问题\r\n14. 去除底部主题声明\r\n15. 自动增加阅读量\r\n16. 将阅读模式切换的图标改成字体\r\n17. css模块化\r\n18. 新增文章阅读目录\r\n19. 新增主题色修改器\r\n20. 新增外部图片替换成本地图的功能\r\n21. 修改全局变量、函数前缀为nicen_theme\r\n22. 修改logo最小宽度为30px，防止页面抖动\r\n22. 支持自定义主题的模块是否显示\r\n23. 新增文章动态加载\r\n24. ...还有更多\r\n\r\n# 2022-06-03\r\n\r\n端午节，在style.css里敲下了第一段代码，描述主题。🤣然后初步确定主要需要具备的一些功能：\r\n\r\n```\r\n/*\r\nTheme Name: Document\r\nTheme URI: https://nicen.cn\r\nAuthor: 友人a丶\r\nAuthor URI: https://nicen.cn\r\nDescription: 一个基于文档类型的博客主题，更加方便的记录、查询学习笔记\r\nVersion: 1.0\r\nLicense: GNU General Public License v2 or later\r\nLicense URI: http://www.gnu.org/licenses/gpl-2.0.html\r\nText Domain: Document\r\nTags: 文档,自适应,主题切换,阅读进度跟随\r\n*/\r\n```\r\n\r\n## 1.文章目录导航\r\n\r\n能够根据文章内容自动生成文章目录，虽然这个前端实现比较方便，但是考虑到需要seo所以直接在后端生成；\r\n\r\n文章目录导航需要自动跟随阅读进度，点击文章目录导致自动跳转到对应的内容；\r\n\r\n文章目录最小高度为屏幕的一半，悬浮在文章左侧；\r\n\r\n## 2. 黑夜、白天阅读模式切换、主题色切换\r\n\r\n支持黑夜、白天阅读模式，主题色切换，悬浮在屏幕右下角，附带一个屏幕滚动进度；\r\n\r\n## 3. 主题前端元素\r\n\r\n1. 代码高亮\r\n2. 代码块一键复制\r\n3. 成功文字块、失败文字块、警告文字块\r\n4. 文字标记\r\n5. 图片灯箱\r\n6. 一级、二级、三级标题\r\n7. 作者信息卡片\r\n8. 文章信息卡片\r\n9. 评论区\r\n   10 最新文章\r\n11. 文章导航\r\n12. 文章底部赞赏\r\n13. 站点底部信息\r\n14. 导航栏菜单\r\n15. 导航栏搜索\r\n16. 上一篇、下一篇文章\r\n17. 一键回到顶部\r\n18. 主题色、阅读模式切换\r\n19. 文章点赞、踩\r\n20. 文章浏览、评论、发布时间、作者信息显示\r\n\r\n## 主题前端优化\r\n\r\n1. 文章页右边栏正常高度时，跟随文章滚动，滚动高度超出侧边栏高度时自动悬浮，保持右边侧边栏始终存在元素，不会空白；\r\n2. 访问首页时显示自定义的站点描述，文章页时自动截取文章内容作为网页描述；\r\n3. 优化Gavatar头像，改为国内镜像服务器；\r\n\r\n## 主题后端优化\r\n\r\n1. 自动切换到经典编辑器。\r\n2. 去除后台加载的无用代码。\r\n3. 增加后台设置，可设置主题的基本信息：关键词、主题描述、作者信息等；\r\n4. 增加编辑器插件：代码高亮、一级、二级、三级标题、成功文字块、错误文字块、失败文字块、图片灯箱、文字标记\r\n5. 新增元标签：一级、二级、三级标题、成功文字块、错误文字块、失败文字块、图片灯箱、文字标记\r\n6. 自定义顶部菜单\r\n7. 404页面\r\n8. 搜索空结果页面\r\n9. 文章密码权限控制\r\n\r\n## 20220617更新\r\n\r\n1. 修复窗口大小改变时，固定状态下的左右侧边栏位置没有同步变动，导致样式错乱的问题；\r\n\r\n## 20220628更新\r\n\r\n1. 新增文章归档页面模板，新建页面时可选。\r\n2. 新增百度站长一键提交URL功能（后台设置好Token）。\r\n3. 新增移动端、平板设备页面自适应。\r\n\r\n## 20220701更新\r\n\r\n1. 压缩css、js，源文件分别保存在同级目录，css源文件为scss文件。\r\n2. 修复已知的一些UI样式问题。\r\n\r\n## 20220709更新\r\n\r\n1. 重构侧边栏，拆分成四个可自定义的小部件。\r\n2. 增加文章顶部的面包屑导航。\r\n3. 修复因为QQ、微信浏览器不支持16进制透明颜色导致阴影失效的BUG。\r\n\r\n## 20220710更新\r\n\r\n1. 修改了Github仓库地址\r\n2. 新增自定义Smtp邮件发送功能，开启后用户评论、回复时自动会发送邮件通知。\r\n\r\n## 20220712更新\r\n\r\n1. 修复css压缩后丢失主题元信息的问题。\r\n\r\n## 2022-07-24更新\r\n\r\n1.首页变成两栏显示\r\n2.优化了大屏和小屏显示的字体大小\r\n3.调整了移动端的UI样式\r\n4.下滑阅读时自动隐藏导航栏，上滑时自动显示。\r\n5.修复主题logo无法修改的问题（由于未register注册该选项导致）\r\n\r\n## 2022-07-25\r\n\r\n1. 新增主题选项：设置首页显示单、双栏\r\n\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffriend-nicen%2Ftheme-document","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffriend-nicen%2Ftheme-document","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffriend-nicen%2Ftheme-document/lists"}