Hexo是一个快速、简洁且高效的博客框架,而Github是一个免费的代码托管工具,利用Github Page可以免费创建一个静态网站。下面将介绍如何使用Hexo和Github,在win10环境下搭建一个静态的博客。
全文分为三个部分:
安装Hexo前,需要安装以下:
如果已经安装完成以上程序,打开Git-bash或者cmd,输入
npm install -g hexo-cli
即可完成Hexo的安装。
选择一个本地的文件夹,如D:\hexo
。
输入
hexo init D:\hexo
cd D:\hexo
npm install
如果hexo安装成功,则在D:\hexo
文件夹下的文件目录为
.
├── _config.yml // 网站的配置信息,你可以在此配置大部分的参数。
├── package.json
├── scaffolds // 模板文件夹。当你新建文章时,Hexo会根据scaffold来建立文件。
├── source // 存放用户资源的地方
| ├── _drafts
| └── _posts
└── themes // 存放网站的主题。Hexo会根据主题来生成静态页面。
详细文件或文件夹的具体含义见 Hexo官方文档之建站
为了测试本地建站是否成功,输入
hexo s
如果显示如下
则说明本地建站成功,访问本地地址可以看到Hexo默认主题的效果。
至此,Hexo的安装和本地建站完成,如需更加深入全面地了解Hexo,可访问Hexo官方文档。
如果已经注册Github,可跳过此步骤。否则,访问Github官网进行注册,下面假设你注册Github账号名为MyGithub。
注册并登陆Github官网成功后,点击页面右上角的+
,选择New repository
。
在Repository name
中填写你的Github账号名.github.io
,这里是MyGithub.github.io
。Description
中填写对此repository的描述信息(可选,但建议填写,如Personal website
)。
点击Create repository
,完成创建。
(1) 生成SSH
检查是否已经有SSH Key,打开Git Bash,输入
cd ~/.ssh
如果没有这个目录,则生成一个新的SSH,输入
ssh-keygen -t rsa -C "your e-mail"
其中,your e-mail
是你注册Github时用到的邮箱。
然后接下来几步都直接按回车键,最后生成如下
(2) 复制公钥内容到Github账户信息中
打开~/.ssh/id_rsa.pub
文件,复制里面的内容;
打开Github官网,登陆后进入到个人设置(点击头像->setting
),点击右侧的SSH Keys
,点击Add SSH key
;填写title之后,将之前复制的内容粘贴到Key框中,最后点击Add key
即可。
(3) 测试SSH是否配置成功
输入
ssh -T [email protected]
如果显示以下,则说明ssh配置成功。
Hi username! You've successfully authenticated, but GitHub does not
provide shell access.
打开D:\Hexo
文件夹中的_config.yml
文件,找到如下位置,填写
# Deployment
## Docs: http://hexo.io/docs/deployment.html
deploy:
type: git
repo: [email protected]:MyGithub/MyGithub.github.io
注: (1) 其中MyGithub
替换成你的Github账户; (2) 注意在yml文件中,:
后面都是要带空格的。
此时,通过访问http://MyGithub.github.io
可以看到默认的Hexo首页面(与之前本地测试时一样)。
本网站使用的是Next主题。该主题简洁易用,在移动端也表现不错。
(1) 下载Next主题
cd D:\Hexo
git clone https://github.com/iissnan/hexo-theme-next themes/next
(2) 修改网站的主题为Next
打开D:\Hexo
下的_config.yml
文件,找到theme
字段,将其修改为next
# Extensions
## Plugins: http://hexo.io/plugins/
## Themes: http://hexo.io/themes/
theme: next
(3) 本地验证是否可用
输入
hexo s --debug
访问本地网站,确认网站主题是否切换为Next.
(4) 更新Github
输入
hexo g -d
完成Github上网页文件的更新。
发表文章操作非常简单,在网站存放的根目录打开git bash
,输入
hexo n "name of the new post"
回车后,在source文件夹下的_post文件夹下,可以看到新建了一个name of the new post.md
的文件,打开
title: name of the new post
date: 2015-12-09 22:55:25
tags:
---
可以给文章贴上相应的tags,如有多个则按照如下格式
[tag1, tag2, tag3, ...]
在- - -
下方添加正文内容即可,注意需要使用markdown语法进行书写。
在这里有关于Markdown语法的简单说明。推荐使用MarkdownPad2进行md文件的编辑工作。
文章撰写完成后保存,输入
hexo g -d
即可生成新网站,并且同步Github上的网站内容。
截止到目前为止,你应该可以通过访问http://MyGithub.github.io
来看到以上创建的网站了。
但是,如何拥有一个属于自己的域名地址,并将其指向在Github上所创建的网站呢?
推荐选择国内的万网或者国外的Goddady进行域名的注册。
如果你选择的是万网注册的域名,可以使用其自带的域名解析服务。
进入万网,登陆后进入到个人中心(点击用户名即可),点击左侧的”云解析”,点击之前所购买的域名,在”解析设置”中,添加如下解析规则:
其中,当记录类型为A时,记录值为服务器的ip地址,这里的服务器地址为存放Github page
的地址,你可以通过命令行输入
ping github.io
得到。
DNS域名解析设置需要一定时间,之后你可以通过ping自己的域名地址来查看是否解析成功。
即在 MyGithub/MyGithub.github.io 中加入名为”CNAME”的文件,文件内容为你的域名地址,如
www.××××××.com
保存即可。
CNAME文件设置的目的是,通过访问 MyGithub.github.io 可以跳转到你所注册的域名上。
为了方便本地文件deploy的时候,CNAME文件不发生丢失,可以在本地网站根目录下的source文件夹下,添加以上的CNAME文件。以后每次deploy的时候,CNAME文件不会发生丢失。
通过以上的设置,相信你已经可以通过注册域名来访问一个默认的hexo主题页面了。之后的工作就在于,(1)如何对主题进行个性化设置及;(2)发表博文以充实网站内容。这里有关于next主题的个性化设置说明。
本文结束,感谢欣赏。
欢迎转载,请注明本文的链接地址:
http://www.jeyzhang.com/hexo-github-blog-building.html