搭建博客

使用github搭建博客

创建仓库

在自己的GitHub账号下创建仓库<账号名>.github.io

在仓库的设置里面可以看到github pages内容，其中可以看到博客对应的链接，如下图的https://zdzh.github.io/.

选择主题

点击choose a theme 可以选择博客显示主题

在上面一栏中选择自己喜欢的主题，然后点击selecet theme选择主题

安装node.js和Hexo

在Node.js官网上下载node.js，按提示安装软件。安装完成后输入node -v可以查看是否安装成功以及安装的版本
安装hexo

Hexo是一个简单、快速、强大的基于 Github Pages 的博客发布工具，支持Markdown格式，有众多优秀插件和主题。hexo官网 hexo GitHub

在自己的电脑中创建一个空文件夹作为博客文件存放地址。使用命令行进入该目录下，输入以下指令安装Hexo

1	npm install -g hexo

初始化

使用命令行在上述路径中输入hexo init初始化文件夹，该文件夹必须是空文件夹否则初始化失败，指令运行成功后，会在该文件夹下创建若干文件

其中scaffolds是模板文件夹，当您新建文章时，Hexo 会根据 scaffold 来建立文件。Hexo的模板是指在新建的markdown文件中默认填充的内容。例如，如果您修改scaffold/post.md中的Front-matter内容，那么每次新建一篇文章时都会包含这个修改。

source资源文件夹是存放用户资源的地方。除 _posts 文件夹之外，开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹，而其他文件会被拷贝过去。

themes主题文件夹。Hexo 会根据主题来生成静态页面。

之后，输入以下指令打开服务器

1 2	hexo g # 生成静态网页 hexo s #打开本地服务器

打开浏览器，输入http://localhost:4000/,可以查看hexo预先生成的网页。若网页无法打开，则有可能是端口占用问题，可以查看文档如何修改端口。

修改主题

完成以上步骤后，网站的基本框架已经搭建完成，下一步是将网站的主题更换为自己喜欢的样式

可以自行在网上搜索自己喜欢的主题，选中主题后，找到其对应的仓库地址，将其克隆到当前目录的themes下

1	git clone https://github.com/idhyt/hexo-theme-next.git

克隆完成后，在themes可以看到克隆下来的文件

修改_config.yml文件，将theme对应字段改为主题名，及上面克隆下来的文件名

1	theme: hexo-theme-next

执行hexo g重新生成。若这一步出现问题，可以执行hexo clean清除之前的内容，之后再重新生成和发布。

添加页面

使用hexo new page <filename>可以在网站上添加页面，现在使用以下语句添加关于，标签和分类页面

1
2
3

hexo new page about                //关于界面
hexo new page categories          //分类界面
hexo new page tags               //标签界面

执行以上语句后会在_posts路径下生成相应的文件夹和目录，在里面的文件中编辑即可修改相应页面

在categories.md中添加type: "categories"，如下所示

按同样的方法在about.md中添加type:about,在tags.md中添加type:tags

上传到github

上传前首先需要下载一个插件

1	npm install hexo-deployer-git --save

配置_config.yml,修改deploy字段为以下内容

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repository: git@github.com:zdzh/zdzh.github.io.git       #在github中生成的仓库链接
  branch: master

最后输入hexo -d上传到GitHub即可

编写文章

编写文章时，使用hexo n <filename>生成空白markdown文档，在markdown文档中输入自己的博客内容。

在文档的开头处，Front-matter 是文件最上方以 --- 分隔的区域，用于指定个别文件的变量，举例来说：

1	---title: Hello Worlddate: 2013/7/13 20:46:25---

以下是预先定义的参数，您可在模板中使用这些参数值并加以利用。

参数	描述	默认值
`layout`	布局
`title`	标题
`date`	建立日期	文件建立日期
`updated`	更新日期	文件更新日期
`comments`	开启文章的评论功能	true
`tags`	标签（不适用于分页）
`categories`	分类（不适用于分页）
`permalink`	覆盖文章网址

只有文章支持分类和标签，您可以在 Front-matter 中设置。在其他系统中，分类和标签听起来很接近，但是在 Hexo 中两者有着明显的差别：分类具有顺序性和层次性，也就是说 Foo, Bar 不等于 Bar, Foo；而标签没有顺序和层次。

categories:
- Diary
tags:
- PS3
- Games

发布文章

使用hexo n <filename>自动创建markdown文件，文件位于..\source\_posts下。也可以自己新建markdown文件。

文章编写完成后，重新运行以下指令

1 2	hexo g hexo d