Updated 2.3.28 nightly Manual
Project: http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/commit/ad3a793e Tree: http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/tree/ad3a793e Diff: http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/diff/ad3a793e Branch: refs/heads/asf-site Commit: ad3a793e666a78aa30746d520ea75b5c0268e3f2 Parents: b8b70b7 Author: ddekany <ddek...@apache.org> Authored: Tue Mar 20 22:52:32 2018 +0100 Committer: ddekany <ddek...@apache.org> Committed: Tue Mar 20 22:52:32 2018 +0100 ---------------------------------------------------------------------- builds/fm2.3.28/alphaidx.html | 10 +- builds/fm2.3.28/app_faq.html | 111 ++++++++--- builds/fm2.3.28/detailed-toc.html | 4 +- .../fm2.3.28/dgui_misc_alternativesyntax.html | 194 +++++++++++++------ builds/fm2.3.28/dgui_template_exp.html | 40 +++- .../fm2.3.28/dgui_template_valueinsertion.html | 10 + .../pgui_config_incompatible_improvements.html | 40 ++-- builds/fm2.3.28/ref_builtins_alphaidx.html | 8 + builds/fm2.3.28/ref_builtins_number.html | 21 ++ builds/fm2.3.28/ref_builtins_sequence.html | 39 +++- builds/fm2.3.28/ref_builtins_string.html | 4 + .../ref_depr_numerical_interpolation.html | 11 +- builds/fm2.3.28/toc.js | 23 +++ builds/fm2.3.28/versions_2_3_28.html | 165 ++++++++++++++++ builds/fm2.3.28/xgui_preface.html | 2 +- 15 files changed, 571 insertions(+), 111 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/ad3a793e/builds/fm2.3.28/alphaidx.html ---------------------------------------------------------------------- diff --git a/builds/fm2.3.28/alphaidx.html b/builds/fm2.3.28/alphaidx.html index 3feb486..4354c4f 100644 --- a/builds/fm2.3.28/alphaidx.html +++ b/builds/fm2.3.28/alphaidx.html @@ -218,7 +218,7 @@ under the License. call a method, <a href="dgui_template_exp.html#dgui_template_exp_methodcall">Method call</a> </dt> <dt> - caller_template_name, <a href="ref_specvar.html">Special Variable Reference</a> + caller_template_name, <a href="ref_specvar.html#ref_specvar_caller_template_name">Special Variable Reference</a> </dt> <dt> cap_first built-in, <a href="ref_builtins_string.html#ref_builtin_cap_first">cap_first</a> @@ -351,7 +351,7 @@ under the License. counter built-in, <a href="ref_builtins_loop_var.html#ref_builtin_counter">counter</a> </dt> <dt> - current_template_name, <a href="ref_specvar.html#ref_specvar_caller_template_name">Special Variable Reference</a> + current_template_name, <a href="ref_specvar.html">Special Variable Reference</a> </dt> <dt> current date-time, <a href="ref_specvar.html">Special Variable Reference</a> @@ -960,6 +960,9 @@ under the License. math, <a href="dgui_template_exp.html#dgui_template_exp_arit">Arithmetical calculations</a> </dt> <dt> + max built-in, <a href="ref_builtins_sequence.html#ref_builtin_min_max">min, max</a> + </dt> + <dt> merging, <a href="pgui_quickstart_merge.html">Merging the template with the data-model</a> </dt> <dt> @@ -974,6 +977,9 @@ under the License. MIME type, <a href="dgui_misc_autoescaping.html">Auto-escaping and output formats</a> </dt> <dt> + min built-in, <a href="ref_builtins_sequence.html#ref_builtin_min_max">min, max</a> + </dt> + <dt> missing value test operator, <a href="dgui_template_exp.html#dgui_template_exp_missing_test">Missing value test operator</a> </dt> <dt> http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/ad3a793e/builds/fm2.3.28/app_faq.html ---------------------------------------------------------------------- diff --git a/builds/fm2.3.28/app_faq.html b/builds/fm2.3.28/app_faq.html index 6e37cc9..85c5ff7 100644 --- a/builds/fm2.3.28/app_faq.html +++ b/builds/fm2.3.28/app_faq.html @@ -121,6 +121,15 @@ under the License. </a> </li> <li> + <a href="#faq_alternative_syntax_interpolation"> + + <code class="inline-code">${<em class="code-color">...</em>}</code> and/or + <code class="inline-code">#{<em class="code-color">...</em>}</code> is used in + the output I have to generate a lot, and FreeMarker tries to + resolve them. What to do? + </a> + </li> + <li> <a href="#faq_legal_variable_names"> What are the legal variable names? @@ -341,6 +350,25 @@ under the License. </li> <li> + <p><a href="dgui_misc_autoescaping.html">Auto-escaping + option</a> to escape HTML and XML special characters + printed with + <code class="inline-code">${<em class="code-color">...</em>}</code>. So you + can just write <code class="inline-code">${x}</code> instead of + <code class="inline-code"><c:out value="${x}"/></code>, and most + importantly, you can't accidentally forget to do + escaping.</p> + </li> + + <li> + <p>Locale-sensitive number and date formatting by default. + When you output for a human audience, all you need to do is + just write <code class="inline-code">${x}</code> rather than + <code class="inline-code"><fmt:formatNumber value="${x}" + /></code>.</p> + </li> + + <li> <p>No servlet specific scopes and other highly technical things in templates (unless, of course, you expose them into the data-model deliberately). It was made for MVC from the @@ -353,14 +381,6 @@ under the License. </li> <li> - <p>Locale-sensitive number and date formatting by default. - When you output for a human audience, all you need to do is - just write <code class="inline-code">${x}</code> rather than - <code class="inline-code"><fmt:formatNumber value="${x}" - /></code>.</p> - </li> - - <li> <p>Easier to define ad-hoc macros and functions.</p> </li> @@ -829,19 +849,50 @@ under the License. <dd class="answer"> - <p>Starting from FreeMarker 2.3.4 you can use - <code class="inline-code">[</code> and <code class="inline-code">]</code> instead of - <code class="inline-code"><</code> and <code class="inline-code">></code>. For more - details <a href="dgui_misc_alternativesyntax.html">read - this...</a></p> + <p>You can use <code class="inline-code">[</code> and <code class="inline-code">]</code> + instead of <code class="inline-code"><</code> and <code class="inline-code">></code>; + see more about square bracket tag syntax <a href="dgui_misc_alternativesyntax.html">here.</a> The comparison + operators, like <code class="inline-code"><</code>, also have an alternative + syntax (<code class="inline-code">lt</code> and <code class="inline-code">&lt;</code> in + this case); see more about them <a href="dgui_template_exp.html#dgui_template_exp_comparison">here</a>. Also, the + <code class="inline-code">&&</code> operator (which is not well-format + HTML/XML) can be written as <code class="inline-code">\and</code> or + <code class="inline-code">&amp;&amp;</code> since 2.3.27.</p> </dd> - <dt class="question" id="faq_legal_variable_names"> + <dt class="question" id="faq_alternative_syntax_interpolation"> 9. + <code class="inline-code">${<em class="code-color">...</em>}</code> and/or + <code class="inline-code">#{<em class="code-color">...</em>}</code> is used in + the output I have to generate a lot, and FreeMarker tries to + resolve them. What to do? + + </dt> + + + <dd class="answer"> + + <p>You can escape them like + <code class="inline-code">${'$'}{<em class="code-color">...</em>}</code>, however + that's impractical if you have to do that often. So starting from + FreeMarker 2.3.28 you can use + <code class="inline-code">[=<em class="code-color">...</em></code><code class="inline-code">]</code> + instead; see more about the square bracket interpolation syntax + <a href="dgui_misc_alternativesyntax.html">here.</a> If you + are going to generate JSP files or even FreeMarker templates, this + is very useful.</p> + </dd> + + + + + + <dt class="question" id="faq_legal_variable_names"> + 10. What are the legal variable names? @@ -865,7 +916,7 @@ under the License. <dt class="question" id="faq_strange_variable_name"> - 10. + 11. How can I use variable names (macro name, parameter name) that contain minus sign (<code class="inline-code">-</code>), colon (<code class="inline-code">:</code>), dot (<code class="inline-code">.</code>), or or other @@ -946,7 +997,7 @@ under the License. <dt class="question" id="faq_jsp_custom_tag_syntax"> - 11. + 12. Why do I get "java.lang.IllegalArgumentException: argument type mismatch" when I try to use <em>X</em> JSP custom tag? @@ -1007,7 +1058,7 @@ under the License. <dt class="question" id="faq_servlet_include"> - 12. + 13. How to include other resources in a way as <code class="inline-code">jsp:include</code> does it? @@ -1052,7 +1103,7 @@ under the License. <dt class="question" id="faq_parameter_unwrapping"> - 13. + 14. How can I get the parameters to my plain-Java-method/<code class="inline-code">TemplateMethodModelEx</code>/<code class="inline-code">TemplateTransformModel</code>/<code class="inline-code">TemplateDirectiveModel</code> implementation as plain @@ -1118,7 +1169,7 @@ under the License. <dt class="question" id="faq_nonstring_keys"> - 14. + 15. Why I can't use non-string key in the <code class="inline-code">myMap[myKey]</code> expression? And what to do now? @@ -1178,7 +1229,7 @@ under the License. <dt class="question" id="faq_simple_map"> - 15. + 16. When I list the contents of a map (a hash) with <code class="inline-code">?keys</code>/<code class="inline-code">?values</code>, I get the <code class="inline-code">java.util.Map</code> methods mixed with the real map @@ -1210,7 +1261,7 @@ under the License. <dt class="question" id="faq_modify_seq_and_map"> - 16. + 17. How can I modify sequences (lists) and hashes (maps) in FreeMarker templates? @@ -1361,7 +1412,7 @@ under the License. <dt class="question" id="faq_null"> - 17. + 18. What about <code class="inline-code">null</code> and the FreeMarker template language? @@ -1421,7 +1472,7 @@ under the License. <dt class="question" id="faq_capture"> - 18. + 19. How can I use the output of a directive (macro) in expressions (as a parameter to another directive)? @@ -1445,7 +1496,7 @@ under the License. <dt class="question" id="faq_questionmark"> - 19. + 20. Why do I have "?"-s in the output instead of character <em>X</em>? @@ -1494,7 +1545,7 @@ t.process(root, out); <dt class="question" id="faq_retrieve_calculated_values"> - 20. + 21. How to retrieve values calculated in templates after template execution done? @@ -1537,7 +1588,7 @@ TemplateModel x = env.getVariable("x"); // get variable x</pre></div> <dt class="question" id="faq_assign_to_dynamic_variable_name"> - 21. + 22. How to assign to (or <code class="inline-code">#import</code> into) a dynamically constructed variable name (like to name that's stored in another variable)? @@ -1564,7 +1615,7 @@ TemplateModel x = env.getVariable("x"); // get variable x</pre></div> <dt class="question" id="faq_template_uploading_security"> - 22. + 23. Can I allow users to upload templates and what are the @@ -1665,7 +1716,7 @@ TemplateModel x = env.getVariable("x"); // get variable x</pre></div> <dt class="question" id="faq_implement_function_or_macro_in_java"> - 23. + 24. How to implement a function or macro in Java Language instead of in the template language? @@ -1702,7 +1753,7 @@ TemplateModel x = env.getVariable("x"); // get variable x</pre></div> <dt class="question" id="faq_nice_error_page"> - 24. + 25. <a name="misc.faq.niceErrorPage"></a> In my Servlet based application, how do I show a nice error page instead of a stack trace when error occurs during template processing? @@ -1771,7 +1822,7 @@ TemplateModel x = env.getVariable("x"); // get variable x</pre></div> <dt class="question" id="faq_html_editor_mangles"> - 25. + 26. I'm using a visual HTML editor that mangles template tags. Will you change the template language syntax to accommodate my editor?