Manual.txt

Istoriya
Версія 1.0
(С) 2022 Назар Федоренко

Інтерпретована езотерична мова програмування, яка використовує факти, терміни, дати
з програми ЗНО з історії України XX-XXI ст. в якості команд.

Коротка технічна документація

=========================================================================

Інтерпретатор запускається через командний рядок. Наприклад, запуск програми,
записаної у файл hello.txt:

Istoriya hello.txt

=========================================================================

Початок програми повинен починатися із цього рядка (пишу без лапок, щоб не було плутанини):

1 серпня 1914 р. - утворення Головної Української Ради, головою якої став Кость Левицький.

=========================================================================

Програма повинна закінчуватися цим рядком:

24 серпня 2022 р. - 31-й День Незалежності України.

=========================================================================

Команда виводу тексту на екран виглядає так:

6 (19) квітня 1917 р. - відкриття Українського національного конгресу в Києві.

Після цього іде послідовність команд, які задають символи на екрані (див. таблицю означень
символів). Ця послідовність завершується цією командою:

Приклад програми, яка виводить "ПРИВІТ!" на екран:

1 серпня 1914 р. - утворення Головної Української Ради, головою якої став Кость Левицький.
6 (19) квітня 1917 р. - відкриття Українського національного конгресу в Києві.
Помаранчева революція - сукупність протестів та інших актів громадянської непокори на підтримку Віктора Ющенка.
Русинство - соціально-політична течія, що виникла на Закарпатті й прихильники якої обстоювали ідею, слов'янське населення тут відмінне від українців.
Вільгельм Франц фон Габсбург-Лотаринген (Василь Вишиваний) - австрійський архікнязь, полковник Українських січових стрільців, поет.
Український визвольний рух - національно-визвольний рух на етнічних українських землях у 20-50-х рр. ХХ ст.
Іван Багряний - публіцист, письменник, політичний діяч. Належав до літературної організації письменників Києва «МАРС».
Тимчасово окупована територія - частина території України, яка контролюється росією.
24 серпня 1991 р. - ухвалення Акта проголошення незалежності України.
Останній день Українського національного конгресу присвятили виборам нового складу Центральної Ради.
24 серпня 2022 р. - 31-й День Незалежності України.

=========================================================================

Щоб попросити користувача ввести дані з клавіатури, використайте наступну команду:

15 (28) червня 1917 р. - створено Генеральний секретаріат УЦР, який очолив Володимир Винниченко.

Дані буде збережено у глобальну змінну.

=========================================================================

Використайте наступну команду для очищення екрану:

«Випалена земля» - метод ведення війни за допомогою знищення всього корисного на території, яку може зайняти противник. Використовувалася радянськими та німецькими військами.

=========================================================================

Для паузи програми використайте наступною командою:

Період «застою» - передостанній період існування радянського режиму (середина 60-х - початок 80-х рр. ХХ ст.).

Далі командою задається число - кількість секунд (1-9) (див. таблицю означень цифр). Наприклад,
цей код зупинить виконання програми на 7 секунд:

1 серпня 1914 р. - утворення Головної Української Ради, головою якої став Кость Левицький.
Період «застою» - передостанній період існування радянського режиму (середина 60-х - початок 80-х рр. ХХ ст.).
17 вересня 1939 р. - вторгнення червоної армії на територію Західної України.
24 серпня 2022 р. - 31-й День Незалежності України.

Якщо задати число 0, то пауза буде тривати 33 мілісекунди.

=========================================================================

Щоб порівняти значення глобальної змінної з іншим значенням, то визначити,
чи вони рівні, то використайте цю команду (IF-розгалуження):

27 січня (9 лютого) 1918 р. - ухвалено Брестський мирний договір між УНР та Четверного союзу.

Далі задається значення для порівняння із значенням глобальної змінної послідовністю
символів (див. таблицю означень символів), яка закінчується цією командою:

Останній день Українського національного конгресу присвятили виборам нового складу Центральної Ради.

Закінчується блок IF цією командою:

Наслідок Брестського мирного договору: звільнення території УНР від більшовиків.

Наступний код виводить "ТАК", якщо значення вводу користувача дорівнює 12.

1 серпня 1914 р. - утворення Головної Української Ради, головою якої став Кость Левицький.
15 (28) червня 1917 р. - створено Генеральний секретаріат УЦР, який очолив Володимир Винниченко.
27 січня (9 лютого) 1918 р. - ухвалено Брестський мирний договір між УНР та Четверного союзу.
Леонід Кравчук - Перший Президент України (1991-1994).
Грудень 1942 р. - початок вигнання німецьких окупантів із території України.
Останній день Українського національного конгресу присвятили виборам нового складу Центральної Ради.
6 (19) квітня 1917 р. - відкриття Українського національного конгресу в Києві.
Тимчасово окупована територія - частина території України, яка контролюється росією.
Автокефальна церква - православна церква, яка має цілковиту самостійність у розв'язанні організаційних і культових питань.
Курултай - орган громадського кримськотатарського національного руху, утворений 26 листопада (9 грудня) 1917 р.
Останній день Українського національного конгресу присвятили виборам нового складу Центральної Ради.
Наслідок Брестського мирного договору: звільнення території УНР від більшовиків.
24 серпня 2022 р. - 31-й День Незалежності України.

Команда для ELSE IF, після якої іде інше значення для порівняння, якщо попереднє не підійшло:

Сторони відмовлялися від взаємних претензій щодо відшкодування завданих війною збитків.

Команда ELSE, якщо усі порівняння провалилися:

Зобов'язання УНР: постачати продовольство Німеччині та Австро-Угорщині.

Наступний код виводить "ТАК", якщо значення вводу користувача дорівнює 12, "МАЙЖЕ",
якщо значення = 11, або "НІ", якщо значення =/= 12 або 11.

1 серпня 1914 р. - утворення Головної Української Ради, головою якої став Кость Левицький.
15 (28) червня 1917 р. - створено Генеральний секретаріат УЦР, який очолив Володимир Винниченко.
27 січня (9 лютого) 1918 р. - ухвалено Брестський мирний договір між УНР та Четверного союзу.
Леонід Кравчук - Перший Президент України (1991-1994).
Грудень 1942 р. - початок вигнання німецьких окупантів із території України.
Останній день Українського національного конгресу присвятили виборам нового складу Центральної Ради.
6 (19) квітня 1917 р. - відкриття Українського національного конгресу в Києві.
Тимчасово окупована територія - частина території України, яка контролюється росією.
Автокефальна церква - православна церква, яка має цілковиту самостійність у розв'язанні організаційних і культових питань.
Курултай - орган громадського кримськотатарського національного руху, утворений 26 листопада (9 грудня) 1917 р.
Останній день Українського національного конгресу присвятили виборам нового складу Центральної Ради.
Сторони відмовлялися від взаємних претензій щодо відшкодування завданих війною збитків.
Леонід Кравчук - Перший Президент України (1991-1994).
Леонід Кравчук - Перший Президент України (1991-1994).
Останній день Українського національного конгресу присвятили виборам нового складу Центральної Ради.
6 (19) квітня 1917 р. - відкриття Українського національного конгресу в Києві.
Мобілізація - комплекс заходів, спрямованих на переведення країни у воєнний стан.
Автокефальна церква - православна церква, яка має цілковиту самостійність у розв'язанні організаційних і культових питань.
Йосип Сліпий - митрополит Української греко-католицької церкви (3 1944 р.).
Андрій Жук - громадський і політичний діяч, публіцист, кооператор, член РУП та УСДРП (1901-1911).
Евакуація - організоване вивезення людей, підприємств, установ та матеріальних цінностей з небезпечної місцевості під час війни.
Останній день Українського національного конгресу присвятили виборам нового складу Центральної Ради.
Зобов'язання УНР: постачати продовольство Німеччині та Австро-Угорщині.
6 (19) квітня 1917 р. - відкриття Українського національного конгресу в Києві.
Націонал-ухильництво - ідеологічний штамп, що вживався в агітаційно-пропагандистській роботі в СРСР.
Іван Багряний - публіцист, письменник, політичний діяч. Належав до літературної організації письменників Києва «МАРС».
Останній день Українського національного конгресу присвятили виборам нового складу Центральної Ради.
Наслідок Брестського мирного договору: звільнення території УНР від більшовиків.
24 серпня 2022 р. - 31-й День Незалежності України.

=========================================================================

Для циклів FOR використовуйте цю команду:

Грудень 1917 р. - березень 1918 рр. - перша війна рсфрр і УНР.

Після неї задається кількість ітерацій циклу (0-9) командою (див. таблицю означень
цифр). Якщо задати число 0, то цикл буде безкінечним.

Для кінця блоку FOR-циклу використовується дана команда:

9 (22) січня 1918 р. - видано Четвертий Універсал УЦР та проголошено УНР.

Для переривання циклу:

18 лютого 1918 р. розпочався наступ армії Четверного союзу та військ УНР проти більшовиків.

Наступна програма виведе "ПРИВІТ!" 9 разів.

1 серпня 1914 р. - утворення Головної Української Ради, головою якої став Кость Левицький.
Грудень 1917 р. - березень 1918 рр. - перша війна рсфрр і УНР.
1959 р. - утворення Української робітничо-селянської спілки.
6 (19) квітня 1917 р. - відкриття Українського національного конгресу в Києві.
Помаранчева революція - сукупність протестів та інших актів громадянської непокори на підтримку Віктора Ющенка.
Русинство - соціально-політична течія, що виникла на Закарпатті й прихильники якої обстоювали ідею, слов'янське населення тут відмінне від українців.
Вільгельм Франц фон Габсбург-Лотаринген (Василь Вишиваний) - австрійський архікнязь, полковник Українських січових стрільців, поет.
Український визвольний рух - національно-визвольний рух на етнічних українських землях у 20-50-х рр. ХХ ст.
Іван Багряний - публіцист, письменник, політичний діяч. Належав до літературної організації письменників Києва «МАРС».
Тимчасово окупована територія - частина території України, яка контролюється росією.
24 серпня 1991 р. - ухвалення Акта проголошення незалежності України.
Останній день Українського національного конгресу присвятили виборам нового складу Центральної Ради.
9 (22) січня 1918 р. - видано Четвертий Універсал УЦР та проголошено УНР.
24 серпня 2022 р. - 31-й День Незалежності України.

=========================================================================

Всередині послідовностей символів можна застосовувати команду випадкового символу:

Референдум - прийняття електоратом рішення з політичних питань.

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

Останній день Українського національного конгресу присвятили виборам нового складу Центральної Ради.

Наступна програма виведе одне з чисел з діапазону 0-9.

1 серпня 1914 р. - утворення Головної Української Ради, головою якої став Кость Левицький.
6 (19) квітня 1917 р. - відкриття Українського національного конгресу в Києві.
Референдум - прийняття електоратом рішення з політичних питань.
16 липня 1990 р. - ухвалення Декларації про державний сувернітет України.
Леонід Кравчук - Перший Президент України (1991-1994).
Грудень 1942 р. - початок вигнання німецьких окупантів із території України.
1923 р. - саморозпуск уряду ЗУНР.
1914 р. - Галицька битва.
1915 р. - утворення Загальної Української Ради (ЗУР).
28 червня 1996 р. - ухвалення Конституції України.
17 вересня 1939 р. - вторгнення червоної армії на територію Західної України.
2008 р. - вступ України до Світової організації торгівлі (СОТ).
1959 р. - утворення Української робітничо-селянської спілки.
Останній день Українського національного конгресу присвятили виборам нового складу Центральної Ради.
Останній день Українського національного конгресу присвятили виборам нового складу Центральної Ради.
24 серпня 2022 р. - 31-й День Незалежності України.

=========================================================================

Для відкриття файлу для читання використовується ця команда:

Українська національна партія (жовтень 1989 р.) - Львів, нечисленна.

Для відкриття файлу для запису використовується ця команда:

Українська республіканська партія (квітень 1990 р.) - Київ.

Для запису текстового рядка у файл використовується ця команда:

Ліберально-демократична партія (червня 1990 р.) - Київ.

Після цих команд ідуть послідовності символів (назва файлу для читання,
назва файлу для запису, рядок для запису відповідно), які теж завершуються
вже знайомою командою:

Останній день Українського національного конгресу присвятили виборам нового складу Центральної Ради.

Для читання текстового рядка із файлу використовується ця команда:

Українська хритиянсько-демократична партія (квітень 1990 р.) - Львів.

Рядок буде записано у глобальну змінну.

Файли закриваються автоматично після завершення виконання програми.

=========================================================================

Замість послідовностей символів у різних командах можна використовувати
команду отримання значення глобальної змінної:

15 (28) червня 1917 р. - створено Генеральний секретаріат УЦР, який очолив Володимир Винниченко.

При цьому НЕ ПОТРІБНО використовувати команду кінця послідовності символів.

Наступна програма виводить на екран, те що написав перед цим користувач.

1 серпня 1914 р. - утворення Головної Української Ради, головою якої став Кость Левицький.
15 (28) червня 1917 р. - створено Генеральний секретаріат УЦР, який очолив Володимир Винниченко.
6 (19) квітня 1917 р. - відкриття Українського національного конгресу в Києві.
15 (28) червня 1917 р. - створено Генеральний секретаріат УЦР, який очолив Володимир Винниченко.
24 серпня 2022 р. - 31-й День Незалежності України.

=========================================================================

У різних місцях коду можна залишати мітки. Це робиться цією командою:

«Поліська Січ» - перша українська повстанська формація, що діяла під Другої світової війни під орудою Тараса Бульби-Боровця.

Далі іде ідентифікатор мітки після цієї команди, який позначається довільним символом
(див. таблицю означень символів).

Для переходу до потрібної мітки у коді використовуйте цю команду:

«Похідні групи» були створені ОУН зі свідомих українців на українських землях органів місцевого самоврядування під час Другої світової війни.

ЗВЕРНІТЬ УВАГУ: використання міток у сучасному програмуванні є ПОГАНОЮ практикою!

Наступний приклад програми, яка використовує мітки - програма "10 PRINT MAZE",
яку зазвичай писали мовою BASIC на комп'ютерах Commodore 64. Вона виводить
випадково згенерований лабіринт на екран.

1 серпня 1914 р. - утворення Головної Української Ради, головою якої став Кость Левицький.
Грудень 1917 р. - березень 1918 рр. - перша війна рсфрр і УНР.
16 липня 1990 р. - ухвалення Декларації про державний сувернітет України.
6 (19) квітня 1917 р. - відкриття Українського національного конгресу в Києві.
Референдум - прийняття електоратом рішення з політичних питань.
Реабілітація - поновлення доброго імені, репутації несправедливо звинуваченої людини.
Політичною реабілітацією вважають винесення виправдовувального вироку під час перегляду справи із безпідставними звинуваченнями.
Останній день Українського національного конгресу присвятили виборам нового складу Центральної Ради.
Останній день Українського національного конгресу присвятили виборам нового складу Центральної Ради.
9 (22) січня 1918 р. - видано Четвертий Універсал УЦР та проголошено УНР.
24 серпня 2022 р. - 31-й День Незалежності України.

=========================================================================

Утиліта UTF8ToIstoriya конвертує текст у файлах із кодуванням UTF-8 у
послідовності символів цією мовою.

Це утиліта командного рядка. Приклад використання:

UTF8ToIstoriya input.txt output.txt

=========================================================================

Ця мова НЕПОВНА за Тюрінгом! Ніяких оголошень змінних, функцій та
математичних операцій! Але, можливо, я зроблю це у майбутньому і,
можливо, навіть перепишу усі свої лабораторні роботи по першому 
модулю з основ програмування цією мовою :D

=========================================================================

Таблиця означень символів:

А - Автокефальна церква - православна церква, яка має цілковиту самостійність у розв'язанні організаційних і культових питань.
Б - Бандерівці - члени ОУН(Б), того її крила самостійників-державників, яке очолював Степан Бандера.
В - Український визвольний рух - національно-визвольний рух на етнічних українських землях у 20-50-х рр. ХХ ст.
Г - Генеральний секретаріат - виконавчий орган, створений за рішенням Малої Ради від 15 червня 1917 р.
Ґ - Гласність - ліквідація цензури в СРСР М.Горбачовим, складова проголошеної ним програми реформ.
Д - Дисидент - учасник руху, спрямованого проти комуністичного тоталітарного режиму.
Е - Евакуація - організоване вивезення людей, підприємств, установ та матеріальних цінностей з небезпечної місцевості під час війни.
Є - Євген Петрушевич - державний і політичний діяч, один із керівників Української революції 1917-1920 рр.
Ж - Андрій Жук - громадський і політичний діяч, публіцист, кооператор, член РУП та УСДРП (1901-1911).
З - 9 листопада 1918 р. - утворено Західноукраїнську Народну Республіку (ЗУНР).
И - Вільгельм Франц фон Габсбург-Лотаринген (Василь Вишиваний) - австрійський архікнязь, полковник Українських січових стрільців, поет.
І - Іван Багряний - публіцист, письменник, політичний діяч. Належав до літературної організації письменників Києва «МАРС».
Ї - Українська Центральна Рада - провідник українського національно-визвольного руху.
Й - Йосип Сліпий - митрополит Української греко-католицької церкви (3 1944 р.).
К - Курултай - орган громадського кримськотатарського національного руху, утворений 26 листопада (9 грудня) 1917 р.
Л - Лібералізація (за «відлиги») - курс на пом'якшення політичного режиму.
М - Мобілізація - комплекс заходів, спрямованих на переведення країни у воєнний стан.
Н - Націонал-ухильництво - ідеологічний штамп, що вживався в агітаційно-пропагандистській роботі в СРСР.
О - Олесь Гончар - письменник, громадський діяч, академік, автор трилогії «Прапороносці».
П - Помаранчева революція - сукупність протестів та інших актів громадянської непокори на підтримку Віктора Ющенка.
Р - Русинство - соціально-політична течія, що виникла на Закарпатті й прихильники якої обстоювали ідею, слов'янське населення тут відмінне від українців.
С - Соборність - ідея об'єднання в одне державне утворення всіх етнічно-історичних українських земель.
Т - Тимчасово окупована територія - частина території України, яка контролюється росією.
У - 10 (23) червня 1917 р. - Перший Універсал Української Центральної Ради.
Ф - Володимир Філатов - офтальмолог і хірург, засновник відомої офтальмологічної школи.
Х - Холодноярська республіка - героїчна сторінка боротьби за незалежність України в 1919-1922 рр. Повстанський селянський рух здебільшого охоплював Чигиринський повіт Київської губернії.
Ц - Олександр Богомолець - видатний учений-патофізіолог, державний і громадський діяч, організатор науки.
Ч - Чортківська офензива - найуспішніша наступальна операція Української галицької армії, проведена 7-28 червня 1919 р.
Ш - Шістдесятники - представники української літературно-мистецької та суспільно-політичної течій наприкінці 50-х - на початку 70-х рр. ХХ ст.
Щ - Отаманщина - явище, що зародилося в Армії УНР наприкінці 1918 р. під час антигетьманського повстання.
Ь - Тіньова економіка - господарська діяльність, яка відбувається поза офіційним (державним) обліком і контролем.
Ю - Віктор Ющенко - Президент України (2005-2010).
Я - Ярослав Стецько - діяч українського національно-визвольного руху, член ОУН (з 1932 р.).
  - Вересень 2014 р., лютий 2015 р. - Мінські угоди.
( - Грудень 1919 р. - травень 1920 р. - Перший зимовий похід Армії УНР.
) - Листопад 1921 р. - Другий зимовий похід Армії УНР.
: - Михайло Волобуєв - вчений-економіст, автор статті «До проблеми української економіки (1928)».
, - Самвидав - тексти, виготовлені й поширені з метою висловлення протесту проти придушення свободи слова радянською владою.
; - Тамвидав - видання книги вітчизняного автора за кордоном, переважно в радянські часи.
- - Експропріація - примусове відчуження приватної власності.
. - Корупція - негативне суспільне явище, яке проявляється у злочинному використанні громадськими і політичними діячами їхніх прав для особистого збагачення.
` - В'ячеслав Чорновіл - учасник дисидентського руху із середини 60-х років ХХ ст.
! - 24 серпня 1991 р. - ухвалення Акта проголошення незалежності України.
? - 3 (16) липня 1917 р. - Другий Універсал Української Центральної Ради.
* - «Червоний терор» - заходи насильства, що їх вживали більшовики проти широких соціальних груп.
+ - Під час індустріалізації в Україні було побудовано 12 промислових гігантів.
= - 22 січня 1919 р. - проголошення Акта Злуки УНР і ЗУНР.
₴ - Вересень 1996 р. - в обіг запроваджено гривню.
% - Середньорічні темпи зростання капіталовкладень у народне господарство України знизилися 3 6,8% до 6,4% у 9-ій п`ятирічці.
№ - 2004 р. Янукович отримав курячим яйцем по морді.
" - 1970-1972 рр. - вихід друком самвидавного «Українського вісника».
/ - Реабілітація - поновлення доброго імені, репутації несправедливо звинуваченої людини.
\ - Політичною реабілітацією вважають винесення виправдовувального вироку під час перегляду справи із безпідставними звинуваченнями.
| - Першим судовим процесом проти української гуманітарної інтелігенції став розгляд справи «Спілки визволення України» (1930).
█ - Казимир Малевич - український художник-авангардист, один із фундаторів кубофутуризму.
▓ - Колективізація сільського господарства - процес докорінної перебудови аграрного сектора, ініційований більшовиками наприкінці 20-х років ХХ ст.
0 - 16 липня 1990 р. - ухвалення Декларації про державний сувернітет України.
1 - Леонід Кравчук - Перший Президент України (1991-1994).
2 - Грудень 1942 р. - початок вигнання німецьких окупантів із території України.
3 - 1923 р. - саморозпуск уряду ЗУНР.
4 - 1914 р. - Галицька битва.
5 - 1915 р. - утворення Загальної Української Ради (ЗУР).
6 - 28 червня 1996 р. - ухвалення Конституції України.
7 - 17 вересня 1939 р. - вторгнення червоної армії на територію Західної України.
8 - 2008 р. - вступ України до Світової організації торгівлі (СОТ).
9 - 1959 р. - утворення Української робітничо-селянської спілки.
(кінець рядка) - Жовтень 1990 р. - Революція на граніті.

=========================================================================

Таблиця означень цифр:

0 - 16 липня 1990 р. - ухвалення Декларації про державний сувернітет України.
1 - Леонід Кравчук - Перший Президент України (1991-1994).
2 - Грудень 1942 р. - початок вигнання німецьких окупантів із території України.
3 - 1923 р. - саморозпуск уряду ЗУНР.
4 - 1914 р. - Галицька битва.
5 - 1915 р. - утворення Загальної Української Ради (ЗУР).
6 - 28 червня 1996 р. - ухвалення Конституції України.
7 - 17 вересня 1939 р. - вторгнення червоної армії на територію Західної України.
8 - 2008 р. - вступ України до Світової організації торгівлі (СОТ).
9 - 1959 р. - утворення Української робітничо-селянської спілки.

=========================================================================

СЛАВА УКРАЇНІ! ГЕРОЯМ СЛАВА! СМЕРТЬ ВОРОГАМ!