From de322fb41f83fc8c32142e731cedd1443e1fb51a Mon Sep 17 00:00:00 2001 From: Joshua Ramon Enslin Date: Sat, 24 Jun 2023 00:55:45 +0200 Subject: [PATCH] Extend README --- README.md | 35 +++++++++++++++++++++++++++++++---- classes/MDAllowedValueSets | 2 +- classes/MDErrorReporter | 2 +- classes/MDMailer | 2 +- classes/MD_QA | 2 +- 5 files changed, 35 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 11001fa..0b0bb39 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,37 @@ -# Validator for the standard csv format for imports to museum-digital +# Validator for the standard CSV format for imports to museum-digital -# Development +The validation and transformation service for import CSV files to an instance of museum-digital is centrally hosted at . This repository contains -To update, run `scripts/compile.php`. +a) The statically generated progressive web app that is being served +b) The simple static page generator for generating it -## Dependencies +## CSVXML as a "Format" / Purpose of This Tool + +Many smaller museums still do not use a dedicated application for managing their collections. This often leads to the need to import Excel or CSV tables. The format described and validated by the present tool helps museums and administrators who want to import data from such sources to pre-prepare their import data. If the data is not yet recorded, this tool allows the generation of a CSV file with the expected table headings. If an existing CSV file is to be imported, users can rename their table headings to the ones listed in CSVXML and then validate their import data using this application. + +Finally, this tool will return a ZIP file containing one XML file per object in the validated CSV file. The application works completely on the client side, meaning that no data is uploaded to the server as the import data is validated. This also allows for offline use. + +## To-Do + +- [ ] Add missing translation files for explanations + - Translations and explanations for most fields exist in the musdb translation files. They now only need to be entered at the relevant positions in [`CsvxmlAvailableFields.php`](./src/CsvxmlAvailableFields.php). + +## Deployment + +1. Clone this repository +2. Point a web server to serve the [`/public`](./public) subdirectory + +## Development + +To update, run [`scripts/compile.php`](./scripts/compile.php). + +All relevant development files can be found in [`/src`](./src). [`CsvxmlAvailableFields.php`](./src/CsvxmlAvailableFields.php) is the central file used for generating one large array defining the allowed table headings / fields and their relevant accompanying data (e.g. explanations). + +### Dependencies - [JSZip](https://github.com/Stuk/jszip), dual-licensed under MIT & GPLv3 - [PapaParse](https://github.com/mholt/PapaParse), licensed under the MIT license + +## License + +This project is licensed under the AGPL License. See the [LICENSE](./LICENSE) file for the full license text. diff --git a/classes/MDAllowedValueSets b/classes/MDAllowedValueSets index b55ea34..1de413b 160000 --- a/classes/MDAllowedValueSets +++ b/classes/MDAllowedValueSets @@ -1 +1 @@ -Subproject commit b55ea34950bf7c14b50cbb1024062a34b13b7853 +Subproject commit 1de413b3fb9051719a728ac4342cf205e03d52f7 diff --git a/classes/MDErrorReporter b/classes/MDErrorReporter index 6506433..ca19b3e 160000 --- a/classes/MDErrorReporter +++ b/classes/MDErrorReporter @@ -1 +1 @@ -Subproject commit 6506433dea65d34572a0ce7846a62232a7b446d3 +Subproject commit ca19b3ed2f1984c41c46cd05982e75140b79d4ba diff --git a/classes/MDMailer b/classes/MDMailer index 942de26..2ee11e3 160000 --- a/classes/MDMailer +++ b/classes/MDMailer @@ -1 +1 @@ -Subproject commit 942de26411feb446955d6198255e348ee68c0323 +Subproject commit 2ee11e3829d5546ba0a6fb812201d80e02f29c94 diff --git a/classes/MD_QA b/classes/MD_QA index 0412060..16f335b 160000 --- a/classes/MD_QA +++ b/classes/MD_QA @@ -1 +1 @@ -Subproject commit 041206040f50a421ab2d5017ecab1b4cf3c85182 +Subproject commit 16f335bab98095021da671360db5c2c2643309cd