Skip to content

Latest commit

 

History

History
225 lines (143 loc) · 7.97 KB

README.md

File metadata and controls

225 lines (143 loc) · 7.97 KB

Yelee

Introduction 前言

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

M-Hexo-Blog Commits; hexo-theme-yelee Commits; 建站日志

本主题 Yelee 基于主题 Hexo-Theme-Yilia 修改而来,在此感谢原作者 Litten。修复了一些 bugs,改变了大量的样式,添加了不少特性。对原主题百般折腾后,发觉变动越来越大,索性就发布个新主题了,主题随我微博名叫 "Yelee" 。个人喜欢简洁的样式,重视内容的浏览,同时希望博客作为个人网站,能稍微凸显出博主个性。各种修改折腾大抵基于以上考虑。主题实际效果,请访问本人博客查看:MOxFIVE's Blog

QR

Installation 安装主题

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

Change theme field in Hexo root's _config.yml file. 修改 Hexo 根目录对应配置文件。

theme: yelee

Update 更新

cd themes/yelee
git pull

New Features 新特性

- Chs 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

feature

Configuration 配置

Internationalization | 语言切换

Use internationalization to present your site in different languages.

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

# 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:
title: Hello World
date: 2015-12-03 00:00:00
---
<Excerpt in index | 首页摘要> 
+ <!-- more -->
<The rest of contents | 余下全文>
  • b: description in Front-matter
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. | 通过 description 添加的摘要只能为纯文本。

Set the value of description with quotes to avoid unexpected error :. | description 的内容加双引号,可以避免一些程序错误,例如内容里包含英文冒号时。

1. About Page 关于我页面:

cd to your hexo folder and run this code:

使用以下代码添加一个新页面:

hexo new page about

2. Tags Cloud Page 标签云页面:

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,可按需修改

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

  • "5": 设置/yelee/source/background/文件夹中 bg-1.jpg 到 bg-5.jpg 这5张图片为背景

  • "0": remove background image and use white-gray theme | 取消网页背景图,使用淳朴的灰白主题

4. Highlight Style | 文本/代码高亮样式:

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

通过 inline_code 切换内置文本高亮样式,通过 code_block 切换内置代码高亮配色主题。

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 them in theme's "_config.yml". 主题目前支持 Disqus,多说 及 友言评论,请自行在主题配置中开启。

多说: http://duoshuo.com/create-site/ 登陆你的多说并创建站点,在 "domain" 中填入你设定的域名的前半部分。比如完整域名是: http://moxfive.duoshuo.com,只需填入 moxfive 即可。请设置好自己专属的多说,不要再群聊了。

6. Table of Contents 文章目录:

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

文章中默认显示目录和对应切换按钮,在文章 “---” 前输入 toc: false 关闭目录。

Hide toc in default | 默认不显示目录

Set toc: false in yelee/_config.yml.

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

7. Copyright info. 文章版权信息:

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

在文章顶部插入行 original: false 关闭文章版权声明框

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:

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

百度专用: hexo-generator-baidu-sitemap

11. Apple Touch icon 苹果图标:

替换路径: /yelee/source/apple-touch-icon.png

Recommended size: 180*180