博客搭建教程

0 前言

建这个博客踩了好多坑QWQ

1 安装

1.1 安装Git和Node.js

这没什么好说的吧…

安装完成后打开cmd通过以下两行命令检测是否安装成功

git --version
npm --version

1.2 更换国内镜像源

~~如果您觉得网速够快可以选择跳过此步~~

npm config set registry https://registry.npm.taobao.org

1.3 安装Hexo

上一步不做的话这一步会慢得让你怀疑人生

npm install -g hexo-cli 

2 创建

2.1 创建本地Blog

新建一个空文件夹并进入

右键 -> “Git Bash Here”

输入以下命令

hexo init

2.2 进行本地预览

继续在命令行中输入下列代码

hexo g
hexo s

之后进入打开浏览器http://localhost:4000 就可以查看自己的Blog了

3 美化

3.1 下载主题

在GitHub 中查找hexo-theme

选择一个自己喜欢的主题并clone或下载zip包解压到主目录/themes中

3.1.1 yilia

这里以yilia 为例

git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia

3.1.2 Material

注意:使用Material主题最好用1.5.2版，最新版会一直报错

这里以Material 为例

cd themes
git clone https://github.com/viosey/hexo-theme-material.git material

3.1.3 Fluid

以下引用自Fluid官方文档

Hexo 5.0.0 版本以上，推荐通过 npm 直接安装

npm install --save hexo-theme-fluid

3.2 使用主题

3.2.1 yilia

修改主目录下的 _config.yml 文件的 theme值为yilia。

theme: yilia

复制 themes/yilia 目录下_config.template.yml 为 _config.yml

3.2.2 Material

修改主目录下的 _config.yml 文件的 theme值为material。

theme: material

复制 themes/material 目录下_config.template.yml 为 _config.yml

3.2.3 Fluid

修改主目录下的 _config.yml 文件的 theme值为fluid。

theme: fluid

然后在博客目录下创建 _config.fluid.yml，将主题的 _config.yml 内容复制进去。

3.3 更改语言

修改主目录下的 _config.yml 文件的 language值为zh-CN。

language: zh-CN

3.4 站内搜索

3.4.1 yilia / Material

安装 hexo-generator-search 插件。

npm install hexo-generator-searchdb --save

修改theme/主题名 目录 _config.yml 中的 search值

search:
    use: local
    swiftype_key: 

然后在主目录的_config.yml文件中添加

search:
    path: search.xml
    field: all

3.4.2 Fluid

修改主目录的 _config.fluid.yml 中的 search值

# 搜索功能，基于 hexo-generator-search 插件，若已安装其他搜索插件请关闭此功能，以避免生成多余的索引文件
# Search feature, based on hexo-generator-search. If you have installed other search plugins, please disable this feature to avoid generating redundant index files
search:
  enable: true

  # 搜索索引文件的路径，可以是相对路径或外站的绝对路径
  # Path for search index file, it can be a relative path or an absolute path
  path: /local-search.xml

  # 文件生成在本地的位置，必须是相对路径
  # The location where the index file is generated locally, it must be a relative location
  generate_path: /local-search.xml

  # 搜索的范围
  # Search field
  # Options: post | page | all
  field: post

  # 搜索是否扫描正文
  # If true, search will scan the post content
  content: true

4 部署

到前一步本地的博客基本上就建好了，接下来就是将其部署在服务器上

4.1 连接Git仓库

首先在GitHub 注册一个账号,建立用户名.github.io的项目

接着打开Git Bash，输入下列命令

git config --global user.name "用户名"
git config --global user.email "注册邮箱"

4.2 添加密钥

在Git Bash中继续输入下列命令生成SSH密钥

ssh-keygen -t rsa -C "注册邮箱"

查看密钥

cat ~/.ssh/id_rsa.pub

将输出的内容复制到SSH and GPG keys 里

4.3 提交部署

安装hexo-deployer-git

npm install hexo-deployer-git --save

配置主目录的_config.yml文件

deploy:
  type: git
  repo: 仓库地址
  branch: master

部署到GitHub

hexo d

访问https://用户名.github.io/

Hervey's Blog