Editing the Manual – Редагування цього Посібника¶
Ви можете модифікувати посібник, редагуючи локальні текстові файли. Ці файли підтримуються в синхронізації з тими, що онлайн, через репозиторій, на основі цього сервер буде оновлювати онлайновий посібник.
Цей посібник написаний мовою розмітки reStructuredText (RST) і може редагуватися за допомогою звичайного редактора тексту. Для локального передогляду ви можете конвертувати (вибудувати) джерельні файли цього посібника з RST у HTML вебсторінки.
Update – Оновлення¶
Спершу, переконайтеся, що ваша локальна копія цього підручника є актуальною з онлайн репозиторієм за допомогою:
make update
Writing – Писання¶
Ви можете редагувати файли цієї документації, що є файлами .rst всередині теки manual, використовуючи будь-який текстовий редактор на ваш вибір.
Be sure to check the Writing Style Guide – Путівник зі Стилю Написання for conventions and Markup Style Guide – Путівник зі Стилю Розмітки to learn how to write in the reStructuredText markup language.
Щасливого писання!
Bigger Changes – Більші Зміни¶
If you are going to add or overhaul a section, be sure to check carefully that it does not already exist. In some places, the docs are so disorganized that sections may be duplicated or in a strange location. In the case that you find a duplicate or out of place section, create an issue explaining the issue, and optionally include a revision (actual changes).
Перш ніж робити будь-які редагування, які не є простими та явно виправданими (наприклад, переміщення тек), вам слід пересвідчитись у підтримувача посібника, чи ваш внесок відповідає баченню спільноти щодо посібника. Це забезпечує найкраще використання вашого часу та доброї волі, оскільки інакше можливо, що з якихось причин ваші зміни будуть суперечити й будуть відхилені або потребуватимуть часовитратного перегляду. Наприклад, інша особа може вже працювати над розділом, який ви хочете змінити, розділ може бути запланований на видалення або буде оновлений відповідно до запланованих змін до Blender.
Спілкування – :ref:`Communicating <contribute-contact> заздалегідь та часто – це ключ до продуктивного середовища без витрачання зайвих зусиль людей та отримання кращого довідника Blender у результаті.
Getting Help/Answers – Отримання Довідки/Відповідей¶
Якщо ви сумніваєтеся з приводу функціональності, яку ви бажаєте задокументувати, ви повинні поставити питання розробникам Blender, відповідальним за відповідну ділянку розробки, чи запитати на неофіційному каналі підтримки користувачів #docs або каналі #blender-coders у Chat.
Blender itself has a system of module owners with developer and artist members who are responsible for the design and maintenance of the assigned Blender areas. See the module pages for more information.
Preview – Передогляд¶
To view your changes, build the manual as instructed.
Keep in mind that you can also build only the chapter you just edited to view it quickly.
Open the generated .html files inside the build/html folder using your web browser,
or refresh the page if you have it open already.
Upload – Вивантаження¶
Коли ви задоволені своїми змінами, ви можете вивантажити їх, щоб вони були в онлайновому посібнику. Спочатку це робиться шляхом подання латок, щоб хтось міг переглянути ваші зміни та надіслати вам відгук. Після, ви можете фіксувати ваші зміни безпосередньо. Цей процес описується детально у наступному розділі.