https://github.com/kinggozhang/hexo-theme-ace
A Hexo Theme:ACE
https://github.com/kinggozhang/hexo-theme-ace
Last synced: about 1 month ago
JSON representation
A Hexo Theme:ACE
- Host: GitHub
- URL: https://github.com/kinggozhang/hexo-theme-ace
- Owner: kinggozhang
- License: apache-2.0
- Created: 2019-04-18T13:21:54.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2019-09-08T08:39:49.000Z (over 5 years ago)
- Last Synced: 2024-05-20T09:22:20.884Z (11 months ago)
- Language: CSS
- Size: 1.04 MB
- Stars: 48
- Watchers: 3
- Forks: 7
- Open Issues: 9
-
Metadata Files:
- Readme: README-en.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hexo-themes - kinggozhang/hexo-theme-ace
README
> This [ACE theme](https://github.com/kinggozhang/hexo-theme-ace) created by kinggozhang based on theme:huweihuang and many other repos.
> please check thanks and references for more details.
# New feature
1. Fancy nav bar
2. Support slide show for index page.
3. Remove image bg of header
4. Add ribbon/particle bg to header.
5. Support sticky post.
6. multi lang support
7. support Valine comment system.
# Live Demo
Live Demo : [www.sumoon.com](http://www.sumoon.com/)
snapshots:
# Copyright Notice
You are free to use this theme, but please keep copyright info in footer.
#Friend link
you can manage your own friend links
```yml
friends: [
{
title: "ACE theme",
href: "http://www.sumoon.com"
},
{
title: "your friend link",
href: "https://##"
}
]
```
If you would like add your blog into ACE theme
please fork this project, and modify _config.yml, append your site into friends,and create pull request.
# Install Hexo
```shell
npm install hexo-cli -g
```
Access for more info
# Theme Usage
## Init
```bash
cd your_blog_dir
git clone https://github.com/kinggozhang/hexo-theme-ace.git themes/ace
```
## Modify blog theme
Change theme with 'ace'
```yml
## Themes: https://hexo.io/themes/
theme: ace
```
## Modify theme config
Modify `themes/ace/_config.yml` file with your own info.
Especially the section:
## header decoration
```yml
slideshow: true //support 3 slides, img/slideshow/slider1/2/3
ribban_bg: false //A beatiful ribban bg
particle_bg: true //A dynamic particle bg
```
## Sticky post
You have to specify a sticky tag, then tag it to post.
```yml
#sticky post tag
sticky_tag: "Sticky"
```
### Sidebar settings
Copy your avatar image to `/img/` and modify the `_config.yml`:
```yml
sidebar: true # whether or not using Sidebar.
sidebar-about-description: ""
sidebar-avatar: img/
```
and activate your personal widget you like
```yml
widgets: # here are widget you can use, you can comment out
- featured-tags
- short-about
- recent-posts
- friends-blog
- archive
- category
```
if you want to add sidebar widget, please add at `layout/_widget`.
### Signature Setup
Copy your signature image to `/img/signature` and modify the `_config.yml`:
```yml
signature: true # show signature
signature-img: img/signature/
```
### Go to top icon Setup
you can change to your own icon at `css/image`.
### Post tag
You can decide to show post tags or not.
```yml
home_posts_tag: true
```
### Markdown render
My markdown render engine plugin is [hexo-renderer-markdown-it](https://github.com/celsomiranda/hexo-renderer-markdown-it).
```yml
# Markdown-it config
## Docs: https://github.com/celsomiranda/hexo-renderer-markdown-it/wiki
markdown:
render:
html: true
xhtmlOut: false
breaks: true
linkify: true
typographer: true
quotes: '“”‘’'
```
and if you want to change the header anchor 'ℬ', you can go to `layout/post.ejs` to change it.
```javascript
async("https://cdn.bootcss.com/anchor-js/1.1.1/anchor.min.js",function(){
anchors.options = {
visible: 'hover',
placement: 'left',
icon: ℬ // this is the header anchor "unicode" icon
};
```
## Hexo Basics
Some hexo command:
```bash
hexo new post "" # you can change post to another layout if you want
hexo clean && hexo generate # generate the static file
hexo server # run hexo in local environment
hexo deploy # hexo will push the static files automatically into the specific branch(gh-pages) of your repo!
```
# Have fun ^_^
Please Star this Project if you like it! Follow would also be appreciated!
Peace!
# Thanks and references
-
-
-