Editing the Manual – Редагування цього Посібника

Ви можете модифікувати посібник, редагуючи локальні текстові файли. Ці файли підтримуються в синхронізації з тими, що онлайн, через репозиторій, на основі цього сервер буде оновлювати онлайновий посібник.

Цей посібник написаний мовою розмітки reStructuredText (RST) і може редагуватися за допомогою звичайного редактора тексту. Для локального передогляду ви можете конвертувати (вибудувати) джерельні файли цього посібника з RST у HTML вебсторінки.

Оновлення – Update

Спершу, переконайтеся, що ваша локальна копія цього підручника є актуальною з онлайн репозиторієм за допомогою:

svn update

Writing – Писання

Ви можете редагувати файли цієї документації, що є файлами .rst всередині теки manual, використовуючи будь-який текстовий редактор на ваш вибір.

Переконайтесь, що ви ознайомилися із Путівник зі Стилю Написання – Writing Style Guide про умовності та Путівник зі Стилю Розмітки – Markup Style Guide, щоб дізнатися, як писати мовою розмітки reStructuredText.

Щасливого писання!

Більші зміни

Якщо ви збираєтеся додати чи переглянути розділ, обов’язково уважно перевірте, чи він ще не існує. У деяких місцях документи настільки дезорганізовані, що розділи можуть дублюватися або знаходитись у дивному місці. У випадку, якщо ви знайдете дублікат або розділ не у відповідному місті, то створіть завдання – create a task з поясненням проблеми та опціонально включіть ревізію (фактичні зміни).

Перш ніж робити будь-які редагування, які не є простими та явно виправданими (наприклад, переміщення тек), вам слід пересвідчитись у підтримувача посібника, чи ваш внесок відповідає баченню спільноти щодо посібника. Це забезпечує найкраще використання вашого часу та доброї волі, оскільки інакше можливо, що з якихось причин ваші зміни будуть суперечити й будуть відхилені або потребуватимуть часовитратного перегляду. Наприклад, інша особа може вже працювати над розділом, який ви хочете змінити, розділ може бути запланований на видалення або буде оновлений відповідно до запланованих змін до Blender.

Спілкування – :ref:`Communicating <contribute-contact> заздалегідь та часто – це ключ до продуктивного середовища без витрачання зайвих зусиль людей та отримання кращого довідника Blender у результаті.

Отримання довідки/відповідей

Якщо ви сумніваєтеся з приводу функціональності, яку ви бажаєте задокументувати, ви повинні поставити питання розробникам Blender, відповідальним за відповідну ділянку розробки, чи запитати на неофіційному каналі підтримки користувачів #docs або каналі #blender-coders у Чат Blender’а – Blender Chat.

Сам Blender має систему власників модулів із розробниками та учасними від мистецтва, які відповідальні за проєктування та обслуговування призначених областей Blender. Дивіться module owners page для отримання додаткової інформації.

Preview – Передогляд

Для перегляду ваших змін вибудуйте цей підручник так, як інструктується тут – as instructed. Майте на увазі, що ви можете також вибудувати лише главу, яку щойно редагували, для її швидкого перегляду. Відкрийте згенеровані .html файли всередині теки build/html за допомогою вашого веббраузера або освіжіть сторінку, якщо вона вже відкрита.

Вивантаження – Upload

Коли ви задоволені своїми змінами, ви можете вивантажити їх, щоб вони були в онлайновому посібнику. Спочатку це робиться шляхом подання латок, щоб хтось міг переглянути ваші зміни та надіслати вам відгук. Після, ви можете фіксувати ваші зміни безпосередньо. Цей процес описується детально у наступному розділі.