2.5.4

Bug fixes

• Fixed a bug related to the handling of paths which made Cosma unusable on Windows (issue 147)

2.5.3

This 2.5.3 release is the first official release for version 2.5 of Cosma. We had to publish a couple of “crash test” 2.5.x versions on NPM, following big changes in Cosma's build process. Everything should work as expected now.

Additions

• Cosma's syntax for citations is now 100% identical to Pandoc's Markdown citation syntax. This adds support for features such as writing [prefix @key, suffix], or rendering Author (Year) when writing @key.
• Link types can now be used on citations. This only works when citation keys are within brackets. Example: [cites as authority:@engelbart1962].
• Link types can now be used in CSV data, by adding a type header to your links table. (Pull request #104 by @snowsign)

Improvements

• Until now, there were some quirks with the way Cosma handled paths in the configuration. For instance, the value of export_target needed to end with a slash / lest you end up with a weird file name (e.g. export_target: folder would lead to foldercosmoscope.html). This is no longer the case. Paths can be written however you prefer: folder, ./folder, folder/, 'folder, "folder", etc.
• The program's build process now include some automatic tests to improve quality assurance. Tests can be run locally (see the README) and are also ran by a GitHub Action when pushing commits. This is the first in a series of changes we plan to make to facilitate maintenance and contributions to the code.

Bug fixes

• Fixed a bug with accessing translations in i18n.yml.
• Fixed a bug preventing the user from displaying Cosma's user manual with the command-line man program.

Cosma 2.4.1

Improvements

• YAML headers can be closed by three dots (...) instead of three dashes (issue 107).
• Added missing English translations for some elements in the cosmoscope (issue 116).
• URLs in the bibliographies of records created with reference_as_nodes are now clickable.

Bug fixes

• Citation processing with cosma modelize --citeproc no longer fails when references_as_nodes is set to false in the configuration (issue 101).
• Creating the user data directory with cosma --create-user-data-dir no longer fails (issue 106).

Cosma 2.4.0

Additions

Greater control over what is shown in the cosmoscope:

• The left and right panel can now be hidden or shown by clicking on toggle buttons (respectively at the top left and top right of the cosmoscope). Folding the right panel does not de-select the currently selected record.
• New option: hide_id_from_record_header (default: false). When set to true, IDs are not shown in the record header in the cosmoscope.

Improvements

Improved navigation in the graph view:

• When the graph view loads, it shows the entire graph (issue 38).
• Upon selecting a record, the graph view automatically centers on the corresponding node (issue 39).
• If the zoom level has not been modified, the graph view automatically zooms in on the selected node. The effect scales with the graph size: bigger graphs mean a greater zoom-in effect when selecting nodes.
• Pressing C centers the graph view on the selected node (this shortcut existed before v2.0 and had been broken since).

Other improvements:

• The cosmoscope no longer shows empty fields in record headers (e.g. when a record does not have tags, the tags field is hidden).
• If cosma modelize encounters an error when parsing a YAML header, it stops and indicates the name of the file in which the error was found (pull request 81 from Yann Trividic).

Cosma 2.3.1

Improvements

• Improved the wording (and documentation) of the “views” feature, which will be called the view (singular) until we re-implement the ability for users to save views in the cosmoscope.

Bug fixes

• Links in bibliographies now work properly again (issue 80).
• cosma batch now generates identifiers properly again.

Cosma 2.3.0

Additions

• Multi-type nodes are now multi-colored in the graph, and have multiple type indicators in front of their name in the index as well as the Links and Backlinks section of records.

Bug fixes

• Opening and closing records is no longer broken (issue 91).
• Lists in records are no longer flush with the margin but indented. This improves the rendering of multiline list items, line breaks inside list items, etc. (issue 86)

2.2.1

Additions

• Added an AUTHORS file.

Cosma 2.2.0

Additions

• New configuration setting: citations_as_nodes. When set to true, this setting modifies the behavior of the --citeproc option of cosma modelize, making it so that bibliographic references become nodes in the graph: each cited reference is treated as a node and each citation is treated as a link; for each cited reference, a bibliographic record is automatically generated in the cosmoscope; each bibliographic record is presented with contextualized backlinks which correspond to citations of that bibliographic reference in other records.

To use this new feature, you must do three things:

1. set citations_as_nodes to true in the project's configuration;
2. define a value for references_type_label (this is a new setting introduced alongside citations_as_nodes in this release);
3. create a record type with the same name as the value for references_type_label.

For instance:

citations_as_nodes: true
references_type_label: "référence"
record_types:
  référence:
    stroke: "#6C6C6C"
    fill: "#6C6C6C"

(You can replace “référence” with whatever you want.)

Then run cosma modelize --citeproc as usual to generate the cosmoscope.

Improvements

• When a record has no value for a particular metadata field (e.g. no keywords), that field is hidden from the record in the cosmoscope.

Cosma 2.1.2

• Reverted a change from v2.1.1: the Links section in the record panel of the cosmoscope is now uncollapsed again (issue #84).

Cosma 2.1.1

Additions

• Links and backlinks context is now shown inline by default. This is set by the new link_context parameter in the configuration. Set link_context to tooltip instead of inline to show link context in a tooltip on hover, as in previous versions of Cosma.

Improvements

• begin and end metadata are now known by Cosma as default metadata and do not need to be declared in record_metas

Known bugs

• Links in bibliographies are broken due to an extra </div> tag in the href attribute (issue 80).