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

Cosma 2.0.2

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

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

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

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.

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

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.

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.

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