writing down some things

README.markdown

@@ -2,24 +2,70 @@
 # ccc maps
 
 the [svg map] used on [ccc de] is at least potentially outdated
-and thus should be updated automically
+and thus in future should be updated automically
 
 [svg map]: https://chaos.expert/telegnom/erfakarte 
 [ccc de]: https://www.ccc.de/regional
 
-## process
 
-1. fetch addressed of a convenient source
-2. resolve geo coordinates for addresses, e. g. `geopy`[0]
-3. visualize on a map, e. g. `leaflet.js`[1]
+## my target process
+
+* [x] fetch addressed of a convenient source
+* [x] resolve geo coordinates for addresses, e. g. [geopy]
+* [x] visualize on a map, e. g. via [leaflet] or [QGIS]
+* [ ] calculate coordinates to place POI on a SVG with a known projection
+* [ ] manipulate SVG so that the POI are shown accordingly
+* [x] create PNG from the SVG and deploy
+* [ ] document for others to use
+
 
 ## data
 
+### POI
+r
 the address data source is the semantic [documentation wiki], queried with [result format]
 
 [documentation wiki]: https://doku.ccc.de/Liste_der_Erfa-Kreise_und_Chaostreffs
 [result format]: https://www.semantic-mediawiki.org/wiki/Help:CSV_format
 
+To create GeoJSON from recent address data:
 
-[0]: https://geopy.readthedocs.io/
-[1]: https://leafletjs.com/
+1. `prepare.sh` pulls CSV from the Wiki
+2. `create-geojson.sh` calls `lookup.py` for each CSV set 
+3. The resulting [data](https://gitea.c3d2.de/vv01f/ccc-map/src/branch/data) in [GeoJSON] format can be used with e.g. [leafletjs] or [QGIS] 
+
+
+### Map
+
+The old SVG was nice for Germany only.
+Over time more European spaces joined and the map could not display them.
+
+Another point is that the projection parameters of the SVG are not known.
+New material can be produced choosing the projection.
+One recommended program to do this is [QGIS].
+Freely useable data is available on e. g. [Natural Earth].
+
+To create a new SVG Map:
+
+1. Start QGIS, KBS setting recommendation: EPSG:3857 / Pseudo Mercator
+2. Drop a Shape-File, e. g. sqlite format (and optionally a GeoJSON-File)
+3. Adjust colors in the layers styles
+4. Print as SVG (Label for POI data is lost in version 2.18)
+
+[QGIS]: https://qgis.org/ "QGIS"
+[Natural Earth]: http://naturalearthdata.com/ "Natural Earth"
+
+[geopy]: https://geopy.readthedocs.io/
+[leaflet]: https://leafletjs.com/
+[GeoJSON]: https://geojson.org/ "Website for RFC 7946"
+
+<!--
+
+## Thanks fo to …
+
+* [telegnom](https://chaos.expert/telegnom/erfakarte) for patiently describing the problems and needs for the map
+* [ax3l](https://github.com/ax3l) for his spontanious talk at [Datenspuren] getting me started
+* The [Dresden OSM Meeting](https://wiki.openstreetmap.org/wiki/DresdnerOSMStammtisch) for hinting me on QGIS and an introduction how to use it
+* and quite some people helping me to finally polish some python
+
+-->