cvs: phpdoc /fi translation.xml /fi/language basic-syntax.xml

sniper Thu Mar 28 06:09:49 2002 EDT Modified files: /phpdoc/fi translation.xml /phpdoc/fi/language basic-syntax.xml Log: - tabs to spaces - try to keep lines under 80 chars - added revision comment - fixed some grammar - removed from work-in-progress (ready) Index: phpdoc/fi/translation.xml diff -u phpdoc/fi/translation.xml:1.3 phpdoc/fi/translation.xml:1.4 --- phpdoc/fi/translation.xml:1.3 Wed Mar 27 19:39:22 2002 +++ phpdoc/fi/translation.xml Thu Mar 28 06:09:49 2002 @@ -13,7 +13,6 @@ </translators> <work-in-progress> - <file name="language/basic-syntax.xml" person="spheroid" type="working" /> </work-in-progress> </translation> Index: phpdoc/fi/language/basic-syntax.xml diff -u phpdoc/fi/language/basic-syntax.xml:1.1 phpdoc/fi/language/basic-syntax.xml:1.2 --- phpdoc/fi/language/basic-syntax.xml:1.1 Wed Mar 27 23:05:48 2002 +++ phpdoc/fi/language/basic-syntax.xml Thu Mar 28 06:09:49 2002 @@ -1,5 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.26 Maintainer: spheroid Status: ready --> + <chapter id="language.basic-syntax"> <title>Syntaksi</title> @@ -50,11 +52,24 @@ <title>Escaping from HTML</title> <para> - Jäsentäessään tiedostoa PHP yksinkertaisesti ohittaa kaiken sisällön siihen asti, kunnes se löytää erityisen aloitustagin, joka kertoo jäsentimelle aloittaa koodin PHP-tulkkaus. Sitten tulkki suorittaa kaiken koodin jonka löytää, aina PHP-lopputagiin asti. Tämän jälkeen tulkki aloittaa tekstin ohittamisen uudelleen. Tämä mekanismi antaa mahdollisuuden lisätä PHP-koodia HTML:n sisään: kaikki PHP-tagin ulkopuolella jätetään täysin rauhaan, kun taas kaikki muu tulkataan PHP-koodina. + Jäsentäessään tiedostoa PHP yksinkertaisesti ohittaa kaiken sisällön siihen + asti, kunnes se löytää erityisen aloitustagin, joka kertoo jäsentimelle + aloittaa koodin PHP-tulkkaus. Sitten tulkki suorittaa kaiken koodin jonka + löytää, aina PHP-lopputagiin asti. Tämän jälkeen tulkki aloittaa tekstin + ohittamisen uudelleen. Tämä mekanismi antaa mahdollisuuden lisätä + PHP-koodia HTML:n sisään: kaikki PHP-tagin ulkopuolella jätetään täysin + rauhaan, kun taas kaikki muu tulkataan PHP-koodina. </para> <para> - On olemassa neljä tagiparia, joita voidaan käyttää PHP-koodin erottelemiseen. Näistä kaksi (&lt;?php. . .?&gt; ja &lt;script language="php"&gt;. . .&lt;/script&gt;) ovat aina käytettävissä; muut voidaan ottaa käyttöön tai pois käytöstä <filename>php.ini</filename> asetustiedostossa. Vaikka lyhyempimuotoiset ja ASP-tyyliset tagit voivat olla käteviä, ne eivät ole niin siirrettäviä, kuin pidemmät versiot. Myös, jos aikomuksena on sisällyttää PHP-koodia XML- tai XHTML-dokumenteissa, joudutaan käyttämään &lt;?php. . .?&gt; muotoa, jotta mukauduttaisiin XML:ään. + PHP:ssa on neljä tagiparia, joita voidaan käyttää koodin erottelemiseen. + Näistä kaksi (&lt;?php. . .?&gt; ja &lt;script language="php"&gt;. . .&lt;/script&gt;) + toimivat aina; muut voidaan ottaa käyttöön tai pois käytöstä + <filename>php.ini</filename> asetustiedostossa. Vaikka lyhyempimuotoiset + ja ASP-tyyliset tagit voivat olla käteviä, niitä tulisi välttää varsinkin + jos haluaa koodinsa toimivan asetuksista riippumatta. + Jos aikomuksena on sisällyttää PHP-koodia XML- tai XHTML-dokumenteissa, + täytyy käyttää &lt;?php. . .?&gt; muotoa. </para> <para> @@ -84,24 +99,24 @@ <para> Ensimmäinen vaihtoehto on käytettävissä ainoastaan, jos lyhyet - tagit ovat sallittu. Ne voidaan sallia funktion - <function>short_tags</function> avulla (PHP3 ainoastaan), - muuttamalla <link linkend="ini.short-open-tag"> - short_open_tag</link> asetusta PHP:n konfiguraatiotiedostossa, - tai kääntämällä PHP --enable-short-tags -parametrillä - <command>configure</command> komennon kanssa. + tagit ovat sallittu. Ne voidaan sallia funktion + <function>short_tags</function> avulla (PHP3 ainoastaan), + muuttamalla <link linkend="ini.short-open-tag"> + short_open_tag</link> asetusta PHP:n konfiguraatiotiedostossa, + tai kääntämällä PHP --enable-short-tags -parametrillä + <command>configure</command> komennon kanssa. </para> <para> Huomautettakoon, että toisena listattu merkintätapa on yleisesti - suositeltu, koska se mahdollistaa PHP:n käytön XML:ää - noudattavan koodin, kuten XHTML:n kanssa. + suositeltu, koska se mahdollistaa PHP:n käytön XML:ää + noudattavan koodin, kuten XHTML:n kanssa. </para> <para> Neljäs vaihtoehto on käytettävissä ainoastaan, jos ASP-tyyliset - tagit ovat sallittu konfiguraatiotiedoston <link - linkend="ini.asp-tags">asp_tags</link> asetuksella. + tagit ovat sallittu konfiguraatiotiedoston <link + linkend="ini.asp-tags">asp_tags</link> asetuksella. <note> <para>ASP-tyylisten tagien tuki on lisätty versiossa 3.0.4.</para> @@ -110,11 +125,11 @@ <para> Lohkon lopetustagi sisältää heti seuraavana tulevan rivinvaihdoin, - mikäli sellainen vain on. Näin ollen tarvitaan kaksi rivinvaihtoa, - jos lopulliseen tulosteeseen halutaan rivinvaihto lopetustagin - jälkeen. Lopetustagi myös sisältää puolipisteen; PHP-lohkon - viimeisellä rivillä ei näin ollen tarvitse olla rivin lopettavaa - puolipistettä. + mikäli sellainen vain on. Näin ollen tarvitaan kaksi rivinvaihtoa, + jos lopulliseen tulosteeseen halutaan rivinvaihto lopetustagin + jälkeen. Lopetustagi sisältää myös puolipisteen; PHP-lohkon + viimeisellä rivillä ei näin ollen tarvitse olla rivin lopettavaa + puolipistettä. </para> <para> @@ -137,12 +152,10 @@ </programlisting> </example> Tämä toimii oletetulla tavalla, koska PHP yksinkertaisesti - tulostaa kaiken lopetustagin ?&gt; jälkeisen sisällön, kunnes - löytää uuden aloitustagin. Tämä esimerkki on tietenkin - teennäinen, mutta suurempien tekstimäärien tulostamiseen - tehokkaampi tapa on lopettaa PHP:n jäsentäminen, kuin tulostaa - ne <function>echo</function>, <function>print</function> tai - muun vastaavan menetelmän avulla. + tulostaa kaiken lopetustagin ?&gt; jälkeisen sisällön, kunnes + löytää uuden aloitustagin. Suurempien tekstimäärien tulostamiseen + tämä on tehokkaampi tapa kuin tulostaa <function>echo</function>, + <function>print</function> tai muilla vastaavilla menetelmillä. </para> </sect1> @@ -151,10 +164,11 @@ <simpara> Lausekkeet erotellaan samalla tavalla kuten C:ssä tai Perlissä - - jokainen lauseke päätetään puolipisteeseen.</simpara> + - jokainen lauseke päätetään puolipisteeseen.</simpara> <para> - Lopetustagi (?&gt;) lopettaa myös lausekkeen, joten seuraavilla lausekkeilla on täysin sama merkitys: + Lopetustagi (?&gt;) lopettaa myös lausekkeen, joten seuraavilla lausekkeilla + on täysin sama merkitys: <informalexample> <programlisting role="php"> @@ -193,8 +207,8 @@ <simpara> "Yksiriviset" kommentointityylit tosiasiassa kommentoivat - ainoastaan rivin tai PHP-lohkon loppuun, kumpi ensin sattuu - tulemaan. + ainoastaan rivin tai PHP-lohkon loppuun, kumpi ensin sattuu + tulemaan. </simpara> <informalexample> <programlisting role="php"> @@ -207,8 +221,8 @@ <simpara> Kannattaa olla tarkkana, että koodiin ei synny sisäkkäisiä - 'C'-tyylisiä kommentteja. Näin voi käydä kommentoidessa - ulos isompia koodinpätkiä. + 'C'-tyylisiä kommentteja. Näin voi käydä kommentoitaessa + pidempiä koodinpätkiä. </simpara> <informalexample>