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 2005/11/04 17:42:23 UTC
svn commit: r330839 [3/5] - in /jakarta/velocity/core/trunk/xdocs: ./ docs/
stylesheets/ translations/
Modified: jakarta/velocity/core/trunk/xdocs/translations/user-guide_fi.xml
URL: http://svn.apache.org/viewcvs/jakarta/velocity/core/trunk/xdocs/translations/user-guide_fi.xml?rev=330839&r1=330838&r2=330839&view=diff
==============================================================================
--- jakarta/velocity/core/trunk/xdocs/translations/user-guide_fi.xml (original)
+++ jakarta/velocity/core/trunk/xdocs/translations/user-guide_fi.xml Fri Nov 4 08:41:57 2005
@@ -1,21 +1,21 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
+<?xml version="1.0" encoding="UTF-8"?>
<document>
<properties>
- <title>Velocity käyttäjän opas</title>
+ <title>Velocity käyttäjän opas</title>
<author email="jvanzyl@zenplex.com">Velocity Documentation Team</author>
<author email="jcastura@kw.igs.net">John Castura</author>
<author email="juha@dwebs.com">Juha Kilpi</author>
</properties>
<body>
-<section name="Sisällys" href="Sisällys">
+<section name="Sisällys" href="Sisällys">
<ol>
-<li><a href="#Tietojatästäoppaasta">Tietoja tästä oppaasta</a></li>
-<li><a href="#MikäonVelocity?">Mikä on Velocity?</a></li>
-<li><a href="#MitenvoinkäyttääVelocityä?">Miten voin käyttää Velocityä?</a>
+<li><a href="#Tietojatästäoppaasta">Tietoja tästä oppaasta</a></li>
+<li><a href="#MikäonVelocity?">Mikä on Velocity?</a></li>
+<li><a href="#MitenvoinkäyttääVelocityä?">Miten voin käyttää Velocityä?</a>
<ol>
<li><a href="#Kurakauppaesimerkki">Kurakauppa esimerkki</a></li>
</ol>
@@ -31,8 +31,8 @@
<li><a href="#Metodit">Metodit</a></li>
</ol>
</li>
-<li><a href="#Muodollinenmerkintä">Muodollinen viittausten merkintä</a></li>
-<li><a href="#Hiljainenviittaustenmerkintä">Hiljainen viittausten merkintä</a></li>
+<li><a href="#Muodollinenmerkintä">Muodollinen viittausten merkintä</a></li>
+<li><a href="#Hiljainenviittaustenmerkintä">Hiljainen viittausten merkintä</a></li>
<li><a href="#Kirjaimellisesti">Kirjaimellisesti</a>
<ol>
<li><a href="#Dollari">Dollari</a></li>
@@ -62,10 +62,10 @@
<li><a href="#Muitaominaisuuksiajasekalaista">Muita ominaisuuksia ja sekalaista</a>
<ol>
<li><a href="#Matematiikka">Matematiikka</a></li>
- <li><a href="#Vaihteluväli(RangeOperator)">Vaihteluväli (Range Operator)</a></li>
+ <li><a href="#Vaihteluväli(RangeOperator)">Vaihteluväli (Range Operator)</a></li>
<li><a href="#Edistyneetkysymykset:Suojaaminenja!">Edistyneet kysymykset: Suojaaminen ja !</a></li>
- <li><a href="#YleistäVelocimakroista">Yleistä Velocimakroista</a></li>
- <li><a href="#Merkkijonojenyhdistäminen">Merkkijonojen yhdistäminen</a></li>
+ <li><a href="#YleistäVelocimakroista">Yleistä Velocimakroista</a></li>
+ <li><a href="#Merkkijonojenyhdistäminen">Merkkijonojen yhdistäminen</a></li>
</ol>
</li>
<li><a href="#Palaute">Palaute</a></li>
@@ -73,98 +73,98 @@
</section>
-<section name="Tietoja tästä oppaasta" href="Tietojatästäoppaasta">
+<section name="Tietoja tästä oppaasta" href="Tietojatästäoppaasta">
<p>
- Velocity käyttäjän opas on tarkoitettu sivusuunnittelijoille ja
- sisällöntuottajille avuksi tutustuttaessa Velocityyn ja sen
+ Velocity käyttäjän opas on tarkoitettu sivusuunnittelijoille ja
+ sisällöntuottajille avuksi tutustuttaessa Velocityyn ja sen
yksinkertaiseen mutta tehokkaaseen skriptikieleen, Velocity
- Template Language:en (VTL). Useat tämän oppaan esimerkeistä
- käsittelevät Velocityn käyttämistä dynaamisen sisällön
- lisäämiseksi web sivuille, mutta kaikki VTL esimerkit toimivat
- HTML sivujen lisäksi yhtä hyvin myös muiden sivujen ja sivupohjien
+ Template Language:en (VTL). Useat tämän oppaan esimerkeistä
+ käsittelevät Velocityn käyttämistä dynaamisen sisällön
+ lisäämiseksi web sivuille, mutta kaikki VTL esimerkit toimivat
+ HTML sivujen lisäksi yhtä hyvin myös muiden sivujen ja sivupohjien
kanssa.
</p>
<p>
- Kiitos että valitsit Velocityn!
+ Kiitos että valitsit Velocityn!
</p>
</section>
-<section name="Mikä on Velocity?" href="MikäonVelocity?">
+<section name="Mikä on Velocity?" href="MikäonVelocity?">
<p>
Velocity on javapohjainen sivumoottori (template engine). Sen
avulla sivusuunnittelijat voivat viitata java -koodissa
- määriteltyihin metodeihin. Sivusuunnittelijat voivat työskennellä
- java ohjelmoijien kanssa samanaikaisesti käyttäen
- Malli-Näkymä-Ohjain (Model-View-Controller, MVC)
+ määriteltyihin metodeihin. Sivusuunnittelijat voivat työskennellä
+ java ohjelmoijien kanssa samanaikaisesti käyttäen
+ Malli-Näkymä-Ohjain (Model-View-Controller, MVC)
suunnittelumallia. MVC mallissa sivusuunnittelijat voivat
- keskittyä täysin luomaan hyvin suunniteltua sivustoa, ja
- ohjelmoijat voivat keskittyä koodaamaan ykkösluokan
+ keskittyä täysin luomaan hyvin suunniteltua sivustoa, ja
+ ohjelmoijat voivat keskittyä koodaamaan ykkösluokan
koodia. Velocity erottaa java -koodin web sivuista, tehden
- sivustosta pitkällä aikavälillä helpommin ylläpidettävän ja
+ sivustosta pitkällä aikavälillä helpommin ylläpidettävän ja
antamalla varteenotettavan vaihtoehdon <a
href="http://java.sun.com/products/jsp/">JSP</a>:lle (Java Server
Pages) ja <a href="http://www.php.net/">PHP</a>:lle.
</p>
<p>
- Velocityä voidaan käyttää web sivujen, SQL:n, PostScriptin ja
- muunlaisten tulosteiden tuottamiseen sivupohjista (template). Sitä
- voidaan käyttää joko itsenäisenä työkaluna lähdekoodin ja
- raporttien luomiseen, tai muihin järjestelmiin integroituna
+ Velocityä voidaan käyttää web sivujen, SQL:n, PostScriptin ja
+ muunlaisten tulosteiden tuottamiseen sivupohjista (template). Sitä
+ voidaan käyttää joko itsenäisenä työkaluna lähdekoodin ja
+ raporttien luomiseen, tai muihin järjestelmiin integroituna
komponenttina. Velocity tarjoaa sivupohjaratkaisun <a
href="http://java.apache.org/turbine/">Turbine</a> web
- sovelluskehykselle. Yhdessä Velocity ja Turbine tarjoavat
- sivupohjaratkaisun jonka avulla web sovelluksia voidaan kehittää
+ sovelluskehykselle. Yhdessä Velocity ja Turbine tarjoavat
+ sivupohjaratkaisun jonka avulla web sovelluksia voidaan kehittää
todellisen MVC -mallin mukaisesti.
</p>
</section>
-<section name="Miten voin käyttää Velocityä?" href="MitenvoinkäyttääVelocityä?">
+<section name="Miten voin käyttää Velocityä?" href="MitenvoinkäyttääVelocityä?">
<subsection name="Kurakauppa esimerkki" href="Kurakauppaesimerkki">
<p>
- Oletetaan että olet kuraa myyvän onlinekaupan
+ Oletetaan että olet kuraa myyvän onlinekaupan
sivusuunnittelija. Kutsumme kauppaa "Kurakauppa
- Online":ksi. Kauppa käy hyvin. Asiakkaat tilaavat vaihtelevia
- määriä eri kuratyyppejä. He pääsevät tutkimaan tekemiään tilauksia
- sekä tekemään uusia ostoja kirjautumalla sivullesi käyttäen
- käyttäjätunnustaan ja salasanaansa. Tällä hetkellä suosittu
- Terracotta -kura on alennusmyynnissä. Pieni osa asiakkaistasi
- ostaa säännöllisesti Kirkkaanpunaista Kuraa, joka myös on
- alennusmyynnissä, mutta pienemmän suosionsa vuoksi yleensä
- mainittu sivulla hieman syrjässä. Tiedot kustakin asiakkaasta
- talletetaan tietokantaan, joten eräänä päivänä herää kysymys;
- Miksipä emme käyttäisi Velocityä kohdentamaan erikoistarjouksia
+ Online":ksi. Kauppa käy hyvin. Asiakkaat tilaavat vaihtelevia
+ määriä eri kuratyyppejä. He pääsevät tutkimaan tekemiään tilauksia
+ sekä tekemään uusia ostoja kirjautumalla sivullesi käyttäen
+ käyttäjätunnustaan ja salasanaansa. Tällä hetkellä suosittu
+ Terracotta -kura on alennusmyynnissä. Pieni osa asiakkaistasi
+ ostaa säännöllisesti Kirkkaanpunaista Kuraa, joka myös on
+ alennusmyynnissä, mutta pienemmän suosionsa vuoksi yleensä
+ mainittu sivulla hieman syrjässä. Tiedot kustakin asiakkaasta
+ talletetaan tietokantaan, joten eräänä päivänä herää kysymys;
+ Miksipä emme käyttäisi Velocityä kohdentamaan erikoistarjouksia
kurasta asiakkaille jotka ovat kiinnostuneita juuri tuosta
- kuratyypistä?
+ kuratyypistä?
</p>
<p>
- Velocityn avulla verkkosivut on helppo personoida kävijöidesi
- mukaan. Kurakauppa Onlinen sivusuunnittelijana haluat tehdä sivun
- jonka asiakas näkee kirjauduttuaan järjestelmään.
+ Velocityn avulla verkkosivut on helppo personoida kävijöidesi
+ mukaan. Kurakauppa Onlinen sivusuunnittelijana haluat tehdä sivun
+ jonka asiakas näkee kirjauduttuaan järjestelmään.
</p>
<p>
- Tapaat yrityksesi ohjelmoijat ja sovitte, että muuttuja
- <em>$asiakas</em> pitää sisällään tiedot parhaillaan kirjautuneena
+ Tapaat yrityksesi ohjelmoijat ja sovitte, että muuttuja
+ <em>$asiakas</em> pitää sisällään tiedot parhaillaan kirjautuneena
olevasta asiakkaasta. Muuttujassa <em>$kuratTarjouksessa</em> ovat
- tiedot kuratyypeistä jotka ovat parhaillaan
+ tiedot kuratyypeistä jotka ovat parhaillaan
erikoistarjouksessa. <em>$tarjous</em> objektissa on metodeja
- jotka auttavat mainostamisessa. Tällä kertaa keskitymme vain
- näihin kolmeen viittaukseen. Muista, että sinun ei tarvitse
- huolehtia siitä kuinka ohjelmoijat hakevat tarvittavat tiedot
- tietokannasta, sinun tarvitsee tietää vain että se toimii. Näin
- pääset tekemään omaa työtäsi ja ohjelmoijat pääsevät tekemään
+ jotka auttavat mainostamisessa. Tällä kertaa keskitymme vain
+ näihin kolmeen viittaukseen. Muista, että sinun ei tarvitse
+ huolehtia siitä kuinka ohjelmoijat hakevat tarvittavat tiedot
+ tietokannasta, sinun tarvitsee tietää vain että se toimii. Näin
+ pääset tekemään omaa työtäsi ja ohjelmoijat pääsevät tekemään
omaansa.
</p>
<p>
- Voisit lisätä seuraavat VTL lauseen sivulle:
+ Voisit lisätä seuraavat VTL lauseen sivulle:
</p>
<source><![CDATA[
@@ -186,22 +186,22 @@
<p>
<em>foreach</em> lauseen toiminta kuvataan yksityiskohtaisemmin
- jäljempänä; tärkeää tässä on tämän lyhyen skriptin tekemä vaikutus
- sivullesi. Kun Kirkkaanpunainen Kura on alennusmyynnissä ja sitä
- joskus aiemmin ostanut asiakas kirjautuu sisään, asiakas näkee
+ jäljempänä; tärkeää tässä on tämän lyhyen skriptin tekemä vaikutus
+ sivullesi. Kun Kirkkaanpunainen Kura on alennusmyynnissä ja sitä
+ joskus aiemmin ostanut asiakas kirjautuu sisään, asiakas näkee
ilmoituksen alennuksesta parhaalla mahdollisella paikalla. Jos
- toinen, Terracottakuraa ostanut asiakas kirjautuu järjestelmään,
- ilmoitus Terracottakuran alennusmyynnistä näkyy hänelle
- ensimmäisenä. Velocity on joustava ja sen käytössä vain
+ toinen, Terracottakuraa ostanut asiakas kirjautuu järjestelmään,
+ ilmoitus Terracottakuran alennusmyynnistä näkyy hänelle
+ ensimmäisenä. Velocity on joustava ja sen käytössä vain
mielikuvituksesi on rajana.
</p>
<p>
VTL hakemistossa on kuvattu Velocityn kaikki elementit jotka
- yhdessä antavat käyttöösi tehokkaan ja joustavan työkalun jota
- tarvitset luodaksesi web sivuistasi dynaamisen. Pääset
- hyödyntämään Velocityn voimaa jatkuvasti paremmin sitä mukaa kun
- opit käyttämään näitä elementtejä.
+ yhdessä antavat käyttöösi tehokkaan ja joustavan työkalun jota
+ tarvitset luodaksesi web sivuistasi dynaamisen. Pääset
+ hyödyntämään Velocityn voimaa jatkuvasti paremmin sitä mukaa kun
+ opit käyttämään näitä elementtejä.
</p>
</subsection>
@@ -212,19 +212,19 @@
<p>
Velocityn sivunkuvauskieli (Velocity Template Language, VTL)
- tarjoaa helpon ja yksinkertaisen keinon liittää dynaamista
- sisältöä web sivulle. Dynaamisen sisällön käyttäminen pitäisi
+ tarjoaa helpon ja yksinkertaisen keinon liittää dynaamista
+ sisältöä web sivulle. Dynaamisen sisällön käyttäminen pitäisi
onnistua nopeasti jopa sellaiselta sivusuunnittelijalta jolla on
- ohjelmointikokemusta vain vähän, tai ei ollenkaan.
+ ohjelmointikokemusta vain vähän, tai ei ollenkaan.
</p>
<p>
- VTL käyttää <em>viittauksia</em> dynaamisen aineiston lisäämiseen
- verkkosivulle. Muuttujat ovat yhdentyyppisiä
+ VTL käyttää <em>viittauksia</em> dynaamisen aineiston lisäämiseen
+ verkkosivulle. Muuttujat ovat yhdentyyppisiä
viittauksia. Muuttujat voivat viitata johonkin java -koodissa
- määriteltyyn, tai niiden arvo voidaan määrittää web -sivulla
+ määriteltyyn, tai niiden arvo voidaan määrittää web -sivulla
annetun VTL <em>lauseen</em> avulla. Seuraavassa on esimerkki VTL
- lauseesta joka voidaan lisätä HTML -dokumenttiin:
+ lauseesta joka voidaan lisätä HTML -dokumenttiin:
</p>
<source><![CDATA[
@@ -232,42 +232,42 @@
]]></source>
<p>
- Kuten kaikki VTL lauseet (statement), tämäkin lause alkaa <em>#</em>
- merkillä ja sisältää ohjeen (directive): <em>set</em>. Kun verkkosivun
- käyttäjä hakee sivun Velocity etsii sivupohjastasi kaikki
- <em>#</em> -merkit. Sitten se tulkitsee mitkä niistä merkitsevät
- VTL lausetta, ja mitkä <em>#</em> merkeistä ovat osa sivujesi
- normaalia HTML -koodia, eivätkä kuulu VTL -koodiin.
+ Kuten kaikki VTL lauseet (statement), tämäkin lause alkaa <em>#</em>
+ merkillä ja sisältää ohjeen (directive): <em>set</em>. Kun verkkosivun
+ käyttäjä hakee sivun Velocity etsii sivupohjastasi kaikki
+ <em>#</em> -merkit. Sitten se tulkitsee mitkä niistä merkitsevät
+ VTL lausetta, ja mitkä <em>#</em> merkeistä ovat osa sivujesi
+ normaalia HTML -koodia, eivätkä kuulu VTL -koodiin.
</p>
<p>
- <em>#</em> merkkiä seuraa ohje, <em>set</em>. <em>set</em> ohjeen
- jälkeen tulee suluissa ilmaus (expression), -- yhtälö joka määrittää
+ <em>#</em> merkkiä seuraa ohje, <em>set</em>. <em>set</em> ohjeen
+ jälkeen tulee suluissa ilmaus (expression), -- yhtälö joka määrittää
<em>arvon</em> <em>muuttujalle</em>. Muuttuja on ilmaistu
- vasemmalla ja arvo oikealla puolella. Nämä on erotettu <em>=</em>
- merkillä.
+ vasemmalla ja arvo oikealla puolella. Nämä on erotettu <em>=</em>
+ merkillä.
</p>
<p>
- Yllä olevassa esimerkissä muuttuja on <em>$a</em> ja arvo on
- <em>Velocity</em>. Kaikkien viittausten tapaan tämäkin muuttuja
- alkaa <em>$</em> merkillä. Arvot ovat aina lainausmerkkien
- sisällä; Velocityssä muuttujien datatyypeistä ei tule
+ Yllä olevassa esimerkissä muuttuja on <em>$a</em> ja arvo on
+ <em>Velocity</em>. Kaikkien viittausten tapaan tämäkin muuttuja
+ alkaa <em>$</em> merkillä. Arvot ovat aina lainausmerkkien
+ sisällä; Velocityssä muuttujien datatyypeistä ei tule
sekaannuksia, koska vain merkkijonoja (string) voi antaa
muuttujien arvoksi.
</p>
<p>
- Seuraava nyrkkisääntö voi auttaa ymmärtämään Velocityn toimintaa:
- <strong>Viittaukset alkavat <em>$</em> merkillä ja niitä käytetään
- jonkin hakemiseen. Ohjeet alkavat <em>#</em> merkillä ja niitä
- käytetään jonkin suorittamiseen.</strong>
+ Seuraava nyrkkisääntö voi auttaa ymmärtämään Velocityn toimintaa:
+ <strong>Viittaukset alkavat <em>$</em> merkillä ja niitä käytetään
+ jonkin hakemiseen. Ohjeet alkavat <em>#</em> merkillä ja niitä
+ käytetään jonkin suorittamiseen.</strong>
</p>
<p>
- Yllä olevassa esimerkissä <em>#set</em> -ohjetta käytetään arvon
- määrittämiseksi muuttujaan. Muuttujaa <em>$a</em> voidaan tämän
- jälkeen käyttää sivupohjassa tulostamaan "Velocity".
+ Yllä olevassa esimerkissä <em>#set</em> -ohjetta käytetään arvon
+ määrittämiseksi muuttujaan. Muuttujaa <em>$a</em> voidaan tämän
+ jälkeen käyttää sivupohjassa tulostamaan "Velocity".
</p>
</section>
@@ -275,9 +275,9 @@
<section name="Hei Velocity Maailma!" href="HeiVelocityMaailma!">
<p>
- Kun muuttujalle on määritelty arvo, voidaan siihen viitata missä
- tahansa paikassa HTML dokumenttia. Seuraavassa esimerkissä
- muuttujalle <em>$foo</em> määritellään arvo. Myöhemmin muuttujaan
+ Kun muuttujalle on määritelty arvo, voidaan siihen viitata missä
+ tahansa paikassa HTML dokumenttia. Seuraavassa esimerkissä
+ muuttujalle <em>$foo</em> määritellään arvo. Myöhemmin muuttujaan
viitataan.
</p>
@@ -296,8 +296,8 @@
<p>
Jotta VTL lauseet olisivat helpommin luettavissa on suositeltavaa
- aloittaa jokainen lause uudelta riviltä, vaikkakaan tämä ei ole
- pakollista. <em>set</em> ohjeeseen palaamme tarkemmin myöhemmin.
+ aloittaa jokainen lause uudelta riviltä, vaikkakaan tämä ei ole
+ pakollista. <em>set</em> ohjeeseen palaamme tarkemmin myöhemmin.
</p>
</section>
@@ -305,66 +305,66 @@
<section name="Kommentit" href="Kommentit">
<p>
- Kommenttien avulla sivulle voidaan lisätä aputekstejä jotka eivät
- tule näkymään sivun tulosteessa. Voit käyttää kommentteja
- muistuttaaksesi itseäsi jostakin tai selittääksesi muille mitä VTL
- komennot tekevät, tai mihin tahansa muuhun tarkoitukseen. Alla on
- esimerkki kommentin käytöstä.
+ Kommenttien avulla sivulle voidaan lisätä aputekstejä jotka eivät
+ tule näkymään sivun tulosteessa. Voit käyttää kommentteja
+ muistuttaaksesi itseäsi jostakin tai selittääksesi muille mitä VTL
+ komennot tekevät, tai mihin tahansa muuhun tarkoitukseen. Alla on
+ esimerkki kommentin käytöstä.
</p>
<source><![CDATA[
-## Tämä on rivin pituinen kommentti.
+## Tämä on rivin pituinen kommentti.
]]></source>
<p>
- Yhden rivin pituinen kommentti alkaa <em>##</em> merkeillä ja
+ Yhden rivin pituinen kommentti alkaa <em>##</em> merkeillä ja
loppuu kyseisen rivin lopussa. Jos aiot kirjoittaa usean rivin
mittaisen kommentin, ei sinun tarvitse kirjoittaa useita yhden
rivin kommentteja. Usean rivin kommentit alkavat <em>#*</em>
- merkeillä ja loppuvat <em>*#</em> merkkeihin.
+ merkeillä ja loppuvat <em>*#</em> merkkeihin.
</p>
<source><![CDATA[
-Tämä teksti on kommenttimerkkien ulkopuolella.
-Käyttäjät näkevät tämän tekstin.
+Tämä teksti on kommenttimerkkien ulkopuolella.
+Käyttäjät näkevät tämän tekstin.
#*
- Monirivinen kommentti alkaa tästä. Käyttäjät eivät näe tätä tekstiä
- koska Velocityn sivumoottori ei näytä kommenttimerkkien sisällä
- olevaa tekstiä tulosteessaan.
+ Monirivinen kommentti alkaa tästä. Käyttäjät eivät näe tätä tekstiä
+ koska Velocityn sivumoottori ei näytä kommenttimerkkien sisällä
+ olevaa tekstiä tulosteessaan.
*#
-Tämä teksti on jälleen kommenttimerkkien ulkopuolella; se on
-näkyvissä.
+Tämä teksti on jälleen kommenttimerkkien ulkopuolella; se on
+näkyvissä.
]]></source>
<p>
- Tässä on muutamia esimerkkejä yksi- ja monirivisten kommenttien
- toiminnan selvittämiseksi:
+ Tässä on muutamia esimerkkejä yksi- ja monirivisten kommenttien
+ toiminnan selvittämiseksi:
</p>
<source><![CDATA[
-Tämä teksti on näkyvissä. ## Tämä teksti ei ole.
-Tämä teksti on näkyvissä.
-Tämä teksti on näkyvissä. #* Tämä teksti on osa monirivistä kommenttia
-eikä siksi ole näkyvissä. Tämä teksti ei edelleenkään ole näkyvissä
-koska se on kommenttimerkkien sisällä. *# Tämä teksti on
-kommenttimerkkien ulkopuolella, joten se on näkyvissä.
-## Tämä teksti ei ole näkyvissä.
+Tämä teksti on näkyvissä. ## Tämä teksti ei ole.
+Tämä teksti on näkyvissä.
+Tämä teksti on näkyvissä. #* Tämä teksti on osa monirivistä kommenttia
+eikä siksi ole näkyvissä. Tämä teksti ei edelleenkään ole näkyvissä
+koska se on kommenttimerkkien sisällä. *# Tämä teksti on
+kommenttimerkkien ulkopuolella, joten se on näkyvissä.
+## Tämä teksti ei ole näkyvissä.
]]></source>
<p>
- On olemassa vielä kolmaskin kommenttityyppi; VTL kommenttilohko,
- jota voidaan käyttää mm. dokumentin tekijä- ja versiotietojen
+ On olemassa vielä kolmaskin kommenttityyppi; VTL kommenttilohko,
+ jota voidaan käyttää mm. dokumentin tekijä- ja versiotietojen
tallettamiseen
</p>
<source><![CDATA[
#**
-Tämä on VTL kommenttilohko. Lohkoa
-voidaan käyttää esimerkiksi dokumentin
-tekijä- ja versiotietojen
+Tämä on VTL kommenttilohko. Lohkoa
+voidaan käyttää esimerkiksi dokumentin
+tekijä- ja versiotietojen
tallettamiseen:
@author
@version 5
@@ -376,15 +376,15 @@
<section name="Viittaukset" href="Viittaukset">
<p>
- VTL:ssä on kolme erityyppistä viittausta: muuttujat, ominaisuudet
- ja metodit. VTL:ää käyttävänä sivusuunnittelijana sinun, ja
+ VTL:ssä on kolme erityyppistä viittausta: muuttujat, ominaisuudet
+ ja metodit. VTL:ää käyttävänä sivusuunnittelijana sinun, ja
javapuolta koodaavien ohjelmoijien on sovittava viittausten
- nimistä, jotta voit käyttää niitä sivupohjissasi.
+ nimistä, jotta voit käyttää niitä sivupohjissasi.
</p>
<p>
- Kaikkea viittauksissa olevaa ja niihin määriteltävää tietoa
- käsitellään tekstityyppisenä. Jos on esimerkiksi määritelty
+ Kaikkea viittauksissa olevaa ja niihin määriteltävää tietoa
+ käsitellään tekstityyppisenä. Jos on esimerkiksi määritelty
objekti <em>$foo</em> (Integer objekti), Velocity kutsuu objektin
<code>.toString()</code> metodia objektin arvon muuntamiseksi
tekstityyppiseksi.
@@ -394,9 +394,9 @@
<a name="Muuttujat"><strong>Muuttujat</strong></a>
<br/>
- Muuttujan lyhyt merkintätapa koostuu ensimmäisenä olevasta "$"
- merkistä, jonka jälkeen tulee VTL <em>tunniste</em>. VTL
- tunnisteen on alettava aakkosnumeerisella merkillä (a..z tai
+ Muuttujan lyhyt merkintätapa koostuu ensimmäisenä olevasta "$"
+ merkistä, jonka jälkeen tulee VTL <em>tunniste</em>. VTL
+ tunnisteen on alettava aakkosnumeerisella merkillä (a..z tai
A..Z). Muuttujan loput merkit ovat rajoitettu seuraaviin:
</p>
@@ -411,7 +411,7 @@
</p>
<p>
- Seuraavassa muutamia esimerkkejä toimivista muuttujaviittauksista:
+ Seuraavassa muutamia esimerkkejä toimivista muuttujaviittauksista:
</p>
<source><![CDATA[
@@ -428,7 +428,7 @@
tai java -koodista. Jos esimerkiksi javamuuttujalla <em>$foo</em>
on arvo <em>bar</em> silloin kun sivupohjaa haetaan, <em>bar</em>
korvaa kaikki <em>$foo</em> muuttujan esiintymiskohdat web
- sivulla. Toisaalta jos sivulle lisätään lause
+ sivulla. Toisaalta jos sivulle lisätään lause
</p>
<source><![CDATA[
@@ -437,7 +437,7 @@
<p>
Sivun tuloste on sama kaikilla <em>$foo</em> muuttujan
- esiintymiskohdille jotka tulevat tämän lauseen jälkeen.
+ esiintymiskohdille jotka tulevat tämän lauseen jälkeen.
</p>
<p>
@@ -445,10 +445,10 @@
<br/>
Toinen VTL:n viittaustyyppi ovat ominaisuudet joilla on oma
- tunnusomainen muotonsa. Lyhyt merkintätapa muodostuu ensimmäisenä
- olevasta <em>$</em> merkistä, jonka jälkeen tulee VTL tunniste,
+ tunnusomainen muotonsa. Lyhyt merkintätapa muodostuu ensimmäisenä
+ olevasta <em>$</em> merkistä, jonka jälkeen tulee VTL tunniste,
jota seuraa piste (".") ja toinen VTL tunniste. Seuraavassa on
- esimerkkejä toimivista ominaisuusviittauksista:
+ esimerkkejä toimivista ominaisuusviittauksista:
</p>
<source><![CDATA[
@@ -457,15 +457,15 @@
]]></source>
<p>
- Käsittelemme ensimmäisen esimerkin <em>$asiakas.Osoite</em>
- tarkemmin. Viittauksella voi olla kaksi merkitystä. Se saattaa
- tarkoittaa; hae <em>asiakas</em> nimisestä hashtable taulukosta
+ Käsittelemme ensimmäisen esimerkin <em>$asiakas.Osoite</em>
+ tarkemmin. Viittauksella voi olla kaksi merkitystä. Se saattaa
+ tarkoittaa; hae <em>asiakas</em> nimisestä hashtable taulukosta
arvo joka on liitetty avaimelle <em>Osoite</em>. Toisaalta
- <em>$asiakas.Osoite</em> voi myös viitata metodiin (käsittelemme
+ <em>$asiakas.Osoite</em> voi myös viitata metodiin (käsittelemme
metodeihin viittaavat viittaukset seuraavassa kappaleessa);
<em>$asiakas.Osoite</em> saattaa olla lyhennetty muoto
viittauksesta <em>$asiakas.getOsoite()</em>. Velocity tulkitsee
- sivua haettaessa kumpaa näistä vaihtoehdoista tarkoitetaan, ja
+ sivua haettaessa kumpaa näistä vaihtoehdoista tarkoitetaan, ja
palauttaa vastaavan arvon.
</p>
@@ -473,14 +473,14 @@
<a name="Metodit"><strong>Metodit</strong></a>
<br/>
- Metodit ovat määritelty java -koodissa ja niiden avulla voidaan
+ Metodit ovat määritelty java -koodissa ja niiden avulla voidaan
suorittaa jokin toimenpide; esimerkiksi laskutoimitus tai jonkin
- päätöksen tekeminen. Metodit ovat viittauksia jotka muodostuvat
- aloittavasta "$" merkistä, jota seuraa VTL tunniste, jonka jälkeen
+ päätöksen tekeminen. Metodit ovat viittauksia jotka muodostuvat
+ aloittavasta "$" merkistä, jota seuraa VTL tunniste, jonka jälkeen
tulee VTL <em>Metodirunko</em>. VTL Metodirunko koostuu VTL
tunnisteesta jota seuraa vasen sulkumerkki "(", jota seuraa
valinnainen parametrilista, jota seuraa oikeanpuoleinen
- sulkumerkki ")". Seuraavassa on esimerkkejä toimivista
+ sulkumerkki ")". Seuraavassa on esimerkkejä toimivista
metodiviittauksista:
</p>
@@ -492,29 +492,29 @@
]]></source>
<p>
- Metodirungossa esiintyvä get tarkoittaa "hae" ja set "aseta".
+ Metodirungossa esiintyvä get tarkoittaa "hae" ja set "aseta".
</p>
<p>
- Kaksi ensimmäistä esimerkkiä -- <em>$asiakas.getOsoite()</em> ja
- <em>$ostos.getSumma()</em> -- näyttävät samanlaisilta kuin
+ Kaksi ensimmäistä esimerkkiä -- <em>$asiakas.getOsoite()</em> ja
+ <em>$ostos.getSumma()</em> -- näyttävät samanlaisilta kuin
Ominaisuudet -osiossa aiemmin; <em>$asiakas.Osoite</em> ja
- <em>$ostos.Summa</em>. Jos arvasit että näillä esimerkeillä on
- jotakin yhteyttä toisiinsa, olit oikeassa!
+ <em>$ostos.Summa</em>. Jos arvasit että näillä esimerkeillä on
+ jotakin yhteyttä toisiinsa, olit oikeassa!
</p>
<p>
- VTL ominaisuuksia voidaan käyttää lyhyempinä muotoina VTL
- metodeista. Ominaisuudella <em>$asiakas.Osoite</em> on täysin sama
- vaikutus kuin käyttämällä metodia
+ VTL ominaisuuksia voidaan käyttää lyhyempinä muotoina VTL
+ metodeista. Ominaisuudella <em>$asiakas.Osoite</em> on täysin sama
+ vaikutus kuin käyttämällä metodia
<em>$asikas.getOsoite()</em>. Yleisesti ottaen ominaisuuksien
- käyttö on suositeltavaa silloin kuin se vain on
- mahdollista. Suurin ero ominaisuuksien ja metodien välillä on se,
- että metodeille voi antaa parametreja.
+ käyttö on suositeltavaa silloin kuin se vain on
+ mahdollista. Suurin ero ominaisuuksien ja metodien välillä on se,
+ että metodeille voi antaa parametreja.
</p>
<p>
- Seuraavien metodien kanssa voidaan käyttää lyhyttä muotoa:
+ Seuraavien metodien kanssa voidaan käyttää lyhyttä muotoa:
</p>
<source><![CDATA[
@@ -524,29 +524,29 @@
]]></source>
<p>
- Näiden metodien voisimme olettaa palauttavan auringolle kuuluvien
- planeettojen nimet, syöttävän matomme, tai hakevan valokuvan
- albumista. Seuraavissa metodeissa toimii vain pitkä muoto:
+ Näiden metodien voisimme olettaa palauttavan auringolle kuuluvien
+ planeettojen nimet, syöttävän matomme, tai hakevan valokuvan
+ albumista. Seuraavissa metodeissa toimii vain pitkä muoto:
</p>
<source><![CDATA[
$aurinko.getPlaneetat( ["Maa", "Mars", "Neptunus"] )
-## lyhyessä muodossa $sun.Planets ei voida antaa parametreja
+## lyhyessä muodossa $sun.Planets ei voida antaa parametreja
$sisyphus.pushRock()
-## Velocity olettaa että tarkoitan $sisyphus.getRock()
+## Velocity olettaa että tarkoitan $sisyphus.getRock()
$kirja.setOtsake( "Catalonian kotisivu" )
## Parametrilistaa ei voida antaa
]]></source>
<p>
- <a name="Muodollinen viittausten merkintä"><strong>Muodollinen viittausten merkintä</strong></a>
+ <a name="Muodollinen viittausten merkintä"><strong>Muodollinen viittausten merkintä</strong></a>
<br/>
- Edellisissä esimerkeissä käytettiin viittauksille lyhyttä
- merkintätapaa. Viittauksille on olemassa myös muodollinen
- merkintätapa, jota käytetään seuraavissa esimerkeissä:
+ Edellisissä esimerkeissä käytettiin viittauksille lyhyttä
+ merkintätapaa. Viittauksille on olemassa myös muodollinen
+ merkintätapa, jota käytetään seuraavissa esimerkeissä:
</p>
<source><![CDATA[
@@ -556,19 +556,19 @@
]]></source>
<p>
- Voit käyttää lyhyttä muotoa viittauksiin lähes aina, mutta
- joissain tapauksissa muodollista viittausta tarvitaan virheettömän
+ Voit käyttää lyhyttä muotoa viittauksiin lähes aina, mutta
+ joissain tapauksissa muodollista viittausta tarvitaan virheettömän
toiminnan turvaamiseksi.
</p>
<p>
- Oletetaan että olet luomassa lausetta jonka sisältö riippuu
- muuttujasta. Muuttujaa <em>$pahe</em> käytetään pohjana luotaessa
- muuttujasta riippuvaista sanaa. Tarkoituksena on sallia käyttäjän
+ Oletetaan että olet luomassa lausetta jonka sisältö riippuu
+ muuttujasta. Muuttujaa <em>$pahe</em> käytetään pohjana luotaessa
+ muuttujasta riippuvaista sanaa. Tarkoituksena on sallia käyttäjän
valita pohjasana ja tuottaa toinen seuraavista tuloksista: "Juha
- on pyromaani." tai "Juha on kleptomaani.". Tässä tapauksessa
- lyhyen viittausmuodon käyttäminen ei toimisi. Tutki seuraavaa
- esimerkkiä:
+ on pyromaani." tai "Juha on kleptomaani.". Tässä tapauksessa
+ lyhyen viittausmuodon käyttäminen ei toimisi. Tutki seuraavaa
+ esimerkkiä:
</p>
<source><![CDATA[
@@ -576,10 +576,10 @@
]]></source>
<p>
- Velocity olettaa että tarkoitat muuttujaa <em>$pahemaani</em>,
- vaikka käytettävä muuttuja oli <em>$pahe</em>. Koska Velocity ei
- löydä arvoa muuttujalle <em>$pahemaani</em>, se palauttaa
- <em>$pahemaani</em>. Tämä ongelma voidaan ratkaista käyttämällä
+ Velocity olettaa että tarkoitat muuttujaa <em>$pahemaani</em>,
+ vaikka käytettävä muuttuja oli <em>$pahe</em>. Koska Velocity ei
+ löydä arvoa muuttujalle <em>$pahemaani</em>, se palauttaa
+ <em>$pahemaani</em>. Tämä ongelma voidaan ratkaista käyttämällä
muodollista viittausta.
</p>
@@ -588,18 +588,18 @@
]]></source>
<p>
- Nyt Velocity ymmärtää että haluttu viittaus on <em>$pahe</em>, ei
- <em>$pahemaani</em>. Muodollinen viittausten merkintä on usein
- hyödyllinen silloin kun viittaukset ovat kiinni muussa tekstissä.
+ Nyt Velocity ymmärtää että haluttu viittaus on <em>$pahe</em>, ei
+ <em>$pahemaani</em>. Muodollinen viittausten merkintä on usein
+ hyödyllinen silloin kun viittaukset ovat kiinni muussa tekstissä.
</p>
<p>
- <a name="Hiljainen viittausten merkintä"><strong>Hiljainen viittausten merkintä</strong></a>
+ <a name="Hiljainen viittausten merkintä"><strong>Hiljainen viittausten merkintä</strong></a>
<br/>
- Kun Velocityltä haetaan viittaus jolle ei ole määritelty arvoa,
- palauttaa se normaalisti viittauksen tekstinä. Oletetaan
- esimerkiksi että seuraavat viittaukset ovat osa VTL sivupohjaa:
+ Kun Velocityltä haetaan viittaus jolle ei ole määritelty arvoa,
+ palauttaa se normaalisti viittauksen tekstinä. Oletetaan
+ esimerkiksi että seuraavat viittaukset ovat osa VTL sivupohjaa:
</p>
<source><![CDATA[
@@ -607,13 +607,13 @@
]]></source>
<p>
- Kun lomake latautuu ensimmäisen kerran muuttujaviittauksella
- <em>$email</em> ei ole arvoa. Oletuksena Velocity täyttää
- lomakkeen tekstillä "$email". Haluaisit kuitenkin kenttään
- mieluummin tyhjän arvon. Käyttämällä hiljaista viittausten
- merkintää voidaan Velocityn normaali toiminta estää;
- <em>$email</em> koodin sijaan käytät viittausta
- <em>$!email</em>. Yllä oleva koodi näyttäisi siis seuraavalta:
+ Kun lomake latautuu ensimmäisen kerran muuttujaviittauksella
+ <em>$email</em> ei ole arvoa. Oletuksena Velocity täyttää
+ lomakkeen tekstillä "$email". Haluaisit kuitenkin kenttään
+ mieluummin tyhjän arvon. Käyttämällä hiljaista viittausten
+ merkintää voidaan Velocityn normaali toiminta estää;
+ <em>$email</em> koodin sijaan käytät viittausta
+ <em>$!email</em>. Yllä oleva koodi näyttäisi siis seuraavalta:
</p>
<source><![CDATA[
@@ -621,14 +621,14 @@
]]></source>
<p>
- Kun lomake latautuu ensimmäisen kerran eikä muuttujalla
- <em>$email</em> ole arvoa, tulostetaankin kenttään tyhjä teksti
+ Kun lomake latautuu ensimmäisen kerran eikä muuttujalla
+ <em>$email</em> ole arvoa, tulostetaankin kenttään tyhjä teksti
"$email" tekstin sijaan.
</p>
<p>
- Muodollista ja hiljaista muuttujien merkintää voidaan käyttää myös
- yhdessä;
+ Muodollista ja hiljaista muuttujien merkintää voidaan käyttää myös
+ yhdessä;
</p>
<source><![CDATA[
@@ -640,9 +640,9 @@
<section name="Kirjaimellisesti" href="Kirjaimellisesti">
<p>
- VTL käyttää erikoismerkkejä kuten <em>$</em> ja <em>#</em> omassa
- toiminnassaan, joten näiden merkkien käyttö sivupohjassa vaatii
- erityistä huolellisuutta. Tässä kappaleessa käsittelemme
+ VTL käyttää erikoismerkkejä kuten <em>$</em> ja <em>#</em> omassa
+ toiminnassaan, joten näiden merkkien käyttö sivupohjassa vaatii
+ erityistä huolellisuutta. Tässä kappaleessa käsittelemme
<em>$</em> merkin suojaamisen (escape).
</p>
@@ -650,9 +650,9 @@
<a name="Dollari"><strong>Dollari</strong></a>
<br/>
- Seuraavassa lauseessa dollarimerkin käytössä ei ole ongelmaa:
- "Ostin markkinoilta säkin perunoita hintaan $2.50!". Kuten
- mainittu, VTL tunniste alkaa aina aakkosmerkillä, joten merkintää
+ Seuraavassa lauseessa dollarimerkin käytössä ei ole ongelmaa:
+ "Ostin markkinoilta säkin perunoita hintaan $2.50!". Kuten
+ mainittu, VTL tunniste alkaa aina aakkosmerkillä, joten merkintää
$2.50 ei ole vaaraa sekoittaa viittaukseksi.
</p>
@@ -660,10 +660,10 @@
<a name="VTLviittaustensuojaaminen"><strong>VTL viittausten suojaaminen</strong></a>
<br/>
- Ongelmatilanne saattaa syntyä silloin, kun Velocity ei osaa
- päätellä tarkoitetaanko dollarinmerkillä merkkiä itseään, vai
+ Ongelmatilanne saattaa syntyä silloin, kun Velocity ei osaa
+ päätellä tarkoitetaanko dollarinmerkillä merkkiä itseään, vai
viittausta. Erikoismerkkien <em>suojaaminen</em> on paras keino
- käsitellä VTL erikoismerkkejä sivupohjissa. Suojaamiseen käytetään
+ käsitellä VTL erikoismerkkejä sivupohjissa. Suojaamiseen käytetään
kenoviivaa ( <em>\</em> ).
</p>
@@ -673,22 +673,22 @@
]]></source>
<p>
- Kun Velocity käsittelee <em>$email</em> viittauksen
- sivupohjassasi, se etsii löytyykö sen nimiselle muuttujalle
- arvoa. Tässä tapauksessa tuloste tulee olemaan <em>foo</em>, koska
- <em>$email</em> on määritelty. Jos <em>$email</em> muuttujaa ei
- olisi määritelty tulisi tulosteeksi <em>$email</em>.
+ Kun Velocity käsittelee <em>$email</em> viittauksen
+ sivupohjassasi, se etsii löytyykö sen nimiselle muuttujalle
+ arvoa. Tässä tapauksessa tuloste tulee olemaan <em>foo</em>, koska
+ <em>$email</em> on määritelty. Jos <em>$email</em> muuttujaa ei
+ olisi määritelty tulisi tulosteeksi <em>$email</em>.
</p>
<p>
- Oletetaan että <em>$email</em> on määritelty (sillä on esimerkiksi
- arvo <em>foo</em>), ja että haluat muuttujan arvon sijaan tulostaa
- sen nimen <em>$email</em>. Tämä saavuttamiseksi on useita keinoja,
- joista helpoin on suojausmerkin käyttäminen.
+ Oletetaan että <em>$email</em> on määritelty (sillä on esimerkiksi
+ arvo <em>foo</em>), ja että haluat muuttujan arvon sijaan tulostaa
+ sen nimen <em>$email</em>. Tämä saavuttamiseksi on useita keinoja,
+ joista helpoin on suojausmerkin käyttäminen.
</p>
<source><![CDATA[
-## Seuraava rivi määrittelee muuttujan $email tässä sivupohjassa:
+## Seuraava rivi määrittelee muuttujan $email tässä sivupohjassa:
#set( $email = "foo" )
$email
\$email
@@ -710,9 +710,9 @@
<p>
Huomaa <em>$</em> merkin eteen liitetty <em>\</em>
merkki. Suojausmerkit tulkitaan vasemmalta oikealle, joten
- <em>\\\$email</em> tulostuu <em>\\$email</em>. Vertaa näitä
- esimerkkejä tulosteeseen joka saadaan kun <em>$email</em>
- muuttujaa ei ole määritelty.
+ <em>\\\$email</em> tulostuu <em>\\$email</em>. Vertaa näitä
+ esimerkkejä tulosteeseen joka saadaan kun <em>$email</em>
+ muuttujaa ei ole määritelty.
</p>
<source><![CDATA[
@@ -734,8 +734,8 @@
]]></source>
<p>
- Huomaa kuinka Velocity käsittelee eri tavalla viittaukset joiden
- arvo on määritelty niistä joita ei ole määritelty. Seuraavassa on
+ Huomaa kuinka Velocity käsittelee eri tavalla viittaukset joiden
+ arvo on määritelty niistä joita ei ole määritelty. Seuraavassa on
set ohje joka asettaa <em>$foo</em> muuttujalle arvon
<em>gibbous</em>.
</p>
@@ -746,13 +746,13 @@
]]></source>
<p>
- Tulosteeksi tulee: <em>$kuu = gibbous</em> -- missä <em>$kuu</em>
- tulostetaan muuttujan nimenä, koska sen arvoa ei ole määritelty ja
+ Tulosteeksi tulee: <em>$kuu = gibbous</em> -- missä <em>$kuu</em>
+ tulostetaan muuttujan nimenä, koska sen arvoa ei ole määritelty ja
<em>gibbous</em> tulostetaan muuttujan <em>$foo</em> arvona.
</p>
<p>
- Myös VTL ohjeiden suojaaminen on mahdollista; tämä kuvataan
+ Myös VTL ohjeiden suojaaminen on mahdollista; tämä kuvataan
tarkemmin Ohjeet -kappaleessa.
</p>
@@ -761,10 +761,10 @@
<section name="Kirjainkoon muutos" href="Kirjainkoonmuutos">
<p>
- Kun nyt olet tutustunut viittauksiin, voit alkaa käyttämään niitä
- tehokkaasti omissa sivupohjissasi. Viittaukset Velocityssä
- käyttävät hyväkseen joitakin java kielen perusperiaatteita, joiden
- käyttö helpottaa sivusuunnittelijoiden työtä. Esimerkiksi:
+ Kun nyt olet tutustunut viittauksiin, voit alkaa käyttämään niitä
+ tehokkaasti omissa sivupohjissasi. Viittaukset Velocityssä
+ käyttävät hyväkseen joitakin java kielen perusperiaatteita, joiden
+ käyttö helpottaa sivusuunnittelijoiden työtä. Esimerkiksi:
</p>
<source><![CDATA[
@@ -786,36 +786,36 @@
]]></source>
<p>
- Nämä esimerkit havainnollistavat viittauksen vaihtoehtoisia
- merkitsemistapoja. Velocity käyttää hyväkseen javan introspection
- ja bean -ominaisuuksia objektien sekä niiden metodien
- viittausnimiä ratkaistaessa. Viittauksia voidaan lisätä lähes
+ Nämä esimerkit havainnollistavat viittauksen vaihtoehtoisia
+ merkitsemistapoja. Velocity käyttää hyväkseen javan introspection
+ ja bean -ominaisuuksia objektien sekä niiden metodien
+ viittausnimiä ratkaistaessa. Viittauksia voidaan lisätä lähes
mihin kohtaan tahansa sivupojassa.
</p>
<p>
- Velocity on tehty Sun Microsystemsin määrittelemän Bean
- määrityksen mukaiseksi, ja on tästä syystä pieni-iso-eroava
- (ts. pienet ja isot kirjaimet käsitellään eri
- merkkeinä). Velocityn kehittäjät ovat tehneet parhaansa jotta
+ Velocity on tehty Sun Microsystemsin määrittelemän Bean
+ määrityksen mukaiseksi, ja on tästä syystä pieni-iso-eroava
+ (ts. pienet ja isot kirjaimet käsitellään eri
+ merkkeinä). Velocityn kehittäjät ovat tehneet parhaansa jotta
mahdolliset kirjoitusvirheet voitaisiin korjata
automaattisesti. Kun sivupohjassa viitataan metodiin
<em>getFoo()</em> koodilla <code>$bar.foo</code>, Velocity
- kokeilee ensin viittausta <code>$getfoo</code>. Jos tämä ei tuota
- tulosta, seuraavaksi yritetään viittausta
+ kokeilee ensin viittausta <code>$getfoo</code>. Jos tämä ei tuota
+ tulosta, seuraavaksi yritetään viittausta
<code>$getFoo</code>. Samalla tavalla, kun sivupohjassa viitataan
- muuttujaan <code>$bar.Foo</code>, ensin yritetään viittausta
+ muuttujaan <code>$bar.Foo</code>, ensin yritetään viittausta
<em>$getFoo()</em> ja sitten <em>getfoo()</em>.
</p>
<p>
- Huomaa: <em>Viittauksia ilmentymämuuttujiin (instance variables)
+ Huomaa: <em>Viittauksia ilmentymämuuttujiin (instance variables)
ei ratkaista.</em> Vain viittaukset JavaBeanin mukaisiin
haku/asetus (getter/setter) metodeihin ratkaistaan (toisin sanoen
<code>$foo.Name</code> ratkaistaan Foo -luokan
- <code>getName()</code> ilmentymämetodiin (instance method), mutta
+ <code>getName()</code> ilmentymämetodiin (instance method), mutta
ei luokan Foo julkiseen (public) <code>Name</code>
- ilmentymämuuttujaan).
+ ilmentymämuuttujaan).
</p>
</section>
@@ -824,19 +824,19 @@
<section name="Ohjeet" href="Ohjeet">
<p>
- <em>Ohjeet</em> ovat helppokäyttöisiä skriptielementtejä joita
- voidaan käyttää web sivun tulosteen manipuloimiseen. Viittausten
+ <em>Ohjeet</em> ovat helppokäyttöisiä skriptielementtejä joita
+ voidaan käyttää web sivun tulosteen manipuloimiseen. Viittausten
avulla sivupohjien suunnittelijat voivat tuottaa web sivuille
- dynaamista sisältöä, kun taas ohjeet antavat mahdollisuuden
- määritellä sivuston ulkoasun ja sisällön.
+ dynaamista sisältöä, kun taas ohjeet antavat mahdollisuuden
+ määritellä sivuston ulkoasun ja sisällön.
</p>
<a name="Set"><strong>#set</strong></a>
<p>
- <em>#set</em> ohjetta käytetään arvon määrittämiseksi
- viittaukselle. Arvo voidaan määrittää joko muuttujaviittaukselle
- tai ominaisuusviittaukselle. Määritys tehdään suluissa, kuten
- seuraavassa esimerkissä:
+ <em>#set</em> ohjetta käytetään arvon määrittämiseksi
+ viittaukselle. Arvo voidaan määrittää joko muuttujaviittaukselle
+ tai ominaisuusviittaukselle. Määritys tehdään suluissa, kuten
+ seuraavassa esimerkissä:
</p>
<source><![CDATA[
@@ -845,9 +845,9 @@
]]></source>
<p>
- Määrityksen vasemman puolen (left hand side, LHS) tulee olla
+ Määrityksen vasemman puolen (left hand side, LHS) tulee olla
muuttuja- tai ominaisuusviittaus. Oikea puoli (right hand side,
- RHS) voi olla jokin seuraavista tyypeistä:
+ RHS) voi olla jokin seuraavista tyypeistä:
</p>
<p>
@@ -862,7 +862,7 @@
</p>
<p>
- Seuraavassa esimerkit kustakin mainitusta tyypistä:
+ Seuraavassa esimerkit kustakin mainitusta tyypistä:
</p>
<source><![CDATA[
@@ -875,15 +875,15 @@
]]></source>
<p>
- HUOMAA: Viimeisessä esimerkissä [..] operaattorilla määritetyt
- elementit ovat käytettävissä ArrayList -luokan metodien
- avulla. Voisit siis esimerkiksi viitata taulukon ensimmäiseen
+ HUOMAA: Viimeisessä esimerkissä [..] operaattorilla määritetyt
+ elementit ovat käytettävissä ArrayList -luokan metodien
+ avulla. Voisit siis esimerkiksi viitata taulukon ensimmäiseen
elementtiin koodilla $apina.Sano.get(0).
</p>
<p>
- Oikeanpuoleinen arvo (RHS) voi olla myös yksinkertainen
+ Oikeanpuoleinen arvo (RHS) voi olla myös yksinkertainen
matemaattinen operaatio:
</p>
@@ -895,16 +895,16 @@
]]></source>
<p>
- Jos määrityksen oikeanpuoleinen ominaisuus- tai metodiviittaus on
- arvoa <em>null</em>, sitä <b>ei</b> anneta vasemman puolen
- arvoksi. Tätä keinoa ei voida käyttää olemassa olevan viittauksen
- poistamiseen. Tämä saattaa olla hämäävää Velocityn uusille
- käyttäjille. Esimerkiksi:
+ Jos määrityksen oikeanpuoleinen ominaisuus- tai metodiviittaus on
+ arvoa <em>null</em>, sitä <b>ei</b> anneta vasemman puolen
+ arvoksi. Tätä keinoa ei voida käyttää olemassa olevan viittauksen
+ poistamiseen. Tämä saattaa olla hämäävää Velocityn uusille
+ käyttäjille. Esimerkiksi:
</p>
<source><![CDATA[
#set( $tulos = $kysely.kriteeri("nimi") )
-Ensimmäisen kyselyn tulos on $tulos
+Ensimmäisen kyselyn tulos on $tulos
#set( $tulos = $kysely.kriteeri("osoite") )
Toisen kyselyn tulos on $tulos
@@ -917,16 +917,16 @@
</p>
<source><![CDATA[
-Ensimmäisen kyselyn tulos on pete
+Ensimmäisen kyselyn tulos on pete
Toisen kyselyn tulos on pete
]]></source>
<p>
- Tällä on vaara hämätä aloittelijoita jotka muodostavat
- <em>#foreach</em> silmukoita joissa yritetään asettaa
+ Tällä on vaara hämätä aloittelijoita jotka muodostavat
+ <em>#foreach</em> silmukoita joissa yritetään asettaa
<em>#set</em> ohjeella viittausta ominaisuus- tai
- metodiviittauksella, ja sen jälkeen testataan tuota viittausta
+ metodiviittauksella, ja sen jälkeen testataan tuota viittausta
<em>#if</em> ohjeella. Esimerkiksi:
</p>
@@ -946,19 +946,19 @@
]]></source>
<p>
- Yllä olevassa esimerkissä ei kannata luottaa <em>$tulos</em>
+ Yllä olevassa esimerkissä ei kannata luottaa <em>$tulos</em>
muuttujan vertaamiseen kyselyn onnistumisen selville
saamiseksi. Kun <em>$tulos</em> on asetettu <em>#set</em>
- ohjeella (lisatty kontekstiin), sitä ei voida asettaa
+ ohjeella (lisatty kontekstiin), sitä ei voida asettaa
<em>null</em>:iksi (poistaa kontekstista). <em>#if</em> ja
- <em>#foreach</em> ohjeet käsitellään tarkemmin myöhemmin tässä
+ <em>#foreach</em> ohjeet käsitellään tarkemmin myöhemmin tässä
dokumentissa.
</p>
<p>
- Yksi ratkaisu ongelmaan olisi asettaa <em>$tulos</em> etukäteen
- arvoon <em>false</em> (epätosi). Tämän jälkeen jos kutsu
- <em>$kysely.kriteeri()</em> epäonnistuu, voit tarkastaa arvon.
+ Yksi ratkaisu ongelmaan olisi asettaa <em>$tulos</em> etukäteen
+ arvoon <em>false</em> (epätosi). Tämän jälkeen jos kutsu
+ <em>$kysely.kriteeri()</em> epäonnistuu, voit tarkastaa arvon.
</p>
@@ -980,15 +980,15 @@
<p>
Muutamista muista Velocityn ohjeista poiketen, <em>#set</em> ohje
- ei käytä <em>#end</em> lausetta.
+ ei käytä <em>#end</em> lausetta.
</p>
<a name="Tekstivakiot"><strong>Tekstivakiot</strong></a>
<p>
- <em>#set</em> ohjetta käytettäessä lainausmerkkeihin (" ")
+ <em>#set</em> ohjetta käytettäessä lainausmerkkeihin (" ")
suljettu teksti tulkitaan ja tulostetaan kuten seuraavasta
- esimerkistä käy ilmi:
+ esimerkistä käy ilmi:
</p>
<source><![CDATA[
@@ -1007,7 +1007,7 @@
]]></source>
<p>
- Jos teksti on suljettu hipsuihin (' '), sitä ei tulkita:
+ Jos teksti on suljettu hipsuihin (' '), sitä ei tulkita:
</p>
<source><![CDATA[
@@ -1025,10 +1025,10 @@
]]></source>
<p>
- Tulkitsemattoman tekstin tulostaminen hipsumerkkien sisällä
- olevavasta tekstistä on oletuksena käytössä
- Velocityssä. Oletusarvo voidaan muuttaa vaihtamalla
- <code>velocity.properties</code> siten että
+ Tulkitsemattoman tekstin tulostaminen hipsumerkkien sisällä
+ olevavasta tekstistä on oletuksena käytössä
+ Velocityssä. Oletusarvo voidaan muuttaa vaihtamalla
+ <code>velocity.properties</code> siten että
<code>stringliterals.interpolate=false</code>.
</p>
</section>
@@ -1038,8 +1038,8 @@
<strong>If / ElseIf / Else</strong>
<p>
- <em>#if</em> ohjeen avulla voidaan teksti sisällyttää web
- sivulle sillä ehdolla että if lauseen arvo on
+ <em>#if</em> ohjeen avulla voidaan teksti sisällyttää web
+ sivulle sillä ehdolla että if lauseen arvo on
tosi. Esimerkiksi:
</p>
@@ -1050,29 +1050,29 @@
]]></source>
<p>
- Muuttuja <em>$foo</em> testataan jotta nähdään onko se tosi,
+ Muuttuja <em>$foo</em> testataan jotta nähdään onko se tosi,
joka tapahtuu kahdessa eri tapauksessa: (i) <em>$foo</em> on
- boolean arvo (tosi/epätosi) jolla on tosi -arvo, tai (ii) arvo
- on eri kuin null (eli muuttuja ei ole tyhjä). <em>#if</em> ja
- <em>#end</em> lauseiden väliin jäävä sisältö tulostetaan mikäli
+ boolean arvo (tosi/epätosi) jolla on tosi -arvo, tai (ii) arvo
+ on eri kuin null (eli muuttuja ei ole tyhjä). <em>#if</em> ja
+ <em>#end</em> lauseiden väliin jäävä sisältö tulostetaan mikäli
testimuuttuja on tosi. Esimerkkitapauksessamme, jos muuttujalla
- <em>$foo</em> on null arvo, tai jos se on boolean epätosi, on
- testimuuttuja epätosi, eikä tulostetta tule lainkaan.
+ <em>$foo</em> on null arvo, tai jos se on boolean epätosi, on
+ testimuuttuja epätosi, eikä tulostetta tule lainkaan.
</p>
<p>
- <em>#if</em> ja <em>#end</em> lauseiden välissä oleva teksti
- tulee tulosteeksi mikäli ehto on tosi. Tässä tapauksessa jos
+ <em>#if</em> ja <em>#end</em> lauseiden välissä oleva teksti
+ tulee tulosteeksi mikäli ehto on tosi. Tässä tapauksessa jos
<em>$foo</em> on tosi, tulosteeksi tulee:
- "Velocity!". Toisaalta, mikäli <em>$foo</em> on epätosi, on myös
- ehtolause epätosi eikä tulostetta tule.
+ "Velocity!". Toisaalta, mikäli <em>$foo</em> on epätosi, on myös
+ ehtolause epätosi eikä tulostetta tule.
</p>
<p>
- <em>#elseif</em> tai <em>#else</em> elementtejä voidaan käyttää
- <em>#if</em> elementin kanssa. Huomaa, että Velocityn
- sivumoottori lopettaa ensimmäisen tosiarvon saaneen
- testimuuttujan kohdalla. Oletetaan seuraavassa esimerkissä että
+ <em>#elseif</em> tai <em>#else</em> elementtejä voidaan käyttää
+ <em>#if</em> elementin kanssa. Huomaa, että Velocityn
+ sivumoottori lopettaa ensimmäisen tosiarvon saaneen
+ testimuuttujan kohdalla. Oletetaan seuraavassa esimerkissä että
muuttujalla <em>$foo</em> on arvo 15 ja muuttujalla
<em>$bar</em> on arvo 6.
</p>
@@ -1081,18 +1081,18 @@
#if( $foo < 10 )
<strong>Mene pohjoiseen</strong>
#elseif( $foo == 10 )
- <strong>Mene itään</strong>
+ <strong>Mene itään</strong>
#elseif( $bar == 6 )
- <strong>Mene etelään</strong>
+ <strong>Mene etelään</strong>
#else
- <strong>Mene länteen</strong>
+ <strong>Mene länteen</strong>
#end
]]></source>
- <p>Tässä esimerkissä <em>$foo</em> on suurempi kuin 10, joten
- kaksi ensimmäistä vertailua eivät ole tosia. Seuraavaksi muuttujaa
+ <p>Tässä esimerkissä <em>$foo</em> on suurempi kuin 10, joten
+ kaksi ensimmäistä vertailua eivät ole tosia. Seuraavaksi muuttujaa
<em>$bar</em> verrataan lukuun 6, joka on tosi, joten tulosteeksi
- tulee <strong>Mene etelään</strong>.
+ tulee <strong>Mene etelään</strong>.
</p>
<p>
@@ -1101,9 +1101,9 @@
</p>
<p>
- Velocity käyttää vastaavuusoperaattoria muuttujien välisten
+ Velocity käyttää vastaavuusoperaattoria muuttujien välisten
suhteiden tulkitsemiseen. Seuraavassa on yksinkertainen esimerkki
- vastaavuusoperaattorin käytöstä.
+ vastaavuusoperaattorin käytöstä.
</p>
<source><![CDATA[
@@ -1111,17 +1111,17 @@
#set ($bar = "ribonukleiinihappo")
#if ($foo == $bar)
- Muuttujat eivät selvästikään ole samanlaiset. Joten...
+ Muuttujat eivät selvästikään ole samanlaiset. Joten...
#else
- Vastaavuusvertaus on epätosi, ja tämä teksti tulee tulosteeksi.
+ Vastaavuusvertaus on epätosi, ja tämä teksti tulee tulosteeksi.
#end
]]></source>
<p>
- Velocity tukee myös loogisia AND ja OR
- operaattoreita. Lisätietoja löydät dokumentista <a
+ Velocity tukee myös loogisia AND ja OR
+ operaattoreita. Lisätietoja löydät dokumentista <a
href="../docs/vtl-reference-guide.html">VTL Reference Guide</a>. Alla on
- esimerkkilause joka käyttää loogista AND:iä.
+ esimerkkilause joka käyttää loogista AND:iä.
</p>
<source><![CDATA[
@@ -1129,26 +1129,26 @@
## looginen AND
#if( $foo && $bar )
- <strong> Tämä JA tuo</strong>
+ <strong> Tämä JA tuo</strong>
#end
]]></source>
<p>
- If lause on tosi vain mikäli sekä <em>$foo</em> että
- <em>$bar</em> ovat tosia. Jos <em>$foo</em> on epätosi, tulee
- lauseesta epätosi eikä <em>$bar</em> muuttujaa tarvitse edes
- testata. Jos <em>$foo</em> on tosi, testataan sen jälkeen
- muuttujan <em>$bar</em> arvo; jos myös <em>$bar</em> on tosi,
- silloin koko ilmaus on tosi ja <strong>Tämä JA tuo</strong>
- tulee tulosteeksi. Jos <em>$bar</em> on epätosi, silloin koko
- ilmaus on epätosi eikä tulostetta tule.
+ If lause on tosi vain mikäli sekä <em>$foo</em> että
+ <em>$bar</em> ovat tosia. Jos <em>$foo</em> on epätosi, tulee
+ lauseesta epätosi eikä <em>$bar</em> muuttujaa tarvitse edes
+ testata. Jos <em>$foo</em> on tosi, testataan sen jälkeen
+ muuttujan <em>$bar</em> arvo; jos myös <em>$bar</em> on tosi,
+ silloin koko ilmaus on tosi ja <strong>Tämä JA tuo</strong>
+ tulee tulosteeksi. Jos <em>$bar</em> on epätosi, silloin koko
+ ilmaus on epätosi eikä tulostetta tule.
</p>
<p>
- Looginen OR operaattori toimii samaan tapaan, paitsi että vain
- toisen viittauksen pitää olla tosi jotta koko ilmaus olisi
- tosi. Katso seuraavaa esimerkkiä.
+ Looginen OR operaattori toimii samaan tapaan, paitsi että vain
+ toisen viittauksen pitää olla tosi jotta koko ilmaus olisi
+ tosi. Katso seuraavaa esimerkkiä.
</p>
<source><![CDATA[
@@ -1156,19 +1156,19 @@
## looginen OR
#if( $foo || $bar )
- <strong>Tämä TAI tuo</strong>
+ <strong>Tämä TAI tuo</strong>
#end
]]></source>
<p>
Jos <em>$foo</em> on tosi, ei <em>$bar</em> muuttujaa tarvitse
- edes testata. Oli <em>$bar</em> sitten tosi tai epätosi, koko
- lauseke on tosi, ja <strong>Tämä TAI tuo</strong> on
- tulosteena. Toisaalta mikäli <em>$foo</em> on epätosi, on
- muuttujan <em>$bar</em> arvo testattava. Jos tässä tapauksessa
- myös <em>$bar</em> on epätosi, koko ilmauksesta tulee epätosi
- eikä tulostetta tule. Jos <em>$bar</em> on tosi, silloin koko
- ilmauksesta tulee tosi, ja tulosteena on <strong>Tämä TAI
+ edes testata. Oli <em>$bar</em> sitten tosi tai epätosi, koko
+ lauseke on tosi, ja <strong>Tämä TAI tuo</strong> on
+ tulosteena. Toisaalta mikäli <em>$foo</em> on epätosi, on
+ muuttujan <em>$bar</em> arvo testattava. Jos tässä tapauksessa
+ myös <em>$bar</em> on epätosi, koko ilmauksesta tulee epätosi
+ eikä tulostetta tule. Jos <em>$bar</em> on tosi, silloin koko
+ ilmauksesta tulee tosi, ja tulosteena on <strong>Tämä TAI
tuo</strong>.
</p>
@@ -1187,10 +1187,10 @@
]]></source>
<p>
- Jos <em>$foo</em> on tosi, silloin <em>!$foo</em> on epätosi, eikä
- tulostetta tämän vuoksi tule. Mikäli <em>$foo</em> on epätosi,
+ Jos <em>$foo</em> on tosi, silloin <em>!$foo</em> on epätosi, eikä
+ tulostetta tämän vuoksi tule. Mikäli <em>$foo</em> on epätosi,
silloin <em>!$foo</em> on tosi ja <strong>EI tuota</strong> on
- tulosteena. Älä sekoita tätä merkintää <em>hiljaiseen viittaukseen
+ tulosteena. Ãlä sekoita tätä merkintää <em>hiljaiseen viittaukseen
$!foo</em> joka tarkoittaa jotakin aivan muuta.
</p>
@@ -1214,25 +1214,25 @@
]]></source>
<p>
- Tämä <em>#foreach</em> silmukka käy läpi yksi kerrallaan kaikki
+ Tämä <em>#foreach</em> silmukka käy läpi yksi kerrallaan kaikki
<em>$kaikkiTuotteet</em> listassa olevat tuotteet. Jokaisella
kierroksella seuraavan tuotteen arvo kopioidaan
<em>$kaikkiTuotteet</em> listasta muuttujaan <em>$tuote</em>.
</p>
<p>
- <em>$kaikkiTuotteet</em> lista on tyyppiä Vector, Hashtable tai
+ <em>$kaikkiTuotteet</em> lista on tyyppiä Vector, Hashtable tai
Array. <em>$tuote</em> muuttujaan kopioitu arvo on java objekti
- (Object), joten siihen voidaan myös viitata objektina. Jos
- esimerkiksi <em>$tuote</em> muuttuja olisi tyyppiä Tuote, sen nimi
+ (Object), joten siihen voidaan myös viitata objektina. Jos
+ esimerkiksi <em>$tuote</em> muuttuja olisi tyyppiä Tuote, sen nimi
voitaisiin hakea viittaamalla <em>$tuote.Name</em> metodiin
(ts. <em>$Tuote.getName()</em>.
</p>
<p>
- Oletetaan että <em>$kaikkiTuotteet</em> on tyyppiä Hashtable. Jos
- haluat hakea Hashtablen avainarvot sekä niihin liittyvät objektit,
- voit käyttää seuraavanlaista koodia:
+ Oletetaan että <em>$kaikkiTuotteet</em> on tyyppiä Hashtable. Jos
+ haluat hakea Hashtablen avainarvot sekä niihin liittyvät objektit,
+ voit käyttää seuraavanlaista koodia:
</p>
<source><![CDATA[
@@ -1244,8 +1244,8 @@
]]></source>
<p>
- Velocityllä on helppo keino silmukkalaskurin käyttämiseen. Voit
- käyttää laskuria esimerkiksi seuraavasti:
+ Velocityllä on helppo keino silmukkalaskurin käyttämiseen. Voit
+ käyttää laskuria esimerkiksi seuraavasti:
</p>
<source><![CDATA[
@@ -1257,12 +1257,12 @@
]]></source>
<p>
- Silmukkalaskurin oletusnimi on $velocityCount ja se määritetään
+ Silmukkalaskurin oletusnimi on $velocityCount ja se määritetään
velocity.properties tiedostossa. Oletuksena laskuri alkaa arvosta
- 1, mutta aloitusarvo voidaan määrittää olemaan joko 1 tai 0
+ 1, mutta aloitusarvo voidaan määrittää olemaan joko 1 tai 0
<code>velocity.properties</code>
tiedostossa. <code>velocity.properties</code> tiedoston
- silmukkalaskuriosio näyttää tältä:
+ silmukkalaskuriosio näyttää tältä:
</p>
<source><![CDATA[
@@ -1279,12 +1279,12 @@
<p>
<em>#include</em> elementin avulla sivusuunnittelija voi hakea
- paikallisesta tiedostojärjestelmästä tiedoston, jonka sisältö
- lisätään sivun siihen kohtaan jossa <em>#include</em> määritys
- tehtiin. Tiedoston sisältö liitetään sellaisenaan eikä sitä siis
- käytetä Velocityn sivumoottorin kautta. Turvallisuussyistä
+ paikallisesta tiedostojärjestelmästä tiedoston, jonka sisältö
+ lisätään sivun siihen kohtaan jossa <em>#include</em> määritys
+ tehtiin. Tiedoston sisältö liitetään sellaisenaan eikä sitä siis
+ käytetä Velocityn sivumoottorin kautta. Turvallisuussyistä
haettava tiedosto voi sijaita vain TEMPLATE_ROOT vakion
- määrittämän hakemiston alla.
+ määrittämän hakemiston alla.
</p>
<source><![CDATA[
@@ -1293,7 +1293,7 @@
<p>
Tiedosto johon <em>#include</em> ohje viittaa on
- lainausmerkeissä. Jos halutaan sisällyttää useampia kuin yksi
+ lainausmerkeissä. Jos halutaan sisällyttää useampia kuin yksi
tiedosto, tiedostonimet tulee erotella toisistaan pilkuilla.
</p>
@@ -1302,12 +1302,12 @@
]]></source>
<p>
- Sisällytettävään tiedoston ei ole pakko viitata nimen perusteella;
- itse asiassa usein on parempi käyttää muuttujaa tiedostonimen
- asemesta. Tämä on hyödyllistä esimerkiksi silloin kun sivun
- ulkoasu riippuu sivupyynnön aikana päätettävästä
- ehdosta. Seuraavassa on esimerkki jossa käytetään sekä
- tiedostonimeä että muuttujaa.
+ Sisällytettävään tiedoston ei ole pakko viitata nimen perusteella;
+ itse asiassa usein on parempi käyttää muuttujaa tiedostonimen
+ asemesta. Tämä on hyödyllistä esimerkiksi silloin kun sivun
+ ulkoasu riippuu sivupyynnön aikana päätettävästä
+ ehdosta. Seuraavassa on esimerkki jossa käytetään sekä
+ tiedostonimeä että muuttujaa.
</p>
<source><![CDATA[
@@ -1319,9 +1319,9 @@
<section name="Parse" href="Parse">
<p>
- <em>#parse</em> elementin avulla sivusuunnittelija voi sisällyttää
- paikallisesta levyjärjestelmästä tiedostoja jotka sisältävät VTL
- elementtejä. Velocity tulkitsee VTL komennot ja tulostaa tuloksen.
+ <em>#parse</em> elementin avulla sivusuunnittelija voi sisällyttää
+ paikallisesta levyjärjestelmästä tiedostoja jotka sisältävät VTL
+ elementtejä. Velocity tulkitsee VTL komennot ja tulostaa tuloksen.
</p>
<source><![CDATA[
@@ -1330,26 +1330,26 @@
<p>
<em>#include</em> ohjeen tapaan <em>#parse</em> voi ottaa
- parametrikseen nimen lisäksi myös muuttujan. Kaikkien sivupohjien
+ parametrikseen nimen lisäksi myös muuttujan. Kaikkien sivupohjien
joihin <em>#parse</em> ohjeella viitataan tulee sijaita
- TEMPLATE_ROOT vakion määrittämän hakemiston
+ TEMPLATE_ROOT vakion määrittämän hakemiston
alla. <em>#include</em> ohjeesta poiketen <em>#parse</em> voi
ottaa vain yhden argumentin.
</p>
<p>
VTL sivupohjissa voi olla <em>#parse</em> ohjeita jotka viittaavat
- sivupohjiin joissa niissäkin on <em>#parse</em>
+ sivupohjiin joissa niissäkin on <em>#parse</em>
ohjeita. <code>velocity.properties</code> tiedostossa oleva rivi
- <em>parse_directive.maxdepth</em> määrittää sen kuinka monta
- peräkkäistä <em>#parse</em> viittausta voidaan tehdä. Mikäli
- <em>parse_directive.maxdepth</em> määritys puuttuu, käytetään
+ <em>parse_directive.maxdepth</em> määrittää sen kuinka monta
+ peräkkäistä <em>#parse</em> viittausta voidaan tehdä. Mikäli
+ <em>parse_directive.maxdepth</em> määritys puuttuu, käytetään
oletusarvoa 10. Rekursiivisuus on sallittu. Jos esimerkiksi
- sivupohja <code>dofoo.vm</code> sisältää seuraavat rivit:
+ sivupohja <code>dofoo.vm</code> sisältää seuraavat rivit:
</p>
<source><![CDATA[
-Laske alaspäin.
+Laske alaspäin.
#set( $laskuri = 8 )
#parse( "parsefoo.vm" )
Kaikki valmista: dofoo.vm!
@@ -1371,10 +1371,10 @@
]]></source>
<p>
- Kun "Laske alaspäin." on näytetty, Velocity lataa ja siirtää
+ Kun "Laske alaspäin." on näytetty, Velocity lataa ja siirtää
kontrollin sivupohjalle <code>parsefoo.vm</code>, joka laskee alas
luvusta 8. Kun laskuri saavuttaa arvon 0, tulostetaan "Kaikki
- valmista: parsefoo.vm!". Tämän jälkeen Velocity palaa sivupohjaan
+ valmista: parsefoo.vm!". Tämän jälkeen Velocity palaa sivupohjaan
<code>dofoo.vm</code> ja tulostaa "Kaikki valmista: dofoo.vm!"
tekstin.
</p>
@@ -1386,8 +1386,8 @@
<p>
<em>#stop</em> elementin avulla sivupohjan suunnittelija voi
- pysäyttää sivun tulkitsemisen. Tämä on hyödyllistä sivupohjan
- virheidenetsinnän aikana.
+ pysäyttää sivun tulkitsemisen. Tämä on hyödyllistä sivupohjan
+ virheidenetsinnän aikana.
</p>
<source><![CDATA[
@@ -1399,11 +1399,11 @@
<p>
<em>#macro</em> elementin avulla sivupohjan suunnittelija voi
- määrittää toistuvasti käytetyn VTL sivupohjan osan. Velocimakrot
- ovat erittäin käyttökelpoisia sekä monimutkaisissa, että
- yksinkertaisissa tehtävissä. Seuraava Velocimakro toimii
+ määrittää toistuvasti käytetyn VTL sivupohjan osan. Velocimakrot
+ ovat erittäin käyttökelpoisia sekä monimutkaisissa, että
+ yksinkertaisissa tehtävissä. Seuraava Velocimakro toimii
johdantona Velocimakroihin. Se on luotu kirjoitettavan tekstin
- määrän vähentämiseksi, sekä kirjoitusvirheiden määrän
+ määrän vähentämiseksi, sekä kirjoitusvirheiden määrän
minimoimiseksi.
</p>
@@ -1414,7 +1414,7 @@
]]></source>
<p>
- Esimerkissä määriteltiin Velocimakro nimeltään <em>d</em>, ja sitä
+ Esimerkissä määriteltiin Velocimakro nimeltään <em>d</em>, ja sitä
voidaan kutsua muiden VTL ohjeiden tapaan:
</p>
@@ -1423,17 +1423,17 @@
]]></source>
<p>
- Kun tätä sivupohjaa haetaan, Velocity korvaa ohjeen <em>#d()</em>
- rivillä joka sisältää yhden tyhjän solun.
+ Kun tätä sivupohjaa haetaan, Velocity korvaa ohjeen <em>#d()</em>
+ rivillä joka sisältää yhden tyhjän solun.
</p>
<p>
Velocimakro voi ottaa kuinka monta parametria tahansa -- tai ei
- yhtään parametria, kuten ensimmäisessä esimerkissämme -- mutta kun
- Velocimakroa kutsutaan, tulee kutsussa olla täsmälleen yhtä monta
- parametria kuin makroa määriteltäessä. Useimmat Velocimakrot ovat
+ yhtään parametria, kuten ensimmäisessä esimerkissämme -- mutta kun
+ Velocimakroa kutsutaan, tulee kutsussa olla täsmälleen yhtä monta
+ parametria kuin makroa määriteltäessä. Useimmat Velocimakrot ovat
hieman monimutkaisempia kuin edellinen esimerkki. Seuraavassa on
- Velocimakro joka ottaa kaksi argumenttia; värin ja listan.
+ Velocimakro joka ottaa kaksi argumenttia; värin ja listan.
</p>
<source><![CDATA[
@@ -1445,18 +1445,18 @@
]]></source>
<p>
- Tässä esimerkissä määriteltiin Velocimakro <em>taulurivit</em>
- joka ottaa kaksi parametria. Ensimmäinen parametri on
+ Tässä esimerkissä määriteltiin Velocimakro <em>taulurivit</em>
+ joka ottaa kaksi parametria. Ensimmäinen parametri on
<em>$vari</em> ja toinen <em>$jokulista</em>.
</p>
<p>
- Velocimakroon voidaan kirjoittaa mitä tahansa koodia jota voidaan
- käyttää muuallakin VTL sivupohjassa. <em>taulurivit</em>
+ Velocimakroon voidaan kirjoittaa mitä tahansa koodia jota voidaan
+ käyttää muuallakin VTL sivupohjassa. <em>taulurivit</em>
Velocimakro on <em>foreach</em> lause. <em>taulurivit</em>
- Velocimakrossa on kaksi <em>#end</em> lausetta; ensimmäinen kuuluu
- <em>#foreach</em> lauseelle, jälkimmäinen päättää Velocimakron
- määrityksen.
+ Velocimakrossa on kaksi <em>#end</em> lausetta; ensimmäinen kuuluu
+ <em>#foreach</em> lauseelle, jälkimmäinen päättää Velocimakron
+ määrityksen.
</p>
<source><![CDATA[
@@ -1468,9 +1468,9 @@
]]></source>
<p>
- Huomaa että <em>$suuretjarvet</em> on makron parametrin
+ Huomaa että <em>$suuretjarvet</em> on makron parametrin
<em>$jokulista</em> arvona. Kun Velocimakroa <em>#taulurivit</em>
- tässä tapauksessa kutsutaan, on tuloksena seuraavaa:
+ tässä tapauksessa kutsutaan, on tuloksena seuraavaa:
</p>
<source><![CDATA[
@@ -1484,23 +1484,23 @@
]]></source>
<p>
- Velocimakroja voidaan määrittää <em>inline</em>, eli Velocity
- sivupohjassa itsessään, jolloin ko. makro ei ole käytettävissä
- muissa sivupohjissa. Velocimakron määrittäminen siten että se on
- kaikkien sivupohjien käytössä on hyödyllistä; samaa makroa ei
- tarvitse määrittää erikseen jokaisessa sivupohjassa jossa sitä
- tarvitaan, jolloin työmäärä ja virheiden mahdollisuus
- vähenee. Lisäksi makroon tehty muutos vaikuttaa heti kaikkiin
- sivupohjiin joissa se on käytössä.
+ Velocimakroja voidaan määrittää <em>inline</em>, eli Velocity
+ sivupohjassa itsessään, jolloin ko. makro ei ole käytettävissä
+ muissa sivupohjissa. Velocimakron määrittäminen siten että se on
+ kaikkien sivupohjien käytössä on hyödyllistä; samaa makroa ei
+ tarvitse määrittää erikseen jokaisessa sivupohjassa jossa sitä
+ tarvitaan, jolloin työmäärä ja virheiden mahdollisuus
+ vähenee. Lisäksi makroon tehty muutos vaikuttaa heti kaikkiin
+ sivupohjiin joissa se on käytössä.
</p>
<p>
- Oletetaan että Velocityssä on määriteltynä Velocimakro
- <em>#tablerows($vari $lista)</em>. Tätä makroa voitaisiin käyttää
- missä tahansa sivupohjassa. Sitä voitaisiin käyttää useaan kertaan
- ja moneen eri käyttötarkoitukseen. Sieniasioita käsittelevässä
+ Oletetaan että Velocityssä on määriteltynä Velocimakro
+ <em>#tablerows($vari $lista)</em>. Tätä makroa voitaisiin käyttää
+ missä tahansa sivupohjassa. Sitä voitaisiin käyttää useaan kertaan
+ ja moneen eri käyttötarkoitukseen. Sieniasioita käsittelevässä
sivupohjassa <code>sieni.vm</code>, <em>#tablerows</em>
- Velocimakroa voitaisiin käyttää listaamaan tyypillisen sienen
+ Velocimakroa voitaisiin käyttää listaamaan tyypillisen sienen
osat:
</p>
@@ -1515,7 +1515,7 @@
<p>
Kun Velocity luo sivun sivupohjasta <code>sieni.vm</code>, se
etsii Velocimakron <em>#tablerows</em> sivupohjakirjastosta (joka
- on määritelty <code>velocity.properties</code> tiedostossa) ja
+ on määritelty <code>velocity.properties</code> tiedostossa) ja
tuottaa seuraavan tulosteen:
</p>
@@ -1532,13 +1532,13 @@
<strong>Velocimakron argumentit</strong>
<p>
- Velocimakrot voivat ottaa argumenteiksi mitä tahansa seuraavista
- VTL elementeistä:
+ Velocimakrot voivat ottaa argumenteiksi mitä tahansa seuraavista
+ VTL elementeistä:
</p>
<ul>
<li>
- Viittaus : mitä tahansa '$' merkillä alkavaa
+ Viittaus : mitä tahansa '$' merkillä alkavaa
</li>
<li>
Tekstivakio : esimerkiksi "$foo" tai 'hei'
@@ -1547,7 +1547,7 @@
Numerovakio : 1, 2 jne
</li>
<li>
- Numeroväli : [ 1..2] tai [$foo .. $bar]
+ Numeroväli : [ 1..2] tai [$foo .. $bar]
</li>
<li>
ObjectArray : [ "a", "b", "c"]
@@ -1556,16 +1556,16 @@
boolean arvo true (tosi)
</li>
<li>
- boolean arvo false (epätosi)
+ boolean arvo false (epätosi)
</li>
</ul>
<p>
- Kun siirrät viittauksia argumentteina Velocimakroille, huomaa,
- että viittaukset siirretään 'nimen mukaan' ('by name'). Tämä
- tarkoittaa sitä, että viittausten arvo 'haetaan' Velocimakrossa
- itsessään. Tämän ominaisuuden avulla voit siirtää viittauksia
- jotka ovat metodikutsuja, ja näin ko. metodeja kutsutaan
+ Kun siirrät viittauksia argumentteina Velocimakroille, huomaa,
+ että viittaukset siirretään 'nimen mukaan' ('by name'). Tämä
+ tarkoittaa sitä, että viittausten arvo 'haetaan' Velocimakrossa
+ itsessään. Tämän ominaisuuden avulla voit siirtää viittauksia
+ jotka ovat metodikutsuja, ja näin ko. metodeja kutsutaan
Velocimakrossa. Esimerkiksi kun Velocimakroa kutsutaan
seuraavasti:
</p>
@@ -1583,18 +1583,18 @@
</p>
<p>
- Ensi katsomalta tämä ominaisuus saattaa vaikuttaa yllättävältä,
- mutta kun otat huomioon Velocimakrojen alkuperäisen
- tarkoituksen -- usein käytettyjen VTL komentojen leikkaa-liimaa
- kopioimisen vähentäminen -- ominaisuus on perusteltu. Sen
- avulla voit esimerkiksi siirtää Velocimakroon argumenttina
+ Ensi katsomalta tämä ominaisuus saattaa vaikuttaa yllättävältä,
+ mutta kun otat huomioon Velocimakrojen alkuperäisen
+ tarkoituksen -- usein käytettyjen VTL komentojen leikkaa-liimaa
+ kopioimisen vähentäminen -- ominaisuus on perusteltu. Sen
+ avulla voit esimerkiksi siirtää Velocimakroon argumenttina
tilansa muistavia (stateful) objekteja, kuten objektin joka
- generoi värejä peräkkäisessä järjestyksessä taulukon rivien
- värien määrittämiseksi.
+ 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
+ Jos sinun tarvitsee kiertää tämä ominaisuus, voit hakea arvon
metodista uudeksi viittaukseksi, ja antaa sen argumentiksi:
</p>
@@ -1606,54 +1606,54 @@
<strong>Velocimakro ominaisuudet</strong>
<p>
- <code>velocity.properties</code> tiedostossa on useita rivejä
+ <code>velocity.properties</code> tiedostossa on useita rivejä
joiden avulla Velocimakrojen toimintaa voidaan muuttaa
- joustavasti. Huomaa että nämä arvot on dokumentoitu myös <a
- href="http://jakarta.apache.org/velocity/developer-guide.html">Kehittäjän
+ joustavasti. Huomaa että nämä arvot on dokumentoitu myös <a
+ href="http://jakarta.apache.org/velocity/developer-guide.html">Kehittäjän
oppaassa</a>.
</p>
<p>
<code>velocimacro.library</code> - Pilkulla eroteltu lista
- Velocimakro sivupohjakirjastoja. Oletuksena Velocity etsii yhtä
+ Velocimakro sivupohjakirjastoja. Oletuksena Velocity etsii yhtä
kirjastoa: <em>VM_global_library.vm</em>. Velocimakro kirjastoja
- etsitään määritellystä sivupohjahakemistosta.
+ etsitään määritellystä sivupohjahakemistosta.
</p>
<p>
- <code>velocimacro.permissions.allow.inline</code> - Tämä
- ominaisuus päättää voidaanko Velocimakroja määrittää tavallisissa
+ <code>velocimacro.permissions.allow.inline</code> - Tämä
+ ominaisuus päättää voidaanko Velocimakroja määrittää tavallisissa
sivupohjissa. Ominaisuus voi saada arvon true (tosi) tai false
- (epätosi). Oletuksena on tosi, jolloin sivusuunnittelijat voivat
- määrittää Velocimakroja suoraan omissa sivupohjissaan.
+ (epätosi). Oletuksena on tosi, jolloin sivusuunnittelijat voivat
+ määrittää Velocimakroja suoraan omissa sivupohjissaan.
</p>
<p>
<code>velocimacro.permissions.allow.inline.to.replace.global</code>
- - Tämän ominaisuuden avulla voidaan määrittää voivatko
- sivupohjassa määritellyt Velocimakrot korvata yleisesti
- määritellyt, <code>velocimacro.library</code> ominaisuuden kautta
+ - Tämän ominaisuuden avulla voidaan määrittää voivatko
+ sivupohjassa määritellyt Velocimakrot korvata yleisesti
+ määritellyt, <code>velocimacro.library</code> ominaisuuden kautta
ladatut Velocimakrot. Ominaisuus voi saada arvon true tai
- false. Oletuksena <code>false</code>, epätosi, jolloin
- sivupohjassa määritellyt Velocimakrot eivät voi korvata
+ false. Oletuksena <code>false</code>, epätosi, jolloin
+ sivupohjassa määritellyt Velocimakrot eivät voi korvata
sivupohjakirjastoista ladattuja makroja.
</p>
<p>
<code>velocimacro.permissions.allow.inline.local.scope</code> -
- Mahdolliset arvot ovat true tai false, oletuksena false. Tämä
- ominaisuus päättää ovatko sivupohjassa määritetyt Velocimakrot
- 'näkyviä' ainoastaan siinä sivupohjassa jossa ne on
- määritelty. Toisin sanoen kun tämä ominaisuus on asetettu arvoon
- true (tosi), sivupohja voi määrittää inline Velocimakroja jotka
- ovat käytettävissä vain sivupohjasta joka ne määritti. Tämän
+ Mahdolliset arvot ovat true tai false, oletuksena false. Tämä
+ ominaisuus päättää ovatko sivupohjassa määritetyt Velocimakrot
+ 'näkyviä' ainoastaan siinä sivupohjassa jossa ne on
+ määritelty. Toisin sanoen kun tämä ominaisuus on asetettu arvoon
+ true (tosi), sivupohja voi määrittää inline Velocimakroja jotka
+ ovat käytettävissä vain sivupohjasta joka ne määritti. Tämän
ominaisuuden avulla voidaan aikaansaada erikoisia vaikutuksia; jos
- yleisesti määritelty Velocimakro kutsuu toista yleisesti
- määriteltyä makroa, tämän ominaisuuden avulla sivupohja voi
- määrittää oman toteutuksensa jälkimmäisestä makrosta, jota
- ensimmäinen makro kutsuu. Sivupohjan paikallista makroa käytetään
- vain kun ensimmäistä makroa kutsutaan ko. sivupohjasta. Uusi makro
+ yleisesti määritelty Velocimakro kutsuu toista yleisesti
+ määriteltyä makroa, tämän ominaisuuden avulla sivupohja voi
+ määrittää oman toteutuksensa jälkimmäisestä makrosta, jota
+ ensimmäinen makro kutsuu. Sivupohjan paikallista makroa käytetään
+ vain kun ensimmäistä makroa kutsutaan ko. sivupohjasta. Uusi makro
ei vaikuta muihin sivupohjiin.
</p>
@@ -1661,41 +1661,41 @@
<code>velocimacro.context.localscope</code> - Mahdolliset arvot
ovat true tai false, oletuksena false. Kun ominaisuuden arvoksi on
asetettu tosi, Velocimakroissa #set() ohjeella tehdyt muutokset
- ovat 'paikallisia' eivätkä vaikuta pysyvästi muuttujien sisältöön.
+ ovat 'paikallisia' eivätkä vaikuta pysyvästi muuttujien sisältöön.
</p>
<p>
- <code>velocimacro.library.autoreload</code> - Tämä ominaisuus
+ <code>velocimacro.library.autoreload</code> - Tämä ominaisuus
ohjaa Velocimakrokirjaston automaattista uudelleenlatausta. Kun
ominaisuus on asetettu arvoon <code>true</code> kutsutun
Velocimakron koodi tutkitaan mahdollisten muutosten varalta, ja se
- ladataan uudelleen mikäli tarpeellista. Näin voit muuttaa ja
- testata Velocimakrokirjastoa ilman että sinun tarvitsee käynnistää
- uudelleen sovellustasi tai sovellusalustaa, aivan kuten voit tehdä
- normaalien sivupohjienkin kanssa. Tämä asetus toimii vain kun
- resurssilataajien välimuisti on pois päältä (<i>off</i>,
- esim. <code>file.resource.loader.cache = false</code>). Tämä
- ominaisuus on tarkoitettu käytettäväksi vain sovelluksen
- kehitysvaiheessa, ei tuotantokäyttöön.
+ ladataan uudelleen mikäli tarpeellista. Näin voit muuttaa ja
+ testata Velocimakrokirjastoa ilman että sinun tarvitsee käynnistää
+ uudelleen sovellustasi tai sovellusalustaa, aivan kuten voit tehdä
+ normaalien sivupohjienkin kanssa. Tämä asetus toimii vain kun
+ resurssilataajien välimuisti on pois päältä (<i>off</i>,
+ esim. <code>file.resource.loader.cache = false</code>). Tämä
+ ominaisuus on tarkoitettu käytettäväksi vain sovelluksen
+ kehitysvaiheessa, ei tuotantokäyttöön.
</p>
<strong>Velocimakro Trivia</strong>
<p>
- Nykyisellään Velocimakrot tulee olla määriteltyinä ennen kuin
- niitä käytetään sivupohjissa. Tämä tarkoittaa sitä että #macro()
- määritystesi tulee sijaita ennen rivejä joissa käytät Velocimakroja.
+ Nykyisellään Velocimakrot tulee olla määriteltyinä ennen kuin
+ niitä käytetään sivupohjissa. Tämä tarkoittaa sitä että #macro()
+ määritystesi tulee sijaita ennen rivejä joissa käytät Velocimakroja.
</p>
<p>
- Tämä on tärkeää muistaa jos yrität käyttää ohjetta #parse()
+ Tämä on tärkeää muistaa jos yrität käyttää ohjetta #parse()
sivupohjaan jossa on inline #macro() ohjeita. Koska #parse()
- suoritetaan ajon aikana, ja parseri päättää ajon aikana onko
- sivupohjassa oleva Velocimakrolta näyttävä elementti Velocimakro,
+ suoritetaan ajon aikana, ja parseri päättää ajon aikana onko
+ sivupohjassa oleva Velocimakrolta näyttävä elementti Velocimakro,
ei Velocimakrojen #parse():aminen toimi niin kuin
- olettaisi. Ongelma voidaan välttää helposti käyttämällä
+ olettaisi. Ongelma voidaan välttää helposti käyttämällä
<code>velocimacro.library</code> toimintoa jonka avulla Velocity
- lataa Velocimakrosi käynnistyksen yhteydessä.
+ lataa Velocimakrosi käynnistyksen yhteydessä.
</p>
</section>
@@ -1706,19 +1706,19 @@
</p>
<source><![CDATA[
-## #include( "a.txt" ) tulostuu <tiedoston a.txt sisältö>
+## #include( "a.txt" ) tulostuu <tiedoston a.txt sisältö>
#include( "a.txt" )
## \#include( "a.txt" ) tulostuu #include( "a.txt" )
\#include( "a.txt" )
-## \\#include ( "a.txt" ) tulostuu \<tiedoston a.txt sisältö>
+## \\#include ( "a.txt" ) tulostuu \<tiedoston a.txt sisältö>
\\#include ( "a.txt" )
]]></source>
<p>
- Eritystä tarkkaavaisuutta tarvitaan tapauksissa joissa suojataan VTL
- ohjeita jotka sisältävät useita skriptielementtejä samassa ohjeessa
+ Eritystä tarkkaavaisuutta tarvitaan tapauksissa joissa suojataan VTL
+ ohjeita jotka sisältävät useita skriptielementtejä samassa ohjeessa
(kuten if-else-end lause). Seuraavassa on tyypillinen VTL if-lause:
</p>
@@ -1736,9 +1736,9 @@
]]></source>
<p>
- Jos <em>$jazz</em> on epätosi (false), tulostetta ei
+ Jos <em>$jazz</em> on epätosi (false), tulostetta ei
tule. Skriptielementtien suojaaminen muuttaa tulostetta. Katso
- seuraavaa esimerkkiä:
+ seuraavaa esimerkkiä:
</p>
<source><![CDATA[
@@ -1748,7 +1748,7 @@
]]></source>
<p>
- Riippumatta siitä onko <em>$jazz</em> tosi vai epätosi, tuloste on
+ Riippumatta siitä onko <em>$jazz</em> tosi vai epätosi, tuloste on
aina:
</p>
@@ -1760,8 +1760,8 @@
<p>
Itse asiassa koska kaikki skriptielementit on suojattu,
- <em>$jazz</em> muuttujan totuusarvoa ei edes tutkita. Oletetaan että
- kenoviiva edeltää skriptielementtejä jotka on suojattu:
+ <em>$jazz</em> muuttujan totuusarvoa ei edes tutkita. Oletetaan että
+ kenoviiva edeltää skriptielementtejä jotka on suojattu:
</p>
<source><![CDATA[
@@ -1771,7 +1771,7 @@
]]></source>
<p>
- Mikäli <em>$jazz</em> on tässä tapauksessa tosi, tuloste on:
+ Mikäli <em>$jazz</em> on tässä tapauksessa tosi, tuloste on:
</p>
<source><![CDATA[
@@ -1780,18 +1780,18 @@
]]></source>
<p>
- Tämän ymmärtämiseksi huomaa, että <code>#if( arg )</code> rivillä
- olevaa rivinvaihtoa (return) ei kopioida tulosteeseen. Tämän vuoksi
+ Tämän ymmärtämiseksi huomaa, että <code>#if( arg )</code> rivillä
+ olevaa rivinvaihtoa (return) ei kopioida tulosteeseen. Tämän vuoksi
<code>#if()</code> lauseen runko ('Vyacheslav Ganelin') on '\\'
- merkinnästä saadun ensimmäisen '\' merkin kanssa samalla
- rivillä. Jälkimmäinen '\' merkki on toisella rivillä kuin teksti,
- koska tekstin lopussa on rivinvaihto ja jälkimmäinen '\\'
- merkinnästä saatu '\' merkki on ennen <code>#end</code> ohjetta,
+ merkinnästä saadun ensimmäisen '\' merkin kanssa samalla
+ rivillä. Jälkimmäinen '\' merkki on toisella rivillä kuin teksti,
+ koska tekstin lopussa on rivinvaihto ja jälkimmäinen '\\'
+ merkinnästä saatu '\' merkki on ennen <code>#end</code> ohjetta,
joten merkki kuuluu edelleen <code>#if()</code> lauseen runkoon.
</p>
<p>
- Jos <em>$jazz</em> on epätosi, tuloste on:
+ Jos <em>$jazz</em> on epätosi, tuloste on:
</p>
<source><![CDATA[
@@ -1799,8 +1799,8 @@
]]></source>
<p>
- Huomaa että
- ongelmia tulee mikäli skriptielementtejä ei ole suojattu oikein.
+ Huomaa että
+ ongelmia tulee mikäli skriptielementtejä ei ole suojattu oikein.
</p>
<source><![CDATA[
@@ -1810,8 +1810,8 @@
]]></source>
<p>
- Esimerkissä <em>#if</em> on suojattu, mutta <em>#end</em> elementti
- on edelleen käytössä. Liian monta lopetuselementtiä sivupohjassa
+ Esimerkissä <em>#if</em> on suojattu, mutta <em>#end</em> elementti
+ on edelleen käytössä. Liian monta lopetuselementtiä sivupohjassa
aiheuttaa virheen sivua luotaessa.
</p>
@@ -1821,8 +1821,8 @@
<p>
- Vaikka tässä ohjeessa oleva VTL on usein muotoiltu rivivaihdoin ja
- välilyönnein, alla oleva VTL
+ Vaikka tässä ohjeessa oleva VTL on usein muotoiltu rivivaihdoin ja
+ välilyönnein, alla oleva VTL
</p>
<source><![CDATA[
@@ -1833,8 +1833,8 @@
]]></source>
<p>
- on yhtä toimiva kuin seuraava kodinpätkä jonka Geir Magnusson
- Jr. lähetti Velocityn käyttäjien postituslistalle:
+ on yhtä toimiva kuin seuraava kodinpätkä jonka Geir Magnusson
+ Jr. lähetti Velocityn käyttäjien postituslistalle:
</p>
<source><![CDATA[
@@ -1842,7 +1842,7 @@
]]></source>
<p>
- Velocity syö ylimääräiset välilyönnit. Edellinen koodinpätkä
+ Velocity syö ylimääräiset välilyönnit. Edellinen koodinpätkä
voitaisiin kirjoittaa seuraavasti:
</p>
@@ -1877,10 +1877,10 @@
<subsection name="Matematiikka" href="Matematiikka">
<p>
- Velocitylla on muutamia sisäänrakennettuja matemaattisia
- funktioita joita voidaan käyttää sivupohjissa <em>#set</em> ohjeen
- kanssa. Seuraavat yhtälöt ovat esimerkkejä yhteen-, vähennys-,
- kerto- sekä jakolaskuista.
+ Velocitylla on muutamia sisäänrakennettuja matemaattisia
+ funktioita joita voidaan käyttää sivupohjissa <em>#set</em> ohjeen
+ kanssa. Seuraavat yhtälöt ovat esimerkkejä yhteen-, vähennys-,
+ kerto- sekä jakolaskuista.
</p>
<source><![CDATA[
@@ -1891,8 +1891,8 @@
]]></source>
<p>
- Jako-operaation tapauksessa tulos on kokonaisluku. Jakojäännös
- saadaan käyttöön jäännösoperandilla (<em>%</em>).
+ Jako-operaation tapauksessa tulos on kokonaisluku. Jakojäännös
+ saadaan käyttöön jäännösoperandilla (<em>%</em>).
</p>
<source><![CDATA[
@@ -1901,8 +1901,8 @@
<p>
- Velocityllä on sisäänrakennettu keino nollalla jakamisen
- käsittelemiseen. Seuraavassa esimerkissä:
+ Velocityllä on sisäänrakennettu keino nollalla jakamisen
+ käsittelemiseen. Seuraavassa esimerkissä:
</p>
<source><![CDATA[
@@ -1914,7 +1914,7 @@
<p>
Viittaukseen <em>$uhoh</em> asetetaan tulos operaatiosta viisi
- jaettuna nollalla. Kun Velocity näyttää tämän sivupohjan, tuloste
+ jaettuna nollalla. Kun Velocity näyttää tämän sivupohjan, tuloste
on:
</p>
@@ -1923,10 +1923,10 @@
]]></source>
<p>
- Suunnittelijoiden on otettava huomioon myös, että <em>#set</em>
+ Suunnittelijoiden on otettava huomioon myös, että <em>#set</em>
tuottaa merkkijonoja, jotka on muunnettava kokonaisluvuiksi jotta
- niitä voidaan käyttää vaihteluväliä määritettäessä (range
- operator). Seuraavassa esimerkki tällaisesta muunnoksesta:
+ niitä voidaan käyttää vaihteluväliä määritettäessä (range
+ operator). Seuraavassa esimerkki tällaisesta muunnoksesta:
</p>
<source><![CDATA[
@@ -1941,12 +1941,12 @@
</subsection>
[... 369 lines stripped ...]
---------------------------------------------------------------------
To unsubscribe, e-mail: velocity-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: velocity-dev-help@jakarta.apache.org