经常看到有类似xxx.github.io的个人博客或者项目说明博客。 本文教你如何免费在github上搭建个人博客和网站。使用hexo框架进行搭建.

安装前提

先要安装nodejs然后注册github账号，同时使用ssh和github进行仓库认证管理，很简单自行百度.

node.js mac下注意npm对user/local的权限问题git保证使用ssh和github进行认证测试通过：ssh -T git@github.com 创建github仓库例如github用户名为gameloses则仓库名为:gameloses.github.io

安装hexo

配置hexo

基本配置

在 _config.yml 中修改大部份的配置

配置部署参数deploy: type: git repository: git@github.com:gameloses/gameloses.github.io.git branch: master安装部署插件cd blog npm install hexo-deployer-git --save发布上传博客 hexo d -g常见的其他命令hexo s == hexo server //启动本地服务 hexo g == hexo generate //生成 hexo d == hexo deploy //发布 hexo n == hexo new //新建

书写文章

hexo new post "文章名字"

使用模板生成文章

分类标签

为了使分类标签生效需要生成两个page文件

主题配置

一个模仿github样式的主题

Set theme: replica in _config.yml (the one in your root folder)

安装插件

安装rss

npm install hero-generator-feed 配置如下：

QA

mac下node安装好之后使用npm安装全局包会出现usr/local目录权限读写问题？ sudo chown -R $USER /usr/local 修改权限之后使用ls -l /usr/local 查看权限分类标签404？ 需要创建两个page categories、tagsvscode 编写markdown回退文本之后以后存在特殊的bs字符问题？

显示隐藏字符 "editor.renderControlCharacters": true

安装插件：Remove backspace control character

开启设置："editor.formatOnType": true 在被设定的情况下，进行变换时;输入时启动