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

From: Date: Tue, 04 Jun 2002 15:18:27 +0000
Subject: cvs: phpdoc-es /language basic-syntax.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969346183@lists.php.net to get a copy of this message
rafael Tue Jun 4 11:18:27 2002 EDT Modified files: /phpdoc-es/language basic-syntax.xml Log: Translation updated to PHP 4.x

Index: phpdoc-es/language/basic-syntax.xml diff -u phpdoc-es/language/basic-syntax.xml:1.4 phpdoc-es/language/basic-syntax.xml:1.5 --- phpdoc-es/language/basic-syntax.xml:1.4 Wed Dec 12 15:48:35 2001 +++ phpdoc-es/language/basic-syntax.xml Tue Jun 4 11:18:26 2002 @@ -1,126 +1,276 @@ <?xml version="1.0" encoding="iso-8859-1"?> - <chapter id="language.basic-syntax"> - <title>Sintaxis b&aacute;sica</title> - - <sect1 id="language.basic-syntax.phpmode"> - <title>Saliendo de HTML</title> - - <para> - Hay cuatro formas de salir de HTML y entrar en el "modo de c&oacute;digo - PHP":</para> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.33 Maintainer: pedroc Status: ready --> + <chapter id="language.basic-syntax"> + <title>S&iacute;ntaxis b&aacute;sica</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>Saliendo de HTML</title> + + <para> + Para interpretar un archivo, php s&iacute;mplemente interpreta el texto + del archivo hasta que encuentra uno de los car&aacute;cteres especiales + que delimitan el inicio de c&oacute;digo PHP. El int&eacute;rprete ejecuta + entonces todo el c&oacute;digo que encuentra, hasta que encuentra una etiqueta + de fin de c&oacute;digo, que le dice al int&eacute;rprete que siga ignorando el c&oacute;digo + siguiente. Este mecanismo permite embeber c&oacute;digo PHP dentro de HTML: todo lo que está + fuera de las etiquetas PHP se deja tal como está, mientras que el resto se interpreta + como c&oacute;digo. + </para> + + <para> + Hay cuatro conjuntos de etiquetas que pueden ser usadas para denotar + bloques de c&oacute;digo PHP. De estas cuatro, s&oacute;lo 2 (&lt;?php. . .?&gt; y + &lt;script language="php"&gt;. . .&lt;/script&gt;) están siempre disponibles; + el resto pueden ser configuradas en el fichero de &php.ini; para ser + o no aceptadas por el int&eacute;rprete. Mientras que el formato corto de etiquetas (short-form tags) y + el estilo ASP (ASP-style tags) pueden ser convenientes, no son portables + como la versi&oacute;n de formato largo de etiquetas. Además, si se pretende + embeber c&oacute;digo PHP en XML o XHTML, será obligatorio el uso del formato + &lt;?php. . .?&gt; para la compatibilidad con XML. + </para> + + <para> + Las etiquetas soportadas por PHP son: + </para> <para> <example> - <title>Formas de salir de HTML</title> - <programlisting> -1. &lt;? echo ("esta es la m&aacute;s simple, una instrucci&oacute;n de procesado SGML\n"); ?> - -2. &lt;?php echo("si quiere servir documentos XML, haga esto\n"); ?> - -3. &lt;script language="php"> - echo ("a algunos editores (como FrontPage) no les - gustan las intrucciones de procesado"); - &lt;/script> - -4. &lt;% echo ("Puedes tambi&eacute;n usar etiquetas tipo ASP"); %> - &lt;%= $variable; # Esto es una forma abreviada de "&lt;%echo .." %> + <title>Formas de escapar de HTML</title> + <programlisting role="php"> +<![CDATA[ +1. <?php echo("si quieres servir documentos XHTML o XML, haz como aqu&iacute;\n"); ?> + +2. <? echo ("esta es la más simple, una instrucci&oacute;n de procesado SGML \n"); ?> + <?= expression ?> Esto es una abreviatura de "<? echo expression ?>" + +3. <script language="php"> + echo ("muchos editores (como FrontPage) no + aceptan instrucciones de procesado"); + </script> + +4. <% echo ("Opcionalmente, puedes usar las etiquetas ASP"); %> + <%= $variable; # Esto es una abreviatura de "<% echo . . ." %> +]]> </programlisting> - </example></para> - - <para> - La primera forma s&oacute;lo est&aacute; disponible si se han habilitado las - etiquetas cortas. Esto se puede hacer a trav&eacute;s de la funci&oacute;n <function>short_tags</function>, - habilitando la opci&oacute;n de configuraci&oacute;n <link linkend="ini.short-open-tag">short_open_tag</link> - en el archivo de configuraci&oacute;n de PHP, o compilando PHP con la - opci&oacute;n --enable-short-tags en <command>configure</command>.</para> - - <para> - La cuarta manera est&aacute; disponible s&oacute;lo si se han habilitado las - etiquetas tipo ASP usando la opci&oacute;n de configuraci&oacute;n - <link linkend="ini.asp-tags">asp_tags</link>. + </example> + </para> + <para> + El m&eacute;todo primero, &lt;?php. . .?&gt;, es el más conveniente, ya que + permite el uso de PHP en c&oacute;digo XML como XHTML. + </para> + + <para> + El m&eacute;todo segundo no siempre está disponible. El formato corto + de etiquetas está disponible con la funci&oacute;n <function>short_tags</function> + (s&oacute;lo PHP 3), activando el parámetro del fichero de configuraci&oacute;n de PHP + <link linkend="ini.short-open-tag">short_open_tag</link>, o compilando + PHP con la opci&oacute;n --enable-short-tags del comando <command>configure</command>. + Aunque est&eacute; activa por defecto en php.ini-dist, se desaconseja + el uso del formato de etiquetas corto. + </para> + + <para> + El m&eacute;todo cuarto s&oacute;lo está disponible si se han activado las + etiquetas ASP en el fichero de configuraci&oacute;n: <link linkend="ini.asp-tags">asp_tags</link>. <note> - <para>El soporte para las etiquetas tipo ASP se a&ntilde;adi&oacute; en 3.0.4.</para> - </note></para> + <para>El soporte de etiquetas ASP se añadi&oacute; en la versi&oacute;n 3.0.4.</para> + </note> + </para> + <note> <para> - La etiqueta de cierre de un bloque incluir&aacute; el car&aacute;cter de - nueva l&iacute;nea final si hay uno presente.</para></sect1> - - <sect1 id="language.basic-syntax.instruction-separation"> - <title>Separaci&oacute;n de instrucciones</title> - - <simpara> - Las instrucciones se separan igual que en C o perl - terminando - cada sentencia con un punto y coma.</simpara> + No se debe usar el formato corto de etiquetas cuando se desarrollen + aplicaciones o librer&iacute;as con intenci&oacute;n de redistribuirlas, o cuando + se desarrolle para servidores que no están bajo nuestro control, porque + puede ser que el formato corto de etiquetas no est&eacute; soportado en el + servidor. Para generar c&oacute;digo portable y redistribu&iacute;ble, aseg&uacute;rate de no + usar el formato corto de etiquetas. + </para> + </note> + + <para> + La etiqueta de fin de bloque incluirá tras ella la siguiente + l&iacute;nea si hay alguna presente. Además, la etiqueta de fin de bloque + lleva impl&iacute;cito el punto y coma; no necesitas por lo tanto añadir + el punto y coma final de la &uacute;ltima l&iacute;nea del bloque PHP. + </para> <para> - La etiqueta de cierre (?&gt;) tambi&eacute;n implica el fin de la sentencia, as&iacute; - lo siguiente es equivalente: - - <informalexample> - <programlisting> -&lt;?php - echo "Esto es una prueba"; + PHP permite estructurar bloques como: + <example><title>M&eacute;todos avanzados de escape</title> + <programlisting role="php"> +<![CDATA[ +<?php +if ($expression) { + ?> + <strong>This is true.</strong> + <?php +} else { + ?> + <strong>This is false.</strong> + <?php +} +?> +]]> + </programlisting> + </example> + Este ejemplo realiza lo esperado, ya que cuando PHP encuentra las etiquetas + ?&gt; de fin de bloque, empieza a escribir lo que encuentra tal cual hasta que + encuentra otra etiqueta de inicio de bloque. El ejemplo anterior es, por supuesto, + inventado. Para escribir bloques grandes de texto generamente es más eficiente + separalos del c&oacute;digo PHP que enviar todo el texto mediante las funciones + <function>echo</function>, <function>print</function> o similares. + </para> + </sect1> + + <sect1 id="language.basic-syntax.instruction-separation"> + <title>Separaci&oacute;n de instrucciones</title> + + <simpara> + Las separaci&oacute;n de instrucciones se hace de la misma manera que en C + o Perl - terminando cada declaraci&oacute;n con un punto y coma. + </simpara> + <para> + La etiqueta de fin de bloque (?&gt;) implica el fin de la declaraci&oacute;n, + por lo tanto lo siguiente es equivalente: + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + echo "This is a test"; ?> -&lt;?php echo "Esto es una prueba" ?> - </programlisting> - </informalexample></para></sect1> - - <sect1 id="language.basic-syntax.comments"> - <title>Comentarios</title> - - <para> - PHP soporta comentarios tipo 'C', 'C++' y shell de Unix. Por ejemplo: - - <informalexample><programlisting> -&lt;?php - echo "Esto es una prueba"; // Esto es un comentario tipo c++ para una l&iacute;nea - /* Esto es un comentario multil&iacute;nea - otra l&iacute;nea m&aacute;s de comentario*/ - echo "Esto es a&uacute;n otra prueba"; - echo "Una Prueba Final"; # Este es un comentario tipo shell +<?php echo "This is a test" ?> +]]> + </programlisting> + </informalexample> + </para> + </sect1> + + <sect1 id="language.basic-syntax.comments"> + <title>Comentarios</title> + + <para> + PHP soporta el estilo de comentarios de 'C', 'C++' y de la interfaz de comandos + de Unix. Por ejemplo: + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + echo "This is a test"; // This is a one-line c++ style comment + /* This is a multi line comment + yet another line of comment */ + echo "This is yet another test"; + echo "One Final Test"; # This is shell-style style comment ?> +]]> </programlisting> - </informalexample></para> + </informalexample> + </para> - <simpara> - El tipo de comentario de "una l&iacute;nea" s&oacute;lo comenta, en realidad, - hasta el fin de la l&iacute;nea o el bloque actual de c&oacute;digo PHP, - lo que venga primero.</simpara> - <informalexample><programlisting> -&lt;h1>Esto es un &lt;?# echo "simple";?> ejemplo.&lt;/h1> -&lt;p>La cabecera de arriba dir&aacute; 'Esto es un ejemplo'. -</programlisting></informalexample> - - <simpara> - Se deber&iacute;a tener cuidado para no anidar comentarios de tipo 'C', - lo cual puede ocurrir cuando se comentan grandes bloques.</simpara> - - <informalexample><programlisting> -&lt;?php - /* - echo "Esto es una prueba"; /* Este comentario causar&aacute; un problema */ + <simpara> + Los estilos de comentarios de una linea actualmente s&oacute;lo comentan + hasta el final de la linea o el bloque actual de c&oacute;digo PHP, lo + primero que ocurra. + </simpara> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<h1>This is an <?php # echo "simple";?> example.</h1> +<p>The header above will say 'This is an example'. +]]> + </programlisting> + </informalexample> + + <simpara> + Hay que tener cuidado con no anidar comentarios de estilo 'C', algo + que puede ocurrir al comentar bloques largos de c&oacute;digo. + </simpara> + + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + /* + echo "This is a test"; /* This comment will cause a problem */ */ ?> - </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 +]]> + </programlisting> + </informalexample> + + <simpara> + Los estilos de comentarios de una linea actualmente s&oacute;lo comentan + hasta el final de la linea o del bloque actual de c&oacute;digo PHP, + lo primero que ocurra. Esto implica que el c&oacute;digo HTML tras // ?&gt; SER&AACUTE; + impreso: ?&gt; sale del modo PHP, retornando al modo HTML, el comentario + // no le influye. + </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: - --> +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 +-->
« previous php.doc (#969346183) next »