Skip to content

Commit

Permalink
Merge branch 'main' of github.com:Stan370/stan370.github.io
Browse files Browse the repository at this point in the history
  • Loading branch information
Stan370 committed Nov 7, 2024
2 parents bce8045 + 6fe2923 commit 7c48e2c
Show file tree
Hide file tree
Showing 3 changed files with 175 additions and 17 deletions.
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
MIT License

Copyright (c) 2022 luuuuuuuuuu
Copyright (c) 2024/11/03 - Stan. All rights reserved.

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
110 changes: 110 additions & 0 deletions README.en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,110 @@
# [stanBlog](https://stan370.github.io/)
**StanBlog** is a blog theme built with Hexo and the EJS template engine, featuring material design and responsive layouts. This comprehensive, visually appealing personal tech blog theme supports Markdown and HTML syntax, offers built-in RSS and Atom feeds, customizable themes and layouts, code highlighting, and syntax checking, as well as mobile device access.

A beautiful Hexo blog theme with material design and responsive design.

<img width="878" alt="image" src="https://github.com/Stan370/stan370.github.io/assets/56168768/bf7c495d-a51c-4c2b-a454-7a66aa036b86">

> - 🔁 Project synced at: [Github](https://github.com/Stan370/stan370.github.io/)
> - 📖 Ebook reader at: [Github Pages](https://stan370.github.io//)
## Features

* Uses Hexo as the blogging framework
* Uses EJS as the template engine
* Supports Markdown and HTML syntax
* Built-in RSS and Atom feed support
* Customizable themes and layouts
* Code highlighting and syntax checking
* Mobile device support
* Clean, visually appealing design with easy-to-read article pages
* Supports Material Design - [Material Design](https://material.io/)
* Responsive layout for desktop, tablet, and mobile
* Carousel articles on the homepage with a daily changing banner image
* Waterfall layout for the article list (24 default images displayed if no feature image is provided)
* Timeline layout for the archive page
* Tag page displayed as a word cloud, category page displayed as a radar chart
* Rich "About" page (includes About Me, article stats, my projects, my skills, photo album, etc.)
* Customizable data for the Links page
* Option to add copyright information when copying article content
* Option for password protection on articles

## Project Structure
```
├── _config.yml
├── package.json
├── scaffolds
│ ├── draft.md
│ ├── page.md
│ └── post.md
├── scripts
│ ├── deploy.sh
│ └── server.sh
├── source
│ ├── _drafts
│ ├── _posts
│ └── index.ejs
├── themes
│ └── ejs-theme
│ ├── _config.yml
│ ├── layout.ejs
│ ├── index.ejs
│ └── partials
│ ├── footer.ejs
│ ├── header.ejs
│ └── sidebar.ejs
└── yarn.lock
```

## Fork Guide

After forking this project, you'll need to complete a few steps to set up your own blog page.

1. **Set the correct project name and branch.**

According to GitHub Pages guidelines, a project named `username.github.io` on the master branch or a project with a different name on the gh-pages branch can automatically generate a GitHub Pages page.

2. **Modify the domain.**

If you want to bind a custom domain, modify the content of the CNAME file and follow [GitHub Pages Custom Domain Configuration](https://docs.github.com/pages/configuring-a-custom-domain-for-your-github-pages-site). If you don't need a custom domain, delete the CNAME file.

3. **Edit the configuration.**

The site configuration is primarily in the `_config.yml` file. Update the personal information fields, such as `url`, `title`, `subtitle`, and any third-party comment module settings, as needed. Use a CDN such as JsDelivr to accelerate file loading from GitHub.

4. **Remove my posts and images.**

You can delete all content in the following folders, except for the `template.md` file, and add your content:

* The `_posts` folder contains my published blog posts.
* The `_drafts` folder contains my unpublished drafts.
* The `_wiki` folder contains my published wiki pages.
* The `images` folder contains images used in articles and pages.

5. **Update the "About" page.**

The `pages/about.md` file corresponds to the "About" page, which contains personal information. Update it with your details, including `skills.yml` and `social.yml` in the `_data` directory.

6. **Test Locally and Deploy**

To deploy, choose a method such as GitHub Pages or Vercel. Here's a quick setup guide for GitHub Pages:

```
npm install hexo-deployer-git --save
Configure deployment in _config.yml:
deploy:
type: git
repo: <repository url>
branch: gh-pages
Generate and Deploy:
hexo generate
hexo deploy
```

## Acknowledgments

This theme is based on [BlinkFox](http://blinkfox.com/) with modifications—thank you!

The longer a piece of code is intended to last, the cleaner it should be. Temporary code, like quick scripts, can be less strict. Conversely, only clean code can achieve exceptional longevity.
80 changes: 64 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
# [stanBlog](https://stan370.github.io/)
A beautiful hexo blog theme with material design and responsive design with reference to BlinkFox.
StanBlog是一个基于Hexo和EJS模板引擎的博客主题,具有材料设计和响应式设计的特点。它是一个全面、美观的个人技术博客主题,支持 Markdown 和 HTML 语法,自带 RSS 和 Atom 订阅功能,支持自定义主题和布局,支持代码高亮和语法检查,支持移动设备访问。
A beautiful hexo blog theme with material design and responsive design.

<img width="878" alt="image" src="https://github.com/Stan370/stan370.github.io/assets/56168768/bf7c495d-a51c-4c2b-a454-7a66aa036b86">

Expand All @@ -11,21 +12,51 @@ A beautiful hexo blog theme with material design and responsive design with refe
## Features

- Simple and beautiful, and post is Beautiful and readable.
- [Material Design](https://material.io/).
- Responsive design, which can be displayed well on desktop, tablet, mobile phone, etc.
- Home page carousel posts and changing 'banner' picture dynamically everyday.
- Blog posts list with waterflow (There will be 24 images if the article doesn't have featured pictures).
- Archive page with timeline.
- Tags page of the **word cloud** and categories page of the **radar chart**
- Rich 'About' page (including about me, posts charts, my projects, my skills, gallery etc.)
- Friendly link page for customizable data
- Support post topping and rewards
- Support `MathJax`
- TOC
- Can be set append the copyright information when copying the content of the post
- Can be set to do password verification when reading a post

* 使用Hexo作为博客框架
* 使用EJS作为模板引擎
* 支持 Markdown 和 HTML 语法
* 自带 RSS 和 Atom 订阅功能
* 支持自定义主题和布局
* 支持代码高亮和语法检查
* 支持移动设备访问
* 简单美观的设计,文章页面美观易读
* 支持Material Design- [Material Design](https://material.io/).
* 响应式设计,适用于桌面、平板、手机等设备
* 首页轮播文章和每日动态更换的banner图片
* 文章列表采用瀑布流布局(如果文章没有特色图片,则显示24张图片)
* 归档页面采用时间轴布局
* 标签页面采用词云布局,分类页面采用雷达图布局
* 丰富的"关于"页面(包括关于我、文章统计、我的项目、我的技能、相册等)
* 友情链接页面支持自定义数据
* 可以设置在复制文章内容时追加版权信息
* 可以设置阅读文章时需要密码验证

## 项目结构
```
├── _config.yml
├── package.json
├── scaffolds
│ ├── draft.md
│ ├── page.md
│ └── post.md
├── scripts
│ ├── deploy.sh
│ └── server.sh
├── source
│ ├── _drafts
│ ├── _posts
│ └── index.ejs
├── themes
│ └── ejs-theme
│ ├── _config.yml
│ ├── layout.ejs
│ ├── index.ejs
│ └── partials
│ ├── footer.ejs
│ ├── header.ejs
│ └── sidebar.ejs
└── yarn.lock
```

## Fork 指南

Expand Down Expand Up @@ -57,6 +88,23 @@ Fork 本项目之后,还需要做一些事情才能让你的页面「正确」

pages/about.md 文件内容对应网站的「关于」页面,里面的内容多为个人相关,将它们替换成你自己的信息,包括 \_data 目录下的 skills.yml 和 social.yml 文件里的数据。

6. 进行本地部署测试
部署您的博客
您需要选择一种部署方法。Hexo支持GitHub Pages、Vercel等多种平台。以下是如何设置GitHub页面:
```
npm install hexo-deployer-git --save
Configure deployment in _config.yml:
deploy:
type: git
repo: <repository url>
branch: gh-pages
Generate and Deploy:
hexo generate
hexo deploy
```
Layouts and Partials: EJS themes often use .ejs files for layouts and partials. For example, layout.ejs might be the main layout file where you define the structure of your pages.

## 致谢

Expand Down

0 comments on commit 7c48e2c

Please sign in to comment.