Blog也写了,照片也贴了。

下面就该深挖一下了。

首先是一些基础。

The Django Book,Django是用Python写的一个Web框架,FarBox最初也是在Django上实现的,看FarBox的Blog是因为Django太过厚重转移到了别的框架。这边本书最开始的几章可以让你了解基本的概念,大概明白网站是怎么搭建之后,就去着重看下模板和模板高级进阶两章,虽然FarBox也转到了其他的模板,但是明白模板的原理和使用已经足够了。

事实你不需要了解任何Python的知识,模板功能在设计之初就考虑到了,使用模板的人一般不会是程序员,所以是尽可能的隐藏背后的代码。当然,里面会有变量,会有循环,而且还是Python风格,但你只是要使用不会妨碍你。

然后是Html与Css,FarBox就是读取你的Dropbox中的*.md文件与图片,通过约定的变量去渲染模板。有什么变量,主要的url映射都是写死的,所以你能定制的东西就局限在了页面上。不会html和css的话定制就无从谈起了。
网上搜了两个教程,html教程css教程

前面讲过,FarBox是通过约定的变量去渲染模板,所以有什么变量可以使用就是最关键的了。这些约定好的东西只能是开发文档,FarBox有提供,点我穿越,里面有API文档,域名,常见问题等等。自己打算定制前还是好好看看吧。

首先是url映射关系,web框架是将不同的url对应到不同的功能函数,这些函数去为你展现不同页面(使用不同的模板)。FarBox这些功能都是约定好的,所以你想使用这些功能并定制页面的外观的话,就必须遵守这个约定。

然后就是我们都有什么变量可以用,每个变量里面都有什么内容。
首先是有一部分变量是所有页面共享的。

页面名 url 使用的模板
首页 / index.html
文章详细页 /post/ post.html
文章分类页 /category/ category.html
标签匹配页 /tags/ tags.html
博客归档页 /archive archive.html
文件目录 /folder/ & /folder/ folder.html
单文件详细 /file/ file.html
RSS订阅页 /feed feed.html
MarkDown文档页 / markdown.html
静态文件 /
404页面 errors/404.html

这一个url就对应着一个函数和一个模板。每个函数用特有的变量去渲染模板。(模板只是框架,没有内容,变量的值就是内容,渲染就是把内容放到框架中,变成一个真正的网页)。
举个例子index.html这个模板(我总打成moban,痛苦),对应url路径'/',意思就是你直接打你blog的网址就会调用index.html这个模板,然后在API文档查看下index.html我们有什么变量可以用。

页面名 变量
全局变量 site request session_account
首页 index.html posts files paginator
文章详细页 post.html post comment_allowed comment_content error
文章分类页 cateogry.html posts paginator
博客归档页 archive.html posts paginator archive
标签匹配页 tags.html tags posts paginator
博客列表页 posts.html posts paginator
文件目录 folder.html folder files paginator

单文件详细| file.html| file
RSS订阅页 |feed.html| posts
文本直显页 markdown.html| post