README_zh.md

hunoc

English

介绍

hunoc 是一个基于huno的一个响应式的Hexo主题.
许可协议:Mozilla 公共许可证 Version 2.0
为了满足一些需要,自己对huno进行了一些修改,算是第一个正经项目吧.
自娱自乐地Commit,Release,写更新日志,嘛,做人最重要的是开心.

项目状态

稳定版

测试版

huno版本: Commit-2693076 (2019-01-12)

主要特性

继承自huno的特性(会有一些不同)

• 响应式主题设计
• Mathjax数学公式支持
• Awesome_toc,一个为网页生成目录的小工具，也支持回到顶部的功能
• GitHub仓库控件
• 社交网站图标
• 独立的归档页面

新的特性

• 定制选项(custom)支持用额外的CSS自定义主题
• 支持在一些选项中使用HTML
• 透明外观
• 支持Vssue,Gitment,Gitalk三个基于Githun Issue的评论系统
• 更好的子目录支持,只需修改config.root
• 更灵活的主题选项,可以在多处配置

演示

查看

如何使用

方案1: 下载解压(推荐)

1. 打开最新稳定版发布页面
2. 下载 Source code(zip)
3. 解压至 <你的hexo路径>/themes/hunoc
4. 修改hexo的 _config.yml

   theme: hunoc

5. 如果有进一步的需要,编辑themes/hunoc/_config.yml,但建议将其中的选项复制到<你的hexo路径>/_config.yml中修改

方案2: 用Git克隆仓库

1. 启动 shell/cmd 进入你的hexo路径
2. 确保安装了git,然后执行:
   git clone git://github.com/someus/hunoc.git themes/hunoc
3. 修改 hexo的 _config.yml theme: hunoc
4. 如果有进一步的需要,编辑themes/hunoc/config.yml 但建议将其中的选项复制到[你的hexo路径]/config.yml 中修改

主题选项

所有的选项都可以在/themes/hunoc/_config.yml,/_config.yml,/source/*.md中使用,有特殊注明的除外
请以/theme/_config.yml中的说明为准

hc_post_comments: [String]/false
    false: 无评论功能  
    vssue: 使用vssue(需在hc_github_config进一步设置)
    gitment: 使用gitment(需在hc_github_config进一步设置)
    gitalk: 使用gitalk(需在hc_github_config进一步设置)
    manual: 在comments.ejs中手动设置  
hc_github_config:
  type:
  owner:
  repo:
  client_id:
  client_secret:
  admin:
  vssue_theme_color:
hc_footer_info:[String]
    显示在页脚中的信息
    如:© YourName 2016-2018  
    支持html
hc_custom: [String]/false
    false: 无定制
    huno: huno风格(并不)
    其他: /themes/hunoc/source/css/custom_uno/ 中的css文件
hc_panel_addition: [String]/false
    false : 无
    [String] : 背景音乐或广告等等,支持HTML  

背景图片

位于 source/images/background-cover.jpg
若要修改成CDN中的某个图片,请参阅 huno说明

归档页面

归档页面会显示分类、标签云以及基于日期的归档
在hexo的配置文件或hunoc的配置文件_config.yml中:

hc_menu:
  首页: /#blog
  关于: /about
  归档: /archive

创建新的page:

    $ hexo new page archive
    $ cd source/archive
    $ index.md

内容修改为:

title: 归档
layout: page-archive

hexo 默认有一个/archives，如果您认为归档页面的url（/archive）和这个冲突，可以选更加合适的名称
请参阅 huno说明

社交网站图标

social:
    github: tom
    500px: tom

由于版权问题存疑,hunoc移除了huno中的China Social Icon
请参阅 huno说明

Foundation Icons v 3.0
Made by ZURB 2013
Official Site
MIT License

网站分析

hc_site_analytics: [your analytics code]

关于huno

作者: letiantian
许可协议: 知识共享-署名 4.0 国际许可协议
该主题基于uno

关于uno

作者: daleanthony
许可协议: 知识共享-署名 4.0 国际许可协议

兼容性

Hexo Theme Unit Test: 通过
Hexo Theme Checklist: 符合:13 部分支持:2 不支持:2 未知:1

在以下环境测试基本正常:

• hexo: 3.9
• node: 10~12
• 浏览器: Firefox/Chrome/Edge/IE 10,11
• 插件: hexo-all-minifier,hexo-deploy-git

建议

• 使用hexo-all-minifier插件
• 建议使用vssue,gitalk
• 注意,本主题暂不遵循语义版本,不能有规律地更新

其他引用项目

项目	作者	许可协议
Vssue	meteorlxy	MIT
gitalk	booxood等	MIT
gitment	imsun	MIT
JQueryRotate	wilq32等	MIT
JQuery	JS Foundation等	jquery.org/license

图片来源

感谢诸位!

图片	作者	许可协议
Red and blue sky – end of day	Peter Janzen	CC0公有领域(CC0 1.0 Universal Public Domain Dedication)
Picography lake view bridge	Gratisography	CC0公有领域(CC0 1.0 Universal Public Domain Dedication)