Add README, prepare more elaborate URI rendering

Author: anneb

README.md

@@ -0,0 +1,34 @@
+# CSW Client
+A client to browse Geographic ***C***atalog ***S***ervices for the ***W***eb (CSW) which enables users to discover, browse, and query geospatial records in catalogues across the web.
+
+## Prerequisites
+* git
+* Node.js (version 20 is recommended; other versions have not been tested)
+
+
+## Install
+```bash
+git clone this_repository
+cd this_repository
+npm install
+```
+
+## Start
+Set up your OPENAI_API_KEY if you plan to use the translation feature requiring external API calls:
+```bash
+# Windows:
+set OPENAI_API_KEY=your_openai_api_key
+# Linux:
+export OPENAI_API_KEY=your_openai_api_key
+
+# start the service
+node app.js
+
+# point you browser to http://localhost:3000 to interact with the CSW Client
+```
+
+## Project structure
+
+This CSW Client is built on the [Express.js](https://expressjs.com) Web Application framework. Main entry point is module ```app.js```. This module sets up the http service routes (or 'handlers') to proxy CSW requests to CSW servers. The route results are returned as JSON. The ```app.js``` module also exposes directory ```public``` that hosts a csw client web application (```index.html``` + ```csw-app.js```) to be used in a browser (http://localhost:3000). The browser app displays a selection of predefined CSW servers to search. This list is defined in file ```endpoints.js```.
+
+The actual requests and responses to the CSW servers are handled in module ```cswrequests.js```. Note that if you want to execute this request/response Javascript code directly in a browser (bypassing the Express.js proxy), the CSW server must allow CORS requests for this to work. The administrator of the CSW service may or may not have enabled CORS. Enabled CORS on the CSW server is not required for use in this project.

endpoints.js

@@ -4,7 +4,7 @@ export const cswEndPoints = [
   {name: "linz", url: "https://data.linz.govt.nz/services/csw?service=CSW&version=2.0.2&request=GetRecords", language: "English"},
   {name: "geo-solutions", url: "https://gs-stable.geo-solutions.it/geoserver/csw", language: "Italian"},
   {name: "geoplatforme.fr", url: "https://data.geopf.fr/csw/", language: "French"},
-  {name: "Bundesamt für Kartographie und Geodäsie (BKG)", url: "https://mis.bkg.bund.de/csw", language: "German"},
+  {name: "B.amt für Kartogr und Geod. (BKG)", url: "https://mis.bkg.bund.de/csw", language: "German"},
   {name: "GDI-DE", url: "https://gdk.gdi-de.org/geonetwork/srv/ger/csw", language: "German"},
   {name: "ign-fr", url: "https://wxs.ign.fr/catalogue/csw-inspire/", language: "French"},
   {name: "ign-es", url: "http://www.ign.es/csw-inspire/srv/spa/csw", language: "Spanish"},

public/csw-app.js

@@ -225,6 +225,9 @@ class CSWApp extends LitElement {
       }
     }
   }
+  renderUri(uri) {
+    return html`${uri.protocol} <a href="${uri.url}" target="cswlink">${uri.name?uri.name:'No name'} ${uri.description}</a>`;
+  }
   renderFullRecord(record) {
     if (!record) return html`<p>No record selected</p>`;
     const subject = record.subject ? Array.isArray(record.subject) ? record.subject.join(', ') : record.subject : '';
@@ -249,7 +252,7 @@ class CSWApp extends LitElement {
       <tr><td>Relation:</td><td> ${record.relation? html`<span @click="${(_e)=>this.updateFullRecord(record.relation)}">Link</span>`:'none'}</td></tr>
       <tr><td>Links: </td><td></td></tr>
       ${record.URI ?
-         record.URI.map(uri => html`<tr><td></td><td>${uri.protocol} <a href="${uri.url}" target="cswlink">${uri.name?uri.name:'No name'} ${uri.description}</a></td></tr>`)
+         record.URI.map(uri => html`<tr><td></td><td>${this.renderUri(uri)}</td></tr>`)
          :
           html`<tr><td></td><td>no URI/URLs defined</td></tr>`
       }