new CONTRIBUTE documentation

diff --git a/CHANGES.md b/CHANGES.md
new file mode 100644 (file)
index 0000000..11154aa
--- /dev/null
+++ b/CHANGES.md
@@ -0,0 +1,8 @@
+# CHANGES
+
+* version 1.1 - 2020-06-19
+
+    * Configuration now optional with example file.
+    * New CONTRIBUTE.md documentation.
+
+* version 1.0 - November 2019 during a hackweekend at Linuxhotel

diff --git a/CONTRIBUTE.md b/CONTRIBUTE.md
new file mode 100644 (file)
index 0000000..de818e8
--- /dev/null
+++ b/CONTRIBUTE.md
@@ -0,0 +1,53 @@
+# Developing Nominatim-UI
+
+## Background
+
+The user interface used to be included in the geocoder. Thus the
+first version avoid being a redesign and still uses some of the
+same configuration values. For simplicity it's not a single
+page application (SPA) written in a framework though it could
+be in the future if complexity grows.
+
+Uses [jQuery](https://jquery.com/) for browser DOM interaction,
+[handlebar](http://handlebarsjs.com/) templates to build pages,
+[leaflet](https://leafletjs.com/) for map interaction,
+[bootstrap](https://getbootstrap.com/) for layout styling.
+
+
+## Building the frontend
+
+* Install dependencies
+
+   ```
+   yarn install
+   ```
+
+* After you change files in `src` directory run
+
+   ```
+   yarn build
+   ```
+
+* Start a webserver on port 8000 to preview changes
+
+   ```
+   yarn start
+   ```
+
+* Run code style check
+
+   ```
+   yarn lint
+   ```
+
+## Prepare a release
+
+1. Update version number in `package.json` file
+
+2. Update `CHANGES.md` file
+
+3. Commit your changes: `git add... `, `git commit ...`, `git push ...` etc
+
+4. Tag release: `git tag THE_VERSION_NUMBER`, `git push --tags`
+
+5. Upload release
\ No newline at end of file

diff --git a/README.md b/README.md
index 2acb5ba8d10cbfac38556e5bd52964722a538551..bd1748b51693dc5aa05b78a485e13c2b7e09fbbb 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,56 +1,45 @@
 # Nominatim-UI
 
 Debugging user interface for [Nominatim](https://nominatim.org/)
 # Nominatim-UI
 
 Debugging user interface for [Nominatim](https://nominatim.org/)

-([source](https://github.com/openstreetmap/Nominatim/)) geocoder.
+([source](https://github.com/osm-search/Nominatim/)) geocoder.

 The frontend runs standalone as website and will requests data
 from a separate Nominatim API (either on the same server or
 remote).
 
 The frontend runs standalone as website and will requests data
 from a separate Nominatim API (either on the same server or
 remote).
 

-Uses [jQuery](https://jquery.com/) for browser DOM interaction,
-[handlebar](http://handlebarsjs.com/) templates to build pages,
-[leaflet](https://leafletjs.com/) for map interaction,
-[bootstrap](https://getbootstrap.com/) for layout styling.
-
-
-## Background
-
-The user interface used to be included in the geocoder. Thus the
-first version avoid being a redesign and still uses some of the
-same configuration values. For simplicity it's not a single
-page application (SPA) written in a framework though it could
-be if complexity grows.
+For technical details see [CONTRIBUTING.md]() file.

 
 

+![Screenshot](screenshot.png)

 
 ## Starting the frontend
 
 
 ## Starting the frontend
 

-You can open the `dist` directory in your browser.
+* You can open the `dist` directory in your browser.

 
 

-You can run `yarn start` to start a simple HTTP webserver and open
-[http://localhost:8000/]() in your browser.
+* If you have python installed (part of the Nominatim server installation):

 
 

-Or start another webserver ([Big list of http static server one-liners](https://gist.github.com/willurd/5720255)).
+   1. `cd dist`
+   2. start webserver `python3 -m http.server 8765` 
+   3. open [http://localhost:8765/]() in your browser

 
 

+* Start a webserver using ([Big list of http static server one-liners](https://gist.github.com/willurd/5720255)) or configure Apache, nginx or other webservers to serve the `dist` directory.

 
 

-## Configuration

 
 

-In `dist/config.js` you will find configuration options. The first
-you want to doublecheck is the `Nominatim_API_Endpoint` URL.
-
-
-## Building the frontend
+## Configuration

 
 

-* Install dependencies
+Create a `dist/config.js` file, you can use `dist/config.example.js` as basis (just copy it). All settings are optional. Usually you want to set the `Nominatim_API_Endpoint` value at least.

 
 

-   ```
-   yarn install
-   ```
+Defaults:

 
 

-* After you change files in `src` directory
+| setting | default |
+|---|---|
+| `Nominatim_API_Endpoint` | http://localhost/nominatim/ (port 80) |
+| `Images_Base_Url` | images in [mapicons]() |
+| `Search_AreaPolygons` | yes, print boundaries of search results on map |
+| `Reverse_Default_Search_Zoom` | 18 (house-number level) |
+| `Map_Default_Lat`, `Map_Default_Lon`, `Map_Default_Zoom` | display whole world |
+| `Map_Tile_URL` | load from openstreetmap.org |
+| `Map_Tile_Attribution` | [OpenStreetMap](https://openstreetmap.org/copyright) obviously |

 
 

-   ```
-   yarn build
-   ```

 
 ## License
 
 
 ## License
 

-The source code is available under a GPLv2 license.
+The source code is available under a [GPLv2 license](LICENSE).

diff --git a/package.json b/package.json
index b3ef07a5ab4d92731031488bdf8da89c95ad2e86..f1f04f789d06d6253b6a6bf67e42a674a1020ec9 100644 (file)
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "nominatim-ui",
 {
   "name": "nominatim-ui",

-  "version": "1.0.0",
-  "description": "",
+  "version": "1.1.0",
+  "description": "Debug web interface for Nominatim geocoder",

   "main": "index.js",
   "scripts": {
     "start": "./node_modules/.bin/static -c 0 -p 8000 dist",
   "main": "index.js",
   "scripts": {
     "start": "./node_modules/.bin/static -c 0 -p 8000 dist",


@@ -10,7 +10,7 @@
     "lint": "node node_modules/.bin/eslint --quiet src/handlebar_helpers.js dist/assets/js/nominatim-ui.js"
   },
   "author": "",
     "lint": "node node_modules/.bin/eslint --quiet src/handlebar_helpers.js dist/assets/js/nominatim-ui.js"
   },
   "author": "",

-  "license": "GPL-3.0",
+  "license": "GPL-2.0",

   "devDependencies": {
     "@ungap/url-search-params": "^0.2.0",
     "bootstrap": "^4.5.0",
   "devDependencies": {
     "@ungap/url-search-params": "^0.2.0",
     "bootstrap": "^4.5.0",

diff --git a/screenshot.png b/screenshot.png
new file mode 100644 (file)
index 0000000..48a356a
Binary files /dev/null and b/screenshot.png differ