KDevelop5/Manual/Customizing KDevelop/uk: Difference between revisions

Latest revision as of 09:36, 17 July 2020

Налаштовування KDevelop

Іноді корисно змінити типовий вигляд або спосіб роботи KDevelop, наприклад, ви звикли до інших клавіатурних скорочень або у вашому проекті використовується інші відступи у коді. У наступних розділах ми коротко обговоримо різні способи налаштування KDevelop відповідно до ваших потреб.

Налаштовування редактора

Корисно налаштувати вбудований редактор та інші компоненти KDevelop. Однією з загальних речей є вмикання показу нумерації рядків за допомогою пункту меню Параметри -> Налаштувати KDevelop, який відкриває діалогове вікно зміни параметрів роботи KDevelop. Якщо вибрати пункт меню Редактор -> Вигляд, а потім перейти на вкладку Межі, ви зможете позначити пункт Показати номери рядків. У такому режимі простіше буде визначати рядки з помилками під час компіляції або визначати відповідність діагностичних повідомлень позиціям у коді. У тому ж підменю ви можете увімкнути "Рамку для піктограм" — стовпчик у лівій частині панелі редактора, у якому KDevelop показуватиме піктограми, зокрема позначок точок зупину у рядках.

Налаштовування відступів у коді

У кожного з нас є певні уподобання щодо форматування коду. У багатьох проектах є власні правила щодо відступів у коді. Ці правила можуть не відповідають правилам встановлення відступів KDevelop. Ви можете просто змінити правила відступів: скористайтеся пунктом меню Параметри -> Налаштувати KDevelop. Перейдіть на сторінку Форматування коду за допомогою списку ліворуч. Ви можете вибрати один з попередньо визначених розповсюджених типів форматування або визначити власний стиль додаванням нового стилю з наступним його редагуванням. Можливо, повністю відтворити стиль форматування коду вашого проекту у минулому не вдасться, але ви можете гранично до нього наблизитися за допомогою параметрів нового стилю. Приклад наведено на двох зображеннях нижче.

Зауваження

У KDevelop 4.2.2 ви можете створити стиль для файлів окремого типу MIME (наприклад, для стилю файлів заголовків C++), але цей стиль не буде показано у списку можливих стилів для файлів інших типів MIME (наприклад, для коду файлів C++), хоча, звичайно ж, було б корисно використати цей тип для обох типів файлів. Тому вам доведеться визначати стиль двічі: один раз для файлів заголовків і один раз для файлів коду. Про цю ваду було повідомлено розробникам, KDevelop, вада 272335.

Налаштовування клавіатурних скорочень

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

Однією з двох корисних змін буде встановлення для Вирівняти скорочення Tab (багато хто звичайно не додає табуляції вручну і віддає перевагу вибору форматування коду редактором; якщо скорочення буде змінено, після натискання Tab KDevelop виконає додавання відступів, вилучення відступів або вирівнювання коду). Другою зміною буде встановлення для команди Встановити/зняти точку зупину скорочення Ctrl+B, оскільки встановлення або зняття точки зупину є доволі поширеною дією.

Налаштування автодоповнення коду

Можливості з автоматичного доповнення коду було обговорено у цьому розділі підручника, присвяченому створенню коду. У KDevelop автоматичне доповнення відбувається з двох джерел: редактора і рушія обробки. Редактор (Kate) є компонентом більшого середовища KDE, він пропонує доповнення на основі інших частин того самого документа. Таке автоматичне доповнення можна впізнати на панелі підказки за піктограмою, вказаною перед відповідним варіантом:

Автоматичне доповнення коду редактором можна налаштувати за допомогою пункту меню Параметри -> Налаштувати KDevelop -> Редактор -> Редагування -> Автозавершення. Зокрема, ви можете визначити кількість символів, які має бути введено у слові для вмикання механізмів автоматичного доповнення.

З іншого боку, автоматичне доповнення самої програми KDevelop є набагато потужнішим, оскільки у ньому використано семантичні дані щодо контексту слова. Наприклад, середовище пропонує лише ті функції для коду object., які використано у відповідному об’єкті тощо. Ось приклад:

Дані щодо контексту надходять з декількох додатків підтримки мов програмування, якими можна скористатися після того, як файл буде збережено (середовище визначить мову програмування за типом збереженого файла). Автоматичне доповнення KDevelop працюватиме під час введення вами коду майже всюди, де таке автоматичне доповнення можливе. Налаштувати механізм доповнення можна за допомогою пункту меню Параметри -> Налаштувати KDevelop -> Підтримка мов. Якщо пункт Увімкнути автоматичний виклик ще не позначено (його має бути типово позначено), позначте його.

У KDevelop передбачено два способи показу доповнення: у режимі Якщо викликано вручну середовище показує на панелі підказки лише основні дані (тобто простір назв, клас, функцію або назву змінної). Таке доповнення подібне до доповнення у Kate (окрім піктограми). У режимі Завжди середовище додатково показує тип кожного запису та, у разі якщо доповнюється функція, перелік аргументів. Крім того, якщо ви заповнюєте аргументи функції, у режимі повного доповнення буде показано додаткову інформаційну панель над курсором, де буде наведено дані щодо поточного аргументу. У режимі автоматичного доповнення коду у KDevelop також має бути наведено у верхній частині списку та підсвічено зеленим всі пункти доповнення, які відповідають поточному очікуваному типу (найкращі відповідники) у режимах мінімального та повного доповнення.

У діалоговому вікні налаштування передбачено три варіанти рівня автоматичного доповнення:

Ніколи: ніколи не показувати «повного доповнення».

Якщо викликано вручну: показувати «повне доповнення», якщо автоматичне доповнення було викликано вручну (тобто було натиснуто Ctrl+Пробіл)

Завжди: завжди показувати «повне доповнення».

@@ Line 7: / Line 7: @@
 === Налаштовування редактора ===
-Корисно налаштувати вбудований редактор та інші компоненти '''KDevelop'''. Однією з загальних речей є вмикання показу нумерації рядків за допомогою пункту меню <menuchoice>Редактор -> Перегляд -> Показати номери рядків</menuchoice>. У такому режимі простіше буде визначати рядки з помилками під час компіляції або визначати відповідність діагностичних повідомлень позиціям у коді. У тому ж підменю ви можете увімкнути "Рамку для піктограм" — стовпчик у лівій частині панелі редактора, у якому '''KDevelop''' показуватиме піктограми, зокрема позначок точок зупину у рядках.
+Корисно налаштувати вбудований редактор та інші компоненти '''KDevelop'''. Однією з загальних речей є вмикання показу нумерації рядків за допомогою пункту меню <menuchoice>Параметри -> Налаштувати KDevelop</menuchoice>, який відкриває діалогове вікно зміни параметрів роботи '''KDevelop'''. Якщо вибрати пункт меню <menuchoice>Редактор -> Вигляд</menuchoice>, а потім перейти на вкладку <menuchoice>Межі</menuchoice>, ви зможете позначити пункт  <menuchoice>Показати номери рядків</menuchoice>. У такому режимі простіше буде визначати рядки з помилками під час компіляції або визначати відповідність діагностичних повідомлень позиціям у коді. У тому ж підменю ви можете увімкнути "Рамку для піктограм" — стовпчик у лівій частині панелі редактора, у якому '''KDevelop''' показуватиме піктограми, зокрема позначок точок зупину у рядках.
+[[File:Kdevelop-borders-settings.png|550px|thumb|center]]
 === Налаштовування відступів у коді ===
@@ Line 19: / Line 21: @@
 {{Note_(uk)|1=У '''KDevelop''' 4.2.2 ви можете створити стиль для файлів окремого типу MIME (наприклад, для стилю файлів заголовків C++), але цей стиль не буде показано у списку можливих стилів для файлів інших типів MIME (наприклад, для коду файлів C++), хоча, звичайно ж, було б корисно використати цей тип для обох типів файлів. Тому вам доведеться визначати стиль двічі: один раз для файлів заголовків і один раз для файлів коду. Про цю ваду було повідомлено розробникам, [https://bugs.kde.org/show_bug.cgi?id=272335 KDevelop, вада 272335].}}
 === Налаштовування клавіатурних скорочень ===
@@ Line 27: / Line 28: @@
 Однією з двох корисних змін буде встановлення для <menuchoice>Вирівняти</menuchoice> скорочення <keycap>Tab</keycap> (багато хто звичайно не додає табуляції вручну і віддає перевагу вибору форматування коду редактором; якщо скорочення буде змінено, після натискання <keycap>Tab</keycap> '''KDevelop''' виконає додавання відступів, вилучення відступів або вирівнювання коду). Другою зміною буде встановлення для команди <menuchoice>Встановити/зняти точку зупину</menuchoice> скорочення <keycap>Ctrl+B</keycap>, оскільки встановлення або зняття точки зупину є доволі поширеною дією.
-=== Customizing code auto-completion ===
+=== Налаштування автодоповнення коду ===
-Code completion is discussed in [[KDevelop5/Manual/Working_with_source_code#Auto-completion|this manual's section on writing source code]]. In '''KDevelop''', it comes from two sources: the editor, and the parse engine. The editor ('''Kate''') is a component of the larger KDE environment and offers auto-completion based on words it has already seen in other parts of the same document. Such auto-completions can be identified in the tooltip by the icon that precedes it:
+Можливості з автоматичного доповнення коду було обговорено у [[KDevelop5/Manual/Working_with_source_code#Auto-completion|цьому розділі підручника, присвяченому створенню коду]]. У '''KDevelop''' автоматичне доповнення відбувається з двох джерел: редактора і рушія обробки. Редактор ('''Kate''') є компонентом більшого середовища KDE, він пропонує доповнення на основі інших частин того самого документа. Таке автоматичне доповнення можна впізнати на панелі підказки за піктограмою, вказаною перед відповідним варіантом:
 [[Image:kdevelop-20.png|thumb|500px|center]]
-The editor's code completion can be customized via <menuchoice>Settings -> Configure Editor -> Editing -> Auto Completion</menuchoice>. In particular, you can select how many characters you need to type in a word before auto-completion kicks in.
+Автоматичне доповнення коду редактором можна налаштувати за допомогою пункту меню <menuchoice>Параметри -> Налаштувати KDevelop -> Редактор -> Редагування -> Автозавершення</menuchoice>. Зокрема, ви можете визначити кількість символів, які має бути введено у слові для вмикання механізмів автоматичного доповнення.
-On the other hand, '''KDevelop's''' own auto-completion is much more powerful as it takes into account semantic information about the context. For example, it knows which member functions to offer when you type <code>object.</code>, etc., as shown here:
+З іншого боку, автоматичне доповнення самої програми '''KDevelop''' є набагато потужнішим, оскільки у ньому використано семантичні дані щодо контексту слова. Наприклад, середовище пропонує лише ті функції для коду <code>object.</code>, які використано у відповідному об’єкті тощо. Ось приклад:
 [[Image:kdevelop-42.png|thumb|500px|center]]
-This context information comes from various language support plugins, which
+Дані щодо контексту надходять з декількох додатків підтримки мов програмування, якими можна скористатися після того, як файл буде збережено (середовище визначить мову програмування за типом збереженого файла). Автоматичне доповнення '''KDevelop''' працюватиме під час введення вами коду майже всюди, де таке автоматичне доповнення можливе. Налаштувати механізм доповнення можна за допомогою пункту меню <menuchoice>Параметри -> Налаштувати KDevelop -> Підтримка мов</menuchoice>. Якщо пункт <menuchoice>Увімкнути автоматичний виклик</menuchoice> ще не позначено (його має бути типово позначено), позначте його.
-can be used after a given file has been saved (so it can check the
-filetype and use the correct language support).
-'''KDevelop's''' completion is set to appear as you type, right away, pretty
-much everywhere that it could possibly complete something. This is
-configurable in <menuchoice>Settings -> Configure KDevelop -> Language Support</menuchoice>. If it isn't already set (as it should, by default),
-make sure <menuchoice>Enable Automatic Invocation</menuchoice> is set.
-'''KDevelop''' has two ways to show a completion: <menuchoice>Minimal Automatic
+У '''KDevelop''' передбачено два способи показу доповнення: у режимі <menuchoice>Якщо викликано вручну</menuchoice> середовище показує на панелі підказки лише основні дані (тобто простір назв, клас, функцію або назву змінної). Таке доповнення подібне до доповнення у '''Kate''' (окрім піктограми). У режимі <menuchoice>Завжди</menuchoice> середовище додатково показує тип кожного запису та, у разі якщо доповнюється функція, перелік аргументів. Крім того, якщо ви заповнюєте аргументи функції, у режимі повного доповнення буде показано додаткову інформаційну панель над курсором, де буде наведено дані щодо поточного аргументу. У режимі автоматичного доповнення коду у '''KDevelop''' також має бути наведено у верхній частині списку та підсвічено зеленим всі пункти доповнення, які відповідають поточному очікуваному типу (найкращі відповідники) у режимах мінімального та повного доповнення.
-Completion</menuchoice> shows just the basic information in completion tooltips (i.e. the namespace, class, function, or variable name). This will look similar to '''Kate''' completion (except for the icons).
-On the other hand, <menuchoice>Full completion</menuchoice> will additionally show the type for each entry,
-and in the case of functions, also the arguments they take. Also,
-if you are currently filling in the arguments to a function, full
-completion will have an additional info-box above the cursor that will
-show you the current argument you are working on.
-'''KDevelop's''' code completion should also bring-to-top and highlight in
-green any completion items that match the currently expected type in
-both minimal and full completion, known as "best-matches".
-The three possible choices for the completion level in the configuration dialog are:
+У діалоговому вікні налаштування передбачено три варіанти рівня автоматичного доповнення:
-* <menuchoice>Always minimal completion</menuchoice>: Never show "Full Completion"
+* <menuchoice>Ніколи</menuchoice>: ніколи не показувати «повного доповнення».
-* <menuchoice>Minimal automatic completion</menuchoice>: Only show "Full Completion" when auto-completion has been triggered manually (i.e., whenever you hit <keycap>Ctrl+Space</keycap>)
+* <menuchoice>Якщо викликано вручну</menuchoice>: показувати «повне доповнення», якщо автоматичне доповнення було викликано вручну (тобто було натиснуто <keycap>Ctrl+Пробіл</keycap>)
-* <menuchoice>Always full completion</menuchoice>: Always show "Full Completion"
+* <menuchoice>Завжди</menuchoice>: завжди показувати «повне доповнення».
 {{Prevnext2
 | prevpage=Special:MyLanguage/KDevelop5/Manual/Working_with_version_control_systems | nextpage=Special:MyLanguage/KDevelop5/Manual/Appendix A: Building KDevelop from Sources
-| prevtext=Working with version control systems | nexttext=Appendix A: Building KDevelop from Sources
+| prevtext=Робота з системами керування версіями | nexttext=Додаток. Збирання KDevelop з початкового коду
-| index=Special:MyLanguage/KDevelop5/Manual | indextext=Back to menu
+| index=Special:MyLanguage/KDevelop5/Manual | indextext=Повернутися до меню
 }}
-[[Category:Development]]
+[[Category:Розробка/uk]]