本文主要是介绍在Mac上利用Hexo以及Github pages快速搭建一个个人博客。整体流程非常简单,按步骤来就可以。
搭建前提:拥有一个Github账号 + 有耐心。。。
知识简介
- Hexo
Hexo 是一个快速、简洁且高效的静态博客框架,它基于 Node.js 运行,可以将我们撰写的 Markdown 文档解析渲染成静态的 HTML 网页。
- GitHub pages
GitHub Pages 是由 GitHub 官方提供的一种免费的静态站点托管服务,让我们可以在 GitHub 仓库里托管和发布自己的静态网站页面。
环境准备:
因为Hexo是基于Node.js的,环境搭建过程中还需要使用npm和git,因此需要先安装Node.js和Git。
下载并安装,按默认配置完成安装ok。
安装完成后,打开终端terminal,输入下列命令,并对应输出结果说明安装成功。
连接Github
拿出你的Github账号。比如就叫账号就是: 邮箱
接下来创建SSH密匙。输入下列命令:
1 | ssh-keygen -t rsa -C "GitHub 邮箱" |
然后一路回车。OK
- 添加密匙:
进入 /Users/用户名/.ssh 目录,找到id_rsa.pub文件并复制里面的内容,登陆Github,进入到settings界面,选择左边栏的SSH and GPG keys,点击 New SSH key。 title名字可以随意取,复制的id_rsa.pub内容现在粘贴在key中,点击Add SSH key添加完成。
- 验证连接:
在终端输入 ssh -T git@github.com , 问你‘are you sure’, 然后 输入 yes回车
上图表示已经连接成功了!OK
创建Github Pages仓库
GitHub 主页右上角加号 -> New repository:
- Repository name 中输入
用户名.github.io
(注意这里必须和你用户名保持一致) - Description选填
设定为Public
勾选 “Initialize this repository with a README”
填好后点击 Create repository 创建。创建后默认自动启用 HTTPS,博客地址为:https://用户名.github.io
本地安装 Hexo 博客程序
接下来开始使用npm 安装Hexo 博客程序:
1 | sudo npm install -g hexo-cli |
注意需要获取管理员权限,由此需要输入开机密码。
出现上图所示那就说明安装成功了。
新建一个文件夹用来存放 Hexo 的程序文件,如 Blog。
终端切换到Blog的路径:cd /Users/m/Documents/Blog这是我存放Blog的路径。
接下来依次输入:
1 | hexo init # 初始化 |
完成后依次输入下面命令,启动本地服务器进行预览:
1 | hexo g # 生成页面 |
访问 http://localhost:4000
,出现 Hexo 默认页面,本地博客安装成功!OK
Tips:如果出现页面加载不出来,可能是端口被占用了。Ctrl+C 关闭服务器,运行 hexo server -p 5000
更改端口号后重试。
输入命令 ls 查看你的blod文件目录:
其中config是网站的配置信息,package是应用程序的信息,scaffolds是模板文件夹,source是存放用户资源的(Markdown文档)themes是主题文件夹,public是网站文件。
部署 Hexo 到 GitHub Pages
本地博客测试成功后,就是上传到 GitHub 进行部署,使其能够在网络上访问。
首先安装 hexo-deployer-git:
1 | npm install hexo-deployer-git --save |
然后修改 _config.yml 文件末尾的 Deployment 部分,修改成如下:
1 | deploy: |
完成后运行 hexo d
将网站上传部署到 GitHub Pages。
完成!这时访问我们的 GitHub 域名 https://用户名.github.io
就可以看到 Hexo 网站了。
发布博文
进入Blog所在目录,创建博文:
1 | hexo new "name" |
然后 source 文件夹中会出现一个 name.md 文件,就可以使用 Markdown 编辑器在该文件中撰写文章了。
写完后运行下面代码将文章渲染并部署到 GitHub Pages 上完成发布。以后每次发布文章都是这两条命令。
1 | hexo g # 生成页面 |
也可以一句话直接生成并部署如下句
1 | hexo g -d # 生成页面并部署 |
其他命令
1 | hexo s # 本地预览 |
主题优化
我们博客的主题文件夹都放在根目录下的themes中,我们可以看到默认的主题是landscape。我猜大多数人是不喜欢的,那么可以选择其他的主题在hexo的主题网站上,不过建议新手的我们乖乖用最热门的主题NexT吧,而且这个主题相当简洁优雅有档(Bi)次(Ge)。
直接在终端 cd 到博客根目录,然后输入下列命令:
1 | git clone https://github.com/theme-next/hexo-theme-next themes/next |
note:我在本地下载的时候很慢,于是我用了阿里云服务器进行的下载,下载之后用Filezilla又下载到了本地,然后将next主题放到themes文件夹下,如果网速好,可以科学上网的请忽略本条注释。
完成下载后在站点目录中搜索关键字 theme。修改其内容如下
保存,发布并预览 hexo g -d. !
快去看看是不是现在变好看了好多?
主题优化
剩下的进行更细节的网站设计,大家去查询吧!
推荐一个我主要参考的主题优化的网站。
结语
最后的最后要有一个conclusion 和 future work。
博客是我辛辛苦苦搭建了近两天,特别感谢我的大树哥铺好的路,让我少走不少弯路,我在自己的菜单页推荐了我可爱的大树哥,大家可以向他好好学习(不知道为什么越写越像致谢)。
不过还好多出问题没有解决,但是整个博客做好以后真的是开心的不得了呀!以后要努力写博客!加油!o^_^o
博客有问题或者我哪里写的不对请大家可以用旁边的信息私聊我呀~