Skip to content

Article Relationships and Transclusions

michael edited this page Sep 23, 2014 · 10 revisions

This document puts together thoughts and concepts for a prototype evolved during a session in Cambridge Sep 2014 (eLife, Substance).

Use-cases

  • Insight: a small article that is related to another article, adding a more informal view on the content. Insights should be visible in the context of the original article under 'Related Articles'.
  • Advance: an article that continues the work proposed in another article. The author (or editor) should describe in which way the original one is advanced. Advances should be visible in the context of the original article under 'Related Articles'.
  • Key-References (by Author): the author can choose 3 different references which are most important for their article, and describe in which way they impact their publication. The article may be listed under 'Related Articles' in the context of the key reference articles.
  • Related Articles (by Editor): an editor can establish relationships between articles by describing in which way they are related (similarities, contrasts, etc.)
  • Personal Notes: a researcher might want to collect notes for each reference. They could write a document with notes using transclusions in a way like bookmarks.
  • Threads (curated): a curated thread could be seen as a kind of survey. The curator would create a narrative embedding transclusions.
  • Timeline (generated thread): articles could be put together to a document showing a chronological development of ideas proposed in one article.

Concept

  • Deep Citations are citations which also denote a fragment in the cited article. A deep citation is essentially a bilateral citation with a defined location in both documents.
  • Transclusions are deep citations wich moreover pull in the referenced content into the article.
  • Relationships are represented by small document fragments containing a narrative explaining the qualitative nature of the relationship and using transclusions to provide links to the relevant parts of the article. Such a fragment will then be included into the 'Related Article' section of the associated articles.
  • Using narratives instead of structural data (such as just cards with link) could provide a more natural way to show and explain relationships to a reader.
  • Deep citations form a basis for establishing an un-directed graph on document fragment level, i.e., it is also possible to see if a fragment has been cited and from where.

Mockups

Related articles panel

Insight with transclusions

Transclusion of text piece

Transclusion of figure

Key References