Official repository for the ClearSilver templating language and webkit
C Python Java Smalltalk Makefile Other Other
Latest commit e02d1ae Mar 8, 2012 blong42 fix registration of CGIParseNotHandled
Permalink
Failed to load latest commit information.
cdbi update copyright notice Jul 28, 2004
cgi fix registration of CGIParseNotHandled Mar 8, 2012
contrib new emacs cs mode from Gaku Aug 18, 2003
cs Expand logging facilities with more prefix options, make logging Jul 20, 2009
csharp Some updates for newer versions of mono, compiles now, but the Jul 12, 2007
dso Use separate streamhtmlparser and remove the bundled one. Jul 8, 2009
imd fix quality=1 for gif and send full size if maxH/maxW are 0 Dec 15, 2011
java Conversion from Google tree to SVN seems to have missed the entire java Apr 20, 2010
m4 better pthreads detection for the *BSDs Mar 16, 2009
mod_ecs Use separate streamhtmlparser and remove the bundled one. Jul 8, 2009
perl Use separate streamhtmlparser and remove the bundled one. Jul 8, 2009
ports Update to 0.10.5 Jul 11, 2007
python Security: don't pass raw string to cgi_error, it expects a format Nov 29, 2011
ruby Use separate streamhtmlparser and remove the bundled one. Jul 8, 2009
scripts always check the return of realloc w/o overriding the original Aug 8, 2007
util minor fix to remove uninitialized variable warnings Sep 8, 2010
COPYING Various cleanups in preparation for a new release, new LICENSE, Jun 29, 2009
ClearSilver.h Fix hash traversal Jun 29, 2009
INSTALL add gettext support from Gerald Dachs <gda@gmx.de> Mar 16, 2004
LICENSE Various cleanups in preparation for a new release, new LICENSE, Jun 29, 2009
Makefile make streamhtmlparser deps work better Nov 17, 2009
README add to readme Aug 11, 2003
README.python new readme files Aug 11, 2003
README_VS.TXT Various cleanups in preparation for a new release, new LICENSE, Jun 29, 2009
acconfig.h update copyright notice Jul 28, 2004
autogen.sh Changes for portability Nov 21, 2005
config.guess Changes to make compatible with amd64 and newer python versions Oct 21, 2005
config.sub Changes to make compatible with amd64 and newer python versions Oct 21, 2005
configure.in Detect java installed directly in the path Oct 5, 2009
cs_config.h.in Use separate streamhtmlparser and remove the bundled one. Jul 8, 2009
install-sh first attempt at autoconf based configuration Apr 2, 2003
java-jni Make java-jni a symlink pointing to java/lib prebuilt library directory. Jul 30, 2008
mkinstalldirs first attempt at autoconf based configuration Apr 2, 2003
rules.mk.in Use separate streamhtmlparser and remove the bundled one. Jul 8, 2009

README

************************************
* Clearsilver README   
************************************

For more information, see the website:

  http://www.clearsilver.net/

This package includes Clearsilver, the CGI kit and HTML templating
system. For information about building and installing, see the
included INSTALL file. This package also includes tools which
help you use Clearsilver, as well as a few examples.

************************************************************
*** Clearsilver

* Clearsilver - This is our html template system and cgi kit. 

There are too many great things about clearsilver to list them all
here, but here are some of the salient points:

  * get the html out of your code
  * loops, conditionals, macros, and stuff
  * cgi kit unifies query variable and cookie handling
  * super-easy to go from static mockup to dynamic page
  * run multiple front-ends on the same application code
  * super-fast C-library
  * unifies Query variable and cookie handling
  * language neutral (C,C++,Python,Ruby,Perl,Java,C#)
  * nice iterative page debugging/development features
  * generate static-data-driven page content without using any code
  * did I mention super-fast?

Supported language information:

  README.python

*************************************************************
*** Tools

* trans.py

This is our transparent translation system. It's based on how we did
translation at Yahoo!. You leave all the english strings right in the
clearsilver templates. trans parses the html and extracts your
language strings into a translation database. You can then translate
the strings using any means. (it includes tools for dump and loading
per-language files for shipping to translators). Occasionally trans
isn't smart enough to find your language strings, in this case you can
manually extract them into static language string files and trans will
automatically pick them up. When it comes time to ship, trans
generates language-independent templates, and a set of language files
from your database.

*************************************************************
*** Examples

* static.cgi

This is a standalone binary which handles Clearsilver rendering of
static content. This is a great way to play with clearsilver syntax
before you start writing dynamic CGIs with it. This is also a great
way to do webpage mockups with much more power than server side 
includes.  See the INSTALL file for information about configuring 
this for use with apache.