Bitcron
目前处于内测阶段。
本文档的作用是面向模板构建的 API 调用以及 Bitcron 运行的一些基本机制的说明。
在本站的文档中,你可以了解到比较详细的 Bitcron 各个接口的调用。
如果有其它Bitcron上的问题,请访问https://faq.bitcron.com。
Bitcron API的基本逻辑
- template 目录下,jade文件类型,视为网站的模板文件;
- 每个模板文件本身的路径,对应网站的URL路径;
- 使用API获取数据,每个数据根据不同的类型 (模板数据对象),会有不同的属性可供使用,按需呈现。
注意事项
- 自定义模板的时候,请确保在网站的设置(Dashboard)中的
呈现(Render)
中确保主题/Theme
一栏留空并保存设置(不然,自定义的模板是不会生效的); - 建议在网站设置中的
呈现/Rrender
中开启Debug Template
,就能实现网站根据模板源码变化实时刷新。
我们的建议
- 模板不要过于复杂,控制template目录下的文件总数,一般不要超过20个;
- 不建议在template目录下有图片类的静态资源;
- 建议使用scss替代css,coffee script替代javascript,Bitcron模板内可以直接对它们进行渲染;
- 不要滥用URL的route规则,比如
index+base.jade
,include/name_a+name_b.jade
,类似的template路径名称,有点反逻辑。 - 当前访问、编辑、同步的服务节点,应该是同一个服务器节点,以避免同步的时滞(跨节点同步一般有十几秒的滞后)。