Hexo基本教程

对安装部署Hexo过程的简单记录。


site

Quick Start

安装前提

  • Node.js
    • https://hexo.io/zh-cn/docs/(概括tab及其评论)、 nvm
    • 直接官网(https://nodejs.org/en/download/)下载安装文件即可。
  • Git

安装 Hexo

npm install -g hexo-cli

  • 安装报错,先sudo运行后再看看是不是网络原因(吐槽一下)。

建站

  • 新建所需文件(同样可能有网络问题)

    1
    2
    3
    $ hexo init <folder>
    $ cd <folder>
    $ npm install
  • 一顿操作后文件结构如下

    • _config.yml (站点配置文件)
    • package.json (应用程序信息)
    • scaffolds(模版文件夹。当新建文章时,Hexo 会根据 scaffold 来建立文件。Hexo的模板是指在新建的markdown文件中默认填充的内容。例如,如果您修改scaffold/post.md中的Front-matter内容,那么每次新建一篇文章时都会包含这个修改。)
    • source (资源文件夹是存放用户资源的地方。除 _posts 文件夹之外,开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML文件会被解析并放到 public 文件夹,而其他文件会被拷贝过去。)
    • themes (主题 文件夹。Hexo 会根据主题来生成静态页面。其中也有一个 _config.yml (我们称之为主题配置文件))
      1
      2
      3
      4
      5
      6
      7
      8
      .
      ├── _config.yml (站点配置文件)
      ├── package.json
      ├── scaffolds
      ├── source
      | ├── _drafts
      | └── _posts
      └── themes

配置

  • 配置网站、网站、目录、布局、分页、分类、拓展见 https://hexo.io/zh-cn/docs/configuration配置tab,修改的站点配置文件

命令

命令列表

  • hexo init [folder] 新建一个网站。
  • hexo new [layout] <title> 新建一篇文章。
  • hexo generate 生成静态文件。
选项 描述
-d, –deploy 文件生成后立即部署网站
-w, –watch 监视文件变动
  • hexo publish [layout] <filename> 发布
  • hexo server 启动服务器。默认情况下,访问网址为: http://localhost:4000/。
选项 描述
-p, –port 重设端口
-s, –static 只使用静态文件
-l, –log 启动日记记录,使用覆盖记录格式
  • hexo deploy 部署网站。(-g, –generate 部署之前预先生成静态文件)
  • hexo clean 清除缓存文件 (db.json) 和已生成的静态文件 (public)。
  • hexo list <type> 列出网站资料。
  • hexo version

其他命令

  • 安全模式:在安全模式下,不会载入插件和脚本。当您在安装新插件遭遇问题时,可以尝试以安全模式重新执行。

    $ hexo –safe

  • 调试模式:在终端中显示调试信息并记录到 debug.log。

    $ hexo –debug

  • 简洁模式:隐藏终端信息。

    $ hexo –silent

标签插件;资源、数据文件夹

服务器

  • 首先安装 hexo-server

npm install hexo-server –save

hexo server // 启动服务器,您的网站会在 http://localhost:4000 下启动。在服务器启动期间,Hexo 会监视文件变动并自动更新,您无须重启服务器。

hexo server -p 5000 // 启动服务器同时指定端口

hexo server -s // 在静态模式下,服务器只处理 public 文件夹内的文件,而不会处理文件变动

生成器

  • 监视文件变动
    Hexo 能够监视文件变动并立即重新生成静态文件,在生成时会比对文件的 SHA1-checksum,只有变动的文件才会写入。

$ hexo generate –watch

  • 完成后部署
    您可执行下列的其中一个命令,让 Hexo 在生成完毕后自动部署网站,两个命令的作用是相同的。
1
2
3
4
5
6
$ hexo generate --deploy
$ hexo deploy --generate

// 简写:
$ hexo g -d
$ hexo d -g

主题、模板、国际化

新建博文

1
$ hexo new "My New Post"

More info: Writing

运行服务器

1
2
$ hexo server
$ hexo server -p 4008 #指定端口打开;

More info: Server

生成静态文件

1
$ hexo generate

More info: Generating

部署到远端

1
$ hexo deploy

More info: Deployment

设置read more?

  • markdown 里 加上个这串,默认就只会显示 <!--more--> 之上的内容了

配置Hexo进行一键部署安装

  • 打开 Hexo工程目录下的 _config.yml,修改如下:
  • 注意:#的冒号后面空一格,半角空格,下面一样,我在这里写注释,你千万别像我一样在修改文件时也写中文注释,可能会报错的,我记得我以前在搭LMAP时,就傻傻的在配置里面写中文注释,结果就出现一些傻傻的错误。。。。。大笑

    1
    2
    3
    4
    5
    6
    # Deployment
    ## Docs: http://hexo.io/docs/deployment.html
    deploy:
    type: git
    repository: git@github.com:name/name.github.io.git
    branch: master # 分支选择 master
  • shell 进入hexo工程目录;

  • 输入:npm install hexo-deployer-git --save 进行安装部署所需要的插件
  • 继续输入: hexo clean && hexo g && hexo deploy (后面的修改只需要执行这个命令)
  • 在浏览器输入(name是你的用户名):http://name.github.io/ ,会出现主页;
  • 第一次部署需要 git initgit remote add origin YourRepo
1
2
3
4
5
## hexo现在支持更加简单的命令格式了,比如:
hexo g == hexo generate
hexo d == hexo deploy
hexo s == hexo server
hexo n == hexo new

部署参考