嗯,搭建这个博客真的是历尽艰辛,所以第一篇博客记录一下我搭建的时候遇见了哪些问题,其实全程都是按网上的教程走的,(想想都是一把辛酸泪),只是最后给博客做加工美化的时候请教了一下大佬,在此特别感谢大佬帮小萌新操作,谢谢谢谢。
首先,搭建博客需要安装
1. git
下载地址https://git-scm.com/download/win
2. node.js下载地址https://nodejs.org/en/
3. hexo
前两个就不用说了,直接下载就行,安装好以后,打开CMD命令窗口,输入npm -v
,如果出现版本号,则说明安装成功了并且环境变量也配置好了,如果是未知命令那就要配置一下环境变量。
安装hexo
安装hexo时要首先在本地磁盘建立一个Hexo文件夹用于存储本地文件
然后再这个文件夹里点击右键打开git命令框
在git命令框中安装Hexo(没有安装git的情况下,可以找网上用cmd窗口安装的教程,不过我没有试过)
安装hexo的命令是npm install -g hexo
打开cmd窗口,输入hexo -v,如果出现版本号则说明安装成功
然后初始化hexo init
初始化完成后启动服务启动服务(npm install –>hexo server –>hexo clean –>hexo generate –>hexo deploy)
最后进行本地测试。
++(注意访问本地页面的时候hexo server不可以按ctrl+c停止服务,否则会报404)++
如果页面没有报404但是进不去,可能是因为端口被占用了,用hexo s -p5000把端口改成5000,再访问一下,就可以进去了
注册github
找到我们的博客仓库,并拷贝仓库地址
找到我们博客根目录下的_config.yml修改目录的配置
修改deploy下的配置如下(注意冒号后有空格)
最后执行控制台命令
npm install hexo-deployer-git
安装部署插件
hexo d //部署到github
最后执行hexo clean –>hexo generate –>hexo deploy
你就可以看到你的博客了
记住,每次修改配置信息或者其他都必须要执行步骤hexo g 、hexo d,才可以使得配置信息生效。
根据自己的的系统自行选择下载安装,下载地址https://desktop.github.com/
下载安装好之后登陆你的github.
从你的仓库添加到本地
hexo new 新建一篇文章之后可以预览(localhost:4000)了
从本地访问成功后执行hexo d部署到github
这时再刷新 username.github.io 就可以看到你的博客了。
我在搭建博客过程中遇到的问题
- 执行npm install -g hexo安装命令时出现错误
然后我执行了npm cache clean –force强制清理了一下cache才安装成功
这一步出错一般是提示权限错误,就是node_modules中某个文件无权限操作,要求使用root/admistrator用户运行命令。
这个问题的解决其实并非单纯的权限问题,当然首先用管理员用户运行命令试一下,linux用户可以在命令前加sudo,windows系统需要以管理员身份运行cmd终端窗口。
如果没有解决,因为本质是node.js安装模块的过程中出现的问题,可以试着用npm cache clean –force强制清理一下cache,然后重新运行npm install安装必要的模块
- 初始化hexo init发生错误
这个问题网上并没有提供解决的办法,可能是因为大家没有遇见过吧,然后我在寻找解决方法的时候注意到教程里有这样一句话
“首先新建一个文件夹,位置随意,然后 cd 到这个文件夹下,运行命令:hexo init”
然后我建了一个文件夹,cd到这个文件夹下,再运行这个命令,果然不假,进入了漫长的初始化生成过程
- 进行本地测试时页面报错404
原因是执行了hexo s后又按了ctrl+c终止
attention:命令行里ctrl+c代表stop停止
附:hexo中几个常用命令
hexo generate (简写:hexo g)
生成静态文件,会在当前目录下生成一个新的叫做public的文件夹
hexo server (简写:hexo s) 启动本地web服务,用于博客的预览
hexo deploy (简写:hexo d) 部署博客到远端(比如github, heroku等平台)
$ hexo new “xxxx”(简写:hexo n) 新建文章
$ hexo new page “pageName” #新建页面
常用组合:
$ hexo s -g #生成预览
$ hexo d -g #生成部署