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--e2p6apqsz5npq7m4xte0kkywn/ 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.pdf [3a] https://mutabit.com/repos.fossil/grafoscopio/file?name=Docs/En/Books/Manual/manual.ston&ci=tip [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-modular-parsers-2013--ac8zq.md.html [4b] http://mutabit.com/repos.fossil/mutabit/doc/tip/wiki/en/petitparser-building-modular-parsers--ac8zq.md.html [4a1] http://mutabit.com/repos.fossil/mutabit/timeline?uf=1680c3899 [4b1] http://mutabit.com/repos.fossil/mutabit/finfo?name=wiki/en/petitparser-building-modular-parsers--ac8zq.md.html&m=98674f27039de682&ci=67aabb62607b152d [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

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--e2p6apqsz5npq7m4xte0kkywn/ > > 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.pdf > [3a] https://mutabit.com/repos.fossil/grafoscopio/file?name=Docs/En/Books/Manual/manual.ston&ci=tip > [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-modular-parsers-2013--ac8zq.md.html > [4b] http://mutabit.com/repos.fossil/mutabit/doc/tip/wiki/en/petitparser-building-modular-parsers--ac8zq.md.html > [4a1] http://mutabit.com/repos.fossil/mutabit/timeline?uf=1680c3899 > [4b1] http://mutabit.com/repos.fossil/mutabit/finfo?name=wiki/en/petitparser-building-modular-parsers--ac8zq.md.html&m=98674f27039de682&ci=67aabb62607b152d > [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