关于搭建hexo博客中的一些问题



一、关于搭建问题

  1、执行命令的一些问题
   1.1、执行命令hexo server,提示:usage: hexo …. 提示找不到该指令

解决方法: 在Hexo 3.0 后server被单独出来了,需要安装server,安装的命令如下:npm install hexo-server –save 安装此server后再试,问题解决。


   1.2、执行:hexo server,启动了服务,在浏览器输入本地地址访问,看到白板和Cannot GET / 几个字

原因是由于2.6以后就更新了,我们需要手动配置些东西,我们需要输入下面三行命令:


    npm install hexo-renderer-ejs--save

    npm install hexo-renderer-stylus--save

    npm install hexo-renderer-marked--save

这时候重新启动本地服务在访问。或者: 在空文件夹下,执行hexo init – npm install


   1.3、localhost:4000 端口被占用,可执行 hexo s -p 5000 修改成5000 端口


   1.4、YAMLException: incomplete explicit mapping pair; a key node is missed; or followed by a non-tabulated empty line at line 1, column 33:

解决方案:(1)出现这种情况,一般都是缺少空格,在:冒号之后要有空格!检查x行y列附近的冒号,其之后是否跟了空格。此外关于修改配置文件后最好进行验证下文件是否合法,这里小彬推荐去这个站点http://www.yamllint.com/验证,直接将配置文件全部复制到该站点,点击go便可看到是否合法,不合法的会提示,若明白原因可直接在这测试验证


   1.5、在搭建hexo博客进行初始化操作 hexo init <folder> 报错:

报错信息:’hexo’ is not a recognized as an internal or external command, operable program or batch file



解决方法:配置hexo的环境变量



[注意]:执行命令时不要把<>也复制过去,执行时去掉这个就行。folder是你的站点名


   1.6、启动本地站点后,浏览器访问打开点击标签或者菜单报该错:


>>>错误原因:出现该错误的本质就是404,路径存在问题[我当时的问题就是个坑是配置项空格导致的]
>>>
>>>解决方法:把空格去掉,正确的应该是图中的格式。把第二个/后的空格去掉即可。 >>>


   1.7、关于启动后页面存在中文乱码问题:

编辑文件保存时有中文记得将文件编码转为utf8编码,保证确实是转换成功了。可以用notepad++转换


   1.8、关于站点配置时区问题:

配置默认是:timezone: Asia/Shanghai,这个尽量不要修改否则会报错


  **2、配置的一些异常**
   2.1、hexo更换主题后,本地运行测试命令行提示 : WARN No layout: index.html?
>>>1.检查下载的主题是不是放在了themes文件夹下面,比如next主题的放置,就是点开themes就看到next的文件夹,next下面就是主题的文件,不能打开next文件夹还有themes >>>2.检查站点配置_config.yml是不是下面的形式 >>> >>>theme: 你的主题名字 >>> >>>注意:(1)这里是theme,不是themes. >>> >>> (2)theme后面与主题名直接有一个空格。 >>> >>> (3)主题名字是否与themes文件夹下 主题的名字一致。 >>>    比如next:theme: next,冒号后面有空格。


   2.2、关于添加第三方服务-内容分享问题:

问题描述:由于我使用的内容分享服务是https://www.addthis.com/具体配置在官方文档http://theme-next.iissnan.com/third-party-services.html#share-addthis有,刚开始由于网络问题我一直注册不了,便开启了配置项的另两项分享服务,结果导致后来一个服务都没有,似乎是会冲突,只开启一个就好。

推荐使用AddThis功能全美观,比较好用些。可自定义配置


   2.3、关于添加不蒜子数据统计问题:

解决方法:打开主题配置..\hexo\folder\themes\next_config.yml,全文搜索属性:busuanzi_count将enable改为true即可,如图:

>>>如果只是这样的话,打开站点后你会发现并没有数字只有文字,这是因为不蒜子的域名换了,js的外链地址需修改,域名位置为:themes\next\layout\_third-party\analytics\busuanzi-counter.swig >>> >>>修改busuanzi-counter.swig: >>> >>>

>>> >>>修改后代码:``

二、关于部署问题

  1、部署命令配置问题:

   1.1、命令写法注意事项,yml对缩进和空格要求很严格,每个英文冒号后面必须有一个空格,该缩进的地方必须要有缩进(比如下面的后三行代码):[当然也有例外比如某些属性的布尔值就不允许存在空格]


   1.2、部署命令错误ERROR Deployer not found: git

问题原因:这是因为你还没有安装hexo-deployer-git插件(Hexo 3.0以上版本默认是未安装的)。因此你需要手动安装:
在站点根目录执行命令:$ npm install hexo-deployer-git --save


  **2、代码上传托管:**


   2.1、上传后打开网页样式为空?主要分gitee和GitHub说明

问题描述:出现这个问题主要是站点配置文件的URL和root的问题

2.1.1、github托管

url格式为:https://github.com/[GitHub用户名]/[仓库名]

root: /【root是根目录,当然若是你站点目录还有一层另当别论】

2.1.2、gitee托管

URL格式:[仓库开启gitee pages服务后生成的地址]

root:[http://lyibin.gitee.io/后的名称]如图

具体配置示例:


本次记录到此结束,欢迎订阅、关注、收藏、评论、点赞哦~~( ̄▽ ̄~)~

哇咔咔(∪。∪)。。。zzz