1.写作
可以执行下列命令来创建一篇新文章。
1 | hexo new [layout] <title> |
可以在命令中指定文章的布局(layout),不指定默认为 post
,也可以通过修改 _config.yml
中的 default_layout
参数来指定默认布局。创建的新文章会自动加上指定布局对应的模板文件中的内容。
1.1 布局(Layout)
Hexo 有三种默认布局:post
、page
和 draft
,它们分别对应不同的路径,而自定义的其他布局和 post
相同,都将储存到 source/_posts
文件夹。
布局路径postsource/_postspagesourcedraftsource/_drafts
1.2 模版(Scaffold)
在新建文章时,Hexo 会根据 scaffolds
文件夹内相对应的文件来建立文件,例如:
1 | hexo new photo "My Gallery" |
在执行这行指令时,Hexo 会尝试在 scaffolds
文件夹中寻找 photo.md
,并根据其内容建立文章
1.3 Front-matter
Front-matter是文件最上方以 ---
分隔的区域,用于指定个别文件的变量,举例来说:
1 | title: -----标题 |
2.网站发布
首先执行下列命令生成相应的静态网页,生成的静态网页以及相关资源都会在public
目录下
1 | hexo generate 或者 hexo g |
2.1 用hexo-server
hexo-server模块的主要命令如下,输入以下命令以启动服务器,网站会在 http://localhost:4000
下启动。在服务器启动期间,Hexo 会监视文件变动并自动更新,无须重启服务器。
1 | hexo server 或者 hexo s |
如果想要更改端口,或是在执行时遇到了 EADDRINUSE
错误,可以在执行时使用 -p
选项指定其他端口,如下:
1 | hexo server -p 5000 |
2.2 部署到Git上
这个需要先将本地博客部署到github才能使用,运行如下命令进行部署更新(部署过程中可能出现网络问题报错,可以多试几次):
1 | hexo deploy 或者 hexo d |
2.3 其他命令
为了避免不必要的错误,在生成静态文件前,强烈建议先运行以下命令:
1 | hexo clean 或者 hexo cl |
上述命令会清除本地站点文件夹下的缓存文件(db.json
)和已有的静态文件(public
)。