1. 常用命令
hexo help #查看帮助
hexo init #初始化一个目录
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成网页,可以在 public 目录查看整个网站的文件
hexo server #本地预览,'Ctrl+C'关闭
hexo deploy #部署.deploy目录
hexo clean #清除缓存文件 (db.json) 和已生成的静态文件 (public),
#用于更改变更了某些地方导致页面显示不完善
简写:
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy
2. 全局配置 _config.yml
# Hexo Configuration
## Docs: http://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/
# Site #站点信息
title: #标题
subtitle: #副标题
description: #站点描述,给搜索引擎看的
author: #作者
email: #电子邮箱
language: zh-CN #语言
# URL #链接格式
url: #网址
root: / #根目录
permalink: :year/:month/:day/:title/ #文章的链接格式
tag_dir: tags #标签目录
archive_dir: archives #存档目录
category_dir: categories #分类目录
code_dir: downloads/code
permalink_defaults:
# Directory #目录
source_dir: source #源文件目录
public_dir: public #生成的网页文件目录
# Writing #写作
new_post_name: :title.md #新文章标题
default_layout: post #默认的模板,包括 post、page、photo、draft(文章、页面、照片、草稿)
titlecase: false #标题转换成大写
external_link: true #在新选项卡中打开连接
filename_case: 0
render_drafts: false
post_asset_folder: false
relative_link: false
highlight: #语法高亮
enable: true #是否启用
line_number: true #显示行号
tab_replace:
# Category & Tag #分类和标签
default_category: uncategorized #默认分类
category_map:
tag_map:
# Archives
2: 开启分页
1: 禁用分页
0: 全部禁用
archive: 2
category: 2
tag: 2
# Server #本地服务器
port: 4000 #端口号
server_ip: localhost #IP 地址
logger: false
logger_format: dev
# Date / Time format #日期时间格式
date_format: YYYY-MM-DD #参考http://momentjs.com/docs/#/displaying/format/
time_format: H:mm:ss
# Pagination #分页
per_page: 10 #每页文章数,设置成 0 禁用分页
pagination_dir: page
# Disqus #Disqus评论,替换为多说
disqus_shortname:
# Extensions #拓展插件
theme: landscape-plus #主题
exclude_generator:
plugins: #插件,例如生成 RSS 和站点地图的
- hexo-generator-feed
- hexo-generator-sitemap
# Deployment #部署
deploy:
type: git
repo: 刚刚github创库地址.git 例如git@github.com:aaa/aaa.github.io.git
branch: master
注意
配置文件的冒号“:”后面有一个空格
3. 主题设置
主题下载和使用
Hexo官方文档包括基本操作、API、插件、主题。
NexT使用文档:next主题的安装与一些基本操作。
主题配置:
-
RSS
- 添加feed插件
$ npm install hexo-generator-feed $ npm install hexo-generator-sitemap
- 修改_config.yml,增加以下内容
# Extensions Plugins: - hexo-generator-feed #Feed Atom feed: type: atom path: atom.xml limit: 20
- 更改主题配置文件,设定 rss字段的值:
rss: /atom.xml
false:禁用 RSS,不在页面上显示 RSS 连接。
留空:使用 Hexo 生成的 Feed 链接。 你可以需要先安装 hexo-generator-feed插件。
具体的链接地址:适用于已经烧制过 Feed 的情形。
-
评论系统HyperComments
- 登录官网,购买免费版本
官网链接:https://www.hypercomments.com/pricing - 再填写完必要信息后,会出现代码,其中第四行:_hcwp.push({widget:"Stream", widget_id: xxxx});,复制这个ID,打开主题配置文件themes/next/_config.yml,加入如下描述:
# Hypercomments hypercomments_id: xxxx
没找到ID的,可以登录到管理页面,点击设置按钮,打开左侧的Widget下的code即可看到代码。顺带一提:code下的General可以设置评论提醒,大家自行摸索吧XD
参考从今天开始使用HyperComments啦! - 登录官网,购买免费版本
数据统计与分析
没有用任何统计工具,不蒜子应该不错
目前使用谷歌分析-
搜索
Local Search 由 flashlab 贡献
添加百度/谷歌/本地 自定义站点内容搜索- 安装 hexo-generator-searchdb,在站点的根目录下执行以下命令:
$ npm install hexo-generator-searchdb --save
- 编辑 站点配置文件,新增以下内容到任意位置:
search: path: search.xml field: post format: html limit: 10000
- 编辑 主题配置文件,启用本地搜索功能:
# Local searchlocal_ search: enable: true
- 安装 hexo-generator-searchdb,在站点的根目录下执行以下命令:
-
站点favicon
# Put your favicon.ico into `hexo-site/source/` directory. # 设置favicon的位置,如以下设置就表明图标在/source/favicon.ico favicon: /favicon.ico
本地预览和谷歌浏览器上加载不出ico图标
解决办法:
1. CTRL+SHIFT+DEL:直接进入“清除浏览数据”页面,包括清除浏览历史记录、清空缓存、删除Cookie等。
2. 按Ctrl+F5刷新,这时新的Favicon图标应该会出现了; 404页面(暂无法使用)
GitHub Pages 自定义404页面非常容易,直接在根目录下创建自己的404.html就可以。但是自定义404页面仅对绑定顶级域名的项目才起作用,GitHub默认分配的二级域名是不起作用的,使用hexo server在本机调试也是不起作用的。-
mapsite站点地图:引导搜索引擎爬取希望被收录的网页。提交好到一到两周,网站收录明显增加。
参考文章:
Hexo搭建的Github博客提交给Baidu、Google检索的问题- google验证时下载文件验证失败,使用备用方法:gogle分析
-google分析
Add Google Analytics to your hexo blog - 百度验证时下载文件方法验证失败,原因:选择验证网站时http与https的验证文件不一致,导致错误。应用https验证。最后成功。
- 使用Baidu主动提交链接方法在修改_config.yml的deploy出现错误,原因:符号格式:空格个数和“-”的位置。如下:
deploy: - type: git repo: git@github.com:github账号/仓库.github.io.git branch: master - type: baidu_url_submitter
Hexo插件之百度主动提交链接
Hexo 优化:提交 sitemap 及解决百度爬虫无法抓取 GitHub Pages 链接问题
Hexo Seo优化让你的博客在google搜索排名第一 - google验证时下载文件验证失败,使用备用方法:gogle分析
首页新增菜单项显示 Menu.xxx
NexT使用文档中开始使用->设置菜单about页面
hexo new page "about"
之后在source下的about文件夹下编写index.html留言板
不做了分享