Skip to content

Commit

Permalink
Sync solr with EN
Browse files Browse the repository at this point in the history
  • Loading branch information
Girgias committed Jan 28, 2024
1 parent 0a82523 commit c7c0c1c
Show file tree
Hide file tree
Showing 88 changed files with 245 additions and 247 deletions.
29 changes: 15 additions & 14 deletions reference/solr/book.xml
Original file line number Diff line number Diff line change
@@ -1,61 +1,62 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: ec0f155359b5ea481e17525086a4bbcbcccc4180 Maintainer: seros Status: ready -->
<!-- EN-Revision: 68c2c871505aadf983f16113c5b077b335ce8d76 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->

<book xml:id="book.solr" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="pecl" ?>
<title>Solr de Apache</title>
<titleabbrev>Solr</titleabbrev>

<preface xml:id="intro.solr">
&reftitle.intro;
<para>
La extensión Solr permite comunicarse de manera efectiva con el servidor Solr de Apache en PHP.
</para>

<para>La extensión Solr es una biblioteca extremadamente rápida, de pequeño tamaño, y con abundantes características que permite a los desarrolladores de PHP comunicarse de manera efectiva con las instancias del servidor Solr.</para>
<para>Las versiones 1.x de la Extensión PECL soportan el Servidor Solr de Apache 1.3-3.x</para>
<para>Las versiones 2.x de la Extensión PECL soportan el Servidor Solr de Apache 4.0+ </para>
<para>Hay herramientas internas para añadir documentos y realizar actualizaciones al servidor solr.</para>
<para>También contiene herramientas que permiten realizar consultas avanzadas al servidor cuando se buscan documentos.</para>
</preface>

&reference.solr.setup;
&reference.solr.constants;
&reference.solr.reference;

&reference.solr.examples;

&reference.solr.solrutils;

&reference.solr.solrinputdocument;
&reference.solr.solrdocument;
&reference.solr.solrdocumentfield;

&reference.solr.solrobject;

&reference.solr.solrclient;

&reference.solr.solrresponse;
&reference.solr.solrqueryresponse;
&reference.solr.solrupdateresponse;
&reference.solr.solrpingresponse;
&reference.solr.solrgenericresponse;

&reference.solr.solrparams;
&reference.solr.solrmodifiableparams;
&reference.solr.solrquery;
&reference.solr.solrdismaxquery;
&reference.solr.solrcollapsefunction;

&reference.solr.solrexception;
&reference.solr.solrclientexception;
&reference.solr.solrserverexception;
&reference.solr.solrillegalargumentexception;
&reference.solr.solrillegaloperationexception;
&reference.solr.solrmissingmandatoryparameterexception;


</book>

<!-- Keep this comment at the end of the file
Expand Down
8 changes: 4 additions & 4 deletions reference/solr/constants.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 4de5cce5d886bf7ea08db8583141ff9715b47073 Maintainer: seros Status: ready -->
<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: seros Status: ready -->

<appendix xml:id="solr.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
Expand All @@ -10,7 +10,7 @@
<varlistentry xml:id="constant.solr-major-version">
<term>
<constant>SOLR_MAJOR_VERSION</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<simpara>
Expand All @@ -20,7 +20,7 @@
<varlistentry xml:id="constant.solr-minor-version">
<term>
<constant>SOLR_MINOR_VERSION</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<simpara>
Expand All @@ -30,7 +30,7 @@
<varlistentry xml:id="constant.solr-patch-version">
<term>
<constant>SOLR_PATCH_VERSION</constant>
(<type>integer</type>)
(<type>int</type>)
</term>
<listitem>
<simpara>
Expand Down
13 changes: 6 additions & 7 deletions reference/solr/setup.xml
Original file line number Diff line number Diff line change
@@ -1,21 +1,20 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 639c9e6a15c7de3156c56427a6fb9cbfbdcbfc68 Maintainer: seros Status: ready -->
<!-- EN-Revision: 184f3f7bd45643cb80f828d0bb001991ec3a5fad Maintainer: seros Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->

<chapter xml:id="solr.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;

<section xml:id="solr.requirements">
&reftitle.required;
<!-- Use &no.requirement; if there no requirement -->
<para>Se requiere la versión de PHP 5.2.11 o superior.</para>
<para>Las bibliotecas libxml y curl también deben estar habilitadas para que esté disponible la extensión Apache Solr.</para>
<para>Se requiere libxml2 2.6.31 o posterior.</para>
<para>También se requiere libcurl 7.18.0 o posterior.</para>
<para>Las versiones de las bibliotecas de arriba son necesarias y se recomienda encarecidamente no intentar hackear el código para hacerlo compilar. Fallará, posiblemente con errores que podrían ser difíciles de depurar</para>
</section>

<!-- {{{ Installation -->
<section xml:id="solr.installation">
&reftitle.install;
Expand All @@ -40,21 +39,21 @@
</note>
</section>
<!-- }}} -->

<!-- {{{ Configuration -->
<section xml:id="solr.configuration">
&reftitle.runtime;
&no.config;
</section>
<!-- or &reference.solr.ini; -->
<!-- }}} -->

<section xml:id="solr.resources">
&reftitle.resources;
&no.resource;
<!-- Use &no.resource; if there no resources -->
</section>

</chapter>

<!-- Keep this comment at the end of the file
Expand Down
24 changes: 12 additions & 12 deletions reference/solr/solrclient/adddocument.xml
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 3b3be96b737e3c90e42a92e0959ed788f06dbbb7 Maintainer: seros Status: ready -->
<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: seros Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->

<refentry xml:id="solrclient.adddocument" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>SolrClient::addDocument</refname>
<refpurpose>Añade un documento al índice</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
Expand All @@ -20,9 +20,9 @@
<para>
Este método añade un documento al índice.
</para>

</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<para>
Expand All @@ -40,7 +40,7 @@
<listitem>
<para>
Si sobrescribir el documento existente o no. Si es &false; existirán duplicados (varios documento con el mismo ID).

</para>
<warning>
<para>
Expand All @@ -59,7 +59,7 @@
Número de milisegundos dentro de los que autoconsignar este documento. Disponible desde Solr 1.4. El valor predeterminado (0) significa deshabilitado.
</para>
<para>
Cuando se especifica este valor, deja el control de cúando realizar la consignación
Cuando se especifica este valor, deja el control de cúando realizar la consignación
al mismo Solr, optimizando el número de consignaciones a un mínimo mientras aún se cumple
con los requisitos
de latencia de actualizaciones, por lo que Solr realizará automáticamente una consignación
Expand All @@ -70,14 +70,14 @@
</variablelist>
</para>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un objeto <type>SolrUpdateResponse</type> o lanza una excepción en caso de error.
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<para>
Expand All @@ -87,7 +87,7 @@
Lanza una <classname>SolrServerException</classname> si el servidor de Solr falló al procesar la petición.
</para>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand Down Expand Up @@ -193,10 +193,10 @@ SolrObject Object
]]>
</screen>
</example>

</para>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
Expand All @@ -206,7 +206,7 @@ SolrObject Object
</simplelist>
</para>
</refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Expand Down
36 changes: 18 additions & 18 deletions reference/solr/solrclient/commit.xml
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: seros Status: ready -->
<!-- EN-Revision: af5f2f87b3b0bb9ee0f83ccb787a4e7db1eb6bd4 Maintainer: seros Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->

<refentry xml:id="solrclient.commit" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>SolrClient::commit</refname>
<refpurpose>Finaliza todas las añadiduras/eliminaciones hechas al índice</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
Expand All @@ -20,9 +20,9 @@
<para>
Este método finaliza todas las añadiduras/eliminaciones hechas al índice.
</para>

</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<para>
Expand All @@ -35,16 +35,16 @@
</para>
<para>
Una consignación suave es mucho más rápida ya que solamente hace visibles los cabios de índices y usa fsync con los ficheros de índices o escribe un nuevo descriptor de índice.
Si la JVM falla o hay una bajada de tensión, los cambios acaecidos después de la úlitma consignación dura se perderán.
Las búsquedas que tengan requisitos cercanos al tiempo real (que requieren que los cambios de índices estén rápidamente visibles para búsquedas) necesitarán más a menudo consignas suaves, y menos frecuentemente duras.
Si la JVM falla o hay una bajada de tensión, los cambios acaecidos después de la úlitma consignación dura se perderán.
Las búsquedas que tengan requisitos cercanos al tiempo real (que requieren que los cambios de índices estén rápidamente visibles para búsquedas) necesitarán más a menudo consignas suaves, y menos frecuentemente duras.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>waitSearcher</parameter></term>
<listitem>
<para>
Bloqueo hasta que un nuevo buscador sea abierto y registrado como el buscador de consultas principal, haciendo los cambios visibles.
Bloqueo hasta que un nuevo buscador sea abierto y registrado como el buscador de consultas principal, haciendo los cambios visibles.
</para>
</listitem>
</varlistentry>
Expand All @@ -59,14 +59,14 @@
</variablelist>
</para>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un objeto <type>SolrUpdateResponse</type> en caso de éxito o lanza una excepción en caso de error.
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<para>
Expand All @@ -76,7 +76,7 @@
Lanza una <classname>SolrServerException</classname> si el Servidor de Solr falló al procesar la petición.
</para>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<para>
Expand All @@ -90,22 +90,22 @@
</thead>
<tbody>
<row>
<entry>1.1.0, 2.0.0</entry>
<entry>PECL solr 1.1.0, 2.0.0</entry>
<entry>
Se eliminó el parámetro $maxSegments.
</entry>
</row>
<row>
<entry>2.0.0b</entry>
<entry>PECL solr 2.0.0b</entry>
<entry>
Cambio en la API: SolrClient::commit ([ int $maxSegments = 0 [, bool $softCommit = false [, bool $waitSearcher = true[, bool $expungeDeletes = false ]]] )
</entry>
</row>

<row>
<entry>0.9.2</entry>
<entry>PECL solr 0.9.2</entry>
<entry>
Firma: SolrClient::commit ([ int $maxSegments = 1 [, bool $waitFlush = true [, bool $waitSearcher = true ]]] ).
Firma: SolrClient::commit ([ int $maxSegments = 1 [, bool $waitFlush = true [, bool $waitSearcher = true ]]] ).
$waitFlush: Bloquea hasta que los cambios de índices sean volcados a disco.
</entry>
</row>
Expand All @@ -118,11 +118,11 @@
&reftitle.notes;
<warning>
<para>
Solr &gt;= 2.0 de PECL solamente soporta Solr Server &gt;= 4.0
Solr &gt;= 2.0 de PECL solamente soporta Solr Server &gt;= 4.0
</para>
</warning>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
Expand All @@ -132,7 +132,7 @@
</simplelist>
</para>
</refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Expand Down
Loading

0 comments on commit c7c0c1c

Please sign in to comment.