Articular is a tool for creating RDF knowledge graphs with Markdown elements: lists of hyperlinks, images, tables and styled or plain text.
As a readable, content-first, low-syntax document format, Articular is intended to facilitate the exchange of structured data between researchers, writers and developers to support the construction of databases of networked information.
Warning
Articular is an on-going research project and is not yet ready for use in production.
pip install git+https://github.com/edwardanderson/articular
articular examples/adventures_of_huckleberry_finn.md
---
language: en
---
- [Adventures of Huckleberry Finn](1)
- a
- Book
- description
- > **Adventures of Huckleberry Finn** is a novel by American author [Mark Twain](https://en.wikipedia.org/wiki/Mark_Twain).
- [source](https://schema.org/isBasedOn)
- ["Adventures of Huckleberry Finn", Wikipedia](https://en.wikipedia.org/wiki/Adventures_of_Huckleberry_Finn)
- author
- Mark Twain
- date of birth
- > 1835-11-30 `date`
- name
- > Samuel Longhorn Clemens
- > صمويل لانغهورن كليمنس `ar`
- > 塞姆·朗赫恩·克莱門斯 `zh`
- portrait
- ![Mark Twain by Sarony, 1884](https://upload.wikimedia.org/wikipedia/commons/thumb/2/2e/Mark_Twain_by_Sarony%2C_1884.JPG/155px-Mark_Twain_by_Sarony%2C_1884.JPG)
- creator
- [Sarony](http:https://www.wikidata.org/entity/Q101243225)
- description
- ["Mark Twain", Wikipedia](https://en.wikipedia.org/wiki/Mark_Twain)
Mark Twain
: <http:https://www.wikidata.org/entity/Q7245>
: <http:https://viaf.org/viaf/50566653>
: <https://vocab.getty.edu/ulan/500020427>
Syntax | Example |
---|---|
application/ld+json |
examples/adventures_of_huckleberry_finn.json |
text/turtle |
examples/adventures_of_huckleberry_finn.ttl |
application/trig |
examples/adventures_of_huckleberry_finn.trig |
An Articular document is a list of Things and Texts connected to each other via Relationships.
graph LR
Thing("📦 Thing")
Text>"✏️ Text"]
Type["⚙️ Type"]
Thing -- Relationship --> Thing
Thing <-- Relationship --> Text
Text .-> Type
Documents are nested lists of these components.
- Thing
- Relationship
- Thing
- Relationship
- > Text `Type`
- Relationship
- ...
- John
- knows
- Paul
- name
- > John Winston Lennon `en`
- Things are hyperlinks, images or identifying plain-text strings
- Relationships are hyperlinks or identifying plain-text strings
- Texts are blockquotes, with or without emphasis
- Types are optional qualifiers for human language or datatype of Texts as code
Definition lists can identify multiple references of the same Thing.
- John
- born in
- Liverpool
- Paul
- born in
- Liverpool
Liverpool
: <http:https://www.wikidata.org/entity/Q24826>
Parameters are set in the YAML frontmatter.
---
base: http:https://www.example.org/
vocab: https://schema.org/
language: fr
autotype: true
---
Tests are in development.
The tests/tests.py
application executes each example documented in tests/tests.md.