cosma -

- JavaScript
Published by Myllaume over 1 year ago

cosma -

- JavaScript
Published by Myllaume over 1 year ago

cosma -

Bug fixes

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

- JavaScript
Published by infologie over 1 year ago

cosma - 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.

- JavaScript
Published by Myllaume over 1 year ago

cosma - 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).

- JavaScript
Published by infologie about 2 years ago

cosma - 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).

- JavaScript
Published by infologie over 2 years ago

cosma - 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.

- JavaScript
Published by infologie over 2 years ago

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

- JavaScript
Published by infologie over 2 years ago

cosma -

Additions

• Added an AUTHORS file.

- JavaScript
Published by infologie over 2 years ago

cosma - 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.

- JavaScript
Published by infologie over 2 years ago

cosma - 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).

- JavaScript
Published by infologie over 2 years ago

cosma - 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).

- JavaScript
Published by infologie over 2 years ago

cosma - Cosma 2.1.0

Improvements

Links can now be based on titles

If a record has e.g. title: Evergreen notes and no id parameter, then it can be linked to based on the title.

Text case is ignored when parsing but preserved when rendering, so you can write [[Evergreen notes]], [[evergreen notes]] or even [[eVerGReeN NotEs]]: the link will work regardless, with the text being rendered the way you wrote it.

A new required parameter has been added to the configuration: generate_id. It modifies the behavior of cosma record according to three values:

• when generate_id: always, cosma record automatically generates identifiers in new records;
• when generate_id: never, cosma record doesn't add identifiers in new records;
• when generate_id: ask, cosma record asks you to type y (yes) or n (no) for each new record to choose if you want an identifier to be automatically added or not

The graph is now displayed on an infinite canvas

The graph is no longer constrained (and truncated) by the edges of the window. This makes it possible to view graphs that are larger than the screen, without having to “shrink” the graph so that it fits the window.

We are still ironing the kinks (see Known issues below). Feedback is welcome as always.

Cosma no longer rewrites configuration files

Cosma sometimes encounters a problem when reading a configuration file (e.g. a missing parameter such as the undefined record type). Instead of silently rewriting the configuration file, Cosma now tries to fall back on internal default configuration values and displays a warning message in the terminal, with the names of the problematic configuration parameters.

Chronological mode has been simplified

Chronological mode now works in only one way: by using the values for begin and end metadata from the YAML header of records. (Future updates will provide the ability to customize chronological metadata.) The chronological_record_meta parameter is deprecated and removed from the configuration

Bug fixes

• Fixed the visual indicator for suggestions that appear when typing into the search bar
• Fixed the warning displayed by Cosma when attempting to create a duplicate record
• Automatically terminate modelize when the task has been completed but the process keeps running (issue encountered on macOS)

Known issues

• In the graph view, zooming doesn't center on the pointer's position
• batch generates identifiers with extra digits (more than the expected 14), which can mess up writing setups. This doesn't affect projects with generate_id: never, for which batch correctly generates records without identifiers

- JavaScript
Published by infologie over 2 years ago

cosma - Cosma 2.0.2

• Added a man page, which can be displayed by running man cosma in the terminal

- JavaScript
Published by infologie almost 3 years ago

cosma - Cosma 2.0.1

Bug fixes

• Modelization no longer fails on Windows
• Windows style carriage return and line feeds hidden characters (CR LF) are now parsed correctly
• Citations are now processed as expected in backlink context tooltips

- JavaScript
Published by infologie almost 3 years ago

cosma - Cosma 2.0.0

Additions

• Manage multiple configurations (global and local)
• Use alternative syntax for links
• Include user-defined metadata in batch creation
• Display user-defined metadata in records in the cosmoscope
• Exclude certain records when generating the cosmoscope, based on types, keywords and user-defined metadata
• Display nodes in chronological mode
• Embed images in the cosmoscope (in base64). Supported formats: JPG, PNG
• Use an image as default thumbnail for a record type
• Use an image as thumbnail for a record
• Define an outline color for node types
• Choose between fixed size nodes and nodes proportional to their degree

Improvements

• Links in bibliography are now clickable
• Messages displayed at command execution are more informative
• The error and warning report is more informative
• Keywords at the top of cards in the cosmoscope no longer overflow the layout
• Cosma now reads directories recursively (issue #4)
• When history: true, cosmoscopes are saved in a history subdirectory, either in the user data directory for global configurations, or in the same directory as the local configuration.

Fixed bugs

• Link/backlink context tooltips now correctly highlight the target record (issue #23)

Known bugs

• Citations are processed in link context tooltips but not in backlink context tooltips
• Windows style carriage return and line feeds hidden characters (CR LF) are not parsed correctly
• When the data comes from online CSV files, the modelize command does not terminate after generating the cosmoscope
• If a record's identifier is not a string of numbers, links to that record do not work
• Links to records with spaces in their identifier are not rendered correctly in the record's body

- JavaScript
Published by infologie almost 3 years ago

cosma - Cosma 2.0-beta-2

(Texte en français plus bas)

This patch fixes the following issues with Chronological mode from v2.0-beta-1:

• Interacting with the timeline had no effect. Now it works as expected.
• begin and end metadata from records were ignored. They work as expected now too.

---

Ce patch corrige les problèmes suivants avec le mode Chronologique dans la v2.0-beta-1 :

• Interagir avec la frise chronologique n'avait aucun effet. Elle fonctionne maintenant comme attendu.
• Les métadonnées begin et end des fiches étaient ignorées. Elles fonctionnent maintenant comme attendu aussi.

- JavaScript
Published by infologie about 3 years ago

cosma - 2.0-beta-1

v2-beta-1

(Texte en français plus bas)

This is the first beta for Cosma GUI v2. It includes three major changes:

1. Cosma has been imbued with the spirit of another of our projects, the Otletosphere: in addition to Markdown text files, cosmoscopes can now be created from tabular data, and we've added new graphical options such as having fixed-size nodes, and using images as thumbnails/portraits on nodes and records.
2. Projects! Cosma is now able to deal with multiple data sources.
3. Chronological mode is a new time-based display filter. Use the slider to make nodes appear and disappear depending on their begin and end metadata. This is a work-in-progress.

Additions

• Manage multiple projects
• Use alternative syntax for links
• Display user-defined metadata in records in the cosmoscope
• Exclude certain records when generating the cosmoscope, based on types, keywords and user-defined metadata
• Display nodes in chronological mode
• Embed images in the cosmoscope (in base64). Supported formats: JPG, PNG
• Use an image as default thumbnail for a record type
• Use an image as thumbnail for a record
• Define an outline color for node types
• Choose between fixed size nodes and nodes proportional to their degree

Improvements

• Links in bibliography are now clickable
• The error and warning report is more informative
• Keywords at the top of cards in the cosmoscope no longer overflow the layout
• Cosma now reads directories recursively (issue #4)

Fixed bugs

• Link/backlink context tooltips now correctly highlight the target record (issue #23)
• Spaces in file names generated by Cosma are correctly replaced by dashes

Known bugs

• Backlink context tooltips may fail to render citations properly

---

v2-beta-1

Ceci est la première bêta de Cosma GUI v2. Elle comprend trois changements majeurs :

1. Cosma s'imprègne de l'esprit de l'Otletosphere : en plus de fichiers Markdown, les cosmoscopes peuvent désormais être créés à partir de données tabulaires, et nous avons ajouté de nouvelles options graphiques telles que régler les nœuds sur une taille fixe, et utiliser des images comme vignettes/portraits sur les nœuds et dans les fiches.
2. Les projets ! Cosma est maintenant capable de gérer plusieurs projets, chacun correspondant à une source de données.
3. Le mode chronologique est un nouveau filtre d'affichage basé sur des métadonnées temporelles. C'est un curseur qui permet de faire apparaître et disparaître les nœuds en fonction des métadonnées begin et end. Work-in-progress.

Ajouts

• Gérer plusieurs projets
• Utiliser une syntaxe alternative pour les liens
• Afficher des métadonnées supplémentaires dans les fiches dans le cosmoscope
• Exclure certaines fiches lors de la génération du cosmoscope, sur la base des types, mots-clés et métadonnées supplémentaires
• Afficher les nœuds en mode chronologique
• Embarquer des images dans le cosmoscope (en base64). Formats pris en charge : JPG, PNG
• Associer une image à un type de fiche
• Associer une image à une fiche (affichée sur le nœud et dans la fiche)
• Définir une couleur de contour pour les types de nœuds
• Choisir entre nœuds de taille fixe et de taille proportionnelle à leur degré

Améliorations

• Les liens en bibliographie sont désormais cliquables
• Le rapport d'erreurs et d'avertissements est plus informatif
• Les mots-clés au sommet des fiches dans le cosmoscope ne débordent plus de la mise en page
• Cosma lit désormais les répertoires de fiches de manière récursive (ticket #4)

Bugs résolus

• Les infobulles de contexte des liens/rétroliens mettent correctement en évidence la fiche cible (ticket #23)
• Les espaces dans les noms de fichiers générés par Cosma sont correctement remplacés par des tirets

Bugs connus

• Le traitement des citations échoue parfois dans les infobulles de contexte des rétroliens

- JavaScript
Published by Myllaume about 3 years ago

cosma - Cosma 1.1

This update introduces a full English translation of the application, as well as a few bug fixes and small interface improvements.

(Texte en français plus bas)

• The application is translated into English, visit Preferences › General to switch languages.
• Creating a record without first specifying a directory no longer causes an error but returns an informative message (issue #6).
• Creating a record with a title already in use no longer silently overwrites the existing record but asks for confirmation (issue #5).
• It is now possible to use keywords instead of tags in the records' YAML header (issue #3).
• It is no longer necessary to declare a record type in the configuration before assigning it to a new record.
• The Preferences window has been reorganised into sections.
• The readability of error reports has been improved.
• The minify option to reduce the size of exports, which was not functional in v1.0, has been removed.
• The application is now distributed with its documentation, accessible via Help › Manual or by clicking on the Help button at the bottom left of the cosmoscope.
• The source code has been reorganised to allow the simultaneous development of a command line version (cosma-cli) from the same code base (cosma-core).
• Upgrade from Electron v13 to v15.

---

Cette mise à jour ajoute la possibilité de changer de langue (anglais ou français), résout des bugs et améliore l'interface, notamment au niveau de la configuration.

• L'application est traduite en anglais, il est possible de changer de langue dans Préférences.
• Créer une fiche sans spécifier de répertoire ne cause plus d'erreur mais renvoie un message informatif (ticket #6).
• Créer une fiche avec un titre déjà utilisé n'écrase plus silencieusement la fiche existante mais demande une confirmation (ticket #5).
• Il est possible d'utiliser keywords au lieu de tags dans l'en-tête YAML des fiches (ticket #3).
• Il n'est plus nécessaire de déclarer un type de fiche dans la configuration avant de pouvoir l'assigner à une nouvelle fiche.
• La fenêtre Préférences a été réorganisée en sections.
• La lisibilité des rapports d'erreur a été améliorée.
• L'option minify permettant de réduire la taille des exports, non fonctionnelle en v1.0, a été supprimée.
• L'application est distribuée avec sa documentation, accessible via Aide › Manuel ou bien en cliquant sur le bouton Aide en bas à gauche dans le cosmoscope.
• Le code source a été réorganisé pour permettre le développement simultané d'une version exécutable en ligne de commande (cosma-cli) à partir de la même base de code (cosma-core).
• Mise à jour de Electron v13 vers v15.

- JavaScript
Published by infologie over 4 years ago

cosma - Cosma 1.0

Cosma est un logiciel de visualisation de graphe documentaire. Il permet de représenter des notes interreliées sous la forme d’un réseau interactif dans une interface web.

Après le développement d'une première version utilisable en ligne de commande, Cosma fait peau neuve et devient une application autonome, à interface graphique, disponible sur macOS et Windows.

Installation

⬇️ Dépliez le menu Assets sous cette description pour afficher les fichiers téléchargeables. ⬇️

• Sur macOS : téléchargez puis décompressez le fichier Cosma.app.zip et placez le fichier Cosma.app dans ~/Applications. Au premier lancement, faites clic droit › Ouvrir sur l'application pour l'exécuter.
• Sur Windows : téléchargez puis décompressez le fichier Cosma-win32-x64, renommez le dossier « Cosma » et placez-le dans C:\Programmes ou C:\Programmes (86).

Attention, l'application n'est pas signée avec un certificat de sécurité : vous devez disposer des privilèges administrateurs sur votre session pour pouvoir l'exécuter.

Sur toutes les plateformes, vous pouvez également télécharger et décompresser le fichier cosma-fiches-aide.zip pour obtenir un répertoire cosma-fiches-aide contenant une documentation utilisateur sous forme de fiches. Ceci vous permet de tester le logiciel : dans Cosma, indiquez le chemin de ce répertoire dans Préférences › Répertoire de fiches.

Avertissement

🚧 Cette 1.0 n'est que partiellement documentée et comporte probablement quelques bugs. 🚧

La documentation utilisateur est à jour et en ligne. La documentation de développement sera mise à jour et publiée prochainement.

Les bugs feront l'objet de correctifs qui seront rassemblés dans une version ultérieure. Une liste des bugs connus est mise à jour périodiquement sur la page Issues.

- JavaScript
Published by infologie almost 5 years ago

cosma - Cosma 1.0-beta

Cosma est un logiciel de visualisation de graphe documentaire. Il permet de représenter des notes interreliées sous la forme d’un réseau interactif dans une interface web.

Après le développement d'une première version utilisable en ligne de commande, Cosma fait peau neuve et devient une application autonome, à interface graphique, disponible sur macOS et Windows.

Installation

⬇️ Dépliez le menu Assets sous cette description pour afficher les fichiers téléchargeables. ⬇️

macOS : téléchargez puis décompressez le fichier Cosma.app.zip et placez le le fichier Cosma.app dans ~/Applications.

Windows : téléchargez puis décompressez le fichier Cosma-win32-x64, renommez le dossier « Cosma » et placez-le dans C:\Programmes ou C:\Programmes (86).

Pour toutes les plateformes : vous pouvez également télécharger et décompresser le fichier cosma-fiches-aide.zip pour obtenir un répertoire cosma-fiches-aide contenant une documentation utilisateur sous forme de fiches. Ceci vous permet de tester le logiciel : dans Cosma, indiquez le chemin de ce répertoire dans Préférences › Répertoire de fiches.

Avertissement

🚧 Attention : ceci est une bêta partiellement documentée et comportant quelques bugs. 🚧

La documentation utilisateur est à jour et en ligne. La documentation de développement sera mise à jour et publiée prochainement.

Les bugs feront l'objet de correctifs qui seront rassemblés dans une version ultérieure. Une liste des bugs connus est mise à jour périodiquement ci-dessous :

• Nouvelle fiche : si l'utilisateur n'a pas renseigné Préférences › Répertoire de fiches, Nouvelle fiche renvoie un message d'erreur.
• Historique : cliquer sur "Modifier" modifie les champs de plusieurs entrées d'historique à la fois.
• Configuration : si un chemin précédemment enregistré renvoie vers un fichier/dossier qui n'existe plus (fichier/dossier supprimé ou renommé), ce chemin ne peut pas être modifié via l'application. Modifiez manuellement le fichier config.json situé dans les fichier de support à l'application : ~/Library/Application Support/cosma (macOS).

- JavaScript
Published by infologie almost 5 years ago