## Site #网站基本信息
title: Hexo #网站名称
subtitle: #副标题
description: #描述,会被搜索引擎抓取,分享文章的时候也会显示
author: John Doe #作者
language: #语言
timezone: #时区,留空为系统默认时区
# URL #网站URL信息
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://yoursite.com #网站URL
root: / #网站根目录,如果整个博客是一个网站的子目录,需要将根目录改为子目录的名称
permalink: :year/:month/:day/:title/ #每篇文章的URL格式
permalink_defaults: #默认URL格式
# Directory
source_dir: source
public_dir: public
tag_dir: tags
archive_dir: archives
category_dir: categories
code_dir: downloads/code
i18n_dir: :lang
skip_render:
# Writing
new_post_name: :title.md # File name of new posts #默认新文章的名字
default_layout: post #默认文章布局
titlecase: false # Transform title into titlecase
external_link: true # Open external links in new tab #是否在新标签页打开链接
filename_case: 0
render_drafts: false
post_asset_folder: false
relative_link: false
future: true
highlight: #代码高亮设置
enable: true #代码高亮开关
line_number: true #是否显示行号
auto_detect: false #是否自动判断语言
tab_replace: #用空格替换tab
# Category & Tag #目录与标签设置
default_category: uncategorized
category_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-DD #日期格式
time_format: HH:mm:ss #时间格式
# Pagination
## Set per_page to 0 to disable pagination
per_page: 10 #每页的文章数目
pagination_dir: page #页面路径
# Extensions #扩展配置,配置主题以及hexo插件信息
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: landscape #主题名称
# Deployment #发布相关配置,需要安装相应插件
## Docs: https://hexo.io/docs/deployment.html
deploy:
type:
Hexo的搭建
根据以下官网wiki安装即可 Nodejs Git Hexo
安装Nodejs,git
略
hexo
安装/初始化 hexo
之后打开终端,使用npm安装hexo,需要root权限进行某些文件的写入
博客初始化,hexo会初始化文件夹(没有会自己创建),博客所有内容将放在改文件夹中。 初始化完毕后,进入该文件夹中执行npm install对npm模块进行初始化安装
之后打开刚才的文件夹,会看到这样的结构
试着运行
用浏览器打开 http://localhost:4000
hexo编译的时候会出现报错:
这是模块报错,npm install 重装一遍
如果是墙的问题导致安装不成功,切换淘宝镜像源
新建文章
之后就会在 source/_posts/生成对应的md文件
多标签的写法
主题更换
hexo默认的主题是landscape,主题放在themes文件夹中,之后在hexo的配置文件_config.yml中将theme后的名称改成想更改的主题名称即可。主题的配置因主题而异,在主题中同样有一个_config.yml文件,是配置主题设置的,不要与hexo的配置文件弄混。
_config.yml配置文件
hexo的相关配置在这个文件中都可以配置,详细介绍一下
生成网站文件
之后会生成一个public文件夹,文件夹中的文件即为生成的网页文件。
将博客部署到github
按照github pages的说明配置,申请一个github帐号,之后新建项目,注意项目名称为用户名.github.io否则之后是无法访问的,一个账户只能建一个github pages。之后将之前的public文件夹里的内容都同步到这个项目的master分支,之后浏览器访问用户名.github.io就能看到hexo的博客界面了。
连接github同步可以直接使用git命令或者github客户端,但是这样都需要 hexo generate 之后再使用git,还是有些麻烦。hexo-deployer-git是hexo的一个插件,可以直接使用hexo命令在生成博客文件后部署到github上。 (此处关于github注册,连接,创建仓库不讲,自行搜索)
首先进入到博客文件夹,安装hexo-deployer-git
然后在博客的配置文件_config.yml(注意是hexo工作目录,不是主题中的)中添加
git地址在git主页中可以看到,注意选择ssh的地址
在本地生成ssh密钥(做连接github用)
读取生成密钥的公钥:id_rsa.pub
把显示出来的内容复制下来,然后到github的网页上,进入到设置界面,找到ssh key,新建一个key,那刚才的内容粘贴进去。 添加之后测试一下
第一次使用ssh连接github会有提示,输入yes即可,之后如果出现success的字样说明连接正常,ssh配置成功。 现在就可以使用hexo-deployer-git插件了,方法很简单,
hexo短命令
hexo支持短命令,使用起来不用输入太长的指令,只列出常用的:
至此博客已经可以使用了。