README-en.md · xiao-gy/hexo-theme-Eternal night

> 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:
![Particle bg](snapshots/snapshot_particle.png "snapshot_particle_bg")
![Ribbon bg](snapshots/snapshot_ribbon_en.png "snapshot_ribbon_bg")
# 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 <https://hexo.io> 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 `<root>/img/` and modify the `_config.yml`:
```yml
sidebar: true    # whether or not using Sidebar.
sidebar-about-description: "<your description>"
sidebar-avatar: img/<your avatar path>
```
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 `<root>/img/signature` and modify the `_config.yml`:
```yml
signature: true   # show signature
signature-img: img/signature/<your-signature-ID>
```
### 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 "<post name>" # 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 <a class="github-button" href="https://github.com/kinggozhang/hexo-theme-sumoon" data-icon="octicon-star" aria-label="Star kinggozhang/hexo-theme-sumoon on GitHub">Star</a> this Project if you like it! <a class="github-button" href="https://github.com/kinggozhang" aria-label="Follow @kinggozhang on GitHub">Follow</a> would also be appreciated!
Peace!
# Thanks and references
 - <https://github.com/huweihuang/hexo-theme-huweihuang>
 - <https://github.com/YenYuHsuan/hexo-theme-beantech>
 - <https://github.com/VincentGarreau/particles.js>

xiao-gy/hexo-theme-Eternal night

简介

发行版

贡献者

近期动态

xiao-gy/hexo-theme-Eternal night .gitee-modal { width: 500px !important; }

简介

发行版

开源评估指数源自 OSS-Compass 评估体系，评估体系围绕以下三个维度对项目展开评估：

贡献者

近期动态

搜索帮助

xiao-gy/hexo-theme-Eternal night