# hexo-theme-bmw @GodBMW Finish 4.0.2

提示

特别鸣谢 BMW 作者 GodBMW (opens new window) 的支持!

BMW 主题地址 (opens new window)

# 快速开始

# 下载主题代码

$ hexo init your-blog
$ cd your-blog/
$ git clone git@github.com:dongyuanxin/theme-bmw.git themes/bmw

# 修改 Hexo 配置文件

修改 Hexo 的配置文件: your-blog/_config.yml :

# ... 

# 位置:大概位于 6 ~ 12 行
title: 您自己的网站标题
subtitle: # 不需要填写
description: 您自己的网站描述
keywords: 您自己的网站关键词
author: 您的姓名
language: zh-Hans # 目前仅支持中文
timezone: # 不需要填写

# 位置:大概位于 18 行
permalink: passages/:title/ # 如果您需要开启评论和文章统计,请修改此配置

# 位置:大概位于 76 行
theme: bmw # 启用 "bmw" 主题

# ...

# 修改主题配置文件

theme-bmw 的配置文件: your-blog/themes/bmw/_config.yml

提示

请注意,初始阶段您并不需要修改本主题的配置文件,请继续往下看。

# 启动博客

$ hexo s

Hexo 默认监听 4000 端口,此时,请使用 Chrome 等主流浏览器打开 http://localhost:4000/ (opens new window) ,查看博客。

# 更多页面

BMW 主题在 Hexo 默认界面的基础上,额外提供了标签归档、 分类归档、 关于介绍 和 友链界面。如果您想自定义更多页面,请看 “进阶内容”。

# 标签页面

生成标签页面:

$ hexo new page tags

修改标签归档页面的 Markdown 文件(文件路径: your-blog/source/tags/index.md )的内容:

---
title: tags
date: <!-- 自动生成,无需修改 -->
type: "tags"
categories:
tags:
---

查看标签归档页面:浏览器中打开 http://localhost:4000/tags/ (opens new window)

# 分类页面

生成分类页面:

$ hexo new page categories

修改分类归档页面的 Markdown 文件 (文件路径: your-blog/source/categories/index.md ) 的内容:

---
title: categories
date: <!-- 自动生成,无需修改 -->
type: "categories"
categories:
tags:
---

查看标签归档页面:浏览器中打开 http://localhost:4000/categories/ (opens new window)

# 关于页面

生成分类页面:

$ hexo new page about

修改关于页面的 Markdown 文件 (文件路径: your-blog/source/about/index.md ) 的内容:

---
title: about
date: <!-- 自动生成,无需修改 -->
type: "about"
categories:
tags:

这里编写您的网站 / 博客的相关介绍:联系方式、更新日志、甚至是您的个人简历。

BMW 主题会自动渲染此篇 Markdown,并且在 http://localhost:4000/about/ 展示给您!

查看关于页面:浏览器中打开 http://localhost:4000/about/ (opens new window)

# 友链界面

友链界面除了要编写相关 Markdown 文件,还需要更改 BMW 主题的配置文件,以更好地方式展示您的友链!

# 生成友链界面

$ hexo new page friends

修改友链页面的 Markdown 文件 (文件路径: your-blog/source/friends/index.md ) 的内容:

---
title: friends
date: <!-- 自动生成,无需修改 -->
type: "friends"
categories: 
tags:

这里编写您的友链声明,您可以陈述您的友链申请规则。

BMW 主题会自动渲染此篇 Markdown,并且在 http://localhost:4000/friends/ 展示给您!

# 展示更多友链

请打开 BMW 主题的配置文件: your-blog/themes/bmw/_config.yml 。您会发现在大概 46 行左右,有相关友情链接的配置:

# ...

# 友链详细信息
friends: # 这是一个数组, 每个元素是一个obj对象
  -
    nickname: 友链名称
    avatar: 友链头像
    site: 友链地址
    meta: 友链信息
  -
    nickname: 友链名称2
    avatar: 友链头像2
    site: 友链地址2
    meta: 友链信息2
  # ...

查看友链页面:浏览器中打开 http://localhost:4000/friends/ (opens new window)

# 进阶内容

theme-bmw 的评论系统采用的是 Valine ,并且提供了基于 Leancloud 的文章统计插件。您只需要按照以下步骤进行简单的配置,便可以提供更好的用户体验!

提示

如果您不想开启评论系统和文章统计插件,请跳过这一部分

# 配置 Leancloud

进入 leancloud.cn (opens new window)

1.png

注册账户,并且登录您的账户,然后在右上角进入 “控制台”。并且创建一个新应用。

2.png

配置默认即可(如下图所示),名字根据自己喜好取:

3.png

进入刚刚创建的应用,在左上方屏幕,点击创建新 Class 。接下来,我们就要为评论系统文章统计插件分别创建 2 个应用。

4.png

  1. 为评论系统开通 Class : 名称必须是 Comment , ACL 权限选择 “限制写入”,如下图 5.png
  2. 为文章统计插件开通 Class : 名称必须是 Timer , ACL 权限选择 “无限制”,如下图 6.png

# 3.2 配置密钥

进入左边导航栏 -> 设置 -> 应用 Key:

7.png

注意:请保存好您的密钥,关于安全问题,请阅读最后一部分!!!

Now,切回 BMW 主题的配置文件 your-blog/source/friends/index.md 。在大概 39~43 行,有一项关于 Leancloud 的配置,按照上图中的 appIdappKey ,复制并且粘贴到配置项即可。

# 开启评论系统

请先确保您按照前面步骤配置了 Leancloud ,并且正确修改了配置文件中的相关配置。

进入配置文件,在大概 42 行左右,请将 leancloud.comment 修改为 true

重启 Hexo 服务即可生效。

# 开启文章统计

请先确保您按照前面步骤配置了 Leancloud ,并且正确修改了配置文件中的相关配置。

进入配置文件,在大概 43 行左右,请将 leancloud.timer 修改为 true

重启 Hexo 服务即可生效。

# ⚠️警告⚠️

# 尊重原创

注意

  1. 您可以根据个人需要修改页面底部的说明信息,但请不要去除 theme-bmw 主题的版权声明
  2. 评论系统采用了 Valine请不要去除 Valine 的版权声明
  3. 尊重原创,也祝您在开源社区玩得开心 (*^▽^*)

# 文章格式

BMW 主题针对文章的 SEO 做了相关优化,并且支持摘要内容渲染。如果您想让您的博客 SEO 更高,浏览体验更高,那么请注意文章格式。

下面是一个标准的文章格式:

---
title: 文章标题
date: 文章创建日期
categories: 文章分类
tags:
  - 文章标签1
  - 文章标签2
  - ...


在`<!-- more -->`之前编写文章的摘要内容!!!

<!-- more -->

在`<!-- more -->`之后编写文章的正式内容!!!

# Web 安全问题

如果您开启了评论系统和文章统计插件,请仔细阅读此节!

借助了 Leancloud 规避了后端部署,傻瓜式一键启动相关功能。但随之而来的是,暴露在浏览器环境下的 appidappkey 带来的安全问题。

请进入 Leancloud 中您的应用 => 左侧导航栏 => 设置 => 安全中心,进行相关配置:

8.png

首先,关闭不需要的 “服务开关” (仅保留 “数据存储” 服务):

9.png

最后,设置您的 “Web” 安全域名 (就是您的博客 / 个人网站地址):

10.png

关于评论

评论前请填好“昵称”、“邮箱”这两栏内容,否则不会收到回复,谢谢!