1 ************************************ 2 * Clearsilver README 3 ************************************ 4 5 For more information, see the website: 6 7 http://www.clearsilver.net/ 8 9 This package includes Clearsilver, the CGI kit and HTML templating 10 system. For information about building and installing, see the 11 included INSTALL file. This package also includes tools which 12 help you use Clearsilver, as well as a few examples. 13 14 ************************************************************ 15 *** Clearsilver 16 17 * Clearsilver - This is our html template system and cgi kit. 18 19 There are too many great things about clearsilver to list them all 20 here, but here are some of the salient points: 21 22 * get the html out of your code 23 * loops, conditionals, macros, and stuff 24 * cgi kit unifies query variable and cookie handling 25 * super-easy to go from static mockup to dynamic page 26 * run multiple front-ends on the same application code 27 * super-fast C-library 28 * unifies Query variable and cookie handling 29 * language neutral (C,C++,Python,Ruby,Perl,Java,C#) 30 * nice iterative page debugging/development features 31 * generate static-data-driven page content without using any code 32 * did I mention super-fast? 33 34 Supported language information: 35 36 README.python 37 38 ************************************************************* 39 *** Tools 40 41 * trans.py 42 43 This is our transparent translation system. It's based on how we did 44 translation at Yahoo!. You leave all the english strings right in the 45 clearsilver templates. trans parses the html and extracts your 46 language strings into a translation database. You can then translate 47 the strings using any means. (it includes tools for dump and loading 48 per-language files for shipping to translators). Occasionally trans 49 isn't smart enough to find your language strings, in this case you can 50 manually extract them into static language string files and trans will 51 automatically pick them up. When it comes time to ship, trans 52 generates language-independent templates, and a set of language files 53 from your database. 54 55 ************************************************************* 56 *** Examples 57 58 * static.cgi 59 60 This is a standalone binary which handles Clearsilver rendering of 61 static content. This is a great way to play with clearsilver syntax 62 before you start writing dynamic CGIs with it. This is also a great 63 way to do webpage mockups with much more power than server side 64 includes. See the INSTALL file for information about configuring 65 this for use with apache. 66 67
