1
0
mirror of https://github.com/OlafvdSpek/ctemplate.git synced 2025-09-28 19:05:49 +08:00
ctemplate/doc/index.html
csilvers a9b9d3190b Mon Oct 19 11:42:57 2009 Google Inc. <opensource@google.com>
* ctemplate: version 0.96 release
	* Support multiple template root directories (williasr)
	* Remove TemplateContext from TemplateToString (jad)
	* Remove programmatic auto-escape code (jad)
	* Speedup: use linker to detect immutable TemplateStrings (csilvers)
	* Implement ShowTemplateGlobalSection (williasr)
	* Change SetIntValue to accept longs (omoikane)
	* Allow TemplateDictionary c'tor to take a TemplateString (csilvers)
	* Make Mutex safer to run during global destructors (csilvers)
	* BUILD: don't set TMPDIR when building; ar reads it (csilvers)
	* BUILD: fix compiling of C (as opposed to C++) test file (csilvers)
	* BUILD: remove bash-specific 'test x == y' from configure.ac (csilvers)
	* BUGFIX: use AllocAligned when allocating non-char objects (csilvers)
	* PORTING: remove obsolete MSVC Detect64BitPortabilityProblems (csilvers)
	* Updated from autoconf 2.61 to 2.62
2009-10-20 17:29:07 +00:00

115 lines
3.2 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>Google Template System</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="http://www.google.com/favicon.ico" type="image/x-icon"
rel="shortcut icon">
<link href="designstyle.css" type="text/css" rel="stylesheet">
<style type="text/css">
<!--
ol.bluelist li {
color: #3366ff;
font-family: sans-serif;
}
ol.bluelist li p {
color: #000;
font-family: "Times Roman", times, serif;
}
ul.blacklist li {
color: #000;
font-family: "Times Roman", times, serif;
}
//-->
</style>
</head>
<body>
<h1> <a name="Google_Template_System"></a>Google Template System </h1>
<center><strong>Status: Current</strong> &nbsp;
<small>(as of 25 April 2008)</small></center>
<br>
Welcome to the Google C++ template system! As a quick start, here's a
small but complete program that uses this template library. For more
details see, the links below.
<h3>Template file <code>example.tpl</code></h3>
<pre>
Hello {{NAME}},
You have just won ${{VALUE}}!
{{#IN_CA}}Well, ${{TAXED_VALUE}}, after taxes.{{/IN_CA}}
</pre>
<h3>C++ program <code>example.cc</code></h3>
<pre>
#include &lt;stdlib.h>
#include &lt;string>
#include &lt;iostream>
#include &lt;ctemplate/template.h>
int main(int argc, char** argv) {
ctemplate::TemplateDictionary dict("example");
dict.SetValue("NAME", "John Smith");
int winnings = random() % 100000;
dict.SetIntValue("VALUE", winnings);
dict.SetFormattedValue("TAXED_VALUE", "%.2f", winnings * 0.83);
// For now, assume everyone lives in CA.
// (Try running the program with a 0 here instead!)
if (1) {
dict.ShowSection("IN_CA");
}
ctemplate::Template* tpl = ctemplate::Template::GetTemplate(
"example.tpl", ctemplate::DO_NOT_STRIP);
std::string output;
tpl->Expand(&output, &dict);
std::cout &lt;&lt; output;
return 0;
}
</pre>
<h3>Compiling and linking (using gcc)</h3>
<pre>
gcc -o example example.cc -lctemplate_nothreads
</pre>
<p>I can use the "nothreads" library because <code>example.cc</code>
doesn't use threads. If <code>example.cc</code> were threaded, I
would do something like this instead:</p>
<pre>
gcc -o example example.cc -lctemplate -pthread
</pre>
<p>See the README for more details about the two different ctemplate
libraries.</p>
<h2>In-depth Documentation</h2>
<ol>
<li> <A HREF="howto.html">Howto</A>: Introduction to the Google
Template system, and a tutorial for using it. </li>
<li> <A HREF="auto_escape.html">Auto Escape</A>: Guide to using
the optional Auto Escape mode to protect your web application
better against XSS.</li>
<li> <A HREF="tips.html">Tips</A>: Advice, tips, and recommendations
for best practices with templates, to make them easier to write
and maintain, and to avoid common template mistakes. </li>
<li> <A HREF="example.html">Examples</A>: Some example templates and
application code that uses them. These are taken from actual
Google applications. </li>
</ol>
<hr>
<address>
Craig Silverstein<br>
Last modified: Wed Feb 15 23:21:42 PST 2006
</address>
</body>
</html>