Yelee主题说明





  Theme Yelee relies on Hexo-Theme-Yilia, thanks for the author Litten. Fix some bugs, change lots of styles, add several features. And then I made the theme. Yelee is mainly designed for fluent text reading. I change styles and add functions, meanwhile, try hard to keep this theme simple, stupid and clear. Theme DEMO: MOxFIVE’s Blog













Yelee 主题使用说明 [简中]




文档 GitHub 仓库

Installation

1
git clone https://github.com/MOxFIVE/hexo-theme-yelee.git themes/yelee

Change theme field in Hexo root’s _config.yml file.

1
theme: yelee

Update

1
2
cd themes/yelee
git pull

New Features DEMO

- En
1 Flexible table of contents
2 Transparent & Random background
3 Scrolling button
4 Copyright info.
5 Post navigation button
6 Site counter
7 i18n, multi-language
8 Local Site Search
9 Load Comment dynamically

Configuration

Internationalization

Use internationalization to present your site in different languages.

https://hexo.io/docs/internationalization.html

1
2
3
4
5
# Hexo Configuration
## Docs: http://hexo.io/docs/configuration.html
# Site
language: en
Available Languages
Code - - Contributor(s)
en English 英语 MOxFIVE
zh-Hans Chinese (Simplified) 大陆简体 MOxFIVE
zh-Hant-HK Chinese (Traditional) 港澳繁體 MOxFIVE
zh-Hant-TW Chinese (Traditional) 台灣正體 MOxFIVE

Any Contribution is Welcome!

0. Post Excerpt

There are two ways to show excerpt in homepage.

  • a:
1
2
3
4
5
6
title: Hello World
date: 2015-12-03 00:00:00
---
<Excerpt in index>
+ <!-- more -->
<The rest of contents>
  • b: description in Front-matter
1
2
3
4
5
title: Hello World
date: 2015-12-03 00:00:00
+ description: "Welcome to Hexo! This is your very first post."
---
<Contents>

Description only support plain text

Set the value of description with quotes to avoid unexpected error :

1. About Page:

cd to your hexo folder and run this code:

1
hexo new page about

2. Tags Cloud Page:

1
hexo new page tags

Post with several categories issue#4

3. Background image:

Find or change background images in folder:

/yelee/source/background/

Setting in themes/yelee/_config.yml:

background_image: 5

  • Default value is 5, free to modify the number

  • “5”: show 5 images form bg-1.jpg to bg-5.jpg in /yelee/source/background/

  • “0”: remove background image and use white-gray theme

Saving JPEGs for the Web: Setting Photoshop Up for Progressive JPEGs

Optimize images with PhotoShop (JPEG, Quality 0, Progressive)

4. Highlight Style:

Set inline_code to style highlight text & Chose a highlight theme for code block.

1
2
3
4
highlight_style:
#on: true
inline_code: 1
code_block: 1

Set on: true to enable this feature

highlight theme from https://github.com/chriskempson/tomorrow-theme

5. Comment:

Disqus, duoshuo and youyan is supported, enable ONE of them in theme’s “_config.yml”.

6. Table of Contents:

Remove toc and the button via putting toc: false before “—“ at [post].md.

Hide toc in default

Set toc: false in yelee/_config.yml.

(Set toc: true in front-matter to show it in certain post)

Hide this via putting original: false to post’s front-matter.

Hide Copyright info. in default

Set copyright: false in yelee/_config.yml.

(Set original: true in front-matter to show it in certain post)

8. 404 Page:

1
hexo new page 404

And then set permalink: /404 in /source/404/index.md front matter.

9. RSS Feed:

Install plugin: hexo-generator-feed

10. Sitemap for SEO:

Install plugin: hexo-generator-seo-friendly-sitemap

Baidu: hexo-generator-baidu-sitemap

11. Apple Touch icon:

The Path is /yelee/source/apple-touch-icon.png

Recommended size: 180*180

Welcome to Hexo! This is your very first post. Check documentation for more info. If you get any problems when using Hexo, you can find the answer in troubleshooting or you can ask me on GitHub.

Quick Start

Create a new post

1
$ hexo new "My New Post"

More info: Writing

Run server

1
$ hexo server

More info: Server

Generate static files

1
$ hexo generate

More info: Generating

Deploy to remote sites

1
$ hexo deploy

More info: Deployment

安装搜索插件

1
$ npm install hexo-generator-search --save
文章目录
  1. 1. Yelee 主题使用说明 [简中] 文档 GitHub 仓库
  2. 2. Installation
  3. 3. Update
  4. 4. New Features DEMO
  5. 5. Configuration
    1. 5.1. Internationalization
      1. 5.1.1. Available Languages
    2. 5.2. 0. Post Excerpt
    3. 5.3. 1. About Page:
    4. 5.4. 2. Tags Cloud Page:
    5. 5.5. 3. Background image:
    6. 5.6. 4. Highlight Style:
    7. 5.7. 5. Comment:
    8. 5.8. 6. Table of Contents:
    9. 5.9. 7. Copyright info.:
    10. 5.10. 8. 404 Page:
    11. 5.11. 9. RSS Feed:
    12. 5.12. 10. Sitemap for SEO:
    13. 5.13. 11. Apple Touch icon:
  • Quick Start
    1. 1. Create a new post
    2. 2. Run server
    3. 3. Generate static files
    4. 4. Deploy to remote sites
    5. 5. 安装搜索插件
  • ,