hexo是一个高效简洁的静态博客框架,基于Node.js使用Markdown解析文章,几秒内即可利用靓丽的主题生成静态网页。
#环境:
windows10 64bits
#所需软件:
1. Node.js 基于Chrome V8引擎的JavaScript运行环境;
2. Git-for-windows windows平台下git 运行环境;也可以使用 github-for-windows 里的 git shell, 由于在线安装 github-for-windows 在国内不翻墙是不可能成功的,所以上面的链接是离线版的安装版本。
3. MarkdownPad 博客撰写工具
开始之前先去 github 注册一个账户,并新建一个名为username.github.io的仓库,最后生成的仓库地址:https://github.com/username/username.github.io 注:username替换为自己的用户名
hexo安装与配置
首先在本地建立自己的博客文件夹,比如 F:\github\hexo,进入该文件夹内,右键点击Git Bash Here,打开git for windows环境,开始安装 hexo:
完成之后可以通过命令查看hexo是否安装成功:
hexo根目录下的_config.yml文件是全局配置文件,修改该文件实现自己的配置。具体可参考 hexo 官网。
hexo常用命令
hexo常用命令可以参考hexo的帮助说明,下面列举几个常用命令:
建站
在自己的博客文件夹下F:\github\hexo,执行命令:
这个时候在浏览器输入localhost:4000即可查看到生成的静态网页:
部署到github
在hexo根目录下找到配置文件_config.yml,使用 MarkdownPad 打开,编辑最后的deploy字段,将自己的github仓库地址输入进去:
配置SSH Key
在桌面空白处鼠标右键选择Git Bash Here,输入以下命令配置SSH Key:
引号里面的内容输入邮箱地址,然后回车,会提示文件保存的路径,这时候按回车键确认,然后会提示你输入密码,然后会确认输入一次,在c:/user/username/.ssh/文件夹内看到生成了两个文件,一个是id_rsa,另一个是id_rsa.pub,打开id_rsa.pub然后选中里面的全部内容,复制下来。登录 github,点击setting,左边有一个SSH and GPG keys选项,进入New SSH选项,title随意,将之前复制的内容粘贴到key里面去。回到Git bash命令行,输入以下命令验证:
成功时会提示:
其中username为自己的github上的用户名
配置用户名和密码
重新生成一下静态文件:
在运行hexo d之前需要安装git部署工具
第一次执行hexo d会弹出对话框提示输入github的用户名和密码。此时在浏览器输入:
https://github.com/username/username.github.io即可看到自己的博客已经搭建成功。
注: username替换为自己的用户名.
文章置顶
修改 hexo-generator-index 插件,位于 node_modules/hexo-generator-index/lib目录下,文件名为 generator.js,将该文件内容修改为:
参考 generator.js,在要置顶的文章中添加 top 值,值越大文章越靠前:
nexT主题
hexo安装完成后,默认的主题是landscape,保存在hexo/themes/文件夹下。nexT 主题需要自行下载。在博客文件目录下F:\github\hexo右键单击Git Bash Here,输入命令:
下载后的nexT主题会保存在themes目录下。修改hexo根目录下的配置文件_config.yml使主题生效:
接下来选择nexT的Scheme,打开nexT的配置文件themes/nexT/_config.yml中,修改:
更多的设置请参考: nexT
设置语言
打开hexo的配置文件F:/github/hexo/_config.yml,修改:
访问量统计
文章阅读量统计
使用 leancloud 实现文章阅读次数统计。注册完成后,点击访问控制台,选择创建新应用:
创建名为Counter的class。之后找到该应用的AppID、AppKey,将这两个值写入到nexT的主题配置文件中_config.yml:
为了安全,将自己的域名加入安全中心->web安全域名中,防止恶意修改。完成后部署网站,看效果是不是已经有了文章阅读量显示了。
站点访问统计
使用 不蒜子 脚本实现。
在themes/nexT/layout/_partials目录下找到文件footer.swig,在文件的头部添加: