使用Hexo搭建个人博客

第一次使用Hexo进行博客的搭建,所以在此记录一下,有需要的同学自行拿去。

点赞就不需要了,评论一下意思意思。( ゜- ゜)つロ

使用Hexo搭建个人博客

安装Nodejs

  • 下载安装Nodejs安装包,一直下一步即可。
  • 官网下载地址,推荐下载LTS版本(长期支持版)
  • 在CMD中输入 node -vnpm -v,如果有版本号输出则表示安装成功。

由于npm默认的下载源不在国内,所以我们使用npm install安装时速度比较慢,这里建议使用淘宝定制的cnpm工具代替npm。

1
2
3
npm install -g cnpm --registry=https://registry.npm.taobao.org

-g 表示全局安装

安装Git

  • 下载安装Git安装包,默认下一步即可。

  • 官网下载地址,选择最高版本下载。

  • 右击桌面,选择 Git Bash Here

  • 输入以下命令

    1
    2
    3
    4
    5
    6
    7
    8
    9
    git config --global user.email "你在Github中配置的邮箱"
    git config --global user.name "你在Github中的用户名"
    ssh-keygen -t rsa -C "你在Github中配置的邮箱"

    一直回车

    cat ~/.ssh/id_rsa.pub

    复制下面这段字符串,开头结尾不要有空格。
  • 打开浏览器,进入你的Github配置页面。

  • 点击左边的选项卡中的 SSH and GPG keys

  • 点击右上角的 New SSH key

  • Title随意写,Key就是之前复制的那串字符串。

  • 最后点击 Add SSH key

安装Hexo

  • 执行 cnpm install -g hexo-cli
  • 在CMD中输入 hexo -v,如果返回各种工具名以及版本号,则表示安装成功。

初始化Hexo博客

  • 选择一个目录安装Hexo博客,我默认选择 E:\Desktop\blog

  • 此时将你的CMD中的路径切换至 E:\Desktop\blog

    1
    2
    3
    cd /d <你的目录路径>

    eg. cd /d E:\Desktop\blog
  • 执行 hexo init 初始化一个博客,完成后会在blog目录中生成如下数据文件

    1
    2
    3
    4
    5
    6
    7
    $ ll
    total 5
    -rw-r--r-- 1 XIAO 197121 1768 10月 6 20:47 _config.yml
    -rw-r--r-- 1 XIAO 197121 492 10月 6 20:47 package.json
    drwxr-xr-x 1 XIAO 197121 0 10月 6 20:47 scaffolds/
    drwxr-xr-x 1 XIAO 197121 0 10月 6 20:47 source/
    drwxr-xr-x 1 XIAO 197121 0 10月 6 20:47 themes/
  • 执行 hexo server 来启动博客

    1
    hexo s # 完整命令位 hexo server

编写第一篇博文

  • 执行 hexo n “我的第一篇博文”

    1
    2
    $ hexo n "我的第一篇博文"
    INFO Created: E:\Desktop\blog\source\_posts\我的第一篇博文.md
  • 编辑 我的第一篇博文.md

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    ---
    title: 我的第一篇博文
    date: 2019-10-06 21:10:40
    tags:
    ---

    # 第一段
    内容

    # 第二段
    内容

    # 参考
    blog.xiaojianzheng.cn
  • 执行如下命令

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    $ hexo clean # 用于清除缓存文件 (db.json) 和已生成的静态文件 (public)。
    INFO Deleted database.

    $ hexo generate # 用于生成静态文件。
    INFO Start processing
    INFO Files loaded in 560 ms
    INFO Generated: index.html
    INFO Generated: archives/index.html
    ......
    INFO Generated: 2019/10/06/hello-world/index.html
    INFO Generated: 2019/10/06/我的第一篇博文/index.html
    INFO Generated: fancybox/jquery.fancybox.js
    INFO Generated: css/images/banner.jpg
    INFO 29 files generated in 988 ms
  • 执行 hexo s 启动博客,查看效果。会发现首页多出一篇博客。

将博客部署到Github

  • 登录Github,新建一个repository,命名为 你的Github用户名.github.io(必需)。

    1
    2
    例如我的仓库名为:xiao1272209235.github.io
    xiao1272209235是我的Github用户名
  • 安装 hexo-deployer-git 插件,用于将博客部署到Github上。

    1
    cnpm install hexo-deployer-git --save
  • 编辑blog目录下的 _config.yml 文件,冒号后面要有一个空格

    1
    2
    3
    4
    5
    6
    7
    8
    ... 省略 ...

    # Deployment
    ## Docs: https://hexo.io/docs/deployment.html
    deploy:
    type: git
    repo: 刚刚创建的Github项目的地址,我的是https://github.com/xiao1272209235/xiao1272209235.github.io.git
    branch: master
  • 执行 hexo deploy,部署博客。第一次会让你输入你的Github账号密码

  • 命令执行完后,进入刚刚创建的GitHub项目,会发现多出来许多文件及文件夹。其实就是将博客中的所有东西推送到Github上

  • 打开浏览器,输入 你的Github用户名.github.io 访问你的博客。

基本指令

init

1
hexo init 目录

新建一个网站。如果没有设置 folder ,Hexo 默认在目前的文件夹建立网站。

new

1
hexo new [layout] <title>

新建一篇文章。如果没有设置 layout 的话,默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话,请使用引号括起来。

1
hexo new "post title with whitespace"
参数 描述
-p, --path 自定义新文章的路径
-r, --replace 如果存在同名文章,将其替换
-s, --slug 文章的 Slug,作为新文章的文件名和发布后的 URL

默认情况下,Hexo 会使用文章的标题来决定文章文件的路径。对于独立页面来说,Hexo 会创建一个以标题为名字的目录,并在目录中放置一个 index.md 文件。你可以使用 --path 参数来覆盖上述行为、自行决定文件的目录:

1
hexo new page --path about/me "About me"

以上命令会创建一个 source/about/me.md 文件,同时 Front Matter 中的 title 为 "About me"

注意!title 是必须指定的!如果你这么做并不能达到你的目的:

1
hexo new page --path about/me

此时 Hexo 会创建 source/_posts/about/me.md,同时 me.md 的 Front Matter 中的 title 为 "page"。这是因为在上述命令中,hexo-cli 将 page 视为指定文章的标题、并采用默认的 layout

generate

1
hexo generate

生成静态文件。

选项 描述
-d, --deploy 文件生成后立即部署网站
-w, --watch 监视文件变动
-b, --bail 生成过程中如果发生任何未处理的异常则抛出异常
-f, --force 强制重新生成文件 Hexo 引入了差分机制,如果 public目录存在,那么 hexo g只会重新生成改动的文件。 使用该参数的效果接近 hexo clean && hexo generate

该命令可以简写为

1
hexo g

publish

1
hexo publish [layout] <filename>

发表草稿。

server

1
$ hexo server

启动服务器。默认情况下,访问网址为: http://localhost:4000/

选项 描述
-p, --port 重设端口
-s, --static 只使用静态文件
-l, --log 启动日记记录,使用覆盖记录格式

该命令可简写为

1
hexo s

deploy

1
hexo deploy

部署网站。

参数 描述
-g, --generate 部署之前预先生成静态文件

该命令可以简写为:

1
hexo d

render

1
hexo render <file1> [file2] ...

渲染文件。

参数 描述
-o, --output 设置输出路径

migrate

1
hexo migrate <type>

从其他博客系统 迁移内容

clean

1
hexo clean

清除缓存文件 (db.json) 和已生成的静态文件 (public)。

在某些情况(尤其是更换主题后),如果发现您对站点的更改无论如何也不生效,您可能需要运行该命令。

list

1
hexo list <type>

列出网站资料。

version

1
hexo version

显示 Hexo 版本。

文章作者: XIAO
文章链接: http://yoursite.com/2019/10/06/使用Hexo搭建个人博客/
版权声明: 本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 XIAO
微信打赏
支付宝打赏