You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@freemarker.apache.org by dd...@apache.org on 2017/03/15 21:19:19 UTC
[22/51] [partial] incubator-freemarker-site git commit: 2.3.26-voting
docs, removed nightly
http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/a4004324/builds/2.3.26-nightly/ref_directive_if.html
----------------------------------------------------------------------
diff --git a/builds/2.3.26-nightly/ref_directive_if.html b/builds/2.3.26-nightly/ref_directive_if.html
deleted file mode 100644
index 99de82d..0000000
--- a/builds/2.3.26-nightly/ref_directive_if.html
+++ /dev/null
@@ -1,196 +0,0 @@
-<!doctype html>
-<!-- Generated by FreeMarker/Docgen from DocBook -->
-<html lang="en" class="page-type-section">
-<head prefix="og: http://ogp.me/ns#">
-<meta charset="utf-8">
-<title>if, else, elseif - Apache FreeMarker Manual</title>
-<meta http-equiv="X-UA-Compatible" content="IE=edge">
-<meta name="viewport" content="width=device-width,initial-scale=1">
-<meta name="format-detection" content="telephone=no">
-<meta property="og:site_name" content="Apache FreeMarker Manual">
-<meta property="og:title" content="if, else, elseif">
-<meta property="og:locale" content="en_US">
-<meta property="og:url" content="http://freemarker.org/docs/ref_directive_if.html">
-<link rel="canonical" href="http://freemarker.org/docs/ref_directive_if.html">
-<link rel="icon" href="favicon.png" type="image/png">
-<link rel="stylesheet" type="text/css" href="http://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
-<link rel="stylesheet" type="text/css" href="docgen-resources/docgen.min.css?1489402528979">
-<script>
-(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
-(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
-m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
-})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
-ga('create', 'UA-55420501-1', 'auto');
-ga('send', 'pageview');
-</script>
-</head>
-<body itemscope itemtype="https://schema.org/Code">
- <meta itemprop="url" content="http://freemarker.org/docs/">
- <meta itemprop="name" content="Apache FreeMarker Manual">
-
- <!--[if lte IE 9]>
- <div style="background-color: #C00; color: #fff; padding: 12px 24px;">Please use a modern browser to view this website.</div>
- <![endif]--><div class="header-top-bg"><div class="site-width header-top"><a class="logo" href="http://freemarker.org" role="banner"> <img itemprop="image" src="logo.png" alt="FreeMarker">
-</a><ul class="tabs"><li><a href="http://freemarker.org/">Home</a></li><li class="current"><a href="index.html">Manual</a></li><li><a class="external" href="api/index.html">Java API</a></li></ul><ul class="secondary-tabs"><li><a class="tab icon-heart" href="http://freemarker.org/contribute.html" title="Contribute"><span>Contribute</span></a></li><li><a class="tab icon-bug" href="https://issues.apache.org/jira/browse/FREEMARKER/" title="Report a Bug"><span>Report a Bug</span></a></li><li><a class="tab icon-download" href="http://freemarker.org/freemarkerdownload.html" title="Download"><span>Download</span></a></li></ul></div></div><div class="header-bottom-bg"><div class="site-width search-row"><a href="index.html" class="navigation-header">Manual</a><div class="navigation-header"></div><form method="get" class="search-form" action="search-results.html"><fieldset><legend class="sr-only">Search form</legend><label for="search-field" class="sr-only">Search query</label><input id="searc
h-field" name="q" type="search" class="search-input" placeholder="Search" spellcheck="false" autocorrect="off" autocomplete="off"><button type="submit" class="search-btn"><span class="sr-only">Search</span></button></fieldset></form></div><div class="site-width breadcrumb-row"><ul class="breadcrumb" itemscope itemtype="http://schema.org/BreadcrumbList"><li class="step-0" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="index.html"><span itemprop="name">Apache FreeMarker Manual</span></a></li><li class="step-1" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="ref.html"><span itemprop="name">Template Language Reference</span></a></li><li class="step-2" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="ref_directives.html"><span itemprop="name">Directive Reference</span></a></li><li class="step-
3" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="ref_directive_if.html"><span itemprop="name">if, else, elseif</span></a></li></ul><div class="bookmarks" title="Bookmarks"><span class="sr-only">Bookmarks:</span><ul class="bookmark-list"><li><a href="alphaidx.html">Alpha. index</a></li><li><a href="gloss.html">Glossary</a></li><li><a href="dgui_template_exp.html#exp_cheatsheet">Expressions</a></li><li><a href="ref_builtins_alphaidx.html">?builtins</a></li><li><a href="ref_directive_alphaidx.html">#directives</a></li><li><a href="ref_specvar.html">.spec_vars</a></li><li><a href="app_faq.html">FAQ</a></li></ul></div></div></div> <div class="main-content site-width">
- <div class="content-wrapper">
- <div id="table-of-contents-wrapper" class="col-left">
- <script>var breadcrumb = ["Apache FreeMarker Manual","Template Language Reference","Directive Reference","if, else, elseif"];</script>
- <script src="toc.js?1489402528979"></script>
- <script src="docgen-resources/main.min.js?1489402528979"></script>
- </div>
-<div class="col-right"><div class="page-content"><div class="page-title"><div class="pagers top"><a class="paging-arrow previous" href="ref_directive_global.html"><span>Previous</span></a><a class="paging-arrow next" href="ref_directive_import.html"><span>Next</span></a></div><div class="title-wrapper">
-<h1 class="content-header header-section1" id="ref_directive_if" itemprop="headline">if, else, elseif</h1>
-</div></div><div class="page-menu">
-<div class="page-menu-title">Page Contents</div>
-<ul><li><a class="page-menu-link" href="#autoid_94" data-menu-target="autoid_94">Synopsis</a></li><li><a class="page-menu-link" href="#autoid_95" data-menu-target="autoid_95">Description</a></li></ul> </div><a name="ref.directive.if"></a><a name="ref.directive.else"></a><a name="ref.directive.elseif"></a>
-
-
-
-
-<h2 class="content-header header-section2" id="autoid_94">Synopsis</h2>
-
-
-
-<pre class="metaTemplate">
-<code class="inline-code"><#if <em class="code-color">condition</em>>
- <em class="code-color">...</em>
-<#elseif <em class="code-color">condition2</em>>
- <em class="code-color">...</em>
-<#elseif <em class="code-color">condition3</em>>
- <em class="code-color">...</em>
-<em class="code-color">...</em>
-<#else>
- <em class="code-color">...</em>
-</#if></code>
-</pre>
-
-
- <p>Where:</p>
-
- <ul>
- <li>
- <code class="inline-code"><em class="code-color">condition</em></code>,
- <code class="inline-code"><em class="code-color">condition2</em></code>,
- ...etc.: Expression evaluates to a boolean value.
- </li>
- </ul>
-
- <p>The <code class="inline-code">elseif</code>-s and the
- <code class="inline-code">else</code> are optional.</p>
-
- <p>Camel case name variant: <code class="inline-code">elseIf</code></p>
-
-
-
-
-
-<h2 class="content-header header-section2" id="autoid_95">Description</h2>
-
-
- <p>You can use <code class="inline-code">if</code>, <code class="inline-code">elseif</code>
- and <code class="inline-code">else</code> directives to conditionally skip a
- section of the template. The
- <code class="inline-code"><em class="code-color">condition</em></code>-s must
- evaluate to a boolean value, or else an error will abort template
- processing. The <code class="inline-code">elseif</code>-s and
- <code class="inline-code">else</code>-s must occur inside <code class="inline-code">if</code>
- (that is, between the <code class="inline-code">if</code> start-tag and end-tag).
- The <code class="inline-code">if</code> can contain any number of
- <code class="inline-code">elseif</code>-s (including 0) and at the end optionally
- one <code class="inline-code">else</code>. Examples:</p>
-
- <p><code class="inline-code">if</code> with 0 <code class="inline-code">elseif</code> and no
- <code class="inline-code">else</code>:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#if x == 1>
- x is 1
-</#if></pre></div>
-
- <p><code class="inline-code">if</code> with 0 <code class="inline-code">elseif</code> and
- <code class="inline-code">else</code>:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#if x == 1>
- x is 1
-<#else>
- x is not 1
-</#if></pre></div>
-
- <p><code class="inline-code">if</code> with 2 <code class="inline-code">elseif</code> and no
- <code class="inline-code">else</code>:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#if x == 1>
- x is 1
-<#elseif x == 2>
- x is 2
-<#elseif x == 3>
- x is 3
-</#if></pre></div>
-
- <p><code class="inline-code">if</code> with 3 <code class="inline-code">elseif</code> and
- <code class="inline-code">else</code>:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#if x == 1>
- x is 1
-<#elseif x == 2>
- x is 2
-<#elseif x == 3>
- x is 3
-<#elseif x == 4>
- x is 4
-<#else>
- x is not 1 nor 2 nor 3 nor 4
-</#if></pre></div>
-
- <p>To see more about boolean expressions, see: <a href="dgui_template_exp.html">Template Author's Guide/The Template/Expressions</a>.</p>
-
- <p>You can nest <code class="inline-code">if</code> directives (of
- course):</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#if x == 1>
- x is 1
- <#if y == 1>
- and y is 1 too
- <#else>
- but y is not
- </#if>
-<#else>
- x is not 1
- <#if y < 0>
- and y is less than 0
- </#if>
-</#if></pre></div>
-
- <div class="callout note">
- <strong class="callout-label">Note:</strong>
-
- <p>When you want to test if <code class="inline-code">x > 0</code> or
- <code class="inline-code">x >= 0</code>, writing <code class="inline-code"><#if x >
- 0></code> and <code class="inline-code"><#if x >= 0></code> is
- WRONG, as the first <code class="inline-code">></code> will close the
- <code class="inline-code">#if</code> tag. To work that around, write
- <code class="inline-code"><#if x gt 0></code> or <code class="inline-code"><#if gte
- 0></code>. Also note that if the comparison occurs inside
- parentheses, you will have no such problem, like <code class="inline-code"><#if
- foo.bar(x > 0)></code> works as expected.</p>
- </div>
-
- <div class="bottom-pagers-wrapper"><div class="pagers bottom"><a class="paging-arrow previous" href="ref_directive_global.html"><span>Previous</span></a><a class="paging-arrow next" href="ref_directive_import.html"><span>Next</span></a></div></div></div></div> </div>
- </div>
-<div class="site-footer"><div class="site-width"><div class="footer-top"><div class="col-left sitemap"><div class="column"><h3 class="column-header">Overview</h3><ul><li><a href="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.org/history.html">About us</a></li><li><a itemprop="license" href="app_license.html">License</a></li></ul></div><div class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a href="http://freemarker-online.kenshoo.com/">Try template online</a></li><li><a href="dgui_template_exp.html#exp_cheatsheet">Expressions cheatsheet</a></li><li><a href="ref_directive_alphaidx.html">#directives</a></li><li><a href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a href="ref_specvar.html">.special_vars</a></li></ul></div><div class="column"><h3 class="column-header">Community</h3><ul><li><a href
="https://github.com/freemarker/freemarker">FreeMarker on Github</a></li><li><a href="https://twitter.com/freemarker">Follow us on Twitter</a></li><li><a href="https://issues.apache.org/jira/browse/FREEMARKER/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.org/mailing-lists.html">Mailing lists</a></li></ul></div></div><div class="col-right"><ul class="social-icons"><li><a class="github" href="https://github.com/freemarker/freemarker">Github</a></li><li><a class="twitter" href="https://twitter.com/freemarker">Twitter</a></li><li><a class="stack-overflow" href="http://stackoverflow.com/questions/ask?tags=freemarker">Stack Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/" rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind XML Editor</span></a></div></div><div class="footer-bottom"> <p class="last-generated">
-Last generated:
-<time itemprop="dateModified" datetime="2017-03-13T10:55:28Z" title="Monday, March 13, 2017 10:55:28 AM GMT">2017-03-13 10:55:28 GMT</time>, for Freemarker 2.3.26 </p>
-<p class="copyright">
-� <span itemprop="copyrightYear">1999</span>\u20132017
-<a itemtype="http://schema.org/Organization" itemprop="copyrightHolder" href="http://apache.org/">The Apache Software Foundation</a>. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation. </p>
-</div></div></div></body>
-</html>
http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/a4004324/builds/2.3.26-nightly/ref_directive_import.html
----------------------------------------------------------------------
diff --git a/builds/2.3.26-nightly/ref_directive_import.html b/builds/2.3.26-nightly/ref_directive_import.html
deleted file mode 100644
index 965f033..0000000
--- a/builds/2.3.26-nightly/ref_directive_import.html
+++ /dev/null
@@ -1,153 +0,0 @@
-<!doctype html>
-<!-- Generated by FreeMarker/Docgen from DocBook -->
-<html lang="en" class="page-type-section">
-<head prefix="og: http://ogp.me/ns#">
-<meta charset="utf-8">
-<title>import - Apache FreeMarker Manual</title>
-<meta http-equiv="X-UA-Compatible" content="IE=edge">
-<meta name="viewport" content="width=device-width,initial-scale=1">
-<meta name="format-detection" content="telephone=no">
-<meta property="og:site_name" content="Apache FreeMarker Manual">
-<meta property="og:title" content="import">
-<meta property="og:locale" content="en_US">
-<meta property="og:url" content="http://freemarker.org/docs/ref_directive_import.html">
-<link rel="canonical" href="http://freemarker.org/docs/ref_directive_import.html">
-<link rel="icon" href="favicon.png" type="image/png">
-<link rel="stylesheet" type="text/css" href="http://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
-<link rel="stylesheet" type="text/css" href="docgen-resources/docgen.min.css?1489402528979">
-<script>
-(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
-(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
-m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
-})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
-ga('create', 'UA-55420501-1', 'auto');
-ga('send', 'pageview');
-</script>
-</head>
-<body itemscope itemtype="https://schema.org/Code">
- <meta itemprop="url" content="http://freemarker.org/docs/">
- <meta itemprop="name" content="Apache FreeMarker Manual">
-
- <!--[if lte IE 9]>
- <div style="background-color: #C00; color: #fff; padding: 12px 24px;">Please use a modern browser to view this website.</div>
- <![endif]--><div class="header-top-bg"><div class="site-width header-top"><a class="logo" href="http://freemarker.org" role="banner"> <img itemprop="image" src="logo.png" alt="FreeMarker">
-</a><ul class="tabs"><li><a href="http://freemarker.org/">Home</a></li><li class="current"><a href="index.html">Manual</a></li><li><a class="external" href="api/index.html">Java API</a></li></ul><ul class="secondary-tabs"><li><a class="tab icon-heart" href="http://freemarker.org/contribute.html" title="Contribute"><span>Contribute</span></a></li><li><a class="tab icon-bug" href="https://issues.apache.org/jira/browse/FREEMARKER/" title="Report a Bug"><span>Report a Bug</span></a></li><li><a class="tab icon-download" href="http://freemarker.org/freemarkerdownload.html" title="Download"><span>Download</span></a></li></ul></div></div><div class="header-bottom-bg"><div class="site-width search-row"><a href="index.html" class="navigation-header">Manual</a><div class="navigation-header"></div><form method="get" class="search-form" action="search-results.html"><fieldset><legend class="sr-only">Search form</legend><label for="search-field" class="sr-only">Search query</label><input id="searc
h-field" name="q" type="search" class="search-input" placeholder="Search" spellcheck="false" autocorrect="off" autocomplete="off"><button type="submit" class="search-btn"><span class="sr-only">Search</span></button></fieldset></form></div><div class="site-width breadcrumb-row"><ul class="breadcrumb" itemscope itemtype="http://schema.org/BreadcrumbList"><li class="step-0" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="index.html"><span itemprop="name">Apache FreeMarker Manual</span></a></li><li class="step-1" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="ref.html"><span itemprop="name">Template Language Reference</span></a></li><li class="step-2" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="ref_directives.html"><span itemprop="name">Directive Reference</span></a></li><li class="step-
3" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="ref_directive_import.html"><span itemprop="name">import</span></a></li></ul><div class="bookmarks" title="Bookmarks"><span class="sr-only">Bookmarks:</span><ul class="bookmark-list"><li><a href="alphaidx.html">Alpha. index</a></li><li><a href="gloss.html">Glossary</a></li><li><a href="dgui_template_exp.html#exp_cheatsheet">Expressions</a></li><li><a href="ref_builtins_alphaidx.html">?builtins</a></li><li><a href="ref_directive_alphaidx.html">#directives</a></li><li><a href="ref_specvar.html">.spec_vars</a></li><li><a href="app_faq.html">FAQ</a></li></ul></div></div></div> <div class="main-content site-width">
- <div class="content-wrapper">
- <div id="table-of-contents-wrapper" class="col-left">
- <script>var breadcrumb = ["Apache FreeMarker Manual","Template Language Reference","Directive Reference","import"];</script>
- <script src="toc.js?1489402528979"></script>
- <script src="docgen-resources/main.min.js?1489402528979"></script>
- </div>
-<div class="col-right"><div class="page-content"><div class="page-title"><div class="pagers top"><a class="paging-arrow previous" href="ref_directive_if.html"><span>Previous</span></a><a class="paging-arrow next" href="ref_directive_include.html"><span>Next</span></a></div><div class="title-wrapper">
-<h1 class="content-header header-section1" id="ref_directive_import" itemprop="headline">import</h1>
-</div></div><div class="page-menu">
-<div class="page-menu-title">Page Contents</div>
-<ul><li><a class="page-menu-link" href="#autoid_96" data-menu-target="autoid_96">Synopsis</a></li><li><a class="page-menu-link" href="#autoid_97" data-menu-target="autoid_97">Description</a></li></ul> </div><a name="ref.directive.import"></a>
-
-
-
-
-<h2 class="content-header header-section2" id="autoid_96">Synopsis</h2>
-
-
-
-<pre class="metaTemplate"><code class="inline-code"><#import <em class="code-color">path</em> as <em class="code-color">hash</em>></code>
-</pre>
-
-
- <p>Where:</p>
-
- <ul>
- <li>
- <code class="inline-code"><em class="code-color">path</em></code>: The
- path of a template. This is an expression that evaluates to a
- string. (With other words, it doesn't have to be a fixed string,
- it can also be something like, for example,
- <code class="inline-code">profile.baseDir + "/menu.ftl"</code>.)
- </li>
-
- <li>
- <code class="inline-code"><em class="code-color">hash</em></code>: The
- unquoted name of hash variable by which you can access the
- namespace. Not an expression. (If you have to import into a
- dynamically constructed name, you have to use <a href="app_faq.html#faq_assign_to_dynamic_variable_name">this
- trick</a>.)
- </li>
- </ul>
-
-
-
-
-
-<h2 class="content-header header-section2" id="autoid_97">Description</h2>
-
-
- <p>Imports a library. That is, it creates a new empty namespace,
- and then executes the template given with
- <code class="inline-code"><em class="code-color">path</em></code> parameter in that
- namespace so the template populates the namespace with variables
- (macros, functions, ...etc.). Then it makes the newly created
- namespace available to the caller with a hash variable. The hash
- variable will be created as a plain variable in the namespace used
- by the caller of <code class="inline-code">import</code> (as if you would create
- it with <code class="inline-code">assign</code> directive), with the name given
- with the <code class="inline-code"><em class="code-color">hash</em></code>
- parameter. If the import happens in the namespace of the main
- template, the hash variable is also created in the global
- namespace.</p>
-
- <p>If you call <code class="inline-code">import</code> with the same
- <code class="inline-code"><em class="code-color">path</em></code> for multiple
- times, it will create the namespace and run the template for the
- very first call of <code class="inline-code">import</code> only. The later calls
- will just create a hash by which you can access the
- <em>same</em> namespace.</p>
-
- <p>The output printed by the imported template will be ignored
- (will not be inserted at the place of importing). The template is
- executed to populate the namespace with variables, and not to write
- to the output.</p>
-
- <p>Example:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#import "/libs/mylib.ftl" as my>
-
-<@my.copyright date="1999-2002"/></pre></div>
-
- <p>The <code class="inline-code"><em class="code-color">path</em></code>
- parameter can be a relative path like <code class="inline-code">"foo.ftl"</code>
- and <code class="inline-code">"../foo.ftl"</code>, or an absolute like
- <code class="inline-code">"/foo.ftl"</code>. Relative paths are relative to the
- directory of the template that uses the <code class="inline-code">import</code>
- directive. Absolute paths are relative to a base (often referred as
- the ''root directory of the templates'') that the programmer defines
- when he configures FreeMarker.</p>
-
- <p>Always use <code class="inline-code">/</code> (slash) to separate path
- components, never <code class="inline-code">\</code> (backslash). If you are
- loading templates from your local file system and it uses
- backslashes (like under. Windows), FreeMarker will convert them
- automatically.</p>
-
- <p>Like with the <code class="inline-code">include</code> directive, <a href="ref_directive_include.html#ref_directive_include_acquisition">acquisition</a> and
- <a href="ref_directive_include.html#ref_directive_include_localized">localized
- lookup</a> may be used for resolving the path.</p>
-
- <p><span class="marked-for-programmers">Note, that it is possible to
- automatically do the commonly used imports for all templates, with
- the "auto imports" setting of
- <code class="inline-code">Configuration</code>.</span></p>
-
- <p>If you are new to namespaces, you should read: <a href="dgui_misc_namespace.html">Template Author's Guide/Miscellaneous/Namespaces</a></p>
- <div class="bottom-pagers-wrapper"><div class="pagers bottom"><a class="paging-arrow previous" href="ref_directive_if.html"><span>Previous</span></a><a class="paging-arrow next" href="ref_directive_include.html"><span>Next</span></a></div></div></div></div> </div>
- </div>
-<div class="site-footer"><div class="site-width"><div class="footer-top"><div class="col-left sitemap"><div class="column"><h3 class="column-header">Overview</h3><ul><li><a href="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.org/history.html">About us</a></li><li><a itemprop="license" href="app_license.html">License</a></li></ul></div><div class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a href="http://freemarker-online.kenshoo.com/">Try template online</a></li><li><a href="dgui_template_exp.html#exp_cheatsheet">Expressions cheatsheet</a></li><li><a href="ref_directive_alphaidx.html">#directives</a></li><li><a href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a href="ref_specvar.html">.special_vars</a></li></ul></div><div class="column"><h3 class="column-header">Community</h3><ul><li><a href
="https://github.com/freemarker/freemarker">FreeMarker on Github</a></li><li><a href="https://twitter.com/freemarker">Follow us on Twitter</a></li><li><a href="https://issues.apache.org/jira/browse/FREEMARKER/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.org/mailing-lists.html">Mailing lists</a></li></ul></div></div><div class="col-right"><ul class="social-icons"><li><a class="github" href="https://github.com/freemarker/freemarker">Github</a></li><li><a class="twitter" href="https://twitter.com/freemarker">Twitter</a></li><li><a class="stack-overflow" href="http://stackoverflow.com/questions/ask?tags=freemarker">Stack Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/" rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind XML Editor</span></a></div></div><div class="footer-bottom"> <p class="last-generated">
-Last generated:
-<time itemprop="dateModified" datetime="2017-03-13T10:55:28Z" title="Monday, March 13, 2017 10:55:28 AM GMT">2017-03-13 10:55:28 GMT</time>, for Freemarker 2.3.26 </p>
-<p class="copyright">
-� <span itemprop="copyrightYear">1999</span>\u20132017
-<a itemtype="http://schema.org/Organization" itemprop="copyrightHolder" href="http://apache.org/">The Apache Software Foundation</a>. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation. </p>
-</div></div></div></body>
-</html>
http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/a4004324/builds/2.3.26-nightly/ref_directive_include.html
----------------------------------------------------------------------
diff --git a/builds/2.3.26-nightly/ref_directive_include.html b/builds/2.3.26-nightly/ref_directive_include.html
deleted file mode 100644
index ebfb785..0000000
--- a/builds/2.3.26-nightly/ref_directive_include.html
+++ /dev/null
@@ -1,449 +0,0 @@
-<!doctype html>
-<!-- Generated by FreeMarker/Docgen from DocBook -->
-<html lang="en" class="page-type-section">
-<head prefix="og: http://ogp.me/ns#">
-<meta charset="utf-8">
-<title>include - Apache FreeMarker Manual</title>
-<meta http-equiv="X-UA-Compatible" content="IE=edge">
-<meta name="viewport" content="width=device-width,initial-scale=1">
-<meta name="format-detection" content="telephone=no">
-<meta property="og:site_name" content="Apache FreeMarker Manual">
-<meta property="og:title" content="include">
-<meta property="og:locale" content="en_US">
-<meta property="og:url" content="http://freemarker.org/docs/ref_directive_include.html">
-<link rel="canonical" href="http://freemarker.org/docs/ref_directive_include.html">
-<link rel="icon" href="favicon.png" type="image/png">
-<link rel="stylesheet" type="text/css" href="http://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
-<link rel="stylesheet" type="text/css" href="docgen-resources/docgen.min.css?1489402528979">
-<script>
-(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
-(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
-m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
-})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
-ga('create', 'UA-55420501-1', 'auto');
-ga('send', 'pageview');
-</script>
-</head>
-<body itemscope itemtype="https://schema.org/Code">
- <meta itemprop="url" content="http://freemarker.org/docs/">
- <meta itemprop="name" content="Apache FreeMarker Manual">
-
- <!--[if lte IE 9]>
- <div style="background-color: #C00; color: #fff; padding: 12px 24px;">Please use a modern browser to view this website.</div>
- <![endif]--><div class="header-top-bg"><div class="site-width header-top"><a class="logo" href="http://freemarker.org" role="banner"> <img itemprop="image" src="logo.png" alt="FreeMarker">
-</a><ul class="tabs"><li><a href="http://freemarker.org/">Home</a></li><li class="current"><a href="index.html">Manual</a></li><li><a class="external" href="api/index.html">Java API</a></li></ul><ul class="secondary-tabs"><li><a class="tab icon-heart" href="http://freemarker.org/contribute.html" title="Contribute"><span>Contribute</span></a></li><li><a class="tab icon-bug" href="https://issues.apache.org/jira/browse/FREEMARKER/" title="Report a Bug"><span>Report a Bug</span></a></li><li><a class="tab icon-download" href="http://freemarker.org/freemarkerdownload.html" title="Download"><span>Download</span></a></li></ul></div></div><div class="header-bottom-bg"><div class="site-width search-row"><a href="index.html" class="navigation-header">Manual</a><div class="navigation-header"></div><form method="get" class="search-form" action="search-results.html"><fieldset><legend class="sr-only">Search form</legend><label for="search-field" class="sr-only">Search query</label><input id="searc
h-field" name="q" type="search" class="search-input" placeholder="Search" spellcheck="false" autocorrect="off" autocomplete="off"><button type="submit" class="search-btn"><span class="sr-only">Search</span></button></fieldset></form></div><div class="site-width breadcrumb-row"><ul class="breadcrumb" itemscope itemtype="http://schema.org/BreadcrumbList"><li class="step-0" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="index.html"><span itemprop="name">Apache FreeMarker Manual</span></a></li><li class="step-1" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="ref.html"><span itemprop="name">Template Language Reference</span></a></li><li class="step-2" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="ref_directives.html"><span itemprop="name">Directive Reference</span></a></li><li class="step-
3" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="ref_directive_include.html"><span itemprop="name">include</span></a></li></ul><div class="bookmarks" title="Bookmarks"><span class="sr-only">Bookmarks:</span><ul class="bookmark-list"><li><a href="alphaidx.html">Alpha. index</a></li><li><a href="gloss.html">Glossary</a></li><li><a href="dgui_template_exp.html#exp_cheatsheet">Expressions</a></li><li><a href="ref_builtins_alphaidx.html">?builtins</a></li><li><a href="ref_directive_alphaidx.html">#directives</a></li><li><a href="ref_specvar.html">.spec_vars</a></li><li><a href="app_faq.html">FAQ</a></li></ul></div></div></div> <div class="main-content site-width">
- <div class="content-wrapper">
- <div id="table-of-contents-wrapper" class="col-left">
- <script>var breadcrumb = ["Apache FreeMarker Manual","Template Language Reference","Directive Reference","include"];</script>
- <script src="toc.js?1489402528979"></script>
- <script src="docgen-resources/main.min.js?1489402528979"></script>
- </div>
-<div class="col-right"><div class="page-content"><div class="page-title"><div class="pagers top"><a class="paging-arrow previous" href="ref_directive_import.html"><span>Previous</span></a><a class="paging-arrow next" href="ref_directive_list.html"><span>Next</span></a></div><div class="title-wrapper">
-<h1 class="content-header header-section1" id="ref_directive_include" itemprop="headline">include</h1>
-</div></div><div class="page-menu">
-<div class="page-menu-title">Page Contents</div>
-<ul><li><a class="page-menu-link" href="#autoid_98" data-menu-target="autoid_98">Synopsis</a></li><li><a class="page-menu-link" href="#autoid_99" data-menu-target="autoid_99">Description</a><ul><li><a class="page-menu-link" href="#ref_directive_include_acquisition" data-menu-target="ref_directive_include_acquisition">Using acquisition</a></li><li><a class="page-menu-link" href="#ref_directive_include_localized" data-menu-target="ref_directive_include_localized">Localized lookup</a></li></ul></li></ul> </div><a name="ref.directive.include"></a>
-
-
-
-
-<h2 class="content-header header-section2" id="autoid_98">Synopsis</h2>
-
-
-
-<pre class="metaTemplate">
-<code class="inline-code"><#include <em class="code-color">path</em>></code>
-or
-<code class="inline-code"><#include <em class="code-color">path</em> <em class="code-color">options</em>></code>
-</pre>
-
-
- <p>Where:</p>
-
- <ul>
- <li>
- <code class="inline-code"><em class="code-color">path</em></code>: The
- path of the file to include; an expression that evaluates to a
- string. (With other words, it doesn't have to be a fixed string,
- it can also be something like, for example,
- <code class="inline-code">profile.baseDir + "/menu.ftl"</code>.)
- </li>
-
- <li>
- <code class="inline-code"><em class="code-color">options</em></code>: One
- or more of these:
- <code class="inline-code">encoding=<em class="code-color">encoding</em></code>,
- <code class="inline-code">parse=<em class="code-color">parse</em></code>
-
- <ul>
- <li>
- <code class="inline-code"><em class="code-color">encoding</em></code>:
- Expression evaluates to string
- </li>
-
- <li>
- <code class="inline-code"><em class="code-color">parse</em></code>:
- Expression evaluates to boolean (also accepts a few string
- values for backward compatibility)
- </li>
-
- <li>
- <code class="inline-code"><em class="code-color">ignore_missing</em></code>:
- Expression evaluates to boolean
- </li>
- </ul>
- </li>
- </ul>
-
-
-
-
-
-<h2 class="content-header header-section2" id="autoid_99">Description</h2>
-
-
- <p>You can use it to insert another FreeMarker template file
- (specified by the <code class="inline-code"><em class="code-color">path</em></code>
- parameter) into your template. The output from the included template
- is inserted at the point where the <code class="inline-code">include</code> tag
- occurs. The included file shares the variables with the including
- template, similarly like if it was copy-pasted into it. The
- <code class="inline-code">include</code> directive is not really replaced by the
- content of the included file, instead it processes the included file
- each time when FreeMarker reaches the <code class="inline-code">include</code>
- directive in the course of template processing. So for example if
- the <code class="inline-code">include</code> is inside a <code class="inline-code">list</code>
- loop, you can specify different file names in each cycle.</p>
-
- <div class="callout note">
- <strong class="callout-label">Note:</strong>
-
- <p>This directive is not be confused with the JSP (Servlet)
- include, as it doesn't involve the Servlet container at all, just
- processes another FreeMarker template, without "leaving"
- FreeMarker. Regarding how to do a "JSP include" <a href="app_faq.html#faq_servlet_include">read this...</a></p>
- </div>
-
-
- <p>The <code class="inline-code"><em class="code-color">path</em></code>
- parameter can be a relative path like <code class="inline-code">"foo.ftl"</code>
- and <code class="inline-code">"../foo.ftl"</code>, or an absolute like
- <code class="inline-code">"/foo.ftl"</code>. Relative paths are relative to the
- directory of the template that contains the
- <code class="inline-code">import</code> directive. Absolute paths are relative to
- a base (often referred as the 'root directory of the templates')
- that the programmer defines when he configures FreeMarker.</p>
-
- <div class="callout note">
- <strong class="callout-label">Note:</strong>
-
- <p>This is different than the way it worked prior FreeMarker
- 2.1, where the path was always absolute. To preserve the old
- behavior, enable the classic compatible mode in the
- <code class="inline-code">Configuration</code> object.</p>
- </div>
-
-
- <p>Always use <code class="inline-code">/</code> (slash) to separate path
- components, never <code class="inline-code">\</code> (backslash). Even if you are
- loading templates from your local file system and it uses
- backslashes (like under. Windows), use <code class="inline-code">/</code>.</p>
-
- <p>Example:</p>
-
- <p>Assume /common/copyright.ftl contains:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template">Copyright 2001-2002 ${me}<br>
-All rights reserved.</pre></div>
-
- <p>Then this:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#assign me = "Juila Smith">
-<h1>Some test</h1>
-<p>Yeah.
-<hr>
-<strong><#include "/common/copyright.ftl"></strong></pre></div>
-
- <p>will output this:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-output"><h1>Some test</h1>
-<p>Yeah.
-<hr>
-<strong>Copyright 2001-2002 Juila Smith
-All rights reserved.</strong></pre></div>
-
- <p>The supported
- <code class="inline-code"><em class="code-color">options</em></code> are:</p>
-
- <ul>
- <li>
- <p><code class="inline-code">parse</code>: If it is
- <code class="inline-code">true</code>, then the included file will be parsed
- as FTL, otherwise the whole file will be considered as simple
- text (i.e, no FreeMarker constructs will be searched in it). If
- you omit this option, then it defaults to
- <code class="inline-code">true</code>.</p>
- </li>
-
- <li>
- <p><code class="inline-code">encoding</code>: The encoding (charset) of the
- included template. You shouldn't use this option anymore; if
- different template use different encodings, then the programmers
- should associated the encoding to the templates via
- <code class="inline-code">Configuration.setTemplateConfigurations(<em class="code-color">...</em>)</code>-s
- (which also overrides that you specify here). If
- <code class="inline-code">Configuration.setTemplateConfigurations(<em class="code-color">...</em>)</code>
- doesn't specify an encoding for the included template, then the
- included file inherits the encoding (the charset) of the
- top-level template, unless you specify an encoding with this
- option. Examples of valid names: UTF-8, ISO-8859-1, ISO-8859-2,
- Shift_JIS, Big5, EUC-KR, GB2312. <span class="marked-for-programmers">Encoding names are the same as the ones
- supported be java.io.InputStreamReader (as of Java API 1.3:
- MIME-preferred charset names from the IANA Charset
- Registry)</span></p>
- </li>
-
- <li>
- <p><code class="inline-code">ignore_missing</code>: When
- <code class="inline-code">true</code>, suppresses the error when the template
- to include is missing, instead <code class="inline-code"><#include
- ...></code> will print nothing. When
- <code class="inline-code">false</code>, the template processing will stop with
- error if the template is missing. If you omit this option, then
- it defaults to <code class="inline-code">false</code>.</p>
- </li>
- </ul>
-
- <p>Example:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#include "/common/navbar.html" parse=false encoding="Shift_JIS"></pre></div>
-
- <p><span class="marked-for-programmers">Note, that it is possible to
- automatically do the commonly used inclusions for all templates,
- with the "auto includes" setting of
- <code class="inline-code">Configuration</code>.</span></p>
-
-
-
-
-
-
-<h3 class="content-header header-section3" id="ref_directive_include_acquisition">Using acquisition</h3>
-
-
-
-
- <p>There's a special path component represented by an asterisk
- (<code class="inline-code">*</code>). It is interpreted as "this directory or
- any of its parents". Therefore, if the template located in
- <code class="inline-code">/foo/bar/template.ftl</code> has the following
- line:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#include "*/footer.ftl"></pre></div>
-
- <p>then the engine will look for the template in following
- locations, in this order:</p>
-
- <ul>
- <li>
- <code class="inline-code">/foo/bar/footer.ftl</code>
- </li>
-
- <li>
- <code class="inline-code">/foo/footer.ftl</code>
- </li>
-
- <li>
- <code class="inline-code">/footer.ftl</code>
- </li>
- </ul>
-
- <p>This mechanism is called <strong>acquisition</strong> and allows the designers to
- place commonly included files in a parent directory, and redefine
- them on a per-subdirectory basis as needed. We say that the
- including template acquires the template to include from the first
- parent directory that has it. Note that you can specify not only a
- template name to the right of the asterisk, but a subpath as well.
- I.e. if the previous template instead read:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#include "*/commons/footer.ftl"></pre></div>
-
- <p>then the engine would look for the template in following
- locations, in this order:</p>
-
- <ul>
- <li>
- <code class="inline-code">/foo/bar/commons/footer.ftl</code>
- </li>
-
- <li>
- <code class="inline-code">/foo/commons/footer.ftl</code>
- </li>
-
- <li>
- <code class="inline-code">/commons/footer.ftl</code>
- </li>
- </ul>
-
- <p>Finally, the asterisk needn't be the first element of the
- path:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#include "commons/*/footer.ftl"></pre></div>
-
- <p>would cause the engine to look for the template in following
- locations, in this order:</p>
-
- <ul>
- <li>
- <code class="inline-code">/foo/bar/commons/footer.ftl</code>
- </li>
-
- <li>
- <code class="inline-code">/foo/bar/footer.ftl</code>
- </li>
-
- <li>
- <code class="inline-code">/foo/footer.ftl</code>
- </li>
-
- <li>
- <code class="inline-code">/footer.ftl</code>
- </li>
- </ul>
-
- <p>However, there can be at most one asterisk in the path. If
- you specifying more asterisks, the template won't be found.</p>
-
-
-
-
-
-
-
-<h3 class="content-header header-section3" id="ref_directive_include_localized">Localized lookup</h3>
-
-
-
-
- <p>A locale is a language and an optional country or dialect
- identifier (plus also maybe a further variant identifier, like
- "MAC"). Whenever a template is requested, a desired
- locale is always specified (explicitly or implicitly), and
- FreeMarke will try to find a variant of the template that matches
- that locale. When a template includes or imports another template,
- internally that will also be requested for a locale, for the
- locale that the <code class="inline-code">locale</code> setting is set to, and
- that's usually for the locale of the top-level template.</p>
-
- <p>Suppose your template was loaded with locale
- <code class="inline-code">en_US</code>, which means U.S. English. When you
- include another template:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#include "footer.ftl"></pre></div>
-
- <p>the engine will in fact look for several templates, in this
- order:</p>
-
- <ul>
- <li>
- <code class="inline-code">footer_en_US.ftl</code>,
- </li>
-
- <li>
- <code class="inline-code">footer_en.ftl</code>
- </li>
-
- <li>
- <code class="inline-code">footer.ftl</code>
- </li>
- </ul>
-
- <p>and it will use the first one that exists.</p>
-
- <p>Note that if how (and if) FreeMarker searches the localized
- variations is configurable by the programmers, so we are just
- describing the default behavior here.<span class="marked-for-programmers"> You can disable localized lookup with the
- <code class="inline-code">localized_lookup</code> setting
- (<code class="inline-code">Configuration.setLocalizedLookup(boolean)</code>).
- Also, you can define your own sequence of deduced template names
- with the <code class="inline-code">template_lookup_strategy</code> setting
- (<code class="inline-code">Configuration.setTemplateLookupStrategy(TemplateLookupStrategy)</code>).</span></p>
-
- <p>When you use both acquisition (i.e., <code class="inline-code">*</code>
- step in the path) and localized template lookup, the template with
- more specific locale in a parent directory takes precedence over
- template with less specific locale in a child directory. Suppose
- you use the following include from
- <code class="inline-code">/foo/bar/template.ftl</code>:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#include "*/footer.ftl"></pre></div>
-
- <p>the engine will look for these templates, in this
- order:</p>
-
- <ul>
- <li>
- <code class="inline-code">/foo/bar/footer_en_US.ftl</code>
- </li>
-
- <li>
- <code class="inline-code">/foo/footer_en_US.ftl</code>
- </li>
-
- <li>
- <code class="inline-code">/footer_en_US.ftl</code>
- </li>
-
- <li>
- <code class="inline-code">/foo/bar/footer_en.ftl</code>
- </li>
-
- <li>
- <code class="inline-code">/foo/footer_en.ftl</code>
- </li>
-
- <li>
- <code class="inline-code">/footer_en.ftl</code>
- </li>
-
- <li>
- <code class="inline-code">/foo/bar/footer.ftl</code>
- </li>
-
- <li>
- <code class="inline-code">/foo/footer.ftl</code>
- </li>
-
- <li>
- <code class="inline-code">/footer.ftl</code>
- </li>
- </ul>
-
- <div class="bottom-pagers-wrapper"><div class="pagers bottom"><a class="paging-arrow previous" href="ref_directive_import.html"><span>Previous</span></a><a class="paging-arrow next" href="ref_directive_list.html"><span>Next</span></a></div></div></div></div> </div>
- </div>
-<div class="site-footer"><div class="site-width"><div class="footer-top"><div class="col-left sitemap"><div class="column"><h3 class="column-header">Overview</h3><ul><li><a href="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.org/history.html">About us</a></li><li><a itemprop="license" href="app_license.html">License</a></li></ul></div><div class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a href="http://freemarker-online.kenshoo.com/">Try template online</a></li><li><a href="dgui_template_exp.html#exp_cheatsheet">Expressions cheatsheet</a></li><li><a href="ref_directive_alphaidx.html">#directives</a></li><li><a href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a href="ref_specvar.html">.special_vars</a></li></ul></div><div class="column"><h3 class="column-header">Community</h3><ul><li><a href
="https://github.com/freemarker/freemarker">FreeMarker on Github</a></li><li><a href="https://twitter.com/freemarker">Follow us on Twitter</a></li><li><a href="https://issues.apache.org/jira/browse/FREEMARKER/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.org/mailing-lists.html">Mailing lists</a></li></ul></div></div><div class="col-right"><ul class="social-icons"><li><a class="github" href="https://github.com/freemarker/freemarker">Github</a></li><li><a class="twitter" href="https://twitter.com/freemarker">Twitter</a></li><li><a class="stack-overflow" href="http://stackoverflow.com/questions/ask?tags=freemarker">Stack Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/" rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind XML Editor</span></a></div></div><div class="footer-bottom"> <p class="last-generated">
-Last generated:
-<time itemprop="dateModified" datetime="2017-03-13T10:55:28Z" title="Monday, March 13, 2017 10:55:28 AM GMT">2017-03-13 10:55:28 GMT</time>, for Freemarker 2.3.26 </p>
-<p class="copyright">
-� <span itemprop="copyrightYear">1999</span>\u20132017
-<a itemtype="http://schema.org/Organization" itemprop="copyrightHolder" href="http://apache.org/">The Apache Software Foundation</a>. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation. </p>
-</div></div></div></body>
-</html>
http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/a4004324/builds/2.3.26-nightly/ref_directive_list.html
----------------------------------------------------------------------
diff --git a/builds/2.3.26-nightly/ref_directive_list.html b/builds/2.3.26-nightly/ref_directive_list.html
deleted file mode 100644
index f2e0cbc..0000000
--- a/builds/2.3.26-nightly/ref_directive_list.html
+++ /dev/null
@@ -1,638 +0,0 @@
-<!doctype html>
-<!-- Generated by FreeMarker/Docgen from DocBook -->
-<html lang="en" class="page-type-section">
-<head prefix="og: http://ogp.me/ns#">
-<meta charset="utf-8">
-<title>list, else, items, sep, break - Apache FreeMarker Manual</title>
-<meta http-equiv="X-UA-Compatible" content="IE=edge">
-<meta name="viewport" content="width=device-width,initial-scale=1">
-<meta name="format-detection" content="telephone=no">
-<meta property="og:site_name" content="Apache FreeMarker Manual">
-<meta property="og:title" content="list, else, items, sep, break">
-<meta property="og:locale" content="en_US">
-<meta property="og:url" content="http://freemarker.org/docs/ref_directive_list.html">
-<link rel="canonical" href="http://freemarker.org/docs/ref_directive_list.html">
-<link rel="icon" href="favicon.png" type="image/png">
-<link rel="stylesheet" type="text/css" href="http://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
-<link rel="stylesheet" type="text/css" href="docgen-resources/docgen.min.css?1489402528979">
-<script>
-(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
-(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
-m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
-})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
-ga('create', 'UA-55420501-1', 'auto');
-ga('send', 'pageview');
-</script>
-</head>
-<body itemscope itemtype="https://schema.org/Code">
- <meta itemprop="url" content="http://freemarker.org/docs/">
- <meta itemprop="name" content="Apache FreeMarker Manual">
-
- <!--[if lte IE 9]>
- <div style="background-color: #C00; color: #fff; padding: 12px 24px;">Please use a modern browser to view this website.</div>
- <![endif]--><div class="header-top-bg"><div class="site-width header-top"><a class="logo" href="http://freemarker.org" role="banner"> <img itemprop="image" src="logo.png" alt="FreeMarker">
-</a><ul class="tabs"><li><a href="http://freemarker.org/">Home</a></li><li class="current"><a href="index.html">Manual</a></li><li><a class="external" href="api/index.html">Java API</a></li></ul><ul class="secondary-tabs"><li><a class="tab icon-heart" href="http://freemarker.org/contribute.html" title="Contribute"><span>Contribute</span></a></li><li><a class="tab icon-bug" href="https://issues.apache.org/jira/browse/FREEMARKER/" title="Report a Bug"><span>Report a Bug</span></a></li><li><a class="tab icon-download" href="http://freemarker.org/freemarkerdownload.html" title="Download"><span>Download</span></a></li></ul></div></div><div class="header-bottom-bg"><div class="site-width search-row"><a href="index.html" class="navigation-header">Manual</a><div class="navigation-header"></div><form method="get" class="search-form" action="search-results.html"><fieldset><legend class="sr-only">Search form</legend><label for="search-field" class="sr-only">Search query</label><input id="searc
h-field" name="q" type="search" class="search-input" placeholder="Search" spellcheck="false" autocorrect="off" autocomplete="off"><button type="submit" class="search-btn"><span class="sr-only">Search</span></button></fieldset></form></div><div class="site-width breadcrumb-row"><ul class="breadcrumb" itemscope itemtype="http://schema.org/BreadcrumbList"><li class="step-0" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="index.html"><span itemprop="name">Apache FreeMarker Manual</span></a></li><li class="step-1" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="ref.html"><span itemprop="name">Template Language Reference</span></a></li><li class="step-2" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="ref_directives.html"><span itemprop="name">Directive Reference</span></a></li><li class="step-
3" itemprop="itemListElement" itemscope itemtype="http://schema.org/ListItem"><a class="label" itemprop="item" href="ref_directive_list.html"><span itemprop="name">list, else, items, sep, break</span></a></li></ul><div class="bookmarks" title="Bookmarks"><span class="sr-only">Bookmarks:</span><ul class="bookmark-list"><li><a href="alphaidx.html">Alpha. index</a></li><li><a href="gloss.html">Glossary</a></li><li><a href="dgui_template_exp.html#exp_cheatsheet">Expressions</a></li><li><a href="ref_builtins_alphaidx.html">?builtins</a></li><li><a href="ref_directive_alphaidx.html">#directives</a></li><li><a href="ref_specvar.html">.spec_vars</a></li><li><a href="app_faq.html">FAQ</a></li></ul></div></div></div> <div class="main-content site-width">
- <div class="content-wrapper">
- <div id="table-of-contents-wrapper" class="col-left">
- <script>var breadcrumb = ["Apache FreeMarker Manual","Template Language Reference","Directive Reference","list, else, items, sep, break"];</script>
- <script src="toc.js?1489402528979"></script>
- <script src="docgen-resources/main.min.js?1489402528979"></script>
- </div>
-<div class="col-right"><div class="page-content"><div class="page-title"><div class="pagers top"><a class="paging-arrow previous" href="ref_directive_include.html"><span>Previous</span></a><a class="paging-arrow next" href="ref_directive_local.html"><span>Next</span></a></div><div class="title-wrapper">
-<h1 class="content-header header-section1" id="ref_directive_list" itemprop="headline">list, else, items, sep, break</h1>
-</div></div><div class="page-menu">
-<div class="page-menu-title">Page Contents</div>
-<ul><li><a class="page-menu-link" href="#autoid_100" data-menu-target="autoid_100">Synopsis</a></li><li><a class="page-menu-link" href="#autoid_101" data-menu-target="autoid_101">Description</a><ul><li><a class="page-menu-link" href="#autoid_102" data-menu-target="autoid_102">Simplest form</a></li><li><a class="page-menu-link" href="#autoid_103" data-menu-target="autoid_103">else directive</a></li><li><a class="page-menu-link" href="#autoid_104" data-menu-target="autoid_104">items directive</a></li><li><a class="page-menu-link" href="#autoid_105" data-menu-target="autoid_105">sep directive</a></li><li><a class="page-menu-link" href="#autoid_106" data-menu-target="autoid_106">break directive</a></li><li><a class="page-menu-link" href="#autoid_107" data-menu-target="autoid_107">Accessing iteration state</a></li><li><a class="page-menu-link" href="#autoid_108" data-menu-target="autoid_108">Nesting loops into each other</a></li><li><a class="page-menu-link" href="#autoid_109" data-menu-
target="autoid_109">Notes for Java programmers</a></li></ul></li></ul> </div><a name="ref.directive.list"></a>
-
-
-
-
-<h2 class="content-header header-section2" id="autoid_100">Synopsis</h2>
-
-
- <p>The simplest form for listing a sequence (or collection)
- is:</p>
-
-
-<pre class="metaTemplate"><code class="inline-code"><#list <em class="code-color">sequence</em> as <em class="code-color">item</em>>
- <em class="code-color">Part repeated for each item</em>
-</#list></code></pre>
-
-
- <p>and to list the key-value pairs of a hash (since
- 2.3.25):</p>
-
-
-<pre class="metaTemplate"><code class="inline-code"><#list <em class="code-color">hash</em> as <em class="code-color">key</em>, <em class="code-color">value</em>>
- <em class="code-color">Part repeated for each key-value pair</em>
-</#list></code></pre>
-
-
- <p>But these are just cases of the generic forms, which are shown
- below. Note that for simplicity we only show the generic forms for
- sequence listing; simply replace "<code class="inline-code">as
- <em class="code-color">item</em></code>" with
- "<code class="inline-code">as <em class="code-color">key</em>,
- <em class="code-color">value</em></code>" to get the
- generic form for hash listing.</p>
-
- <p>Generic form 1:</p>
-
-
-<pre class="metaTemplate"><code class="inline-code"><#list <em class="code-color">sequence</em> as <em class="code-color">item</em>>
- <em class="code-color">Part repeated for each item</em>
-<#else>
- <em class="code-color">Part executed when there are 0 items</em>
-</#list></code></pre>
-
-
- <p>Where:</p>
-
- <ul>
- <li>
- The <code class="inline-code">else</code> part is optional, and is only
- supported since FreeMarker 2.3.23.
- </li>
-
- <li>
- <code class="inline-code"><em class="code-color">sequence</em></code>:
- Expressions evaluates to a sequence or collection of the items
- we want to iterate through
- </li>
-
- <li>
- <code class="inline-code"><em class="code-color">item</em></code>: Name
- of the <a href="dgui_misc_var.html">loop variable</a> (not
- an expression)
- </li>
-
- <li>
- The various "parts" between the tags can
- contain arbitrary FTL (including nested
- <code class="inline-code">list</code>-s)
- </li>
- </ul>
-
- <p>Generic form 2 (since FreeMarker 2.3.23):</p>
-
-
-<pre class="metaTemplate"><code class="inline-code"><#list <em class="code-color">sequence</em>>
- <em class="code-color">Part executed once if we have more than 0 items</em>
- <#items as <em class="code-color">item</em>>
- <em class="code-color"> Part repeated for each item</em>
- </#items>
- <em class="code-color">Part executed once if we have more than 0 items</em>
-<#else>
- <em class="code-color">Part executed when there are 0 items</em>
-</#list></code></pre>
-
-
- <p>Where: see the "Where" section of Form 1 above
- (and thus the <code class="inline-code">else</code> part is optional here
- too).</p>
-
-
-
-
-
-<h2 class="content-header header-section2" id="autoid_101">Description</h2>
-
-
-
-
-
-
-
-<h3 class="content-header header-section3" id="autoid_102">Simplest form</h3>
-
-
- <p>Assuming <code class="inline-code">users</code> contains the
- <code class="inline-code">['Joe', 'Kate', 'Fred']</code> sequence:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#list users as user>
- <p>${user}
-</#list></pre></div>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-output"> <p>Joe
- <p>Kate
- <p>Fred</pre></div>
-
- <p>The <code class="inline-code">list</code> directive executes the code
- between the <code class="inline-code">list</code> start-tag and
- <code class="inline-code">list</code> end-tag (the body of
- <code class="inline-code">list</code> from now on) for each value in the
- sequence (or collection) specified as its first parameter. For
- each such iteration the loop variable (<code class="inline-code">user</code> in
- this example) will store the value of the current item.</p>
-
- <p>The loop variable (<code class="inline-code">user</code>) only exists
- inside the <code class="inline-code">list</code> body. Also, macros/functions
- called from within the loop won't see it (as if it were a local
- variable).</p>
-
- <p>Listing hashes is very similar, but you need to provide two
- variable names after the <code class="inline-code">as</code>; one for the hash
- key, and another for the associated value. Assuming
- <code class="inline-code">products</code> is <code class="inline-code">{ "apple": 5, "banana":
- 10, "kiwi": 15 }</code>:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#list products as name, price>
- <p>${name}: ${price}
-</#list></pre></div>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-output"> <p>apple: 5
- <p>banan: 10
- <p>kiwi: 15</pre></div>
-
- <p>Note that not all hash variables can be listed, because some
- of them isn't able to enumerate its keys. It's practically safe to
- assume though that hashes that stand for Java
- <code class="inline-code">Map</code> objects can be listed.</p>
-
-
-
-
-
-
-
-<h3 class="content-header header-section3" id="autoid_103">else directive</h3>
-
-
- <a name="ref.directive.list.else"></a>
-
-
-
- <div class="callout note">
- <strong class="callout-label">Note:</strong>
-
- <p><code class="inline-code">else</code> inside <code class="inline-code">list</code> is
- only supported since FreeMarker 2.3.23</p>
- </div>
-
-
- <p>The <code class="inline-code">else</code> directive is used if when there
- are 0 items, you have to print something special instead of just
- printing nothing:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#list users as user>
- <p>${user}
-<#else>
- <p>No users
-</#list></pre></div>
-
- <p>This outputs the same as the earlier example, except when
- <code class="inline-code">users</code> contains 0 items:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-output"> <p>No users</pre></div>
-
- <p>Note that the loop variable (<code class="inline-code">user</code>)
- doesn't exist between the <code class="inline-code">else</code> tag and the
- <code class="inline-code">list</code> end-tag, since that part is not part of
- the loop.</p>
-
- <p><code class="inline-code">else</code> must be literally (means, in the
- source code) inside the body of the <code class="inline-code">list</code>
- directive. That is, you can't moved it out into a macro or
- included template.</p>
-
-
-
-
-
-
-
-<h3 class="content-header header-section3" id="autoid_104">items directive</h3>
-
-
- <a name="ref.directive.items"></a>
-
-
-
- <div class="callout note">
- <strong class="callout-label">Note:</strong>
-
- <p><code class="inline-code">items</code> exists since FreeMarker
- 2.3.23</p>
- </div>
-
-
- <p>The <code class="inline-code">items</code> directive is used if you have
- to print (or do) something before the first list item, and after
- the last list item, as far as there's at least 1 item. A typical
- example:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#list users>
- <ul>
- <#items as user>
- <li>${user}</li>
- </#items>
- </ul>
-</#list></pre></div>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-output"> <ul>
- <li>Joe</li>
- <li>Kate</li>
- <li>Fred</li>
- </ul></pre></div>
-
- <p>If there are 0 items, the above won't print anything, thus
- you don't end up with an empty
- <code class="inline-code"><ul></ul></code>.</p>
-
- <p>That is, when the <code class="inline-code">list</code> directive has no
- <code class="inline-code">as <em class="code-color">item</em></code> parameter,
- the body of its is executed exactly once if there's at least one
- item, or not at all otherwise. It's the body of the mandatory
- nested <code class="inline-code">items</code> directive that will be run for
- each item, and hence it's also the <code class="inline-code">items</code>
- directive that defines the loop variable with <code class="inline-code">as
- <em class="code-color">item</em></code>, not
- <code class="inline-code">list</code>.</p>
-
- <p>A <code class="inline-code">list</code> directive with
- <code class="inline-code">items</code> also can have an <code class="inline-code">else</code>
- directive:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#list users>
- <ul>
- <#items as user>
- <li>${user}</li>
- </#items>
- </ul>
-<#else>
- <p>No users
-</#list></pre></div>
-
- <p>Some further details:</p>
-
- <ul>
- <li>
- <p>The parser will check that a <code class="inline-code">list</code>
- without <code class="inline-code">as <em class="code-color">item</em></code>
- parameter always has a nested <code class="inline-code">items</code>
- directive, and that an <code class="inline-code">items</code> directive
- always has an enclosing <code class="inline-code">list</code> which has no
- <code class="inline-code">as <em class="code-color">item</em></code>
- parameter. This is checked when the template is parsed, not
- when the template is executed. Thus, these rules apply on the
- FTL source code itself, so you can't move
- <code class="inline-code">items</code> out into a macro or included
- template.</p>
- </li>
-
- <li>
- <p>A <code class="inline-code">list</code> can have multiple
- <code class="inline-code">items</code> directives, but only one of them will
- be allowed to run (as far as you don't leave and re-enter the
- enclosing <code class="inline-code">list</code> directive); and further
- attempts to call <code class="inline-code">items</code> will cause error. So
- multiple <code class="inline-code">items</code> can be utilized on different
- <code class="inline-code">if</code>-<code class="inline-code">else</code> branches for
- example, but not for iterating twice.</p>
- </li>
-
- <li>
- <p><code class="inline-code">items</code> directive can't have its own
- nested <code class="inline-code">else</code> directive, only the enclosing
- <code class="inline-code">list</code> can have</p>
- </li>
-
- <li>
- <p>The loop variable (<code class="inline-code">user</code>) only exists
- inside the body of the <code class="inline-code">items</code>
- directive.</p>
- </li>
- </ul>
-
-
-
-
-
-
-
-<h3 class="content-header header-section3" id="autoid_105">sep directive</h3>
-
-
- <a name="ref.directive.sep"></a>
-
-
-
- <div class="callout note">
- <strong class="callout-label">Note:</strong>
-
- <p><code class="inline-code">sep</code> exists since FreeMarker
- 2.3.23</p>
- </div>
-
-
- <p><code class="inline-code">sep</code> is used when you have to display
- something between each item (but not before the first item or
- after the last item). For example:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#list users as user>${user}<strong><#sep>, </strong></#list></pre></div>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-output">Joe, Kate, Fred</pre></div>
-
- <p>Above, <code class="inline-code"><#sep>, </#list></code> is a
- shorthand for <code class="inline-code"><#sep>,
- </#sep></#list></code>; the <code class="inline-code">sep</code>
- end-tag can be omitted if you would put it where the enclosing
- directive is closed anyway. In the next example, you couldn't use
- such abbreviation (HTML tags close nothing, as they are just raw
- text to output for FreeMarker):</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#list users as user>
- <div>
- ${user}<strong><#sep>, </#sep></strong>
- </div>
-</#list></pre></div>
-
- <p><code class="inline-code">sep</code> is just a shorthand for
- <code class="inline-code"><#if
- <em class="code-color">item</em>?has_next>...</#if></code>.
- Thus, it can be used anywhere where there's a
- <code class="inline-code">list</code> or <code class="inline-code">items</code> loop variable
- available, it can occur for multiple times, and it can have
- arbitrary nested content.</p>
-
- <p>The parser ensures that <code class="inline-code">sep</code> is only used
- on a place where there's a visible loop variable. This happens
- earlier than the actual execution of the template. Thus, you can't
- move <code class="inline-code">sep</code> from inside the associated
- <code class="inline-code">list</code> or <code class="inline-code">items</code> directive into
- a macro or included template (the parser can't know where those
- will be called from).</p>
-
-
-
-
-
-
-
-<h3 class="content-header header-section3" id="autoid_106">break directive</h3>
-
-
- <a name="ref.directive.list.break"></a>
-
-
-
- <p>You can exit the iteration at any point with the
- <code class="inline-code">break</code> directive. For example:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#list 1..10 as x>
- ${x}
- <#if x == 3>
- <strong><#break></strong>
- </#if>
-</#list></pre></div>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-output"> 1
- 2
- 3</pre></div>
-
- <p>The <code class="inline-code">break</code> directives can be placed
- anywhere inside <code class="inline-code">list</code> as far as it has
- <code class="inline-code">as <em class="code-color">item</em></code> parameter,
- otherwise it can be placed anywhere inside the
- <code class="inline-code">items</code> directive. If the
- <code class="inline-code">break</code> is inside <code class="inline-code">items</code>, it
- will only exit from <code class="inline-code">items</code>, not from
- <code class="inline-code">list</code>. In general, <code class="inline-code">break</code> will
- only exit from the directive whose body is called for each item,
- and can only be placed inside such directive. So for example can't
- use <code class="inline-code">break</code> inside <code class="inline-code">list</code>'s
- <code class="inline-code">else</code> section, unless there's the
- <code class="inline-code">list</code> is nested into another
- <code class="inline-code">break</code>-able directive.</p>
-
- <p>Just like <code class="inline-code">else</code> and
- <code class="inline-code">items</code>, <code class="inline-code">break</code> must be
- literally inside body of the directive to break out from, and
- can't be moved out into a macro or included template.</p>
-
-
-
-
-
-
-
-<h3 class="content-header header-section3" id="autoid_107">Accessing iteration state</h3>
-
-
-
-
-
-
- <p>Starting from 2.3.23, <a href="ref_builtins_loop_var.html">loop variable built-ins</a> is
- the preferred way of accessing current state of the iteration. For
- example, here we use the <code class="inline-code">counter</code> and
- <code class="inline-code">item_parity</code> loop variable built-ins (see all of
- them <a href="ref_builtins_loop_var.html">in the
- Reference</a>):</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#list users>
- <table>
- <#items as user>
- <tr class="${user<strong>?item_parity</strong>}Row">
- <td>${user<strong>?counter</strong>}
- <td>${user}
- </#items>
- </table>
-</#list></pre></div>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-output"> <table>
- <tr class="<strong>odd</strong>Row">
- <td><strong>1</strong>
- <td>Joe
- <tr class="<strong>even</strong>Row">
- <td><strong>2</strong>
- <td>Kate
- <tr class="<strong>odd</strong>Row">
- <td><strong>3</strong>
- <td>Fred
- </table></pre></div>
-
- <p>In 2.3.22 and earlier, there were two extra loop variables
- to retrieve the iteration state instead (and they still exist for
- backward compatibility):</p>
-
- <ul>
- <li>
- <p><code class="inline-code"><em class="code-color">item</em>_index</code>
- (<em>deprecated</em> by
- <code class="inline-code"><em class="code-color">item</em>?index</code>): The
- index (0-based number) of the current item in the loop.</p>
- </li>
-
- <li>
- <p><code class="inline-code"><em class="code-color">item</em>_has_next</code>
- (<em>deprecated</em> by
- <code class="inline-code"><em class="code-color">item</em>?has_next</code>):
- Boolean value that tells if the current item is the last in
- the sequence or not.</p>
- </li>
- </ul>
-
- <p>so in the above example, you could replace
- <code class="inline-code">${user?counter}</code> with <code class="inline-code">${user_index +
- 1}</code>.</p>
-
-
-
-
-
-
-
-<h3 class="content-header header-section3" id="autoid_108">Nesting loops into each other</h3>
-
-
- <p>Naturally, <code class="inline-code">list</code> or
- <code class="inline-code">items</code> can contain further
- <code class="inline-code">list</code>-s:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#list 1..2 as i>
- <#list 1..3 as j>
- i = ${i}, j = ${j}
- </#list>
-</#list></pre></div>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-output"> i = 1, j = 1
- i = 1, j = 2
- i = 1, j = 3
- i = 2, j = 1
- i = 2, j = 2
- i = 2, j = 3</pre></div>
-
- <p>It's also allowed to use clashing loop variable names
- like:</p>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-template"><#list 1..2 as i>
- Outer: ${i}
- <#list 10..12 as i>
- Inner: ${i}
- </#list>
- Outer again: ${i}
-</#list></pre></div>
-
-
-
-<div class="code-wrapper"><pre class="code-block code-output"> Outer: 1
- Inner: 10
- Inner: 11
- Inner: 12
- Outer again: 1
- Outer: 2
- Inner: 10
- Inner: 11
- Inner: 12
- Outer again: 2</pre></div>
-
-
-
-
-
-
-
-<h3 class="content-header header-section3" id="autoid_109">Notes for Java programmers</h3>
-
-
- <p><span class="marked-for-programmers">If classic compatible mode
- <code class="inline-code">list</code> accepts a scalar too and treats it as a
- single-element sequence.</span></p>
-
- <p><span class="marked-for-programmers">If you pass an collection that
- wraps an <code class="inline-code">java.util.Iterator</code> to the
- <code class="inline-code">list</code>, you can iterate over its elements only
- once, since <code class="inline-code">Iterator</code>s are by their nature
- one-off objects. When you try to list a such collection variable
- for the second time, an error will abort template
- processing.</span></p>
-
- <div class="bottom-pagers-wrapper"><div class="pagers bottom"><a class="paging-arrow previous" href="ref_directive_include.html"><span>Previous</span></a><a class="paging-arrow next" href="ref_directive_local.html"><span>Next</span></a></div></div></div></div> </div>
- </div>
-<div class="site-footer"><div class="site-width"><div class="footer-top"><div class="col-left sitemap"><div class="column"><h3 class="column-header">Overview</h3><ul><li><a href="http://freemarker.org/">What is FreeMarker?</a></li><li><a href="http://freemarker.org/freemarkerdownload.html">Download</a></li><li><a href="app_versions.html">Version history</a></li><li><a href="http://freemarker.org/history.html">About us</a></li><li><a itemprop="license" href="app_license.html">License</a></li></ul></div><div class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a href="http://freemarker-online.kenshoo.com/">Try template online</a></li><li><a href="dgui_template_exp.html#exp_cheatsheet">Expressions cheatsheet</a></li><li><a href="ref_directive_alphaidx.html">#directives</a></li><li><a href="ref_builtins_alphaidx.html">?built_ins</a></li><li><a href="ref_specvar.html">.special_vars</a></li></ul></div><div class="column"><h3 class="column-header">Community</h3><ul><li><a href
="https://github.com/freemarker/freemarker">FreeMarker on Github</a></li><li><a href="https://twitter.com/freemarker">Follow us on Twitter</a></li><li><a href="https://issues.apache.org/jira/browse/FREEMARKER/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="http://freemarker.org/mailing-lists.html">Mailing lists</a></li></ul></div></div><div class="col-right"><ul class="social-icons"><li><a class="github" href="https://github.com/freemarker/freemarker">Github</a></li><li><a class="twitter" href="https://twitter.com/freemarker">Twitter</a></li><li><a class="stack-overflow" href="http://stackoverflow.com/questions/ask?tags=freemarker">Stack Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/" rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind XML Editor</span></a></div></div><div class="footer-bottom"> <p class="last-generated">
-Last generated:
-<time itemprop="dateModified" datetime="2017-03-13T10:55:28Z" title="Monday, March 13, 2017 10:55:28 AM GMT">2017-03-13 10:55:28 GMT</time>, for Freemarker 2.3.26 </p>
-<p class="copyright">
-� <span itemprop="copyrightYear">1999</span>\u20132017
-<a itemtype="http://schema.org/Organization" itemprop="copyrightHolder" href="http://apache.org/">The Apache Software Foundation</a>. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation. </p>
-</div></div></div></body>
-</html>