frictionlessdata / livemark

Data presentation framework for Python that generates static sites from extended Markdown with interactive charts, tables, scripts, and other features
https://livemark.frictionlessdata.io
MIT License
95 stars 8 forks source link

Document differences with other static sites generators #202

Open JBPressac opened 2 years ago

JBPressac commented 2 years ago

Hello, What are the differences between Livemark and other static sites generators as MKdocs or Jupyter Book ? Thanks,

roll commented 2 years ago

Hi @JBPressac,

It's a good question and we will def write a section in our documentation on this topic. In a few words comparing to:

MkDocs Livemark is just something like a new tool similar to MkDocs that tries to provide more features esp. related to data visualizations like charts and tables (the features set is open-ended with plugins). I would say that both Livemark and MkDocs have a similar core scope but Livemark extends it to data journalism or education domains not only focusing on documentation writing.

Jupiter Book This tool is more like Livemark and the difference lays in the approach. Jupiter Book is centered around Jupiter Notebooks while Livemark has a more generic approach to book generation. Livemark translates extended markdown documents to HTML not being dependent on Jupiter Notebooks in any aspect (under the hood or regarding the writing experience).

As summary, I would say that Livemark is targeting a similarity with Jupiter Book feature-wise while the philosophy is alike with MkDocs i.e. simple markdown to HTML conversion without notebooks dependency.


Another take on answering it =)

JBPressac commented 2 years ago

Thank you for this answer.

roll commented 2 years ago

Thanks!

I'll re-open to ensure that it goes to the docs :+1: