/help/faq/collections-carousel-examples.es
Type: /type/page
body: value: Las colecciones son esencialmente páginas de **carruseles de búsqueda** que parecen una hilera de portadas de libros en una estantería, colorida y fácil de hojear.

&bull; Para más información sobre el uso de carruseles para crear colecciones, <a href="https://openlibrary.org/help/faq/collections">haz clic aquí</a>. 

&bull; Para leer la macro QueryCarousel en el código, <a href="https://github.com/internetarchive/openlibrary/blob/master/openlibrary/macros/QueryCarousel.html">haz clic aquí</a>. 

{{QueryCarousel('key:(/works/OL10673093W OR /works/OL73356W OR /works/OL73385W OR /works/OL73375W OR /works/OL73384W OR /works/OL73382W OR /works/OL73387W)')}}

Los carruseles pueden ser muy generales, cubriendo un tema amplio como el Arte o un autor muy prolífico como Stephen King, o muy específicos, mostrando una lista explícita de identificadores de obras. Como mínimo, un carrusel necesita un argumento: la **consulta**. Si se omite la consulta, se producirá un error.  

`{{QueryCarousel(QUERY)}}`

Estos son ejemplos de carruseles con solo la consulta:

`{{QueryCarousel('subject:"dragons"')}}`

`{{QueryCarousel('key:(/works/OL10673093W OR /works/OL73356W OR /works/OL73385W)')}}`

Este es un ejemplo de carrusel con todas las opciones especificadas:

`{{QueryCarousel('subject:"dragons"', title="Dragons", sort="new", key="", limit=20, search=True, has_fulltext_only=False, url=None)}}`

Esta es una plantilla para un carrusel sin título ni búsqueda, con un límite de 20 y ordenado por escaneos y ediciones:

`{{QueryCarousel('subject:"dragons"', sort="scans,editions", limit=20, has_fulltext_only=False)}}`

## Tabla de contenidos

1. <a href="https://openlibrary.org/help/faq/collections-carousel-examples#query-search">Consulta por cadena de búsqueda</a>
2. <a href="https://openlibrary.org/help/faq/collections-carousel-examples#query-key">Consulta por clave</a>
3. <a href="https://openlibrary.org/help/faq/collections-carousel-examples#title">Añadir un título</a>
4. <a href="https://openlibrary.org/help/faq/collections-carousel-examples#search">Añadir una barra de búsqueda</a>
5. <a href="https://openlibrary.org/help/faq/collections-carousel-examples#search-title">Añadir una barra de búsqueda y un título</a>
6. <a href="https://openlibrary.org/help/faq/collections-carousel-examples#sort">Opciones de ordenación</a>
7. <a href="https://openlibrary.org/help/faq/collections-carousel-examples#full-text">Solo texto completo</a>
8. <a href="https://openlibrary.org/help/faq/collections-carousel-examples#limits">Límites</a>
9. <a href="https://openlibrary.org/help/faq/collections-carousel-examples#key">Key=?</a>
10. <a href="https://openlibrary.org/help/faq/collections-carousel-examples#url">URL</a>

<h2 id="query-search">Consulta por cadena de búsqueda</h2>

La consulta puede ser cualquier cadena con el formato que usarías en la barra de búsqueda, como `subject:dragons` o `author:mccaffrey`. 

Las cadenas de búsqueda de varias palabras deben ir entre comillas, como `subject:"dragonriders of pern"`.

Para obtener más información sobre las cadenas de búsqueda, <a href="https://openlibrary.org/search/howto" target="_blank">haz clic aquí</a>.

`{{QueryCarousel('subject:"dragons"')}}`

{{QueryCarousel('subject:"dragons"')}}

<h2 id="query-key">Consulta por clave</h2>

La consulta puede ser una lista de obras específicas. No es posible (todavía) especificar el orden exacto de las portadas de los libros. Consulta la sección <a href="https://openlibrary.org/help/faq/collections-carousel-examples#sort">ordenación</a> para conocer algunas opciones.

`{{QueryCarousel('key:(/works/OL10673093W OR /works/OL73356W OR /works/OL73385W OR /works/OL73375W OR /works/OL73384W OR /works/OL73382W OR /works/OL73387W)')}}`

{{QueryCarousel('key:(/works/OL10673093W OR /works/OL73356W OR /works/OL73385W OR /works/OL73375W OR /works/OL73384W OR /works/OL73382W OR /works/OL73387W)')}}

<h2 id="title">Añadir un título de carrusel</h2>

Añade un título encima del carrusel, que enlaza con la página de consulta.

Consulta la sección <a href="https://openlibrary.org/help/faq/collections-carousel-examples#url">url</a> para obtener instrucciones sobre cómo anular el destino del enlace.  

`{{QueryCarousel('subject:"dragons"', title="Dragones")}}`

{{QueryCarousel('subject:"dragons"', title="Dragones")}}

<h2 id="search">Añadir una barra de búsqueda en carrusel</h2>

`{{QueryCarousel('subject:"dragons"', search=True)}}`

{{QueryCarousel('subject:"dragons"', search=True)}}

<h2 id="search-title">Añadir un título y una barra de búsqueda</h2>

La barra de búsqueda aparece siempre encima del título. 

`{{QueryCarousel('subject:"dragons"', title="Dragones", search=True)}}`

{{QueryCarousel('subject:"dragons"', title="Dragones", search=True)}}

<h2 id="sort">Opciones de ordenación</h2>

Puedes ordenar por fecha de publicación (más antigua o más reciente) o por el número de escaneos o ediciones. 

**De la más antigua a la más reciente**.

Usa `sort='old'` para listar las obras por la fecha de publicación más antigua primero, lo cual es útil para darte las obras de una serie en orden. 

`{{QueryCarousel('key:(/works/OL73356W OR /works/OL73385W OR /works/OL73375W OR /works/OL73384W OR /works/OL73382W OR /works/OL73387W)', sort='old')}}`

{{QueryCarousel('key:(/works/OL73356W OR /works/OL73385W OR /works/OL73375W OR /works/OL73384W OR /works/OL73382W OR /works/OL73387W)', sort='old')}}

**De lo más reciente a lo más antiguo** 

Usa `sort='new'` para listar las obras por fecha de publicación, apareciendo primero las más recientes. 

`{{QueryCarousel('key:(/works/OL73356W OR /works/OL73385W OR /works/OL73375W OR /works/OL73384W OR /works/OL73382W OR /works/OL73387W)', sort='new')}}`

{{QueryCarousel('key:(/works/OL73356W OR /works/OL73385W OR /works/OL73375W OR /works/OL73384W OR /works/OL73382W OR /works/OL73387W)', sort='new')}}

**Escaneos, ediciones**

Esta opción debería (y normalmente lo hace) ordenar el carrusel para que las obras que se pueden tomar prestadas se muestren primero.

`{{QueryCarousel('key:(/works/OL73356W OR /works/OL73385W OR /works/OL73375W OR /works/OL73384W OR /works/OL73382W OR /works/OL73387W)', sort='scans,editions')}}`

{{QueryCarousel('key:(/works/OL73356W OR /works/OL73385W OR /works/OL73375W OR /works/OL73384W OR /works/OL73382W OR /works/OL73387W)', sort='scans,editions')}}

<h2 id="full-text">Solo texto completo</h2>

De forma predeterminada, los carruseles solo incluirán las obras que estén en la biblioteca de préstamo. Para incluir todas las obras, establece `has_fulltext_only=False`.

`{{QueryCarousel('subject:"dragons"', has_fulltext_only=True)}}`

{{QueryCarousel('subject:"dragons"', has_fulltext_only=True)}}

`{{QueryCarousel('subject:"dragons"', has_fulltext_only=False)}}`

{{QueryCarousel('subject:"dragons"', has_fulltext_only=False)}}

<h2 id="limits">Límites</h2>

Esto no es un límite de cuántas obras mostrará el carrusel. Los carruseles no tienen un límite total para el número de obras que mostrarán. Si hay 500 elementos en un resultado de búsqueda para la consulta de su carrusel y sigues haciendo clic en la flecha de la derecha, el carrusel continuará haciendo consultas de búsqueda y mostrando las siguientes obras hasta que se hayan mostrado los 500 elementos. 

**El límite es el número de elementos recuperados de la consulta de búsqueda a la vez**. El límite predeterminado es 20 y debe dejarse en 20, porque aumentar el límite también aumenta el tiempo de carga.  

Si estableces el límite a menos del número de obras que muestra el carrusel, como en el ejemplo de abajo, la flecha de la derecha no aparece nunca y no podrás hacer clic para obtener más entradas. 

`{{QueryCarousel('subject:"dragons"', limit=20)}}`

{{QueryCarousel('subject:"dragons"', limit=20)}}

`{{QueryCarousel('subject:"dragons"', limit=1)}}`

{{QueryCarousel('subject:"dragons"', limit=1)}}

<h2 id="key">Key=?</h2>

La clave `Key` es el nombre único del carrusel en *analytics*. Se puede dejar vacío. 

Se usa tanto para el análisis como para recibir los resultados de la función «cargar más». Puede dejarse vacío. Si se deja vacío, la clave del carrusel se generará a partir del *hash* de la consulta de búsqueda. Como las claves deben ser únicas, si tienes varios carruseles con la misma consulta, debes asignarles claves. 

<h2 id="url">URL</h2>

Por omisión, el parámetro `title` de un carrusel crea un título en el que se puede hacer clic y que está vinculado a la página de resultados de la consulta del carrusel. Puedes establecer un parámetro alternativo explícito `url` para cambiar el enlace del título. Asegúrate de usar la url completa, comenzando por `https://`. 

El primer carrusel de abajo tiene el enlace del título predeterminado, mientras que el segundo carrusel te lleva a la página principal de la Biblioteca Abierta.

`{{QueryCarousel('subject:"dragons"', title="Dragones")}}`

{{QueryCarousel('subject:"dragons"', title="Dragones")}}

`{{QueryCarousel('subject:"dragons"', title="Dragones", url="https://openlibrary.org")}}`

{{QueryCarousel('subject:"dragons"', title="Dragones", url="https://openlibrary.org")}}


<h2>Prueba de búsqueda por lista</h2>

`{{ListCarousel("/people/mekBot/lists/OL104041L")}}`

{{ListCarousel("/people/mekBot/lists/OL104041L")}}

`{{ListCarousel("/people/panfilomaria/lists/OL199150L")}}`

{{ListCarousel("/people/panfilomaria/lists/OL199150L")}}

`{{ListCarousel("/people/jehanni/lists/OL197286L")}}`

{{ListCarousel("/people/jehanni/lists/OL197286L")}}
title: Colecciones: Ejemplos de carruseles
m: edit