生成静态博客站点的程序。
全局安装:
> npm install amberpine -g
本地安装:
> mkdir myblog
> cd myblog
> npm install amberpine --save-dev
> abp i # 全局安装
> node_modules/.bin/abp i # 本地安装
在当前目录下生成结构:
source
目录存放博客文章列表。assets
目录中存放静态资源,包含一个必须的index.css
文件,可修改此文件来改变样式。
> abp d
参考 source/first-post
目录中的 yaml
文件和 md
文件进行写作。文章编辑保存时,浏览器会自动刷新以体现最新的进展。
> abp
执行此命令将在 dist 目录下生成完整的站点,包含一个首页 index.html
和每篇文章的一个 html
页。
一般情况下,将 dist 目录作为根目录完整地发布到任何静态文件服务器即可。一个常用的选择是 github-pages。可以使用 travis-ci 来完成构建。
language: node_js
node_js:
- 9.11.2
script:
- npm install amberpine
- node_modules/.bin/abp
- cp .nojekyll dist # 此文件是为了防止 githuh-pages 将仓库当做 jekyll 项目来构建,如果你没有使用 gitub-pages,可删除此文件。
branches:
only:
- source # 文章的源文件(md 文件)放在这个分支上
deploy:
provider: pages
local_dir: dist
skip_cleanup: true
github_token: $GITHUB_TOKEN # 在 Travis-CI 上设置 GITHUB_TOKEN,参考上面引用的 travis-ci 教程
on:
branch: source
target_branch: gh-pages # 对项目主页来说通常是 gh-pages 分支,但对个人/组织主页来说,通常是 master 分支