hunoc

中文

Introduction

hunoc is a hexo theme based on huno.
License: Mozilla Public License Version 2.0
In order to meet some needs,I have made some changes on hunoc. It may be the first serious project for me.
I like commiting,releasing,writing update log.Well,the most important thing is to be happy.

Project Status

This project is in FROZEN period

Stable

Dev

huno version: Commit-2693076 (2019-01-12)

Main Features

From huno

• A responsible theme
• Mathjax Math formula support
• Awesome_toc.Automaticly generate a index for your pages
• GitHub Repo Widget support
• Social icons
• Indepedent archive pages

New

• The "hc_custom" option to custom hunoc with your own css
• Translucent looks
• Enable to use HTML Code in some options
• Support Vssue,Gitment,Gitalk , which are based on the issue system of the Github
• Better child path support.You only need change the config.root option
• More flexibile theme options,which can be used in many places

Demo

View

How to use

Method 1: Download and Unzip(Recommended)

1. Open the latest stable release page
2. Download Source code(zip)
3. Unzip it to <Your hexo path>/themes/hunoc
4. Edit hexo's _config.yml

   theme: hunoc

5. If your'd like to config more about this theme,edit themes/hunoc/_config.yml
   but you'd better copy the option to you hexo's _config.yml instead of hunoc-theme's

Method 2: Git Clone

1. Start your shell/cmd and enter your hexo path
2. make sure your installed git,and run:
   git clone git://github.com/someus/hunoc.git themes/hunoc
3. Edit hexo's _config.yml
   theme: hunoc
4. If your'd like to config more about this theme,edit themes/hunoc/_config.yml,but you'd better copy the options to your hexo's config.yml instead of theme's

Theme Options

Every option is available in these files excluding ones with explanation.And you can use html in most of them.
Please read the instruction in /_config.yml for detailed and correct infomation.

• /themes/hunoc/_config.yml
• /_config.yml
• /source/_post/*.md

hc_post_comments: [String]/false
    false: no comments  
    gitment: use gitment(must complete the hc_github_config list)
    gitalk: use gitalk(must complete the hc_github_config list)
    vssue: use vssue(must complete the hc_github_config list)
    manual: you will config manually in comments.ejs  
hc_github_config:
    type:
    owner:
    repo:
    client_id:
    client_secret:
    admin:
    vssue_theme_color:
hc_footer_info:[String]
      Information printed on the footer of a page
      only available in themes/_config.yml
hc_custom: [String]/false
    false: None custom
    huno: Original huno style(not very original)
    (others): file name in /themes/hunoc/source/css/custom_uno/  
hc_panel_addition: [String]/false
    false : No
    [String] : HTML code for your bgm or ads  

Background picture

Just put your picture as source/images/background-cover.jpg
If you want to use a picture in CDN,please modify source/css/uno.css
For more infomation,read huno readme

Archive

1. Execute:
   hexo new page archive

2. Edit source/archive/index.md

    ---
    title: Archive
    layout: page-archive
    ---

For more infomation,read huno readme

Social Icon

For example:

social:
    github: YourName
    500px: YourName

Do not need to edit social.yml
For more infomation,read _config.yml

Foundation Icons v 3.0
Author: ZURB 2013
Official Site: http://zurb.com/playground/foundation-icon-fonts-3
License: MIT

Site analytics

hc_site_analytics: (your analytics code from Google analysis,CNZZ etc.)

Or just paste it in the bottom of layout/_scripts/site-analytics.ejs

About huno and uno

huno is a Hexo theme，based on uno
Author: letiantian
License: Creative Commons Attribution 4.0 International

uno
Author: daleanthony
License: Creative Commons Attribution 4.0 International

Compatibility

Hexo Theme Unit Test: PASSED
Hexo Theme Checklist: YES:13 PARTLY:2 NO:2 UNKNOWN:1

It's generally tested on:

• hexo: 3.9
• node: 10~12
• Browsers: Firefox/Chrome/Edge/IE 10 11
• Plugins: hexo-all-minifier,hexo-deploy-git

Suggestions

• Use hexo-all-minifier(Plugin)
• If you want to keep up-to-date,you need to know:
  This theme DO NOT obey Semantic Versioning now
  This theme DO NOT update regularly
• Vssue and gitalk are recommended.

Other cited projects

Project	Author	License
Vssue	meteorlxy	MIT
gitalk	booxood and others	MIT
gitment	imsun	MIT
JQueryRotate	wilq32 and others	MIT
JQuery	JS Foundation and other contributors	jquery.org/license

Picture Authors

Thank these generous guys!

Picture	Author	License
Red and blue sky – end of day	Peter Janzen	CC0 1.0 Universal Public Domain Dedication
Picography lake view bridge	Gratisography	CC0 1.0 Universal Public Domain Dedication