Hexo+GitHub搭建博客

拾柒的博客

Hexo美化:
Hexo博客优化之Next主题美化
hexo的next主题个性化教程:打造炫酷网站
hexo页脚添加访客人数和总访问量
Hexo搭建的博客如何给文章分类(next主题)

Hexo搭建博客

1、准备
  1. 安装Git
    Git下载
    廖雪峰Git教程

  2. 安装Node.js
    Node.js下载
    测试安装:node -v
    在这里插入图片描述

  3. 安装Hexo工具
    右键,选择打开Git Bash Here,输入 npm install hexo-cli -g
    在这里插入图片描述

  4. 注册GitHub
    GitHub

  5. Typora
    可以用这个写博客,是一个Markdown编辑器。
    MarkDown语法

2、搭建博客
  1. 开启GitHub Pages服务
    通过Github Pages获得一个免费使用的域名:

    1. 在Github上新建一个仓库,名字为 “你的用户名(如username)”+“github.io”
      在这里插入图片描述
    2. 打开设置
      在这里插入图片描述
      在设置中找到GitHub Pages点击Choose theme选择一个主题
      在这里插入图片描述
    3. 再进入GitHub Pages中会得到一个域名https://oouapatia.github.io/
  2. 创建本地博客点
    在git bash中输入: hexo init Blog

  3. 测试本地博客站点

    hexo g  //g是generetor的缩写,生成博客
    hexo s  //s是server的缩写,启动服务
    
  4. 同步到Github

    修改本博客根目录下的_config.yml文件,修改deploy下的配置如下:

    # Deployment
    ## Docs: https://hexo.io/docs/deployment.html
    deploy:
      type: git
      repo: git@github.com:oouapatia/oouapatia.github.io.git
      branch: master
    

    执行控制台命令

    npm install hexo-deployer-git —save 	//安装部署插件
    hexo d 									//部署到github
    
3、发布博客

在本地写好博客,放到本地博客目录的source文件夹中的_posts文件夹下。
Git中输入:

hexo g  									 //生成网页
hexo d  									//部署到远端(github)

如果有更新,直接生成部署没有效果,可以先执行hexo clean命令后再生成部署

4、更换主题
  1. 在themes文件夹下新建一个next存放即将下载的主题
    mkdir themes\next
  2. 下载主题
    https://github.com/iissnan/hexo-theme-next
    https://github.com/topics/hexo
  3. 修改博客配置文件,更换主题
    修改博客根目录(不是next主题)下的_config.yml文件,搜索theme字段,并将其值修改为next。
    # Extensions
    ## Plugins: https://hexo.io/plugins/
    ## Themes: https://hexo.io/themes/
    theme: next
    
    在控制台下输入如下命令:
    hexo clean 								//清理缓存
    hexo g   	 							//重新生成博客代码
    hexo d   								//部署到本地
    

next 设置

5、配置文件

Blog根目录下的配置文件
themes根目录下的配置文件

6、坑
  1. hexo g报错:

    ERROR Process failed: _posts/my.md
    YAMLException: can not read a block mapping entry; a multiline key may not
    be an implicit key at line 4, column 1:
    

    解决:
    查看新建要上传地md文件,tags或者其他,与后面内容是不是有一个空格。

  2. npm install报错

    npm WARN optional SKIPPING OPTIONAL DEPENDENCY: 
    fsevents@1.2.7(node_modules\fsevents):
    npm WARN notsup SKIPPING OPTIONAL DEPENDENCY: 
    Unsupported platform for fsevents@1.2.7: 
    wanted {"os":"darwin","arch":"any"} (current: {"os":"win32","arch":"x64"})
    

    解决:
    fsevent是mac osx系统的,在win或者Linux下使用了 所以会有警告,忽略即可。

  3. hexo d报错

    ERROR Deployer not found: git
    

    解决:
    需要提前安装一个扩展npm install hexo-deployer-git --save

  4. 配置文件_config.yml

    解决:
    置文件里的deploy中的设置,:后面也需要有空格,不然无法进行部署

  5. 在修改主题是遇到的问题

    解决:
    修改_config.yml中的language为zh-Hans时,在notepad++默认的方式输入中文,然后到浏览器中运行,发现乱码。回去查看notepad++中的默认字符是ANSI编码,转化为UTF-8后,原来输入的中文乱码,将原来输入的文字在UTF-8模式下重新输入。

6、结

仔细阅读网上的教程,一步步搭建,结果还是有很多错误,其中有一些,仔细看它的提示信息,在网上搜索一番,发现这些警告并没有什么影响,如fsevent,只是因为操作系统的缘故发出了警告。随后又在网上的一篇博客中找到了很多问题的解决方案:cloud_yf
Hexo的官网,,里面有很多的操作和原理,还有很多的主题。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值