使用说明系列（部署中有问题此issue讨论）

[removeif]

使用主题前请仔细阅读主题README.md，以及主题配置文件_config.yml!!!

使用主题前请仔细阅读主题README.md，以及主题配置文件_config.yml!!!

使用主题前请仔细阅读主题README.md，以及主题配置文件_config.yml!!!

[removeif]

1.首页文章折叠方法

适当位置放入标签 <!-- more -->此标签之后的部分在首页自动影藏，此标签之前的部分为摘要，会放入文章的description字段中，此部分最好对此文章作总结，以便于于更好的seo。

[removeif]

2.首页个人资料 一言句子

首页个人资料，左边一言句子 配置文件中可以关闭，也可以点击句子自动切换一言句子。

[removeif]

3.关于加密文章的使用以及缺少依赖包的问题

• 完全使用readme中提供的文件package.json内容替换博客目录下的package.json，并非主题目录下的package.json！！！

{
  "name": "hexo-site",
  "version": "0.0.0",
  "private": true,
  "scripts": {
    "build": "hexo generate",
    "clean": "hexo clean",
    "deploy": "hexo deploy",
    "server": "hexo server"
  },
  "hexo": {
    "version": "5.2.0"
  },
  "dependencies": {
    "bulma-stylus": "^0.8.0",
    "hexo": "^5.0.0",
    "hexo-blog-encrypt": "^3.0.13",
    "hexo-component-inferno": "^0.8.2",
    "hexo-deployer-git": "^2.1.0",
    "hexo-generator-archive": "^1.0.0",
    "hexo-generator-category": "^1.0.0",
    "hexo-generator-index": "^2.0.0",
    "hexo-generator-tag": "^1.0.0",
    "hexo-renderer-ejs": "^1.0.0",
    "hexo-renderer-inferno": "^0.1.3",
    "hexo-renderer-marked": "^3.0.0",
    "hexo-renderer-stylus": "^2.0.0",
    "hexo-server": "^2.0.0"
  }
}

• 删除博客目录下node_modules已有依赖包
• 博客目录下执行 npm install 安装依赖包
• 安装完后如果要使用置顶功能，需要重新修改node_modules中相应文件

[removeif]

4.关于widget的增减

• 如果要去掉一个widget，只需要在主题配置文件_config.yml中注释 相应的widget，如不需要邮件订阅的widget则注释如下

    # Tags widget configurations
    -
        # Where should the widget be placed, left sidebar or right sidebar
        position: right
        type: tags
    # Google FeedBurner email subscription widget configurations
    #-
        # Where should the widget be placed, left sidebar or right sidebar
        #position: right
        #type: subscribe_email
        # Hint text under the email input
        #description: 输入邮箱开始订阅，更博后邮件通知！
        # Feedburner ID
        #feedburner_id: removeifFeedsId

• 注意一定要把该节点的 -这个符号一起注释掉，否则会报错
• 节点中position: right代表是在左还是在右显示

[removeif]

5.logo图片设置方法

从网站 https://www.qt86.com/ 设计一张带字透明的图片，放到 主题img中，配置文件中相应logo地方引用此图片就可以了

[removeif]

6.配置文件注释注意问题！！！

配置前面有此 - 的需要把此 - 一起注释掉，否则编译会报错！

[removeif]

7.gitalk 评论使用

• 配置文件中开启如下配置

comment:
    type: gitalk
    owner: removeif         # (required) GitHub user name
    repo: blog_comment          # (required) GitHub repository name
    client_id: 46a9f3481b46ea0129d8     # (required) OAuth application client id
    client_secret: 79c7c9cb847e141757d7864453bcbf89f0655b24 # (required) OAuth application client secret
    admin: ['removeif']
    create_issue_manually: true
    distraction_free_mode: false
    has_hot_recommend: true # 是否有热门推荐
    has_latest_comment: true #是否有最新评论

• owner：github 账号名，如URL中 https://github.com/removeif 中的removeif
• repo：放评论的仓库，需要自己去GitHub创建一个public类型的仓库
• client_id，client_secret 申请
  找到如图位置
  
  新建app
  
  填写完内容，然后点击register xxx 创建完成
  
  找到刚刚创建的app，点击进去找到相关client_id，client_secret参数
  
• admin 管理员参数，博客文章里第一次点进去需要初始化issue，需要用此账号登录 初始化，可填多个，如 ['removeif','dogzi']，同时配置create_issue_manually: true，此时才能点击初始化，自动创建issue。如下文章中点击以下登录，然后在点击创建issue!
  
• 以上点击初始化issue后 首页评论 数99+才会变成对应正常的评论数

[removeif]

8.首页增加banner，热门推荐和banner只能存在一个，如果两个都有热门推荐优先

感谢水寒提供的教程
开启方法，配置中开启以下配置

has_banner: false #首页是否有banner，true-是，false-否，如果配置了热门推荐显示热门推荐，banner配置数据在json_data/banner.json里按照配置格式配置好，至少三条

数据文件在themes/amazing/source/json_data/banner.json 中，配置成对应格式就好，图片长宽一致
效果如下 https://dogzi.fun/

[removeif]

9.针对热门推荐没标题的问题

如图所示：

此页面是page 友链页面，生成issue的时候page没有title，如下对应issue

可以自己手动加上，只需要编辑issue标题。比如上面的友链issue标题改成
友链 - 帕奇笔记
就可以了，注意-前后有个空格

[removeif]

10.添加自定义widget

• 主题 文件中_config.yml 添加

    - 
        position: right
        type: notice
        contents: 
            1: 2019.8.15 <a href="https://github.com/removeif/hexo-theme-amazing" target="_blank">主题开源</a>
            2: 2020.5.20 添加公告widget
            3: 2020.5.21 公告测试

• include/schema/common/widgets.json 文件中添加

,  {
                "$ref": "/widget/notice.json"
   }

• include/schema/widget/notice.json 添加

{
    "$schema": "http://json-schema.org/draft-07/schema#",
    "$id": "/widget/notice.json",
    "description": "Notice links widget configurations",
    "type": "object",
    "properties": {
        "type": {
            "type": "string",
            "const": "notice"
        },
        "contents": {
            "type": "object",
            "description": "notic contents",
            "patternProperties": {
                ".+": {
                    "type": "string",
                    "description": "URL of the site"
                }
            },
            "examples": [
                {
                    "1": "2019.05.23 建站"
                }
            ],
            "nullable": true
        }
    },
    "required": [
        "type"
    ]
}

• i18文件 languages/en.yml， languages/zh-CN.yml添加 widget 名称

 notice: 'Notice'
 notice: '通知'

• layout/widget/notice.jsx widget 宽主要样式，以及获取相关内容

const { URL } = require('url');
const { Component } = require('inferno');
const { cacheComponent } = require('../util/cache');

class Links extends Component {
    render() {
        const { title, contents } = this.props;
        return <div class="card widget">
            <div class="card-content">
                <div class="menu">
                    <h3 class="menu-label">{title}</h3>
                    <ul>
                        {Object.keys(contents).map(key => {
                            return <li>
                                <span>
                                    <span dangerouslySetInnerHTML={{ __html: contents[key] }}></span>
                                </span>
                            </li>;
                        })}
                    </ul>
                </div>
            </div>
        </div>;
    }
}

module.exports = cacheComponent(Links, 'widget.links', props => {
    const { helper, widget } = props;
    if (!Object.keys(widget.contents).length) {
        return null;
    }
    return {
        title: helper.__('widget.notice'),
        contents: widget.contents
    };
});

效果如下：

• 注意
  每个地方的notice名字一定要对应上。
  详细的代码diff！

[autorecap]

为什么Adsense不写成config而是是新的branch？