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

From KDE Wiki Sandbox
(Importing a new version from external source)
No edit summary
 
(27 intermediate revisions by 2 users not shown)
Line 7: Line 7:
=== Налаштовування редактора ===
=== Налаштовування редактора ===


There are a number of useful things one can configure in and around '''KDevelop's''' built-in editor. Of more universal use is to switch on line numbering using the menu entry <menuchoice>Editor -> View -> Show line numbers</menuchoice>, making it easier to match compiler error messages or debug messages with locations in the code. In the same submenu you may also want to switch on the ''Icon border'' - a column to the left of your code in which '''KDevelop''' will show icons such as whether there is a breakpoint on the current line.
Корисно налаштувати вбудований редактор та інші компоненти '''KDevelop'''. Однією з загальних речей є вмикання показу нумерації рядків за допомогою пункту меню <menuchoice>Параметри -> Налаштувати KDevelop</menuchoice>, який відкриває діалогове вікно зміни параметрів роботи '''KDevelop'''. Якщо вибрати пункт меню <menuchoice>Редактор -> Вигляд</menuchoice>, а потім перейти на вкладку <menuchoice>Межі</menuchoice>, ви зможете позначити пункт  <menuchoice>Показати номери рядків</menuchoice>. У такому режимі простіше буде визначати рядки з помилками під час компіляції або визначати відповідність діагностичних повідомлень позиціям у коді. У тому ж підменю ви можете увімкнути "Рамку для піктограм" — стовпчик у лівій частині панелі редактора, у якому '''KDevelop''' показуватиме піктограми, зокрема позначок точок зупину у рядках.


=== Customizing code indentation ===
[[File:Kdevelop-borders-settings.png|550px|thumb|center]]


Many of us like code formatted in a particular way. Many projects also enforce a particular indentation style. Neither may match '''KDevelop's''' default indentation style. However, this can be customized: Go to the <menuchoice>Settings -> Customize KDevelop</menuchoice> menu item, then click on <menuchoice>Source Formatter</menuchoice> on the left. You can choose one of the predefined indentation styles that are widely in use, or define your own one by adding a new style and then editing it. There may not be a way to exactly re-create the style in which your project's sources have been indented in the past, but you can come close by using the settings for a new style; an example is shown in the two pictures below.
=== Налаштовування відступів у коді ===
 
У кожного з нас є певні уподобання щодо форматування коду. У багатьох проектах є власні правила щодо відступів у коді. Ці правила можуть не відповідають правилам встановлення відступів '''KDevelop'''. Ви можете просто змінити правила відступів: скористайтеся пунктом меню <menuchoice>Параметри -> Налаштувати KDevelop</menuchoice>. Перейдіть на сторінку <menuchoice>Форматування коду</menuchoice> за допомогою списку ліворуч. Ви можете вибрати один з попередньо визначених розповсюджених типів форматування або визначити власний стиль додаванням нового стилю з наступним його редагуванням. Можливо, повністю відтворити стиль форматування коду вашого проекту у минулому не вдасться, але ви можете гранично до нього наблизитися за допомогою параметрів нового стилю. Приклад наведено на двох зображеннях нижче.


{|class="tablecenter"
{|class="tablecenter"
Line 18: Line 20:
|}
|}


{{Note|1= With '''KDevelop 4.2.2''', you can create a new style for a particular mimetype (e.g. for C++ header files) but this style does not show up among the list of possible styles for other mimetypes (e.g. for C++ source files) although it would of course be useful to use the same style for both kinds of files. You will therefore have to define the style twice, once for header and once for source files. This has been reported as [https://bugs.kde.org/show_bug.cgi?id=272335 KDevelop bug 272335].}}
{{Note_(uk)|1=У '''KDevelop''' 4.2.2 ви можете створити стиль для файлів окремого типу MIME (наприклад, для стилю файлів заголовків C++), але цей стиль не буде показано у списку можливих стилів для файлів інших типів MIME (наприклад, для коду файлів C++), хоча, звичайно ж, було б корисно використати цей тип для обох типів файлів. Тому вам доведеться визначати стиль двічі: один раз для файлів заголовків і один раз для файлів коду. Про цю ваду було повідомлено розробникам, [https://bugs.kde.org/show_bug.cgi?id=272335 KDevelop, вада 272335].}}
 


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


'''KDevelop''' has an almost boundless list of keyboard shortcuts (some of them are listed in the "Useful keyboard shortcuts sections" of several chapters in this manual) that can be changed to your taste through the menu <menuchoice>Settings -> Configure Shortcuts</menuchoice>. At the top of the dialog you can enter a searchword and it only shows those commands that match; you can then edit which key combination is bound to this command.  
У '''KDevelop''' передбачено майже безмежний список клавіатурних скорочень (деякі з них можна знайти у списках «Корисні клавіатурні скорочення» у декількох частинах цього підручника). Ці клавіатурні скорочення можна змінити за вашими потребами за допомогою пункту меню <menuchoice>Параметри -> Налаштувати скорочення</menuchoice>. У верхній частині діалогового вікна ви можете вказати ключ пошуку, щоб переглянути лише відповідні ключу скорочення. Після цього ви можете змінити клавіатурні скорочення для бажаних команд.  


Two that have been found to be very useful to change are to set <menuchoice>Align</menuchoice> to the <keycap>Tab</keycap> key (many people don't usually enter tabs by hand and rather prefer if the editor chooses the layout of code; with the changed shortcut, hitting <keycap>Tab</keycap> makes '''KDevelop''' indent/outdent/align the code). The second one is putting <menuchoice>Toggle Breakpoint</menuchoice> on <keycap>Ctrl + B</keycap> since this is quite a frequent operation.
Однією з двох корисних змін буде встановлення для <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]]
[[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]]
[[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
{{Prevnext2
| prevpage=Special:MyLanguage/KDevelop5/Manual/Working_with_version_control_systems | nextpage=Special:MyLanguage/KDevelop5/Manual/Appendix A: Building KDevelop from Sources
| 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]]

Latest revision as of 09:36, 17 July 2020

Other languages:

Налаштовування 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+Пробіл)
  • Завжди: завжди показувати «повне доповнення».