创建一个主题十分容易,只需要创建一个新的文件夹。想要开始你的主题,需要编辑 theme 设置在你的网页设置的 saber-config.yml :
theme: ./src
# or from a npm package
# call `saber-theme-simple`:
theme: simple
一个主题需要具有以下文件结构:
.
├── saber-browser.js # optional
├── saber-node.js # optional
└── layouts # required
主题布局被填充在 $ Theme/layouts 目录下,这个目录是必需的,$projectRoot/layouts 中的布局仍然可以工作,并且具有更高的优先级。
Ejecting
如果你正在使用一个来自npm的主题,并希望修改它以更好地满足你的需求,你可能想要退出它。这将复制源代码到 ./theme 以允许您编辑它。
saber eject-theme
以上命令需要使用从 node_modules 中的文件,但是如果你想要从仓库(调用)源代码,需要添加 –git。这将把主题的Git存储库克隆为子模块,这增加了更容易升级的好处,对上游代码的贡献和更好的版本控制管理。
Submitting Themes
我们在此页面展示了高质量的官方和社区主题,您可以按照以下指南获得您的主题:
首先,你需要fork Saber 并且克隆它到本地:
git clone git@github.com:YOUR_USERNAME/saber.git
然后添加一个预览图像到 website/pages/theme/previews 文件夹,有一些要求的图像应该满足:
- PNG格式
- 使用npm管理包命名,例如 saber-theme-minima.png
- 尺寸需要在 1024*768 / 或者 2048*1536
- 80kb以下,使用 TinyPNG压缩,若需要
最后打开 website/pages/theme/_themes.yml 并添加你的主题,例如:
- name: Minima
npm: saber-theme-minima
demo: https://minima.saber.land
repo: https://github.com/saberland/saber-theme-minima
tags:
- Blog
- Clean
- Minimal