I see a lot of potential in this, and already see some use-cases. Unfortunately I don’t have the bandwith, nor the full skills to make this happens. So I am just writing this in the hope that the idea is implemented by someone, or that someone tells me it is totally nonsense…

Here are the semantic annotations use-cases I see with such a Semantic Markdown :

1. Annotate a span or title that corresponds to an entity ;
2. Annotate a piece of text with an existing URI for an entity;
3. Create some statements on an entity;

Note that I am not necessarily looking for a way to produce RDFa annotations on the generated HTML, although that would be nice for a schema.org use-case. Any conversion route from the original semantically annotated markdown to a set of triples would be fine.

My source of inspiration is essentially Span Inline Attribute Lists » from the Kramdown syntax.

Annotate a span that corresponds to an entity

This piece of Semantic Markdown :

Tomorrow I am travelling to _Berlin_ {.schema:Place}

When interprered by a Semantic Markdown parser would produce this set of triples :

_:1 a <http://schema.org/Place> .
_:1 rdfs:label “Berlin” .

The span immediately preceding the « {.xxxx} » annotation is taken as the label of the entity. The use of rdfs:label to store the label of the entity could be subject to a parser configuration option.

One could imagine that a semantic markdown parser relies on the same RDFa Initial Context to interpret the « schema: » prefix without further declaration. But what about other ontologies ? we would need some kind of prefixes / vocab declaration somewhere in the document, just like in RDFa.

Note also that Markdown parser supporting the « {.xxxxx} » syntax will also insert this value as a CSS class on the corresponding span, so we win both on the CSS level and the semantic level.

Annotate a title

Similarly, we could annotate a title

### European Semantic Web Conference {.schema:Event}
Lorem ipsum...

In that case, the full content of the title is interpreted as the label of the entity :

_:1 a <http://schema.org/Event> .
_:1 rdfs:label “European Semantic Web Conference” .

Annotate with a known URI

Tomorrow I am travelling to [Berlin](https://www.wikidata.org/wiki/Q64) {.schema:Place}

Would yield

<https://www.wikidata.org/wiki/Q64> a <http://schema.org/Place> .
<https://www.wikidata.org/wiki/Q64> rdfs:label “Berlin” .

Describe an entity

If a list follows an annotated entity, then it should be interpreted as a set of predicates with this entity as subject :

### Specifications Meeting {.schema:Event}

* Date : _11/10_{.schema:startDate}
* Place {.schema:location} : Our office, Street name, 75014 Paris
* Meeting participants : 
  {.schema:attendee}
  * Thomas Francart{.schema:Person}
  * [Someone else](https://www.wikidata.org/wiki/Q80)
  * Tim Foo
* Description : Some information not annotated

### titre suivant
Lorem ipsum...

Should yield :

_:1 a <http://schema.org/Event> .
_:1 rdfs:label “Specifications Meeting” .
_:1 <http://schema.org/startDate> "11/10" .
_:1 <http://schema.org/location> "Our office, Street name, 75014 Paris" .
_:1 <http://schema.org/attendee> _:2 , <https://www.wikidata.org/wiki/Q80>, _:3 .

# attendee that is annotated : we know a type and a name
_:2 a <http://schema.org/Person>
_:2 rdfs:label “Thomas Francart” .

# attendee that is annotated with a URI : we keep the URI and add a label to it (?)
<https://www.wikidata.org/wiki/Q80> rdfs:label "Someone else" .

# attendee that is not annotated - but we know he was an attendee
_:3 rdfs:label "Tim Foo" .

1. If a list follows a title or a paragraph that contains an annotated entity…
2. Then items in this list correspond to a property of this entity…
3. And can be annotated with a property
4. The property annotation can be placed on an inline text, or right before or after a `:` or `=` character
5. If the property annotation immediatly precedes a list, then all items in this list would be considered values for that property, and in that case could be either : entities annotated with a type, or entities identified by a URI, or entites not annotated (and in that case we would consider them as blank nodes with only a label

Related works

Metadata for Markdown, a Python extension to generated JSON-LD from YAML section in a Markdown document.

EDIT : PanDoc divs and spans : https://pandoc.org/MANUAL.html#divs-and-spans

I like the <span> syntax :

[This is *some text*]{.class key="val"}

This is close ! but still would not produce triples, unless one writes explicitely RDFa :

My name is [Thomas Francart]{typeof="schema:Person"}

Cet article Semantic Markdown Specifications est apparu en premier sur Sparna Blog.

Je continue à creuser le sillon entamé précédemment de démos simples et réutilisables de ce que peuvent apporter les données disponibles sur le web pour enrichir un texte, sans infrastructure compliquée. Pour cela je vous invite à entrer dans le laboratoire de sparna.fr ! http://labs.sparna.fr sera un terrain de jeu qui hébergera dans le futur d’autres applications et illustrations des technologies du web de données et de l’open data, « so stay tuned » !

Mais revenons à la démo, ou aux démos puisqu’il s’agit de 2 pages :

• la première page de démo est un article scientifique en français enrichi grâce aux données de la base Isidore;
• la seconde est un article de presse en anglais enrichi grâce aux données de DBpedia.

Qu’est-ce qu’elles illustrent ?

1. La génération du contenu d’une partie du contenu à partir des données du web : ici, la génération automatique de la liste des articles du même auteur dans la page Isidore;
2. L’affichage d’informations contextuelles lorsqu’on clique sur un élément annoté dans le texte : dans le cas de l’article scientifique, on va chercher sur Isidore, dans le cas de la news, sur DBpedia, mais le principe est le même : on affiche un encart avec titre, photo, définition ou description et un lien vers une page plus complète;
3. Dans la démo DBpedia, la l’affichage sur une carte des noms de lieux mentionnés dans le texte : les noms des villes, régions ou pays sont marqués avec un identifiant DBpedia, et on va récupérer dynamiquement l’information de positionnement dans DBpedia, pour afficher un marqueur sur la carte; la carte et le texte sont synchronisés, quand on passe la souris sur un lieu géographique dans le texte, le marqueur correspondant sur la carte se met en surbrillance, et inversement;
4. Dans la démo Isidore, la navigation dans les termes des thesaurus; certains mots du texte dans l’article (« habitat », « XVIIIe siècle », etc.) renvoient vers les concepts abstraits d’un thesaurus; on récupère alors les notions plus génériques et plus spécifiques de cette notion, qui seront elles-mêmes cliquables et permettent donc de naviguer dans la hiérarchie des terminologies associées à l’article;
5. Dans le démo DBpedia, la possibilité d’afficher les informations dans plusieurs langues, simplement en changeant un paramètre de la page : essayez en français, en russe, en néerlandais, etc. vous avez compris l’idée, il suffit de changer le paramètre de langue dans l’adresse de la page;
6. Enfin, tout cela illustre l’interrogation de bases SPARQL directement depuis les pages HTML, sans infrastructure serveur, puisque les requêtes sont envoyées en utilisant JSONP depuis du javascript; A noter que cela demande que le endpoint SPARQL supporte le JSONP; c’est le cas de Virtuoso qui est utilisé pour DBpedia et Isidore; Sesame le supportera dans sa prochaine version.

Que peut-on imaginer à partir de ça ? Plusieurs idées :

• se brancher derrière un annotateur automatique qui mettrait les annotations automatiquement (type DBpedia Spotlight), pour présenter une interface de navigation enrichie à partir de n’importe quel texte;
• imaginer une interface de navigation dans des thesaurus SKOS que l’on pourrait « brancher » sur n’importe quelle source de données contenant du SKOS pour naviguer dans des terminologies;

Vos idées et vos cas d’usage sont les bienvenus ! n’hésitez pas à montrer ces pages comme des démos ou à les récupérer et les adapter avec votre propre contenu !

English summary :

I have launched http://labs.sparna.fr and I am presenting 2 demos of articles augmented with linked data :

• the first one is a demo of a news article in english augmented with DBpedia data;
• the second one is a demo of a scientific article in french augmented with data from Isidore (Isidore is a data repository containing humanities articles metadata and classification thesaurii);

These pages illustrate :

• How you can generate part of the content dynamically from the web of data : the list of articles from the same author in the Isidore demo is fetched dynamically when the page loads;
• How you can pull and display contextual information besides the text, in an « infobox », when the reader clicks an underlined word;
• How you can fetch geographic coordinates from DBpedia to automatically plot the locations mentionned in the text on a map (provided they have been « tagged » with a DBpedia identifier), in the DBpedia demo;
• How you can navigate thesaurus terms in the Isidore demo : some words correspond to thesaurus concepts (« habitat », « XVIIIe siècle »), thus generic and specific concepts are displayed in the infobox;
• That the data in DBpedia can be fecthed in diferent languages to adapt to the reader’s language : try to load the DBpedia demo in french, in russian, in dutch… and try playing with the 2-letter language code in the URLs to display other languages;
• How SPARQL queries can be executed directly from within an HTML page without requiring any server infrastructure, provided the SPARQL endpoint supports JSONP;

Don’t hesitate to save the webpages and adapt them with your own annotated content, and drop me a note if you have other use-cases in mind !

Cet article Des articles enrichis grâce au web de données (DBpedia, Isidore) est apparu en premier sur Sparna Blog.

• Quelques cas d’usage simple des données du web pour enrichir la navigation : montrer des définitions contextuelles, les traductions d’un mot, et générer une partie du contenu de la page automatiquement à partir du linked data; on pourrait en imaginer plein d’autres.
• Ensuite montrer que cela ne nécessite pas de traitement côté serveur : tout est dans la page web. Du RDFa, du SPARQL, du rdfquery, un peu de JSON, du JQuery et tout roule;

(Got avait fait quelque chose de similaire il y a quelque temps sous la forme d’un module Drupal, ca s’appelait la « knowledge box« ; mais la box est cassée et ne fonctionne plus).

On notera que les données de cette page de démo viennent du DBPedia francophone. Il faudrait encore enrichir cet exemple pour montrer une utilisation des données de plusieurs sources de données différentes à la fois… ce sera pour un autre dimanche ! Allez faire un tour sur la démo et dites-moi ici si vous avez des questions/commentaires, voire des idées ou projets similaires !

Cet article Démo de l’utilisation de RDFa & SPARQL pour enrichir une page HTML est apparu en premier sur Sparna Blog.