什么是 hexo

hexo 是博客框架，将支持的类型的文件转换成静态Web页面（html+css+javascript）。

发布一篇博客

工具安装

1. 下载并安装git
2. 下载并安装Node.js
3. 下载并安装hexo

cmd打开命令行窗口, 使用npm安装hexo

npm install -g hexo-cli // 全局安装 hexo 模块

创建博客目录

继续执行如下命令

hexo init <folder> // 初始化, 在指定目录中创建文件目录
cd <folder>
npm install // 安装 <folder> 中的全部项目依赖

创建一篇新文章

hexo new [layout] <title> // 标题中包含空格需要用引号将标题引起来
// 执行该命令后在`source/_posts`目录下生成文件

然后就可以打开该文件进行编辑。

生成博客页面

hexo generate
// 执行该命令后会生成`public`目录

本地查看

hexo server
// 执行命令后启动服务，访问`http://localhost:4000/`可查看博客

上传到 github

首次使用配置

1. 安装 hexo-deplorer-git（执行如下指令）

npm install hexo-deplorer-git --save

1. 修改 _config.yml 中的#deploy 配置

deploy:
type: git
repo: <git-repo-url>
branch: [branch]
message: [message]

如何获取 git-repo-url

a. 打开github.com，创建一个名为username.github.io repo。则 repo 名为 http://github.com/username/username.github.io。下面是手动提交站点资源。也可以直接在 _config.yml中配置。

b. 拉取项目

git clone https://github.com/username/username.github.io

c. 切换到项目目录，将站点资源文件放置到该目录

cd username.github.io

d. 提交项目

git add --all
git commit
git push -u origin master

自定义

hexo 目录结构

<folder> 中生成的目录结构和含义如下

_config.yml 配置信息
package.json hexo 博客框架模块信息
source 存放博客源文件和其他文件。Markdown和HTML文件会被解析并放到public目录（解析时生成），其他类型文件/文件夹将会被复制到 public 目录下。对于以”“开头的文件/文件夹，除_post文件夹外，其他以”“开头的文件/文件夹和隐藏文件将被忽略。
themes 生成页面时，根据该文件夹中的主题来生成某个主题的页面。
scaffolds 生成页面时，根据该文件夹中的模板来生成页面。

文章引用资源

哪些文件作为资源?

source目录下除了文章和以”_”为前缀的文件/文件夹（”_post”目录除外）的所有文件都属于资源。

文章中如何引用资源?

方式1：不与文章相关的资源管理
可以在 source 目录下新建用于存放资源的目录。引用通过绝对路径的![](/folder/res.png)方式来引用资源。（注意：source目录相当于发布后的站点根目录）。

方式2：与文章相关的资源管理
将_config.yml 中的post_asset_folder 设置为 true。在生成过程中会自动在source目录下生成与文章同名的目录，可以将资源存放于该目录。引用通过相对路径![](res.png)的方式来应用资源。（注意：这时页面和资源位于同一目录）。

问题：归档页中的资源没有正确引用

最好不使用Markdown的方式来引用资源，使用{% asset_img example.jpg This is an example image %}来引用资源。使用Hexo 3中的新的标签插件语法能够保证在归档页中资源也得到正确的引用。

资源引用插件语法参考

1. 文章 {% post_path link %}
2. 资源
   
   • 资源 {% asset_path path %}
   • 图片 {% asset_img path [title] %}
   • 链接 {% asset_link path [title] %}
3. 代码
   {% codeblock lang: java Hello.java http://www.baidu.com Hello.java %}
System.out.println("Hello");
{% endcodblock %}
4. Gist
   {% gist gist_id [filename] %}
5. 引言
   {% blockquote [author[, source]] [link] [source_link_title] %}
content
{% endblockquote %}

参考

1. 标签插件
2. 资源文件夹

主题

使用 NexT 主题

NexT
中文作者，支持程度好，所以选用

参考

1. Hexo Themes 主题列表
2. NexT 文档

参考

1. Hexo 文档
2. Github Pages

最后

以上就是受伤小蜜蜂最近收集整理的关于hexo 初识什么是 hexo发布一篇博客自定义参考的全部内容，更多相关hexo内容请搜索靠谱客的其他文章。