Skip to content

Commit be2914e

Browse files
authored
Merge pull request #3465 from programminghistorian/Issue-3464
Issue-3464-intro-linked-data-images
2 parents 43d0b69 + 837b403 commit be2914e

14 files changed

+20
-19
lines changed

en/lessons/intro-to-linked-data.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -101,11 +101,11 @@ The presentation (or [syntax](https://en.wikipedia.org/wiki/Syntax)) of triples,
101101

102102
The traditional way to represent a triple in diagrammatic form is:
103103

104-
{% include figure.html filename="intro-to-linked-data-fig5.png" caption="the classic way to represent a triple" %}
104+
{% include figure.html filename="en-or-intro-to-linked-data-01.png" caption="Figure 1. The classic way to represent a triple." %}
105105

106106
So our Jack Straw triple, in more human-readable form, could be represented like this:
107107

108-
{% include figure.html filename="intro-to-linked-data-fig6.png" caption="triple diagram showing that Jack Straw represented Blackburn" %}
108+
{% include figure.html filename="en-or-intro-to-linked-data-02.png" caption="Figure 2. Triple diagram showing that Jack Straw represented Blackburn." %}
109109

110110
For now there are three key points to remember:
111111

@@ -323,7 +323,7 @@ The SPARQL query end point I use is called [snorql](http://dbpedia.org/snorql/).
323323

324324
If you go to the snorql URL above you will see at first that a number of prefixes have already been declared for us, which is handy. You'll recognise some of the prefixes now too.
325325

326-
{% include figure.html filename="intro-to-linked-data-fig1.png" caption="snorql's default query box, with some prefixes declared for you" %}
326+
{% include figure.html filename="en-or-intro-to-linked-data-03.png" caption="Figure 3. snorql's default query box, with some prefixes declared for you." %}
327327

328328
In the query box below the prefix declarations you should see:
329329

@@ -343,7 +343,7 @@ Let's start with something simple to see how this works. Paste (or, better, type
343343

344344
Hit 'go' and, if you left the drop-down box as 'browse' you should get two columns labelled "b" and "c". (Note that here, searching for a string, case does matter: lyndal_roper will get you no results.)
345345

346-
{% include figure.html filename="intro-to-linked-data-fig2.png" caption="top of results lists for a query for all triples with 'Lyndal_Roper' as subject" %}
346+
{% include figure.html filename="en-or-intro-to-linked-data-04.png" caption="Figure 4. Top of results lists for a query for all triples with 'Lyndal_Roper' as subject." %}
347347

348348
So what just happened? And how did I know what to type?
349349

@@ -371,7 +371,7 @@ I've made a small change here. If this query works at all then I expect my histo
371371

372372
Run the query. Does it work for you? I get a big list of historians.
373373

374-
{% include figure.html filename="intro-to-linked-data-fig3.png" caption="historians, according to DBpedia" %}
374+
{% include figure.html filename="en-or-intro-to-linked-data-05.png" caption="Figure 5. Historians, according to DBpedia." %}
375375

376376
So this works for creating lists, which is useful, but it would much more powerful to combine lists, to get intersections of sests. I found a couple more things that might be interesting to query in Lyndal Roper's DBpedia attributes: <http://dbpedia.org/class/yago/WikicatBritishHistorians> and <http://dbpedia.org/class/yago/WikicatWomenHistorians>. It's very easy to combine these by asking a for a variable to be returned (in our case this is `?name`) and then using that in multiple lines of a query. Note as well the space and full point at the end of the first line beginning with `?name`:
377377

@@ -383,7 +383,7 @@ So this works for creating lists, which is useful, but it would much more powerf
383383

384384
It works! I get five results. At the time of writing, there are five British, women historians in *DBpedia*...
385385

386-
{% include figure.html filename="intro-to-linked-data-fig4.png" caption="British historians who are women, according to DBpedia" %}
386+
{% include figure.html filename="en-or-intro-to-linked-data-06.png" caption="Figure 6. British historians who are women, according to DBpedia." %}
387387

388388
Only five British women historians? Of course there are, in reality, many more than that, as we could easily show by substituting the name of, say, Alison Weir in our first Lyndal Roper query. This brings us to the problem with *Dbpedia* that I mentioned earlier: it's not very consistently marked up with structural information of the type *DBpedia* uses. Our query can list some British women historians but it turns out that we can't use it to generate a meaningful list of people in this category. All we've found is the people in entries in *Wikipedia* that someone has decided to categorise as "British historian" and "woman historian".
389389

es/lecciones/introduccion-datos-abiertos-enlazados.md

+8-6
Original file line numberDiff line numberDiff line change
@@ -101,10 +101,12 @@ La presentación (o [sintaxis](https://es.wikipedia.org/wiki/Sintaxis)) de las t
101101
| persona 64183282 | representanteEnElParlamentoUK | "blackburn1955-current" |
102102

103103
La forma tradicional de representar una tripleta en forma de diagrama es:
104-
{% include figure.html filename="intro-a-datos-enlazados-fig5.png" caption="Manera clásica de representar una tripleta" %}
104+
105+
{% include figure.html filename="es-tr-intro-a-datos-enlazados-01.png" caption="Figura 1. Manera clásica de representar una tripleta." %}
105106

106107
Así que nuestra tripleta de Jack Straw, en una forma más legible para los humanos, podría representarse así:
107-
{% include figure.html filename="intro-a-datos-enlazados-fig6.png" caption="Diagrama triple que muestra que Jack Straw representó a Blackburn" %}
108+
109+
{% include figure.html filename="es-tr-intro-a-datos-enlazados-02.png" caption="Figura 2. Diagrama triple que muestra que Jack Straw representó a Blackburn." %}
108110

109111
Por ahora hay tres puntos clave que recordar:
110112

@@ -311,7 +313,7 @@ Vamos a ejecutar nuestras consultas SPARQL en [DBpedia](https://es.wikipedia.org
311313
El punto de entrada (*endpoint*) de consulta SPARQL que yo uso se llama [snorql](http://dbpedia.org/snorql/). Estos puntos de entrada a veces parecen desconectarse, por lo que, si ese fuera el caso, busca *dbpedia sparql* en internet para encontrar un reemplazo similar.
312314

313315
Si vas a la URL snorql indicada antes, verás que al principio ya están declarados varios prefijos, lo cual te será útil. También reconocerás ya algunos de los prefijos.
314-
{% include figure.html filename="intro-to-linked-data-fig1.png" caption="cuadro de consulta predeterminado de snorql, con algunos prefijos declarados para ti" %}
316+
{% include figure.html filename="en-or-intro-to-linked-data-03.png" caption="Figura 3. Cuadro de consulta predeterminado de snorql, con algunos prefijos declarados para ti." %}
315317

316318
En el cuadro de consulta, debajo de las declaraciones de prefijo, deberías ver:
317319

@@ -331,7 +333,7 @@ Comencemos con algo simple para ver cómo funciona esto. Pega esto (o, mejor, es
331333

332334
Haz clic en "Go!"(ir) y, si dejaste el cuadro desplegable como "Browse" (navegar), deberías obtener dos columnas con la etiqueta "b" y "c". (Ten en cuenta que aquí, buscando una cadena, las mayúsculas y minúsculas sí importan: lyndal_roper no te dará ningún resultado).
333335

334-
{% include figure.html filename="intro-to-linked-data-fig2.png" caption="Parte inicial de la lista de resultados de una consulta para todas las tripletas con 'Lyndal_Roper' como sujeto" %}
336+
{% include figure.html filename="en-or-intro-to-linked-data-04.png" caption="Figura 4. Parte inicial de la lista de resultados de una consulta para todas las tripletas con 'Lyndal_Roper' como sujeto." %}
335337

336338
Recapitulando, ¿qué acaba de pasar? ¿Y cómo sé qué escribir?
337339

@@ -359,7 +361,7 @@ He hecho un pequeño cambio aquí. Si esta consulta funciona entonces espero que
359361

360362
Ejecuta la consulta. ¿Te funciona? Yo obtuve una gran lista de historiadores.
361363

362-
{% include figure.html filename="intro-to-linked-data-fig3.png" caption="historiadores, según DBpedia" %}
364+
{% include figure.html filename="en-or-intro-to-linked-data-05.png" caption="Figura 5. Historiadores, según DBpedia." %}
363365

364366
Así que esto funciona para crear listas, lo cual es útil, pero sería mucho más potente combinar listas, para obtener intersecciones de conjuntos. Encontré un par de cosas más que podrían ser interesantes para consultar en los atributos de DBpedia de Lyndal Roper: <http://dbpedia.org/class/yago/WikicatBritishHistorians> y <http://dbpedia.org/class/yago/WikicatWomenHistorians>. Es muy fácil combinarlos pidiendo una variable que retornará (en nuestro caso, esta es `?name`) y luego usar eso en múltiples líneas de una consulta. Ten en cuenta también el espacio y el punto al final de la primera línea que comienza con `?name`:
365367

@@ -372,7 +374,7 @@ Así que esto funciona para crear listas, lo cual es útil, pero sería mucho m
372374

373375
¡Funciona! Obtengo cinco resultados. En el momento de escribir, hay cinco historiadoras británicas en *DBpedia*...
374376

375-
{% include figure.html filename="intro-to-linked-data-fig4.png" caption="Historiadoras británicas, según DBpedia" %}
377+
{% include figure.html filename="en-or-intro-to-linked-data-06.png" caption="Figura 6. Historiadoras británicas, según DBpedia." %}
376378

377379
¿Solo cinco mujeres británicas historiadoras? Por supuesto que hay, en realidad, muchas más que eso, como podríamos demostrar fácilmente sustituyendo el nombre de, digamos, Alison Weir en nuestra primera consulta de Lyndal Roper. Esto nos lleva al problema con *Dbpedia* que mencioné anteriormente: no está marcado de manera consistente con información estructural del tipo que usa *DBpedia*. Nuestra consulta puede enumerar algunas historiadoras británicas, pero resulta que no podemos usarla para generar una lista significativa de personas en esta categoría. Todo lo que hemos encontrado es la gente en las entradas en Wikipedia que alguien ha decidido categorizar como "Historiador británico" y "mujer historiadora".
378380

images/intro-to-linked-data/create.md

-1
This file was deleted.

pt/licoes/introducao-dados-abertos-conectados.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -109,11 +109,11 @@ A apresentação (ou [sintaxe](https://pt.wikipedia.org/wiki/Sintaxe)) das tripl
109109

110110
A forma tradicional de representar uma tripla semântica em forma esquemática é a seguinte (em inglês):
111111

112-
{% include figure.html filename="introducao-dados-abertos-conectados-fig1.png" alt="Imagem com a representação de uma tripla semântica" caption="Forma tradicional de representar uma tripla semântica" %}
112+
{% include figure.html filename="pt-tr-introducao-dados-abertos-conectados-01.png" alt="Imagem com a representação de uma tripla semântica" caption="Figura 1. Forma tradicional de representar uma tripla semântica." %}
113113

114114
Assim, a nossa tripla semântica do Jack Straw, apresentado de forma mais legível para o ser humano, poderia assumir a seguinte forma:
115115

116-
{% include figure.html filename="introducao-dados-abertos-conectados-fig2.png" alt="Imagem com a representação de uma tripla semântica aplicada ao exemplo de Jack Straw" caption="Diagrama da tripla semântica que demonstra que Jack Straw representava Blackburn" %}
116+
{% include figure.html filename="pt-tr-introducao-dados-abertos-conectados-02.png" alt="Imagem com a representação de uma tripla semântica aplicada ao exemplo de Jack Straw" caption="Figura 2. Diagrama da tripla semântica que demonstra que Jack Straw representava Blackburn." %}
117117

118118
Por enquanto, é importante fixar três pontos-chave:
119119

@@ -329,7 +329,7 @@ O end point de consulta SPARQL que é utilizado chama-se [snorql](http://dbpedia
329329

330330
Se for ao URL snorql acima verá, no início, um número de prefixos que já nos foram declarados, o que é útil. Agora também irá reconhecer alguns dos prefixos.
331331

332-
{% include figure.html filename="intro-to-linked-data-fig1.png" alt="Captura de tela com a interface de criação de consultas snorql" caption="Caixa de consulta padrão do snorql, com alguns prefixos declarados para si" %}
332+
{% include figure.html filename="en-or-intro-to-linked-data-03.png" alt="Captura de tela com a interface de criação de consultas snorql" caption="Figura 3. Caixa de consulta padrão do snorql, com alguns prefixos declarados para si." %}
333333

334334
Na caixa de consulta abaixo das declarações de prefixo, deverá ver o seguinte:
335335

@@ -350,7 +350,7 @@ Vamos começar com algo simples para ver como é que isto funciona. Cole (ou, me
350350
Clique em '*go*' (ir). Se deixar o menu *drop-down* como '*browse*' (navegar) deverá obter duas colunas com os rótulos "b" e "c". (Note que aqui, ao procurar uma cadeia de caracteres, as maiúsculas/minúsculas importam: lyndal_roper não lhe dará resultados).
351351

352352

353-
{% include figure.html filename="intro-to-linked-data-fig2.png" alt="Captura de tela com a interface de resultados de consultas snorql" caption="Topo das listas de resultados de uma consulta com todas as triplas semânticas com 'Lyndal_Roper' como sujeito" %}
353+
{% include figure.html filename="en-or-intro-to-linked-data-04.png" alt="Captura de tela com a interface de resultados de consultas snorql" caption="Figura 4. Topo das listas de resultados de uma consulta com todas as triplas semânticas com 'Lyndal_Roper' como sujeito." %}
354354

355355
Então o que é que acabou de acontecer? E como é que soubemos o que escrever?
356356

@@ -378,7 +378,7 @@ Fizemos uma pequena mudança aqui. Se esta consulta funcionar de todo, então es
378378

379379
Execute a *querie*. Deverá encontrar uma grande lista de historiadores.
380380

381-
{% include figure.html filename="intro-to-linked-data-fig3.png" alt="Duas capturas de tela com a interface de consultas snorql e respectivos resultados" caption="Historiadores de acordo com a DBpedia" %}
381+
{% include figure.html filename="en-or-intro-to-linked-data-05.png" alt="Duas capturas de tela com a interface de consultas snorql e respectivos resultados" caption="Figura 5. Historiadores de acordo com a DBpedia." %}
382382

383383
Assim, esta ferramenta funciona para criar listas, o que é útil, mas seria muito mais poderoso combinar listas para obter intersecções de conjuntos. Encontrei mais algumas coisas que podem ser interessantes consultar nos atributos DBpedia de Lyndal Roper: <http://dbpedia.org/class/yago/WikicatBritishHistorians> e <http://dbpedia.org/class/yago/WikicatWomenHistorians>. É muito fácil combiná-los pedindo uma variável a ser devolvida (no nosso caso isto é `?name` (nome)) e depois utilizando-a em múltiplas linhas de uma *querie*. Note também o espaço e o ponto completo no final da primeira linha que começa com `?name`:
384384

@@ -390,7 +390,7 @@ Assim, esta ferramenta funciona para criar listas, o que é útil, mas seria mui
390390

391391
Funciona! Devemos obter cinco resultados. Na altura em que escrevo, há cinco historiadoras britânicas na *DBpedia*...
392392

393-
{% include figure.html filename="intro-to-linked-data-fig4.png" alt="Duas capturas de tela com a interface de consultas snorql e respectivos resultados" caption="Historiadoras britânicas segundo a DBpedia" %}
393+
{% include figure.html filename="en-or-intro-to-linked-data-06.png" alt="Duas capturas de tela com a interface de consultas snorql e respectivos resultados" caption="Figura 6. Historiadoras britânicas segundo a DBpedia." %}
394394

395395
Apenas cinco historiadoras britânicas? Claro que há, na realidade, muitas mais do que isso, como poderíamos facilmente mostrá-lo substituindo o nome de, digamos, Alison Weir na nossa primeira consulta sobre Lyndal Roper. Isto leva-nos ao problema com a *Dbpedia* que mencionamos anteriormente: não é muito consistentemente marcado com informação estrutural do tipo que a *DBpedia* que utiliza. A nossa consulta pode listar algumas historiadoras britânicas mas acontece que não podemos utilizá-la para gerar uma lista significativa de pessoas nesta categoria. Tudo o que encontrámos foram as pessoas nas entradas da *Wikipedia* que alguém decidiu classificar como "historiadora britânica" e "historiadora".
396396

0 commit comments

Comments
 (0)