Ajuda:Llistes automàtiques/començar: diferència entre les revisions
Contingut suprimit Contingut afegit
Cap resum de modificació |
|||
Línia 6: | Línia 6: | ||
**La <u>funció principal</u> d'aquest codi SPARQL és <u>seleccionar el subconjunt</u> que volem llistar. Per tant, hem de tenir clar quines són les característiques/condicions del "Filtre del SPARQL" que ens cal. |
**La <u>funció principal</u> d'aquest codi SPARQL és <u>seleccionar el subconjunt</u> que volem llistar. Per tant, hem de tenir clar quines són les característiques/condicions del "Filtre del SPARQL" que ens cal. |
||
**Si reaprofitem 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 reaprofitem 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'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. |
**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]]"'') |
**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>. |
*Crear el primer esborrany de la nostra llista en una <u>pàgina d'usuari</u>. |
||
Línia 12: | Línia 12: | ||
**És a dir, el prova-error, requereix temps i tenim la pàgina segrestada fins que acabem. Per tant, fins no tenir una versió definitiva, cal treballar en una pàgina de prova personal. |
**És a dir, el prova-error, requereix temps i tenim la pàgina segrestada fins que acabem. Per tant, fins no tenir una versió definitiva, cal treballar en una pàgina de prova personal. |
||
**Comencem sempre per posar un codi mínim: |
**Comencem sempre per posar un codi mínim: |
||
{| |
|||
⚫ | |||
!Esquema de mínims |
|||
!Exemple |
|||
|- valign=top |
|||
⚫ | |||
<span class=dgblue>| sparql = </span><span class=sparqlcode>SELECT * WHERE { |
<span class=dgblue>| sparql = </span><span class=sparqlcode>SELECT * WHERE { |
||
'''?item''' P''nnn'' Q''nnnnnn''. |
'''?item''' P''nnn'' Q''nnnnnn''. |
||
Línia 25: | Línia 29: | ||
::''<small>(descripció de cada paràmetre a la [[Plantilla:Wikidata list|seva documentació]])</small>'' |
::''<small>(descripció de cada paràmetre a la [[Plantilla:Wikidata list|seva documentació]])</small>'' |
||
|{{<span class=wdlist>Wikidata list</span> |
|||
|<span class=dgblue> sparql = </span><span class=sparqlcode>SELECT * WHERE { |
|||
?item wdt:P106 wd:Q1028181; |
|||
wdt:P135 wd:Q34636; |
|||
wdt:P21 wd:Q6581072. |
|||
}</span> |
|||
<span class=param>| columns = P18,label,P19,P569,P106, item |
|||
| sort=label |
|||
| links = red |
|||
| thumb = 60 |
|||
| freq = 180</span><br>}} |
|||
''<span class=generated>«Aquí anirà el resultat generat pel Listeriabot»</span>'' |
|||
{{<span class=wdlist>Wikidata list end</span>}} |
|||
|} |
|||
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. |
:*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, existeixen dos noms especials: '''''item''''', per obtenir |
:*<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, existeixen 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. |
:*La resta de paràmetres ja els ajustarem posteriorment. |
||
=== Provar i ajustar === |
=== Provar i ajustar === |
||
* '''Provar''' |
* '''Provar''' |
||
**Recordem que després de fer els canvis, cal guardar |
** Recordem que després de fer els canvis, cal guardar. NO ES VEURAN els canvis, no us amoïneu!, ja que la '''Wikidata list''' NO fa res quan desem. |
||
** Per veure'ls cal cridar el Listeriabot prement "'''Actualitzar ara'''", al costat dret de la llista. |
** Per veure'ls cal cridar el Listeriabot prement la icona [[file:Fxemoji u1F504.svg|20px|"'''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. |
** 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, 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. |
**Quan "funciona", és a dir, 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. |
Revisió del 23:24, 27 feb 2021
Si recordem els "Elements que en formen part de la solució", 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 que volem llistar. Per tant, hem de tenir clar quines són les característiques/condicions del "Filtre del SPARQL" que ens cal.
- Si reaprofitem 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'eina SPARQL i fer servir l'assistent de consultes (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")
- 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, el prova-error, requereix temps i tenim la pàgina segrestada fins que acabem. Per tant, fins no tenir 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 |
---|---|
{{Wikidata list
| sparql = SELECT * WHERE { ?item Pnnn Qnnnnnn. } | columns = label, Pnn, Pmm, Pzz, item | sort= | links = red | thumb = 60 | freq =
|
{{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 |
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, existeixen 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.
- Al paràmetre
Provar i ajustar
- Provar
- Recordem que després de fer els canvis, cal guardar. NO ES VEURAN els canvis, no us amoïneu!, ja que la Wikidata list NO fa res quan desem.
- Per veure'ls cal cridar el Listeriabot prement la icona , 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, surten les files corresponents al subconjunt que volíem filtrar i les columnes amb la informació que volem veure, podem seguir endavant.
- Ajustar i editar continguts
- Els canvis "lleugers" que poden fer a continuació són:
- canviar text capçaleres estàndard: afegint
:<el nostre text>
, darrera de les Pnnn decolumns
. Només cal fer-ho en aquells que volem canviar. - ordenar la llista. (paràmetre
sort
) - mida de la imatge, si n'hem fet servir alguna. (paràmetre
thumb
indicant els px)
- canviar text capçaleres estàndard: afegint
- 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
, és 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.
- Els canvis "lleugers" que poden fer a continuació són:
Continua .. / ..
- ⇒ pestanya "Paràmetres Wikidata List" per veure més exemples dels paràmetres de la {{Wikidata list}}
- ⇒ pestanya "Tractament dades" per veure com editar continguts mitjançant el codi SPARQL abans de mostrar-los.
- ⇒ pestanya "header-row template" per veure perquè 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 la seva Qid i per obtenir el label, cal fer servir
?<variable>Label
.