[PHP-DOC] cvs: phpdoc-es /language basic-syntax.xml

[Rafael Martinez]

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 [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>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
+-->