Bitcron

目前处于内测阶段。
本文档的作用是面向模板构建的 API 调用以及 Bitcron 运行的一些基本机制的说明。

在本站的文档中,你可以了解到比较详细的 Bitcron 各个接口的调用。

如果有其它Bitcron上的问题,请访问https://faq.bitcron.com

Bitcron API的基本逻辑

  1. template 目录下,jade文件类型,视为网站的模板文件;
  2. 每个模板文件本身的路径,对应网站的URL路径;
  3. 使用API获取数据,每个数据根据不同的类型 (模板数据对象),会有不同的属性可供使用,按需呈现。

注意事项

  1. 自定义模板的时候,请确保在网站的设置(Dashboard)中的呈现(Render)中确保主题/Theme一栏留空并保存设置(不然,自定义的模板是不会生效的);
  2. 建议在网站设置中的呈现/Rrender中开启Debug Template,就能实现网站根据模板源码变化实时刷新。

我们的建议

  1. 模板不要过于复杂,控制template目录下的文件总数,一般不要超过20个;
  2. 不建议在template目录下有图片类的静态资源;
  3. 建议使用scss替代css,coffee script替代javascript,Bitcron模板内可以直接对它们进行渲染;
  4. 不要滥用URL的route规则,比如 index+base.jadeinclude/name_a+name_b.jade,类似的template路径名称,有点反逻辑。
  5. 当前访问、编辑、同步的服务节点,应该是同一个服务器节点,以避免同步的时滞(跨节点同步一般有十几秒的滞后)。