安装Hexo
安装node.js,安装git for windows。
所有必备的应用程序安装完成后,创建一个文件夹(用来存放所有blog的东西),然后在该文件夹下使用 npm 安装 Hexo。(所有命令建议使用git的终端来执行)
1 | npm install -g hexo-cli |
过程有点慢以为没反应失败,其实一直在安装,建议切换npm镜像
1 | npm config set registry "https://registry.npm.taobao.org" |
设置淘宝镜像源后,很快就安装完毕了。
安装 Hexo 完成后,请执行下列命令,Hexo 将会在该文件夹中新建所需要的文件。
1 | hexo init |
到此,Hexo安装完成。
hexo常用命令
常见命令
1 | hexo new "postName" #新建文章 |
缩写:
1 | hexo n == hexo new |
组合命令:
1 | hexo s -g #生成并本地预览 |
Github Pages设置
什么是Github Pages
GitHub Pages 本用于介绍托管在GitHub的项目,不过,由于他的空间免费稳定,用来做搭建一个博客再好不过了。
每个帐号只能有一个仓库来存放个人主页,而且仓库的名字必须是yourgithubname.github.io,这是特殊的命名约定。你可以通过http://yourgithubname.github.io 来访问你的个人主页。
需要注意的个人主页的网站内容是在master分支下的。
创建Github Pages
在github创建了一个repo叫做 hombinwong.github.io. 创建完成之后,需要有一次提交(git commit)操作,然后就可以通过链接http://hombinwong.github.io/ 访问了。
Hexo搭桥到github
首先需要明白部署到github的原理。
- 之前在Github上创建的那个特别的仓库(hombinwong.github.io)一个最大的特点就是其master中的html静态文件,可以通过链接http://hombinwong.github.io来直接访问。
- Hexo -g 会生成一个静态网站(第一次会生成一个public目录),这个静态文件可以直接访问。
- 需要将hexo生成的静态网站,提交(git commit)到github上。
配置SHH Key
如果你之前已经配置好git个人信息,请跳过这一个步骤
设置Git的user name和email:(如果是第一次的话)
1 | git config --global user.name "yourname" |
生成密钥
1 | ssh-keygen -t rsa -C "your email" |
连续三个回车,生成密钥,最后得到了两个文件:id_rsa和id_rsa.pub(默认存储路径是:C:\Users\Administrator.ssh)。
打开你的github主页,进入个人设置 -> SSH and GPG keys -> New SSH key。将id_rsa.pub文件里的key粘贴到key那里,title随便填,保存。
配置Deployment
打开 站点配置文件_config.yml
,找到deploy,然后按照如下修改:(PS:如果要配多个deploy,type前面加-)
1 | deploy: |
比如我的仓库的地址是hombinwong.github.io,所以配置如下:
1 | deploy: |
安装部署到github的插件:
1 | npm install hexo-deployer-git --save |
执行命令(建议每次都按照如下步骤部署):
1 | hexo g |
在浏览器中输入http://yourgithubname.github.io
就可以看到你的个人博客。
绑定个人域名
当然,你不绑定域名肯定也是可以的,就用默认的 yourgithubname.github.io
来访问,如果你想更个性一点,想拥有一个属于自己的域名,那也是OK的。
首先注册一个域名,域名注册推荐去阿里云,本来想用.me域名,不过现在这些非主流的域名工信部还没有纳入备案的条件,如目前的.online,.xyz,.me等都不能备案。如果有需要可以绑定国外服务器,这样就不需要备案了,比如godaddy
。
绑定域名分2种情况:带www和不带www的。
域名配置最常见有2种方式,CNAME和A记录,CNAME填写域名,A记录填写IP,由于不带www方式只能采用A记录,所以必须先ping一下yourgithubname.github.io
的IP,然后到你的域名DNS设置页,将A记录指向你ping出来的IP,将CNAME指向yourgithubname.github.io
,这样可以保证无论是否添加www都可以访问,如下:
然后到你的Hexo/source目录新建一个名为CNAME的文件(无后缀),里面填写你的域名,加不加www看你自己喜好,因为经测试:
- 如果你填写的是没有www的,比如 wanghongbin.top,那么无论是访问 http://www.wanghongbin.top 还是 http://wanghongbin.top,都会自动跳转到 http://wanghongbin.top
- 如果你填写的是带www的,比如 www.wanghongbin.top ,那么无论是访问 http://www.wanghongbin.top还是 http://wanghongbin.top,都会自动跳转到 http://www.wanghongbin.top
另外说一句,在你绑定了新域名之后,原来的yourgithubname.github.io
并没有失效,而是会自动跳转到你的新域名。
发表博客
写博客
定位到我们的hexo根目录,执行命令:
1 | hexo new 'my-first-blog' |
然后你就可以在source/_posts
路径下看到生成的相关md文件。我们只需要打开这个文件就可以开始写博客了,默认生成如下内容:
当然你也可以直接自己新建md文件,用这个命令的好处是帮我们自动生成了时间。
关于具体的文章编辑可以看下官网的介绍。
让博文列表不显示全部内容
默认情况下,生成的博文目录会显示全部的文章内容,如何设置文章摘要的长度呢?
在合适的位置加上<!--more-->
即可。例如:
写博客工具
markdown语法参考markdown。
markdown编辑器推荐一个极致简洁的:Typora。