cvs: phpdoc /fi/language basic-syntax.xml
| From: | Henry Karpatskij | Date: | Thu, 28 Mar 2002 04:05:49 +0000 |
| Subject: | cvs: phpdoc /fi/language basic-syntax.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969343653@lists.php.net to get a copy of this message | ||
spheroid Wed Mar 27 23:05:49 2002 EDT
Added files:
/phpdoc/fi/language basic-syntax.xml
Log:
Added translated basic-syntax.xml.. Request for comments :)
Index: phpdoc/fi/language/basic-syntax.xml +++ phpdoc/fi/language/basic-syntax.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <chapter id="language.basic-syntax"> <title>Syntaksi</title> <!-- NOTE: Last modified: 2001-05-16 13:00 GMT the language part is currently under heavy revision. Please do not not make any heavy (i.e. structural) modifications to this part for a moment. You'd also better not start any translation yet. Comments are always welcome at phpdoc@lists.php.net Progress: intro : DOESN'T EXIST - yet? new chapter, with some introductionary remarks? Will be discussed on the ML soon. basic-syntax: FINISHED except maybe moving the 'advanced escaping' to a better place? TODO: - nada types : Being revised. Added all new types Boolean and Integer are more or less finished. The rest isn't. TODO: - why is $foo[bar] bad syntax? - what's the difference between unset($bla) and $bla = NULL; (it is different!) - $obj->{expr} syntax - (unset) cast????? - $bla = unset <== should've been nuked, don't mention it - $str{offset} syntax, rather than $str[offset] - read notes and apply when any of them are useful - remove notes which have been included here. - ... the rest: Not yet started with. TODO: - ? oop : has been revised by Kristian, DONE. --> <sect1 id="language.basic-syntax.phpmode"> <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. </para> <para> On olemassa neljä tagiparia, joita voidaan käyttää PHP-koodin erottelemiseen. Näistä kaksi (<?php. . .?> ja <script language="php">. . .</script>) 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 <?php. . .?> muotoa, jotta mukauduttaisiin XML:ään. </para> <para> PHP:n tukemat tagit ovat: </para> <para> <example> <title>Tapoja erotella koodi HTML:stä</title> <programlisting role="php"> <![CDATA[ 1. <? echo ("tämä on yksinkertaisin SGML-merkintätapa\n"); ?> <?= lauseke ?> Tämä on helpompi tapa ilmaista "<? echo lauseke ?>" 2. <?php echo("XHTML- ja XML-dokumenttien kanssa voidaan käyttää seuraavaa menetelmää\n"); ?> 3. <script language="php"> echo ("jotkut editorit (kuten FrontPage) eivät pidä tällaisesta merkintätavasta"); </script> 4. <% echo ("ASP-tagejä voidaan myös vaihtoehtoisesti käyttää"); %> <%= $muuttuja; # Tämä on helpompi tapa ilmaista "<% echo . . ." %> ]]> </programlisting> </example> </para> <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. </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. </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. <note> <para>ASP-tyylisten tagien tuki on lisätty versiossa 3.0.4.</para> </note> </para> <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ä. </para> <para> PHP mahdollistaa seuraavanlaisten rakenteiden käytön: <example><title>Kehittyneempää erottelemista</title> <programlisting role="php"> <![CDATA[ <?php if ($lauseke) { ?> <strong>Tämä on tosi</strong> <?php } else { ?> <strong>Tämä on epätosi.</strong> <?php } ?> ]]> </programlisting> </example> Tämä toimii oletetulla tavalla, koska PHP yksinkertaisesti tulostaa kaiken lopetustagin ?> 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. </para> </sect1> <sect1 id="language.basic-syntax.instruction-separation"> <title>Lausekkeiden erottelu</title> <simpara> Lausekkeet erotellaan samalla tavalla kuten C:ssä tai Perlissä - jokainen lauseke päätetään puolipisteeseen.</simpara> <para> Lopetustagi (?>) lopettaa myös lausekkeen, joten seuraavilla lausekkeilla on täysin sama merkitys: <informalexample> <programlisting role="php"> <![CDATA[ <?php echo "Tämä on koe"; ?> <?php echo "Tämä on koe" ?> ]]> </programlisting> </informalexample> </para> </sect1> <sect1 id="language.basic-syntax.comments"> <title>Kommentointi</title> <para> PHP tukee 'C', 'C++' ja Unix shell-tyylisiä kommentointitapoja. Esimerkiksi: <informalexample> <programlisting role="php"> <![CDATA[ <?php echo "Tämä on koe"; // Tämä on yksirivinen C++-tyylinen kommentti /* Tämä on monirivinen kommentti ja tässä vielä yksi kommentti */ echo "Tämä on toinen koe"; echo "Vielä viimeinen koe"; # Tämä on Unix shell-tyylinen kommentti ?> ]]> </programlisting> </informalexample> </para> <simpara> "Yksiriviset" kommentointityylit tosiasiassa kommentoivat ainoastaan rivin tai PHP-lohkon loppuun, kumpi ensin sattuu tulemaan. </simpara> <informalexample> <programlisting role="php"> <![CDATA[ <h1>Tämä on <?php # echo "yksinkertainen";?> esimerkki.</h1> <p>Ylläoleva otsikko tulostaa ruudulle 'Tämä on esimerkki'. ]]> </programlisting> </informalexample> <simpara> Kannattaa olla tarkkana, että koodiin ei synny sisäkkäisiä 'C'-tyylisiä kommentteja. Näin voi käydä kommentoidessa ulos isompia koodinpätkiä. </simpara> <informalexample> <programlisting role="php"> <![CDATA[ <?php /* echo "Tämä on testi"; /* Tämä kommentti tulee aiheuttamaan virheen */ */ ?> ]]> </programlisting> </informalexample> </sect1> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
Index: phpdoc/fi/language/basic-syntax.xml +++ phpdoc/fi/language/basic-syntax.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <chapter id="language.basic-syntax"> <title>Syntaksi</title> <!-- NOTE: Last modified: 2001-05-16 13:00 GMT the language part is currently under heavy revision. Please do not not make any heavy (i.e. structural) modifications to this part for a moment. You'd also better not start any translation yet. Comments are always welcome at phpdoc@lists.php.net Progress: intro : DOESN'T EXIST - yet? new chapter, with some introductionary remarks? Will be discussed on the ML soon. basic-syntax: FINISHED except maybe moving the 'advanced escaping' to a better place? TODO: - nada types : Being revised. Added all new types Boolean and Integer are more or less finished. The rest isn't. TODO: - why is $foo[bar] bad syntax? - what's the difference between unset($bla) and $bla = NULL; (it is different!) - $obj->{expr} syntax - (unset) cast????? - $bla = unset <== should've been nuked, don't mention it - $str{offset} syntax, rather than $str[offset] - read notes and apply when any of them are useful - remove notes which have been included here. - ... the rest: Not yet started with. TODO: - ? oop : has been revised by Kristian, DONE. --> <sect1 id="language.basic-syntax.phpmode"> <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. </para> <para> On olemassa neljä tagiparia, joita voidaan käyttää PHP-koodin erottelemiseen. Näistä kaksi (<?php. . .?> ja <script language="php">. . .</script>) 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 <?php. . .?> muotoa, jotta mukauduttaisiin XML:ään. </para> <para> PHP:n tukemat tagit ovat: </para> <para> <example> <title>Tapoja erotella koodi HTML:stä</title> <programlisting role="php"> <![CDATA[ 1. <? echo ("tämä on yksinkertaisin SGML-merkintätapa\n"); ?> <?= lauseke ?> Tämä on helpompi tapa ilmaista "<? echo lauseke ?>" 2. <?php echo("XHTML- ja XML-dokumenttien kanssa voidaan käyttää seuraavaa menetelmää\n"); ?> 3. <script language="php"> echo ("jotkut editorit (kuten FrontPage) eivät pidä tällaisesta merkintätavasta"); </script> 4. <% echo ("ASP-tagejä voidaan myös vaihtoehtoisesti käyttää"); %> <%= $muuttuja; # Tämä on helpompi tapa ilmaista "<% echo . . ." %> ]]> </programlisting> </example> </para> <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. </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. </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. <note> <para>ASP-tyylisten tagien tuki on lisätty versiossa 3.0.4.</para> </note> </para> <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ä. </para> <para> PHP mahdollistaa seuraavanlaisten rakenteiden käytön: <example><title>Kehittyneempää erottelemista</title> <programlisting role="php"> <![CDATA[ <?php if ($lauseke) { ?> <strong>Tämä on tosi</strong> <?php } else { ?> <strong>Tämä on epätosi.</strong> <?php } ?> ]]> </programlisting> </example> Tämä toimii oletetulla tavalla, koska PHP yksinkertaisesti tulostaa kaiken lopetustagin ?> 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. </para> </sect1> <sect1 id="language.basic-syntax.instruction-separation"> <title>Lausekkeiden erottelu</title> <simpara> Lausekkeet erotellaan samalla tavalla kuten C:ssä tai Perlissä - jokainen lauseke päätetään puolipisteeseen.</simpara> <para> Lopetustagi (?>) lopettaa myös lausekkeen, joten seuraavilla lausekkeilla on täysin sama merkitys: <informalexample> <programlisting role="php"> <![CDATA[ <?php echo "Tämä on koe"; ?> <?php echo "Tämä on koe" ?> ]]> </programlisting> </informalexample> </para> </sect1> <sect1 id="language.basic-syntax.comments"> <title>Kommentointi</title> <para> PHP tukee 'C', 'C++' ja Unix shell-tyylisiä kommentointitapoja. Esimerkiksi: <informalexample> <programlisting role="php"> <![CDATA[ <?php echo "Tämä on koe"; // Tämä on yksirivinen C++-tyylinen kommentti /* Tämä on monirivinen kommentti ja tässä vielä yksi kommentti */ echo "Tämä on toinen koe"; echo "Vielä viimeinen koe"; # Tämä on Unix shell-tyylinen kommentti ?> ]]> </programlisting> </informalexample> </para> <simpara> "Yksiriviset" kommentointityylit tosiasiassa kommentoivat ainoastaan rivin tai PHP-lohkon loppuun, kumpi ensin sattuu tulemaan. </simpara> <informalexample> <programlisting role="php"> <![CDATA[ <h1>Tämä on <?php # echo "yksinkertainen";?> esimerkki.</h1> <p>Ylläoleva otsikko tulostaa ruudulle 'Tämä on esimerkki'. ]]> </programlisting> </informalexample> <simpara> Kannattaa olla tarkkana, että koodiin ei synny sisäkkäisiä 'C'-tyylisiä kommentteja. Näin voi käydä kommentoidessa ulos isompia koodinpätkiä. </simpara> <informalexample> <programlisting role="php"> <![CDATA[ <?php /* echo "Tämä on testi"; /* Tämä kommentti tulee aiheuttamaan virheen */ */ ?> ]]> </programlisting> </informalexample> </sect1> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->