目录
一、环境准备
安装 Node js
二、安装 Hexo 博客框架
三、使用 Hexo 搭建博客(本地启动)
四、部署到远端(Github)上公开使用
五、注意
Hexo 博客框架比较成熟,出了问题,网上可以搜索到很多的解决方式。无论是 Windows 还是 Linux,操作其实都是差不多的。我的是 Windows10 的电脑操作的。这个是我的个人博客地址:qinghan586.github.io
一、环境准备
提前装好 Git,这里不多讲解了,可以百度安装下。
安装 Nodejs
下载 nodejs:https://nodejs.org/en/
安装直接点击下一步、下一步就可以了。
安装完以后会有两个组件:1.是 npm 包管理器;2.是 Nodejs 本身。
如果是 mac,需打开终端切换到 root 用户:
sudo su
输入密码,敲回车。
输入clear
清一下。
查看 node 的版本:node -v
查看 npm 包管理器的版本:npm -v
Windows 电脑我是直接以管理员身份打开 cmd,输入:
查看 node 的版本:node -v
查看 npm 包管理器的版本:npm -v
因为 Hexo 需要 Nodejs 支持的、生成的,所以这是前置步骤。
二、安装 Hexo 博客框架
需借助 npm 包管理器来安装。因为国内安装镜像源很慢,所以利用 npm 安装 cnpm。
用淘宝链接进行安装:
npm install -g cnpm --registry=https://registry.npm.taobao.org
敲cnpm
就可以自动补全了,这个工具说明就有了。
看下 cnpm 的版本:cnpm -v
安装 Hexo 框架:
cnpm install -g hexo-cli
hexo -v
来验证下。
可以看到 Hexo 的博客框架是基于 node 的。
三、使用 Hexo 搭建博客(本地启动)
方式一:
在开始之前,输入 pwd 看下所处路径。
新建一个 blog 文件夹:mkdir blog
方式二:
我是直接在 E 盘自己手工创建了一个 blog 文件夹。
所有博客的东西全部都在 blog 里面生成。所以大家如果出了什么错,直接连 blog 文件夹整个删除就行了。注意:千万不能只删除 blog 文件夹里面的内容,却不删除 blog 文件夹,这样操作会出问题的。
进入 blog 的目录中,位于这个目录下,就可以使用 Hexo 生成我们的博客。
mac 下输入 sudo,表示用管理员的命令来执行,用 mac 电脑需要加上。
初始化一个博客:sudo hexo init
初始化一个博客:hexo init
您看,它会自己去克隆。还会默认克隆一个 Landscape 主题:
安装完成了!
看该目录下的所有子目录和文件:ls
列出该目录下的所有子目录和文件的详细信息:ls -l
启动博客:hexo s
输入localhost:4000
问下,看看博客是不是已经成功,已经有了,就像这样:
您看,还简介了 Hexo 怎么使用:
hexo s
就是hexo server
,写一篇博客,可以用hexo s
这个命令启动预览下。
hexo n "我的第一篇博客文章"
切换到 source,输入命令:cd source/_posts/
用 vim 编辑器:
可以进行编辑,也可以不编辑直接发布。
点击键盘的 i 进行编辑,shift 和 esc 同时按下(这里我记得是这样用的,如果不行可以百度下),然后输入:wq
保存退出。这个不太好用,编辑用 Visual Studio Code 这个工具即可。
这样博客文章就创建好了。
输入 pwd,看到在 source 目录下,需要退 2 层回去:cd ../..
这样就到了 blog 目录。
接着输入以下命令:
清理下:hexo clean
生成下:hexo g
启动下:hexo s
刷新下:http://localhost:4000
以上 Hexo 博客的搭建已经完成了。
四、部署到远端(Github)上公开使用
1.登录自己的 Github。
2.新建一个仓库:
注意:一定是你的昵称.github.io
例如我的 Github 昵称是 qinghan586
,那么这里输入qinghan586.github.io
现在是个空仓库,地址是这个,先放着。
继续在 blog 目录下,输入命令行操作:
装 Git 部署的插件:cnpm install --save hexo-deployer-git
里面的红色警告可以忽略不管。
去 blog 文件下,直接看到一个_config.yml
,修改_config.yml
即可。注意:blog
文件夹下的其它文件下也有_config.yml
文件,别改错了文件。
文件的最底部修改成这样:
deploy: type: git repository: https://github.com/qinghan586/qinghan586.github.io.git branch: master 复制代码
注意:deploy: type: repository: branch: 后面都有一个英文的空格。
用 nopad++修改后一定要保存!
部署到远端:hexo d
自动部署,需输入账号密码:
往远端推成功后,刷新 Github 仓库,发现多了很多东西,这些就是我的博客内容:
访问qinghan586.github.io
就可以直接打开,并看到博客部署到 Github 上去了。
下载好看的主题:
好看的 Hexo 主题地址:https://hexo.io/themes/
自己来换个主题,克隆到 themes 主题下去:
git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia
git clone https://github.com/volantis-x/hexo-theme-volantis.git themes/volantis
themes 文件夹下就出现你下载的主题了。
现在把主题配置到博客上去:
修改_config.yml
文件:
theme: yilia
theme: volantis
你用哪个主题就换哪个主题的名字,注意名称前面有个英文空格。
输入以下命令:
hexo clean
hexo g
hexo s
启动本地服务:http://localhost:4000
看看,主题已经换了。
推到远端(github)上去:hexo d
推送完成!
访问qinghan586.github.io
可看到主题成功换了!
以上整个过程已经完成了。
后续学下 css,然后才会把自己的博客修改的很漂亮。先搭建起来,再考虑博客内容美观的问题。
五、注意
修改_config.yml
文件后,需要把主题配置到博客上去,输入
hexo clean
hexo g
hexo s
推到远端(github)上去:hexo d
都不行的情况下,可以换成这样的命令再次输入下:
npm install hexo-deployer-git --save
hexo clean
hexo generate
hexo deploy
出现提示 nothing to commit, working tree clean
我是这样提交文章成功的,依次输入:
git add .
git commit -m "one"
hexo clean
hexo generate
hexo deploy
hexo g
hexo d
hexo s
hexo s
后就出来了,域名本地都可以访问了。
如果 Hexo 部署提交不上,Github 仓库上文件未更新。
删除 .deploy_git
目录,再执行hexo d -g
就可以了。
Github 比较慢,刷新后要耐心等待下。
开启无痕模式加载网页,ctrl+shift+delete
清除缓存有时候不一定管用(原因不明)。
较为靠谱的参考链接:https://segmentfault.com/q/1010000003481894?utm_source=sf-similar-question
作者:清菡
链接:https://juejin.cn/post/6897823660191514637
来源:掘金