Nice write up

On Dec 13, 2022, at 3:15 PM, Offray Vladimir Luna Cárdenas <offray.luna@mutabit.com> wrote:

Hi,

As I told in a previous message, we, at the Grafoscopio[1][1a][1b] community, are migrating some lessons learned since 2015 to the new capabilities available since last year via Lepiter[2]. And one of such lessons is the use of human friendly data formats for exchanging and publishing data narratives.

[1] https://mutabit.com/grafoscopio/en.html [1a] https://mutabit.com/repos.fossil/grafoscopio/doc/tip/intro.md [1b] https://mutabit.com/repos.fossil/grafoscopio/doc/tip/readme.md.html [2] https://lepiter.io/feenk/introducing-lepiter--knowledge-management--e2p6apqs...

Originally, in Grafoscopio, we made this friendly format by embedding Markdown inside STON, as shown in the Grafoscopio Manual (PDF[3], source code [3a]) and now we are flipping the strategy: embedding STON metadata in Mardeep[4]/Markdown, which allows us to exchange and publish Pharo powered data narratives, lessons and book(let)s in a pretty light format as shown by the republication of the "PetitParser: Building Modular Parsers" chapter (18th )from the Deep into Pharo book[4] as a Markdeep data narrative[4a]. The chapter was rewritten in Lepiter and can be exported/imported to/from Markdeep, so new updates or learning notes can be created pretty easily[4b]. Because we combine this with Fossil SCM[5], it is also possible to have the history of the documents (look at [4a1][4b1]) in a self contained environment for collaborative publishing/writing that is easier to use, in comparison with Git based alternatives (as shown in our practices introducing this tools and workflows to non-programmers).

[3] https://mutabit.com/repos.fossil/grafoscopio/uv/Docs/En/Books/Manual/manual.... [3a] https://mutabit.com/repos.fossil/grafoscopio/file?name=Docs/En/Books/Manual/... [4] http://files.pharo.org/books-pdfs/deep-into-pharo/2013-DeepIntoPharo-EN.pdf [4a] http://mutabit.com/repos.fossil/mutabit/doc/tip/wiki/en/petitparser-building... [4b] http://mutabit.com/repos.fossil/mutabit/doc/tip/wiki/en/petitparser-building... [4a1] http://mutabit.com/repos.fossil/mutabit/timeline?uf=1680c3899 [4b1] http://mutabit.com/repos.fossil/mutabit/finfo?name=wiki/en/petitparser-build... [5] https://fossil-scm.org/

I like the results with so far with this light (re)publishing workflow based in Markdeep, despite some bugs, like subsection numbering done in Markdeep when combined with HTML divs[6] (a bug already reported to the author). For more detailed control of the output or the combination with HTML graphical libraries, like Apache Echarts, we're testing a similar strategy using Pandoc's Markdown with promising features. For example, we can have interactive snippets in the HTML exported document [6a].

[6] https://nitter.net/offrayLC/status/1585701931728740352#m [6a] https://twitter.com/offrayLC/status/1555229528355651586

Such light, human readable and diff friendly publishing and exchange formats are kind of a dehydrated data narrative for the web and/or the file-system than can be re-hydrated back into a full Pharo/GToolkit image for total interactivity/moldability and meanwhile you can tease the casual web reader/explorer with data stories and visualizations without s/he having the need to have Pharo/GToolkit in her/his machine.

Cheers and thanks for the community and technologies that make this possible. I will be posting more advances as they come.

Offray