Skip to content

Latest commit

 

History

History
113 lines (87 loc) · 4.73 KB

README.md

File metadata and controls

113 lines (87 loc) · 4.73 KB
Raw

stanBlog

StanBlog是一个基于Hexo和EJS模板引擎的博客主题，具有材料设计和响应式设计的特点。它是一个全面、美观的个人技术博客主题，支持 Markdown 和 HTML 语法，自带 RSS 和 Atom 订阅功能，支持自定义主题和布局，支持代码高亮和语法检查，支持移动设备访问。 A beautiful hexo blog theme with material design and responsive design.

image

一个基于材料设计和响应式设计而成的全面、美观的Hexo主题的个人技术博客Blog

Features

  • 使用Hexo作为博客框架
  • 使用EJS作为模板引擎
  • 支持 Markdown 和 HTML 语法
  • 自带 RSS 和 Atom 订阅功能
  • 支持自定义主题和布局
  • 支持代码高亮和语法检查
  • 支持移动设备访问
  • 简单美观的设计，文章页面美观易读
  • 支持Material Design- Material Design.
  • 响应式设计，适用于桌面、平板、手机等设备
  • 首页轮播文章和每日动态更换的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 指南

Fork 本项目之后，还需要做一些事情才能让你的页面「正确」跑起来。

  1. 正确设置项目名称与分支。

    按照 GitHub Pages 的规定，名称为 username.github.io 的项目的 master 分支，或者其它名称的项目的 gh-pages 分支可以自动生成 GitHub Pages 页面。

  2. 修改域名。

    如果你需要绑定自己的域名，那么修改 CNAME 文件的内容，并参考 配置 GitHub Pages 站点的自定义域 做好配置；如果不需要绑定自己的域名，那么删掉 CNAME 文件。

  3. 修改配置。

    网站的配置基本都集中在 _config.yml 文件中，将其中与个人信息相关的部分替换成你自己的，比如网站的 url、title、subtitle 和第三方评论模块的配置等。 使用 JsDelivr图床 来加速 GitHub 上托管的文件

  4. 删除我的文章与图片。

    如下文件夹中除了 template.md 文件外，都可以全部删除，然后添加你自己的内容。

    • _posts 文件夹中是我已发布的博客文章。
    • _drafts 文件夹中是我尚未发布的博客文章。
    • _wiki 文件夹中是我已发布的 wiki 页面。
    • images 文件夹中是我的文章和页面里使用的图片。

  5. 修改「关于」页面。

    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.

致谢

本博客外观基于 BlinkFox 修改，感谢！

生命周期越长的代码，一定要写的越干净；临时使用代码，比如小脚本，就可以不讲究一些。反过来，也正是干净的代码才能成就超长的生命周期。