НАЛАШТУВАННЯ ЦІЄЇ ЗБІРКИ
========================================
GANAPATI VIDYA: Школа ведичної астрології

В архіві є готовий jhcore\jhora.ini з налаштуваннями, підібраними під
українського користувача. Нижче описано, чим вони відрізняються від того,
що Jagannatha Hora ставить сама на чистій інсталяції.

Усе перелічене — справа смаку й школи, а не «правильності». Кожен пункт
можна змінити з меню «Налаштування», і файл jhora.ini застосунок перепише сам.


МІСЦЕ ЗА ЗАМОВЧУВАННЯМ — КИЇВ
-----------------------------
  було:   South Grafton, Массачусетс, США
          71 W 41', 42 N 12', висота 425 м, пояс -5 год (літній -4)
  стало:  Kyiv, Ukraine
          30 E 31', 50 N 26', висота 179 м, пояс +2 год (літній +3)

Це те місце, яке застосунок підставляє в діалог народження для нової карти,
доки ви не введете інше. На вже збережені карти воно не впливає.


ЧАРА-КАРАКИ — СІМ, А НЕ ВІСІМ
-----------------------------
У схемі восьми чара-карак враховано Раху й додано Пітрі караку; так учили
Парашара і Джайміні. У схемі семи Раху виключено, Пітрі караки немає; так
учив Шрі К. Н. Рао.

Тут обрано схему семи карак. Перемкнути: Налаштування -> Визначення Чара-карак.


ВУЗЛИ — ІСТИННІ, А НЕ СЕРЕДНІ
-----------------------------
Середні вузли рухаються рівномірно, істинні — з коливаннями. Тут обрано
істинні. Різниця в довготі Раху й Кету доходить до півтора градуса, тож
це помітно і в карті, і в дашах.

Перемкнути: Налаштування -> Середні чи істинні вузли.


ОПЦІЇ ОБЧИСЛЕННЯ ПЛАНЕТ
-----------------------
Це найважливіший діалог для точності: Налаштування -> Опції обчислення
планет. Тут сім пунктів, і нижче — що в кожному стоїть у цій збірці.
Позначку «типово» має те, що так само стоїть і в оригінальному застосунку.

  1. Позиції: ГЕОЦЕНТРИЧНІ                             (типово)
     Геоцентричні рахуються від центру Землі, топоцентричні — від
     фактичного місця події. Різниця помітна лише для Місяця (до 1°) і
     майже нульова для далеких планет. Класичний джйотіш геоцентричний.

  2. Положення планет: ІСТИННІ                         (типово)
     Істинна позиція — де планета справді є в цю мить. Видима — де вона
     ВИДАЄТЬСЯ, з поправкою на час, за який світло долетіло до Землі.
     Різниця для Сонця близько 20 секунд дуги. Джйотіш працює з істинними.

  3. Вузли: ІСТИННІ                                    (змінено, типово — середні)
     Середні вузли рухаються рівномірно назад, істинні — з коливаннями
     навколо середніх. Розбіжність доходить до півтора градуса, тож це
     помітно і в карті, і в дашах. Тут обрано істинні.

  4. Нутація: УВІМКНЕНО                                (типово)
     Нутація — невелике коливання земної осі. На сидеричні довготи вона
     майже не впливає (входить і в довготу, і в аянамшу, тож скорочується),
     але важлива для тропічного режиму.

  5. Річна аберація світла: УВІМКНЕНО                  (типово)
  6. Гравітаційне відхилення: УВІМКНЕНО                (типово)
  7. Рефракція у «видимих позиціях»: УВІМКНЕНО         (типово)

     Пункти 4-7 стосуються лише «видимих позицій». Оскільки в пункті 2
     обрано ІСТИННІ, на довготи планет вони не впливають — залишені як є.

Разом це означає: **геоцентричні істинні положення з істинними вузлами**.
Саме з такими налаштуваннями робилася звірка з еталоном Swiss Ephemeris (див. відмінність.txt): 
у термінах бібліотеки це прапорці SEFLG_SIDEREAL | SEFLG_TRUEPOS і SE_TRUE_NODE.

Окремо варто знати: якщо в аянамші обрано ШСС (Шрі Сур'я Сіддханта), увесь
цей діалог ні на що не впливає — там своя арифметика, не через Swiss Ephemeris.
Тут обрано True Chitrapaksha, тож усе перелічене працює.


СТИЛЬ КАРТИ — ПІВНІЧНО-ІНДІЙСЬКИЙ
---------------------------------
Типово застосунок малює південно-індійський стиль (квадрат зі сталими знаками). 
Тут обрано північно-індійський — ромбічний, де сталі будинки, а знаки рухаються.

Перемкнути: Налаштування -> Мова і стиль карти.


ДРІБНІШЕ
--------
  - шрифт у картах на крок менший за типовий (щоб уміщалося більше);
  - Манді не показується в самих картах (у списку довгот лишається);
  - «більше карт на великому екрані» вимкнено;
  - точка відліку для Бхава/Чаліт Чакри — ЛАҐНА (типово Місяць).


ДРУК
----
Налаштування -> Сторінки для включення в друк.

  - друк КОЛЬОРОВИЙ. Типово застосунок друкує лише чорно-білим (у діалозі
    це позначка «У мене немає кольорового принтера»); тут її знято, бо
    в картах і таблицях кольором розрізняються об'єкти, і в сірому
    друці ця різниця губиться;

  - зі списку сторінок вимкнено «Карти нещасть і карми (D-6, D-8, D-11,
    D-30, D-45, D-60)». Решта сторінок друкується. Це лише те, що
    потрапляє в роздруківку за замовчуванням; у самому застосунку ці
    карти нікуди не поділися, і позначку можна повернути в тому ж діалозі.


ІМ'Я ТА АДРЕСА АСТРОЛОГА
------------------------
Налаштування -> Ваша адреса. Те, що тут введено, друкується у верхньому
куті кожної роздруківки. У цій збірці стоїть

  Jagannatha Hora UA
  GANAPATI VIDYA

Замініть на своє ім'я й контакти, якщо роздруковуєте карти для інших.


ТОЧКА ВІДЛІКУ ДЛЯ БХАВА/ЧАЛІТ ЧАКРИ
-----------------------------------
Налаштування -> Бхава чакра або Чаліт чакра -> Обрати точку відліку.

Бхава (чаліт) чакра показує, у якому ДОМІ стоїть планета, а не просто в
якому знаку. Щоб побудувати доми, потрібна точка, від якої вони
відраховуються. У списку 47 варіантів — лаґна, будь-яка з планет, вузли,
часові лаґни, спхути тощо.

  було:   Місяць (пункт 2 списку)
  стало:  Лаґна  (пункт 0)

Лаґна — класичний вибір: доми відлічують від висхідного градуса. Це ще й
єдиний варіант, за якого працюють системи домів на кшталт Шріпатхі: якщо
точкою відліку обрано не лаґну (або якщо чакра будується на дробній карті),
застосунок примусово переходить на рівні доми по 30 градусів.

Місяць як точка відліку теж має сенс — це «чандра-лаґна», карта від Місяця,
але для неї в застосунку є окремі засоби, і тримати її типовою для основної
бхава-чакри незручно.


ЯК ПОВЕРНУТИ ТИПОВІ НАЛАШТУВАННЯ
--------------------------------
Закрийте застосунок, видаліть jhcore\jhora.ini і запустіть її знову — файл
створиться наново з типовими значеннями. Разом із описаним вище зникнуть
і кольори, розміри вікон та перелік останніх карт.


ЯКЩО АНГЛІЙСЬКА ВЕРСІЯ ЛЕЖИТЬ ПОРУЧ
-----------------------------------
jhora.ini у них СПІЛЬНИЙ: обидві версії читають і пишуть той самий файл.
Тобто налаштування, змінені в одній, побачить і друга — це стосується і
всього описаного вище.


jhora-uk.ini — окремий файл української збірки
-----------------------------------------------
Поруч із jhora.ini лежить jhcore\jhora-uk.ini. Окремий файл потрібен тому,
що сам застосунок при виході переписує jhora.ini цілком і викидає з нього
все, чого не знає, — тобто будь-яке власне налаштування там не переживає
навіть одного запуску. jhora-uk.ini програма не знає й не чіпає.

Поки що в ньому один розділ:

  [Google]
  ApiKey=

Це ключ доступу до двох служб Google. У поставці рядок порожній: ключ
особистий, кожен заводить власний. Порожнє значення означає, що застосунок
узагалі не звертається до мережі й працює самим атласом, як авторська
версія. Той самий текст, що нижче, продубльовано в самому jhora-uk.ini —
щоб інструкція була під рукою там, де її виконують.


Навіщо це потрібно
------------------
Вбудований атлас міст зберігає для кожного міста один звичайний часовий
пояс і один літній. Для сьогоднішніх дат цього досить, а для давніх — ні:
межі переходів мінялися десятки разів, а до 1924 року Київ узагалі жив за
місцевим сонячним часом.

Ось той самий пошук «Kyiv» на чотирьох датах — ліворуч те, що каже
довідник Google, праворуч те, що дає атлас:

  дата          Google        атлас
  ----------------------------------------------
  31.3.1984     3:00          3:00 «Літній час»
  2.4.1984      4:00          3:00 «Літній час»
  29.9.1984     4:00          3:00 «Літній час»
  1.10.1984     3:00          3:00 «Літній час»
  4.4.1900      2:02          3:00 «Літній час»

1984 року літній час діяв з 1 квітня по 30 вересня — обидва переходи видно
точно. На 2 квітня і 29 вересня атлас помиляється на цілу годину, а на
4 квітня 1900 року — теж на годину, бо тоді ще не було жодних поясів.
Година різниці — це вже інший асцендент.

Крім поясу, ключ дає ще три речі: пошук міста за назвою будь-якою мовою
(атлас латинський і «Київ» не знайде ніколи), координати з точністю до
секунди дуги замість цілих хвилин і висоту над рівнем моря.


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

1. Заведіть обліковий запис Google (або скористайтеся наявним) і відкрийте
   https://console.cloud.google.com

2. Створіть проєкт. Угорі, ліворуч від рядка пошуку, — перемикач проєкту;
   натисніть його й оберіть «Створити проєкт» (New project). Назва будь-яка,
   наприклад jhora. Зачекайте кілька секунд і переконайтеся, що новий
   проєкт обрано в тому самому перемикачі: усе подальше робиться саме в
   ньому.

3. Увімкніть оплату: меню зліва -> «Оплата» (Billing) -> «Прив'язати
   обліковий запис для оплати». Знадобиться картка.
   Без цього кроку служби відповідають відмовою
   «You must enable Billing on the Google Cloud Project»,
   навіть якщо все інше зроблено правильно.

4. Увімкніть дві служби: меню зліва -> «API та служби» -> «Бібліотека»
   (APIs & Services -> Library). Знайдіть у пошуку й натисніть «Увімкнути»
   (Enable) по черзі для:

     Geocoding API   — пошук міста за назвою (обов'язково);
     Time Zone API   — часовий пояс на задану мить (обов'язково);
     Elevation API   — висота над рівнем моря (не обов'язково).

   Кожна відповідає за своє: без Geocoding не буде пошуку кирилицею й
   точних координат, без Time Zone — історичного поясу, без Elevation —
   висоти (поле лишиться таким, як дав атлас, тобто здебільшого 0).
   Висота на розрахунки майже не впливає, тож третю службу можна й не
   вмикати. Відмова «This API is not activated on your API project»
   означає саме цей крок для конкретної служби.

5. Створіть ключ: «API та служби» -> «Облікові дані» (Credentials) ->
   «Створити облікові дані» -> «Ключ API». З'явиться рядок виду AIzaSy… —
   скопіюйте його.

6. Обмежте ключ. Не обов'язково, але варто: натисніть на щойно створений
   ключ і в його властивостях
     — «Обмеження додатків» (Application restrictions) лишіть «Немає»
       (None): настільна програма не має ні сталої IP-адреси, ні
       сторінки-джерела, тож інші обмеження тут просто не працюють;
     — в «Обмеження API» (API restrictions) оберіть «Обмежити ключ» і
       позначте лише ті служби, які ви ввімкнули на кроці 4.
   Тоді ключем не можна буде скористатися для чогось іншого, навіть якщо
   він кудись потрапить.

7. Впишіть ключ у jhcore\jhora-uk.ini:

     [Google]
     ApiKey=AIzaSy…

   Одним рядком, без лапок і пробілів. Перезапускати програму не треба:
   ключ читається щоразу, коли ви натискаєте «Решта світу».

8. Перевірте. Відкрийте «Дані народження», у полі «Назва міста» наберіть
   Київ і натисніть «Решта світу». У списку результатів має з'явитися
   рядок «Київ, Україна   (…) [Google]» — позначка в самому кінці.


Якщо не працює
--------------
Застосунок навмисно мовчить про помилки: не вийшло — працює самим атласом,
як і раніше, без жодних повідомлень. Тому перевіряти найпростіше в
браузері. Підставте свій ключ замість <КЛЮЧ> і відкрийте два посилання:

  https://maps.googleapis.com/maps/api/geocode/json?address=Kyiv&key=<КЛЮЧ>
  https://maps.googleapis.com/maps/api/timezone/json?location=50.45,30.52&timestamp=1&key=<КЛЮЧ>

Відповідь читається так:

  "status" : "OK"                    служба працює;
  "You must enable Billing…"         не зроблено крок 3;
  "This API is not activated…"       не зроблено крок 4 для цієї служби;
  "API key not valid"                ключ скопійовано з помилкою;
  "REQUEST_DENIED" з обмеженнями     у кроці 6 не позначено цю службу.

Якщо обидва посилання відповідають «OK», а рядка «(Google)» у програмі все
одно немає — перевірте, чи ключ записано без зайвих пробілів і чи є на
комп'ютері доступ до мережі.


Про безпеку й витрати
---------------------
Ключ лежить у файлі відкритим текстом — інакше програма не змогла б ним
скористатися. Не викладайте jhora-uk.ini у мережу із заповненим ключем.
Якщо ключ кудись потрапив, видаліть його в консолі Google і створіть
новий: досить вписати сюди новий рядок.

Щоб напевно виключити несподіваний рахунок, у консолі можна поставити
добову межу кількості запитів: «API та служби» -> потрібна служба ->
«Квоти».

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