You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@velocity.apache.org by he...@apache.org on 2006/09/19 23:00:26 UTC
svn commit: r447969 [10/10] - in /jakarta/velocity/engine/trunk: ./ build/
build/xsl/ examples/anakia/build/ examples/anakia/xdocs/
examples/anakia/xdocs/about/ examples/anakia/xdocs/stylesheets/
examples/app_example1/ examples/app_example2/ examples/c...
Modified: jakarta/velocity/engine/trunk/xdocs/translations/user-guide_fi.xml
URL: http://svn.apache.org/viewvc/jakarta/velocity/engine/trunk/xdocs/translations/user-guide_fi.xml?view=diff&rev=447969&r1=447968&r2=447969
==============================================================================
--- jakarta/velocity/engine/trunk/xdocs/translations/user-guide_fi.xml (original)
+++ jakarta/velocity/engine/trunk/xdocs/translations/user-guide_fi.xml Tue Sep 19 14:00:14 2006
@@ -21,7 +21,7 @@
</ol>
</li>
<li><a href="#VelocityTemplateLanguage(VTL):Johdanto">Velocity
-Template Language (VTL): Johdanto</a></li>
+Template Language (VTL): Johdanto</a></li>
<li><a href="#HeiVelocityMaailma!">Hei Velocity Maailma!</a></li>
<li><a href="#Kommentit">Kommentit</a></li>
<li><a href="#Viittaukset">Viittaukset</a>
@@ -399,9 +399,9 @@
tunnisteen on alettava aakkosnumeerisella merkillä (a..z tai
A..Z). Muuttujan loput merkit ovat rajoitettu seuraaviin:
- </p>
+ </p>
- <p>
+ <p>
<ul>
<li>aakkoset (a .. z, A .. Z)</li>
<li>numerot (0 .. 9)</li>
@@ -806,7 +806,7 @@
<code>$getFoo</code>. Samalla tavalla, kun sivupohjassa viitataan
muuttujaan <code>$bar.Foo</code>, ensin yritetään viittausta
<em>$getFoo()</em> ja sitten <em>getfoo()</em>.
- </p>
+ </p>
<p>
Huomaa: <em>Viittauksia ilmentymämuuttujiin (instance variables)
@@ -1537,25 +1537,25 @@
</p>
<ul>
- <li>
+ <li>
Viittaus : mitä tahansa '$' merkillä alkavaa
</li>
- <li>
+ <li>
Tekstivakio : esimerkiksi "$foo" tai 'hei'
</li>
- <li>
+ <li>
Numerovakio : 1, 2 jne
</li>
- <li>
+ <li>
Numeroväli : [ 1..2] tai [$foo .. $bar]
</li>
- <li>
+ <li>
ObjectArray : [ "a", "b", "c"]
</li>
- <li>
+ <li>
boolean arvo true (tosi)
</li>
- <li>
+ <li>
boolean arvo false (epätosi)
</li>
</ul>
@@ -1592,7 +1592,7 @@
generoi värejä peräkkäisessä järjestyksessä taulukon rivien
värien määrittämiseksi.
</p>
-
+
<p>
Jos sinun tarvitsee kiertää tämä ominaisuus, voit hakea arvon
metodista uudeksi viittaukseksi, ja antaa sen argumentiksi:
@@ -1604,7 +1604,7 @@
]]></source>
<strong>Velocimakro ominaisuudet</strong>
-
+
<p>
<code>velocity.properties</code> tiedostossa on useita rivejä
joiden avulla Velocimakrojen toimintaa voidaan muuttaa
Modified: jakarta/velocity/engine/trunk/xdocs/translations/user-guide_fr.xml
URL: http://svn.apache.org/viewvc/jakarta/velocity/engine/trunk/xdocs/translations/user-guide_fr.xml?view=diff&rev=447969&r1=447968&r2=447969
==============================================================================
--- jakarta/velocity/engine/trunk/xdocs/translations/user-guide_fr.xml (original)
+++ jakarta/velocity/engine/trunk/xdocs/translations/user-guide_fr.xml Tue Sep 19 14:00:14 2006
@@ -8,9 +8,9 @@
<author email="jean-francois.elfouly@wanadoo.fr">Jean-François El Fouly</author>
</properties>
<body>
-
+
<section name="Table des Matières" href="TabledesMatières">
-
+
<ol>
<li><a href="#Aproposdecedocument">A propos de ce document</a></li>
<li><a href="#Velocity,qu'est-cequec'est?">Velocity, qu'est-ce que c'est?</a></li>
@@ -313,7 +313,7 @@
$person.setAttributes( ["Strange", "Weird", "Excited"] )
]]></source>
<p>
- Les deux premiers exemples -- <em>$customer.getAddress()</em> et
+ Les deux premiers exemples -- <em>$customer.getAddress()</em> et
<em>$purchase.getTotal()</em> -- peuvent avoir l'air semblables à ceux utilisés dans la section précédente,
consacrée aux Propriétés, <em>$customer.Address</em> et
<em>$purchase.Total</em>. Si vous avez deviné que ces exemples sont liés entre eux d'une manière ou d'une autre,
@@ -789,7 +789,7 @@
#end
]]></source>
<p>
- Cette fois, si <em>$foo</em> vaut <em>true</em>, alors <em>!$foo</em> est évalué comme <em>false</em>,
+ Cette fois, si <em>$foo</em> vaut <em>true</em>, alors <em>!$foo</em> est évalué comme <em>false</em>,
et il n'y a pas de sortie. Si <em>$foo</em> est <em>false</em>, alors <em>!$foo</em> est évalué à <em>true</em>
et <strong>PAS ça</strong> est produit en sortie. Attention à ne pas confondre ceci avec la
<em>référence silencieuse $!foo</em> que nous avons déjà rencontrée et qui représente quelque chose de complètement
@@ -1202,8 +1202,8 @@
parce qu'il y a un retour chariot après 'Ganelin', et donc le \\ final, qui précède le <code>#end</code> fait partie
du corps du bloc.
</p>
-
-
+
+
<p>
Si <em>$jazz</em> est faux, la sortie est
</p>
@@ -1211,8 +1211,8 @@
<source><![CDATA[
\
]]></source>
-
-
+
+
<p>
Notons que les choses vont commencer à mal se passer
si des éléments de script ne sont pas échappés correctement.
@@ -1279,14 +1279,14 @@
#set( $foo = $bar / 2 )
]]></source>
<p>
- Lorsqu'une opération de division est exécutée, le résultat sera un entier. Le reste éventuel de la division peut
+ Lorsqu'une opération de division est exécutée, le résultat sera un entier. Le reste éventuel de la division peut
être obtenu en utilisant l'opérateur modulo (<em>%</em>).
</p>
<source><![CDATA[
#set( $foo = $bar % 5 )
]]></source>
</subsection>
-
+
<subsection name="Opérateur d'intervalle (range)" href="Opérateurd'intervalle(range)">
<p>
L'opérateur d'intervalle peut être utilisé en conjonction avec les instructions <em>#set</em> et
@@ -1344,10 +1344,10 @@
pas assez de données pour remplir la table, trouveront cet opérateur d'intervalle particulièrement utile.
</p>
</subsection>
-
+
<subsection name="Questions pointues: Echappement et !" href="Questionspointues:Echappementet!">
<p>
- Lorsqu'une référence est annulée par le caractère <em>!</em> et que ce caractère
+ Lorsqu'une référence est annulée par le caractère <em>!</em> et que ce caractère
<em>!</em> est précédé par un caractère d'échappement <em>\</em>, la référence est traitée de manière particulière.
A noter: les différences entre l'échappement ordinaire et le cas particulier où <em>\</em> précède <em>!</em>
comme ici:
@@ -1381,7 +1381,7 @@
\bar
]]></source>
</subsection>
-
+
<subsection name="Compléments divers sur les Velocimacros" href="ComplémentsdiverssurlesVelocimacros">
<p>
Cette section est une mini-FAQ sur différents sujets relatifs aux Velocimacros.
@@ -1485,7 +1485,7 @@
]]></source>
<p>Ne gardez pas cette configuration en production.</p>
</subsection>
-
+
<subsection name="Concaténation de chaînes" href="Concaténationdechaînes">
<p>
Une question habituelle parmi les développeurs est:
Modified: jakarta/velocity/engine/trunk/xdocs/user-guide.xml
URL: http://svn.apache.org/viewvc/jakarta/velocity/engine/trunk/xdocs/user-guide.xml?view=diff&rev=447969&r1=447968&r2=447969
==============================================================================
--- jakarta/velocity/engine/trunk/xdocs/user-guide.xml (original)
+++ jakarta/velocity/engine/trunk/xdocs/user-guide.xml Tue Sep 19 14:00:14 2006
@@ -12,7 +12,7 @@
<section name="Moved" href="Moved">
<p>
-Velocity documentation has moved
+Velocity documentation has moved
<a href="docs/user-guide.html">here</a>.
</p>
Modified: jakarta/velocity/engine/trunk/xdocs/veltag.xml
URL: http://svn.apache.org/viewvc/jakarta/velocity/engine/trunk/xdocs/veltag.xml?view=diff&rev=447969&r1=447968&r2=447969
==============================================================================
--- jakarta/velocity/engine/trunk/xdocs/veltag.xml (original)
+++ jakarta/velocity/engine/trunk/xdocs/veltag.xml Tue Sep 19 14:00:14 2006
@@ -11,7 +11,7 @@
<section name="Moved" href="Moved">
<p>
-Velocity documentation has moved
+Velocity documentation has moved
<a href="docs/veltag.html">here</a>.
</p>
Modified: jakarta/velocity/engine/trunk/xdocs/vtl-reference-guide.xml
URL: http://svn.apache.org/viewvc/jakarta/velocity/engine/trunk/xdocs/vtl-reference-guide.xml?view=diff&rev=447969&r1=447968&r2=447969
==============================================================================
--- jakarta/velocity/engine/trunk/xdocs/vtl-reference-guide.xml (original)
+++ jakarta/velocity/engine/trunk/xdocs/vtl-reference-guide.xml Tue Sep 19 14:00:14 2006
@@ -12,7 +12,7 @@
<section name="Moved" href="Moved">
<p>
-Velocity documentation has moved
+Velocity documentation has moved
<a href="docs/vtl-reference-guide.html">here</a>.
</p>
Modified: jakarta/velocity/engine/trunk/xdocs/webapps.xml
URL: http://svn.apache.org/viewvc/jakarta/velocity/engine/trunk/xdocs/webapps.xml?view=diff&rev=447969&r1=447968&r2=447969
==============================================================================
--- jakarta/velocity/engine/trunk/xdocs/webapps.xml (original)
+++ jakarta/velocity/engine/trunk/xdocs/webapps.xml Tue Sep 19 14:00:14 2006
@@ -15,7 +15,7 @@
Velocity is often used to generate web pages in applications, usually as a direct replacement
for JSP. Some of the benefits of using Velocity to generate web pages are:
</p>
-
+
<ul>
<li> <strong>Simplicity</strong> - The pages can be written and maintained by non-technical web designers.
</li>
@@ -26,7 +26,7 @@
<li> <strong>Access both methods and properties</strong> - Web designers can reference methods as well as properties of objects in a context.
</li>
-<li> <strong>Consistency</strong> - Velocity can be used for other text generation tasks (such as sending email)
+<li> <strong>Consistency</strong> - Velocity can be used for other text generation tasks (such as sending email)
providing a consistent way to mark up text.
</li>
</ul>
@@ -39,33 +39,33 @@
<section name="Use a Framework" href="UseaFramework">
<p>
-The primary purpose of the Velocity engine is simply to generate text based on
-a template. Consequently, Velocity does not contain any web-related functionality in and of itself.
-To make a web application, you will need a framework to respond to HTTP requests,
-handle user authentication, make business logic calls, and generate a response.
+The primary purpose of the Velocity engine is simply to generate text based on
+a template. Consequently, Velocity does not contain any web-related functionality in and of itself.
+To make a web application, you will need a framework to respond to HTTP requests,
+handle user authentication, make business logic calls, and generate a response.
There are several strong contenders.
</p>
<ol>
<li> <strong>Velocity Tools / VelocityViewServlet</strong> -
-The easiest way to get started is to download the companion <a href="http://jakarta.apache.org/velocity/tools/">Velocity Tools</a>
-subproject and use the
-<a href="http://jakarta.apache.org/velocity/tools/view/">VelocityViewServlet</a>. This servlet is easy to configure
-and install. You create a directory of templates on your web server, edit an XML file that lists various "Tools" to
+The easiest way to get started is to download the companion <a href="http://jakarta.apache.org/velocity/tools/">Velocity Tools</a>
+subproject and use the
+<a href="http://jakarta.apache.org/velocity/tools/view/">VelocityViewServlet</a>. This servlet is easy to configure
+and install. You create a directory of templates on your web server, edit an XML file that lists various "Tools" to
place in the context and you are off. More details can be found in the tutorial below.
</li>
<li> <strong>Velocity Tools / VelocityStruts</strong> -
You may be familiar with the popular <a href="http://struts.apache.org/">Struts</a> framework, originally designed to provide much needed
application functionality to JSP. With the <a href="http://jakarta.apache.org/velocity/tools/struts/">VelocityStruts</a>
-module of Velocity Tools you can substitute Velocity for JSP as the page template language. This allows you
+module of Velocity Tools you can substitute Velocity for JSP as the page template language. This allows you
to take advantage of the large base of Struts infrastructure while designing pages using Velocity.
</li>
-<li><strong>Third party frameworks</strong> - There are a number of third party frameworks listed on the
+<li><strong>Third party frameworks</strong> - There are a number of third party frameworks listed on the
<a href="http://wiki.apache.org/jakarta-velocity/PoweredByVelocity">PoweredByVelocity</a>
wiki page. Of these, <a href="http://www.springframework.org/">Spring</a> is probably the most sophisticated and well known.
-<a href="http://jakarta.apache.org/turbine/">Jakarta Turbine</a> has many features and can also be very useful.
+<a href="http://jakarta.apache.org/turbine/">Jakarta Turbine</a> has many features and can also be very useful.
It was built with Velocity as the primary page language, which is not surprising since many of the original Velocity
developers were involved in creating it.
A simpler alternative is the <a href="http://mav.sourceforge.net/">Maverick</a> framework
@@ -90,12 +90,12 @@
<section name="Web-Specific Issues" href="Web-SpecificIssues">
<p>
-There are a few issues with Velocity that are specific to web applications. Here is a brief discussion of the most
+There are a few issues with Velocity that are specific to web applications. Here is a brief discussion of the most
commonly encountered issues.
</p>
<subsection name="Changing Object State - Don't!" href="ChangingObjectState-Don't!">
-<p>Velocity provides the ability to call any method of an object acting as a reference. This can be useful when displaying
+<p>Velocity provides the ability to call any method of an object acting as a reference. This can be useful when displaying
information into the page but is dangerous when object or application state is modified.
</p>
@@ -121,12 +121,12 @@
<p>The problem with this approach is that the code cannot be repeated in multiple parts of the page. You may not intend
to do so, but it's easy to forget this when cutting and pasting or writing control statements (such as #if or #foreach).
-This becomes more of an issue when you are dealing with application or session-level state.
+This becomes more of an issue when you are dealing with application or session-level state.
</p>
<p>The (strongly) recommended practice is
to only use Velocity for inserting information into text. Method calls can be useful to retrieve information. However, it's generally a bad idea
-to use a method call to change object state, and it's always a bad idea to change application state.
+to use a method call to change object state, and it's always a bad idea to change application state.
</p>
<p>If you find yourself needing to change object state (as in the previous example) try precalculating all the possible
@@ -134,7 +134,7 @@
done by the controller.
</p>
-<p>On a related note, you should always put a List or Set into the context instead of an Iterator or Enumeration. This allows the collection to
+<p>On a related note, you should always put a List or Set into the context instead of an Iterator or Enumeration. This allows the collection to
be used more than once in the page with no change in behavior.
</p>
@@ -143,10 +143,10 @@
<subsection name="Escaping HTML/XML Entities" href="EscapingHTML/XMLEntities">
<p>
-Any user-entered text that contains special HTML or XML entities (such as <, >, or &) needs to be escaped
+Any user-entered text that contains special HTML or XML entities (such as <, >, or &) needs to be escaped
before included in the web page. This is required, both to ensure the text is visible, and also to prevent
-dangerous <a href="http://en.wikipedia.org/wiki/Cross_site_scripting">cross-site scripting</a>.
-Unlike, for example, JSTL (the Java Standard Tag Language found in Java Server Pages),
+dangerous <a href="http://en.wikipedia.org/wiki/Cross_site_scripting">cross-site scripting</a>.
+Unlike, for example, JSTL (the Java Standard Tag Language found in Java Server Pages),
Velocity does not contain any HTML-specific escaping functionality. However, you have three options:
</p>
@@ -171,10 +171,10 @@
<subsection name="Securing the Application" href="SecuringtheApplication">
<p>
-Since a web application is running on a central server, that typically has multiple users and confidential resources,
-care must be taken to make certain that the web application is secure. Most standard web security principles apply to a
-web application built with Velocity. A few specific issues (such as system configuration, more on cross-site scripting,
-and method introspection) are written up in this article on
+Since a web application is running on a central server, that typically has multiple users and confidential resources,
+care must be taken to make certain that the web application is secure. Most standard web security principles apply to a
+web application built with Velocity. A few specific issues (such as system configuration, more on cross-site scripting,
+and method introspection) are written up in this article on
<a href="http://wiki.apache.org/jakarta-velocity/BuildingSecureWebApplications">Building Secure Applications with Velocity</a>.
</p>
@@ -183,7 +183,7 @@
<subsection name="Log Files" href="LogFiles">
<p>
-A minor point is that Velocity, in the absence of any log-related configuration, creates a log file in the current directory.
+A minor point is that Velocity, in the absence of any log-related configuration, creates a log file in the current directory.
When Velocity is used in a web application the "current directory" is usually the current directory from which the application
server is started. If you start seeing the file "velocity.log" files in random places on your server filesystem, check
the Velocity log configuration. Typically this occurs when Velocity is used within a web application outside of web page
@@ -198,13 +198,13 @@
<section name="Tutorial" href="Tutorial">
<p>
-What follows is a brief tutorial on building a simple web app with VelocityViewServlet. For more information, consult the
+What follows is a brief tutorial on building a simple web app with VelocityViewServlet. For more information, consult the
<a href="http://jakarta.apache.org/velocity/tools/">Velocity Tools</a> documentation.
</p>
<ol>
<li>Download the Velocity Tools project source (you need the source for the examples)
-from <a href="http://jakarta.apache.org/site/downloads/downloads_velocity.cgi">download page</a>.
+from <a href="http://jakarta.apache.org/site/downloads/downloads_velocity.cgi">download page</a>.
</li>
<li>If you haven't already installed <a href="http://ant.apache.org/">Apache Ant</a>. do so now.
@@ -244,8 +244,8 @@
You can copy any additional velocity files
-into this same directory. In examples/WEB-INF you will see a file "toolbox.xml". This specifies a list of "Tools"
-that are automatically included in the context.
+into this same directory. In examples/WEB-INF you will see a file "toolbox.xml". This specifies a list of "Tools"
+that are automatically included in the context.
<source><![CDATA[
<toolbox>
@@ -316,7 +316,7 @@
</li>
<li>Experiment with adding new Velocity pages. Note that you can access any velocity page just by changing the URL. Try changing the
-entries in toolbox.xml or creating your own tools. Consult the <a href="http://jakarta.apache.org/velocity/tools/">Velocity Tools</a>
+entries in toolbox.xml or creating your own tools. Consult the <a href="http://jakarta.apache.org/velocity/tools/">Velocity Tools</a>
documentation and the <a href="http://wiki.apache.org/jakarta-velocity/">Wiki</a> for more info on the wide variety of tools available.
</li>
</ol>
---------------------------------------------------------------------
To unsubscribe, e-mail: velocity-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: velocity-dev-help@jakarta.apache.org