陈斌彬的技术博客

Stay foolish,stay hungry

搭建 Hexo 博客

初始化

然后,执行init命令初始化hexo到你指定的目录:

hexo init <folder>

也可以 cd 到目标目录,执行 hexo init

生成静态页面

cd 到你的init目录,执行如下命令,生成静态页面至 hexo\public\ 目录。

hexo generate

本地启动

执行如下命令,启动本地服务,进行文章预览调试。

hexo server

浏览器输入 http://localhost:4000 就可以看到效果。

命令小结

hexo n 写文章
hexo g 生成
hexo d 部署  可与hexo g合并为 hexo d -g

写文章

执行new命令,生成指定名称的文章至 hexo\source\_posts\postName.md

hexo new [layout] "postName" #新建文章

其中 layout 是可选参数,默认值为 post。有哪些 layout 呢,请到 scaffolds 目录下查看,这些文件名称就是 layout 名称。当然你可以添加自己的 layout,方法就是添加一个文件即可,同时你也可以编辑现有的 layout,比如 post 的 layout 默认是 hexo\scaffolds\post.md

title: { { title } }
date: { { date } }
tags:
---

请注意,大括号与大括号之间我多加了个空格,否则会被转义,不能正常显示。 我想添加 categories,以免每次手工输入,只需要修改这个文件添加一行,如下:

title: { { title } }
date: { { date } }
categories: 
tags: 
---

postName 是 md 文件的名字,同时也出现在你文章的 URL 中,postName 如果包含空格,必须用"将其包围,postName 可以为中文。

注意,所有文件:后面都必须有个空格,不然会报错。 看一下刚才生成的文件 hexo\source\_posts\postName.md ,内容如下:

title: postName #文章页面上的显示名称,可以任意修改,不会出现在URL中
date: 2013-12-02 15:30:16 #文章生成时间,一般不改,当然也可以任意修改
categories: #文章分类目录,可以为空,注意:后面有个空格
tags: #文章标签,可空,多标签请用格式[tag1,tag2,tag3],注意:后面有个空格
---

这里开始使用 markdown 格式输入你的正文。

录介绍

默认目录结构:

.
├── .deploy
├── public
├── scaffolds
├── scripts
├── source
|   ├── _drafts
|   └── _posts
├── themes
├── _config.yml
└── package.json
  • .deploy:执行hexo deploy命令部署到GitHub上的内容目录
  • public:执行hexo generate命令,输出的静态网页内容目录
  • scaffolds:layout模板文件目录,其中的md文件可以添加编辑
  • scripts:扩展脚本目录,这里可以自定义一些javascript脚本
  • source:文章源码目录,该目录下的markdown和html文件均会被hexo处理。该页面对应repo的根目录,404文件、favicon.ico文件,CNAME文件等都应该放这里,该目录下可新建页面目录。
  • _drafts:草稿文章
  • _posts:发布文章
  • themes:主题文件目录
  • _config.yml:全局配置文件,大多数的设置都在这里
  • package.json:应用程序数据,指明hexo的版本等信息,类似于一般软件中的 关于 按钮

Resource Reference