Minor fixes (6)

Author: Serg-Norseman

locales/help_enu/gkhHistory.html

@@ -12,6 +12,7 @@ <h1>Change log</h1>
 
     <p>
         <b>??.??.2024 [v2.29.0 &amp; v3.5.0]</b><ul>
+            <li>Added the "Extended locations" option, which includes substitution of full place names depending on the date of events when using the historical ATD hierarchy.
             <li>Added a tool for batch adding photos.
             <li>Added support for multiple names and date periods in location records (GEDCOM 5.5 EL).
             <li>Added a non-standard date attribute to source records (for clarifying and sorting censuses, parish books, confession books and personal documents).

locales/help_rus/gkhHistory.html

@@ -12,6 +12,7 @@ <h1>История версий</h1>
 
     <p>
         <b>??.??.2024 [v2.29.0 &amp; v3.5.0]</b><ul>
+            <li>Добавлена опция "Расширенная обработка мест", включающая подстановку полных названий мест в зависимости от даты событий при использовании иерархии исторического АТД.
             <li>Добавлен инструмент пакетного добавления фотографий.
             <li>Добавлена поддержка множественных названий и периодов дат в записи мест (GEDCOM 5.5 EL).
             <li>Добавлен нестандартный атрибут даты в записи источников (для уточнения и сортировки переписей, метрических книг, ревизских сказок, исповедных книг и личных документов).

locales/help_rus/gkhOptions.html

@@ -517,6 +517,10 @@ <h3>Список персон</h3>
         <dt>Расширенное определение родства</dt>
         <dd>В калькуляторе родственных связей и в деревьях с включенным отображением родства, будут определяться такие связи как единокровные и единоутробные братья и сестры,
 		    усыновления/удочерения, родные и неродные родители, гражданские браки.</dd>
+
+        <dt>Расширенная обработка мест</dt>
+        <dd>Все операции по обработке и подстановке местоположений с участием записей мест будут учитывать возможное наличие исторических сведений о привязке названий мест
+		    к датам, возможное наличие иерархических связей между местами (см. <a href="gkhRec_Place.html">Записи географических мест</a>).</dd>
     </dl>
 
     <hr />

locales/help_rus/gkhRec_Place.html

@@ -48,6 +48,47 @@ <h1>Записи географических мест</h1>
         можно просмотреть список всех фактов событий персон или семей, которые ссылаются на данную.
     </p>
 
+    <hr />
+    <p align="center"><img src="images/dlgLocHistory.png"></p>
+    <p>
+		Данный диалог предназначен для ввода и управления историческими сведениями о месте: привязками названий мест и ссылок на верхние уровни
+		иерархии административно-территориального деления к периоду действия. Т.е. если определенный нас.пункт на протяжении истории несколько раз менял своё название -
+		в данном диалоге можно ввести все названия и указать в какие интервалы времени они действовали. Если некая деревня или город в разные периоды входили в разные
+		волости или районы - это можно ввести в нижней секции диалога - "Ссылки на верхние уровни".
+    </p>
+    <p>
+		Возможно использование различных подходов к ведению справочника мест:<ul>
+			<li>не использовать исторические привязки имен и иерархию;
+			<li>использовать только одноуровневую модель: в список имен вводятся длинные полные имена, от самого нижнего уровня - до верхнего (или наоборот), и их периоды;
+			<li>использовать полную многоуровневую модель: в имя вводится только непосредственная часть (название города или волости, или губернии, и т.д.), прочие части
+			распределяются по уровням, каждое конкретное место получает собственную запись, со своими названиями и ссылками на верхние уровни.
+		</ul>
+    </p>
+    <p>
+		Внимание: при включении опции "Настройки \ Особое \ Расширенная обработка мест" и подключении иерархически организованных мест к датам в диалоге редактирования событий - 
+		места начинают автоматически подстраиваться при изменении даты (определяется полное длинное название места в конкретную дату события). Также этот механизм будет работать
+		при использовании инструмента управления местами и на этапе верификации загружаемых файлов.
+    </p>
+
+    <hr />
+    <p align="center"><img src="images/dlgLocName.png"></p>
+    <p>
+		Диалог предназначен для редактирования названия места и его периода действия. Например: "Вятское наместничество", период действия названия с 11/09/1780 по 30/12/1796.
+    </p>
+
+    <hr />
+    <p align="center"><img src="images/dlgLocLink.png"></p>
+    <p>
+		Диалог предназначен для редактирования ссылки на запись места более высокого уровня и периода подчинения. Например, "Вятская провинция/наместничество" входила
+		в "Сибирская губерния" с 29/05/1719 по 28/04/1727 и в "Казанская губерния" с 29/04/1727 по 10/09/1780.
+    </p>
+
+    <hr />
+    <p>
+		Пример полного заполнения истории:
+    </p>
+    <p align="center"><img src="images/dlgLocHistSample.png"></p>
+
     <hr />
     <p>
         Также смотрите: <a href="gkhRec_Event.html">События/факты</a>, <a href="gkhRec_Note.html">Заметки</a>, <a href="gkhRec_Media.html">Мультимедиа-материалы</a>,

locales/help_rus/images/dlgLocHistSample.png

@@ -57,6 +57,7 @@ public EventEditDlgController(IEventEditDlg view) : base(view)
         {
             fTempLocation = null;
             fView.EventType.Activate();
+            fView.Date.DateChanged += new EventHandler(dateCtl_DateChanged);
         }
 
         public override void Init(IBaseWindow baseWin)
@@ -166,19 +167,19 @@ public override void UpdateView()
             fView.Agency.Text = fEvent.Agency;
 
             fTempLocation = fBase.Context.Tree.GetPtrValue<GDMLocationRecord>(fEvent.Place.Location);
-            UpdatePlace();
+            UpdatePlace(true);
 
             fView.NotesList.UpdateSheet();
             fView.MediaList.UpdateSheet();
             fView.SourcesList.UpdateSheet();
         }
 
-        private void UpdatePlace()
+        private void UpdatePlace(bool forced)
         {
             if (fTempLocation != null) {
                 fView.Place.Text = GKUtils.GetLocationNameExt(fTempLocation, fView.Date.Date);
                 SetLocationMode(true);
-            } else {
+            } else if (forced) {
                 fView.Place.Text = fEvent.Place.StringValue;
                 SetLocationMode(false);
             }
@@ -202,13 +203,13 @@ private void SetLocationMode(bool active)
         public async void AddPlace()
         {
             fTempLocation = await fBase.Context.SelectRecord(fView, GDMRecordType.rtLocation, new object[] { fView.Place.Text }) as GDMLocationRecord;
-            UpdatePlace();
+            UpdatePlace(true);
         }
 
         public void RemovePlace()
         {
             fTempLocation = null;
-            UpdatePlace();
+            UpdatePlace(true);
         }
 
         public async void ModifyAddress()
@@ -282,9 +283,9 @@ public void SendData(string signature, string data)
             }
         }
 
-        public void OnDateChanged()
+        private void dateCtl_DateChanged(object sender, System.EventArgs e)
         {
-            UpdatePlace();
+            UpdatePlace(false);
         }
 
         public override void SetLocale()

locales/help_rus/images/dlgLocHistory.png

@@ -736,7 +736,8 @@ public static string GetEventDesc(GDMTree tree, GDMCustomEvent evt, bool hyperLi
             if (evt == null)
                 throw new ArgumentNullException("evt");
 
-            string dt = GEDCOMEventToDateStr(evt, GlobalOptions.Instance.DefDateFormat, false);
+            var globOpts = GlobalOptions.Instance;
+            string dt = GEDCOMEventToDateStr(evt, globOpts.DefDateFormat, globOpts.ShowDatesSign);
 
             string place = string.Empty;
             if (evt.HasPlace) {