Ajuda:Llistes automàtiques/començar: diferència entre les revisions

→‎Preparació: retocs de forma
Contingut suprimit Contingut afegit
m enllaç intro
Etiqueta: editor de codi 2017
→‎Preparació: retocs de forma
Etiqueta: editor de codi 2017
Línia 5:
=== Preparació ===
* Construir un codi SPARQL.
** La <u>funció principal</u> d'aquest codi SPARQL és <u>seleccionar el subconjunt</u> de dades que volemes visualitzaran en forma de relacionartaula. Per tant, hem de tenir clar quines són les característiques/condicions del "Filtre delfiltre SPARQL" que ens cal (''t'anirà bé saber el [[d:Wikidata:List of properties/ca|codi de les propietats]] que faràs servir'').
** Reaprofitant algun dels casos d'exemple, probablement n'hi haurà prou en saber el Qid de l'objecte a llistar (el premi del que volem saber els premiats, el l'autor del que volem veure'n les obres, etc.), i bescanviar-lo dins el "codi a copiar" al lloc on s'indica.
** Si estem fent una llista nova a mida, recomanem anar directament a l'[https://query.wikidata.org eina SPARQL] i fer servir l'<u>assistent de consultes</u> (adesplegueu-lo l'esquerraprement el botó "i" del marge esquerre) per escriure les condicions de selecció i provar que el resultat (de moment, les files) que surten són les que volem.
** A més de filtrar, també ens pot servir per fer alguna tasca de preparació de dades. (''veure "[[#Provar i ajustar|Provar i ajustar]]"'')
* Crear el primer esborrany de la nostra llista en una <u>pàgina d'usuari</u>.
** Cada prova requereix guardar els canvis i cridar el bot, esperar que s'executi i mirar el resultat.
** És a dir, el proval'assaig-error requereix temps i tindrem la pàgina segrestada fins que acabem. Per tant, fins que no tinguem una versió definitiva, cal treballar en una pàgina de prova personal.
** Comencem sempre per posar un codi mínim:
{|
Línia 28:
&#124; thumb = 60
&#124; freq = </span><br>&#125;&#125;
''<span class=generated>«Aquí hi anirà el resultat generat pel Listeriabot»</span>''
&#123;&#123;<span class=wdlist>Wikidata list end</span>&#125;&#125;
 
::''<small>(vegeu la descripció de cada paràmetre a la [[Plantilla:Wikidata list|seva documentació]])</small>''
|Seleccionarem: {{P|P106}} = {{Q|Q1028181}} +
 
Línia 50:
&#124; thumb = 60
&#124; freq = 180</span><br>&#125;&#125;
''<span class=generated>«Aquí hi anirà el resultat generat pel Listeriabot»</span>''
&#123;&#123;<span class=wdlist>Wikidata list end</span>&#125;&#125;
|[[Fitxer:Print Listeriabot sample-1.jpg|miniatura|Resultat que haurem de veure amb el codi de mostra ]]
|}
Ens '''centrarem en els dos''' paràmetres fonamentals:
:*Al paràmetre <code><span class=paramcode>sparql</span></code> cal posar-li el codi SPARQL que hem provat al punt anterior.
:*<code><span class=paramcode>columns</span></code> ha de tenir, de moment, el codi de les propietats que volem mostrar. Observeu que, a més de codis de propietat, hi ha dos noms especials: '''''item''''', per obtenir l'identificador de l'itemítem (Qid) i '''''label''''', per mostrar el nom (l'etiqueta) de l'itemítem WD.
:*La resta de paràmetres ja els ajustarem posteriorment.