Diferència entre revisions de la pàgina «Ajuda:Llistes automàtiques/començar»

m
Correccions puntuals (ortografia i gramàtica).
m (Correccions puntuals (ortografia i gramàtica).)
=== Preparació ===
* Construir un codi SPARQL.
**La <u>funció principal</u> d'aquest codi SPARQL és <u>seleccionar el subconjunt</u> que volem llistarrelacionar. Per tant, hem de tenir clar quines són les característiques/condicions del "Filtre del SPARQL" que ens cal (''et vindràt'anirà bé saber el [[d:Wikidata:List of properties/ca|codi de les propietats]] que faràs servir'').
**Si reaprofitemReaprofitant algun dels casos d'exemple, probablement n'hi haurà prou en saber el Qid de l'objecte a llistar (el premi del que volem els premiats, el autor del que volem 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> (a l'esquerra) 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 prova-error, requereix temps i tenimtindrem la pàgina segrestada fins que acabem. Per tant, fins que no tenirtinguem una versió definitiva, cal treballar en una pàgina de prova personal.
**Comencem sempre per posar un codi mínim:
{|
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, existeixenhi ha dos noms especials: '''''item''''', per obtenir l'identificador de l'item (Qid) i '''''label''''', per mostrar el nom de l'item WD.
:*La resta de paràmetres ja els ajustarem posteriorment.
 
=== Provar i ajustar ===
* '''Provar'''
** Recordem que, després de fer els canvis, cal guardar. NO ES VEURAN els canvis, no us amoïneu!. '''Wikidata list''' NO fa res quan desem, tant sols guarda els paràmetres que li hem posat per a queperquè el Listeriabot se'ls trobi i els faci servir.
** Per generar els resultats cal cridar el Listeriabot prement la icona [[file:Fxemoji u1F504.svg|15x15px|"'''Actualitzar ara'''"]], al costat dret de la llista.
** Revisem el resultat i fem els ajustos que calgui amb l'objectiu de que surti allò que ha de sortir, NO necessàriament COM ha de sortir.
**Quan "funciona", és a dir, quan surten les <u>files corresponents al subconjunt que volíem filtrar</u> i les <u>columnes amb la informació que volem veure</u>, podem seguir endavant.
*'''Ajustar i editar continguts'''
**Els canvis "lleugers" que poden fer a continuació són:
***<u>canviarCanviar text capçaleres</u> estàndard: afegint <code><span class=paramcode>''':<''el nostre text''>'''</span></code>, darrera de les P''nnn'' de<code><span class=paramcode>columns</span></code>. Només cal fer-ho en aquells que volem canviar els textos que ens ha generat automàticament.[[Fitxer:Print Listeriabot sample-header.jpg|dreta|561x561px]]
****On teníem: <span class="param">P18,label,P19,P569,P106, item</span>
****Hi podem posar: <span class="param">P18:Imatge,label:Nom,P19:Lloc naixement,P569:Data naixement,P106:Ocupació, item:Qid</span>
***ordenarOrdenar la llista. (paràmetre <code><span class=paramcode>sort</span></code>).
***Establir la mida de la imatge, si n'hem fet servir alguna. (paràmetre <code><span class=paramcode>thumb</span></code> indicant els px).
**Si ens cal fer alguna edició més complexa que requereixi un codi de tractament, ho podrem fer:
***o bé al <span class=sparqlcode>codi SPARQL</span>, ampliant el "codi de mínims" que hem construït al primer punt.
***o bé mitjançant el paràmetre <code><span class=paramcode>row_template</span></code>.
**En el primer cas, cal tenir <u>importants coneixements SPARQL</u> i, si es tracta de "formatar text", no acostuma a ser la millor opció.
**Si optem per la <code>row_template</code>, éses fa amb codi wiki com a una plantilla i té incidència directa amb la construcció específica de cada línia. En aquest cas, cal estar familiaritzat amb la construcció de taules wiki.
 
=== Continua .. / .. ===
:<span class="flow"><big><big>⇒</big></big></span> pestanyaPestanya <span class="flow">"Tractament dades"</span> per veure com editar continguts mitjançant el codi SPARQL abans de mostrar-los.
:<span class=flow><big><big>⇒</big></big></span> pestanyaPestanya <span class=flow>"header-row template"</span> per veure perquèper què serveixen i com construir aquests elements.
 
=== Notes de funcionament ===
* '''Wikidata list''' requereix que el subjecte del <code><span class=sparqlcode>''WHERE''</span></code> sigui la variable <code><span class=sparqlcode>'''?item'''</span></code>. 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., Aa diferència d'una consulta amb SPARQL, on el valor que s'obté d'una propietat és el seu identificador Qid.
5.236

modificacions