Hexo NexT 博客本地搭建指南

阅读量：7105 次

发布时间：2019-06-28

本文共 4706 字，大约阅读时间需要 15 分钟。

0x01 写在前面的话

第一次见到这个这个Hexo主题，是在查找lucene学习指南时看到了，文章写的自然不错，但博客程序主题更是令我喜欢不已.

于是我便萌生了也想撸一个的冲动。

既然想撸一个，那么咱们自然首先得来Hexo 官网看看吧。

0x02 上官网

Hexo官网：

0x03 四大特性

Tips:这么好的东西，就问你心动不心动~

0x04 搭建环境

点击开始后我们便进入了开发文档界面，

安装前提

安装 Hexo 相当简单。然而在安装前，您必须检查电脑中是否已安装下列应用程序：

Node.js

如果您的电脑中已经安装上述必备程序，那么恭喜您！接下来只需要使用 npm 即可完成 Hexo 的安装。

$ npm install -g hexo-cli

Mac 用户

您在编译时可能会遇到问题，请先到 App Store 安装 Xcode，Xcode 完成后，启动并进入 Preferences -> Download -> Command Line Tools -> Install 安装命令行工具。

如果您的电脑中尚未安装所需要的程序，请根据以下安装指示完成安装

安装 Git

Git官网:

Windows：下载并安装 git.

Mac：使用 , ：brew install git;或下载安装。

Linux (Ubuntu, Debian)：sudo apt-get install git-core

Linux (Fedora, Red Hat, CentOS)：sudo yum install git-core

Windows 用户

由于众所周知的原因，从上面的链接下载git for windows最好挂上一个代理，否则下载速度十分缓慢。也可以参考，收录了存储于百度云的下载地址。

安装 Node.js

安装 Node.js 的最佳方式是使用 nvm，但是由于下面这个提示，咱们直接用安装包安装吧。

如果想用nvm方式安装请移步：

Windows 用户

对于windows用户来说，建议使用安装程序进行安装。安装时，请勾选Add to PATH选项。
另外，您也可以使用Git Bash，这是git for windows自带的一组程序，提供了Linux风格的shell，在该环境下，您可以直接用上面提到的命令来安装Node.js。打开它的方法很简单，在任意位置单击右键，选择“Git Bash Here”即可。由于Hexo的很多操作都涉及到命令行，您可以考虑始终使用Git Bash来进行操作。

node.js 官网：

下载后点击安装，我们可以看到这个界面

Tips: 这里我们看到在安装Node.js 的时候会安装一个NPM 包管理器，这样我们才能执行待会的NPM命令。

安装 Hexo

在任意位置单击右键，选择“Git Bash Here”即可。

Tips: 由于Hexo的很多操作都涉及到命令行，您可以考虑始终使用Git Bash来进行操作。

所有必备的应用程序安装完成后，即可使用 npm 安装 Hexo。

$ npm install -g hexo-cli

执行后会像这样

0x05 建站

安装 Hexo 完成后，我们其实需要切换下目录

当前我们位置处于桌面，因此假设我想把站建立在C:\Users\fairy\Documents\HexoBlog目录下

那么需要执行命令

cd ..

Tips:这里注意下这个cd和..后面要有空格，这个是和linux有点不太一样的。

再切换到Documents目录

cd Documents

创建文件夹HexoBlog

mkdir HexoBlog

请执行下列命令，Hexo 将会在指定文件夹中新建所需要的文件。

hexo init HexoBlog

执行成功后会变成这样

然后进入这个文件夹

cd HexoBlog

进行安装

npm install

执行命令后卡看到回显：

生成目录结构哦如图所示

新建完成后，指定文件夹的目录如下：

. ├── _config.yml ├── package.json ├── scaffolds ├── source | ├── _drafts | └── _posts └── themes

_config.yml

网站的信息，您可以在此配置大部分的参数。

package.json

应用程序的信息。, 和 renderer 已默认安装，您可以自由移除。

{  "name": "hexo-site",  "version": "0.0.0",  "private": true,  "hexo": {    "version": ""  },  "dependencies": {    "hexo": "^3.2.0",    "hexo-generator-archive": "^0.1.4",    "hexo-generator-category": "^0.1.3",    "hexo-generator-index": "^0.2.0",    "hexo-generator-tag": "^0.2.0",    "hexo-renderer-ejs": "^0.3.0",    "hexo-renderer-stylus": "^0.3.1",    "hexo-renderer-marked": "^0.3.0",    "hexo-server": "^0.2.0"  }}

scaffolds

文件夹。当您新建文章时，Hexo 会根据 scaffold 来建立文件。

Hexo的模板是指在新建的markdown文件中默认填充的内容。例如，如果您修改scaffold/post.md中的Front-matter内容，那么每次新建一篇文章时都会包含这个修改。

source

资源文件夹是存放用户资源的地方。除 _posts 文件夹之外，开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹，而其他文件会被拷贝过去。

themes

文件夹。Hexo 会根据主题来生成静态页面。

0x06 配置

Hexo配置：

0x07 指令

Hexo指令:

0x08 迁移

Hexo迁移:

0x09 配置NexT模板

其他中文教程：

在终端切换到hexo 根目录. 在hexo目录下一定有 node_modules, source, themes 和其他文件夹:

ls

执行后你将看到这样的界面：

从 github 上获取主题

下载最新发布的版本

下载地址：

创建主题文件夹

mkdir themes/next

解压后结构如图所示：

复制解压的文件到theme/next文件夹下

在 hexo 根目录下的配置文件_config.yml里设置主题:

# Extensions## Plugins: https://hexo.io/plugins/## Themes: https://hexo.io/themes/theme: next

配置文件详情：

# Hexo Configuration## Docs: https://hexo.io/docs/configuration.html## Source: https://github.com/hexojs/hexo/# Sitetitle: Hexosubtitle:description:keywords:author: John Doelanguage:timezone:# URL## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'url: http://yoursite.comroot: /permalink: :year/:month/:day/:title/permalink_defaults:# Directorysource_dir: sourcepublic_dir: publictag_dir: tagsarchive_dir: archivescategory_dir: categoriescode_dir: downloads/codei18n_dir: :langskip_render:# Writingnew_post_name: :title.md # File name of new postsdefault_layout: posttitlecase: false # Transform title into titlecaseexternal_link: true # Open external links in new tabfilename_case: 0render_drafts: falsepost_asset_folder: falserelative_link: falsefuture: truehighlight:  enable: true  line_number: true  auto_detect: false  tab_replace:  # Home page setting# path: Root path for your blogs index page. (default = '')# per_page: Posts displayed per page. (0 = disable pagination)# order_by: Posts order. (Order by date descending by default)index_generator:  path: ''  per_page: 10  order_by: -date  # Category & Tagdefault_category: uncategorizedcategory_map:tag_map:# Date / Time format## Hexo uses Moment.js to parse and display date## You can customize the date format as defined in## http://momentjs.com/docs/#/displaying/format/date_format: YYYY-MM-DDtime_format: HH:mm:ss# Pagination## Set per_page to 0 to disable paginationper_page: 10pagination_dir: page# Extensions## Plugins: https://hexo.io/plugins/## Themes: https://hexo.io/themes/theme: next# Deployment## Docs: https://hexo.io/docs/deployment.htmldeploy:  type:

View Code

执行部署命令