From 76959ed3492a905ed252966cd96b44ab39b86bf0 Mon Sep 17 00:00:00 2001 From: XPoet Date: Wed, 8 Apr 2020 17:30:05 +0800 Subject: [PATCH] chore(release): v1.0.0 --- README.md | 157 ++++++++++++++++-- _config.yml | 9 +- .../layout/common/highlight/highlight.styl | 23 ++- source/css/layout/common/markdown.styl | 4 +- source/css/layout/common/variables.styl | 6 +- 5 files changed, 162 insertions(+), 37 deletions(-) diff --git a/README.md b/README.md index d4e76ae..794fde5 100644 --- a/README.md +++ b/README.md @@ -1,26 +1,151 @@ -# ILS +# hexo-theme-ils -> ILS(I Like Simple 我喜欢简约) +[![Github Author](https://img.shields.io/badge/author-XPoet-orange.svg)](https://github.com/XPoet) +[![Github Release](https://img.shields.io/github/release/XPoet/hexo-theme-ils.svg)](https://github.com/XPoet/hexo-theme-ils/releases) +[![Github License](https://img.shields.io/github/license/XPoet/hexo-theme-ils.svg)](https://github.com/XPoet/hexo-theme-ils/blob/master/LICENSE) -A simple and beautiful theme for Hexo. +**一款简约大气的Hexo主题。** +**A simple and atmospheric theme for Hexo.** -- [Preview](https://xpoet.cn) +> 关于主题名称 __"ILS"__： 在主题开发之初，作者想到的几个名字都被用了，词穷，后来将名字取自 **"I Like Simple「我喜欢简约」"** 首字母。 +> 如果你也喜欢简约大气风格的主题，一起来折腾吧~ -## Installation +- [Preview 预览](https://xpoet.cn) -### Install +## Features 功能特性 +- [x] 恰到好处的留白，简约大气； +- [x] 响应式设计，适配多种终端； +- [x] 日间/夜间模式自由切换； +- [x] 多种代码高亮方案； +- [x] 内置多语言（目前仅支持中英文）； +- [x] 内置评论插件； +- [x] 支持全站文章搜索； +- [x] 网站访问统计和文章阅读统计； +- [x] 代码简洁高效，无jQuery； +- [x] 配置简单，配置项均有详细注释； -``` bash -$ git clone --depath=1 git@github.com:XPoet/hexo-theme-ils.git themes/ils +## Get start 快速开始 + +### Install 安装 +- 使用 Git SSH + ``` bash + git clone --depath=1 git@github.com:XPoet/hexo-theme-ils.git themes/ils + ``` +- 下载主题 release 版本 + 请优先下载 [最新 release 版本](https://github.com/XPoet/hexo-theme-ils/releases)，master 分支无法保证稳定。 + 下载后解压到 Hexo 博客目录下 themes 文件夹里面并重命名为 `ils`。 + +### Enable 启用 +Modify `theme` setting in `_config.yml` to `ils`. +找到博客目录下的 `_config.yml` 文件，将 `theme` 设置为 `ils` 。 + +### Update 更新 +- 使用 Git SSH + ``` bash + cd themes/ils + git pull + ``` +- 下载[主题最新 release 版本](https://github.com/XPoet/hexo-theme-ils/releases) + 下载后解压到 Hexo 博客目录下 themes 文件夹里面并重命名为 `ils`。 + + +## Configuration 配置 +```yml +# theme basic info +# 该主题的基本信息，此处不用改动。 +theme_info: + name: ILS + version: 1.0.0 + author: XPoet + repository: https://github.com/XPoet/hexo-theme-ils + +# navigation menu +# 导航菜单，如需增加，请按下面格式填写。 +menu: + Home: / + Archives: /archives + About: /about + +# RSS +# RSS 订阅，当前版本未实现（欢迎RP）。 +rss: /atom.xml + +# favicon +# 网站 icon 图标，换成自己的图片即可。 +favicon: images/favicon.png + +# comment plugin +# 评论插件， +# 当前版本只内置只支持 Valine，欢迎参与贡献代码，增加其他评论插件。 +comments: + # Valine. + # more info please open https://github.com/xCss/Valine + # 如何使用 Valine, 请前往 https://github.com/xCss/Valine + valine: + enable: false + appid: # your leancloud application appid + appkey: # your leancloud application appkey + notify: false # mail notifier, https://github.com/xCss/Valine/wiki + verify: false # Verification code + placeholder: 填写昵称和邮箱才能收到回复通知哦~ + +# Show PV/UV of the website/page with busuanzi. +# 不蒜子计数插件 +# Get more information on http://ibruce.info/2015/04/04/busuanzi/ +busuanzi_count: + # count values only if the other configs are false + enable: false + + # custom uv span for the whole site + # 网站访问人数统计 + site_uv: false + + # custom pv span for the whole site + # 网站总访问量统计 + site_pv: false + + # custom pv span for one page only + # 文章页面阅读次数统计 + page_pv: false + +# Local Search +# Dependencies: https://github.com/theme-next/hexo-generator-searchdb +# 全站文章搜索功能，默认不开启，如需开启，请先在 Hexo 博客目录下安装 hexo-generator-searchdb +# 详情请参考：https://github.com/theme-next/hexo-generator-searchdb +local_search: + enable: fales + # If auto, trigger search by changing input. + # If manual, trigger search by pressing enter key or search button. + trigger: auto + # Show top n results per article, show all results by setting to -1 + top_n_per_article: 1 + # Unescape html strings to the readable one. + unescape: false + # Preload the search data when the page loads. + preload: false ``` -### Enable +## Add page 添加页面 +**Hexo 初始化没有 about、links、tag、category 等页面，需要自己手动创建。** +例如创建「关于」页面： +1. 在 Hexo 博客目录下执行命令 + ```bash + hexo new page about + ``` +2. 创建成功后，编辑博客目录下 `/source/about/index.md`，添加 `layout: about` 属性。 + 修改后的文件示例如下： + ```bash + title: about + date: 2020-04-08 16:29:00 + layout: about + --- + + 这里写正文，支持 Markdown, HTML + ``` + -Modify `theme` setting in `_config.yml` to `ils`. +## Feedback 反馈 +在使用主题过程中，如果遇到问题，请仔细阅读文档，或者提 `issue`。 -### Update - -``` bash -cd themes/ils -git pull -``` \ No newline at end of file +## Licence 许可证 +[MIT](https://github.com/XPoet/hexo-theme-ils/blob/master/LICENSE) Copyright (c) 2020 XPoet \ No newline at end of file diff --git a/_config.yml b/_config.yml index 07ad59a..8e4d03a 100644 --- a/_config.yml +++ b/_config.yml @@ -1,6 +1,6 @@ # theme basic info theme_info: - name: ILS-X + name: ILS version: 1.0.0 author: XPoet repository: https://github.com/XPoet/hexo-theme-ils @@ -10,6 +10,8 @@ menu: Home: / Archives: /archives About: /about + # Links: /links + # ... # RSS rss: /atom.xml @@ -17,10 +19,9 @@ rss: /atom.xml # favicon favicon: images/favicon.png -# comment system +# comment plugin comments: # Valine. - # You can get your appid and appkey from https://leancloud.cn # more info please open https://github.com/xCss/Valine valine: enable: false @@ -28,7 +29,7 @@ comments: appkey: # your leancloud application appkey notify: false # mail notifier, https://github.com/xCss/Valine/wiki verify: false # Verification code - placeholder: 填写昵称和邮箱才能收到回复通知哦~ + placeholder: your placeholder # Show PV/UV of the website/page with busuanzi. # Get more information on http://ibruce.info/2015/04/04/busuanzi/ diff --git a/source/css/layout/common/highlight/highlight.styl b/source/css/layout/common/highlight/highlight.styl index beef517..2f0aad9 100644 --- a/source/css/layout/common/highlight/highlight.styl +++ b/source/css/layout/common/highlight/highlight.styl @@ -10,19 +10,18 @@ $code-block { line-height: 1.5em; transition: all 0.5s ease; - //&::-webkit-scrollbar { - // height: 8px; - //} - // - //&::-webkit-scrollbar-thumb { - // border-radius: 5px; - // background: rgba(0, 0, 0, 0.2) - //} - // - //&::-webkit-scrollbar-track { - // background: transparent; - //} + &::-webkit-scrollbar { + height: 6px; + } + &::-webkit-scrollbar-thumb { + border-radius: 5px; + background: rgba(0, 0, 0, 0.3) + } + + &::-webkit-scrollbar-track { + background: transparent; + } } diff --git a/source/css/layout/common/markdown.styl b/source/css/layout/common/markdown.styl index f4fb115..4f9a102 100644 --- a/source/css/layout/common/markdown.styl +++ b/source/css/layout/common/markdown.styl @@ -22,8 +22,8 @@ } ul > li, ol > li { - margin-left: 35px; - line-height: 1.8em; + margin-left: 16px; + line-height: 2em; } ul { diff --git a/source/css/layout/common/variables.styl b/source/css/layout/common/variables.styl index ad23b4b..4fffc9c 100644 --- a/source/css/layout/common/variables.styl +++ b/source/css/layout/common/variables.styl @@ -7,7 +7,7 @@ // =============================== $header-height = 100px; // 头部默认高度 $header-shrink-height = 60px; // 头部收缩高度 -$main-content-width = 66%; // 中间内容区域宽度 +$main-content-width = 60%; // 中间内容区域宽度 $media-max-width = 760px; // 媒体查询最大宽度 // =============================== @@ -25,8 +25,8 @@ $z-index-6 = 1006; // color // =============================== // normal mode color -$primary-color = #62bbbd; // 主题颜色 -$background-color = #fcfcfc; // 背景颜色 +$primary-color = #1864bd; // 主题颜色 +$background-color = #fdfdfd; // 背景颜色 $normal-text-color = #515061; // 通用文本颜色（默认字体颜色） $first-text-color = darken($normal-text-color, 20%); // 第一文本颜色 $second-text-color = darken($normal-text-color, 10%); // 第二文本颜色