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 [EMAIL PROTECTED]
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
-->
