chg_usage.md

Що таке chg

• chg - скрипт для виправлення структури розділів і заміни слів

chg від change - змінити

Як встановити

Встановіть середовище для виконання скрипта на вашу операційну систему

GNU/Linux та MacOS вже мають потрібне середовище, нічого додатково встановлювати не потрібно.

Windows: Встановіть середовище MSYS2 виконуючи 1-5 кроки з наведеної на сайті інструкції.

У випадку з Windows скрипт потрібно виконувати не у звичайному терміналі, а в тому що постачає msys2

Як використовувати

Взаємодія зі скриптом відбувається через передачу йому параметрів. Наприклад, chg розділ1 розділ2 розділ3 - виправити структуру вказаних файлів і виконати заміну помилкових слів(опціонально). Або chg json chapters1_645.json - перетворити JSON-файл(наприклад, з додатку Automa якщо збирали через нього розділи) на звичайний текст

Якщо треба виконати заміну помилкових слів - створіть файл cin.txt у поточній/попередній теці. На кожному рядку регулярний вираз що шукаємо/на що замінюємо. Приклад:

Хейді/Хайді
Хетевей/Хатевей
Хатвея/Хатевей
Хетевея/Хатевей
Хатвей/Хатевей
Хетеуея/Хатевей
Гетевей/Хатевей
Гетевея/Хатевей
Хетевею/Хатевей
Хативей/Хатевей
Сент-/Святий
ІІІ/III
ІІ/II

Скрипт зберігає результат своєї роботи у теці res, не перезаписуючи наявні файли.

Параметри

• json - перетворити JSON-файл на звичайний текст. Створить новий [ім'я файлу].text.txt. Приклад: chg json chapter1_645.json
• prep - оптимізувати кількість символів у файлі шляхом скорочення знаків пунктуації та пробілів. Використовується для зменшення кількості файлів які треба перекладати. Приклад chg prep chapter1_645.txt
• -c - не виконувати виправлення структури тексту, лише зробити заміну слів з файлу cin.txt. Приклад chg -c розділ5