{"id":19338265,"url":"https://github.com/gbv/cocoda","last_synced_at":"2026-07-06T12:30:24.562Z","repository":{"id":41583749,"uuid":"132579489","full_name":"gbv/cocoda","owner":"gbv","description":"A web-based tool for creating mappings between knowledge organization systems.","archived":false,"fork":false,"pushed_at":"2024-12-13T09:07:42.000Z","size":114717,"stargazers_count":40,"open_issues_count":81,"forks_count":5,"subscribers_count":8,"default_branch":"dev","last_synced_at":"2025-01-06T10:29:05.831Z","etag":null,"topics":["code4lib","coli-conc","service","ts4nfdi","web-application"],"latest_commit_sha":null,"homepage":"https://coli-conc.gbv.de/cocoda/","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gbv.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-05-08T08:37:15.000Z","updated_at":"2024-12-13T09:06:35.000Z","dependencies_parsed_at":"2023-02-19T08:10:16.875Z","dependency_job_id":"3e6b2492-c13f-4335-8889-faedefdda2cc","html_url":"https://github.com/gbv/cocoda","commit_stats":null,"previous_names":[],"tags_count":60,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gbv%2Fcocoda","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gbv%2Fcocoda/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gbv%2Fcocoda/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gbv%2Fcocoda/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gbv","download_url":"https://codeload.github.com/gbv/cocoda/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240441952,"owners_count":19801793,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["code4lib","coli-conc","service","ts4nfdi","web-application"],"created_at":"2024-11-10T03:16:52.128Z","updated_at":"2026-07-06T12:30:24.453Z","avatar_url":"https://github.com/gbv.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cocoda Mapping Tool\n\n[![GitHub release](https://img.shields.io/github/release/gbv/cocoda.svg)](https://github.com/gbv/cocoda/releases/latest)\n[![Web App Status](https://coli-conc-status.fly.dev/api/badge/8/status)](https://coli-conc.gbv.de/cocoda/app/)\n[![License](https://img.shields.io/github/license/gbv/cocoda.svg)](https://github.com/gbv/cocoda/blob/master/LICENSE)\n[![Docker](https://img.shields.io/badge/Docker-ghcr.io%2Fgbv%2Fcocoda-informational)](https://github.com/gbv/cocoda/blob/dev/docker/README.md)\n[![Build Status](https://github.com/gbv/cocoda/actions/workflows/build.yml/badge.svg)](https://github.com/gbv/cocoda/actions/workflows/build.yml)\n[![standard-readme compliant](https://img.shields.io/badge/readme%20style-standard-brightgreen.svg)](https://github.com/RichardLitt/standard-readme)\n\n\u003e A web-based tool for creating mappings between knowledge organization systems.\n\nTry out the [latest release version](https://coli-conc.gbv.de/cocoda/app/), the [current development version](https://coli-conc.gbv.de/cocoda/dev/), and consult the [usage documentation](#usage)!\n\n## Table of Contents\n\n- [Install](#install)\n  - [Release versions](#release-versions)\n  - [Development versions](#development-versions)\n  - [Serving the Files](#serving-the-files)\n  - [Docker](#docker)\n- [Usage](#usage)\n- [Configuration](#configuration)\n- [Maintainers](#maintainers)\n- [Contribute](#contribute)\n- [License](#license)\n\n## Install\n\n### Release versions\n\nReleases [can be downloaded](https://github.com/gbv/cocoda/releases) in form of static files. Extract into a web server directory and adjust [configuration](#configuration) file `cocoda.json`. You could automate download and extraction of the latest release with [jq](https://stedolan.github.io/jq/) like this:\n\n```bash\n# You can also manually download the latest release here: https://github.com/gbv/cocoda/releases/latest\nwget -N $(curl -s https://api.github.com/repos/gbv/cocoda/releases/latest | jq -r '.assets[].browser_download_url')\nunzip cocoda-*.zip\nrm cocoda-*.zip\n```\n\nThe directory `cocoda` is then ready to be [served with any web server](#serving-the-files).\n\n### Development versions\n\nAlternatively, it's possible to clone the [Cocoda repository](https://github.com/gbv/cocoda):\n\n```bash\ngit clone https://github.com/gbv/cocoda.git\ncd cododa\n```\n\nThen install required Node modules with [npm](https://www.npmjs.com/get-npm) and run build (requires Node.js v18 or above, v20 recommended):\n\n```bash\nnpm ci\nnpm run build\n```\n\nFiles are created in directory `dist`, including the configuration file.\n\n### Serving the Files\n\nAny web server can be used to serve Cocoda files. No special configuration is necessary. For instance using the `http-server` npm package to serve Cocoda at \u003chttp://localhost:8000\u003e:\n\n```bash\n# serve the pre-built release\nnpx http-server -p 8000 cocoda/\n# or serve the build version\nnpx http-server -p 8000 dist/\n```\n\n### Docker\n\nCocoda is also available via Docker. Please refer to [our Docker documentation](https://github.com/gbv/cocoda/blob/dev/docker/README.md) for more information and instructions.\n\n## Usage\n\nThere is a detailled end-user manual available [in German](https://gbv.github.io/cocoda/dev/user-manual-de.html) and [in English](https://gbv.github.io/cocoda/dev/user-manual-en.html). The German version will likely be more up-to-date. Documentation sources are located in directory `docs`.\n\n## Configuration\n\nFor the pre-built version, configuration options can be overridden by using `cocoda.json` in the root of the directory. The default options are given in the file [`config/cocoda.default.json`](https://github.com/gbv/cocoda/blob/dev/config/cocoda.default.json) (please consult this file for examples on how to use the configuration options). When using a manual build, create file `config/cocoda.json` and rebuild (`npm run build`) after editing (you can also run `npm run build -- --config-only` if you already have a build in folder `dist/` and only need to update the config file). The following fields are recognized so far:\n\n* **title**: the main title of the instance as plain string\n\n* **logos**: a list of logos to display left to the title, each with subfields:\n  * `file`: image URL relative to the `static` directory\n  * `alt`: alternate text for the image, if the image cannot be displayed, as plain string\n  * `url`: URL to link from the logo\n\n* **menu**: a list of links to show in the menu, each with subfields:\n  * `url`: the link URL\n  * `prefLabel`: mapping of language codes to link titles\n\n* **searchLinks**: a list of search links to quickly link to external resources from concepts. Each searchlink has subfields:\n  * `url` an URL template with possible parameters `{prefLabel}` and/or `{notation}`\n  * `prefLabel`: mapping of language codes to link titles\n\n* **favoriteSchemes**: list of vocabulary URIs to be favorited by default.\n\n* **languages**: array with supported interface languages\n\n* **registries**: lists [registries](#registries) where to get data from\n\n* **overrideRegistries**: `false` (default) or `true`\n  controls whether to override registries listed in `config/cocoda.default.json`\n\n* **auth**: URL to a [login-server](https://github.com/gbv/login-server) instance to be used for authentication\n\n* **conceptLists**: a list of concept lists. Each list can be either an object or a URL that returns a JSON object. Objects are basically [JSKOS registries](http://gbv.github.io/jskos/jskos.html#registries) with required properties `prefLabel` and `concepts`. If `concepts` is a string, it will be considered a URL which returns a JSON array of concepts. Optional properties are `notation` and `scopeNote`.\n\n* **autoRefresh**: an object with auto refresh values in milliseconds. `autoRefresh.mappings` determines how often mappings in MappingBrowser will be reloaded (default: 10000 = every 10 seconds), `autoRefresh.update` determines how often Cocoda will look for an update (default: 120000 = every 2 minutes).\n\nUsing the pre-built version, the application only has to be reloaded after editing the configuration file.\n\n## Maintainers\n\n- [@stefandesu](https://github.com/stefandesu)\n- [@nichtich](https://github.com/nichtich)\n\n## Contribute\n\nYour contributions to improve Cocoda are very welcome: please [open a GitHub issue](https://github.com/gbv/cocoda/issues/new) for feature suggestions and bug reports! See the file [CONTRIBUTING.md](CONTRIBUTING.md) for more information about how and where to best contribute and for development details.\n\nSee \u003chttps://gbv.github.io/cocoda/\u003e for API documentation automatically build from Node sources.\n\n## License\n\nMIT ©2019 Verbundzentrale des GBV (VZG)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgbv%2Fcocoda","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgbv%2Fcocoda","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgbv%2Fcocoda/lists"}