Create README.md for frontlines

frontlines/README.md

@@ -0,0 +1,55 @@
+# Файлы описания расположения войск и линий фронта
+Данная папка содержит файлы описания расположения войск, линий фронта и прочих полигонов/линий,
+которые должны отображаться на карте.
+
+Все файлы, расположенные здесь, автоматически упаковываются в _webpack_ бандл и отрисовываются на карте,
+если условия для их изображения удовлетворены (например, даты действия полигона удовлетворяют динамически
+выбранному фильтру дат).
+
+Форматом файлов является [GeoJSON](https://geojson.org/).
+Поддерживаются все доступные GeoJSON типы [геометрий](https://datatracker.ietf.org/doc/html/rfc7946#section-3.1).
+
+Пример линии в GeoJSON:
+```
+{
+  "type": "FeatureCollection",
+  "features": [
+    {
+      "type": "Feature",
+      "properties": {
+        "description": "Электрический кабель проложенный по дну. Кабель Жизни.",
+        "actionHeader": "Кабель действовал"
+        "dateStart": "1942-09-23",
+        "dateEnd": "1943-12-31",
+        "color": "#800080"
+      },
+      "geometry": {
+        "type": "LineString",
+        "coordinates": [
+          [31.08496, 60.11055],
+          [31.52218, 60.06583]
+        ]
+      }
+    }
+  ]
+}
+```
+
+## Поддерживаемые свойства (properties)
+Поддерживаются все свойства доступные для класса [Path](https://leafletjs.com/reference.html#path) библиотеки [leaflet](https://leafletjs.com/).
+Больше деталей по синтаксису описания свойств класса _Path_ доступны по [ссылке](https://leafletjs.com/reference.html#path) -
+некоторые из свойств ссылаются на более детальное описание атрибутов [SVG](https://developer.mozilla.org/en-US/docs/Web/SVG).
+
+Дополнительно поддерживаются следующие свойства:
+* **description**: строка описания, отображающаяся в заглавии _popup_ при клике на полигон/линию.
+* **dateStart**, **dateEnd**: строки в формате "ГГГГ-ММ-ДД" описывающие время "действия" полигона/линии.
+* **actionHeader**: заголовок фразы отображающейся в _popup_, описывающей время "действия" полигона/линии.
+  Если это свойство не указано, то будет использован заголовок "Линия фронта действовала".
+
+**Для примера выше будет отображено следующее:**
+> <b>Электрический кабель проложенный по дну. Кабель Жизни.</b>
+> 
+> Кабель действовал с:</br>
+> 1942-09-23</br>
+> по:</br>
+> 1943-12-31</br>