Phabricator/Help/uk

Шановний користувачу Фабрикатора! Якщо у Вас є запитання, просто поставте їх на сторінці обговорення. Ми покращимо нашу документацію на основі отриманих відгуків. If you want to test Phabricator, you should use the Cloud Services instance.

Щоб отримати вищий рівень розуміння Фабрикатора, перейдіть за посиланням нижче. Або продовжіть читати цю сторінку, щоб почати прямо вже.

Створення свого облікового запису
You can connect your new Phabricator account either with your global Wikimedia wiki account, or with your Wikimedia developer account. In both cases, no separate password is needed.

With your global wiki account



 * Спершу переконайтеся, що Ви Вікімедіа.
 * Якщо у Вас ще нема вікімедійної обліковки,.
 * Перейдіть на сторінку входу в Фабрикатор (коли Ви не в системі, посилання відображається як стрілка на двері у верхньому правому кутку).
 * Натисніть на кнопку із соняшником, де пише «Login or Register - MediaWiki».
 * MediaWiki.org попросить у Вас підтвердження з'єднання.
 * Фабрикатор попросить Вас ввести ім'я користувача. Якщо сумніваєтеся, просто використайте вікімедійне ім'я користувача, але зауважте, що ім'я користувача в Фабрикаторі не може містити символи не латинкою, як-то العَرَبِيةُ чи 中华民族. Також вимагається вказати адресу електронної пошти, але вона не буде видима іншим користувачам.


 * Натисніть на Manage у навігаційній панелі зліва.
 * Натисніть на Edit Profile і вкажіть про себе Also Known As (наприклад, своє повне ім'я), щоб Вас було легше шукати.

With your Wikimedia Developer account

 * Розширені
 * Якщо у Вас є обліковий запис [$link1 wikitech.wikimedia.org] &mdash; також відомий як обліковка LDAP або Gerrit — Ви можете також скористатися ним. Одне й те ж ім'я користувача Фабрикатора може бути приєднане і до MediaWiki.org, і до LDAP. Це може бути запасним варіантом, якщо раптом станеться неправдоподібне і SUL Вікімедіа не працюватиме.

Приєднайте свої облікові записи SUL та LDAP до одного імені користувача Фабрикатора! Інакше Ви створите у Фабрикаторі два різні облікові записи.

Multi-factor authentication

 * Ми не заохочуємо використання багатофакторної автентифікації у Фабрикаторі Вікімедіа. Якщо все ж Ви плануєте її використовувати, прочитайте спершу настанови і вимоги до багатофакторної автентифікації.

Troubleshooting

 * If you cannot verify your Phabricator account because you entered an incorrect email address, please add a note on Talk:Phabricator/Help.
 * If you find your Phabricator account disabled, please add a note on Talk:Phabricator/Help.
 * If you get an "Email address already taken" error when you try to create a Phabricator account via "Login or Register - MediaWiki" you probably already registered a Phabricator account connected to your Wikimedia Developer account. You will have to log into Phabricator via your Developer account. Use wikitech:Special:PasswordReset if you have forgotten your Developer account password.
 * If you need to change your Phabricator user name for some reason, please add a note on Talk:Phabricator/Help.

Повернення попередніх облікових записів Bugzilla та RT
Перейдіть за цим посиланням.

Отримання оновлень і сповіщень
Фабрикатор сповіщує Вас про відповідну активність, включно з Вашими власними діями. Ви можете відрегулювати налаштування електронної пошти на свій смак і отримувати веб-сповіщення лише для певної діяльності або не отримувати їх взагалі.

Фабрикатор надає кілька інструментів отримання сповіщень, які Ви хочете отримувати.


 * Якщо Вам цікавий окремий об'єкт (завдання, макет тощо), просто клікніть  на його сторінці. Додавання коментаря підпише Вас автоматично.
 * Якщо Вас цікавить уся діяльність в межах проекту, Ви можете натиснути на  на сторінці огляду проекту. There is more information in the Projects user guide under "Watching Projects".

See Phabricator/Help/Managing mail for reducing the amount of mail notifications and about filtering mail notifications.

Troubleshooting
If you receive unexpected mail notifications for a task:


 * You might be subscribed to the task.
 * You might be a member of a project or of a subproject associated to that task. A list of all projects that you are a member of is available.
 * You might watch a project associated to that task. A list of all projects that you watch is available.
 * In your email preferences under "Maniphest Tasks", you might have enabled "One of a task's subtasks changes status".
 * You might have a personal Herald rule set up. Check the "X-Herald-Rules" message header field to see a list of all applied Herald rules.

Створення правил Herald для сповіщень
Перейдіть за цим посиланням, щоб дізнатися, як створити власні (особисті) правила сповіщення у Herald'і Фабрикатора Вікімедіа. Це більш розширена можливість, і її може бути складно використовувати.

Створення завдання
Є три способи створити завдання, залежно від інформації, яку треба внести: Заповніть форму, залишивши поля, у яких Ви не впевнені, незміненими.
 * Просто нове завдання: натиснути на кнопку $+ або посилання Create Task угорі справа. Ви побачите пусту форму.
 * A security problem: click the Star button toward the right side of the top navigation bar. From the dropdown menu, choose Report Security Issue. You will get a form pre-tagged with Security, and with a link to special instructions for filing security bugs.
 * Підзавдання дійсного завдання: натисніть на посилання Create Subtask у правій колонці поточного завдання. Буде встановлено залежність між двома завданнями і деякі значення батьківського завдання буде заповнено автоматично (Assigned To, Subscribers, Priority, Projects). Підзавдання будуть перераховані у батьківському завданні, відсортовані від найпізніше оновлених.

Форматування
Фабрикатор підтримує деяке форматування у текстових полях. [https://secure.phabricator.com/book/phabricator/article/remarkup/ Див. цю довідку про форматування у Фабрикаторі.]

Обирання проектів
Щоб прив'язати завдання до проекту, який використовує Фабрикатор, Вам просто треба почати вводити його назву у полі Tags й обрати проект зі списку тих, що пасують (у списку буде показано лише п'ять підхожих проектів). Ви можете також шукати проекти натискаючи іконку збільшувального скла у полі Tags. Ви можете додати один чи бліьше проектів до поля Tags. Якщо Ви не впевнені, можете також залишити його пустим — оцінювачі потурбуються про завдання, для яких не вказаний проект. Існує (довгий) список доступних проектів. Натисніть, щоб шукати проекти. (Цей список доступний також на сторінці Фабрикатор/Проекти.)

Вказання пріоритету завдання
Зазвичай пріоритет вказують менеджери продуктів, обслуговувачі або розробники, що планують працювати над завданням, або баґмайстери чи досвідчені члени спільноти, але не та ж людина, що подає звіт про помилку чи сторонній спостерігач. Див. детальніше Менеджмент проектів у Фабрикаторі.

Використання e-mail
Ви також можете створювати завдання, надсилаючи електронні листи на [mailto:task@phabricator.wikimedia.org task@phabricator.wikimedia.org]. Тема листа має бути назвою завдання, тіло буде використане, як воно є, а прикріплення будуть додані до завдання. Щоб встановити проект, додайте відповідну команду «!projects» та його хештеґ на початку тіла, наприклад,. ===Passing certain values in the task creation URL [ [/w/index.php%3Ftitle%3DPhabricator/Help%26action%3Dedit%26section%3D1 edit] ]  === "Report a bug in Phabricator" link can pass numerous values via URL parameters appended to the generic task creation link.

This is a very advanced feature. [/wiki/Special%3AMyLanguage/Phabricator/Help/Task%20Creation%20URL Learn more here.]

Reply to comments and markup
To reply, you need an account as well.

Uploading file attachments [ [/w/index.php%3Ftitle%3DPhabricator/Help%26action%3Dedit%26section%3D1 edit] ]
Є декілька способів завантажувати файли: Ви можете додати файл (наприклад, знімок екрану) у коментар або опис завдання, перетягнувши його туди мишкою. Користувачі також можуть копіювати і вставляти зображення через буфер обміну своєї системи.

Якщо у Вашій системі це неможливо, можете скористатися phabricator:file/upload і послатися на номер файлу (наприклад, «123»), який відобразиться після успішного завантаження файлу, вписавши  у коментар. Це створить посилання на файл. Щоб включити файл у коментар, візьміть ID файлу у фігурні дужки:. Per default it's included as thumbnail. Більше опцій форматування у довідці Remarkup. If you have to upload files frequently and consider the currently available options uncomfortable, you could also add a text panel to your homepage with a direct link.

Зверніть увагу, що Ви не можете завантажити файл, а потім обмежити рівень доступу до нього (наприклад, прив'язавши його тікета про загрозу безпеки). Вам доведеться вилучити файл і завантажити його повторно з більш обмеженими дозволами доступу. Рекомендовано завантажувати файли, які матимуть обмежений доступ, разом зі створенням тікету з обмеженим доступом  (про загрозу безпеки).

Якщо Вам знадобиться вилучити файл, який Ви завантажили, відкрийте огляд [[phabricator:file/query/authored/, оберіть «Authored», тоді виберіть файл і натисніть «Delete File» на бічній панелі.

Менеджмент проектів у Фабрикаторі
Якщо Ви підтримуєте чи керуєте проектом, будь ласка, перейдіть за цим посиланням по детальнішу інформацію.

Блокування завдань
Завдання можуть блокувати або бути заблокованими будь-якою кількістю інших завдань. Ця функція може використовуватися для досягнення кількох різних речей:

ПРИМІТКА: Існує функція «Create Subtask». На додачу до встановлення коректного відношення «блокуюче/заблоковане», вона також переносить список копій (підписок) на нове підзавдання. Коли підзавдання створено, воно є просто блокуючим завданням. Конкретно статус «підзавдання» не зберігається.
 * Блокатори. Завдання може бути просто заблоковане іншим завданням, що відображає залежність (див. Phabricator/Project management про те, як додати блокуюче завдання).
 * Підзавдання. Батьківське завдання буде заблоковане своїми підзавданнями. (Немає іншого способу позначити відношення «батьківське завдання/підзавдання»).
 * Відслідковування. «Безробітне» завдання, заблоковане кількома завданнями, може бути відслідковуванням групи завдань в межах релізу чи іншого періоду часу (див. #«Слідкуючі» завдання нижче).
 * Схвалення. Декілька завдань (наприклад, чернетки командних цілей) можуть бути блоковані єдиним завданням, яке показує, що чернеткові завдання схвалено, після чого чернетки цілей стають реальними цілями.

Визначення пріоритетності
See Phabricator/Project management

Призначення
See Phabricator/Project management

«Слідкуючі» завдання
Цей термін запозичений з Баґзілли, де він мав конкретне значення: завдання, що встановлювалось як таке, що блокується іншими завданнями, але саме собою не представляє жодної роботи, і не прив'язане до певного релізу чи дати. Прикладом могло бути завдання з назвою «Почистити документацію», яке могло мати купу підзавдань, кожне з яких описувало конкретний шмат роботи, який треба зробити. Такі «слідкуючі» завдання часто висіли довгий час (або й постійно), тоді як підзавдання вирішувались, але й створювались нові. У Фабрикаторі краще створити проект (теґ) для категоризації такого типу роботи.

Зверніть, однак, увагу, що є інші типи «безробітних» узагальнюючих завдань, які все ж є сенс мати у Фабрикаторі. Зокрема завдання «Release». Майбутній реліз може бути представлений завданням, яке містить у вигляді підзавдань (так званих блокуючих завдань) усю фактичну роботу, яку треба зробити для цього релізу. Коли реліз виходить, завдання вирішується. Подібне використання — мати завдання, яке представляє загальні цілі команди на квартал, тоді кожна ціль може бути (або не бути) блокуючим підзавданням.

Search context (global vs advanced)


Фабрикатор складається з кількох аплікацій (менеджмент завдань у Maniphest'і — одна з них, у майбутньому також будуть вичитка коду та інші). Поле пошуку у верхньому кутку дозволяє шукати у всіх цих аплікаціях.



There are 2 different search forms:


 * The global search at https://phabricator.wikimedia.org/search/query/advanced/. This one is fairly simple. It is in the upper right corner. By default, it searches across all applications and hence all types of documents (open tasks, closed tasks, code commits, etc…). You can change the default context using the the arrow menu to the left of the search bar. For example, select "Open Tasks" to only show results in open tasks from the Maniphest issue tracker. Or select "Current Application" to search Maniphest in Maniphest, Diffusion in Diffusion etc.
 * Advanced, application specific search, for example at https://phabricator.wikimedia.org/maniphest/query/advanced/ for Maniphest. This one has more fields, and auto-completion that includes "Not in:..." (equivalent to NOT) and "In any:..." (equivalent to OR) (for example, type "echo" in the "Tags" field). There is also an advanced search for most other applications (e.g. file/query/advanced for Files). To only search for tasks / bug reports, use the Maniphest advanced search.

Inside Maniphest, custom, saved searches and advanced search options are listed in the navigation bar on the left.

Search terms
Special care needs to be put in choosing correct search terms.

Some locally-valid properties for the "Query" field:
 * Case insensitive:  is the same as
 * phrase search works:
 * basic tokenization is performed, e.g. to strip punctuation
 * Stemming is performed: "edited" is also found when searching for . However,   does not match   as quoted text does not stem.
 * Substring search is supported:  matches , but   does not.
 * matches  as quoted and substring-operator text uses substring search.
 * Boolean queries to exclude certain terms are possible by using the - symbol before the unwanted term. E.g. use  to exclude "non-fatal" errors from results.
 * To only search in a task title but not in the task description or comments, use  which is the same as  . To search for one term in the task title and other terms anywhere in a task, use   or  . See https://secure.phabricator.com/book/phabricator/article/search/ for more information.

The advanced search forms are not explicit about the logic but in general use AND between different fields. You can exclude specific projects from the results by entering  (equivalent to NOT) and combine several projects via   (equivalent to OR) via the auto-completion suggestions. There's a limit of 5 items in the maniphest autocomplete. To increase this limit, see these userscripts for Chrome and for Firefox.

Alternatives ways to find something
If you don't remember the exact words used in an item you are looking for you can follow one of these paths:
 * use the activity feed and edit the query to be restricted to certain projects or timeframes
 * use the activity feed to list all actions that you performed in a certain timeframe at feed/query/EW2FwdAi.Kfz/
 * use an external search engine;
 * remove all search terms, refine the search only by project etc. and then scan all the possible results manually or use Ctrl+F to search specific strings (this might require setting "Page Size" to a high value to display more than only 100 results);
 * file a new task, mentioning that a past report exists as well, and wait for someone to merge the new report to the old.

Selecting Dates and Date Ranges
This is only available in the Advanced Search.

Using the Date fields like "Created After" and "Created Before" allow entering absolute and relative dates. Note that Maniphest uses UTC.

To get a list of tasks which were created in the last 24 hours, set the "Created After" field to "-24 hours" or "-1 day". Note that "Updated Before" actually means "Last updated before" and that absolute date values like "2014-11-26" refer to UTC time while your time zone setting might be different. The "Updated After" and "Updated Before" fields return any and all changes to a task. For example, when a task is moved to another column in a board it registers as "updated". This may add noise to your search results.

Examples of how Maniphest interprets searches:
 * "02/25/2015" is interpreted as "00:01 on February 25th, 2015" (UTC)
 * "5 days ago" is interpreted as "00:01 on the fourth calendar day before today" (UTC)
 * "2:45 AM 5 days ago" is interpreted as "02:45 on the fourth calendar day before today" (UTC)

The "X days ago" range can be confusing. Phabricator interprets today as part of any data set. Even if it is 12:30 UTC, Phabricator will interpret that as a potential day in the range.

Saving and Managing Searches/Queries
Queries can be saved and managed inside Maniphest.

Maniphest offers links to some predefined search queries in the navigation bar on the left. For example, click authored to get a list of tasks that you have created.

Search query addresses (URL) are stable so you can save and reuse them. You can share the address in your web browser's address bar with other people, e.g. via posting the link on a wikipage.

If you want to save a search, select the "Save Query" button at the bottom of the Advanced Search UI.

When looking at the navigation bar on the left in Maniphest, click on the "Edit Queries…" link. You will see a list of your saved queries. All users have a default set which can be deleted in this UI.

Some options in this UI:
 * Use the line elements on the left to drag queries up and down in the list.
 * The "x" will permanently delete a Query.
 * The Pencil icon allows a user to edit the name of a query
 * Clicking on the name of a Query will bring up the search options and results of that query

Once you save a query, you cannot change its parameters, but you can change its name. To edit a query, click on it's name, change parameters and save it as a new query. Also, Phabricator allows users to save multiple queries with the same name.

To make the user name dynamic (e.g. for "Tasks assigned to the person running this query") in searches that you'd like to share with others, set "Current viewer".

Note that some common queries are also available in the "Activity" tabs on the Phabricator frontpage.

Finding the Maniphest task corresponding to a Bugzilla bug number
This is only available in the Advanced Search.

All Phabricator tasks migrated in 2014 from Bugzilla have a Reference field that contains a value "bz" followed by the number of the equivalent report in Bugzilla. If you want to search the task corresponding to a specific Bugzilla report, use the Reference field in the advanced search or just add 2000.

Використання панелей
Панелі — це спеціально створені домашні сторінки, де може відображатися різна вибрана інформація. Їх можна створювати, налаштовувати і ділитися ними з іншими користувачами.

Натисніть тут, щоб отримати детальний огляд панелі.

Пакетні редагування
Фабрикатор надає можливість робити масові/пакетні редагування завдань. У кінці кожного пошукового запиту Maniphest'у Ви знайдете посилання «Batch Edit Selected» на редагування усіх редагувань, які виберете натисканням з клавішею Shift. Користувачі, які хочуть користуватися цією функцією, мають приєднатися до групи оцінювачів (Triagers).

Batch editing can be reversed by noting the "Bulk Job" ID that is generated at the start of a Batch Edit. This can be accessed by clicking "Details" before or after executing. On the following page, there will be a "Continue" menu item to the right, which will generate a Maniphest query of all the affected tasks.

Favorites
The Star menu in the top navigation bar can be customized with links to your preferred forms and actions. See the Profile Menu instructions for more information.

Особисті списки елементів
Функціонал «Flag For Later» пропонує позначити об'єкти (як-то завдання або версії), які «Ви хочете запам'ятати проглянути пізніше». Доступні вісім кольорів прапорців. Прапорці особисті і приватні, тож Ваші списки інші не бачитимуть. Ваші позначені об'єкти перераховані на сторінці flag. Їх можна шукати за кольором чи типом об'єкта, на відміну від токенів.

Створення проекту


У Фабрикаторі проекти є теґами, теґи — проектами. Ієрархія через підпроекти доступна з лютого 2016. Завдання можуть бути приписані більш, ніж одному проекту, і також можуть бути подані без приписування жодному проекту.

Коли Вам треба проект?
В загальному, Вам треба проект…
 * коли у Вас є визначена команда, що працює над одним чи кількома проектами (почніть з цього, запитуйте більше, лише якщо Вам треба більше)
 * коли Вам треба робоча панель (тобто спринт)
 * коли Вам треба теґ чи ключове слово, щоб задати тип завдання, яке може бути частиною будь-якого проекту (наприклад, «Доступність»)

Запит на новий проект
Див. Фабрикатор/Запит на новий проект.

Обмеження доступу до завдань
Access to a specific task can be changed via "Edit Task" and then changing the "Visible To" field to something else than "Public".

Note that tasks filed as Security issues are not publicly visible. Будь ласка, див. загальний огляд і випадну функцію «Security» у завданнях на сторінці Фабрикатор/Безпека. Див. налаштування проектів за замовчуванням (і використання пробілів) на сторінці Фабрикатор/Створення і перейменування проектів#Правила.

Displaying and using a Space
''Spaces (upstream documentation) allow restricting access to groups of objects (like tasks) to members of a specific group only. See Restricting access via Space policies for setting up.''

If you can access at least two spaces, you see an additional Spaces dropdown under "Visible To" when creating and editing an object. Users with access to only one space will not see this control.

In Maniphest's task view, the Space will also be displayed in front of the task summary. You can batch-edit tasks to move them to a different Space.

Note that you will still have to associate the corresponding "public" project (if existing) to a task to make a task in a restricted Space (which you have access to) to show up in search queries and the workboard of the project. The "public" project could be automatically added via requesting a global Herald rule.

When creating tasks in Spaces, use the "Create Advanced Task" option in the "Create Task" dropdown. This option will display an additional Spaces dropdown under "Visible To" in the task creation UI that will allow you to set visibility to the Space for which this task should be visible.

If you instead create a task via the "Create Simple Task" option in the "Create Task" dropdown, then after you create it, you will have to edit the task to restrict visibility to members of the Space. Before this edit, the task will be visible to anyone and notifications about your task might have been sent to public logged IRC channels and other subscribed individuals.

Шаблони і посилання MediaWiki

 * Ви можете посилатися на завдання Фабрикатора з вікісторінок, використовуючи  та його коротшу версію , наприклад,   дає приклад.
 * Template:Tracked оновлено, щоб включати посилання на об'єкти Фабрикатора — див. справа, як виводиться введене.
 * Template:Phabricator також доступний;  дає.

Наявні посилання і шаблони на Баґзіллу далі працюватимуть, тому що ці посилання продовжують вказувати на bugzilla.wikimedia.org, який перенаправляє їх на конвертовані завдання Фабрикатора.

Використання Conpherence
Conpherence — це аплікація Фабрикатора, яка дозволяє приватні розмови між двома і більше користувачами, подібно до миттєвих повідомлень і приватних кімнат чату. Жодна команда цього не використовує. Воно може конфліктувати з іншими каналами комунікації. Щоб дізнатися більше, натисніть тут.

Conpherence має необов'язкове постійне вікно/колонку, яку можна показати і приховати клавішею «\». Користувачі можуть випадково активувати цю функцію, і назад її можна приховати клавішею «\» (графічного інтерфейсу для її приховання нема).

Статистика
Фабрикатор пропонує таблиці, які показують відкриті завдання за пріоритетом і за користувачем або проектом. Окрім цього, Фабрикатор не підтримує подальшої статистики, метрики, діаграм, звітів (наприклад, за період часу) чи чогось такого, ні вбудованих, ні через API. Phragile and Phlogiston are further reporting tool options for Phabricator.

Diffusion


Diffusion — це браузер репозиторія Фабрикатора та інструмент керування репозиторієм. Кінець кінцем ми хочемо замінити Gerrit для вичитки коду і керування репозиторієм і gitblit для віддзеркалення репозиторія в режимі «тільки читання». Прямо зараз, ми дублюємо деякі свої репозиторії Git на Фабрикатор з метою демонстрації.

To request and set up a new code repository, see Gerrit/New repositories/Requests.

Default fields (Forms)


Phabricator allows some customization of the fields shown for a given task. These are handled via the Forms feature.

API (Conduit)
Conduit is the name of the web API. https://phabricator.wikimedia.org/conduit/ offers some explanation and examples. See the Conduit upstream documentation. Also see Phabricator/Bots.

Інші посилання

 * Інші
 * phabricator-production, споживач OAuth, використовуйте Special:OAuthManageMyGrants для керування під'єднаними програмками
 * Етикет Фабрикатора