前置环境
安装hexo并初始化
创建一个文件夹hexo,在其中右键进入 Git Bash
1 | $ npm install hexo-cli -g |
hexo文件夹是本地网站开发环境文件夹
此时hexo文件夹目录如下
1 | . |
scaffolds
模版文件夹。当您新建文章时,Hexo 会根据 scaffold 来建立文件。
Hexo的模板是指在新建的markdown文件中默认填充的内容。例如,如果您修改scaffold/post.md中的Front-matter内容,那么每次新建一篇文章时都会包含这个修改。
source
资源文件夹是存放用户资源的地方。除 _posts 文件夹之外,开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹,而其他文件会被拷贝过去。
themes
主题 文件夹。Hexo 会根据主题来生成静态页面。
修改网站配置
hexo/_config.yml 是我们的网站配置文件
您可以在
_config.yml中修改大部份的配置。网站
参数 描述 title网站标题 subtitle网站副标题 description网站描述 author您的名字 language网站使用的语言,简体汉字使用 zh-Hanstimezone网站时区。Hexo 默认使用您电脑的时区。时区列表。比如说: America/New_York,Japan, 和UTC。其中,
description主要用于SEO,告诉搜索引擎一个关于您站点的简单描述,通常建议在其中包含您网站的关键词。author参数用于主题显示文章的作者。网址
参数 描述 默认值 url网址 root网站根目录 permalink文章的 永久链接 格式 :year/:month/:day/:title/permalink_defaults永久链接中各部分的默认值 网站存放在子目录
如果您的网站存放在子目录中,例如
http://yoursite.com/blog,则请将您的url设为http://yoursite.com/blog并把root设为/blog/。扩展
参数 描述 theme当前主题名称。值为 false时禁用主题deploy部署部分的设置 详细内容请参考
hexo文档
安装主题
本博客选择的是next主题
你可以在hexo主题页面找到更多主题,设置主题的方法大同小异
1 | $ cd hexo |
此时打开hexo/themes,可以发现除了hexo默认的landscape主题以外,还多了一个主题文件夹next,打开这个文件夹,有一个文件_config.yml,这是next主题配置文件,
修改hexo/_config.yml文件,找到 theme 标签,将其值修改为 next
1 | theme: next |
现在可以删除landscape文件夹了
本地试运行网站
在hexo文件夹下进入 Git Bash
1 | $ hexo s --debug |
运行完成后打开http://localhost:4000/
配置主题
编辑 hexo/themes/next/_config.yml
主题样式 Scheme 标签
Scheme 是 next 提供的一种特性,借助于 Scheme,next 为你提供多种不同的外观。同时,几乎所有的配置都可以 在 Scheme 之间共用。目前 next 支持三种 Scheme,他们是:
Muse - 默认 Scheme,这是 NexT 最初的版本,黑白主调,大量留白
Mist - Muse 的紧凑版本,整洁有序的单栏外观
Pisces - 双栏 Scheme,小家碧玉似的清新
Gemini - 左侧网站信息及目录,块+片段结构布局
Scheme 的切换通过更改主题配置文件,搜索 scheme 关键字。 你会看到有四行 scheme 的配置,将你需用启用的 scheme 前面注释 # 去除即可。
菜单 Menu标签
1 | menu: |
看看你需要哪个菜单就把哪个取消注释打开就行了
||之后的archive表示图标,Next主题所有的图标都来自Font Awesome图标库。
侧栏sidebar标签
sidebar:1
2
3
4
5
6
7
8
9
10
11
12
13
14
position: left //靠左放置
display: always //在所有页面中都显示
offset: 12 //文章间距(只对Pisces | Gemini两种风格有效)
b2t: false //返回顶部按钮(只对Pisces | Gemini两种风格有效)
scrollpercent: true //返回顶部按钮的百分比
头像 avatar标签
1 |
|
将你的头像命名为avatar.jpg放入themes/next/source/images(没有请创建)中
更多配置请参考
next官方文档以及万能的
百度
生成及部署
进入hexo文件夹并打开Git Bash
1 | $ cd hexo |
或者简写为
1 | $ hexo g |
此时将生成静态文件夹 hexo/public
将这个文件夹 git push 到你的Github下的 username.github.io repo(没有请新建),其中 username 是你的Github用户名
然后打开网址username.github.io
即可看到你的博客
或者使用git进行部署
修改
hexo/_config.yml中的deploy标签
1
2
3
4
5 > deploy:
> type: git
> repo: git.com:username/username.github.io.git
> branch: master
>
>
安装
hexo-deployer-git
1
2 > $ npm install hexo-deployer-git --save
>
>
生成
1
2 > $ hexo generate
>
>
部署
1
2 > $ hexo deploy
>
>
或者
您可执行下列的其中一个命令,让 Hexo 在生成完毕后自动部署网站,两个命令的作用是相同的。
1
2
3 > $ hexo generate --deploy
> $ hexo deploy --generate
>
>
简写
上面两个命令可以简写为
1
2
3 > $ hexo g -d
> $ hexo d -g
>
写作
hexo写作使用Markdown格式(本文也是)
Markdown格式文件后缀一般为.md
Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑,Markdown 的语法十分简单。常用的标记符号也不超过十个,这种相对于更为复杂的 HTML 标记语言来说,Markdown 可谓是十分轻量的,学习成本也不需要太多,且一旦熟悉这种语法规则,会有一劳永逸的效果。
这里推荐一个非常好用的markdown编辑器
typora
请在每个 .md文件开头加入标题格式1
2
3
title: yourtitle
将写好的 .md 文件放入/hexo/source/_posts重新生成部署即可
注意:
_posts文件夹是博文存储目录==呼,写完了==
以后可能还会更新更多新东西