Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tangkunyin/hexo-theme-jsimple
Simple three columns theme for Hexo.Inspired by JianShu.com
https://github.com/tangkunyin/hexo-theme-jsimple
hexo jianshu jsimple theme
Last synced: 3 months ago
JSON representation
Simple three columns theme for Hexo.Inspired by JianShu.com
- Host: GitHub
- URL: https://github.com/tangkunyin/hexo-theme-jsimple
- Owner: tangkunyin
- License: mit
- Archived: true
- Created: 2015-09-15T14:31:15.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-04-03T12:09:59.000Z (10 months ago)
- Last Synced: 2024-05-20T09:18:35.399Z (9 months ago)
- Topics: hexo, jianshu, jsimple, theme
- Language: CSS
- Homepage: https://thomartisen.com
- Size: 22.9 MB
- Stars: 210
- Watchers: 9
- Forks: 64
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hexo-themes - tangkunyin/hexo-theme-jsimple
README
# JSimple
**JSimple is a responsive blog theme for Hexo which include day-night mode, local search, article view count etc. Inspired by JianShu that in the earliest**.
- [**☞ Preview Demo**](https://tomartisan.com) | [**For Chinese click here**](https://github.com/tangkunyin/hexo-theme-jsimple/blob/master/README.zhCN.md)
## Installation
1. Get it from GitHub
```shell
$ git clone https://github.com/tangkunyin/hexo-theme-jsimple themes/jsimple
```
2. Enable
Modify `theme` setting in `_config.yml` to `jsimple`.
To use of the local search, please add `hexo-generator-search`
3. Update
```shell
$ cd themes/jsimple
$ git pull
```
## Configurations
~~For a quick start, see my [Site backup](https://github.com/shuoit/blog) may be more convenient.~~
### site _config.yml
```yml
# choose your language. default Chinese
language:
- en
- zh-cn
# URL （Notice the permalink. Variable timestamp in post.md was added from hexo lib source）
## Please see the scripts in patch dir for more details
url: https://tomartisan.com
root: /
permalink: :category/:entitle-:timestamp.html
permalink_defaults:
lang: en
# Local search
search:
path: search.json
field: all
content: true
# Category alias
default_category: Tech
category_map:
Tech: tech-notes
tag_map:
hexo: hexo
```
### theme _config.yml
```yml
# Master information. At the other hand, the fields int post.md(author|avatar|authorLink|authorAbout|authorDesc）also have the same effects
## The priority in article config is higher than theme when you configuring at the same time. This used for multiplayer creation
webmaster:
name: Thomas Tang
avatar: /images/favicon.png
home: https://tomartisan.com
desc: Senior Chinglish writer and coder😁️️
# Decide whether the 'Content-Security-Policy = upgrade-insecure-requests' will be add in head tag.
csp_enable: false
# Article sort mode: -1(newer first)，1(older first). home_article_shown means paging count
home_page_sort: -1
home_article_shown: 10
# Article category navigation
menu:
Tech: tech-notes
Life: humanities
# Left navigation link. The faName is in FontAwesome styles.
left_nav_menus:
- uri: help
title: Help
faName: fa-question-circle
# Google AdSense. Support auto-ads and manual-unit
adsense:
enable: false// manual-unit-ads
auto: false// auto-ads
client_id:
archive_id:
tags_id:
post_left_id:
post_right_id:
post_bottom_id:
# Only support Disqus and Gitment so far.
comments:
enable: false
disqus_shortname:
gitment:
repo:
githubID:
ClientID:
ClientSecret:
lazy: true
```
### Other config
#### Search Module
Because of the search in previous version didn't work well. Such as highlight content, responsive problem in small screen.
So I replace it with `hexo-generator-search`. Thanks for [Next](https://github.com/theme-next/hexo-theme-next) theme.
There are two Chinese articles that told how to create local-search in hexo.
- [hexo-generator-search](https://github.com/wzpan/hexo-generator-search)
- [为 Hexo 博客创建本地搜索引擎](https://liam.page/2017/09/21/local-search-engine-in-Hexo-site/)
#### How sticky top and timestamp works
I have made some changes in hexo lib source code so that timestamp and sticky datasource could get when hexo-cli generating articles.
From version `0.0.7`, JSimple have been adding `patch` scripts. You need to excute `patch/run.sh` when `node_modules` was deleted.
You have to copy the `patch` dir into your site dir, otherwise sticky top and timestamp in permalink will not work.
#### AdSence
From version `0.0.7`. Google AdSense have been added. If you don't need this, just close it.
#### The other things about JSimple
If you don't understand Chinese. You can translate online by [Google Translate](https://translate.google.com/) 🤣🤣🤣
- [JSimple主题用户指南](https://tomartisan.com/groceries/jsimple-usage/)
- [在hexo博客中打造相对完美的URL](https://tomartisan.com/groceries/hexo-perfect-link/)
- [将Hexo博客url优化进行到底](https://tomartisan.com/groceries/permalink-optimize-hexo/)
- [Update-for-JSimple-in-Early2019](https://tomartisan.com/groceries/the-update-for-jsimple-in-early2019/)
## Browser support
## Contributing
All kinds of contributions (enhancements, new features, documentation & code improvements, issues & bugs reporting) are welcome.
Looking forward to your pull request.
> Special thanks to iTimeTraveler and jiangmuzi, who designed the theme [Hipaper](https://github.com/iTimeTraveler/hexo-theme-hipaper) and [JianShu](https://github.com/jiangmuzi/jianshu).
## License
JSimple is under the MIT license. See the [LICENSE](https://github.com/tangkunyin/hexo-theme-jsimple/blob/master/LICENSE) file for details.
## Thanks
[Hexo](https://hexo.io)
[Font Awesome](http://fontawesome.io)