mauflix/source/templates/help.html

104 lines
4.1 KiB
HTML

{% extends "base.html" %}
{% block content %}
<div class="hero full">
<div class="hero-body">
<p class="title">Ayuda</p>
<div class="content">
<h2 id="busqueda">Sobre las búsquedas</h2>
<p>En las búsquedas existen las siguientes consideraciones:</p>
<ul>
<li>
Las búsquedas tienen un límite de cien resultados.
</li>
<li>
Cualquier búsqueda ignora tildes, mayúsculas y eñes,
así que «<a href="{% url 'search' %}?q=Iñarritú">Iñarritú</a>»
es lo mismo que «<a href="{% url 'search' %}?q=inarritu">inarritu</a>».
</li>
<li>
Cuando una búsqueda encuentra más de cien películas,
los cien resultados son seleccionados y ordenados de manera aleatoria:
<b>nunca obtendrás los mismos resultados</b>.
</li>
</ul>
<h2 id="refinamiento">Refinamiento en las búsquedas</h2>
<p>Para buscar por campos específicos se usan algunos de los siguientes prefijos:</p>
<table class="table is-striped is-narrow">
<thead>
<tr>
<th>prefijo:ejemplo</th>
<th>Descripción</th>
</tr>
</thead>
<tbody>
<tr>
<td><a href="{% url 'search' %}?q=t:lucio">t:lucio</a></td>
<td>Busca «lucio» en los títulos</td>
</tr>
<tr>
<td><a href="{% url 'search' %}?q=o:monkey">o:monkey</a></td>
<td>Busca «monkey» en los títulos en idioma original</td>
</tr>
<tr>
<td><a href="{% url 'search' %}?q=y:1989">y:1989</a></td>
<td>Busca películas publicadas en el año (<i>year</i>) «1989»</td>
</tr>
<tr>
<td><a href="{% url 'search' %}?q=p:México">p:México</a></td>
<td>Busca películas hechas en el país «México»</td>
</tr>
<tr>
<td><a href="{% url 'search' %}?q=d:varda">d:varda</a></td>
<td>Busca películas dirigidas por «varda»</td>
</tr>
<tr>
<td><a href="{% url 'search' %}?q=a:uma">a:uma</a></td>
<td>Busca películas en donde actúe «uma»</td>
</tr>
<tr>
<td><a href="{% url 'search' %}?q=g:drama">g:drama</a></td>
<td>Busca películas del género «drama»</td>
</tr>
<tr>
</tbody>
</table>
<p>Esto añade las siguientes consideraciones:</p>
<ul>
<li>
Para dos o más palabras con prefijos se usan guiones en lugar de espacios,
como en «<a href="{% url 'search' %}?q=p:estados-unidos">p:estados-unidos</a>».
</li>
<li>
Se pueden usar varias palabras con prefijos o no para restringir la búsqueda,
como en «<a href="{% url 'search' %}?q=p:mexico+d:buñuel+cielo">p:mexico d:buñuel cielo</a>».
</li>
</ul>
<h2 id="api">API</h2>
<p>
Los resultados de las búsquedas pueden ser en JSON si usas la
<a href="https://es.wikipedia.org/wiki/Interfaz_de_programaci%C3%B3n_de_aplicaciones" target="_blank">API</a>.
</p>
<h3>Obtención de películas</h3>
<p>
La API para obtener películas usa la misma sintaxis a una búsqueda ordinaria,
solo cambia la url <code>search</code> por <code>api</code>.
</p>
<p>
Es decir, en lugar de
<code><a href="{% url 'search' %}?q=p:mexico+d:cuaron">search/?q=p:mexico+d:cuaron</a></code> usa
<code><a href="{% url 'search' %}?q=p:mexico+d:cuaron"><b>api</b>/?q=p:mexico+d:cuaron</a></code>.
</p>
<h3>Obtención de ficha</h3>
<p>
Para obtener una película en específico solo necesitas su ID.
<p>
Por ejemplo, para obtener la ficha de <a href="{% url 'movie' id=1596 %}"><i>Gremlins</i></a> usa
<code><a href="{% url 'search' %}?id=1596">api/?id=1596</a></code>.
</p>
<p><i>Happy hacking</i> 😎</p>
</div>
</div>
</div>
{% endblock %}