{"id":13928739,"url":"https://github.com/AKSW/MadamsEditor","last_synced_at":"2025-07-19T10:32:00.275Z","repository":{"id":77119944,"uuid":"314235180","full_name":"AKSW/MadamsEditor","owner":"AKSW","description":"(yet simple) YARRRML mapping editor: map JSON data to RDF.","archived":true,"fork":false,"pushed_at":"2021-02-24T11:07:17.000Z","size":11285,"stargazers_count":4,"open_issues_count":2,"forks_count":2,"subscribers_count":28,"default_branch":"master","last_synced_at":"2024-08-07T18:12:54.295Z","etag":null,"topics":["json","mapping","rdf","rml","yarrrml"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-sa-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AKSW.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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}},"created_at":"2020-11-19T12:02:05.000Z","updated_at":"2024-04-22T18:49:56.000Z","dependencies_parsed_at":"2023-03-22T02:03:14.888Z","dependency_job_id":null,"html_url":"https://github.com/AKSW/MadamsEditor","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AKSW%2FMadamsEditor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AKSW%2FMadamsEditor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AKSW%2FMadamsEditor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AKSW%2FMadamsEditor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AKSW","download_url":"https://codeload.github.com/AKSW/MadamsEditor/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226588819,"owners_count":17655794,"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":["json","mapping","rdf","rml","yarrrml"],"created_at":"2024-08-07T18:01:35.189Z","updated_at":"2024-11-26T17:30:57.930Z","avatar_url":"https://github.com/AKSW.png","language":"JavaScript","funding_links":[],"categories":["json"],"sub_categories":[],"readme":"# MaDaMs Editor (**Ma**terial **Da**ta **M**apping)\n\n(yet simple) Text based editor to map JSON data with [YARRRML](http://rml.io/yarrrml/) (a human-readible form of RDF Mapping Language [[RML](https://rml.io/specs/rml/)]) to RDF. Demo available [here](https://aksw.github.io/MadamsEditor/dist/).\n\nThe RML to YARRRML is based on [YARRRML-Parser](https://github.com/RMLio/yarrrml-parser).\n\nTo apply the mappings on the data an RML Mapper service is **required**. We use the Node JavaScript library [RocketRML](https://github.com/semantifyit/RocketRML) for this.\n\n## Screenshot\n\n[![Screenshot](./screenshot.png)](https://aksw.github.io/MadamsEditor/dist/)\n\n## Init, install packages\n\n    docker-compose up install\n\n## Start development environment\n\nRun installation first, then:\n\n    docker-compose up dev\n\nAccess app at `http://localhost:1234` and RML mapping server at `http://localhost:3000`\n\nTo change default ports edit file `.env`\n\n## Create productive build\n\nRun installation first, then\n\n    docker-compose up build\n\nWill create files in `./dist/`\n\n## Start productive\n\nThe productive requires one server to deliver the HTML/Javascript app and a Node server for the RML mapper.\n\n1) Create build\n2) App: make content of `./dist/` public available\n3) Server: start mapping server with Docker `docker-compose up server` or directly with Node `node src/server.js`. To change default port (3000) edit file `.env`.\n\n### Usage\n\nSee `./src/app.html` for usage example.\n\nUsage as library:\n\n```js\nnew MadamsEditor({\n    // JSON DATA: url to a json ressource or JSON object as value\n    'data': {\n        'type': 'url' ,  // url|json\n        'value': './dist/example-data.json',  // string|json\n        'name': '' // string (required for json)\n    },\n    // MAPPING: url to yaml (yarrrml) ressource, or yaml (yarrrml) as string\n    'mapping': {\n        'type': 'url' , // url|yaml\n        'value': './dist/example-mapping.yml', // string\n        'name': '' // string (required for yaml)\n    },\n    // url to RML mapper service\n    'rmlMapperUrl': 'http://localhost:3000/rmlmapper',\n    // callback method after run\n    run: function(mapping, result) { }\n});\n```\n\n# Ressources\n\n- [RML](https://rml.io/specs/rml/)\n- [YARRRML](https://rml.io/yarrrml/spec/)\n- [JSONPath](https://goessner.net/articles/JsonPath/index.html), [more JSONPath](https://gregsdennis.github.io/Manatee.Json/usage/path.html), [JSONPath-Plus](https://github.com/JSONPath-Plus/JSONPath)\n- [YARRRML-Parser](https://github.com/RMLio/yarrrml-parser)\n- [RocketRML](https://github.com/semantifyit/RocketRML)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAKSW%2FMadamsEditor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAKSW%2FMadamsEditor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAKSW%2FMadamsEditor/lists"}