Reach 使用文档

独立页面

目前只做了友链和关于页面，像分类页和时间归档这些基本没什么用，也就没有做，而FAQ页面准备设置为主题的帮助页面，但是目前太忙也没来得及做，到时候更新的时候加上去。

创建友链和关于页面：

如果你之前也有独立页面并且不是下面两个，我建议是删除，不删除虽然也会在导航栏输出，但是进去不会有内容，本主题暂时只适配这两个独立页面，有能力者也可以自行开发

友链

撰写 --- 创建页面 --- 标题填：友链 --- 链接自定义填：links --- 自定义模板选：links

截图忘记写了，友链右侧的页面顺序填1

友链的内容格式为表格，md的写法，格式如下：

| LOGO      | 站点名称    | 站点地址 | 介绍 |
| --------- | -------- | ----- | ----- |
| ![冰封博客][1]| 冰封博客| [https://www.ad-s.cn/](https://www.ad-s.cn/) |   山高人为峰|

logo填图片，站点地址为链接，其他为文本。

关于页面

关于页面的内容部分修改需要手动修改主题文件夹中的about.php部分，自行替换内容。

撰写 --- 创建页面 --- 标题填：关于 --- 链接自定义填：about --- 自定义模板选：about

截图忘记写了，关于右侧的页面顺序填2

todo列表

todo的表头可以用在任何地方，格式如下

[这里填小写X] 这是勾选表头
[这里填一个空格] 里面为空格则是未勾选

• 这是勾选表头
• 里面为空格则是未勾选

二级分类

主题支持二级分类菜单，可以自行在后台设置，将某一个分类设置一个父类即可。

注意：这个父类的菜单将不支点击进入对应的分类页面，使用前注意不要将文章分类勾选到父类的分类下

目录树

只有文章才有目录树，目录统一为h2元素，md的写法就是两个#号。

文章缩略图

目前自定义文章缩略图还未完善，当前的缩略图为自动获取文章的第一张图片为缩略图，如果没有缩略图则随机显示本地图片，图片的位置位于：images --- content-sm-bg文件夹下，可自行替换，注意文件名要一致。

banner轮播

左侧四个为随机文章，右侧为热门文章。

博客信息

在右侧侧栏第一个是博客的信息，其中创建时间是需要手动设置的，这个可以自行到sidebar.php文件中修改一下即可。

站点logo

为了适应多平台，我推荐大家到Favicon网站进行转换，你们将站点logo图片，svg或者其他，个人推荐svg转，批量转换后下载到本地，然后替换到images下的favicon文件夹里的内容就行了，其他不用管，十分方便。

Favicon Generator. For real.

移动网用户估计要梯子。

回复可见

在需要回复可见的内容用[hide][/hide]标签包裹起来就行了。

注意：回复可见和插件EditorMD Markdown编辑器冲突，如果你使用的该插件，回复可见就不能使用了，然后你需要修改post.php文件中di为cmd_md的div元素内的所有php代码，并改为：

<?php $this->content(); ?>

保存即可。

天气功能（pro版才有）

默认是调用第三方的天气，但是今天我自己写了一个天气插件，有需要的可以使用这个效果，打开reach.js文件，将开头的天气部分js代码取消注销，然后将自己的开发者key加上，教程：天气插件

然后再去sidebar.php中找到天气插件，将iframe元素注销，然后在后面加上引入php

<?php $this->need('weather.php'); ?>

loading

pro版使用的是我之前自己开发的狂野飙车9的加载动画，如果不想要这么复杂的话可以如下操作,更换为简洁模式。

首先找到loading.php文件，删除里面所有的内容，粘贴下面的html代码

<div id="preloader">
    <div id="status">
        <div class="bouncing-loader">
            <div></div>
            <div></div>
            <div></div>
        </div>
    </div>
</div>

然后保存。

找到head.php，删除loading.css引用并保存。

找到script.php，删除loading.min.js引用并保存。

更改完毕。

完全取消loading

如果完全不需要loading，按照上面的删掉了css和js引用后，直接把loading.php里面的内容也删除就行了。

限制评论字数

在js目录里找到reach.js，搜索文字限制评论字数就可以找到对应的代码，把500改为你想要的数字保存。

pro版还需要改动一处地方，在js\jq_plugin目录下找到jquery.expression.min.js文件打开，搜索500,然后修改为一样的数字，比如你之前要求只能输入250个字，这里也改成250，然后保存。

完毕。

站点地图

1.2版本更新新增了底部站点地图Sitemap，使用该功能自行去pro群下载AutoSitemap微调版插件安装使用即可。

滚动进度条

1.2新增滚动进度条，可以自己编写css样式和修改颜色，代码如下：

// 顶部进度条
$.loadingBar({
    position: 'fixed',
    top: 0,
    height: '2px',
}, 'bg-info');

loadingBar方法有两个参数，第一个为对象，是css样式设置，第二个为class，class不是必须的，css是必须的，如果你不懂bootstarp4的背景颜色class，又想自己自定义进度条颜色，可以如下写法

// 顶部进度条
$.loadingBar({
    position: 'fixed',
    top: 0,
    height: '2px',
    backgroundColor: '#000'
});

想改啥样色修改backgroundColor对应的值即可，支持rgba，rgba，hsl，#fff这些写法。

该代码在js目录下的reach.js中，搜索顶部进度条就可以找到对应的代码自行修改

php切换7.0以上报错无法使用

这个问题我个人测试的时候发现并不是主题的问题，而是typecho数据库配置的问题。

找到博客根目录的config.inc.php文件，打开，翻到最底部

默认数据库配置：

/** 定义数据库参数 */
$db = new Typecho_Db('Mysql', 'typecho_');
$db->addServer(array (
  'host' => 'localhost',
  'user' => '数据库名',
  'password' => '数据库密码',
  'charset' => 'utf8',
  'port' => '端口',
  'database' => '数据库表前缀',
), Typecho_Db::READ | Typecho_Db::WRITE);
Typecho_Db::set($db);

将第一句修改为：

$db = new Typecho_Db('Mysqli', 'typecho_');

这个时候如果还是进不去，改为：

$db = new Typecho_Db('Pdo_Mysql', 'typecho_');

如何开启debug模式

php报错没有详细提示，只有个error信息，为了更详细的了解问题出在哪里，我们可以给typecho开启debug模式。

博客根目录config.inc.php文件，打开

加入下面这句代码

/** Dbug模式 */
 define('__TYPECHO_DEBUG__', true);

放在开头注释的后面

粒子背景

如果不需要可以自行打开主题文件中的script.php文件删除这行引用：

<script type="text/javascript" src="<?php $this->options->themeUrl('js/js_plugin/canvas-nest.js'); ?>" color="108,117,125" opacity="0.8" 

自定义粒子参数：

行内属性有两个可以自行修改：