About Cosma

id : 20210901132721
last modified :
type : documentation

Cosma is a document graph visualization tool. It modelizes interlinked Markdown files and renders them as an interactive network in a web interface.

A unique tool

Among tools for thought, Cosma stands out on three key aspects:

First, Cosma is not a note-taking app. It is designed to work in conjunction with these programs. This is inspired by software such as Deckset, which applies this principle to presentations (write in your favorite editor, visualize elsewhere).

Secondly, Cosma is based on interoperable, open and standardised writing conventions. This allows you to use other tools that share these standards (such as Zettlr) and to switch tools more freely. Overall, it increases the durability of your data.

Finally, Cosma allows you to simultaneously share your data and the tools to explore it. What does this mean? Most visualization tools are packed with great functionality, but they only export static images, or structured data that requires software to make any use of. Cosma reverses this logic: what you see in the main window is actually a standalone HTML file, meaning you can share it and thus transmit not just your data, but a fully interactive representation of it.

These three aspects make Cosma a unique proposition among tools for thought.

A high degree of user control

Cosma works with a directory of text-based files, and only reads them. Installing, using and uninstalling the app does not alter your files, nor does it interfere with your existing practices for storage, editing and version control.

Many interface elements are customizable, from the graph layout to the color of nodes and pattern of links. Interesting views can be saved as shortcuts. Users proficient with CSS can use a custom stylesheet.

You can add semantic metadata to records and links through simple writing conventions. This is done through generic mechanisms, meaning you are free to invent and use any categories to describe your data.

Cosma is free software. The code is public, its development is documented, it is accessible and reusable for free under the GNU GPL license. Our work can thus be evaluated, archived and continued by others.

A research experiment

Cosma was imagined by Arthur Perret as part of his PhD research under the direction of Olivier Le Deuff. This means the project's DNA is very much experimental, and that its use is subject to caution.

However, we also want to popularize plain text-based research and its possibilities to a wider audience of knowledge workers. This means we have tried to design Cosma as a relatively polished and accessible tool.

Currently, there is no dedicated funding to this project. But Cosma is already in use in a few research projects and graduate programs. This encourages us to keep developing it, and to work on securing more funding in the coming years.

Citing Cosma

Arthur Perret, Guillaume Brioudes, Clément Borel, & Olivier Le Deuff. (2021). Cosma. Zenodo. https://doi.org/10.5281/zenodo.5920615

Citations

id : 20210901134745
last modified :
type : documentation

Cosma offers automatic citation processing. This feature works similarly as in Zettlr: CSL-compliant bibliographic data and styles, and Pandoc-style citation syntax.

You can use Zotero with the Better BibTeX plugin to generate unique citation keys for each reference and then export the references in CSL JSON. Load the file in the Bibibliography section of Cosma's configuration.

You can then integrate the citation keys into your Markdown files using Pandoc-style syntax:

Sur la raison et la déraison graphique [@goody1979; @christin1995, 46-52]…

Click on New cosmoscope with citations to generate a cosmoscope with citation processing enabled. Each citation key is then replaced with formatted text and a bibliography is generated below the body of each record containing references.

Sur la raison et la déraison graphique (Goody 1979 ; Christin 1995, p. 46-52)…

Bibliographie
-------------

GOODY, Jack, 1979. La Raison graphique : la domestication de la pensée sauvage.
  Paris : Les Editions de Minuit. ISBN 978-2-7073-0240-3.

CHRISTIN, Anne-Marie, 1995. L’image écrite, ou, La déraison graphique.
  Paris : Flammarion. Idées et recherches. ISBN 978-2-08-012635-1. 

You can change the citation style (default: ISO690-author-date-fr) by loading a CSL style file in the configuration. Download styles from the Zotero database.

You can localize bibliographic terms (default: French) by loading an XML translation file. Download translations from the CSL database.

Bibliographic data corresponding to the cited references is embedded in the cosmoscope in JSON. You can access this data by clicking on the "Data" button at the bottom of the left side panel. In the cosmoscope source code, they are located under the <article id="citation-references"> tag.

Configuration

id : 20210901145632
last modified :
type : documentation

Cosma can be configured extensively. The GUI version includes a Preferences window. The CLI version reads configuration text files written in YAML.

Required parameters

  • Records directory: path to the directory containing your Markdown files.
  • Auto-save in history: when this option is active, Cosma automatically exports each cosmoscope to a time-stamped subdirectory of the temporary directory defined by your operating system. Click on View History to view and manage entries.
  • Record types: list of record types. Each type is defined by a name and a color. To assign a type to a record, add type: name to its YAML header.
  • Link types: list of link types. Each type is defined by a name, a color and a stroke type. Stroke types are predefined: single, double, dash and dotted. To assign a type to a link in a record, prefix the identifier with the name of a link type followed by a colon. Example: [[link_type:ID]].

Warning: The default type undefined is required for both record types and link types. You may not delete it from the configuration.

Tip: The links' visual settings have a strong impact on their readability within the graph. For example, a user may define three link types in the manner of a thesaurus (s for “specific”, g for “generic” and a for “associated with”). The colors and stroke types can be set to enhance the visibility of certain types of links: if undefined links are in dotted gray and qualified links are in darker solid strokes, the latter will stand out.

Graph parameters

The graph parameters can be changed live in the cosmoscope. This allows you to test different values before transferring them to the configuration. The values defined in the configuration are applied each time the cosmoscope is reloaded, and each time a new cosmoscope is generated.

  • Show arrows on links: choose between directed or non-directed graph.
  • Maximum focus level: Focus mode restricts the display to the selected node and its direct connections. Direct means a distance of only 1 node. It is possible to vary this distance by changing Maximum focus level: with a value of 2, Focus mode will display all connections up to a distance of 2 nodes; changing the value to 3 extends it further; etc.
  • Label text size: defines the size of the nodes' labels, in pixels. Minimum value is 5; maximum value is 15.
  • Background color : the background color of the graph.
  • Highlight color: the color that is applied to nodes and links when hovering and selecting them.
  • Repulsion: this is the overall strength of the simulated force. The higher the value, the longer the links between nodes are.
  • Maximum distance between nodes: this is the maximum threshold for repulsion between nodes.
  • Vertical/horizontal attraction: force of attraction to the vertical/horizontal axis, from 0 to 1. A value of 0 means that the parameter is disabled. Applying a vertical/horizontal force “tightens” the graph and brings isolated nodes closer to the center.

Additional parameters

  • Metadata: this optional metadata is added to the About pane of exported cosmoscopes.
  • Bibliography: load your bibliographic data, style and localization files here. All three files are required for citation processing.
  • Views: manage the views saved in the cosmoscope.
  • Link symbol: enter an arbitrary Unicode string which will replace the bracketed identifiers in the HTML rendering of the files. This allows you to visually lighten the text by replacing long numeric identifiers with a personal convention (for example a small manicule: ☞).
  • Enable developer tools: this option activates the Development menu in the operating system menu bar. Click on Development then Show Web Inspector to display the Chromium engine development tools and inspect the source code to Cosma's interface.
  • Custom CSS: load a custom CSS for the cosmoscope.

In order to design your custom CSS, you can :

  • click on Development then Show Web Inspector (requires clicking on Preferences then Enable Development Tools) ;
  • open the cosmoscope in your web browser and use the browser's development tools;
  • or you can examine Cosma's source code, specifically /cosmoscope/template.njk (for the HTML structure of the cosmoscope), /cosmoscope/styles.css and /cosmoscope/print.css (for the print styles).

Tip: cosmoscope styles use CSS variables to define the colors and fonts. You can redefine these variables to change all the interface elements they apply to. In the example below, the custom.css file contains declarations that change the fonts used in the cosmoscope:

:root {
  --sans: "IBM Plex Sans", sans-serif;
  --serif: "IBM Plex Serif", serif;
  --mono: "IBM Plex Mono", monospace;
  --condensed: 'Avenir Next Condensed', sans-serif;
}

Cosma

id : 20210901131627
last modified :
type : documentation

Welcome to Cosma, a visualization and sharing tool for knowledge workers (Perret, Le Deuff, Borel, Brioudes 2021).

Cosma exists in two different versions that can be downloaded and used separately: a desktop application with a graphical user interface (GUI version) and a command-line tool (CLI version).

The inner workings of Cosma are made of two parts: a cosmographer and a cosmoscope. The cosmographer reads a directory of text files written in Markdown, and renders them as a single HTML file called the cosmoscope. The cosmoscope is displayed in the main window of Cosma. It can also be used as a standalone file.

You are currently browsing a cosmoscope which serves as a quick-start documentation as well as a demonstration of how Cosma works. A more comprehensive user documentation is available online.


Bibliography

PERRET, Arthur, LE DEUFF, Olivier, BOREL, Clément and BRIOUDES, Guillaume, 2021. Cosma [online]. Zenodo. Available from: https://zenodo.org/record/5920616

Cosmographer

id : 20210901133503
last modified :
type : documentation

The cosmographer is the internal part of Cosma that configures the application's behavior and creates content (records and cosmoscope).

Use the cosmographer to create records as well as create cosmoscopes and share cosmoscopes.

Cosmoscope

id : 20210901140150
last modified :
type : documentation

The cosmoscope is an HTML file containing your records as well as tools to explore and interact with them. It is generated by the cosmographer and displayed in the main window of Cosma. But it is also a standalone file, which you can share and use outside of the application without any difference in content or functionality.

Content

The cosmoscope is organized in three areas.

The left side panel of the cosmoscope is the Menu. It contains various exploratory features and interactive settings: index, search, types, keywords and views.

The central area of the cosmoscope displays the graph and associated controls (zoom and focus).

The right side panel of the cosmoscope displays the records, with their metadata, their content and a list of links and backlinks.

Use outside of Cosma

The cosmoscope can exported from Cosma. View an exported cosmoscope by opening it in a web browser. It can be shared like any other computer file: email, file transfer, messaging, uploading on a server, etc.

With an online cosmoscope, you can send links to specific records by adding a # sign and the corresponding identifier at the end of the URL. For example:

https://name.tld/cosmoscope.html#20210427185546

Creating a cosmoscope

id : 20210901141048
last modified :
type : documentation

The main functionality of the cosmographer is to create cosmoscopes. After being generated, the most recent cosmoscope is displayed in the main window of Cosma.

Plain cosmoscope

Click on New cosmoscope (shortcut: Cmd/Ctrl + R) to generate a new cosmoscope.

Cosmoscope with citations

Click on New cosmoscope with citations (shortcut: Shift + Cmd/Ctrl + R) to generate a new cosmoscope with citations. This requires that all appropriate files be loaded in Preferences › Bibliography.

Error handling

Cosma automatically logs a report that describes any problems encountered during the generation of a cosmoscope. Errors can be of two types:

  • something prevents a file from being processed (missing title, non-unique identifier) ;
  • something is unknown (unrecognized record or link type, link to an unrecognized identifier).

Click View History to check the logs for each cosmoscope.

Creating a record

id : 20210901133623
last modified :
type : documentation

Click on New record to open the record creation form.

Entering a title is mandatory. Additionally, you can also assign a type to the record. Record types need to defined beforehand in Preferences. You can also add arbitrary keywords to the record, separated by commas.

Clicking OK creates a new record in the records directory specified in Preferences.

Creating a record from within Cosma guarantees that the file conforms to the data format required by the application.

Data format

id : 20210901133701
last modified :
type : documentation

Cosma does not require the use of any particular writing application. On the other hand, creating content for Cosma requires the use of plain text and the adoption of several writing conventions, which may be facilitated by some writing applications. These conventions are:

  • YAML for the metadata written at the beginning of each record ;
  • Markdown for the rest of the file contents;
  • wiki-like syntax (double brackets [[ ]]) for creating internal links;
  • unique identifiers that serve as anchors for internal links.

Cosma also features automatic citation processing. This relies on the CSL standard and the Pandoc citation syntax.

This combination of writing standards combines several textual cultures: documentation (enriching and indexing content with metadata); wikis (interrelating documents); the Zettelkasten method (organising one's notes); academic writing with Pandoc (using plain text as a source for exporting in various formats). Therefore, Cosma works particularly well when used in tandem with writing environments that also adopt this approach, such as Zettlr or the Foam extension for Visual Studio Code and VSCodium.

You can create a Cosma-compliant file via the application's record creation form (click File › New record, or type Ctrl + N) or manually with the text editor of your choice. Some text editors can save you time with document templates, which you can use to quickly create records for Cosma.

File contents

id : 20210901133951
last modified :
type : documentation

Cosma interprets files as being written in CommonMark, a strictly defined version of Markdown, a popular lightweight markup language. Check out the CommonMark tutorial to learn Markdown in 10 minutes.

Cosma renders Markdown files into HTML. Therefore, Markdown files can also include HTML code, as well as vector images in SVG.

Bitmap images can also be rendered using the Markdown syntax. However, the actual image files are not included when exporting a cosmoscope. To ensure that images are displayed in the export, you should use images hosted on the web, including them via their URL. Example:

![Alternative text](http://domain.com/image.jpg)

Focus

id : 20210901143014
last modified :
type : documentation

Activate Focus mode (shortcut: F) by ticking the “Focus” box at the bottom left of the graph. In Focus mode, only direct connections to the selected node are displayed in the interface. Focus mode only works if you have selected a record.

You can increase the maximum distance displayed in Focus mode with the slider located beneath the Focus button. The slider's maximum value can be set in Preferences › Maximum focus level. A value of 1 means only the immediate connections will be displayed when in Focus mode. A value of 2 means you can extend the focus two connections of connections, and so on.

The focus level slider can be controlled with the arrow keys. You can combine shortcuts: F to activate Focus mode, then arrow keys to increase and decrease the focus level.

Graph

id : 20210901142644
last modified :
type : documentation

The central area of the cosmoscope is an interactive graph of labelled nodes. Each node corresponds to a record; the label corresponds to the title of the record. The links correspond to the links established between the records via their identifiers.

Hovering over a node temporarily highlights it and its connections. Clicking on a node highlights it and its connections and opens the corresponding record.

You can zoom in and out of the graph freely with a mouse or touchpad, by double-clicking on the graph background or with the dedicated buttons at the bottom left. Press C to zoom in on a selected node (whose record is open). The Reset button (shortcut: R) resets the zoom.

Nodes are organised in space by a force simulation algorithm. A coloured bar at the top of the Menu indicates the state of the drawing process (active or finished). Click on this bar (shortcut: Space) to start an additional simulation cycle. This does not reset the graph but re-runs the algorithm on the existing graph, improving its layout.

If you have a particularly tangled graph, pressing Space a few times will progressively untangle it.

The graph is not fixed: nodes can be moved by click and drag. However, the nodes and links remain permanently subject to the simulation, so it is not possible to arrange them manually. Modifying the records may change the arrangement of the nodes in space.

The way the graph is displayed can be changed temporarily via the controls under Graph settings in the Menu. To change the display permanently, change the default values of the corresponding settings in Preferences › Graph.

Change the strength and maximum distance between nodes to adapt the display to your screen resolution and size. Add vertical/horizontal attraction to tighten the graph and bring isolated nodes closer to the center.

The graph can be displayed on all types of screens but is not optimised for mobile devices: touch does not give access to certain interactions such as hovering, and small screens greatly limit the usefulness of the graph.

Identifiers

id : 20210901134136
last modified :
type : documentation

To be correctly interpreted by Cosma, each record must have a unique identifier. This identifier serves as a target for links between records.

By default, Cosma generates 14-digit identifiers in the form of a timestamp (year, month, day, hours, minutes and seconds). This is inspired by Zettelkasten note-taking applications such as The Archive and Zettlr.

Many interrelated note-taking applications use file names as targets for links between files. They maintain links automatically when file names are changed. By choosing to use unique identifiers instead, we have designed Cosma with a more traditional, stricter, WWW-like approach. We believe this is the easiest way to avoid link rot in a sustainable way. Avoiding the reliance on automatic link maintenance is especially important if you wish to make your data less dependent on specific applications.

Links based on unique identifiers have disadvantages, mainly in terms of user experience: they are cumbersome to write and to read, especially when the identifier is a long series of numbers. In Preferences › Link symbol, you can define a string of characters (as small and visually distinct as the manicle ☞), which Cosma will display instead of the identifiers as the text of links in the cosmoscope.

Index

id : 20210901143958
last modified :
type : documentation

The alphabetical index of records in the Menu allows you to select a record from a list rather than through the graph. Clicking on a title selects the corresponding node in the graph and opens the corresponding record. The index can be sorted in ascending or descending alphabetical order.

Installing

id : 20210901132906
last modified :
type : documentation

Cosma is available in two versions: a graphical user interface (GUI) application and a command line interface (CLI) application.

GUI version

The GUI version of Cosma is available for macOS and Windows. Visit the Releases page of the GitHub repository to get the latest version. Please note that the application is not signed with a security certificate, so you must have administrator privileges on your session to run it.

On macOS: download and unzip Cosma.app.zip, then place it in ~/Applications. For the first launch, right click on the application then select Open to run it.

On Windows: download and unzip Cosma-win32-x64.zip, then rename the folder Cosma and place it in C:\Program Files or C:\Program Files (86).

CLI version

The CLI version of Cosma is available on macOS, Windows and Linux. The installation of NodeJS version 15 or higher is required. Enter the following command in your terminal to install Cosma CLI:

npm i @graphlab-fr/cosma -g

Keywords

id : 20210901143845
last modified :
type : documentation

The list of keywords in Menu allows you to highlight records that use the selected keywords. Selecting a keyword highlights the label of the corresponding nodes in the graph and restricts the index to the corresponding records. You can activate several keywords simultaneously. To deactivate a keyword, click the corresponding button again.

For a keyword to appear, it must have been declared in the tags field of the YAML header of at least one record. The value must be a list. A record can have as many keywords as you wish. You can use keywords instead of tags, for compatibility with Pandoc. If a record has a tags field and a keywords field, only the keywords declared in the tags field are interpreted by Cosma.

Links

id : 20210901134026
last modified :
type : documentation

Within a record, you link to another record by writing its identifier between double brackets.

Example:

A link to [[20201209111625]] record B.

Cosma allows you to define link types. Each link type is defined by a name, a colour and a stroke pattern. To apply a type to a link, add the name of the type followed by a colon before the identifier.

Example:

Concept B is derived from [[generic:20201209111625]] concept A.

Person D wrote against [[opponent:20201209111625]] person C.

To improve the readability of records in the cosmoscope, Cosma includes an option to customise the text of the links. Under Preferences › Link symbol, enter one or more Unicode characters (letters, numbers, symbols…). Example: ☞. This string replaces the identifier and square brackets in the HTML rendering of the records.

Metadata

id : 20210901133736
last modified :
type : documentation

In order to be correctly interpreted by Cosma, Markdown files (.md) must include a YAML header at the beginning of the file.

This header is created automatically when you create a file via Cosma. You can also create it manually, or with the help of a template in certain text editors.

Example:

---
title: Title of the record
id: 20201209111625
type: undefined
tags:
- keyword 1
- keyword 2
---

The YAML header is delimited by two sets of three single dashes on a line (---).

In YAML, a field consists of a name and a value separated by a colon. Cosma recognises and uses the following four fields:

title (mandatory): title of the record.

id (mandatory): unique identifier of the record. By default, Cosma generates 14-digit identifiers in the form of a timestamp (year, month, day, hours, minutes and seconds). This is inspired by Zettelkasten note-taking applications such as The Archive and Zettlr.

type (optional): record type. Only one type can be assigned to a record. If the type field is not specified or its value does not match one of the types declared in the configuration, Cosma will interpret the type of the record as undefined.

tags (optional): keywords assigned to the record. The value must be a list. A record can have as many keywords as you wish. You can use keywords instead of tags, for compatibility with Pandoc. If a record has a tags field and a keywords field, only the keywords declared in the tags field are interpreted by Cosma.

In accordance with the YAML specification, the list of keywords can be written in block mode:

tags:
- keyword 1
- keyword 2

Or in flow mode:

tags: [keyword 1, keyword 2]

You can add additional YAML fields arbitrarily. You may for example include fields recognized by Pandoc.

Why a YAML header?

Some applications opt to recognize file metadata heuristically. For example, if the first line of the file is a level 1 heading, then it will be interpreted as the title of the file; if the second line contains words prefixed with a # pound sign, then they will be interpreted as keywords.

This method is not interoperable: each program has its own conventions, which limits the user's ability to change tools.

Using a YAML header allows writers to declare different metadata explicitly and separately. This has the advantage of making the detection and manipulation of this metadata trivial, both by machines and humans. The use of a common format (such as YAML) increases the number of tools that can be used seamlessly with the same set of files. And widely used computer tools such as regular expressions and shell scripts allow people to convert their data themselves in a relatively simple way if needed.

Records

id : 20210901142849
last modified :
type : documentation

Records can be opened by clicking on a node, an index entry, a search engine suggestion, or a link in the body or footer of a record. Opening a record displays its contents in the right side panel.

In Cosma, you can go forward or backward with the Previous / Next buttons located in the left side panel. In a web browser, you can do the same via the browser's Previous / Next functions. Opening a record adds the corresponding identifier at the end of the URL. This allows you to copy direct links to records.

Clicking on the “Close” button closes the right side panel and deselects the corresponding node in the graph.

The links in the records are clickable. In a browser, you can open these links in a new tab via a right click. The title of the link (displayed in a tooltip after 1-2 seconds of hovering) is the title of the corresponding card.

To improve the readability of the records in the cosmoscope, Cosma includes an option to customise the text of the links. In Preferences › Link symbol, enter one or more Unicode characters (letters, numbers, symbols...). Example: ☞. This string replaces the identifier in square brackets in the HTML rendering of the records.

Contextualised links and backlinks

At the bottom of each record is a list of outgoing and incoming links (or backlinks). The links and backlinks are contextualised: when hovering over them, a tooltip is displayed, showing the paragraph that surrounds this link in the corresponding record.

This is one the most useful features in hypertext systems. It is famously absent from the Web. Many interrelated note-taking applications treat links as “first-class citizens”, and this includes contextualised backlinks. However, when these notes are shared on the Web, this feature is not always included, or it is only inclued in a paid plan. With Cosma, contextualised backlinks are part of the package, whether you're the author of a cosmoscope working locally, or someone exploring a cosmoscope on the Web.

Search

id : 20210901143134
last modified :
type : documentation

The text field at the top of the Menu allows you to search record titles. It suggests a list of records whose title is closest to what you type in the search bar (using fuzzy search). Clicking on a suggestion selects the corresponding node in the graph and opens the corresponding record in the right side panel.

Sharing a cosmoscope

id : 20210901144524
last modified :
type : documentation

Click on File › Share (Cmd/Ctrl + E) to export a comoscope to be used outside of the application.

Two options are available:

  • Process citations: process citation keys to generate bibliographies within the records and add bibliographic data to the cosmoscope.
  • Custom CSS: apply a custom CSS stylesheet to modify the appearance of the cosmoscope.

If the options are greyed out, it means that the corresponding settings in Preferences are not filled in.

Cosmoscopes exported via the Share menu include metadata (title, author, description, keywords) if they are set in Preferences › Metadata. These are displayed in the “About” panel. They are also included in the cosmoscope source code in the form of meta tags.

The toolbar at the top of the Menu only works in Cosma. It is therefore hidden in cosmoscopes exported via the Share menu. If a title has been set in Preferences › Metadata, it will be displayed instead.

The exported cosmoscope.html file can be shared like any other computer file: email, file transfer, messaging, uploading to a server…

In the case of a cosmoscope published on the Web, it is possible to link directly to a record by adding its identifier preceded by a # pound sign at the end of the URL. Example:

https://domain.com/cosmoscope.html#20210427185546

Types

id : 20210901143447
last modified :
type : documentation

The list of record types in the Menu allows you to filter the display. Deselecting a type hides the corresponding records in the graph, index and search engine suggestions. Deselecting a type while holding down the Alt key hides the records of all the other types.

For a type to appear in this list, it must be declared in Preferences › Record types and be assigned to at least one record.

Views

id : 20210901144304
last modified :
type : documentation

At any time, the state of the graph (selected record, active filters, focus mode) can be saved for quick access. This works like a bookmark. Click the Save view button under Views in the Menu and enter a name. This adds an eponymous button to the Views section. Clicking this button applies all settings that were active at the time the view was saved. Clicking the button again restores the normal view.

Views are preserved when exported. However, it is not possible to create a new view from an export. This is only possible from within Cosma.

Visibility of records

id : 20210901150958
last modified :
type : important

Filtering by type and keyword, as well as using Focus mode, affects which records are displayed in the index as well as in search suggestions. A record hidden by one of these features will not be accessible via the search engine and will not be visible in the index.

Click on Reset display (shortcut: Alt + R) to rest filters and focus. All records will be listed again in the index and accessible via the search engine.

Help

Click here to access Cosma's documentation

Shortcuts

Space Re-run the force-layout algorithm
S Move the cursor to Search
Alt + click (on a record type) Deselect other types
R Reset zoom
Alt + R Reset the display
C Zoom in on the selected node
F Switch to Focus mode
Escape Close the active record

Cosma Demo

Arthur Perret, Guillaume Brioudes

Cosma is a graph visualization and sharing tool for knowledge workers. From a directory of text files written in Markdown, Cosma generates a collection of records gathered in a single HTML file: the cosmoscope. You are currently viewing a cosmoscope created with Cosma. It is both a demo and a sample of the documentation, which can be found here: https://cosma.graphlab.fr/en/docs/


Version 1.0.1 • License GPL-3.0-or-later

  • Arthur Perret
  • Guillaume Brioudes
  • Olivier Le Deuff
  • Clément Borel
  • ANR research programme HyperOtlet
D3 v4.13.0
Mike Bostock (BSD 3-Clause)
Nunjucks v3.2.3
James Long (BSD 2-Clause)
Js-yaml v4.1.0
Vitaly Puzrin (MIT License)
Js-yaml-front-matter v4.1.1
Derek Worthen (MIT License)
Markdown-it v12.3.0
Vitaly Puzrin, Alex Kocharin (MIT License)
Citeproc v2.4.62
Frank Bennett (CPAL, AGPL)
Fuse-js v6.4.6
Kiro Risk (Apache License 2.0)
Moment v2.29.1
Iskren Ivov Chernev (MIT License)

Bibliographical data

The data below correspond to the references cited in this cosmoscope. They are structured according to the Citation Style Language standard and expressed in JSON. This format is recognized by most popular bibliographic management software, such as Zotero, Mendeley or Papers. Click on the button below to download the data.

[{"id":"cosma","author":[{"family":"Perret","given":"Arthur"},{"family":"Le Deuff","given":"Olivier"},{"family":"Borel","given":"Clément"},{"family":"Brioudes","given":"Guillaume"}],"citation-key":"cosma","DOI":"10.5281/zenodo.5920615","issued":{"date-parts":[[2021,5,3]]},"language":"fr","publisher":"Zenodo","title":"Cosma","type":"book","URL":"https://zenodo.org/record/5920616","version":"v1.0.0","used":true}]