Skip to content

[Sync-En] chapters, chmonly: fix typos and grammar #1372

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lacatoire wants to merge 1 commit into
base: master
Choose a base branch
from
Open

[Sync-En] chapters, chmonly: fix typos and grammar #1372

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 21 additions & 22 deletions chapters/intro.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 0bae88c19601e7f67ae6a22a8f9aa44cb9342cc1 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: cd7a4b94a4cf282d8fd70803f0e2fdd159557444 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->

<chapter xml:id="introduction" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
Expand All @@ -10,7 +10,7 @@
<section xml:id="intro-whatis" annotations="chunk:false">
<info><title>¿Qué es PHP?</title></info>
<para>
<acronym>PHP</acronym> (oficialmente, este sigle es un acrónimo recursivo para
<acronym>PHP</acronym> (oficialmente, esta sigla es un acrónimo recursivo para
<emphasis>PHP Hypertext Preprocessor</emphasis>) es un lenguaje de scripts generalista
y Open Source, especialmente concebido para el desarrollo de aplicaciones
web. Puede ser integrado fácilmente al HTML.
Expand All @@ -31,7 +31,7 @@
<body>

<?php
echo "Hola, soy un script PHP!";
echo "¡Hola, soy un script PHP!";
?>

</body>
Expand All @@ -43,7 +43,7 @@ echo "Hola, soy un script PHP!";
<para>
En lugar de utilizar toneladas de comandos para mostrar HTML (como en
C o en Perl), las páginas PHP contienen fragmentos HTML con código que hace <replaceable>"algo"</replaceable> (en este caso, mostrará
<computeroutput>"Hola, soy un script PHP!"</computeroutput>).
<computeroutput>"¡Hola, soy un script PHP!"</computeroutput>).
El código PHP está incluido entre
<link linkend="language.basic-syntax.phpmode">una etiqueta de inicio
<code>&lt;?php</code> y una etiqueta de fin <code>?&gt;</code></link>
Expand All @@ -54,9 +54,8 @@ echo "Hola, soy un script PHP!";
es que el código se ejecuta en el servidor, generando así el HTML, que
será luego enviado al cliente. El cliente solo recibe el
resultado del script, sin ningún medio de acceso al código
que produjo dicho resultado. Se puede configurar el servidor web para que analice todos los ficheros HTML como ficheros PHP.
Así, no hay manera de distinguir las páginas que son producidas
dinámicamente de las páginas estáticas. Un servidor web puede incluso ser configurado
que produjo dicho resultado.
Un servidor web puede incluso ser configurado
para procesar todos los ficheros HTML con PHP, y no hay
manera para los usuarios de saber que PHP está siendo utilizado.
</para>
Expand Down Expand Up @@ -108,8 +107,8 @@ echo "Hola, soy un script PHP!";
ejecutado en línea de comandos,
sin la ayuda del servidor web y de un navegador. Solo se necesita
el ejecutable PHP. Este uso es ideal para los scripts que se ejecutan regularmente
con un <command>cron</command> en Unix o Linux o
un gestor de tareas (en Windows). Estos scripts
con <command>cron</command> (en Unix o macOS) o con el Programador de tareas
(en Windows). Estos scripts
también pueden ser utilizados para realizar operaciones en ficheros de texto. Vea la sección sobre el uso de PHP en
<link linkend="features.commandline">línea de comandos</link>
para más información.
Expand All @@ -132,34 +131,34 @@ echo "Hola, soy un script PHP!";
la programación procedimental u orientada a objetos (OOP), o incluso una mezcla de
ambas.
</para>
<para>
<simpara>
Con PHP, no se limita a la producción de código HTML. Las capacidades de PHP incluyen
la creación de tipos de ficheros ricos, como imágenes o ficheros PDF, el cifrado de datos
y el envío de correos electrónicos. También puede generar fácilmente cualquier texto, como JSON
o XML. PHP puede generar automáticamente estos ficheros y guardarlos en
el sistema de ficheros en lugar de imprimirlos, formando así una caché del lado del servidor para
contenido dinámico.
</para>
<para>
Una de las fortalezas más significativas de PHP es que soporta
<link linkend="refs.database">enormemente bases de datos</link>.
</simpara>
<simpara>
Una de las fortalezas más significativas de PHP es su soporte para una
<link linkend="refs.database">amplia gama de bases de datos</link>.
Escribir una página web que utilice una base de datos se vuelve
extremadamente simple, utilizando una de las extensiones específicas
para bases de datos (i.e., para <link linkend="book.mysqli">mysql</link>),
o utilizando una clase de abstracción como <link linkend="book.pdo">PDO</link>,
o una conexión a cualquier base de datos que soporte la conexión
estándar abierta a través de la extensión <link linkend="book.uodbc">ODBC</link>.
para bases de datos (por ejemplo, para <link linkend="book.mysqli">MySQL</link>),
o utilizando una capa de abstracción como <link linkend="book.pdo">PDO</link>,
o conectándose a cualquier base de datos compatible con el estándar
Open Database Connection a través de la extensión <link linkend="book.uodbc">ODBC</link>.
Otras bases de datos pueden utilizar la extensión
<link linkend="book.curl">cURL</link> o <link linkend="book.sockets">sockets</link>
<link linkend="book.curl">cURL</link> o <link linkend="book.sockets">sockets</link>,
como CouchDB.
</para>
</simpara>
<simpara>
PHP soporta numerosos protocolos como
LDAP, IMAP, SNMP, NNTP, POP3, HTTP, COM (en Windows) y
muchos otros. También puede abrir sockets de red
e interactuar con cualquier otro protocolo.
</simpara>
<para>
<simpara>
PHP posee funcionalidades útiles en el
<link linkend="refs.basic.text">tratamiento de texto</link>,
incluyendo las expresiones regulares compatibles con Perl (<link linkend="book.pcre">PCRE</link>),
Expand All @@ -169,7 +168,7 @@ echo "Hola, soy un script PHP!";
y extiende el conjunto de funcionalidades añadiendo soporte para
<link linkend="book.simplexml">SimpleXML</link>, <link linkend="book.xmlreader">XMLReader</link>
y <link linkend="book.xmlwriter">XMLWriter</link>.
</para>
</simpara>
<para>
Muchas otras extensiones existen, categorizadas
<link linkend="extensions">alfabéticamente</link> y por <link linkend="funcref">categoría</link>.
Expand Down
62 changes: 31 additions & 31 deletions chapters/tutorial.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1340d3595bde8489ea1385868ffd75471a56999b Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: cd7a4b94a4cf282d8fd70803f0e2fdd159557444 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="tutorial" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<info><title>Un tutorial sencillo</title></info>
Expand All @@ -8,7 +8,7 @@
Aquí nos gustaría mostrar los aspectos más básicos de PHP en un tutorial breve y sencillo.
Este texto solo trata sobre la creación de páginas web dinámicas con PHP, aunque PHP no
solo es capaz de crear páginas web. Consulte la sección titulada <link linkend="intro-whatcando">¿Qué
puede hacer PHP</link> para obtener más información.
puede hacer PHP?</link> para obtener más información.
</para>
<para>
Las páginas web habilitadas para PHP se tratan exactamente igual que las páginas HTML
Expand Down Expand Up @@ -104,20 +104,20 @@ php -S localhost:8000
muchas cosas interesantes.
</para>

<para>
<simpara>
El objetivo del ejemplo es mostrar el formato especial de las etiquetas PHP.
En este ejemplo usamos <literal>&lt;?php</literal> para indicar el
inicio de una etiqueta PHP. Luego pusimos la sentencia PHP y salimos del
modo PHP añadiendo la etiqueta de cierre, <literal>?&gt;</literal>.
Puede entrar y salir del modo PHP en un fichero HTML como este donde
quiera. Para más detalles, lea la sección del manual sobre la
<link linkend="language.basic-syntax">sintaxis básica de PHP</link>.
</para>
</simpara>

<note>
<info><title>Una nota sobre los saltos de línea</title></info>
<para>
Los saltos de línea tienen poco significado en HTML, sin embargo sigue siendo
<simpara>
Los saltos de línea tienen poco significado en HTML; sin embargo, sigue siendo
una buena idea hacer que su HTML se vea bien y limpio poniendo saltos de línea.
Un salto de línea que sigue inmediatamente después de un cierre
<literal>?&gt;</literal> será eliminado por PHP. Esto puede ser
Expand All @@ -127,40 +127,40 @@ php -S localhost:8000
<literal>?&gt;</literal> para forzar que se muestre un espacio y un salto
de línea, o puede poner un salto de línea explícito en el último echo/print
desde dentro de su bloque PHP.
</para>
</simpara>
</note>

<note>
<info><title>Una nota sobre los editores de texto</title></info>
<para>
<simpara>
Hay muchos editores de texto y Entornos de Desarrollo Integrados (IDE) que
puede usar para crear, editar y gestionar ficheros PHP. Una lista parcial de
estas herramientas se mantiene en <link xlink:href="&url.phpeditorlist;">Lista de
editores PHP</link>. Si desea recomendar un editor, por favor visite la
página anterior y pídale al responsable de la página que añada el editor a
la lista. Tener un editor con resaltado de sintaxis puede ser útil.
</para>
</simpara>
</note>

<note>
<info><title>Una nota sobre los procesadores de texto</title></info>
<para>
Los procesadores de texto como StarOffice Writer, Microsoft Word y Abiword no
<simpara>
Los procesadores de texto como StarOffice Writer, Microsoft Word y AbiWord no
son óptimos para editar ficheros PHP. Si desea usar uno para este script de
prueba, debe asegurarse de guardar el fichero como <emphasis>texto plano</emphasis>
o PHP no podrá leer y ejecutar el script.
</para>
</simpara>
</note>

<para>
<simpara>
Ahora que ha creado con éxito un script PHP funcional, es hora de crear
¡el script PHP más famoso! Haga una llamada a la función
<function>phpinfo</function> y verá mucha información útil sobre su
sistema y configuración, como las <link linkend="language.variables.predefined">variables
predefinidas</link> disponibles, los módulos PHP cargados y las
<link linkend="configuration">configuraciones</link>. Tómese su tiempo y revise
esta información importante.
</para>
</simpara>
<para>
<example>
<info><title>Obtener información del sistema desde PHP</title></info>
Expand All @@ -181,7 +181,7 @@ phpinfo();
<info><title>Algo útil</title></info>
<para>
Ahora hagamos algo más útil. Vamos a comprobar qué tipo de navegador
está usando el visitante. Para ello, comprobamos la cadena del agente de
está usando el visitante. Para ello, comprobamos el string del agente de
usuario que el navegador envía como parte de la petición HTTP. Esta
información se almacena en una <link linkend="language.variables">variable</link>.
Las variables siempre comienzan con un signo de dólar en PHP. La variable que
Expand Down Expand Up @@ -221,12 +221,12 @@ Mozilla/5.0 (Linux) Firefox/112.0
</screen>
</example>
</para>
<para>
<simpara>
Hay muchos <link linkend="language.types">tipos</link> de variables
disponibles en PHP. En el ejemplo anterior imprimimos un elemento de un
<link linkend="language.types.array">array</link> variable. Los arrays pueden
disponibles en PHP. En el ejemplo anterior imprimimos un elemento de una
variable de tipo <link linkend="language.types.array">array</link>. Los arrays pueden
ser muy útiles.
</para>
</simpara>
<para>
<varname>$_SERVER</varname> es solo una variable que PHP hace
automáticamente disponible. Puede ver una lista en la sección
Expand Down Expand Up @@ -273,11 +273,11 @@ Está usando Firefox.
introductorio de PHP o los primeros capítulos, o leer la parte de
<link linkend="langref">Referencia del Lenguaje</link> del manual.
</para>
<para>
<simpara>
El segundo concepto que introdujimos fue la llamada a la función
<function>str_contains</function>. <function>str_contains</function> es una
función integrada en PHP que determina si una cadena dada contiene otra
cadena. En este caso estamos buscando <literal>'Firefox'</literal> (la
función integrada en PHP que determina si un string dado contiene otro
string. En este caso estamos buscando <literal>'Firefox'</literal> (la
llamada aguja) dentro de <varname>$_SERVER['HTTP_USER_AGENT']</varname>
(la llamada pajar). Si la aguja se encuentra dentro del pajar, la función
devuelve true. De lo contrario, devuelve &false;. Si devuelve &true;, la
Expand All @@ -291,7 +291,7 @@ Está usando Firefox.
seguro de cómo usar funciones, querrá leer tanto la página del manual sobre
<link linkend="about.prototypes">cómo leer una definición de función</link> como
la sección sobre <link linkend="language.functions">funciones de PHP</link>.
</para>
</simpara>
<para>
Podemos llevar esto un paso más allá y mostrar cómo puede entrar y salir
del modo PHP incluso en medio de un bloque PHP:
Expand Down Expand Up @@ -327,27 +327,27 @@ if (str_contains($_SERVER['HTTP_USER_AGENT'], 'Firefox')) {
</screen>
</example>
</para>
<para>
<simpara>
En lugar de usar una sentencia echo de PHP para mostrar algo, salimos
del modo PHP y enviamos directamente HTML. El punto importante y potente
a notar aquí es que el flujo lógico del script permanece intacto. Solo
uno de los bloques HTML terminará siendo enviado al espectador dependiendo
del resultado de <function>str_contains</function>. En otras palabras,
depende de si la cadena <literal>Firefox</literal> fue encontrada o no.
</para>
depende de si el string <literal>Firefox</literal> fue encontrado o no.
</simpara>
</section>

<section xml:id="tutorial.forms">
<info><title>Tratar con formularios</title></info>
<para>
<simpara>
Una de las características más poderosas de PHP es la forma en que maneja
los formularios HTML. El concepto básico que es importante entender es
que cualquier elemento de formulario estará automáticamente disponible
para sus scripts PHP. Por favor, lea la sección del manual sobre
<link linkend="language.variables.external">Variables desde fuentes
externas</link> para obtener más información y ejemplos sobre el uso
de formularios con PHP. Aquí hay un ejemplo de formulario HTML:
</para>
</simpara>
<para>
<example>
<info><title>Un formulario HTML sencillo</title></info>
Expand Down Expand Up @@ -391,12 +391,12 @@ Hola Joe. Tiene 22 años.
</screen>
</example>
</para>
<para>
<simpara>
Aparte de las partes <function>htmlspecialchars</function> y
<literal>(int)</literal>, debería ser obvio lo que hace esto.
<function>htmlspecialchars</function> asegura que cualquier carácter que
sea especial en HTML se codifique correctamente para que la gente no pueda
inyectar etiquetas HTML o Javascript en su página. Para el campo de edad,
inyectar etiquetas HTML o JavaScript en su página. Para el campo de edad,
ya que sabemos que es un número, podemos simplemente
<link linkend="language.types.typecasting">convertirlo</link> a un
<type>int</type> que automáticamente eliminará cualquier carácter
Expand All @@ -413,7 +413,7 @@ Hola Joe. Tiene 22 años.
También puede usar la superglobal <varname>$_REQUEST</varname> si no le
importa la fuente de sus datos de petición. Contiene la información
combinada de los datos GET, POST y COOKIE.
</para>
</simpara>
</section>

<section xml:id="tutorial.whatsnext">
Expand Down
20 changes: 10 additions & 10 deletions chmonly/aboutchm.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,37 +1,37 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: lboshell Status: ready -->
<!-- EN-Revision: 4d624ced045b1f0012d9010351e250e8b2bbb755 Maintainer: lboshell Status: ready -->
<chapter xml:id="chm.about" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Sobre Esta Edición</title>

<para>
<simpara>
La Edición de Ayuda HTML Windows del Manual de PHP
está dirigida a desarrolladores, quienes desean tener el
manual a mano todo el tiempo, y desean leer páginas del
manual y notas de usuarios sin tener que esperar a que descargue
manual y notas de usuarios sin tener que esperar a que se descargue
una página web remota. Esta edición le ofrece el
contenido completo del manual más las anotaciones de
usuarios, con algunas excelentes características adicionales
ofrecidas por la aplicación visora, por los scripts que
usamos para generar éste formato y por otros contribuyentes
usamos para generar este formato y por otros colaboradores
en forma de skins.
</para>
</simpara>

<para>
<simpara>
Esta distribución del manual de PHP contiene varios archivos, incluyendo el
archivo principal del manual, <filename>php_manual_en.chm</filename>. Puede ver
el manual haciendo doble clic sobre éste archivo (tal y como ya lo habrá adivinado).
el manual haciendo doble clic sobre este archivo (tal y como ya lo habrá adivinado).
<!--
Las notas de usuario se encuentran en <filename>php_manual_notes.chm</filename>. Solo
necesita tener una copia de éste archivo en su equipo, independientemente
necesita tener una copia de este archivo en su equipo, independientemente
de cuántos lenguajes usa para leer el Manual de PHP. El único
requerimiento es que necesita tener todos los archivos <filename>php_manual_LANG.chm</filename>
en un directorio junto con <filename>php_manual_notes.chm</filename>.
//-->
También puede ver un archivo <filename>php_manual_en.chw</filename> en el
directorio, éste es generado la primera vez que usa la pestaña del índice,
directorio, este es generado la primera vez que usa la pestaña del índice,
y contiene un índice con las páginas del manual.
</para>
</simpara>

<para>
Para aquellos interesados en los detalles técnicos del formato Microsoft HTML Help,
Expand Down
Loading
Loading