<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY % addindex "IGNORE">
<!ENTITY % Spanish "INCLUDE">
<!-- change language only here -->
]>

<article lang="&language;" id="nepomuksearch">
  <title
>nepomuksearch</title>
  <articleinfo>
    <authorgroup>
      <author
><personname
> <firstname
>Sebastian</firstname
> <surname
>Tr&uuml;g</surname
> </personname
> <email
>trueg@kde.org</email
> </author>
      <othercredit role="translator"
><firstname
>Cristina Yenyxe</firstname
><surname
>González García</surname
><affiliation
><address
><email
>the.blue.valkyrie@gmail.com</email
></address
></affiliation
><contrib
>Traductor</contrib
></othercredit
> 
    </authorgroup>

    <date
>10-09-2010</date>
    <releaseinfo
>1.0.0</releaseinfo>
  </articleinfo>

  <sect1>
    <title
>Descripción general</title>

    <para
>El protocolo <acronym
>nepomuksearch</acronym
> permite buscar en el almacén de metadatos de Nepomuk, archivos o cualquier otro tipo de recurso (aunque los archivos son el caso de uso más importante puesto que en éste contexto estamos hablando de sistemas de archivos virtuales).</para>
    <note>
      <para
>Para que funcione es necesario que el sistema Nepomuk esté activado. La activación del indexador de archivos Strigi proporciona mejores resultados y más posibilidades de búsqueda.</para>
    </note>

    <para
>Generalmente <acronym
>nepomuksearch</acronym
> se utiliza de forma transparente al usuario a través de un aplicación como <application
>Dolphin</application
> que proporciona una interfaz gráfica de usuario para construir la consulta necesaria y la URL correspondiente. No obstante, también es posible escribir una consulta URL manualmente. Hay dos posibilidades diferentes que pueden ser de interés para el usuario (tenga en cuenta que las consultas creadas tal como se presentan debajo no están restringidas a los archivos):</para>
    <variablelist>
      <varlistentry>
        <term>
          <userinput
>nepomuksearch:/?query=Nepomuk</userinput>
        </term>
        <listitem>
          <para
>buscará cualquier cosa que contenga la palabra «Nepomuk». «Nepomuk» puede ser sustituida con cualquier cosa que permita la simple <xref linkend="query_syntax"/>.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <userinput
>nepomuksearch:/?sparql=select ?r where { ?r nao:hasTag ?tag . ?tag nao:prefLabel 'Nepomuk'^^xsd:string . }</userinput>
        </term>
        <listitem>
          <para
>ejecutará la consulta <acronym
>SPARQL</acronym
> que en este caso buscará todos los recursos que estén etiquetados con la etiqueta «Nepomuk». Tenga en cuenta que la consulta necesita estar codificada con porcentajes, &ie; una URI como <userinput
> &lt;http://www.semanticdesktop.org/ontologies/2007/08/15/nao#Tag&gt;</userinput
> debería ser escrita como <userinput
>%3chttp:%2f%2fwww.semanticdesktop.org%2fontologies%2f2007%2f08%2f15%2fnao#Tag%3e</userinput
>.</para>
        </listitem>
      </varlistentry>
    </variablelist>

  </sect1>

  <sect1 id="query_syntax">
    <title
>Sintaxis de consulta de Nepomuk</title>
    <para
>La sintaxis es bastante simple. Se pueden combinar varios términos de consulta utilizando las palabras clave <command
>AND</command
> o <command
>OR</command
>, los términos pueden ser excluidos utilizando un menos como prefijo, y las propiedades específicas pueden buscarse mediante la combinación del nombre de la propiedad con un comparador y el valor.</para>
    <tip>
      <para
>Esta sintaxis también se puede utilizar en los campos de búsqueda estándar tales como los de <application
>Dolphin</application
>.</para>
    </tip>
    <sect2>
      <title
>Ejemplos</title>
      <variablelist>
        <varlistentry>
          <term
><userinput
>Nepomuk KDE</userinput
> o <userinput
>Nepomuk AND KDE</userinput
> </term>
          <listitem>
            <para
>busca cualquier cosa que contenga las palabras «Nepomuk» y «KDE» en cualquiera de sus propiedades (incluyendo el contenido de los archivos).</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>Nepomuk OR KDE</userinput>
          </term>
          <listitem>
            <para
>busca cualquier cosa que contenga la palabra «Nepomuk» o la palabra «KDE» en cualquiera de sus propiedades.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>«Nepomuk KDE»</userinput>
          </term>
          <listitem>
            <para
>busca cualquier cosa que contenga la frase exacta «Nepomuk KDE» en cualquiera de sus propiedades.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>hastag:Nepomuk</userinput>
          </term>
          <listitem>
            <para
>busca cualquier cosa que esté etiquetada con una etiqueta llamada «Nepomuk».</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>+hastag:nepomuk AND -hastag:scribo</userinput>
          </term>
          <listitem>
            <para
>busca cualquier cosa que tenga una etiqueta llamada «nepomuk» pero que no tenga una etiqueta llamada «scribo».</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
  </sect1>

</article>
