dokieli

dokieli is a clientside editor for decentralised article publishing, annotations, and social interactions.

It is built with the following principles in mind: freedom of expression, decentralisation, interoperability, and accessibility. There is no root, authority, or centralisation here. Control yourself!

Welcome! Check out the:

• Code of Conduct
• Contributing Guide
• Documentation
• Security Policy
• Roadmap

License

• Source code is licensed under the Apache License, Version 2.0.
• Unless otherwise noted, images and other media assets are licensed under the Creative Commons Attribution 4.0 International.

Use

dokieli can be used as a:

• single-page application - open any dokieli embedded article
• browser extension - import dokieli from your Web browser's extensions (see also instructions.

Setup

Clone your work repository, for example:

git clone git@github.com:YOUR-USERNAME/dokieli
cd dokieli

Install packages:

yarn

Make your code updates at src/ , media/ etc.

Build eg. to create scripts/dokieli.js:

yarn build

or automatically rebuild when files change:

yarn watch

or create a minified scripts/dokieli.js:

yarn minify

To serve static files, you can use any HTTP server, e.g.:

npx serve

For more details on our development process, including tests and code quality guidelines, see our Contributing Guide

Documentation

• For brave developers and authors: the canonical documentation explains dokieli's principles, architectural and design patterns.

Features

• In-browser document authoring and formatting, and semantic enrichments (RDFa annotations).
• Content negotiation is possible for RDFa, Turtle, JSON-LD, RDF/XML.
• Uses author's information from their online profile (WebID).
• Creation of new documents from any existing dokieli document - part of self-replication.
• Save document and its dependencies to a new location (anywhere on the Web given access) - part of self-replication.
• Open and edit URLs containing HTML.
• Individually assign the language of articles and annotations and parts within.
• Assignment of URI fragments (to any unit of significance) so that other resources on the Web can link to it.
• Implements versioning and has the notion of immutable resources.
• Embedding data blocks, e.g., Turtle, N-Triples, JSON-LD, TriG (Nanopublications).
• Embedding of media objects, tables, and interactions.
• Graph visualisation of linked data.
• Import GPX and extension data and view tracks on map.
• Automated references and citations (retrieves and reuses structured information).
• Insertion of table of contents, figures, tables, abbreviations.
• Drag and drop to reorganize the document's sections and table of contents.
• In-browser local storage, and document exporting.
• Message log.
• Document metadata.
• Views for screen and print (e.g., ACM, LNCS) - yes, you can output to a paper user interface: PDF
• .. and many more on the way.

Let's make it so together! You are welcome to create issues, discuss, or pull requests.

Screencasts

• Access request.
• Annotating and sharing.
• Matching resource's target audience with user's occupations.
• Citations
• Generate and publish web feed.
• Robustify links.
• Sparqlines towards better data journalism.
• Accessible link tabbing, hover, and focus.
• Bookmark create and read.
• Open digital rights contrasting storage description and personal policies, agreements and actions between people.
• Share an article by announcing it to a contact from addressbook and entering a contact directly.
• Specification requirements, test coverage, version diff, change log.
• Geo and statistical data importing and viewing.

Examples

See the growing list of examples in the wild. Add the URLs of your articles or interactions to the list.

This repository is published and accessible from https://dokie.li/. dokie.li is intended to demo and exemplify what we can do with this technology. You are welcome to use and experiment with dokieli there, or anywhere else you come across a dokieli document.

For the scholars among us, view the authoring guidelines such as the ACM SIG Proceedings Paper using the LNCS Author Guidelines (typographical rules), and vice versa (see the dokieli menu) ;) More can be found in the dokieli themes repository.

Specifications

• Information is represented and retrieved following the Linked Data design principles.
• WebID for personal/agent identities.
• WebID-TLS and WebID-OIDC for authentication.
• Web Access Control/ACL to set permissions on Web resources.
• W3C Linked Data Platform and Solid Protocol servers to read and write Web resources.
• W3C Linked Data Notifications for inbox notifications for annotations and social sharing.
• W3C ActivityPub client to read/write from/to profile's outbox.
• W3C Web Annotation Model, W3C Web Annotation Vocabulary, W3C Embedding Web Annotations in HTML, and W3C Selectors and States to model and identify annotations (eg. replies, peer-reviews, liking, resharing, bookmarking)
• W3C Activity Streams 2.0 vocabulary for social activities.
• W3C ODRL Information Model and W3C ODRL Vocabulary & Expression to represent statements about the usage of content and services.
• Memento for resource management eg. TimeMap.
• Creative Commons to assign license to individual contributions and annotations.
• Robust Links for hyperlinks eg. citations, and to show Link Decoration.
• schema.org, SPAR Ontologies, PROV-O, and various other vocabularies.

Supported By

• NLnet (2024-02–present)

Support the project

Help the project grow by sponsoring it on Open Collective or reach out to us.

Contributors

Acknowledgements

The following organisations have supported a part of the research and development on dokieli:

• Massachusetts Institute of Technology (2015–2016)
• Qatar Computing Research Institute (2015–2016)
• Deutsche Forschungsgemeinschaft (2016–2017)
• University of Bonn (2017)
• TIB – Leibniz-Informationszentrum Technik und Naturwissenschaften (2017-2019)

We would also like to express our gratitude to the following individuals for their support:

• Amy van der Hiel
• Andrei Vlad Sambra
• Ben Companjen
• Benjamin Young
• Gerben Treora
• Henry Story
• Herbert Van de Sompel
• Kingsley Idehen
• Melvin Carvalho
• Patrick Hochstenbach
• Ruben Verborgh
• Sandro Hawke
• Thomas Bergwinkl
• Tim Berners-Lee