Convertors - HTML Convertor

[chifandeyu]

I want get editor delta json convert HTML and set to clipboard.But no convert function for dart.

• Could be useful for SEO SSR

---

Potentially PDF Convertor

[adrian-moisa]

Hmmm, that will be a tall order. Technically it's possible but I first need to finish the code cleanup and a few other more burning improvements. There are quite a few tags and exceptions to handle.

Several things to consider:

• CSS Styles vs inline styles - The question is wether we want styling or not on them. My best guess now is that we need to place whatever styling can be done as inline styling and avoid using classes to reduce the risk of collisions with existing stylesheets from any client project. However dropping everything inline will create a bit of a nasty situation where we have to use higher specificity css selectors to take over the styling of the document. Another potential solution is to use namespaced classes (such as: .ve-heading").
• Embeds - What to do about the embeds. This is where the show stops. Embeds cannot be automatically converted by any means. The only solution I see is to provide a config in the controller to specify what to output for your custom embeds when encountering them.
• Video - Also video is a rather wild card.
• Reading HTML - That's where things get really tricky with the implementation. What to do about unrecognized tags? Just ignore them I guess.

In essence there will be some differences. Overall I would not encourage anyone to use html as the blob document format stored in the DB. Mainly because if you use HTML, you usually want it HTML because of the human readability factor. Such that novices can do edits. And large part of these edits can end up as being giberish for our reading script. In other words you get the HTML but no touching it.

Plus, just in case you don't know, you can already render in browsers. The only major issue right now in the browsers missing support for video player. It is on my radar since I need it as well.

Basically the only real value of Delta to HTML is when you want to render a SSR version of your app for unlogged users to deal with SEO issues from google. That's my plan for making Visual Space SEO friendly. As you know, Flutter, by it's nature, is by far not a feasible/recommended option for document handling apps. The content gets rendered in a canvas element for performance reasons. The HTML renderer is nowhere close to compete with hand crafted HTML/JS in terms of performance.

I'll keep this issue open for a while to hear more thoughts from the devs interested in this topic. I'd be happy to hear how other editors deal with the HTML issue. So I can't promise a delivery date sooner than end of summer. In the meantime do consider to join the discord server. I'll be also covering this topic in an YT episode once I have a more concrete plan/set of specs.

[adrian-moisa]

I'm thinking maybe it's possible to highjack the HTML renderer from Quill JS if it has any. QuillJS as far as I know reads the same delta format. But I can't guarantee this will work at all. I don't have much knowledge abotu QuillJS and if the delta formats have drifted between the JS and Dart versions.

[Wishmater]

In my specific app, I need to provide a rich text editor for the user to enter content that will be sent by email. The only way to do this is by converting to html. I'm currently using quill, which has some issues but the editor itself works decently well. The problem is in the "workaround" I found for converting to html. I use markdown_quill to convert the deltas to markdown and then markdown to convert the markdown to html. This process, as you might imagine, has a LOT of unpredictable bugs.

I thing being able to somewhat reliably export html would be a strong feature for any text editing package, just for the sheer compatibility html has with everything.

[adrian-moisa]

Exporting to html will be easy compared to importing from HTML. That's one of the issues I have on the radar for this feature. I see what you mean about editing HTML templates. This feature can easily blow in a massive way. For example we are currently missing support for tables. Tables are a must have before going into html. So I guess it will be a while until we get to this stage. But yes, using it for editing email templates seems like a worthy cause. Would be happy to learn more from you what particular details we need to take care when doing the conversion.

[Wishmater]

Even a basic export, supporting only text styles, bullet lists and tables would cover a lot of use cases. Images and video would be a lot harder, but that can be left for later.
I understand other features have priority (starting with the tables themselves of course), but I think this definitely has enough value to implement at some point.

[kairan77]

@chifandeyu , @Wishmater > I want get editor delta json convert HTML and set to clipboard.But no convert function for dart.

There exists several two way delta <-> markdown conversion packages and several two way markdown <->html conversion packages on pub.dev.

It's merely less than a dozen lines of code to chain everything together using those packages.