hexo-butterfly-clock-anzhiyu-yang v1.0.1

hexo-butterfly-clock-anzhiyu-yang

这是基于 hexo-butterfly-clock-anzhiyu 项目修改而来的版本，为 hexo-theme-butterfly 添加 侧边栏电子钟。

原项目说明

原项目 hexo-butterfly-clock-anzhiyu 由 anzhiyu-c 开发，此版本在原项目基础上进行了修改和优化。

删除了原作者无效的获取ip地址的代码

许可证声明

本项目采用 Apache 2.0 许可证，详细内容请查看 LICENSE 文件。

安装

1. 如果有安装店长的插件版侧边栏电子钟（与店长的电子钟冲突）或者anzhiyu的插件（因和风天气关闭了api地址，会拖慢页面的加载速度），在博客根目录[Blogroot]下打开终端，运行以下指令

  # 卸载原版电子钟
  npm uninstall hexo-butterfly-clock
  # 卸载anzhiyu的插件版电子钟
  npm uninstall hexo-butterfly-clock-anzhiyu --save

2. 安装本插件,在博客根目录[Blogroot]下打开终端，运行以下指令：

  # 安装插件
  npm install hexo-butterfly-clock-anzhiyu-yang --save

3. 添加配置信息，以下为写法示例。 在站点配置文件 _config.yml 或者主题配置文件 _config.butterfly.yml 中添加：

      # electric_clock
      # see https://anzhiy.cn/posts/fc18.html
      electric_clock:
        enable: true # 开关
        priority: 5 #过滤器优先权
        enable_page: all # 应用页面
        exclude:
          # - /posts/
          # - /about/
        layout: # 挂载容器类型
          type: class
          name: sticky_layout
          index: 0
        loading: https://cdn.cbd.int/hexo-butterfly-clock-anzhiyu/lib/loading.gif #加载动画自定义
        clock_css: https://cdn.cbd.int/hexo-butterfly-clock-anzhiyu/lib/clock.min.css
        clock_js: https://cdn.cbd.int/hexo-butterfly-clock-anzhiyu/lib/clock.js
        qweather_key:  # 和风天气key
        gaud_map_key:  # 高得地图web服务key
        default_rectangle: false # 开启后将一直显示rectangle位置的天气，否则将获取访问者的地理位置与天气
        rectangle: 112.6534116,27.96920845 # 获取访问者位置失败时会显示该位置的天气，同时该位置为开启default_rectangle后的位置

   其中qweather_key和gaud_map_key最好自己去申请对应的 API key，默认使用原作者的，可能会被限制，不保证可靠性。

   qweather_key申请地址: https://id.qweather.com/#/login

   1. 登录后进入控制台
   2. 创建应用
   3. 填写应用名称和key名称随意
   4. 选择WebApi

   5. 复制key

      gaud_map_key 申请地址: https://lbs.amap.com/

   6. 登录后进入控制台

   7. 创建应用，名称随意，类型选其他
   8. 点击添加, key名称随意，服务平台选择Web服务,点击提交
   9. 复制key

4. 参数释义

   参数	备选值/类型	释义
   priority	number	【可选】过滤器优先级，数值越小，执行越早，默认为10，选填
   enable	true/false	【必选】控制开关
   enable_page	path	【可选】填写想要应用的页面,如根目录就填'/',分类页面就填'/categories/'。若要应用于所有页面，就填all，默认为all
   exclude	path	【可选】填写想要屏蔽的页面，可以多个。写法见示例。原理是将屏蔽项的内容逐个放到当前路径去匹配，若当前路径包含任一屏蔽项，则不会挂载。
   layout.type	id/class	【可选】挂载容器类型，填写id或class，不填则默认为id
   layout.name	text	【必选】挂载容器名称
   layout.index	0和正整数	【可选】前提是layout.type为class，因为同一页面可能有多个class，此项用来确认究竟排在第几个顺位
   loading	URL	【可选】电子钟加载动画的图片
   clock_css	URL	【可选】电子钟样式CDN资源
   clock_js	URL	【可选】电子钟执行脚本CDN资源
   qweather_key	【可选】和风天气key	【可选】和风天气 key（默认使用anzhiyu-c的）
   gaud_map_key	【可选】高得地图web服务key	【可选】高得地图 web 服务 key（默认使用anzhiyu-c的）
   default_rectangle	【可选】和风天气key	【可选】开启后将一直显示 rectangle 位置的天气，否则将获取访问者的地理位置与天气
   rectangle	【可选】高得地图web服务key	【可选】获取访问者位置失败时会显示该位置的天气，同时该位置为开启 default_rectangle 后的位置

截图