主题由我个人开发并测试，肯定存在未被发现Bug，如安装使用中遇到，请及时反馈。

为了方便学习研究、以及二开，主题、插件所有源码均未加密，希望大家不要分享和倒卖，谢谢了。

需要自己先搭建Typecho系统，主题基于Typecho1.3版本开发，可以前往官网下载 Typecho1.3 正式版，以前老版本可能不兼容。

官方支持的几种安装方式：云服务器、虚拟主机、Docker，强烈建议采用：云服务器部署方式。

可以考虑购买腾讯云轻量机器，一年也就一百多(甚至更低)，2H2G配置足够了。

本站腾讯云轻量4H4G5Mbps，启用MxCache插件，速度仅供参考。

PHP环境8.0，其它版本暂未尝试，后续会持续兼容至最新版PHP。

Riven主题设置

下载Riven主题包，放到/usr/themes目录下，然后后台外观中启用即可。

后台设置界面如下：

1. 主题说明：备份模板数据到数据库，而导入导出JSON是，每次保存主题设置时，会将主题设置更新到主题根目录下，名为：rivenSetting.json中，防止主题设置丢失，我因为之前切主题没注意，导致覆盖了主题设置，又要重新配置，很恼火，所以干脆做了一个JSON存储策略。
2. 主题设置：包含favicon、logo、评论区开关、评论验证码、文章目录、备案信息、首页背景图、页面宽度、文章段落首行缩进、首页通知内容、首页置顶文章、自定义菜单等设置项，按需开启和设置即可。
3. 个性化设置：gravatar头像源、字体链接、自定义css、自定义js、RSS json地址(使用RssManage插件，此处无需设置)、RSS分页数量等设置。
4. 其它：关于页相关设置、友链页面设置、以及评论等级设置。

这里说一下自定义菜单，是标准的json格式，格式如下：

[
  {"label": "微语", "url": "memos"},
  {"label": "留言", "url": "liuyan"},
  {"label": "归档", "url": "guidang"},
  {
    "label": "邻居",
    "url": "links",
    "children": [
      {"label": "友情链接", "url": "links"},
      {"label": "博友动态", "url": "rss"}
    ]
  },
  {"label": "走心", "url": "zouxin"},
  {"label": "关于", "url": "about"}
]

如果要配置自定义外部链接，只需要加上http或者https，系统会自动识别为外部链接进行跳转。

建议先把自定义页面创建好，然后配置自定义菜单即可。

自定义页面

主题内置了：关于、文章归档、友情链接(依赖兔兔插件)、留言榜单、微语、博友动态(依赖RssManage插件)、走心评论七个页面。

在Typecho后台，管理 >> 独立页面自行创建，右侧自定义模板选择即可，链接自己记住，自定义菜单中会用到。

以上内容都配置好，就可以去页面看下效果了，下面在进行插件设置。

需要安装的插件

所有插件，到Riven主题群中下载。

1、安装SiteSearch插件，全站搜索插件，由似水流年开发，我二次适配。
2、安装XQLocation插件，IP归属地插件，由苏晓晴开发，我二次适配。
3、安装Links插件，友链插件，由懵仙兔兔开发，我二次适配。
4、安装CommentNotifier插件，邮件通知插件，由满心设计开发。
5、安装SafeMange插件，安全防护插件，由满心设计开发。
6、安装RssManage插件，友链动态Rss插件，由满心设计开发。
7、安装MxCache插件，缓存插件，由满心设计开发。

注意：建议所有功能和内容设置完，且确认无误后，再开启MxCache插件，否则无法看出修改效果。

插件设置上似乎没什么好说的，等大家使用后，确实有不懂的，我再酌情补录吧。

主题、插件更新

养成随时备份是一种好习惯，建议每次更新时，尽量手动备份，防止意外发生。

主题更新两种方式，如果主题改动不大，建议直接覆盖更新；如果改动内容过大，建议直接禁用主题，然后再上传新的主题，启用即可，更新完成后一定记得清理MxCache插件和浏览器缓存。

插件没啥好说的，直接禁用插件，然后删除，上传新的插件包，再启用即可，里面的配置项需要重新配置。

从riven_v1.1.0版本后，提供了在线增量更新功能，直接后台点击更新即可。

资源分享

1、自定义字体，本站使用的是：字魂荧智，其它也可以自行替换，字体网站。

常见问题

自动抓取Rss

需要配合定时任务来执行，插件RssManage设置中，有一个计划任务地址，把这个添加到宝塔面板中定时任务，时间可以自己选择，比如15分钟执行一次，就可以达到定时抓取友链的效果了，每次禁用和启用该插件，都会重新生成末尾的token，也就是每次都要在宝塔中重新配置一次。

Rss未配置，却有数据

管理后台，控制台 >> RSS订阅管理，点击清理缓存，再查看是否正常

文章页404或搜索或点击有异常

配置站点伪静态，然后Typecho后台设置>>永久链接开启，自定义文章路径选择个性化定义，填入/{cid}.html，其它不用动。

在线更新失败

如果出现更新失败，先去服务器检查theme目录是否有写入权限