livemark icon indicating copy to clipboard operation
livemark copied to clipboard

Document differences with other static sites generators

Open JBPressac opened this issue 3 years ago • 3 comments

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

JBPressac avatar Feb 01 '22 13:02 JBPressac

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 =)

  • MkDocs - for developers
  • Jupiter Book - for scientists
  • Livemark - audience-agnostic

roll avatar Feb 04 '22 12:02 roll

Thank you for this answer.

JBPressac avatar Feb 04 '22 12:02 JBPressac

Thanks!

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

roll avatar Feb 04 '22 12:02 roll