cvs: phpdoc-lt /language basic-syntax.xml

--shivas1041608518
Content-Type: text/plain

shivas		Fri Jan  3 10:41:58 2003 EDT

  Added files:                 
    /phpdoc-lt/language	basic-syntax.xml 
  Log:
  no message
  
--shivas1041608518
Content-Type: text/plain
Content-Disposition: attachment; filename="shivas-20030103104158.txt"


Index: phpdoc-lt/language/basic-syntax.xml
+++ phpdoc-lt/language/basic-syntax.xml
<?xml version="1.0" encoding="Windows-1257"?>
<!-- $Revision: 1.1 $ -->
<chapter id="language.basic-syntax">
	<title>Basic syntax</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>Atskyrimas nuo HTML</title>
		<para>
    Kai PHP transliuoja bylà, jis tiesiog seka tekstà ið failo kol suranda specialius tagus kurie nurodo jam, 
    kad reikia teksta interpretuoti kaip koda. Tuomet interpretatorius ávykdo visà kodà kuri jis randa uþdaranti PHP tagà, kuris pasako kad vël prasidëjo paprastas tekstas.
    Toks mechanizmas leidþia Jums áterpti PHP kodà á HTML turiná: viskas kas yra PHP tagø iðorëje paliekama nepaliesta, viskas kas viduje traktuojama kaip kodas.
   </para>
		<para>
    Ið viso yra keturi tagø rinkiniai kurie leidþia iðskirti PHP kodo blokus.
   Ið jø tik du (&lt;?php. . .?&gt; ir &lt;script
    language="php"&gt;. . .&lt;/script&gt;) yra visuomet prieinami; kiti gali bûti ájungti arba iðjungti 
    &php.ini; konfiguracinëje byloje. Trumpo formato PHP tagai ir ASP tagai gali bûti tinkami, taèiau jie nëra tokie patogûs kaip ilgesnës formos.
    Taip pat jei Jûs norësite átraukti PHP kodà á XML ar XHTML, Jûs turësite naudoti
    &lt;?php. . .?&gt; formatà kad jis nesipainiotu su XML.
   </para>
		<para>
    Tagai palaikomi PHP yra:
   </para>
		<para>
			<example>
				<title>Atskirimo nuo HTML bûdai</title>
				<programlisting role="php"><![CDATA[
1.  <?php echo("jei Jûs norite aptarnauti XHTML arba XML dokumentus, darykite taip kaip èia\n"); ?>

2.  <? echo ("èia paprasèiausias, atskirimo bûdas\n"); ?>
    <?= reiðkinys ?> Tai yra trumpinys nuo "<? echo reiðkinys ?>"
    
3.  <script language="php">
        echo ("kai kurie redaktoriai (kaip FrontPage) nemëgsta standartinio atskyrimo");
    </script>

4.  <% echo ("Taip pat galite naudoti ASP-stiliaus tagus"); %>
    <%= $kintamasis; # Trumpinys nuo "<% echo . . ." %>
]]></programlisting>
			</example>
		</para>
		<para>
    Pirmasis bûdas, &lt;?php. . .?&gt;, yra priimtinesnis, nes jis leidþia naudoti tai XML-suderinamuose koduose kaip XHTML.
   </para>
		<para>
    Antrasis bûdas ne visuomet yra palaikomas. Trumpo formato PHP tagai palaikomi tik tuomet kai jie yra ájungti
    Tai gali bûti atlikta 
    <function>short_tags</function> funkcijos (tik PHP 3) pagalba, ájungiant <link linkend="ini.short-open-tag">short_open_tag</link>
    konfiguraciná nustatyma PHP konfiguracinëje byloje, arba kompiliuojant PHP
    su --enable-short-tags raktu
    <command>configure</command>. Nors jis pagal nutylëjimà yra ájungtas 
    php.ini-dist, naudojimas yra neskatinamas.
   </para>
		<para>
    Ketvirtas bûdas priimtinas tik tuo atveju jei ASP-stiliaus tagai yra ájungti naudojant <link linkend="ini.asp-tags">asp_tags</link>
    konfiguraciná nustatymà.

    <note>
				<para>ASP-stiliaus tagø palaikymas yra nuo 3.0.4.</para>
			</note>
		</para>
		<note>
			<para>
	Trumpo formato tagø turëtø bûti vengiama kai kuriamos aplikacijos arba bibliotekos kurios bus publikuojamos, arba talpinamos á serverius kuriuos valdote ne Jûs, kadangi trumpo formato tagai gali bûti nepalaikomi duotame serveryje.
     Visuomet stenkites nenaudoti trumpo formato tagø.
    </para>
		</note>
		<para>
	Uþdarantysis tagas visuomet paskui save turi naujos eilutës kodà, taip
	 pat uþdarantysis tagas automatiðkai priskiria kabliataðká;
	 Jums nebûtinas kabliataðkis paskutinëje PHP bloko eilutëje.
   </para>
		<para>
    PHP leidþia naudoti tokias struktûras:
    <example>
				<title>Sudëtingesnis iðskyrimas</title>
				<programlisting role="php"><![CDATA[
<?php
if ($reiðkinys) { 
    ?>
    <strong>Tai yra teisinga.</strong>
    <?php 
} else { 
    ?>
    <strong>Tai neteisinga.</strong>
    <?php 
}
?>
]]></programlisting>
			</example>
	Tai veikia taip tikimasi, kadangi PHP suranda ?&gt; uþdarantájá
    tagà, spausdinà viskà kas seka po jo kaip tekstà, kol vël randa atidarantá tagà.
    Kaip pavyzdys, jei Jûs norite iðspausdinti didelá blokà teksto yra labai patogu iðvengti PHP transliavimo proceso, 
    nes tai yra kur kas efektyviau nei viskà iðspausdinti 
    <function>echo</function> arba
    <function>print</function> arba panaðiø funkcijø pagalba.
   </para>
	</sect1>
	<sect1 id="language.basic-syntax.instruction-separation">
		<title>Instrukcijø atskirimas</title>
		<simpara>
    Instrukcijos yra atskiriamos taip pat kaip C arba Perl - kiekviena instrukcija nutraukiama kabliataðkio pagalba.</simpara>
		<para>
    Uþdarantysis tagas (?&gt;) taip pat reiðkia instrukcijos pabaiga, todël sekantis pavyzdys yra ádentiðkas:
    <informalexample>
				<programlisting role="php"><![CDATA[
<?php
    echo "Tai yra pavyzdys";
?>

<?php echo "Tai yra pavyzdys" ?>
]]></programlisting>
			</informalexample>
		</para>
	</sect1>
	<sect1 id="language.basic-syntax.comments">
		<title>Komentarai</title>
		<para>
    PHP palaiko 'C', 'C++' ir Unix apvalkalo-stiliaus komentarus. Pavyzdys:

    <informalexample>
				<programlisting role="php"><![CDATA[
<?php
    echo "Tai yra testas"; // Tai vienos eilutës c++ stiliaus komentaras
    /* Tai keliø eiluèiø komentaras
       dar viena komentaro eilutë */
    echo "Èia kitas testas";
    echo "O èia paskutinis testas"; # Tai yra apvalkalo-stiliaus stiliaus komentaras
?>
]]></programlisting>
			</informalexample>
		</para>
		<simpara>
	Vienos eilutës komentarai uþkomentuojà iki eilutës pabaigos arba iki einamojo PHP kodo bloko pabaigos, priklausomai kuris aptinkamas pirmas.
   </simpara>
		<informalexample>
			<programlisting role="php"><![CDATA[
<h1>Tai yra <?php # echo "paprastas";?> pavyzdys.</h1>
<p>Aukðèiau esanti antraðtë atspausdins 'Tai yra paprastas pavyzdys.'.
]]></programlisting>
		</informalexample>
		<simpara>
    Jus turëtumëte vengti áterpinëti 'C' stiliaus komentarus, kurie gali atsirasti kai kuomentuojamas didelis blokas.
   </simpara>
		<informalexample>
			<programlisting role="php"><![CDATA[
<?php
 /* 
    echo "Tai yra testas"; /* Ðis komentaras sukels problemø */
 */
?>
]]></programlisting>
		</informalexample>
		<simpara>
    Vienos eilutës komentarø stilius daþniausiai komentuoja iki eilutës pabaigos arba iki einamojo PHP bloko pabaigos, priklausomai kuris aptinkamas pirmas.
    Tai reiðkia kad HTML kodas po // ?> BUS atspausdintas: ?> iðjungia PHP reþimà ir gráþta á HTML reþimà, ir // negali to paveikti.
   </simpara>
	</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
-->

--shivas1041608518--