自从我开了这个博客后,就有很多小伙伴问我怎么弄的?(好吧,其实就一个(*/ω\*)) 为了教她,也为了给各位看官一点参考。我写了这篇文章。 因为她比较小白,所以这篇文章会写得比较详细。

准备工作

  1. 一个 Github 账号。 <-我们要使用它提供的 Github Pages 服务来搭建博客 https://github.com/
  2. Node.js <- Hexo 依赖于此 https://nodejs.org/zh-cn/
  3. Git <- 用来发布博客 https://git-scm.com/
  4. Hexo <- 博客框架 https://hexo.io/zh-cn/index.html
  5. [非必需]Chocolatey <- 用来安装 Node.js 和 Git https://chocolatey.org/

正文

安装 Node.js & Git

使用 安装包 安装(小白看这里)

首先去官网下载各自的安装包。(地址在上面) 其中 Node.js 一般会有两个版本;都可以用。 Git 的官网是英文的,点 [Downloads for Windows] 下载。

下载好后,双击安装包,就像安装普通软件一样安装。

安装好后打开按 Win键 + R,输入 cmd,回车。 在弹出的黑框框中分别输入

$ node -v
$ npm -v
$ git version

如果显示的是各种的版本号,说明安装成功 查看版本号

使用 Chocolatey 安装

我比较喜欢用 Chocolatey 来安装;比较方便。 虽然赶 apt 还有一段距离,但确实是 Windows 下最好的包管理程序。 有空我会写一篇比较详尽的 Chocolatey 使用教程。

首先安装 Chocolatey 用管理员身份打开 CMD,输入一下命令,回车

$ @"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"

然后安装 Node.js 在 CMD 中键入:(同样是以管理员身份运行)

$ choco install nodejs

出现一下文字说明它安装完成了 安装 Node.js

然后安装 Git

$ choco install git

安装 Git

同样的,验证一下是否安装成功 关闭 CMD 然后重新打开它(刷新 %PATH% )键入

$ node -v
$ npm -v
$ git version

如果显示的是各种的版本号,说明安装成功 查看版本号

注册 Github 账号

如果你已经拥有,请跳过 打开 https://github.com/ 分别填上 名字邮箱密码Sign up to GitHub 注册 Github 账号 然后前往自己刚才填写的邮箱,点开 Github 发送给你的注册确认信,确认注册

创建代码库

登陆之后,点击页面右上角的加号,选择 New repository 创建代码库

Repository name 下填写 [你的名字].github.io(填写注册时的名字,英文),Description (optional) 下填写一些简单的描述(不写也没有关系) 创建代码库 然后你会看到 创建代码库

选择右侧的Settings,向下拖动,直到看见GitHub Pages 创建代码库 点击 Automatic page generator,Github 将会自动替你创建出一个 gh-pages 的页面。 如果你的配置没有问题,那么大约 15 分钟之后,[你的名字].github.io 这个网址就可以正常访问了

安装 Hexo

按照官网的说法,Hexo是一个 快速、简洁且高效的博客框架 我们要用它来将 Markdown 渲染成网页,然后发布到 Github 上。

Hexo 通过 Node.js 来安装 在 CMD 中输入:

$ npm install hexo-cli -g

你会看到 安装 Hexo

然后输入

$ npm install hexo -g

安装 Hexo

等它安装好了,我们验证一下是否安装成功 输入

$ hexo -v

安装 Hexo

下面,初始化我们的 Hexo 找一个地方新建一个文件夹,这个文件夹将是用来存放你博客的地方 切换的刚刚新建的文件夹下,初始化 Hexo:(将[你新建的文件夹的路径]改为你刚刚新建文件夹的路径)

$ cd [你新建的文件夹的路径]
$ hexo init

初始化 Hexo

因为我们要用 Git 来发布博客,所以还需要安装一个名为 hexo-deployer-git 的插件 在 CMD 中输入

$ npm install hexo-deployer-git --save

安装 hexo-deployer-git

此时的目录结构↓

.
├── .deploy # 需要部署的文件
├── node_modules # Hexo插件
├── public # 生成的静态网页文件
├── scaffolds # 模板
├── source # 博客正文和其他源文件,404、favicon、CNAME 都应该放在这里
| ├── _drafts # 草稿
| └── _posts # 文章
├── themes # 主题
├── _config.yml # 全局配置文件
└── package.json

配置 Deployment

首先,你需要为自己配置身份信息,打开命令行,然后输入:

$ git config --global user.name "[yourname]"
$ git config --global user.email "[youremail]"

修改 _config.yml

按照一下注释按需修改

# Hexo Configuration
## Docs: http://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/

# Site # 站点信息
title:  # 标题
subtitle:  # 副标题
description:  # 站点描述,给搜索引擎看的
keywords:  # 关键词
author:  # 作者
language: zh-CN # 语言
timezone:  # 时区

# URL # 链接格式
url: https://[你的用户名].github.io # 网址;必填,否则会报错!!
root: / # 根目录
permalink: :year/:month/:day/:title/ # 文章的链接格式
permalink_defaults:

# Directory # 目录
source_dir: source # 源文件目录
public_dir: public # 生成的网页文件目录
tag_dir: tags # 标签目录
archive_dir: archives # 存档目录
category_dir: categories # 分类目录
code_dir: downloads/code
i18n_dir: :lang
skip_render:README.md # 排除的页面 (可以用来上传 README)

# Writing # 写作
new_post_name: :title.md # 新文章标题
default_layout: post # 默认的模板,包括 post、page、photo、draft(文章、页面、照片、草稿)
titlecase: false # 标题转换成大写
external_link: true # 在新选项卡中打开连接
filename_case: 0
render_drafts: false
post_asset_folder: ture # 资源文件夹
relative_link: false
future: true
highlight: # 语法高亮
  enable: true # 是否启用
  line_number: true # 显示行号
  auto_detect: false
  tab_replace:

# Home page setting # 主页设置
## path: 博客主页的根路径 (默认 = '')
## per_page: 每页显示多少个帖子 (0 = 禁用分页)
## order_by: 排序方式 (默认按时间降序排序)
index_generator:
  path: ''
  per_page: 10
  order_by: -date

# Category & Tag # 分类和标签
default_category: uncategorized # 默认分类
category_map:
tag_map:

# Date / Time format # 日期时间格式
date_format: YYYY-MM-DD # 参考http://momentjs.com/docs/#/displaying/format/
time_format: HH:mm:ss

# Pagination # 分页
per_page: 10 # 每页文章数,设置成 0 禁用分页
pagination_dir: page

# Extensions # 拓展插件
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: hexo-theme-next # 主题

# Deployment # 部署,将 [你的用户名] 改成你的用户名
deploy:
  type: git
  repo: [email protected]:[你的用户名]/[你的用户名].github.io.git
  branch: master

注意: * 配置文件的冒号 “:” 后面有一个空格 * repo: 按照 [email protected]:[你的名字]/[你的名字].github.io.git 的格式填写。

安装 NexT 主题

使用 Hexo 的最大好处就是非常的自由,你可以完全掌握你的博客,想把它弄成什么样都可以。 因此,我们可以安装跟好看的主题来替换 Hexo 自带的 landscape 主题。 我推荐使用 NexT 主题(就是你们现在看到的样子),因为它简洁大方,比较符合我的审美。 而且它也是所有主题中,获得 stars 最多的。(在 Github 中,stars 越多,说明该项目越受欢迎。)

使用一下命令安装 NexT

$ git clone https://github.com/iissnan/hexo-theme-next.git themes/next

不嫌弃的话也可以安装我修改过的版本(*/ω\*) -> NexT

$ git clone https://github.com/Mogeko/hexo-theme-next.git themes/next

安装好后打开 Hexo 文件夹中的 _config.yml,找到 theme: landscape,将其改为theme: next

theme: landscape -> theme: next

重新部署一遍 Hexo,开启 Hexo 的本地服务器

$ hexo g
$ hexo s

现在访问 http://localhost:4000/ 看看效果。(๑•̀ㅂ•́)و✧

编写文章

引用一段来自官方的文档 > 你可以执行下列命令来创建一篇新文章。
> $ hexo new [layout] <title>
> 您可以在命令中指定文章的布局(layout),默认为 post,可以通过修改 _config.yml 中的 default_layout 参数来指定默认布局。

创建文章后,可以看见 source\_posts\ 下有一篇新建的以 .md 为后缀文章 打开它可以看见

---
title: hello-world   //在此处添加你的标题。
date: 2014-11-7 08:55:29   //在此处输入你编辑这篇文章的时间。
categories: Exercise   //在此处输入这篇文章的分类。
toc: true  //在此处设定是否开启目录,需要主题支持。
---

在之后空白的地方用 Markdown 编写文章。

更多操作

$ hexo generate  # 将 Markdown 编译成静态网页
$ hexo deploy  # 部署 Hexo 到服务器,也就是到 Github
$ hexo server  # 启动一个本地服务器,默认地址是 `http://localhost:4000`

# 缩写
$ hexo g  # 等同于 hexo generate
$ hexo d  # 等同于 hexo deploy
$ hexo s  # 等同于 hexo server

$ hexo d -g # 等同于 hexo deploy + hexo generate

相关文章


·End·