Ajuda:Llistes automàtiques/començar

Si recordem els "Elements que formen part d'una llista automàtica", que hem vist al capítol de "Presentació", anem a preparar-los:

Preparació

Construir un codi SPARQL.
- La funció principal d'aquest codi SPARQL és seleccionar el subconjunt de dades que es visualitzaran en forma de taula. Per tant, hem de tenir clar quines són les característiques/condicions del "filtre SPARQL" que ens cal (t'anirà bé saber el 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, 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'eina SPARQL i fer servir l'assistent de consultes (desplegueu-lo prement 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")
Crear el primer esborrany de la nostra llista en una pàgina d'usuari.
- Cada prova requereix guardar els canvis i cridar el bot, esperar que s'executi i mirar el resultat.
- És a dir, l'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:

Esquema de mínims

Exemple

Resultat

{{Wikidata list
| sparql = SELECT * WHERE {
   ?item Pnnn Qnnnnnn. 
   }
| columns = label, Pnn, Pmm, Pzz, item 
| sort=
| links = red 
| thumb = 60
| freq = 
}}
«Aquí hi anirà el resultat generat pel Listeriabot»
{{Wikidata list end}}

(vegeu la descripció de cada paràmetre a la seva documentació)

Seleccionarem: Ocupació (P106) = Pintor (Q1028181) +

Moviment (P135) = Modernisme (Q34636) +

Sexe o gènere (P21) = Femení (Q6581072)

Llistarem (columns): Imatge (P18), nom (label), Lloc de naixement (P19), Data de naixement (P569), Ocupació (P106)

{{Wikidata list
| sparql = SELECT * WHERE {
   ?item wdt:P106 wd:Q1028181;
     wdt:P135 wd:Q34636;
     wdt:P21 wd:Q6581072.
  }
| columns = P18,label,P19,P569,P106, item
| sort=label
| links = red
| thumb = 60
| freq = 180
}}
«Aquí hi anirà el resultat generat pel Listeriabot»
{{Wikidata list end}}

Ens centrarem en els dos paràmetres fonamentals:

Al paràmetre sparql cal posar-li el codi SPARQL que hem provat al punt anterior.
columns 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'ítem (Qid) i label, per mostrar el nom (l'etiqueta) de l'ítem WD.
La resta de paràmetres ja els ajustarem posteriorment.

Provar i ajustar

Provar
- Recordem que, després de fer els canvis, cal desar. Aquests canvis NO ES VEURAN, però no us amoïneu! Wikidata list NO fa res quan desem, tan sols guarda els paràmetres que li hem posat perquè el Listeriabot se'ls trobi i els faci servir.
- Per generar els resultats cal cridar el Listeriabot prement la icona que hi ha al costat dret de la llista.
- Revisem el resultat i fem els ajustos que calgui amb l'objectiu de que la cerca retorni allò que realment volem, sense patir per a que la informació aparegui tal ens agradaria.
- Quan la cerca "funciona", és a dir, quan surten les files corresponents al subconjunt que volíem filtrar i les columnes amb la informació que volem veure de cada element del resultat, podem seguir endavant.
Ajustar i editar continguts
- Els canvis "lleugers" que poden fer a continuació són:
  - Canviar el text estàndard de les capçaleres: afegint :<el nostre text>, darrera de les Pnnn decolumns. Només cal fer-ho en aquells encapçalaments dels que volem canviar els textos generats automàticament.
    - On teníem: P18,label,P19,P569,P106, item
    - Hi podem posar: P18:Imatge,label:Nom,P19:Lloc naixement,P569:Data naixement,P106:Ocupació, item:Qid
  - Ordenar la llista (paràmetre sort).
  - Establir la mida de la imatge, si n'hem fet servir alguna (paràmetre thumb indicant els px).
- Si ens cal fer alguna edició més complexa que requereixi un codi de tractament, ho podrem fer:
  - o bé al codi SPARQL, ampliant el "codi de mínims" que hem construït al primer punt.
  - o bé mitjançant el paràmetre row_template.
- En el primer cas, cal tenir importants coneixements SPARQL i, si es tracta de "formatar text", no acostuma a ser la millor opció.
- Si optem per la row_template, cal saber que es genera amb codi wiki com una plantilla i afecta directament a la construcció específica de cada línia. En aquest cas, cal estar familiaritzat amb la construcció de taules wiki.

Continua .. / ..

⇒ Pestanya "Tractament dades" per veure com editar continguts mitjançant el codi SPARQL abans de mostrar-los.

⇒ Pestanya "header-row template" per veure per què serveixen i com construir aquests elements.

Notes de funcionament

Wikidata list requereix que el subjecte del WHERE sigui la variable ?item. Habitualment ja és així, però quan es fa servir l'assistent de consultes a vegades li posa un nom diferent. Si això passa, caldrà canviar el nom que hagi posat l'eina i posar ?item a tots els lloc que hi aparegui i tornar a provar que tot va bé.
Wikidata list retorna sempre el label de les propietats que li demanem, no les seves Qid, a diferència d'una consulta amb SPARQL, on el valor que s'obté d'una propietat és el seu identificador Qid.