ClearSilver

2010年12月1日 (三) 00:29的最后版本

ClearSilver is a fast, powerful, and language-neutral template system. It is designed to make it easy to create template driven static or dynamic websites.

http://www.clearsilver.net/

ClearSilver is first and foremost designed to be extremely fast. It is coded completely in C and exported to your script language of choice (i.e. Python, Perl). As a result, it is notably faster than template systems written in a script language. However, its design has additional benefits. It is also one of the only template systems available which allows you to easily mix-and-match multiple programming languages with the same templates, even on the same page. This allows you to optimize your website by writing C-modules to handle speed-sensitive sections, while leaving the majority of your site in easy to write script code.

Brandon Long. http://www.fiction.net/blong/

[编辑] Features

Fast, simple, language-neutral template system.
Modules currently available for C, Python, Perl.
Powerful template language supports variable substitution, template includes, conditionals, loops, macros, recursive macros, local variables.
Full CGI-handling kit with support for CGI/1.1, RFC 2388, automatic gzip compression, and other CGI standards.
"Pipelined" rendering model stores rendering data in an intermediate static dataset and makes debugging easier.
Separate your web application from its appearance.
Allow non-programmers access to edit parts of the site appearance.
Open Source and non-restrictive license

ClearSilver由3各部分组成：hdf数据描述，cst模版文件，py逻辑处理向hdf赋值

[编辑] Install

Debian

#apt-get install clearsilver-dev - headers and static library for clearsilver
#apt-get install python2.3-clearsilver - python bindings for clearsilver

or

./configure --prefix=/opt/clearsilver-0.10.2 \
 --with-python=/opt/python-2.4.2/bin/python \
 --disable-ruby --disable-java --disable-perl --disable-apache --disable-csharp

or windows

http://clearsilver.yi.org/

[编辑] Example

编写hdf文件:hello.hdf

# This is my static data for Hello World (and this is a comment)

Hello = Hello World!

WeekDays {
        0 = Sunday
        1 = Monday
        2 = Tuesday
        3 = Wednesday
        4 = Thursday
        5 = Friday
        6 = Saturday
}

编写模版文件:hello.cst

<?cs var:Hello ?>


<?cs each:day = WeekDays ?>
    On <?cs var:day ?>, <?cs var:Hello ?> 

<?cs /each ?>
<?cs if:?Query.day ?>
    On <?cs var:WeekDays[Query.day] ?>, <?cs var:Hello ?> 

<?cs /if ?>
Hey <?cs var:html_escape(Query.name) ?>, <?cs var:Hello ?>

这个模版文件唯一要注意的就是cs if:?Query.day，是用来处理链接参数的：cgi-bin/hello.py?day=1

然后将这两部分合二为一：

#!/usr/bin/python
#
# Hello World using the ClearSilver CGI Kit and Python

import neo_cgi

# create a CGI handler context
ncgi = neo_cgi.CGI()
 
# parse the form data (and post upload data)
ncgi.parse()
 
# Load our static data
ncgi.hdf.readFile("hello.hdf")

ncgi.display("hello.cst")

example from http://wiki.woodpecker.org.cn/moin/ClearSilver

http://www.clearsilver.net/docs/python/examples.cst

[编辑] Success Stories

Google Groups 2 - The new version of Google Groups uses ClearSilver. (C++/Python)
Yahoo Groups! is authored in ClearSilver's ancestor, "CS/HDF". (C, Python)
For HTML rendering, Trac uses the ClearSilver templating system.
Discogs - Discogs is a user-built database containing information on artists, labels, and their recordings. (Python)
Bloglines - Used by the server based RSS aggregator. (C)
Hassan Image Server - a server for sharing web-browsable photo repositories. (Python)

<discussion>characters_max=300</discussion>