ДЖАГАННАТХА ХОРА 8 УКРАЇНСЬКОЮ — 8.2.2026
========================================
GANAPATI VIDYA: Школа ведичної астрології

Український переклад застосунку Jagannatha Hora 8.0. 
Перекладено інтерфейс, довідку та назви українських міст в атласі.
8.2.2026 — пошук міста й часовий пояс через довідники Google
(див. розділ нижче); решта — як у попередньому випуску.

Сам застосунок безкоштовний, усі права на нього належать авторові.
Українська версія застосунку 8.2.2026 належить школі GANAPATI VIDYA.
Весь «source code» української локалізація та всіх правок, включаючи правки 
розрахунку належать власнику сторінки https://www.facebook.com/JagannathaHoraUA.


ЩО В АРХІВІ
-----------
Зірочкою * позначено те, що ЗМІНЕНО або ОНОВЛЕНО порівняно з оригінальною
збіркою «Джаганнатха Хора 2017». Решта — оригінальні файли як є.

  bin\jhora-uk.exe        *  українська збірка (на основі JHora 8.0.0.0)
                             складено 2026-08-15, версія 8.2.2026
  bin\jhora-uk.chm        *  довідка українською, виклик F1 (2026-08-03)
  bin\jhora.exe              оригінальний англійський, версія 8.0.0.0,
                             файл датовано 2015-12-31 — лежить поруч, щоб
                             можна було звірити розрахунки
  bin\swedll32.dll        *  Swiss Ephemeris 2.10.03
                             (у «Джаганнатха Хора 2017» — 2.02.01, 2016 рік)
  jhcore\ephe\            *  ефемериди Astrodienst від 2026-05-26,
                             на основі JPL DE441
                             (у «Джаганнатха Хора 2017» — 2014 рік, DE431)
  jhcore\atlas\jhworld.adb *  атлас світу, українські міста — сучасними
                             назвами (Kyiv, Lviv, Dnipro, Kharkiv тощо)
  jhcore\atlas\jhlite.adb    короткий атлас, без змін
  jhcore\jhora.ini        *  налаштування під українського користувача,
                             рекомендовані школою GANAPATI VIDYA
                             (див. налаштування.txt)
  data\                      приклади карт з оригінальної збірки, БЕЗ ЗМІН —
                             рівно ті самі файли, що в англійській версії
  test-data\                 карти для звірки розрахунків: те саме місце
                             й час, різні роки від 0 до 2100 (див.
                             відмінність.txt)
  налаштування.txt        *  чим налаштування відрізняються від типових
  відмінність.txt         *  звірка розрахунків: Джаганнатха Хора 2017,
                             ця збірка і незалежний еталон Swiss Ephemeris

Це повний комплект — окремо встановлювати Jagannatha Hora не потрібно.

Головне, на що варто звернути увагу: оновлено не лише переклад, а й астрономічну 
частину — бібліотеку Swiss Ephemeris та ефемериди - про ценаступний розділ.
Крім перекладу, є важлива правка розрахунку — про неї в останньому розділі.


ЯК ВСТАНОВИТИ
-------------
  1. Зніміть з архіву блокування (див. наступний розділ) — це найважливіший крок.
  2. Розпакуйте архів у будь-яку теку, зберігаючи структуру.
  3. Запускайте bin\jhora-uk.exe.

Англійська версія лежить поруч (bin\jhora.exe) і запускається з тієї самої
теки — зручно, коли треба щось звірити. Майте на увазі: файл налаштувань
jhcore\jhora.ini у них СПІЛЬНИЙ, тож зміни в одній версії побачить і друга.

І ще: англійська версія працює з тими самими оновленими ефемеридами, що й
українська, — тобто її числа теж відрізнятимуться від того, що дає
оригінальна інсталяція «Джаганнатха Хора 2017» зі старою бібліотекою.


ЗНЯТИ БЛОКУВАННЯ — ОБОВ'ЯЗКОВО
------------------------------
Усе завантажене з інтернету Windows позначає як «з іншого комп'ютера» (механізм
Zone.Identifier, він же Mark of the Web). Для довідки .chm це не косметична
дрібниця: заблокований файл відкривається порожнім або з написом «Перехід до
вебсторінки скасовано» замість тексту.

Найпростіше — розблокувати АРХІВ до розпакування, тоді всі видобуті файли
будуть чисті:

  права кнопка на jhora8uk.zip -> Властивості -> унизу прапорець
  «Розблокувати» -> Застосувати

Якщо вже розпакували, зробіть те саме для bin\jhora-uk.chm і bin\jhora-uk.exe.

Те саме з PowerShell:

  Unblock-File jhora8uk.zip

або для вже розпакованого, з теки застосунку:

  Get-ChildItem -Recurse | Unblock-File


ЯКЩО SMARTSCREEN НЕ ДАЄ ЗАПУСТИТИ
---------------------------------
З'явиться вікно «ОС Windows захистила цей ПК» і напис «Невідомий видавець».
Натисніть «Докладніше», далі «Виконати».

Це не виявлення вірусу, а перевірка репутації: застосунок не має цифрового підпису
і завантажена поки що малою кількістю людей. Оригінальний англійський jhora.exe
теж не підписаний і поводиться так само. Щоб попередження зникло назавжди,
потрібен платний сертифікат для підпису коду — його поки немає.

Натомість можна переконатися, що файл не підмінено, — див. наступний розділ.


ПЕРЕВІРКА КОНТРОЛЬНИХ СУМ
-------------------------
Поруч із посиланням на завантаження опубліковано SHA256SUMS.txt. Порахуйте суму
свого файлу й порівняйте:

  PowerShell:       Get-FileHash jhora8uk.zip -Algorithm SHA256
  Командний рядок:  certutil -hashfile jhora8uk.zip SHA256

У SHA256SUMS.txt є суми й для самих jhora-uk.exe та jhora-uk.chm.

Збіглося — файл саме той, що опубліковано.


ДОВІДКА (F1)
------------
Довідка викликається клавішею F1 і відкривається на сторінці, яка відповідає
поточному вікну. Файл jhora-uk.chm має лежати поруч із jhora-uk.exe — застосунок
шукає його саме там. Порожнє вікно довідки майже завжди означає, що не знято
блокування (див. вище).


ЩО ПЕРЕКЛАДЕНО
--------------
  - інтерфейс: меню, діалоги, підписи, повідомлення самого застосунку;
  - довідка: підручник і довідник, із посторінковим викликом F1;
  - атлас: сучасні назви українських міст (Kyiv, Lviv, Dnipro, Kharkiv тощо);
  - іконка — брендована, щоб відрізняти від англійської версії.

Помилки й побажання щодо формулювань вітаються — переклад живий і далі шліфується.


МЕНЮ «ВЕБСАЙТИ»
---------------
Кілька пунктів цього меню вели на групи Yahoo, а їх закрито ще 2020 року.
Замінено на чинні адреси:

  Обговорення «Jagannatha Hora UA»: офіційна група
        відкриває Телеграм-групу, де можна запитати про саму збірку,
        повідомити про хибу в перекладі чи обговорити розрахунки.

  GANAPATI VIDYA: Школа ведичної астрології
        відкриває ganapatividya.com — школу, яка веде цей переклад і
        рекомендує налаштування з jhcore\jhora.ini.

  VedicHoro: Найзручніший веб-сайт з ведичної астрології
        відкриває vedic-horo.com і одразу передає туди дані карти,
        відкритої в застосунку, — дату, час, координати, часовий пояс і
        назву документа. Тобто ту саму карту можна відразу подивитися на
        сайті, нічого не набираючи руками.

  VedicTime: Джйотіш разом з інноваційними веб-технологіями відкриває vedictime.com.

  AstroExpert: Поточні транзити та панчанга на сьогодні
        відкриває astro.expert — поточні транзити й панчанґу на
        сьогоднішній день.

Дві кнопки на панелі інструментів теж перенаправлено: «Сторінка автора української версії у Facebook»,
а колишня кнопка Twitter — «Обговорення «Jagannatha Hora UA»: офіційна група» 
— у ту саму Телеграм-групу, що й однойменний пункт меню.

Решта пунктів меню лишилася така, як в оригіналі.


ПОШУК МІСТА Й ЧАСОВИЙ ПОЯС ІЗ ЖИВОГО ДОВІДНИКА
----------------------------------------------
Вбудований атлас має дві вади. По-перше, він латинський: «Київ» у ньому не
знайдеться ніколи, треба вгадувати написання Kyiv чи Kiev. По-друге, він
зберігає для міста один звичайний часовий пояс і один літній, а цього для
давніх дат замало: Київ до 1924 року жив за місцевим сонячним часом
(+2:02 від Гринвіча), потім за московським, і межі переходів мінялися
десятки разів.

Тому кнопка «Решта світу» в діалозі «Введіть дані народження» тепер, окрім
пошуку в атласі, звертається до довідників Google: знаходить місто за
назвою будь-якою мовою, бере координати з точністю до секунди дуги, висоту
над рівнем моря й питає, який часовий пояс діяв у цьому місці саме на
введену дату й годину.

У списку результатів з'являється додатковий перший рядок — його видно
одразу, бо він закінчується позначкою в квадратних дужках:

  Київ, Україна   (30 E 31,  50 N 27) [Google]      ← Google
  Kyiv , Україна   (30 E 31,  50 N 26)              ← як в атласі

Позначки дві. «[Google]» означає, що від Google узято і координати, і пояс.
«[Google TZ]» — що назву довелося взяти з атласа (наприклад, служба пошуку
недоступна), а від Google лише часовий пояс. Усі знахідки атласа лишаються
під новим рядком, вибір за вами.

Приклад різниці. Для Києва 2 квітня 1984 року Google дає 4:00, атлас —
3:00; для 4 квітня 1900 року Google дає 2:02, атлас — 3:00. Для
сьогоднішніх дат обидва збігаються.

Позначку «Стандартний час» під полями поясу в рядку Google слід читати як
«остаточний зсув»: довідник уже врахував, діяв того дня літній час чи ні,
тож окремо його додавати не треба.

Якщо мережі немає, ключа не вписано або служба не відповідає, застосунок
мовчки працює так само, як раніше, — самим атласом. Ніяких повідомлень про
помилку не буде, просто в списку не з'явиться додатковий рядок.

Що йде в запиті: назва міста, координати й дата з діалогу. Нічого іншого
застосунок нікуди не надсилає.

ЩО ТРЕБА ЗРОБИТИ, ЩОБ ЦЕ ЗАПРАЦЮВАЛО

У поставці ця можливість вимкнена: потрібен особистий ключ доступу до
служб Google, і кожен заводить власний. Ключ безкоштовний; Google
просить прив'язати картку, але безкоштовної місячної норми вистачає на
тисячі запитів, а один пошук міста — це два запити.

Коротко: у консолі https://console.cloud.google.com створити проєкт,
увімкнути оплату, увімкнути служби — Geocoding API і Time Zone API
(обов'язкові) та Elevation API (для висоти, за бажанням), — створити ключ
API й вписати його у файл jhcore\jhora-uk.ini:

  [Google]
  ApiKey=AIzaSy…

Докладна покрокова інструкція — з тим, що натискати, які бувають
помилки й що вони означають, — лежить у двох місцях: у самому файлі
jhcore\jhora-uk.ini (там її видно там, де вписують ключ) і в
налаштування.txt.

Поки рядок ApiKey порожній, застосунок нікуди не звертається й працює
самим атласом, як авторська версія.


ЗАСТАВКА НА СТАРТІ
------------------
Оригінальний застосунок на старті показує картинку й тримає її на екрані
близько півтори секунди. Головне вікно при цьому готове вже за секунду,
тобто заставка нічого не пришвидшує — просто затуляє собою вже
працездатну програму. У цій збірці її вимкнено: вікно з'являється
одразу. На швидкість запуску це не впливає.


ПРО SWISS EPHEMERIS І ЧОМУ ЦЕ ВАЖЛИВО
-------------------------------------
Jagannatha Hora не рахує положення планет сама. Вона звертається до Swiss
Ephemeris — бібліотеки астрономічних розрахунків швейцарської компанії
Astrodienst, побудованої на ефемеридах NASA/JPL. Це галузевий стандарт: нею
користується більшість серйозних астрологічних застосунків. Тобто числа на
екрані JHora — це числа Swiss Ephemeris, а застосунок їх лише запитує й
оформлює в карти та таблиці.

Тому саме Swiss Ephemeris варто вважати еталоном: якщо розрахунок застосунку
розходиться з нею, розходження майже напевно на боці застосунку.

Бібліотека складається з двох частин, і оновлювати треба обидві:
  * swedll32.dll — код;
  * файли в jhcore\ephe — таблиці положень, які цей код читає.

Оригінальна збірка Jagannatha Hora 8.0 (далі — «Джаганнатха Хора 2017»)
несе Swiss Ephemeris 2.02.01 з ефемеридами 2014 року на основі JPL DE431.
Це майже десять років давності.

У цій збірці — поточна Swiss Ephemeris 2.10.03 і ефемериди від 26 травня
2026 року на основі JPL DE441.

Що це змінює на практиці: положення планет зсуваються на соті частки
секунди дуги (непомітно), істинні вузли — на 0.13", а от час сходу сонця —
приблизно на секунду. Через схід зсуваються Манді, Ґуліка та часові лаґни
(Бгава, Хора, Ґхаті, Вігхаті, Пранапада) — Вігхаті лаґна аж на п'ять із
половиною мінут дуги, бо проходить знак за шість хвилин.

Наскільки точна ця збірка. Усі 17 тестових карт (роки 0…2100) звірено з
еталонним розрахунком swetest зі складу Swiss Ephemeris:

  планети, вузли, аянамша, лаґна        не гірше за 0.02"
  тітхі, накшатра, йога, карана         збіг до сотої частки відсотка
  Ґуліка, Манді й решта упаґрах         не гірше за 0.9"
  часові лаґни                          не гірше за 14" (це найшвидша
                                        з них, Вігхаті)
  схід і захід сонця                    у межах округлення до секунди

Усі числа з трьох версій, поруч і з поясненнями, — у відмінність.txt.


ЛАҐНА: ОДНА ПРАВКА РОЗРАХУНКУ
-----------------------------
У цій збірці виправлено одну ваду оригінального застосунку, тому лаґна (асцендент)
і куспіди бгав тут відрізняються від англійської версії — на величину до 18
кутових секунд, залежно від дати. Положення планет не змінилися.

У чому річ. Планети Jagannatha Hora бере з бібліотеки Swiss Ephemeris одразу
сидеричними: аянамшу віднімає сама бібліотека, і робить це з урахуванням
нутації (невеликого коливання земної осі). А лаґну застосунок отримує тропічною
й віднімає аянамшу самотужки — ту, яка нутації не містить. Через це лаґна
опинялася в трохи іншій системі відліку, ніж планети того самого гороскопа.

Приклад (18.04.1976, 20:35 UT, 27 E 13', 49 N 45'):

  оригінальна Jagannatha Hora    13 Sc 37' 25.18"
  ця збірка                      13 Sc 37' 14.01"
  Swiss Ephemeris напряму        13 Sc 37' 14.01"

Друге значення дає й vedic-horo, коли в ньому вибрано «Истинное» положення планет.

Правку вимкнено там, де вона не потрібна: у тропічному режимі (без аянамші) та
коли вибрано власну аянамшу Jagannatha Hora — у цих випадках лаґна й планети
рахуються однаково й розбіжності немає.

Аянамша, яку застосунок показує на екрані, лишилася такою, як в оригіналі.
