mirror of
https://github.com/OlafvdSpek/ctemplate.git
synced 2025-09-28 19:05:49 +08:00
3f759b57cb
* Major documentation revamp: howto -> guide + reference (csilvers) * Protect auto-generated #include files with header guard (dnovillo) * PORTING: autoconf macros to get cygwin/mingw to compile (csilvers)
110 lines
3.1 KiB
HTML
110 lines
3.1 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>
|
|
<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 <stdlib.h>
|
|
#include <string>
|
|
#include <iostream>
|
|
#include <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");
|
|
}
|
|
std::string output;
|
|
ctemplate::Expand("example.tpl", ctemplate::DO_NOT_STRIP, &dict, &output);
|
|
std::cout << 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: Mon Feb 22 10:59:03 PST 2010
|
|
</address>
|
|
|
|
</body>
|
|
</html>
|