linkeddata/dokieli

dokieli is a clientside editor for decentralised article publishing, annotations and social interactions https://dokie.li/

Sarven Capadisli

@csarven

@reyman Not sure if/what dokieli will need to do but surely PeerGos system/platform can make use of dokieli if it can make HTML (and friends) available. Just straight up HTTP.

matrixbot

@matrixbot

reyman :)

reyman great

Sarven Capadisli

@csarven

Detecting and linking to URI Persistence Policy is now in dokieli: https://github.com/solid/specification/issues/206#issuecomment-730512527

Samuel Klein

@metasj

Loving the experience so far.

Sarven Capadisli

@csarven

@metasj Great. How are you using it? Any issues/features you'd like to propose? There's a tonne of work up ahead..

John Murray

@lucidbard

Hi all, this editor is very much something I'd like to see developed more. I'm very interested in a linked-data native editor, but I'm still struggling a bit with integration with third-party data sources and tools.

1 reply

Sarven Capadisli

@csarven

@lucidbard welcome! How are you doing with the server setup? got your WebID, ACLs etc sorted?

Dan Keith

@DoctorBud

FWIW, the main example Dokieli page at https://dokie.li references a CrossCloud URL which appears to be defunct. It just times out. (I tried the https version at https://crosscloud.org and it has the same problem). VERY LOW priority issue, but thought I'd mention it or get clarification.

Sarven Capadisli

@csarven

@DoctorBud Thanks. I'll update the links when I get a chance - the homepage needs a major redo too. There are archived snapshot of CrossCloud by the way if interested eg https://web.archive.org/web/20161021112226/https://crosscloud.org/

Sarven Capadisli

@csarven

Added initial support for ODRL. The menu has some basic awareness for archiving. The print one is an easteregg for ODRL.. if there is an action for it, it will show up.. and depending on permitted or prohibited, it will enable or disable. Will support the other menu features eg. "save as" and have it correspond to the actions on distribution etc.

Daniel Garijo

@dgarijo

Hi @csarven, I have a question: Is it possible to convert any files written in latex to an HTML that could be understood by dokieli? I would like to start from a written article rather than to start from scratch. I have gone through the readme files, but I haven't found any hints. Thanks!

Sarven Capadisli

@csarven

Hey @dgarijo . Generally yes and it'd be no different than dokieli's CSS and JS being included in any HTML. There are of course some markup patterns that dokieli has in which you can get more out of the tool - what it can detect / display. The pattern is fairly straight forward to follow / generate IMO.

dokieli doesn't offer a transformation from anything to dokieli HTML. That's out of scope. So, you might want to find a tool that gives you a simple HTML. From what I've seen - and I can't say I have much experience with it - pandoc is pretty decent to get things going. You'll really have to massage whatever it generates if you really want to bring it closer to HTML like in articles listed in https://github.com/linkeddata/dokieli/wiki#examples-in-the-wild -- but don't take that as absolutes. Just in the right direction of things working properly.

See https://dokie.li/new as what the outer HTML should look like. Aside: see how the HTML patterns in https://dokie.li/ or https://dokie.li/acm-sigproc-sp or https://dokie.li/lncs-splnproc or https://csarven.ca/linked-research-decentralised-web .. essentially have no difference. It is just the CSS doing the work.

You'll likely run into issues with Math.. and yes that gets tricky but still workable -- depends to what extent you want to make sure the underlying formulas are MathML or SVG or image.. or maybe even in some ascii/latexmath that gets converted into MathML with JavaScript..

My suggestion is to take it step at a time. Unlikely that you'll get a perfect document coming out of LaTeX... but dig around for XSL-based approaches as well.

You might want to scroll through this section to get a feel of the patterns: https://dokie.li/docs#html-patterns -- the docs may be a bit outdated but you won't go wrong with what's there.

Alternatively, and I think this is as reasonable as converting from LaTeX is to simply copy/rewrite in HTML+RDFa... once you get a feel of the basic html patterns that dokieli uses, it should be mechanical / and not require much thinking -- although not fun.. YMMV.

Daniel Garijo

@dgarijo

Thanks @csarven! I appreciate the links. I will probably play around with pandoc whenever I have the chance and the dokieli css.

Sarven Capadisli

@csarven

@bergos I've noticed something strange with SimpleRDF -- yes, I know I know.. - where either rdf-serializer-n3 or something higher up is accumulates the prefixes from previous parsing/serializing and includes the prefixes all of the prefixes used in the latest serialization. Is there a way to disable this? I think this is a security issue. Is usePrefixMap related?

I use something like ld.store.serializers['text/turtle'].serialize(g._graph) where the return contains the accumulated prefixes. Not sure if there is something I can do before that (eg. some option to SimpleRDF.parse?) or as I call that.

Thomas Bergwinkl

@bergos

@csarven sorry for the late reply. i don't remember the details, but if possible, can you create a new instance of the store/serializer? could be that there is a usePrefixMap options, which you can also try to disable.

Shan Alexander

@shan-alexander

When I click "New" or "Save As" from dokieli, I receive the message "Unable to save: you are not authorized." I have not found a solution in this chat or in the dokieli docs. What should I do?

1 reply

Sarven Capadisli

@csarven

@shan-alexander Do you have Write access (via HTTP PUT request) to the target URL?

Firas Moosvi

@firasm

Hello @csarven - I just wanted to ping you about integrating Dokieli with JupyterBook. I put together a minimal working example in this issue about 3 weeks ago, but I understand github notifications are overwhelming: https://github.com/executablebooks/sphinx-comments/issues/12#issuecomment-855452494. Happy to move this issue to the dokieli repo if that's better.

circlebuilder

@circlebuilder:matrix.org

[m]

Hi there. Just joining via Matrix to notify of this brainstorm I created to TBL's idea for a FAQ Solid App, which possibly provides a good use case for Dokieli (and because your project is super-interesting overall, but I never had time to dedicate to deepdiving). Here's the Solid forum topic: https://forum.solidproject.org/t/ideas-for-a-possible-faq-solid-app/4627/2

CanYouGiveMeAName

@CanYouGiveMeAName

how can I find other's WebID,like Tim Berners-Lee

Rohan Kumar

@Seirdy

how does the dokieli team feel about supporting microdata?

Sarven Capadisli

@csarven

@Seirdy dokieli uses RDFa which is native to the RDF/Linked Data stack.

renyuneyun

@renyuneyun:matrix.org

[m]

Hi, I'm wondering what happened to the firefox extension? It's no longer in the extension repository (for a few years, as far as I can tell).

In case useful: I'm interested to help maintain the firefox extension, if that is not too much effort (e.g. lots of code changes). I had success in installing it locally (via dev mode; last year), but had no experience in building and uploading firefox extensions.

Sarven Capadisli

@csarven

@renyuneyun:matrix.org That'd be really great! The extension works in debug mode but bringing the code to a point where it'd be acceptable to be listed at Mozilla's add-ons is another story. I've made some progress there but things were still changing quite fast with Mozilla Web Extensions.. I haven't looked closely for some years now. Let me know if you need some more info.

4 replies

renyuneyun

@renyuneyun:matrix.org

[m]

It's not functioning well; chromium extension also has some probably bugs when adding a "note" (annotation?).

renyuneyun

@renyuneyun:matrix.org

[m]

Some examples: logging in works; UI works; adding notes gives the UI and selection of "Personal Storage" (no other storages, e.g. "Annotation service" as in the video), but nothing happens after clicking OK; "sharing" gives the UI and loads friend list, but sending fails on Firefox (with extension loaded from dev/debug mode).

Sarven Capadisli

@csarven

If there is no storage/annotationService, it means that dokieli didn't pick that up from the user's profile description or the current document's annotation service. Basically no statement with pim:storage or oa:annotationService is found. So, it doesn't know where to create an annotation. I suppose the UI can be cleaned up to not offer the option to annotate..

Oh, in your case, it did pick up the pim:storage then

Then perhaps the document doesn't have an inbox to send the notification about the annotation.

1 reply

The article, annotation, and the notification are all different resources.

Sarven Capadisli

@csarven

I haven't been able to see the inspector/developer tabs (console/network) in add-on mode properly. I see the window for it but it shows no activities there. Do you know how to make it show? This has been making it difficult to debug.

2 replies

Martynas Jusevicius

@namedgraph_twitter

https://blog.arxiv.org/2022/02/21/arxiv-articles-as-responsive-web-pages/

Sarven Capadisli

@csarven

@renyuneyun:matrix.org
You're already on the right track. dokieli's Web Extension will let you annotate any HTML document. dokieli's CSS/JS can also be included in an HTML document.

Perhaps the diagram in https://csarven.ca/linked-research-decentralised-web#examplar-information-space can help to clarify the connection between an article, inbox, notification, annotation, profile and so on. See also this diagram https://csarven.ca/dokieli-rww#figure-dokieli-architecture-relations

At the moment, the location of the annotation may be your personal storage root but that can be changed - without asking the user necessarily. (At the time we didn't have a specification / practice to do that). It can be any HTTP URL in fact that you have write access to. There is some relatively small work there - dokieli just needs to be able to discover the information that indicates user's preferred place or perhaps ask the user where to store it at each time. I initially decided to just store at storage root as that was simplest and also to not bother the user. There are a number of possibilities there and I don't think they're mutually exclusive either.

The "annotation service" is a bit like the location that the article suggests where annotations can go - similar to how public comments tend to work on the current Web but there is no constraint that it must be a public location. That too can be access controlled.

What dokieli decides is basically if you there are multiple places to store an annotation, it will prefer to use your personal location - because you ultimately control that - but it can still send copies to other locations - if selected on the UI - and refer back to the canonical one (on your storage).

Notification is used as a way to allow the discovery of annotations made on an article. To get there, dokieli checks what the article's inbox is and then finds its notifications, and the notifications will have a reference to an annotation URL.

Andrew Berezovskyi

@berezovskyi

Hi everyone! I would like to print https://solid.github.io/web-access-control-spec/ to PDF to read it and annotate it in Zotero (yes, I know about Hypothes.is, but I end up going back to Zotero). No matter what I try, the print is done in the landscape mode (not to mention that text gets cut off at page breaks). Did anyone try to save Dokieli-based specs to PDF before? Tried FF and also Chrome. I also don't have a way to choose the page size, which makes me think that it got stuck in a mode for printing slides. Thank you in advance for your help!

Sarven Capadisli

@csarven

@berezovskyi Thanks for raising this. That's strange. I'll look into that.

Sarven Capadisli

@csarven

Looks like Shower CSS's @page{margin:0;size:1024px 640px} is causing the issue.

Sarven Capadisli

@csarven

@berezovskyi I've removed that rule and it seems to resolve the issue. (Shower CSS is typically on HTML pages that's only intended for presentations. dokieli's CSS includes Shower CSS and it can be on any page - as you've seen for the spec.) Shower CSS's page rule is not particularly required. User can select the landscape mode in a very specific case: HTML includes dokieli that's intended for slideshows using the Shower presentation engine.

Thanks for pointing out and let me know if that address it - you clear your crash and try again.

Andrew Berezovskyi

@berezovskyi

Thanks a lot, @csarven! Just wanted to let you know that your fix works perfectly: page size selectors work well and the text breaks across pages properly.

@metasj:matrix.org

[m]

FR: remove login barriers to participation!

Let people start annotating or contributing with an autogenerated local ID in their browser session or on their device, which is then tied to a webID/openID if | when they create one

Sarven Capadisli

@csarven

@metasj:matrix.org I believe users can already do that for the most part. Did you have something particular in mind? Perhaps create an issue. Authentication and authorization is not something dokieli dictates. So, a request can be successful e.g., annotating and notifying can be done without authn. Having said that, dokieli doesn't storage annotations on localStorage or alike.. that can be a feature.. and maybe even there is an issue already. Can't remember.

Azure

@Datapredator

Is there a known-good SOLID POD that Dokieli is supposed to work with? I keep trying to create documents and being able to type into them, but then if I try to reopen them. Or switch out of edit mode and back, it pops up saying it's in Author Mode or Social Mode but I can never actually edit anything again, it acts like plain read-only text.

Or is there a bootstrap guide that's a bit better than what's on dokie.li?

numéro6

@numero6:codelutin.com

[m]

I've added this room to a matrix space #decentralised-social-networks:codelutin.com (which is part of #next-internet:codelutin.com)

Where communities thrive

People

Repo info

Activity