[Ann] [Grafoscopio] New release with major improvements

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|

[Ann] [Grafoscopio] New release with major improvements

Offray Vladimir Luna Cárdenas-2

Hi,

In Grafoscopio, we follow a rolling release model, so we don't make a lot of noise about new versions, but this one has several features worthy to mention:

a. Pharo 6 & 6.1 support, with out of the box 64 bits support on Mac and Gnu/Linux.

b. Improved support for documentation: Now we have a GrafoscopioDocumentation object that defines documentation as a (Fossil) repository with a list of documents inside and is able to download and update them to their last version using the standard Fossil JSON API.

c. Improved traceability: The usual document workflow in Grafoscopio is to create a notebook (i.e notebook.ston), export it as Markdown (notebook.markdown) and convert it to PDF (notebook.pdf) or HTMl (notebook.html). Now in the notebook.ston --> notebook.markdown --> notebook.pdf workflow, the exported/derived file contains the checksum of the last saved source file where it comes from. So, notebook.markdown contain the checksum of notebook.ston in the YAML metadata block [1][2], and notebook.pdf can show the checksum of the notebook.markdown, as exemplified in the User Manual [3].

[1] http://pandoc.org/MANUAL.html#extension-yaml_metadata_block
[2] http://mutabit.com/repos.fossil/grafoscopio/artifact?name=99778d46ef034389&txt=1
[3] http://mutabit.com/repos.fossil/grafoscopio/doc/tip/Docs/En/Books/Manual/manual.pdf

d. Metadata config nodes: Now notebook internalizes the environment (as Smalltalkers and Lispers[4] like ;-)). "%medatata" nodes (see image below) allow a Grafoscopio notebook to define and control the command line options used by the operative system to export the notebook to other formats and enables the notebook to feedback such options with information provided/calculated by the notebook itself. This improves reproducibility greatly, because notebook now describes even the external operations to it, to create other derived files (Markdown, PDF, LaTeX and so on) and to interact with the operative system where it resides (currently this only works on Unix like operative systems like Mac and Gnu/Linux). Such configuration options are defined in plain Pharo, using just dictionaries and dynamic arrays, with some special keys.

[4] https://youtu.be/JnczIyPXGfc?t=2548



e. Support for multiple tags in a node: Until now the only allowed tag was 'código' (code), but now tags can be almost arbitrary. This will open new ways to process and display the notebook document tree, once the proper GUI features and interactions are developed.

f. Updated and corrected documentation: English User Manual has been improved to reflect new features and several typos and errors have been corrected.

Last stable Grafoscopio version is available from the Pharo Catalog, and remember to run the update, frequently.

Enjoy,

Offray