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

You can modify the manual by editing local text files. These files are kept in sync with those online via a repository, based on this the server will update the online manual.

The manual is written in the reStructuredText (RST) markup language and can be edited using a plain text editor. For a local preview, you convert (build) the manual source files from RST into HTML web pages.

Оновлення – 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

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