如何使用 Hexo 部署个人博客 | Jialun Liu
安装准备在安装 Hexo 前，需要安装 Node.js 和 Git, 详见 。
安装 Hexo利用 nvm 安装 Hexo。
sudo npm install -g --unsafe-perm hexo-cli
WordPress 迁移到 Hexo导出 WordPressWordPress & Tools & Export
安装 Hexo 插件npm install hexo-migrator-wordpress --save
Hexo 命令注意设置文件中，# 号后为注释。
完整命令完整的 Hexo 命令如下：
hexo clean hexo server hexo server --debug hexo generate
hexo deploy hexo generate --deploy
快捷命令快捷操作的 Hexo 省略命令如下：
hexo n hexo s hexo g hexo d hexo g d
安装 NexT 主题git clone /iissnan/hexo-theme-next themes/next
主题中的 categories 和 tags 页面需要手动创建 hexo new page &categories 和 hexo new page &tags&
After adding pages, the names of the pages should be defined in /themes/next/languages/'.
网站发布注册 GitHub
ssh -T ls -al ~/.sshgit config --global user.email ""git config --global user.name "J.Liu"ssh-keygen -t rsa -b 4096 -C "your_"pbcopy & ~/.ssh/id_rsa.pub
安装发布到 GitHub 的插件npm install hexo-deployer-git --save
FTPFTP 的布置可以参考
npm install hexo-deployer-ftpsync --save
不推荐使用这种模式发布，可以使用其他 FTP 工具将生成的网站直接上传到服务器上。
Configure RSS and sitemap如何生成 RSS 以供他人订阅，请参见
RSSnpm install hexo-generator-feed --save
添加 Sitemapnpm install hexo-generator-sitemap --savenpm install hexo-generator-baidu-sitemap --save
在 /_config.yml 文件里，添加
写作写作命令hexo new [layout] &title& hexo new page "New page name" hexo new draft "New draft name" hexo new post "New post name" hexo publish post "Old draft name"
添加图片添加图片有绝对路径和相对路径两种方法，推荐使用绝对路径的方法，相较而言比较稳定。当然也可以使用图床链接的方式，暂不讨论。
绝对路径添加图片的方法将图片存放在 source/images 文件夹中，然后通过类似  来访问。
相对路径添加图片的方法将 _config.yml 中 post_asset_folder 值改为 true，即 post_asset_folder: true。之后，每次新建 post 时，Hexo 会新建一个同 post 相同名的文件夹。此时，可以将相关资源放到这个相对文件夹中，然后通过 来引用。
控制图片大小&img src="./xxx.png" width = "300" height = "200" alt="图片名称" align=center /&
添加新 layoutAdd photo.md into scaffolds with the following contnent. This would be a layout for photos.
---layout: { { layout } }title: { { title } }date: { { date } }tags:photos:----
文章摘要以上是摘要&!--more--&以下是余下全文
第三方支持LaTeX 数学公式启用主题中 _config.yml 的 mathjax 选项。
enable: false
cdn: //cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML
###安装 hexo-generator-searchdb，在站点的根目录下执行以下命令：
$ npm install hexo-generator-searchdb --save
编辑 站点配置文件，新增以下内容到任意位置：
path: search.xml
field: post
format: html
limit: 10000
评论系统多说评论系统请参照
npm install hexo-generator-feed --save
如果遇到以下错误
FATAL (unknown path) [Line 7, Column 23]
Error: Unable to call `the return value of (posts["first"])["updated"]["toISOStrin"]`, which is undefined or falsey
应注意，public 里至少要有一篇 post 才能够生成 RSS，否则会报错。
添加站内搜索在
网站上注册，填写个人网站信息，直到生成 swiftype_key。之后将其，添加到 NexT主题中的 _config.yml 中。参考
网站访问计数NexT 主题中已经集成了不蒜子，可以直接修改主题配置文件中一下部分，将 false 改为 true 即可。另可进行个性化配置，详见 NexT
busuanzi_count:
enable: false
site_uv: true
site_uv_header: &i class="fa fa-users"&&/i&
site_uv_footer:
site_pv: true
site_pv_header: &i class="fa fa-eye"&&/i&
site_pv_footer:
page_pv: true
page_pv_header: &i class="fa fa-file-o"&&/i&
page_pv_footer:
插入指定大小图片{% img [class names] /path/to/image [width] [height] [title text [alt text]] %}
引用基本使用
{% blockquote [author[, source]] [link] [source_link_title] %}content{% endblockquote %}
{% blockquote David Levithan, Wide Awake %}Do not just seek happiness for yourself. Seek happiness for all. Through kindness. Through mercy.{% endblockquote %}
Markdown引用使用 & 符号即可。
& Quotation
Markdown假设要提供一个连接以供访客下载 book.pdf。首先在 ./source 下创建文件夹 book， 并将 book.pdf 添加进去。在编写 markdown 文档时使用[Download my book!](/books/book.pdf)。或者使用如下代码以提供给一个下载按钮：
{% raw %}&button onclick=&window.open(&/books/book.pdf&)&&Download&/button&{% endraw %}
结语本文写的较为简洁，如有疑问，敬请留言。
This is it.Cheers!Hexo 3.0 静态博客使用指南 - 推酷
Hexo 3.0 静态博客使用指南
上次我介绍了Hexo的基本搭建方法 近期
大神 又更新了3.0版本
和之前的2.0使用步骤略有不同 目前刚刚更新 可能有许多主题和插件不兼容3.0 请等待后续更新
本文介绍从零开始搭建的方法 如需从2.x升级到3.0 迁移方法请移至本文最后
I.Hexo简介
II.Hexo安装方法
III.Hexo配置方法
IV.Hexo部署方法
I.Hexo简介
Hexo 是一个轻量的静态博客框架。通过Hexo可以快速生成一个静态博客框架,仅需要几条命令就可以完成,相当方便。
而架设Hexo的环境更简单了 不需要lnmp/lamp这些繁琐复杂的环境 仅仅需要一个简单的http服务器即可使用 或者使用互联网上免费的页面托管服务
比如Hexo的官方网站
就是托管于github的pages服务上
II.Hexo安装方法
Mac OS X/Linux或其他UNIX/类UNIX系统
node环境 请去
下载源代码编译安装
wget http:
tar zxvf node-v0.12.0.tar.gz
cd node-v0.12.0
./configure --prefix=/usr
make install
npm(node包管理器)
redhat系 yum install npm -y
debain系 apt-get install npm -y
其他发行版请自行寻找wiki获得帮助
通过npm安装Hexo-Cli 和 hexo
npm install hexo-cli -g
npm install hexo
如果以上命令不能安装 可以尝试把官方源替换为
再执行安装Hexo
npm install -g cnpm --registry=https://registry.npm.taobao.org
或者你直接通过添加 npm 参数 alias 一个新命令:
alias cnpm=&npm --registry=https://registry.npm.taobao.org \
--cache=$HOME/.npm/.cache/cnpm \
--disturl=https://npm.taobao.org/dist \
--userconfig=$HOME/.cnpmrc&
Or alias it in .bashrc or .zshrc
$ echo '\n#alias for cnpm\nalias cnpm=&npm --registry=https://registry.npm.taobao.org \
--cache=$HOME/.npm/.cache/cnpm \
--disturl=https://npm.taobao.org/dist \
--userconfig=$HOME/.cnpmrc&' && ~/.zshrc && source ~/.zshrc
Windows系统（具体环境配置请参考
npm(node包管理器)
III.Hexo配置方法
新建一个需要当做博客目录的文件夹
mkdir blog
进去之后加入hexo主程序和安装npm
npm install
文件夹大致结构如下
scaffolds 工具模板
scripts hexo的功能js
source 博客资源文件夹
source/_drafts 草稿文件夹
source/_posts 文章文件夹
themes 存放皮肤的文件夹
themes/landscape 默认皮肤文件夹
_config.yml 全局配置文件
db.json json格式的静态常量数据库
_posts 目录：Hexo存放博客文章的文件夹
themes 目录：存放皮肤的文件夹，默认使用官方的主题 你也可以从
下载你喜欢的主题
Hexo全局配置
用文本编辑器修改_config.yml这个文件 大致如下 只需要自行修改几个 其他保持默认即可
通常需要修改站点名称 /URL格式 /归档设置 /disqus评论用户名 /部署配置 这几项就可以了 注意冒号后面都要添加一个半角空格 之后才是设置参数
自定义域名设置 在 source 我文件夹下面新建 CNAME 文件 里面写入你的自定义域名 并设置您的dns配置cname方式到服务提供商的给的地址即可
title 网站标题
subtitle 网站副标题
description 网站描述
author 您的名字
language 网站使用的语言
timezone 网站时区。Hexo 预设使用您电脑的时区。时区列表
参数 描述 默认值
root 网站根目录
permalink 文章的 永久链接 格式 :year/:month/:day/:title/
permalink_default 永久链接中各部分的默认值
网站存放在子目录
如果您的网站存放在子目录中，例如
并把 root 设为 /blog/。
参数 描述 默认值
source_dir 资源文件夹，这个文件夹用来存放内容。 source
public_dir 公共文件夹，这个文件夹用于存放生成的站点文件。 public
tag_dir 标签文件夹 tags
archive_dir 归档文件夹 archives
category_dir 分类文件夹 categories
code_dir Include code 文件夹 downloads/code
i18n_dir 国际化（i18n）文件夹 :lang
skip_render 跳过指定文件的渲染，您可使用 glob 来配置路径。
参数 描述 默认值
new_post_name 新文章的文件名称 :title.md
default_layout 预设布局 post
auto_spacing 在中文和英文之间加入空格 false
titlecase 把标题转换为 title case false
external_link 在新标签中打开链接 true
filename_case 把文件名称转换为 (1) 小写或 (2) 大写 0
render_drafts 显示草稿 false
post_asset_folder 启动 Asset 文件夹 false
relative_link 把链接改为与根目录的相对位址 false
future 显示未来的文章 true
highlight 代码块的设置
分类 & 标签
参数 描述 默认值
default_category 默认分类 uncategorized
category_map 分类别名
tag_map 标签别名
日期 / 时间格式
Hexo 使用 Moment.js 来解析和显示时间。
参数 描述 默认值
date_format 日期格式 MMM D YYYY
time_format 时间格式 H:mm:ss
参数 描述 默认值
per_page 每页显示的文章量 (0 = 关闭分页功能) 10
pagination_dir 分页目录 page
theme 当前主题名称
deploy 部署
Hexo常用插件安装与配置
安装首页文章数量 存档 分类 的插件
安装本地服务器代理插件
安装发布器插件
安装更新插件 rss site-map之类的
npm install hexo-generator-index
npm install hexo-generator-archive
npm install hexo-generator-category
npm install hexo-generator-tag
npm install hexo-server
npm install hexo-deployer-git
npm install hexo-deployer-heroku
npm install hexo-deployer-rsync
npm install hexo-deployer-openshift
npm install hexo-renderer-marked@0.2
npm install hexo-renderer-stylus@0.2
npm install hexo-generator-feed@1
npm install hexo-generator-sitemap@1
装完之后去全局配置文件 _config.yml 修改参数
index_generator:
per_page: 10 ##首页默认10篇文章标题 如果值为0不分页
archive_generator:
per_page: 10 ##归档页面默认10篇文章标题
yearly: true
##生成年视图
monthly: true ##生成月视图
tag_generator:
per_page: 10 ##标签分类页面默认10篇文章
category_generator:
per_page: 10 ###分类页面默认10篇文章
type: atom ##feed类型 atom或者rss2
path: atom.xml ##feed路径
##feed文章最小数量
type: git ##部署类型 其他类型自行google之
repo: &repository url& ##git仓库地址
branch: [branch] ##git 页面分支
message: [message] ##git message建议默认字段update 可以自定义
message: update
##git message建议默认字段update 可以自定义
github: &repository url&,[branch] ##github 仓库地址和分支
gitcafe: &repository url&,[branch] ##gitcafe 仓库地址和分支
更多插件可以去Hexo插件wiki找到
Hexo主题设置
同样编辑主题文件夹的 _config.yml
menu: #导航栏连接
Archives: /archives #归档页面URL
自定义页面标题: /自定义页面URL
rss: /atom.xml
excerpt_link: Read More #阅读更多的文字显示
fancybox: true #开启fancybox效果
#侧边栏设置
sidebar: right
- category
- tagcloud
- recent_posts
# Miscellaneous #社交网络和统计连接地址
google_analytics: #google analytics ID
favicon: /favicon.png #网站的favicon
google_plus:
fb_admins:
fb_app_id:
Hexo使用markdown语法的纯文本存放文章 后缀为 .md 你可以在 _post 文件夹里面新建这个后缀的 .md 文件 使用的全是UTF-8编码
也可以输入命令以生成
hexo new post &title&
如果是新建一个页面
hexo new page &title&
看一下刚才生成的
.md，内容如下：
title: title #文章标题
12:47:44 #文章生成时间
categories: #文章分类目录 可以省略
tags: #文章标签 可以省略
description: #你对本页的描述 可以省略
这里开始使用markdown格式输入你的正文。
多标签注意语法格式 如下:
想在首页文章预览添加图片可以添加photo参数 这个fancybox可以省略 如下:
正文中可以使用 &!--more--& 设置文章摘要 如下:
以上是文章摘要
以下是余下全文
more以上内容即是文章摘要，在主页显示，more以下内容点击『& Read More』链接打开全文才显示。
IV.Hexo部署方法
写完文章之后 就可以启动本地服务器测试了
hexo server
这个时候hexo启动localhost的4000端口 静态的网站架设完成
推荐部署在
的pages服务上
修改后就可以部署上去了
hexo clean
以上就是Hexo的基本使用方法 进阶的可以在Hexo的官方文档里找到 感谢阅读!
hexo3.0带来了更好的性能，更新了API，模块化了大部分组件。更多变化看这里：
hexo2.x到3.0迁移指南：
不会使用Hexo的也可以使用本人提供的博客服务 使用wordpress/typecho 更方便简单的后台管理
已发表评论数()
请填写推刊名
描述不能大于100个字符!
权限设置： 公开
仅自己可见
正文不准确
标题不准确
排版有问题
主题不准确
没有分页内容
图片无法显示
视频无法显示
与原文不一致更多最新文章相关作者文章搜狗：感谢您阅读最详细的Hexo博客搭建教程 本文版权归原作者所有，本文由网友投递产生，如有侵权请联系 ，会第一时间为您处理删除。