关于API,这是一个开始。

FarBox.com是构建于API之上的,也就是通过自定义模板实现的。
但在之前,我们仍然是有一些针对farbox.com的特殊处理,所以,直接重建一个farbox.com,是不可能的;因为,你无法提供自己的域名给别人使用。

我们最近提供的API,基本上去除了不该存在的特殊处理,然后就有了两个充满魅力的DEMO,见如下视频(IE浏览器可能看不了):


这次API到底有什么提升?

公共域名

这意味着,如果你有自己的独立域名,只要它注册为FarBox的公共域名,那么,其他人就可以使用其子域名绑定自己的网站了。

账户体系

简洁的登录、注册流程

在你的页面中,只需要使用超级链接,引导用户访问FarBox提供的登录页面,成功之后,会自动跳转回来。

变更角色(change_role)

通过change_role这个页面函数,可以获取当前用户相关数据(包括博客、图片等)的访问权限。
如何获取数据?跟往常一样使用get_posts之类的函数就可以了。

Web端的同步接口(sync-gateway)

当用户登录之后,通过URL上POST的数据传递方式,可以更新、新建文档,包括编辑文本、上传图片。
重要的是,这些数据会同步回用户自己的云盘(Dropbox/Google Drive)

模板包(Template Package)

模板包不仅仅是用来实现模板自动更新的。
它还有一个非常重要的角色,就是赋予新建网站以一个默认模板。
这意味着,如果通过FarBox API定制一个自己的BSP(博客托管服务),那么,你可以决定其默认的模板,并且可以随时更新。

更多?

还是参考api.farbox.com吧。


两个Demo


写在最后

向那些无论艰难险阻,情怀依然,一直追求着自己的理想的人致敬。
from @handsomegui

原本,我们想把这篇文章的标题名为“一个伟大的开始”,觉得不妥,把“伟大”变成“巨大”,倒会显得谦虚一些。
但这并不重要,重要的是,这一次,对我们自己来说,是一个里程碑的事情。

当我们依托于个人云端服务商的第三方接口,却提供了易用性更高的接口;这跟技术没有多大的关系,本质的驱动,来源于我们对于个人数据存在形式的思考。

这会帮我们打开一扇窗。
新的API的意义,并不是说可以用来重建一个FarBox.com;而是其所拥有的可能性。
如果你愿意,你甚至可以使用FarBox API + Google Drive重新构造一个Evernote,如果使用恰当的前端工具,这项工作甚至都不会耗费太多的时间。

互联网中的产品,多数的本质,是需要思考人与数据的关系。而不在于,具备了什么样的功能。
这便是我们的想法。


至于为什么会是一个开始。
因为,也许某一天,我们会说,“如果你愿意,你可以使用FarBox API + Dropbox重构一个属于自己的FaceBook”。

@2013-07-11 11:01
  • Anonymous2013-07-11 18:22

    这明明链接的是farbox嘛

  • Anonymous2013-07-13 23:39

    之前准备开始写blog或者做个小网站用下Jekyll等静态blog,今天了解了下常见的几个系统,又再次读了Farbox的官网blog,非常不错,觉得是一个有理想又很靠谱的服务。
    谢谢。加油。

  • Capricornusoel2013-07-15 20:58

    为啥这个模板克隆不了。。。=口=。。。。

  • Harry2013-07-16 09:25

    果然IT男都是很文艺的,连技术文章都可以写的这么有味道 O_o
    这会是一个开始,美好的开始!

  • Gryu2013-07-18 20:10

    很不错,良心farbox。

  • Gryu2013-07-18 21:00

    暂时还用不到这个,以后估计能用上。

  • Gryu2013-07-20 10:25

    为何我的归档(Archives)新的文章会在下面,旧文章在上面?排序是倒的。

  • Hepo2013-07-20 22:16

    @Gryu

    参考https://github.com/hepochen/farbox-templates/blob/master/Default%20V2/archive.html的代码

    第三行,控制的是当前页所有日志的次序,可能增加个sort='desc'就可以了。

    第七行,控制的是单个group(比如年份归档)内的次序。 :)

  • Hepo2013-07-20 22:17

    @Capricornusoel 因为,这个模板就是默认模板…… 克隆过去,相当于清空了一次原来的克隆……

    @Harry U2. :)

  • Gryu2013-07-20 22:27

    @Hepo

    您好,按照您提供的方式,依然无法解决问题,我在configs.html中添加了{% set file_sort = 'desc' %}(文件列表按日期的升降序,可选desc、asc),依然无解。

  • Hepo2013-07-20 22:32

    @Gryu

    不好意思,我没有说清楚, sort是get_posts的一个参数, file_sort这个孤立的变量并不会参与排序的

    {% set total_posts = get_posts(limit=300, sort='desc') %}  # 得到posts
    
    {% set entries = group(total_posts, 'date:year', reverse=True) %}  # 对posts进行group
    
    
    
    # 开始渲染archive
    
        {% for year, posts in entries %}
            {{ year }}
    
            {% for post in posts %}
    
                    {{ post.date | date("%Y-%m-%d") }}
                    {{ post.title }}
    
            {% endfor %}
    
        {% endfor %}
  • Gryu2013-07-20 22:33

    @Hepo

    非常感谢,已经解决了。
    http://gryu.net/archive

  • Hepo2013-07-20 23:03

    @Gryu Nice Job!

    提个小建议, js脚本对Gryu的模板来说,可能并不需要,去掉后完全用css控制,载入的速度应该会快上一些。 :)

  • Capricornusoel2013-07-21 10:15

    @Hepo 囧~都没发现~之前一段时间忙+懒,好久没写博了

  • Tony2013-07-21 16:08

    评论系统可能存在问题,我的同一个账号下建了二个网站,这二个网站中有一篇文件名一样的文章,之后,它们的评论信息被合并了,不管在哪边评论,两边都会显示,这二篇文章的地址是:http://tony.farbox.com/post/2013-07-17 和 http://fish.farbox.com/post/2013-07-17

  • Hepo2013-07-21 16:39

    @Tony, 是有这个问题,谢谢Tony,已经修复了。

  • Hepo2013-07-21 16:40

    @Capricornusoel 写博客都是这样子,陆陆续续写了10年的人,也都是如此。不过,终归会记录下一些东西,这样就比别人要好了。 :)

  • Gryu2013-07-22 08:46

    @Hepo

    嗯,最近上班比较忙,等闲空的时候重新整理下,对现在的模板还不太满意,呵呵,你说的很对,陆陆续续写博文也有六七年了,不过后面都不知道数据是怎么丢失的,可能是太忙,没来得及备份,空间就到期了,也可能是服务商跑路了,有很多很多的意外,写了N多的博文,基本没有几篇文章被完整的保存下来,不过现在放心了,只要硬盘别坏,就算是懒或者是没有空,都不会出现这种状况了。

  • Capricornusoel2013-07-22 17:05

    Do not send me the notifications from the sites of author again? please Click Here.
    手机上邮箱的时候不小心点了Click Here 怎么把通知弄回来QAQ

  • Tony2013-07-24 12:23

    @Hepo 我发现我的站点tony.farbox.com就是不能进行模板克隆,而另外建了一个站就可以,不知道什么原因,请帮忙看一下,谢谢。

  • Tony2013-07-24 12:27

    @Hepo 刚评论完,发现我的站点目录下多了一个Comment Life站点,奇怪,但是没有用处,被我删除了。

  • Hepo2013-07-24 12:30

    @Tony

    不知道克隆的hi哪个站点? 你的网站内有自己定义的模板源在,如果克隆空模板(比如blog.farbox.com)是无效的。

    http://king.farbox.com/template 里面再填tony.farbox.com,这样克隆无效么?

    呃,Comment Life就是你所有评论过别人的文字呀…… 它也是一个站点目录,也是可以绑定域名的。删了多可惜呀。

  • Tony2013-07-24 12:54

    @Hepo http://king.farbox.com/template 里面再填tony.farbox.com,这样克隆也无效,所以我才奇怪了。。

    Comment Life有用的话我就弄一下。。

  • Tony2013-07-24 12:59

    @Hepo 把评论弄成一个站,真不错,哈哈:http://comment.farbox.com/

  • Hepo2013-07-24 12:59

    @Capricornusoel hikeri#xxx.com 这个邮箱没有看到block的记录…… 不过,机制设计上是如果被block的话,到网站重新评论一次,会自动解锁的。

    @Tony, 好的,我再确认下。 Comment Life是个人决定是否保留,不过,每次评论,会push自己的内容到这个目录下的当日文件中,所以,Comment Life这个目录,应该算是删不掉的……

  • Tony2013-07-24 13:03

    @Hepo 不过希望评论信息中保留文章地址,这样Comment Life更有意义,将来去翻自己评论的时候,可以找到原文

  • Tony2013-07-24 13:10

    @Hepo 我看到了,是有地址的,这个功能强!

  • Tony2013-07-24 13:25

    @Hepo 不能克隆的问题,我找到原因了,估计是我换了个dropbox账号,但是又把邮箱号改成和原来一样了导致的,清cookie以后正常,还是谢谢啦

  • Tony2013-07-25 13:25

    @Hepo 不知道能否实现多模板共存呢?比如可以判断客户端是手机则显示适合手机的模板,如果是电脑就显示电脑的模板。

  • Gryu2013-07-28 08:44

    @Tony

    为何不使用响应式WEB主题?

  • Gryu2013-07-28 08:46

    @Hepo

    不知能否实现搜索功能?

  • Tony2013-07-29 10:42

    @Gryu 响应式主题是可以实现,但如能实现动态主题调度就更完美了,这样可以不需要修改现有主题。

  • v.v.2013-08-03 13:50

    那么你们现在在做什么,期待你们的更新。

  • carlhan2013-08-13 23:07

    你好,我想问一下,怎么样让一个页面隐藏起来,不出现在archive和category中,只有知道这个网页链接的人才能访问这个页面。

  • 好大的胆2013-12-17 18:22

    你好,请问我的网站nixwang.com的模板不能克隆,这是为什么呢?