https://github.com/smallyunet/hexo-theme-yinwang
Hexo blog theme, Wang Yin’s blog theme, yinwang.org style.
https://github.com/smallyunet/hexo-theme-yinwang
blog hexo-theme yinwang
Last synced: 3 months ago
JSON representation
Hexo blog theme, Wang Yin’s blog theme, yinwang.org style.
- Host: GitHub
- URL: https://github.com/smallyunet/hexo-theme-yinwang
- Owner: smallyunet
- Created: 2018-10-19T13:13:31.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-02-25T03:45:28.000Z (over 1 year ago)
- Last Synced: 2024-05-20T09:23:46.828Z (about 1 year ago)
- Topics: blog, hexo-theme, yinwang
- Language: CSS
- Homepage: https://www.smallyu.net
- Size: 227 KB
- Stars: 59
- Watchers: 2
- Forks: 10
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-hexo-themes - smallyunet/hexo-theme-yinwang
README
## Introduction
- **Project Motivation**: [Blog Theme Sharing Initiative (Draft)](https://en.smallyu.net/2021/02/11/Blog%20Theme%20Sharing%20Plan%20(Draft)/)
- **Design Inspired By**: [https://www.yinwang.org](http://www.yinwang.org/)
- **Theme Demo**: [https://en.smallyu.net](https://en.smallyu.net/)
## Installation
### Instructions
1. **Multi-language Support**
- Modify the `language` field in the blog project's `_config.yml` file.
- Available options: `en`, `zh-cn`.
2. **Custom Page Types**
- The `type: tags` field marks a page as a tag page.
- Supported types: `tags`, `categories`, `about`, `display`, `micro-blog`.
- These are specific to this theme and not documented in Hexo’s official documentation.
3. **Theme Configuration**
- Icons should be placed in the blog project’s `source` folder (not the theme’s `source`).
- Example: Place `favicon.svg` directly into `source/`.
- Configurable styles include post titles, tag displays, etc.
4. **Support & Contributions**
- For any issues or feature requests, use the issue tracker or submit a PR.
### Method 1: Direct Installation
1. **Navigate to the Blog Project Directory**
- If the blog project already exists, move into its directory.
- If not, initialize a new blog project:
```
hexo init blog
cd blog
npm i
```
2. **Copy the Theme**
- Place the theme into the `themes` directory.
3. **Install Required Dependencies**
```
npm i --save hexo-renderer-pug
npm i --save hexo-wordcount-sy
```
4. **Update Blog Configuration (`_config.yml`)**
- Set `theme: hexo-theme-yinwang`.
- Disable default highlighting: `highlight -> enable: false`.
- Customize `subtitle` for the blog’s title.
5. **Update Theme Configuration (`_config.yml`)**
- No required modifications, but ensure it doesn't conflict with project settings.
6. **Start the Preview Server**
```
hexo clean && hexo server
```
### Micro-blog Page
#### Configuration
- Specify the `issue_years`, GitHub username, repository name, and issue number in the theme configuration.
#### Create a New Page
Run:
```
hexo new page micro-blog
```
Modify `source/micro-blog/index.md`:
```
---
title: micro-blog
date: 2023-07-26 11:03:03
type: micro-blog
---
```
- Change the `title` if needed.
#### Updating Microblog
1. If `issue_years` is set in `_config.yml`, running `hexo generate` will automatically fetch content.
2. If `issue_years` is empty, manually update with:
```
hexo generate 2025
```
### Tags Page
#### Create a New Page
Run:
```
hexo new page tags
```
Modify `source/tags/index.md`:
```
---
title: Tags Cloud
date: 2022-08-30 18:07:20
type: tags
---
```
- Change `title` as needed.
### Method 2: Using the Template
Due to the complexity of installation, a pre-configured template is available:
**Template Repository**: [hexo-theme-yinwang-demo](https://github.com/smallyunet/hexo-theme-yinwang-demo)
**Features Included**:
- LaTeX rendering
- Micro-blog page
- Tag cloud page
- Categories page
- About page
- External links
### Theme Configuration Example
```
# Navigation Menu
menu:
Blog: ''
Micro-blog: micro-blog
Tag Cloud: tags
About: about
# Pagination
paginator: false
# Header Settings
header:
blank: false # Open links in a new tab
# Article List
list:
date: true # Show post dates
wordcount: true # Show word count
# Footer
footer:
display: false
href: ""
text: "© domain name"
# Post Settings
post:
title_h1: true
blank: false
backHome: false
backhome_right: false
backHome_hr: false
backHome_prefix: "↶ "
backHome_content: "Back to Home"
backHome_suffix: ""
show_tags: true
# Tag Cloud
tags:
all: true
# Micro-blog
github:
owner: smallyunet
repo: hexo-blog
micro_blogs:
- year: 2020
issue: 7
- year: 2021
issue: 10
- year: 2022
issue: 19
- year: 2023
issue: 29
issue_years: []
# Google Analytics
google_analysis:
enable: true
id: G-XXXXXXXXXXX
```
## Formula Rendering
Use this Hexo plugin for LaTeX support:
[hexo-filter-mathjax](https://github.com/next-theme/hexo-filter-mathjax)
No additional theme-level support required.