hexo博客速搭

hexo介绍

使用hexo搭建博客十分的简单,适用于想写博客但并不想花费过多时间用于搭建博客的同学~

主页: https://hexo.io/zh-cn/

主页的内容已经很详细了,这里只记录几点使用中发现的注意点。

  • 文件目录说明(这里只简单说明,详细介绍请移步官网~~)

    _config.yml :配置文件

    public :生成的静态文件,这个目录最终会发布到服务器

    source :编写的markdown文件,_drafts草稿文件,_posts发布的文章

    themes :博客的模板

  • 编写博客

    官方提供的是命令的方式: hexo new [layout] <title>,实际上,还有另一种方式可以节约我们的时间。将我们已经编写好的markdown文件直接放在_posts文件夹下,并且在最上方加上注释即可。如下:

    1
    2
    3
    4
    5
    ---
    title: 30分钟搭建博客并发布到github
    date: 2019-10-29 17:49:54
    tags:
    ---
  • 本地运行

    打开cmd进入到项目路径下,运行命令hexo server即可本地运行,默认访问地址为:http://localhost:4000。还有另一种运行方式,了解node的同学都知道,package.json文件中可以配置脚本,其实项目初始化后已经帮助我们配置好了,打开package.json文件即可看到如下内容,所以使用命令: npm run server ,一样可以启动本地运行。同时,他提供的有build 、clean、deploy等命令。

    1
    2
    3
    4
    5
    6
    "scripts": {
    "build": "hexo generate",
    "clean": "hexo clean",
    "deploy": "hexo deploy",
    "server": "hexo server"
    },
  • 发布流程

    第一步:建仓库。

    在自己的github仓库中创建一个仓库(repository ),注意仓库名称,比如我的账号是lmAsm,那么仓库的名称必须是lmAsm.github.io,同时,仓库权限设置为public。

    第二步:配置SSH。

    这个就不解释啦,相信大家都会哒~

    第三步:修改项目的配置文件。

    打开项目根目录,如我的是:D:\hexo,然后用编辑器打开_config.yml配置文件,文件最后可以看到:

    1
    2
    deploy:
    type:

    修改成如下并保存:

    1
    2
    3
    4
    deploy:
    type: git
    repository: git@github.com:yourname/yourname.github.io.git
    branch: master

    第四步:部署

    打开命令行,执行命令hexo deploy或者命令npm run deploy。 到这里就大功告成啦!

    若是遇到异常可以执行下面命令:

    1
    2
    hexo clean && hexo g
    hexo d

    如果出现下面的这个异常:

    1
    ERROR Deployer not found: git

    输入以下命令,然后重新执行刚刚的两条命令 :

    1
    npm install hexo-deployer-git --save

    这时候如果弹出一个对话框,输入在github上面的用户名和密码即可 。

    这时候我们就可以在浏览器输入https://yourname.github.io 打开 查看效果啦。

  • 常见问题

    1、执行deploy命令了,但是代码没有上传?

    解决方案:

    先执行hexo generate命令,生成静态文件,再执行hexo deploy上传,上传是只会上传public中生成的文件 .

本文会持续更新记录优化博客遇到的一系列问题以及小技巧,欢迎关注,互放友链~~