Bernd
Pol

# Настройка &kdevelop;

&kdevelop; - очень мощная и гибкая IDE, что позволяет легко подстроить её под себя. Для этого перейдите в Настройка Настроить KDevelop.... Из этого диалога производится большая часть настройки.

Вкладки окна настроек

Мы будет описывать вкладки диалога конфигурации в порядке, отличном от их расположения в программе, собрав их в несколько общих тем — Общая настройка, Настройка документации и Расширенная настройка.

Если вы хотите сразу перейти к описанию конкретной вкладки конфигурации, воспользуйтесь следующими ссылками.

- Общие
- Модули
- Форматировщик кода
- Мастер создания файлов
- Пользовательский интерфейс
- Редактор
- Сокращения
- Сервис
- Внешние инструменты
- Дерево документации
- Наработки
- Выбор файлов

## Общая настройка

Здесь описываются наиболее распространённые действия по настройке &kdevelop;, а именно:

- Общая настройка

- Выбор пользовательского интерфейса

- Редактирование исходного кода

  - Выбор редактора

  - Выбор стиля форматирования кода

  - Настройка хранилища наработок кода

- Настройка инструмента выбора файлов

### Общая настройка

Вкладка Общие предлагает настроить основные нюансы поведения &kdevelop;:

- Параметры проекта, а именно

  - определение родительского каталога по умолчанию, в котором будут создаваться новые проекты.

  - загружать ли автоматически последний открытый проект при запуске &kdevelop;.

- Выбор шрифта для окон с выводом:

  - Окно сообщений, используемое для связи с компиляцией, и

  - Окно вывода приложения, в котором могут отображаться ошибки из stderr.

- Некоторые общие параметры отображения в окне Messages Output View:

  - переносить ли длинные строки

  - отображать ли сообщения о смене каталогов и конечные сообщения команды `Make`.

- уровень детализации сообщений компилятора.

Вкладка Общие

#### Загружать последний открытый проект при запуске

Открывать при запуске проект, с которым вы работали в предыдущий раз. Обычно восстанавливается также и его состояние (набор открытых окон с исходными кодами, панелями инструментов и т.д.).

#### Каталог с проектами по умолчанию

Здесь вы можете выбрать родительский каталог, предлагаемый по умолчанию для всех вновь созданных проектов.

Тем не менее, вы всегда сможете поменять его для создаваемого проекта в Мастере приложений.

#### Шрифт окна сообщений

Нажмите кнопку Шрифт окна, содержащую текущий шрифт (на снимке экрана выше это Luxi Sans).

При первом запуске &kdevelop; берёт настройки шрифтов из &kde;-конфигурации пользователя. Если вы позже измените эти настройки шрифтов, это никак не отразится в &kdevelop;, т.е. вам нужно будет также самостоятельно изменить шрифт в нём.

#### Перенос строк

Если вам не нравится что строки переносятся, отключите этот параметр.

Это также можно сделать через контекстное меню окна сообщений.

#### Сообщения о смене каталога

Программа `Make` обычно выводит сообщения типа Вход в каталог (Entering directory) и Выход из каталога (Leaving directory). Чтобы абстрагироваться от этого, &kdevelop; фильтрует их.

Изменение этого параметра ничего не сделает с уже полученными сообщениями.

#### Вывод компилятора

&kdevelop; фильтрует выводимые сообщения. Здесь вы можете изменить уровень такой фильтрации.

Очень краткий

  Только предупреждения, ошибки и имена компилируемых файлов.

Краткий

  Преобразует все опции компилятора и форматы в более читабельную форму.

Полный

  Не изменять вывод компилятора.

Это также можно сделать через контекстное меню.

#### Шрифт окна вывода приложения

Окно вывода приложения используется для отображения информации об ошибках и состоянии приложений, запущенных из &kdevelop;.

Нажмите кнопку Шрифт окна, содержащую текущий шрифт (на снимке экрана выше это Luxi Sans).

При первом запуске &kdevelop; берёт настройки шрифтов из &kde;-конфигурации пользователя. Если вы позже измените эти настройки шрифтов, это никак не отразится в &kdevelop;, т.е. вам нужно будет также самостоятельно изменить шрифт в нём.

### Выбор пользовательского интерфейса

Как уже было сказано выше, в &kdevelop; есть 4 режима рабочей области:

- Режим IDEAl

- Дочерние окна

- Вкладки

- Отдельные окна

Чтобы переключить режим интерфейса, выберите меню Настройка Настроить KDevelop... . В появившемся диалоге выберите вкладку Пользовательский интерфейс. При этом справа будут следующие параметры.

Выбор режима интерфейса

Выберите режим и нажмите OK.

Для вступления изменений в силу нужно перезапустить &kdevelop;.

При выборе режима IDEAl или Вкладки станут доступны ещё два раздела настроек: Использовать вкладки и Кнопка закрытия.

Также в режиме IDEAl будет доступен ещё один раздел, Вкладки инструментов, в котором можно менять размер вкладок инструментов (они расположены по бокам главного окна).

#### Настройка вкладки документации

В режиме вкладок и IDEAl, в верхней части главного окна появятся вкладки, с помощью которых можно переключаться между открытыми документами. Если вы хотите получить больше свободного рабочего пространства, вы можете "поиграться" с настройками в разделе Вкладки.

Всегда

  По умолчанию — отображать вкладку со значком и именем файла вверху рабочей области &kdevelop;.

Только когда открыто несколько файлов

  Скрывать панель вкладок если открыт только один файл.

Никогда

  Полезно если вы редко используете мышь для переключения между открытыми файлами. По умолчанию, для этого есть комбинация клавиш - Alt Стрелка, а мышью это также можно сделать через меню Окно.

#### Настройка закрытия файла щелчком по его вкладке

Вы можете расширить функциональность вкладок с помощью пункта Кнопка закрытия при наведении.

Нет

  Стандартное поведение. Вкладки используются только для переключения на файл, который они представляют.

Да

  Отображать в левом краю вкладок кнопку их закрытия после наведения курсора.

Да, с задержкой

  Если задержать курсор на значке на несколько секунд, он превратится в кнопку закрытия. Это позволяет предотвратить случайные закрытия документа при попытке переключиться на него.

#### Настройка вкладок инструментов

Раздел Вкладки инструментов доступен только в режиме IDEAl.

Значки

  На вкладках будет отображаться только значок соответствующего инструмента, а на активной также описание в виде текста.

  Если вы хотите узнать, что за инструмент скрывается за значком, наведите на его вкладку курсор и через некоторое время появится подсказка с именем инструмента.

Текст

  Отображать имя инструмента, по умолчанию.

Текст и значки

  По желанию, особенно если вы работаете с высоким разрешением экрана, вы можете выбрать этот пункт. Именна этот параметр включен на снимке экрана в разделе Сложные вкладки.

#### Сложные вкладки

Если в режиме IDEAl вкладки инструментов содержат текст (или текст со значками) и они перекрываются развёрнутой нижней вкладкой (например, отображающей сообщения компилятора), то они будут автоматически сложены:

Вкладки инструментов складываются чтобы не перекрываться другими элементами

Активная вкладка инструментов должна быть зафиксирована (режим неперекрываемости), разделяя рабочую область с другими элементами, для такого сложения. Нажмите маленький квадратик на границе окна для такой фиксации.

### Выбор редактора

В &kdevelop; вы можете использовать свой любимый редактор. Перейдите на вкладку Редактор окна конфигурации KDevelop. Справа будут отображены следующие параметры:

Выберите редактор

Если &kde; настроен правильно, вы сможете выбрать один из доступных компонентов-редакторов:

Встроенный текстовый редактор

  Это стандартный Kateкомпонент &kde;.

Встроенный Vim Component

  Имеет стиль базового редактора Linux vi.

  - Если этот пункт отсутствует, вам нужно установить Vim. Для подробностей см. .

  - Кроем того нужно будет настроить KParts Vim в Центре управления перед его использованием.

Редактор из Qt Designer

  Этот редактор поставляется Qt с компонентом Designer.

Все редакторы хорошо интегрированы с &kdevelop;., например вы всегда сможете перейти к строке, содержащей ошибку, щёлкнув по соответствующему сообщению об ошибке.

Смена редактора никак не повлияет на открытые файлы. Чтобы продолжить редактирования в новом редакторе, вы можете заново открыть все файлы, или же просто заново открыть весь проект.

Вы можете использовать любой редактор, зарегистрированный в &kde; и поддерживающий интерфейс KatePart.

### Выбор стиля оформления

&kdevelop; автоматически форматирует текст в выбранном стиле.

На данный момент, поддерживаются C, C++ и &Java;. &kdevelop; использует для этого astyle.

&kdevelop; автоматически форматирует текст в выбранном стиле. Чтобы поменять его, перейдите на вкладку Форматировщик кода диалога конфигурации. Здесь вы можете настроить общий стиль оформления, a расстановку отступов и другое.

Изменение стиля влияет только на вновь вводимый текст. Если вы хотите изменить оформление старого кода, воспользуйтесь меню Правка Форматировать код.

Результат этих определений стиля зависит от редактора используемого вами. На данный момент, большинство параметров подстроено под Kate KPart (Встроенный текстовый редактор). Некоторые другие редакторы (например редактор Qt) могут не(правильно) поддерживать часть параметров. Поэтому вам придётся поэкспериментировать с ними.

Также могут быть несовместимости между настройками оформления и нестандартным редактором, что в редких случаях может привести с порче файлов. Мы рекомендуем создать резервные копии перед проверкой новых настроек оформления с таким редактором.

#### Общая настройка форматировщика

Вкладка Общие диалога Форматировщик кода предлагает пять предустановленных стилей оформления.

Общая настройка стиля форматирования

При выборе стиля справа будет отображён пример исходного кода в этом стиле. Если вам не понравился ни один из перечисленных стилей, выберите Определяемый пользователем и установите все параметры самостоятельно на других двух вкладках.

В настоящее время, выдаётся пример оформления только для предустановленных стилей.

#### Стиль расстановки переносов

Правильная расстановка переносов - главный критерий удобочитаемости исходного кода. Вкладка Отступы диалога Форматирование кода содержит набор параметров расстановки переносов, сгруппированных в три категории.

Настройка стиля расстановки отступов

##### Параметры по умолчанию

По умолчанию используется ANSI-стиль:

    namespace foospace
    {
      int Foo()
      {
        if (isBar)
        {
          bar();
          return 1;
        }
        else
          return 0;
      }
    }

##### Установка размера отступов

Группа Заполнение определяет символы, которые будут использоваться для расстановки отступов.

Использовать табуляцию

  Вставлять символ табуляции для каждого уровня. Длина табуляции определена в настройках редактора (обычно 8 или 4). Настройка Настроить редактор... для изменения этого.

  Определение длины табуляции зависит от выбранного редактора.

Использовать пробелы

  Вставлять некоторое число пробелов для каждого уровня.

##### Требующие отступов конструкции

К каким объектам будут применяться настройки отступов.

По умолчанию это только пространства имён (namespace) и метки (label).

##### Переносы и продолжение строк

Эти настройки отвечают за те случаи, когда форматировщик кода автоматически переносит длинные строки. Это - слишком большой размер отступа на глубоких уровнях, и условные операторы, получающие дополнительный отступ.

Это применяется к статическому переносу слов только при превышении лимита ширины строки. Если ваш редактор настроен на динамический перенос слов (т.е. только при отображении) вы не увидите эффекта этих настроек.

Максимум в выражении

  Ограничить размер отступа для длинных строк, чтобы оставить достаточно места для сохранения удобочитаемости текста.

  Значение по умолчанию - 40 символов (половина стандартной страницы). Возможно вы захотите увеличить это значение для более широкой страницы.

Минимум в условном операторе:

  Условные операторы или код, следующий, например, за оператором присваивания должны получать дополнительный отступ в длинных строках. Его величину можно указать здесь.

  Значение по умолчанию - В два раза больше текущего, последний можно указать в группе Заполнение.

#### Другие настройки форматирования

Другие настройки стиля форматирования кода

##### Расположение скобок

Группа Скобки определяет позиционирование разделителей блоков в коде C/C++.

Оторвать

  Вставить символ новой строки перед каждой открывающей (фигурной) скобкой. Обе скобки будут иметь одинаковый с заголовком блока отступ.

      namespace foospace
      {
        int Foo()
        {
          if (isBar)
          {
            bar();
            return 1;
          }
          else
            return 0;
        }
      }

Присоединить

  Оставить открывающую скобку на одной строке с заголовком блока. Закрывающие скобки будут иметь отступ одинаковый с заголовком блока. Слово else выражения if будет оставлено на одной строке с закрывающей скобкой.

      namespace foospace {
        int Foo() {
          if (isBar) {
            bar();
            return 1;
          } else
            return 0;
        }
      }

Стиль Linux

  Это совмещение описанных выше стилей. Скобки, отделяющие блок функции будут переводиться на новую строку, а скобки, открывающие блок условного выражения или цикла, будут оставлены на той же строке.

      namespace foospace
      {
        int Foo()
        {
          if (isBar) {
            bar();
            return 1;
          } else
            return 0;
        }
      }

##### Дополнительные пробелы

По умолчанию, &kdevelop; стремится к уменьшению количества пробелов, использующихся в коде.

    if (isBar(fooArg)==barValue)

Здесь можно вставлять дополнительные пробелы, которые (возможно) повысят удобочитаемость кода.

Добавить пробелы около круглых скобок

  На самом деле пробелы будут ставиться вокруг текста, заключённого в скобки.

      if ( isBar( fooArg )==barValue )

Добавить пробелы около операторов

  Вставлять пробелы вокруг операторов присваивания и сравнения.

      if (isBar(fooArg) == barValue)

##### Форматирование однострочных конструкций

В некоторых случаях форматирование кода излишне. Для C/C++ вы можете настроить это здесь.

Сохранять однострочные выражения

  Не трогать однострочные выражения даже если они превышают ограничение длины стоки.

Сохранять однострочные блоки

  Не трогать однострочные блоки даже если они превышают ограничение длины стоки.

### Настройка инструмента заготовок кода

При работе с &kdevelop; вы можете сохранять часто используемые участки кода в виде заготовок. Чтобы настроить модуль заготовок, перейдите в Настройка Настроить KDevelop..., на вкладку Code Snippets.

Настройка инструмента заготовок кода

#### Предпросмотр заготовок

Отметьте Show snippet's text in tooltip для быстрого просмотра заготовки при наведении на него курсора.

#### Переменные в заготовках

Инструмент Code Snippets поддерживает переменные. Настройки, связанные с ними, можно поменять в группе Variables.

Delimiter

  Имена переменных должны разделяться специальными символом. По умолчанию это $, но вы можете это поменять.

Метод задания значений переменных

  - Отдельный диалог для каждой переменной – отображать отдельный диалог для каждой переменной, которая будет найдена при вставке заготовки в текст.

  - Одно окно для всех переменных заготовки – выводить один общий диалог для указания значений всех переменных.

### Настройка окна выбора файлов

&kdevelop; содержит средство выбора файлов, которое позволяет работать с файловой системой.

Выбор файлов (режим IDEAl)

Поведение окна Выбор файлов обладает гибкими настройками. Перейдите в Настройка Настроить KDevelop... , Выбор файлов:

Настройка выбора файлов

#### Настройка панели инструментов

Панель инструментов, расположенная вверху окна можно настраивать как обычно.

#### Добавление действия на панель инструментов

1. Выберите пункт в списке Selected actions, после которого нужно вставить новое действие.

2. Выберите пункт в списке Available actions.

3. Нажмите кнопку со стрелкой вправо

#### Удаление действия с панели инструментов

1. Выберите пункт в списке Selected actions, который нужно удалить.

2. Нажмите кнопку со стрелкой влево

#### Изменение порядка пунктов

1. Выберите пункт в списке Selected actions.

2. Нажмите кнопку со стрелкой вверх или вниз

#### Способ обновления содержимого

Обновление содержимого окна Выбор файлов занимает определённое количество ресурсов. Поэтому оно настроено на обновление только по запросу, т.е. при выборе другого каталога или нажимаете кнопку Обновить.

Нажмите Обновить на панели инструментов. Если её нет, добавьте её.

Можно его настроить на обновление также когда вы вносите изменения в файловую систему. ГруппаАвтоматическая синхронизация отвечает за это.

При активизации документа

  Обновлять содержимое при переходе к другому документу. При этом произойдёт переход в каталог документа.

При открытии документа

  Обновлять содержимое при открытии документа. При этом произойдёт переход в каталог документа.

При отображении окна выбора файла

  Обновлять содержимое когда окно становится видимым. При этом произойдёт переход в каталог текущего документа.

Эти параметры можно совмещать.

#### История каталогов и фильтров

Вверху и внизу окна выбора файлов есть выпадающие списки, позволяющие контролировать путь к текущему каталогу и фильтр отображаемых файлов. Вы можете указать количество запоминаемых (использованных) значений в этих списках.

Запомнить расположения

  Введите максимальное количество пунктов журнала.

Запомнить фильтры

  Введите максимальное количество пунктов журнала.

#### Что запоминать между сеансами

По умолчанию Обзор файлов настроен на возвращение значений при запуске &kdevelop;, которые были в прошлый сеанс.

При автоматическом перезапуске &kdevelop; менеджером сеансов &kde; значения этих параметров не учитываются, и предыдущие значения всегда восстанавливаются.

Восстанавливать расположение

  Включено по умолчанию

  Если вы выбрали одно из автоматических обновлений, расположение может меняться не смотря на то, что было сохранено с прошлого сеанса.

Восстанавливать предыдущий фильтр

  Включено по умолчанию

### Настройка мастера создания файлов

(... в процессе написания ...)

## Настройка просмотра документации

&kdevelop; поставляется с мощными средствами доступа к документации. Например, в режиме IDEAl есть вкладка Документация справа от рабочей области.

Дерево документации &kdevelop; (режим IDEAl)

Для обращения к документации используется соответствующий модуль. Для подробностей см. Подключаемый инструментарий.

Вы можете настроить содержимое дерева документации через Настройка Настроить KDevelop... , вкладка Просмотр документации:

Появится страница настроек со вкладками:

- Коллекции документации
- Полнотекстовый поиск
- Прочее

### Настройка коллекций документации

Разные коллекции документации имеют свой собственный формат, и, кроме общих, они также имеют различные настройки. Вы можете выбрать что будет отображаться на вкладке Содержание модуля Документация, а также режимы поиска.

Вкладка Документация представляет довольно большой набор настроек:

- Коллекция документации по Qt
- Коллекция документации в формате CHM
- Коллекция документации Doxygen
- Документация в формате KDevelopTOC
- Коллекция документации в формате Devhelp
- Другие коллекции документации

Настройка коллекций документации

#### Общие элементы настройки коллекций документации

Все страницы настроек вкладки Документация имеют сходную расстановку элементов.

##### Кнопки управления содержимым списка документации

Доступно три кнопки:

Добавить

  Открыть диалог Свойства каталога документации, в котором вы можете указать путь к новой документации.

Изменить

  Открыть диалог Свойства каталога документации, в котором вы можете изменить путь к документации.

Удалить

  Удалить документацию из списка.

  Удалить запись о выделенной документации. Если документация вам не нужна, удалите её самостоятельно с диска.

Добавление или изменение элемента документации

Кнопка справа от поля Расположение открывает диалог выбора папки.

Поле Заголовок может быть недоступно для некоторых типов документации.

##### Список коллекций документации

Страница параметров документации отображает пункты документации в таблице с четырьмя столбцами:

TOC

  Если флажок отмечен, пункт документации будет показан на вкладке Содержание инструмента Документация.

  Снятие флажка TOC приведёт к отключению флажов Индекс и Поиск (см. ниже).

Индекс

  Если отмечено, текущий элемент будет учтён при индексации. Это ускорит работу с документацией через вкладки Индекс и Поиск утилиты Документация &kdevelop;.

  Внутренний индекс будет построен при первом переходе на вкладку Индекс. Это займёт некоторое время.

  При последующих обращениях к этой вкладке будет использован созданный кэш, это будет намного быстрее.

Поиск

  Включать соддержимое документации в кэш для полнотекстового поиска со вкладки Поиск утилиты Документация &kdevelop;.

  &kdevelop; использует утилиту htdig для полнотекстового поиска. Последний поизводится по внутреннему индексу, который должен быть создан припервом поиске.

  Для вступления изменений в силу вам нужно будет пересоздать индекс со вкладки Поиск утилиты Документация &kdevelop;.

Заголовок

  Имя пункта, отображаемое на вкладке Содержание утилиты Документация &kdevelop;.

В ранних версиях &kdevelop; можно было выбирать какие пункты документации отображать для каждого проекта отдельно. Эта возможность была отключена.

#### Коллекции документации по Qt

На этой вкладке можно настроить документацию по &Qt;

Настройка коллекции документации по &Qt;

Этот пункт будет заполнен при первом запуске &kdevelop;. Будет произведён поиск документации в установочном каталоге &Qt;. Слева отображается список найденных файлов.

Если пути не определились, воспользуйтесь кнопками справа.

&kdevelop; будет использовать имеющиеся заголовки установленной документации &Qt;. Поэтому поле Заголовок в Свойства каталога документации недоступно.

По умолчанию, на вкладке Содержание отрображается не вся документация &Qt;. Для выбора отображаемого набора документации воспользуйтесь флажком TOC на соответствующей вкладке настроек.

Для управления набором документации, которую следует индексировать воспользуйтесь флажками Индекс и Поиск на соответствующей вкладке настроек.

#### Настройка коллекции документации CHM

На этой вкладке можно настроить просмотр документации в формате &Microsoft; CHM.

Настройка документации в формате &Microsoft; CHM

Сначала эта вкладка будет пустая (как показано выше), добавить новые элементы можно соответствующими кнопками справа от списка.

Для подробностей о формате &Microsoft; `*.chm` см., например, PHP: Documentation - Extended CHM Format (http://de2.php.net/docs-echm.php).

#### Сгенерированная Doxygen документация

На этой вкладке можно настроить работу с API-документацией, чегенерированной &doxygen;.

Настройка документации, сгенерированной Doxygen

Такая документация создаётся автоматически. Раньше это делалось с помощью KDoc, но теперь используется более гибкий &doxygen;. Если вам всё же потребуется воспользоваться документацией в старом формате, добавьте файлы на странице Коллекция документации.

Сгенерированная &doxygen; API-документация состоит из набора `html` файлов, с основным`index.html`. Также в ней могут присутствовать `tag-`файлы, для связей с существующей внешней API-документацией.

Папка, в которой находится файл `index.html`, должна содержать подпапки с отдельными коллециями документации. В каждой из них должен быть файл `.tag` и папка `html/`.

Примером служит `$KDEDIR/share/doc/HTML/en/kdelibs-apidocs`.

В &kdevelop; уже содержатся данные о API-документации библиотек &kde;. Если вы собрали &kdevelop; самостоятельно, для этого нужно было сделать одно из следующих действий:

- Передать путь к документации сценарию `configure` с помощью ключа `--with-kdelibsdoxy-dir` при сборке &kdevelop; (см. Как получить API-документацию KDevelop).

- Однако обычно `configure` самостоятельно находит все пути.

- В худшем случае, папка `$KDEDIR/share/doc/HTML/en/kdelibs-apidocs/` должна быть обнаружена &kdevelop; при первом запуске.

Если документация не найдена, Сгенерированная Doxygen документация будет пустым.

Добавить свою API-документацию можно с помощью кнопок справа. Если вы хотите, чтобы она была проиндексирована, отметьте соответствующие флажки.

&kdevelop; берёт заголовки из `index.html`, поэтому поле Заголовок в диалоге Свойства каталога документации недоступно.

&kde; предоставляет больше документации, например документацию по включению модуля &kate; part в ваши программы. Установите &kde; Base Libraries API из исходников (`make apidox` и `make install` для пакета `kdebase`) и добавьте новый элемент:

Добавление &kde; Base API

(естественно, замените `/home/dev/mykde-system/` на ваш каталог &kde;)

Аналогичным образом можно добавить справочник по API вашего проекта. Ранние версии &kdevelop; разрешали указывать набор документации отдельно для каждого проекта, эта возможность была удалена.

#### Иерархическая документация (KDevelopTOC)

KDevelopTOC (TOC - Table Of Contents, таблица содержания) - это файлы, определяющие структуру документации, и содержащие ссылки на её (он-лайн) содержимое.

Документация в формате KDevelopTOC

&kdevelop; поставляется с большим набором готовых файлов KDevelopTOC, но для экономии места отображаются только некоторые из них. За это отвечает столбец TOC в настройках документации.

Файлы KDevelopTOC не подлежат полнотекстовому индексированию, т.к. обычно они содержат ссылки на удалённую документацию. Но в них может быть простая индексная информация в теге `<index>`. Поэтому флажок Индекс будет доступен только если такой тег будет найден (для подробностей см. &kdevelop; TOC).

Флажок Поиск будет всегда недоступен.

Добавить новые элементы можно соответствующими кнопками справа от списка.

Кнопка Удалить не удаляет сам `.toc`-файл, а только убирает его из списка.

#### &kdevelop; TOC

Найдите в дереве документации пункт ниже &Qt;/&kde; (например KDE2 Development Book (kde.org)). Нажмите на значке в виде плюса. Откроется структура документации, позволяющая переходить к желаемому разделу. Но он будет расположен удалённо.

Это позволяет сэкономить на трафике и времени.

Таблицы содержания хранятся в файлах с расширением `.toc`. Они написаны в &XML;.

##### Стандартный каталог &kdevelop; TOC

При установке &kdevelop; файлы `.toc` помещаются в `$KDEDIR/share/apps/kdevdoctreeview/tocs`.

##### Структура &kdevelop; TOC

заголовок
  - `<!DOCTYPE kdeveloptoc>`
  - `<kdeveloptoc>`
  - (заголовок)
  - (начальный адрес)
  - (структура содержимого)
  - (структура индекса)
  - `</kdeveloptoc>`

  &XML; будет обрабатываться соответствующим модулем.

заголовок
  - `<title>` (некоторая строка) `</title>`

  Заголовок, отображаемый на верхнем уровне.

  Чтобы изменить его, отредактируйте файл `.toc` (тег `<title>`).

начальный адрес
  - `<base href="` (&URL;) `"/>`

  &URL; должен ссылаться на начальный файл. Остальные ссылки относительны, так что если вы загрузили документацию, вам нужно будет сменить лишь его на соответствующий локальный.

структура содержимого
  - `<tocsect1 name="` (заголовок раздела) `" url="` (&URL; раздела) `">`
  - ...
  - `<tocsectn name="` (заголовок раздела) `" url="` (&URL; раздела) `"/>`
  - ...
  - `</tocsect1>`

  Вся оставшаяся информация записывается в такую иерархическую структуру с парами `<tocsecti>` ... `</tocsecti>`, где i - номер уровня.

  Любой `<tocsecti>` должен иметь атрибут `name="xxx"`. Он будет использован для отображения заголовка в дереве документации.

  Атрибут `url=""` может быть ассоциирован с любым уровнем вложенности i.

  Тег `<tocsectn/>` должен содержать атрибут `url=""`. Последний вложенный `<tocsectn/>` будет закрыт `/` перед `>`.

  Ссылкой может быть адрес документа, либо указатель на конкретное его место (якорь) с помощью #, например: `/base-url/section-url#anchor-mark`.

структура индекса
  - `<index>`
  - `<tocsectn name="` (заголовок индексного пункта) `" url="` (&URL; раздела) `"/>`
  - `</index>`

  Простой список индексных записей - пар заголовок-&URL;. Необязательно.

#### Документация в формате DevHelp

Формат DevHelp - другой вариант доступа к иерархической документации. Он сделан для GNOME 2 и использует расширение `.devhelp`.

Вы можете выбирать, какие файлы будут доступны, на вкладкеКоллекция документации DevHelp.

Документация в формате DevHelp

##### Как получить документацию DevHelp

Файлы DevHelp были доступны на сайте LiDN, но похоже, что он умер. Более свежие версии DevHelp можно найти на страницеDevHelp Books Download.

При установке &kdevelop;, он попытается найти файлы `.devhelp` в некоторых стандартных папках системы, например в `/opt/gnome/share/`. Найденные файлы не будут отображаться по умолчанию, за это отвечается флажок TOC в настройках документации.

Добавить новые элементы можно соответствующими кнопками справа от списка.

#### Документация в нестандартном формате

Здесь вы можете добавить файлы почти любого формата, но с меньшей функциональностью.

Документация в нестандартном формате

Изначально коллекция будет пустая, мы специально добавить в неё элемент.

Добавить новые элементы или удалить старые можно соответствующими кнопками справа от списка.

Чтобы документация отображалась на панели документации, отметьте флажок TOC в окне настроек.

Документация в нестандартном формате не может быть проиндексирована.

### Индексирование документации

(... в процессе написания ...)

Индексирование документации

### Другие настройки коллекций документации

(... в процессе написания ...)

## Расширенная настройка

(... в процессе написания ...)

### Подключаемый инструментарий

(... в процессе написания ...)

### Сокращения

(... в процессе написания ...)

### Добавление стандартных приложений &kde; в меню Сервис

(... в процессе написания ...)

### Добавление внешних приложений в меню

(... в процессе написания ...)

#### Добавление в меню Сервис

(... в процессе написания ...)

#### Добавление в контекстное меню файлов

(... в процессе написания ...)

#### Добавление в контекстное меню каталогов

(... в процессе написания ...)