Hexo搭建个人博客
Hexo is a fast, simple and powerful blog framework. You write posts in Markdown (or other languages) and Hexo generates static files with a beautiful theme in seconds.
大致解释是:Hexo是一个快速,简单和强大的博客框架。你写的Markdown(或其他语言)的帖子Hexo在几秒钟内就能生成静态文件;
环境配置
安装Hexo非常容易。但是,你需要先安装几个其他的东西:
Node.js
作用:用来生成静态页面的 到Node.js官网下载相应平台的最新版本,一路安装即可。官网入口
Github账号
作用:用来做博客的远程创库、域名、静态资源服务器。怎么申请github的账号和ssh key等,请大家自行搜索,网络上资源还是很丰富的。
关联Github
添加ssh key到Github
检查SSH keys是否存在Github
执行如下命令,检查SSH keys是否存在。如果有文件id_rsa.pub
或id_dsa.pub
,则直接进入步骤1.3将SSH key添加到Github中,否则进入下一步生成SSH key。
1 | $ ls -al ~/.ssh |
生成新的ssh key
执行如下命令生成public/private rsa key pair,注意将`your_email@example.com`换成你自己注册Github的邮箱地址。
1 | $ ssh-keygen -t rsa -C "your_email@example.com" |
默认会在相应路径下(~/.ssh/id_rsa.pub
)生成id_rsa和id_rsa.pub
两个文件。
将ssh key添加到Github中
Find前往文件夹~/.ssh/id_rsa.pub
打开id_rsa.pub文件,里面的信息即为SSH key,将这些信息复制到Github的Add SSH key页面即可。
进入Github –> Settings –> SSH keys –> add SSH key:
Title里任意添一个标题,将复制的内容粘贴到Key里,点击下方Add key绿色按钮即可。
正式安装Hexo
nodejs和git都安装好后,可执行如下命令安装hexo:
1 | $ sudo npm install -g hexo |
初始化
创建一个文件夹,如:Blog,进入到Blog里分别执行init命令和安装依赖命令:
1 | $ hexo init blog |
生成静态页面
继续再Blog目录下执行如下命令,生成静态页面:
1 | $ hexo generate 或 hexo g |
安装hexo-server插件
1 | $ sudo npm install hexo-server |
本地启动
启动本地服务,进行文章预览调试,命令:
1 | $ hexo server 或 hexo s |
浏览器输入localhost:4000进行预览博客网站,是不是很简陋呢,但是好歹有一个自己的家园了,也是很兴奋呢。但是现在都是在本地进行的,需要和github进行关联。
配置Github
建立与你用户名对应的仓库,仓库名必须为【your_user_name.github.io】,固定写法 然后建立关联,例如我的是:luojinghui.github.io,此时,你的目录应该是这样子:
Blog
|
|-- _config.yml
|-- node_modules
|-- public
|-- source
|-- db.json
|-- package.json
|-- scaffolds
|-- themes
现在我们需要修改_config.yml文件,用编辑器打开,翻到最后,改成这个样子(注意冒号后面的空格):
1 | deploy: |
执行如下命才能使用git部署(只需要执行一次):
1 | $ npm install hexo-deployer-git --save |
执行这个命令进行部署:
1 | $ hexo deploy |
然后在浏览器中输入 http://liyilian.github.io 就行了,我的 github 的账户叫 liyilian ,把这个改成你 github 的账户名就行了
备注
每次部署的步骤,可按以下三步来进行:
1 | $ hexo clean |
简写:
1 | $ hexo clean |
一些常用命令:
1 | $ hexo new "postName" #新建文章 |
主题
这里面有很多主题,可以参考: Hexo官网主题页
图片路径
1.文章在 source/_posts下新建以.md为结尾的文件,编辑器可以用Webstrom、Sublime,支持 markdown 语法
2.修改头像可以直接在主题里的 _config.yml 文件里面修改,友情链接,之类的都在这里
3.创建文章的文件开头格式,可以用我现用的格式去写:
1 | --- |
4.如果想引用本地图片路径,以根路径作为起始点,就可以了。例如: /img/logo.png
开始打理你的博客吧,有什么问题下面留言,我会回复的。
Q&A
问:如何让文章想只显示一部分和一个 阅读全文 的按钮?
答:在文章中加一个<!--more-->
,<!--more-->
后面的内容就不会显示出来了。
问:如何添加多说评论?
答:在主题里的 _config.yml中找到duoshuo:
,冒号后面填写你在多说申请用的域名,例如,我申请的是liyilian.duoshuo.com
,那么,在这里就填写liyilian,就好了
转载请注明原地址,liyilian的博客:https://liyilian.github.io/ 谢谢!