From 0b8ca6637be94f7814cafa7d01ad4699672ff336 Mon Sep 17 00:00:00 2001 From: Darrell Anderson Date: Tue, 21 Jan 2014 22:06:48 -0600 Subject: Beautify docbook files --- tde-i18n-ru/docs/tdebase/kate/advanced.docbook | 2344 ++++-------------- tde-i18n-ru/docs/tdebase/kate/configuring.docbook | 2591 +++++--------------- tde-i18n-ru/docs/tdebase/kate/fundamentals.docbook | 999 ++------ tde-i18n-ru/docs/tdebase/kate/highlighting.docbook | 1300 ++-------- tde-i18n-ru/docs/tdebase/kate/index.docbook | 429 +--- tde-i18n-ru/docs/tdebase/kate/man-kate.1.docbook | 260 +- tde-i18n-ru/docs/tdebase/kate/mdi.docbook | 324 +-- tde-i18n-ru/docs/tdebase/kate/menus.docbook | 1969 +++------------ tde-i18n-ru/docs/tdebase/kate/part.docbook | 883 ++----- tde-i18n-ru/docs/tdebase/kate/plugins.docbook | 33 +- .../docs/tdebase/kate/regular-expressions.docbook | 1155 ++------- 11 files changed, 2444 insertions(+), 9843 deletions(-) (limited to 'tde-i18n-ru/docs/tdebase/kate') diff --git a/tde-i18n-ru/docs/tdebase/kate/advanced.docbook b/tde-i18n-ru/docs/tdebase/kate/advanced.docbook index 6d07d91855f..fbce3e435b3 100644 --- a/tde-i18n-ru/docs/tdebase/kate/advanced.docbook +++ b/tde-i18n-ru/docs/tdebase/kate/advanced.docbook @@ -1,196 +1,68 @@ -&Anders.Lund; &Anders.Lund.mail; -&Dominik.Haumann; &Dominik.Haumann.mail; -АндрейБалагута
uj2@mail.ru
Перевод на русский АлексейОпарин
opaleksej@yandex.ru
Перевод на русский +&Anders.Lund; &Anders.Lund.mail; +&Dominik.Haumann; &Dominik.Haumann.mail; +АндрейБалагута
uj2@mail.ru
Перевод на русский АлексейОпарин
opaleksej@yandex.ru
Перевод на русский -Дополнительные возможности редактирования +Дополнительные возможности редактирования -Комментирование - -Команды "Комментировать" и "Раскомментировать", которые доступны из меню Сервис, позволяют добавить или убрать маркеры комментариев для выделенного блока текста (или для текущей строки, если текст не выделен), при условии, что комментарии поддерживаются форматом редактируемого текста. - -Правила комментирования определяются синтаксисом; таким образом, если подсветка синтаксиса не включена, то команды "Закомментировать" и "Раскомментировать" будут недоступны. - -Некоторые форматы поддерживают только однострочные маркеры комментариев, другие -- только многострочные, третьи -- и те, и другие. Если многострочные маркеры недоступны, то комментирование блока, в котором не до конца выделена последняя строка, будет невозможным. - -Предпочтение отдаётся комментированию отдельных строк однострочными маркерами, если последние допустимы синтаксисом и если такое комментирование возможно -- это помогает избежать проблем со вложенными комментариями. - -При удалении маркеров комментариев выделение снимается с раскомментированного текста. При удалении маркеров многострочного комментария пробелы снаружи маркеров игнорируются. - -закомментировать Чтобы закомментировать выделенный текст (или активную строку), выберите пункт менюСервисЗакомментировать или нажмите соответствующее сочетание клавиш (по умолчанию &Ctrl;D). - -раскомментировать Чтобы удалить маркеры комментариев, выберите пункт меню СервисРаскомментировать или нажмите соответствующее сочетание клавиш ( по умолчанию &Ctrl;&Shift;D). +Комментирование + +Команды "Комментировать" и "Раскомментировать", которые доступны из меню Сервис, позволяют добавить или убрать маркеры комментариев для выделенного блока текста (или для текущей строки, если текст не выделен), при условии, что комментарии поддерживаются форматом редактируемого текста. + +Правила комментирования определяются синтаксисом; таким образом, если подсветка синтаксиса не включена, то команды "Закомментировать" и "Раскомментировать" будут недоступны. + +Некоторые форматы поддерживают только однострочные маркеры комментариев, другие -- только многострочные, третьи -- и те, и другие. Если многострочные маркеры недоступны, то комментирование блока, в котором не до конца выделена последняя строка, будет невозможным. + +Предпочтение отдаётся комментированию отдельных строк однострочными маркерами, если последние допустимы синтаксисом и если такое комментирование возможно -- это помогает избежать проблем со вложенными комментариями. + +При удалении маркеров комментариев выделение снимается с раскомментированного текста. При удалении маркеров многострочного комментария пробелы снаружи маркеров игнорируются. + +закомментировать Чтобы закомментировать выделенный текст (или активную строку), выберите пункт менюСервисЗакомментировать или нажмите соответствующее сочетание клавиш (по умолчанию &Ctrl;D). + +раскомментировать Чтобы удалить маркеры комментариев, выберите пункт меню СервисРаскомментировать или нажмите соответствующее сочетание клавиш ( по умолчанию &Ctrl;&Shift;D). -Командная строка компонента редактора - -Модуль Kate имеет встроенную командную строку, позволяющую производить различные действия, оставляя интерфейс минималистским. Она представляет из себя поле ввода внизу области редактора. Для получения к ней доступа, выберите пункт меню ВидПереключиться в командную строку или нажмите F7 (по умолчанию). Команды, доступные из неё, описаны ниже, кроме того, модули могут предоставлять свои дополнительные команды. - -Для выполнения команды введите её и нажмите Enter. На месте команды будет выведено сообщение об успешном её выполнении или об ошибке. Если вы вызвали командную строку клавишей F7, она будет автоматически скрыта по прошествии нескольких секунд. Для того чтобы убрать сообщение и ввести новую команду, нажмите F7 ещё раз. - -Вы всегда можете получить справку с помощью команды help. Для получение списка всех доступных команд, введите help list, для просмотра справки по определённой команде - help команда. - -Для навигации по истории команд, воспользуйтесь стрелками Вверх и Вниз. При отображении команды из истории, её аргументы будут выделены, так что заменить их на другие легко. +Командная строка компонента редактора + +Модуль Kate имеет встроенную командную строку, позволяющую производить различные действия, оставляя интерфейс минималистским. Она представляет из себя поле ввода внизу области редактора. Для получения к ней доступа, выберите пункт меню ВидПереключиться в командную строку или нажмите F7 (по умолчанию). Команды, доступные из неё, описаны ниже, кроме того, модули могут предоставлять свои дополнительные команды. + +Для выполнения команды введите её и нажмите Enter. На месте команды будет выведено сообщение об успешном её выполнении или об ошибке. Если вы вызвали командную строку клавишей F7, она будет автоматически скрыта по прошествии нескольких секунд. Для того чтобы убрать сообщение и ввести новую команду, нажмите F7 ещё раз. + +Вы всегда можете получить справку с помощью команды help. Для получение списка всех доступных команд, введите help list, для просмотра справки по определённой команде - help команда. + +Для навигации по истории команд, воспользуйтесь стрелками Вверх и Вниз. При отображении команды из истории, её аргументы будут выделены, так что заменить их на другие легко. -Стандартные команды +Стандартные команды -Параметры редактора +Параметры редактора -Установленные таким способом параметры применяются только к текущему экземпляру редактора и не сохраняются. Удобно, если нужно установить параметры, отличные от стандартных (например, отступ). +Установленные таким способом параметры применяются только к текущему экземпляру редактора и не сохраняются. Удобно, если нужно установить параметры, отличные от стандартных (например, отступ). -Типы аргументов +Типы аргументов -BOOLEAN -Используется для команд включения/выключения. Допустимые значения - on, off, true, false, 1 или 0 +BOOLEAN +Используется для команд включения/выключения. Допустимые значения - on, off, true, false, 1 или 0 -INTEGER -Целое число +INTEGER +Целое число -STRING -Строка +STRING +Строка @@ -198,255 +70,84 @@ -set-tab-widthINTEGER width -Устанавливает расстояние между позициями табуляции - - - -set-indent-widthINTEGER width -Устанавливает ширину отступа. Только при создании отступов пробелами. - - - -set-word-wrap-columnINTEGER width -Устанавливает максимальную длину строк в случае, если включён автоматический перенос. - - - -set-icon-borderBOOLEAN enable -Устанавливает видимость рамок пиктограмм. - - - -set-folding-markersBOOLEAN enable -Устанавливает видимость маркеров сворачивания блоков кода. - - - -set-line-numbersBOOLEAN enable -Устанавливает видимость нумерации строк. - - - -set-replace-tabsBOOLEAN enable -Заменять при вводе символы табуляции на пробелы. - - - -set-remove-trailing-spaceBOOLEAN enable -Удалять пробелы в конце строки при снятии с неё курсора. - - - -set-show-tabsBOOLEAN enable -Представлять символы табуляции пробельное пространство в конце строк маленькими точками. - - - -set-indent-spacesBOOLEAN enable -Вставлять заданное количество пробелов для каждого уровня отступа, вместо одного символа табуляции. - - - -set-mixed-indentBOOLEAN enable -Использовать для отступов как символы табуляции, так и пробелы. Это реализуется путём замены пробелов в количестве, кратном ширине символа табуляциями, на последние. -Эта команда также включит расстановку отступов пробелами, и установит ширину отступов, если она не указана, в половину значения (для текущего документа на время выполнения). - - - -set-word-wrapBOOLEAN enable -Динамический перенос слов - - - -set-replace-tabs-saveBOOLEAN enable -Заменять символы табуляции на пробелы при сохранении. - - - -set-remove-trailing-space-saveBOOLEAN enable -Удалить пробелы в конце строк при сохранении. - - - -set-indent-modename -Выбрать режим расстановки отступов. Параметр name может иметь следующие значения: 'cstyle', 'csands', 'xml', 'python', 'varindent' и 'none'. При других значениях используется 'none'. - - - -set-highlighthighlight -Выбрать формат для подсветки, один из содержащихся в подменюСервисПодсветка синтаксиса. Доступно также автозавершение параметра. +set-tab-widthINTEGER width +Устанавливает расстояние между позициями табуляции + + + +set-indent-widthINTEGER width +Устанавливает ширину отступа. Только при создании отступов пробелами. + + + +set-word-wrap-columnINTEGER width +Устанавливает максимальную длину строк в случае, если включён автоматический перенос. + + + +set-icon-borderBOOLEAN enable +Устанавливает видимость рамок пиктограмм. + + + +set-folding-markersBOOLEAN enable +Устанавливает видимость маркеров сворачивания блоков кода. + + + +set-line-numbersBOOLEAN enable +Устанавливает видимость нумерации строк. + + + +set-replace-tabsBOOLEAN enable +Заменять при вводе символы табуляции на пробелы. + + + +set-remove-trailing-spaceBOOLEAN enable +Удалять пробелы в конце строки при снятии с неё курсора. + + + +set-show-tabsBOOLEAN enable +Представлять символы табуляции пробельное пространство в конце строк маленькими точками. + + + +set-indent-spacesBOOLEAN enable +Вставлять заданное количество пробелов для каждого уровня отступа, вместо одного символа табуляции. + + + +set-mixed-indentBOOLEAN enable +Использовать для отступов как символы табуляции, так и пробелы. Это реализуется путём замены пробелов в количестве, кратном ширине символа табуляциями, на последние. +Эта команда также включит расстановку отступов пробелами, и установит ширину отступов, если она не указана, в половину значения (для текущего документа на время выполнения). + + + +set-word-wrapBOOLEAN enable +Динамический перенос слов + + + +set-replace-tabs-saveBOOLEAN enable +Заменять символы табуляции на пробелы при сохранении. + + + +set-remove-trailing-space-saveBOOLEAN enable +Удалить пробелы в конце строк при сохранении. + + + +set-indent-modename +Выбрать режим расстановки отступов. Параметр name может иметь следующие значения: 'cstyle', 'csands', 'xml', 'python', 'varindent' и 'none'. При других значениях используется 'none'. + + + +set-highlighthighlight +Выбрать формат для подсветки, один из содержащихся в подменюСервисПодсветка синтаксиса. Доступно также автозавершение параметра. @@ -454,209 +155,79 @@ -Команды редактирования +Команды редактирования -Команды, которые непосредственно изменяют текущий документ. +Команды, которые непосредственно изменяют текущий документ. -indent -Подставляет отступы к выделенным строкам или к текущей. - - - -unindent -Снимает отступы с выделенных строк или с текущей. - - - -cleanindent -Очистить отступы в выделенных строках или в текущей в соответствии с параметрами расстановки отступов для текущего документа. - - - -comment -Вставляет маркеры, отмечающие выделенные строки или текущую как комментарии, в соответствии с форматом текущего файла (определяется способом подсветки синтаксиса). - - - -uncomment -Удалить маркеры, отмечающие выделенные строки или текущую как комментарии, в соответствии с форматом текущего файла. - - - -kill-line -Удаляет текущую строку. - - - -replacepatternreplacement -Заменить текст, совпадающий с pattern на replacement. Для включения пробелов в pattern, нужно заключить в двойные или одинарныекавычки и pattern, и replacement. Если аргументы не заключены в кавычки, первое слово будет принято за pattern, а остальное - за replacement. Если replacement не задать, все pattern будут удалены. -Для настройки параметров поиска, нужно указать соответствующие флаги после двоеточия (replace:options pattern replacement). Возможные параметры: - - -b -Искать в обратном направлении. - - - -c -Искать от позиции курсора. - - - -e -Искать только в выделенном тексте. - - - -r -Аргумент pattern - регулярное выражение. Вы можете использовать \N в replacement для получения N-ной подстроки найденного текста. - - - -s -С учётом регистра. - - - -p -Подтверждать каждую замену. - - - -w -Только целые слова. +indent +Подставляет отступы к выделенным строкам или к текущей. + + + +unindent +Снимает отступы с выделенных строк или с текущей. + + + +cleanindent +Очистить отступы в выделенных строках или в текущей в соответствии с параметрами расстановки отступов для текущего документа. + + + +comment +Вставляет маркеры, отмечающие выделенные строки или текущую как комментарии, в соответствии с форматом текущего файла (определяется способом подсветки синтаксиса). + + + +uncomment +Удалить маркеры, отмечающие выделенные строки или текущую как комментарии, в соответствии с форматом текущего файла. + + + +kill-line +Удаляет текущую строку. + + + +replacepatternreplacement +Заменить текст, совпадающий с pattern на replacement. Для включения пробелов в pattern, нужно заключить в двойные или одинарныекавычки и pattern, и replacement. Если аргументы не заключены в кавычки, первое слово будет принято за pattern, а остальное - за replacement. Если replacement не задать, все pattern будут удалены. +Для настройки параметров поиска, нужно указать соответствующие флаги после двоеточия (replace:options pattern replacement). Возможные параметры: + + +b +Искать в обратном направлении. + + + +c +Искать от позиции курсора. + + + +e +Искать только в выделенном тексте. + + + +r +Аргумент pattern - регулярное выражение. Вы можете использовать \N в replacement для получения N-ной подстроки найденного текста. + + + +s +С учётом регистра. + + + +p +Подтверждать каждую замену. + + + +w +Только целые слова. @@ -666,223 +237,47 @@ -dateformat -Вставить строку с датой/временем в указанном формате (задаётся параметром format), или в yyyy-MM-dd hh:mm:ss, если параметр упущен. Доступны следующие подстановки: -dНомер дня в месяце без ведущего нуля (1-31). -ddНомер дня в месяце с ведущим нулём (01-31). -dddСокращённое название дня недели ('Пн'..''Вс, 'Mon'..'Sun'). -ddddПолное названия дня недели ('Понедельник'..'Воскресенье', 'Monday'..'Sunday'). -MНомер месяца без ведущего нуля (1-12). -MMНомер месяца с ведущим нулём (01-12). -MMMСокращённое название месяца ('Янв'..'Дек', 'Jan'..'Dec'). -yyГод двумя цифрами (00-99). -yyyyГод четырьмя цифрами (1752-8000). -hЧас без ведущего нуля (0..23 или 1..12, в зависимости от настроек). -hhЧас с ведущим нулём (00..23 or 01..12, в зависимости от настроек). -mМинуты без ведущего нуля (0..59). -mmМинуты с ведущим нулём (00..59). -sСекунды без ведущего нуля (0..59). -ssСекунды с ведущим нулём (00..59). -zМиллисекунды без ведущих нулей (0..999). -zzzМиллисекунды с ведущими нулями (000..999). -APИспользовать 12-часовый формат часов. AP будет заменено на "AM" или "PM". -apИспользовать 12-часовый формат часов. ap будет заменено на "am" или "pm". +dateformat +Вставить строку с датой/временем в указанном формате (задаётся параметром format), или в yyyy-MM-dd hh:mm:ss, если параметр упущен. Доступны следующие подстановки: +dНомер дня в месяце без ведущего нуля (1-31). +ddНомер дня в месяце с ведущим нулём (01-31). +dddСокращённое название дня недели ('Пн'..''Вс, 'Mon'..'Sun'). +ddddПолное названия дня недели ('Понедельник'..'Воскресенье', 'Monday'..'Sunday'). +MНомер месяца без ведущего нуля (1-12). +MMНомер месяца с ведущим нулём (01-12). +MMMСокращённое название месяца ('Янв'..'Дек', 'Jan'..'Dec'). +yyГод двумя цифрами (00-99). +yyyyГод четырьмя цифрами (1752-8000). +hЧас без ведущего нуля (0..23 или 1..12, в зависимости от настроек). +hhЧас с ведущим нулём (00..23 or 01..12, в зависимости от настроек). +mМинуты без ведущего нуля (0..59). +mmМинуты с ведущим нулём (00..59). +sСекунды без ведущего нуля (0..59). +ssСекунды с ведущим нулём (00..59). +zМиллисекунды без ведущих нулей (0..999). +zzzМиллисекунды с ведущими нулями (000..999). +APИспользовать 12-часовый формат часов. AP будет заменено на "AM" или "PM". +apИспользовать 12-часовый формат часов. ap будет заменено на "am" или "pm". - + -charidentifier +charidentifier -Эта команда позволяет вставить символ по его числовому идентификатору в десятичной, восьмеричной или шестнадцатеричной системах счисления. Чтобы использовать её, откройте диалоговое окно "Команда правки" и наберите char: [number] в строке ввода, после чего нажмите кнопку OK. +Эта команда позволяет вставить символ по его числовому идентификатору в десятичной, восьмеричной или шестнадцатеричной системах счисления. Чтобы использовать её, откройте диалоговое окно "Команда правки" и наберите char: [number] в строке ввода, после чего нажмите кнопку OK. -Примеры использования команды <command ->char</command -> - -Введите: char:234 -Получите: ê -Введите: char:0x1234 -Получите: ሴ +Примеры использования команды <command>char</command> + +Введите: char:234 +Получите: ê +Введите: char:0x1234 +Получите: ሴ @@ -890,149 +285,54 @@ -замена в стиле sed -поиск в стиле sed -s///[ig] %s///[ig] +замена в стиле sed +поиск в стиле sed +s///[ig] %s///[ig] -"Типичный пользователь" при виде этих команд обязательно вздрогнет и начнёт искать на клавиатуре кнопку "Windows". В самом деле, кому придёт в голову искать текст подобным образом? Но вы же не "типичный", не так ли? Поэтому попробуем разобраться в этих двух sed-подобных командах. Первая выполняет поиск/замену в текущей строке, вторая -- во всём файле (%s///). - -Вкратце, команды производят поиск текста, заданного маской поиска -- регулярным выражением (regexp) между первой и второй наклонной чертой, и, при нахождении, выполняет замену выражением, которое задано между второй и третьей чертой. Круглые скобки в маске поиска позволяют задать подстроки в найденном тексте, на которые можно потом ссылаться в выражении замены. Обратная ссылка -- это регулярное выражение, которое при совпадении заменяется на фактический текст и может быть использовано в шаблоне замены. Для этого, в нужном месте поставьте обратную черту, а за ней номер подстроки по порядку (\1 -- для первой пары скобок, \2 -- для второй, и т. д.). - -Чтобы искать сами скобки ( или ), нужно предварить их обратной чертой: \(\) - -Если в самом конце указать i, поиск будет проводиться с учётом регистра, а если g - будут заменены все вхождения текста, совпадающего с регулярным выражением, иначе - только первое. +"Типичный пользователь" при виде этих команд обязательно вздрогнет и начнёт искать на клавиатуре кнопку "Windows". В самом деле, кому придёт в голову искать текст подобным образом? Но вы же не "типичный", не так ли? Поэтому попробуем разобраться в этих двух sed-подобных командах. Первая выполняет поиск/замену в текущей строке, вторая -- во всём файле (%s///). + +Вкратце, команды производят поиск текста, заданного маской поиска -- регулярным выражением (regexp) между первой и второй наклонной чертой, и, при нахождении, выполняет замену выражением, которое задано между второй и третьей чертой. Круглые скобки в маске поиска позволяют задать подстроки в найденном тексте, на которые можно потом ссылаться в выражении замены. Обратная ссылка -- это регулярное выражение, которое при совпадении заменяется на фактический текст и может быть использовано в шаблоне замены. Для этого, в нужном месте поставьте обратную черту, а за ней номер подстроки по порядку (\1 -- для первой пары скобок, \2 -- для второй, и т. д.). + +Чтобы искать сами скобки ( или ), нужно предварить их обратной чертой: \(\) + +Если в самом конце указать i, поиск будет проводиться с учётом регистра, а если g - будут заменены все вхождения текста, совпадающего с регулярным выражением, иначе - только первое. -Замена текста в текущей строке +Замена текста в текущей строке -Будучи противником принципа "разделяй и властвуй", вы решили откомпилировать свою программу. Но компилятор начал на вас ругаться: класс myClass, упомянутый в строке 3902, не определён. +Будучи противником принципа "разделяй и властвуй", вы решили откомпилировать свою программу. Но компилятор начал на вас ругаться: класс myClass, упомянутый в строке 3902, не определён. -"Чёрт!", - думаете вы, -- "да это же мой класс MyClass". Вы добираетесь до строки 3902 и, вместо того, чтобы пытаться искать слово в этой длинной строке (а кто сейчас укладывает каждую строчку кода в 60 символов?), вы запускаете диалоговое окно "Команда правки", вводите s/myclass/MyClass/i, жмёте OK, сохраняете и компилируйте -- успешно и без ошибок. +"Чёрт!", - думаете вы, -- "да это же мой класс MyClass". Вы добираетесь до строки 3902 и, вместо того, чтобы пытаться искать слово в этой длинной строке (а кто сейчас укладывает каждую строчку кода в 60 символов?), вы запускаете диалоговое окно "Команда правки", вводите s/myclass/MyClass/i, жмёте OK, сохраняете и компилируйте -- успешно и без ошибок. -Замена текста во всём файле - -Представьте себе, что у вас есть файл, в котором вы несколько раз упоминаете некоего человека по имени госпожа Иванова. Но вдруг вам сообщают, что эта самая госпожа Иванова вчера вышла замуж за господина с редкой фамилией Петров. Естественно, вам нужно заменить все упоминания о госпоже Ивановой на текст госпожа Петрова. - -Вызовите командную строку и введите следующий текст: %s/госпожа Иванова/госпожа Петрова/ -- и ваша работа сделана. +Замена текста во всём файле + +Представьте себе, что у вас есть файл, в котором вы несколько раз упоминаете некоего человека по имени госпожа Иванова. Но вдруг вам сообщают, что эта самая госпожа Иванова вчера вышла замуж за господина с редкой фамилией Петров. Естественно, вам нужно заменить все упоминания о госпоже Ивановой на текст госпожа Петрова. + +Вызовите командную строку и введите следующий текст: %s/госпожа Иванова/госпожа Петрова/ -- и ваша работа сделана. -Более сложный пример - -Этот пример показывает, как пользоваться обратными ссылками и классами символов (если вы не знаете, что это такое, советуем ознакомиться с приведенными ниже разделами). - -Допустим, у вас набрана такая строка: void MyClass::DoStringOps( String &foo, String &bar String *p, int &a, int &b ) +Более сложный пример + +Этот пример показывает, как пользоваться обратными ссылками и классами символов (если вы не знаете, что это такое, советуем ознакомиться с приведенными ниже разделами). + +Допустим, у вас набрана такая строка: void MyClass::DoStringOps( String &foo, String &bar String *p, int &a, int &b ) -Теперь вы думаете, что это недостаточно "красивый" код, и решаете, что вам нужно использовать ключевое слово const с параметрами, передаваемыми по ссылке (теми, перед которыми стоит амперсанд). Вы также хотите удалить лишние пробелы. - -Запустите диалоговое окно "Команда правки" и наберите: s/\s+(\w+)\s+(&)/ const \1 \2/g, и не забудьте нажать кнопку OK -- иначе ничего не выйдет. Символ g в конце команды указывает компилятору "пересчитывать" регулярное выражение обратной ссылки каждый раз, когда встречаются совпадения. - -Вывод: void MyClass::DoStringOps( const String &foo, const String &bar String *p, const int &a, const int &b ) - -Миссия завершена! Ну, и что же произошло? Мы искали некоторое количество пробелов (\s+), за которыми идут несколько латинских символов (\w+), следом за ними опять несколько пробелов (\s+), после которых стоит амперсанд, и по ходу дела сохраняли эти алфавитные символы и амперсанд для использования их в операции замены. После этого мы заменили совпадающие части строки следующей последовательностью: один пробел, за которым идёт спецификатор const, за ним ещё один пробел, после которого наши сохранённые символы (\1), ещё один пробел и сохранённый амперсанд (\2) - -В одном случае латинские символы составили слово String, в другом -- слово int, т.е. символьный класс \w с последующим знаком + определяет символьный набор произвольной длины. +Теперь вы думаете, что это недостаточно "красивый" код, и решаете, что вам нужно использовать ключевое слово const с параметрами, передаваемыми по ссылке (теми, перед которыми стоит амперсанд). Вы также хотите удалить лишние пробелы. + +Запустите диалоговое окно "Команда правки" и наберите: s/\s+(\w+)\s+(&)/ const \1 \2/g, и не забудьте нажать кнопку OK -- иначе ничего не выйдет. Символ g в конце команды указывает компилятору "пересчитывать" регулярное выражение обратной ссылки каждый раз, когда встречаются совпадения. + +Вывод: void MyClass::DoStringOps( const String &foo, const String &bar String *p, const int &a, const int &b ) + +Миссия завершена! Ну, и что же произошло? Мы искали некоторое количество пробелов (\s+), за которыми идут несколько латинских символов (\w+), следом за ними опять несколько пробелов (\s+), после которых стоит амперсанд, и по ходу дела сохраняли эти алфавитные символы и амперсанд для использования их в операции замены. После этого мы заменили совпадающие части строки следующей последовательностью: один пробел, за которым идёт спецификатор const, за ним ещё один пробел, после которого наши сохранённые символы (\1), ещё один пробел и сохранённый амперсанд (\2) + +В одном случае латинские символы составили слово String, в другом -- слово int, т.е. символьный класс \w с последующим знаком + определяет символьный набор произвольной длины. @@ -1045,123 +345,48 @@ -Команды навигации +Команды навигации -gotoINT line -Перейти к указанной строке. - - - -findpattern -Перейти к первому образцу, заданному параметром pattern. Последующие вхождения образца можно найти посредством пункта меню ПравкаНайти далее (клавиша по умолчанию - F3). -Параметры команды поиска можно задавать добавлением двоеточия и "флагов" после её имени (find:options pattern). Флаги - набор из следующих букв: - - -b -Искать в обратном направлении. - - - -c -Искать от позиции курсора. - - - -e -Искать только в выделенном тексте. - - - -r -Аргумент pattern - регулярное выражение. Вы можете использовать \N в replacement для получения N-ной подстроки найденного текста. - - - -s -С учётом регистра. - - - -w -Только целые слова. +gotoINT line +Перейти к указанной строке. + + + +findpattern +Перейти к первому образцу, заданному параметром pattern. Последующие вхождения образца можно найти посредством пункта меню ПравкаНайти далее (клавиша по умолчанию - F3). +Параметры команды поиска можно задавать добавлением двоеточия и "флагов" после её имени (find:options pattern). Флаги - набор из следующих букв: + + +b +Искать в обратном направлении. + + + +c +Искать от позиции курсора. + + + +e +Искать только в выделенном тексте. + + + +r +Аргумент pattern - регулярное выражение. Вы можете использовать \N в replacement для получения N-ной подстроки найденного текста. + + + +s +С учётом регистра. + + + +w +Только целые слова. @@ -1173,64 +398,30 @@ -ifindpattern -Поиск по мере набора. Поддерживается установка дополнительных флагов +ifindpattern +Поиск по мере набора. Поддерживается установка дополнительных флагов -b -Искать в обратном направлении. +b +Искать в обратном направлении. -r -Поиск по регулярному выражению. +r +Поиск по регулярному выражению. -s -С учётом регистра. +s +С учётом регистра. -c -Искать от позиции курсора. +c +Искать от позиции курсора. - + @@ -1242,250 +433,101 @@ -Использование сворачивания кода - -Сворачивание кода позволяет скрывать участки документа в редакторе, упрощая осмотр громоздких документов. В &kate; разделение на сворачиваемые участки определяется правилами подсветки синтаксиса, следовательно, доступно не для всех форматов файлов. В основном, сворачивание кода доступно в режиме написания исходного кода, XML-разметки и т.п. Большинство способов подсветки позволяют также самостоятельно определять скрываемые области, чаще всего используя ключевые слова BEGIN и END. - -Для того чтобы включить/отключить функцию сворачивания, выберите пункт меню ВидПоказать маркеры сворачивания. На панели маркеров сворачивания с левой стороны документа появится графическое представление сворачиваемых участков. Знак "-" показывает, что участок развёрнут, знак "+" обозначает свёрнутый участок. Щелчок на знаке "+" приведёт к разворачиванию свёрнутого участка, и наоборот (с одновременным изменением графического представления). - -Для управления состоянием сворачиваемых участков служат четыре команды, смотрите справку по меню. - -Если вы не хотите использовать функцию сворачивания, можно отключить параметр Показать маркеры сворачивания (если доступны) на странице настройки внешнего вида редактора +Использование сворачивания кода + +Сворачивание кода позволяет скрывать участки документа в редакторе, упрощая осмотр громоздких документов. В &kate; разделение на сворачиваемые участки определяется правилами подсветки синтаксиса, следовательно, доступно не для всех форматов файлов. В основном, сворачивание кода доступно в режиме написания исходного кода, XML-разметки и т.п. Большинство способов подсветки позволяют также самостоятельно определять скрываемые области, чаще всего используя ключевые слова BEGIN и END. + +Для того чтобы включить/отключить функцию сворачивания, выберите пункт меню ВидПоказать маркеры сворачивания. На панели маркеров сворачивания с левой стороны документа появится графическое представление сворачиваемых участков. Знак "-" показывает, что участок развёрнут, знак "+" обозначает свёрнутый участок. Щелчок на знаке "+" приведёт к разворачиванию свёрнутого участка, и наоборот (с одновременным изменением графического представления). + +Для управления состоянием сворачиваемых участков служат четыре команды, смотрите справку по меню. + +Если вы не хотите использовать функцию сворачивания, можно отключить параметр Показать маркеры сворачивания (если доступны) на странице настройки внешнего вида редактора -Написание сценариев Javascript в компоненте редактора +Написание сценариев Javascript в компоненте редактора -Введение - -Начиная с версии 2.5, компонент редактора &kate; поддерживает написание сценариев на языке ECMA, известном также как JavaScript. - -Сценарии можно вызывать только из встроенной командной строки. При этом необходимо, чтобы сценарий и файл .desktop (если он существует) находились в той папке, в которой &kate; сможет их разыскать. Подходящая папка для этого - katepart/scripts в папках данных &kde;. Найти папки данных можно командой tde-config data. Как правило, существуют системная и пользовательские папки данных. Естественно, сценарии в системных папках доступны всем пользователям системы, а в пользовательских - только их владельцам. - -Эта функциональность находится на экспериментальной стадии разработки, весьма вероятно его изменение в дальнейшем. -Сценарии нельзя добавлять в меню или назначать им комбинации клавиш. Может быть, в дальнейшем мы сможем это исправить. -Также невозможно использовать в сценариях аргументы. Потерпите, в светлом будущем это вполне может произойти ;) +Введение + +Начиная с версии 2.5, компонент редактора &kate; поддерживает написание сценариев на языке ECMA, известном также как JavaScript. + +Сценарии можно вызывать только из встроенной командной строки. При этом необходимо, чтобы сценарий и файл .desktop (если он существует) находились в той папке, в которой &kate; сможет их разыскать. Подходящая папка для этого - katepart/scripts в папках данных &kde;. Найти папки данных можно командой tde-config data. Как правило, существуют системная и пользовательские папки данных. Естественно, сценарии в системных папках доступны всем пользователям системы, а в пользовательских - только их владельцам. + +Эта функциональность находится на экспериментальной стадии разработки, весьма вероятно его изменение в дальнейшем. +Сценарии нельзя добавлять в меню или назначать им комбинации клавиш. Может быть, в дальнейшем мы сможем это исправить. +Также невозможно использовать в сценариях аргументы. Потерпите, в светлом будущем это вполне может произойти ;) -Программный интерфейс (API) Kate JavaScript - -Здесь приведен полный список функций и свойств, доступных для объектов document и view. Разумеется, доступны любые стандартные объекты языка, такие как Math, String, Regex и т.д. - -Во время исполнения сценария, объектом document является текущий документ, а объектом view является текущий вид (панель). - -Конечно, в настоящее время типы аргументов в JavaScript не используются, они просто информируют, какие виды значений ожидаются функциями. +Программный интерфейс (API) Kate JavaScript + +Здесь приведен полный список функций и свойств, доступных для объектов document и view. Разумеется, доступны любые стандартные объекты языка, такие как Math, String, Regex и т.д. + +Во время исполнения сценария, объектом document является текущий документ, а объектом view является текущий вид (панель). + +Конечно, в настоящее время типы аргументов в JavaScript не используются, они просто информируют, какие виды значений ожидаются функциями. -Глобальные функции - -debug( string) [функция] +Глобальные функции + +debug( string) [функция] -параметры -string выводимая строка +параметры +string выводимая строка -Выводит строку на стандартный поток ошибок, используя функцию kDebug(). Для вывода используется выделенное пространство, в начало может быть добавлен префикс Kate (KJS Scripts): +Выводит строку на стандартный поток ошибок, используя функцию kDebug(). Для вывода используется выделенное пространство, в начало может быть добавлен префикс Kate (KJS Scripts): -Программный интерфейс (API) класса <classname ->document</classname -> - - -document.attribute( line , column ); [функция] +Программный интерфейс (API) класса <classname>document</classname> + + +document.attribute( line , column ); [функция] -Параметры -uint line Строка, в которой находится атрибут. -uint column Столбец, в котором находится атрибут. +Параметры +uint line Строка, в которой находится атрибут. +uint column Столбец, в котором находится атрибут. -Возвращает числовые значения позиции атрибута в документе [line,column]. Атрибут представляет собой вид или стиль текста, а также используется для определения подсветки синтаксиса в различных частях текста смешанных форматов вроде HTML или PHP. +Возвращает числовые значения позиции атрибута в документе [line,column]. Атрибут представляет собой вид или стиль текста, а также используется для определения подсветки синтаксиса в различных частях текста смешанных форматов вроде HTML или PHP. -document.canBreakAt( Char c, uint attribute ); [функция] +document.canBreakAt( Char c, uint attribute ); [функция] -Параметры -c Знак для проверки -attribute Атрибут для позиции c. +Параметры +c Знак для проверки +attribute Атрибут для позиции c. - Возвращает допустимость разрыва строки на знаке c с атрибутом attribute. Результат зависит от того, какие атрибуты допускают разрыв строки без потери принадлежности подсветки. + Возвращает допустимость разрыва строки на знаке c с атрибутом attribute. Результат зависит от того, какие атрибуты допускают разрыв строки без потери принадлежности подсветки. -document.canComment( uint start_attribute, uint end_attribute ); [функция] +document.canComment( uint start_attribute, uint end_attribute ); [функция] -Параметры -start_attribute Атрибут начала участка комментария. -end_attribute Атрибут конца участка комментария. +Параметры +start_attribute Атрибут начала участка комментария. +end_attribute Атрибут конца участка комментария. -Возвращает принадлежность start_attribute и end_attribute к одной и той же системе подсветки синтаксиса. Если это так - всё нормально. +Возвращает принадлежность start_attribute и end_attribute к одной и той же системе подсветки синтаксиса. Если это так - всё нормально. -использование canComment -if ( document.canComment( document.attribute(1,0), document.attribute(5,0) ) ) { +использование canComment +if ( document.canComment( document.attribute(1,0), document.attribute(5,0) ) ) { // 1,0 и 5,0 принадлежат к одной системе подсветки синтаксиса } @@ -1494,723 +536,325 @@ -document.clear(); [функция] -Очищает документ. +document.clear(); [функция] +Очищает документ. -document.commentStart( uint attribute ); [функция] +document.commentStart( uint attribute ); [функция] -Параметры -attribute Атрибут текста, для которого вводится строка commentStart. +Параметры +attribute Атрибут текста, для которого вводится строка commentStart. -Возвращает строку, необходимую для начала многострочного комментария к тексту с атрибутом, или пустую строку, если в этом тексте не поддерживаются многострочные комментарии. +Возвращает строку, необходимую для начала многострочного комментария к тексту с атрибутом, или пустую строку, если в этом тексте не поддерживаются многострочные комментарии. -document.commentMarker( uint attribute ); [функция] +document.commentMarker( uint attribute ); [функция] -Параметры -attribute Атрибут текста, для которого вводится строка commentMarker +Параметры +attribute Атрибут текста, для которого вводится строка commentMarker -Возвращает пометку остатка строки как комментария к тексту с атрибутом, либо пустую строку для текста, в котором не поддерживаются комментарии в той же строке. +Возвращает пометку остатка строки как комментария к тексту с атрибутом, либо пустую строку для текста, в котором не поддерживаются комментарии в той же строке. -document.commentEnd( uint attribute ); [функция] +document.commentEnd( uint attribute ); [функция] -Параметры -attribute Атрибут текста, для которого вводится строка commentEnd +Параметры +attribute Атрибут текста, для которого вводится строка commentEnd -Возвращает строку, необходимую для окончания многострочного комментария к тексту с атрибутом, либо пустую строку для текста, в котором многострочные комментарии не поддерживаются. +Возвращает строку, необходимую для окончания многострочного комментария к тексту с атрибутом, либо пустую строку для текста, в котором многострочные комментарии не поддерживаются. -document.editBegin(); [функция] +document.editBegin(); [функция] -Начало группы редактирования. Все действия включаются в одну группу отмены до вызова editEnd(). +Начало группы редактирования. Все действия включаются в одну группу отмены до вызова editEnd(). -document.editEnd(); [функция] +document.editEnd(); [функция] -Окончание группы редактирования. +Окончание группы редактирования. -document.highlightMode; [свойство:только для чтения] +document.highlightMode; [свойство:только для чтения] -Название режима подсветки (JavaScript или C++). Если к документу не применяется режим подсветки, устанавливается значение None. Помните - необходимо использовать англоязычное название. +Название режима подсветки (JavaScript или C++). Если к документу не применяется режим подсветки, устанавливается значение None. Помните - необходимо использовать англоязычное название. -document.indentMode; [свойство:только для чтения] +document.indentMode; [свойство:только для чтения] -Название режима отступов документа, такое как normal или cstyle. Помните - если режим отступов не задан, устанавливается значение none. +Название режима отступов документа, такое как normal или cstyle. Помните - если режим отступов не задан, устанавливается значение none. -document.indentWidth; [свойство:только для чтения] +document.indentWidth; [свойство:только для чтения] -Устанавливает ширину отступа. Только при создании отступов пробелами. +Устанавливает ширину отступа. Только при создании отступов пробелами. -document.insertLine( uint line, string text ); [функция] +document.insertLine( uint line, string text ); [функция] -Параметры -line номер строки в документе +Параметры +line номер строки в документе -text вставляемый текст +text вставляемый текст -Вставляет новую строку с текстом text в строку под номером line. +Вставляет новую строку с текстом text в строку под номером line. -document.insertText( uint line, uint column, string text ); [функция] +document.insertText( uint line, uint column, string text ); [функция] -Параметры -line номер строки -column номер столбца -text вставляемый текст +Параметры +line номер строки +column номер столбца +text вставляемый текст -Вставляет текст text в строку номер line, столбец номер column. +Вставляет текст text в строку номер line, столбец номер column. -document.length(); [функция] +document.length(); [функция] -Возвращает размер документа в байтах. +Возвращает размер документа в байтах. -document.lines(); [функция] +document.lines(); [функция] -Возвращает число строк в документе. +Возвращает число строк в документе. -document.mixedIndent; [свойство:только для чтения] +document.mixedIndent; [свойство:только для чтения] -Логическая величина. Сообщает, применяется ли в документе смешанный тип отступов. Если это так - отступы осуществляются при помощи и пробелов, и позиций табуляции, сходно с редактором Emacs. +Логическая величина. Сообщает, применяется ли в документе смешанный тип отступов. Если это так - отступы осуществляются при помощи и пробелов, и позиций табуляции, сходно с редактором Emacs. -document.removeLine( uint line ); [функция] +document.removeLine( uint line ); [функция] -Параметры -line номер строки +Параметры +line номер строки -Удаляет строку документа номер line. +Удаляет строку документа номер line. -document.removeText( uint startLine, uint startColumn, uint endLine, uint endColumn ); [функция] +document.removeText( uint startLine, uint startColumn, uint endLine, uint endColumn ); [функция] -Параметры -startLine указывает начальную строку -startColumn указывает начальный столбец -endLine указывает конечную строку -endColumn указывает конечный столбец +Параметры +startLine указывает начальную строку +startColumn указывает начальный столбец +endLine указывает конечную строку +endColumn указывает конечный столбец -Удаляет участок текста, начиная от строки номер startLine и столбца номер startColumn до строки номер endLine и столбца номер endColumn. +Удаляет участок текста, начиная от строки номер startLine и столбца номер startColumn до строки номер endLine и столбца номер endColumn. -document.setText( string text ); [функция] +document.setText( string text ); [функция] -Параметры -text текст документа +Параметры +text текст документа -Приводит всё содержимое документа к тексту с параметрами text. +Приводит всё содержимое документа к тексту с параметрами text. -document.spaceIndent; [свойство:только для чтения] +document.spaceIndent; [свойство:только для чтения] -Логическая величина. Сообщает, применяется ли к документу отступ пробелами. Если это так, то отступы в документе производятся на величину indentWidth между уровнями, иначе сдвиг происходит на одну позицию табуляции. +Логическая величина. Сообщает, применяется ли к документу отступ пробелами. Если это так, то отступы в документе производятся на величину indentWidth между уровнями, иначе сдвиг происходит на одну позицию табуляции. -document.textFull(); [функция] +document.textFull(); [функция] -Возвращает весь текст документа. Если в тексте есть переводы строк, то знак перевода строки отобразится как \n. +Возвращает весь текст документа. Если в тексте есть переводы строк, то знак перевода строки отобразится как \n. -document.textLine( uint line ); [функция] +document.textLine( uint line ); [функция] -Параметры -line строка номер +Параметры +line строка номер -Возвращает текст строки номер line. +Возвращает текст строки номер line. -document.textRange( uint startLine, uint startColumn, uint endLine, uint endColumn ); [функция] +document.textRange( uint startLine, uint startColumn, uint endLine, uint endColumn ); [функция] -Параметры -startLine указывает начальную строку -startColumn указывает начальный столбец -endLine указывает конечную строку +Параметры +startLine указывает начальную строку +startColumn указывает начальный столбец +endLine указывает конечную строку -endColumn указывает конечный столбец +endColumn указывает конечный столбец -Возвращает указанный участок текста. Если в пределах участка есть переводы строк, то знак перевода отобразится как \n. +Возвращает указанный участок текста. Если в пределах участка есть переводы строк, то знак перевода отобразится как \n. - + -Аппаратно-программный интерфейс (API) <classname ->view</classname -> +Аппаратно-программный интерфейс (API) <classname>view</classname> -view.clearSelection(); [функция] +view.clearSelection(); [функция] -Снимает выделение со всего текста. +Снимает выделение со всего текста. -view.cursorColumn(); [функция] +view.cursorColumn(); [функция] -Возвращает столбец, в котором находится курсор (учитываются все знаки табуляции). +Возвращает столбец, в котором находится курсор (учитываются все знаки табуляции). -view.cursorColumnReal(); [функция] +view.cursorColumnReal(); [функция] -Возвращает номер столбца, в котором реально находится курсор (знак табуляции считается за один символ). +Возвращает номер столбца, в котором реально находится курсор (знак табуляции считается за один символ). -view.cursorLine(); [функция] +view.cursorLine(); [функция] -Возвращает номер строки, в которой находится курсор. +Возвращает номер строки, в которой находится курсор. -view.hasSelection(); [функция] +view.hasSelection(); [функция] -Если выделенный текст есть, возвращает true, иначе false. +Если выделенный текст есть, возвращает true, иначе false. -view.removeSelectedText(); [функция] +view.removeSelectedText(); [функция] -Если есть выделенный текст, он удаляется. +Если есть выделенный текст, он удаляется. -view.selectAll(); [функция] +view.selectAll(); [функция] -Выделяет весь текст. +Выделяет весь текст. -view.selection(); [функция] +view.selection(); [функция] -Возвращает выделенный текст. Если в пределах выделенного текста есть переводы строк, они отображаются знаком \n. +Возвращает выделенный текст. Если в пределах выделенного текста есть переводы строк, они отображаются знаком \n. -view.selectionEndColumn; [свойство:только для чтения] +view.selectionEndColumn; [свойство:только для чтения] -Возвращает номер последней позиции выделяемого участка. +Возвращает номер последней позиции выделяемого участка. -view.selectionEndLine; [свойство:только для чтения] +view.selectionEndLine; [свойство:только для чтения] -Возвращает номер последней строки выделяемого участка. +Возвращает номер последней строки выделяемого участка. -view.selectionStartColumn; [свойство:только для чтения] +view.selectionStartColumn; [свойство:только для чтения] -Возвращает номер начальной позиции выделяемого участка. +Возвращает номер начальной позиции выделяемого участка. -view.selectionStartLine; [свойство:только для чтения] +view.selectionStartLine; [свойство:только для чтения] -Возвращает номер начальной строки выделяемого участка. +Возвращает номер начальной строки выделяемого участка. -view.setCursorPosition( uint line, uint column ); [функция] +view.setCursorPosition( uint line, uint column ); [функция] -Параметры -line Указывает строку для курсора. -column Указывает столбец для курсора. +Параметры +line Указывает строку для курсора. +column Указывает столбец для курсора. -Устанавливает курсор ввода в позицию [line, col]. Установка курсора происходит визуально, символ табуляции считается за несколько символов, в зависимости от расположения текста, но не больше значения параметра Ширина табуляции. Отсчёт номеров строк и столбцов начинается от нуля. +Устанавливает курсор ввода в позицию [line, col]. Установка курсора происходит визуально, символ табуляции считается за несколько символов, в зависимости от расположения текста, но не больше значения параметра Ширина табуляции. Отсчёт номеров строк и столбцов начинается от нуля. -view.setCursorPositionReal( uint line, uint column ); [функция] +view.setCursorPositionReal( uint line, uint column ); [функция] -Параметры -line Указывает строку для курсора. -column Указывает столбец для курсора. +Параметры +line Указывает строку для курсора. +column Указывает столбец для курсора. -Устанавливает курсор в позицию [line, col]. При рассчёте позиции табуляция соответствует одному символу. Отсчёт строк и столбцов начинается от нуля. +Устанавливает курсор в позицию [line, col]. При рассчёте позиции табуляция соответствует одному символу. Отсчёт строк и столбцов начинается от нуля. -view.setSelection( uint startLine, uint startColumn, uint endLine, uint endColumn ); [функция] +view.setSelection( uint startLine, uint startColumn, uint endLine, uint endColumn ); [функция] -Параметры -startLine указывает начальную строку -startColumn указывает начальный столбец -endLine указывает конечную строку -endColumn указывает конечный столбец +Параметры +startLine указывает начальную строку +startColumn указывает начальный столбец +endLine указывает конечную строку +endColumn указывает конечный столбец -Устанавливает выделение от строки номер startLine и столбца номер startColumn до строки номер endLine и столбца номер endColumn. +Устанавливает выделение от строки номер startLine и столбца номер startColumn до строки номер endLine и столбца номер endColumn. @@ -2218,13 +862,10 @@ -Пример сценария -В качестве примера рассмотрим небольшой сценарий, переводящий выделенный текст в верхний регистр. Очевидно, сначала необходимо проверить, есть ли выделенный текст вообще. Если есть - возьмём этот текст, изменим регистр и заменим его новым текстом. Сценарий будет выглядеть примерно так: +Пример сценария +В качестве примера рассмотрим небольшой сценарий, переводящий выделенный текст в верхний регистр. Очевидно, сначала необходимо проверить, есть ли выделенный текст вообще. Если есть - возьмём этот текст, изменим регистр и заменим его новым текстом. Сценарий будет выглядеть примерно так: -if ( view.hasSelection() ) +if ( view.hasSelection() ) { column = view.selectionStartColumn; line = view.selectionStartLine; @@ -2238,32 +879,16 @@ } -Для группировки действий так, чтобы их можно было отменить одним вызовом пункта меню Отмена, мы поместили строки view.removeSelectedText() и document.insertText() между document.editBegin() и document.editEnd(). +Для группировки действий так, чтобы их можно было отменить одним вызовом пункта меню Отмена, мы поместили строки view.removeSelectedText() и document.insertText() между document.editBegin() и document.editEnd(). -Пример файла <filename ->.desktop</filename -> +Пример файла <filename>.desktop</filename> -Вот пример простого .desktop-файла, соответствующего приведенному выше сценарию. +Вот пример простого .desktop-файла, соответствующего приведенному выше сценарию. -[Desktop Entry] +[Desktop Entry] Encoding=UTF-8 Name=Kate Part JavaScript Uppercase Comment=Script to uppercase the selection @@ -2271,35 +896,16 @@ X-Kate-Command=uppercase-selection X-Kate-Help=<p>Usage: <code>uppercase-selection</code></p> -Мы видим, что здесь можно определить кодировку, ввести название, комментарий, указать путь к справке с помощью X-Kate-Help и название для командной строки через X-Kate-Command. Если файлы находятся в SVN-хранилище KDE, то пункты Name, Comment and X-Kate-Help автоматически переводятся на другие языки командами переводчиков KDE. +Мы видим, что здесь можно определить кодировку, ввести название, комментарий, указать путь к справке с помощью X-Kate-Help и название для командной строки через X-Kate-Command. Если файлы находятся в SVN-хранилище KDE, то пункты Name, Comment and X-Kate-Help автоматически переводятся на другие языки командами переводчиков KDE. -Резюме - -&kate; может разыскивать в определённых папках (см. выше) файлы *.js. Для каждого найденного файла будет проведен поиск соответствующего файла .desktop, например файлу uppercase.js соответствует файл uppercase.desktop. -Если требуемый файл .desktop не найден, сценарий будет зарегистрирован в командной строке katepart с именем без расширения .js, для нашего примера это будет uppercase.Если такое формирование названия команды подходит, и вам не требуются какие-то дополнительные возможности, которые предоставляет файл .desktop, он может не понадобиться вам совсем. -Если файл .desktop найден, то katepart считывает имя из пункта .desktop-файла X-Kate-Command, например X-Kate-Command=uppercase-selection. +Резюме + +&kate; может разыскивать в определённых папках (см. выше) файлы *.js. Для каждого найденного файла будет проведен поиск соответствующего файла .desktop, например файлу uppercase.js соответствует файл uppercase.desktop. +Если требуемый файл .desktop не найден, сценарий будет зарегистрирован в командной строке katepart с именем без расширения .js, для нашего примера это будет uppercase.Если такое формирование названия команды подходит, и вам не требуются какие-то дополнительные возможности, которые предоставляет файл .desktop, он может не понадобиться вам совсем. +Если файл .desktop найден, то katepart считывает имя из пункта .desktop-файла X-Kate-Command, например X-Kate-Command=uppercase-selection. diff --git a/tde-i18n-ru/docs/tdebase/kate/configuring.docbook b/tde-i18n-ru/docs/tdebase/kate/configuring.docbook index 01362187209..63b9813638f 100644 --- a/tde-i18n-ru/docs/tdebase/kate/configuring.docbook +++ b/tde-i18n-ru/docs/tdebase/kate/configuring.docbook @@ -1,97 +1,42 @@ -&Anders.Lund; &Anders.Lund.mail; -АндрейБалагута
uj2@mail.ru
Перевод на русскийАлексейОпарин
opaleksej@yandex.ru
Перевод на русский +&Anders.Lund; &Anders.Lund.mail; +АндрейБалагута
uj2@mail.ru
Перевод на русскийАлексейОпарин
opaleksej@yandex.ru
Перевод на русский -Настройка &kate; +Настройка &kate; -Обзор +Обзор -конфигурация -настройка -параметры +конфигурация +настройка +параметры &kate; предоставляет несколько средств настройки. Наиболее важные из них: -Диалог настройки -Главный инструмент настройки приложения &kate;, редактора и дополнительных модулей. - - -Меню Настройка -Предоставляет доступ к часто изменяемым параметрам. Из этого меню можно открыть диалоги настройки. - - -Меню Вид -Позволяет разделить текущею окно, включить/отключить отображение панелей значков и номеров строк для редактируемого документа. +Диалог настройки +Главный инструмент настройки приложения &kate;, редактора и дополнительных модулей. + + +Меню Настройка +Предоставляет доступ к часто изменяемым параметрам. Из этого меню можно открыть диалоги настройки. + + +Меню Вид +Позволяет разделить текущею окно, включить/отключить отображение панелей значков и номеров строк для редактируемого документа. -Поведение встроенного терминала определяется его настройкой в Центре управления KDE, и может быть изменено через контекстное меню или меню Настройка. +Поведение встроенного терминала определяется его настройкой в Центре управления KDE, и может быть изменено через контекстное меню или меню Настройка. -Основной диалог настройки +Основной диалог настройки @@ -99,23 +44,12 @@ -В диалоге настройки слева отображаются разделы, организованные в древовидную структуру, а справа - страница настройки, соответствующая выбранному разделу. - -Параметры настройки делятся на две основные группы -Настройка программы - -Настройка компонентов редактора +В диалоге настройки слева отображаются разделы, организованные в древовидную структуру, а справа - страница настройки, соответствующая выбранному разделу. + +Параметры настройки делятся на две основные группы +Настройка программы + +Настройка компонентов редактора @@ -124,317 +58,168 @@ -Настройка программы &kate; -Эта группа содержит страницы общей настройки программы &kate; +Настройка программы &kate; +Эта группа содержит страницы общей настройки программы &kate; -Страница <quote ->Общие настройки</quote -> -Здесь можно настроить несколько основных параметров &kate; +Страница <quote>Общие настройки</quote> +Здесь можно настроить несколько основных параметров &kate; - -Показывать полный путь в заголовке окна -Если флажок установлен, в заголовке окна &kate; будет отображать не только имя файла, но и полный путь к нему. + +Показывать полный путь в заголовке окна +Если флажок установлен, в заголовке окна &kate; будет отображать не только имя файла, но и полный путь к нему. - -Поведение + +Поведение -Синхронизировать терминал с активным документом -Если флажок установлен, встроенный терминал будет менять свой текущий каталог при каждой смене активного документа. Если сброшен, вам придётся перемещаться по дереву каталогов вручную. - - - - -Предупреждать об изменении файла другой программой -Если флажок установлен, &kate; уведомит вас об изменении файла другой программой, как только главное окно получит фокус ввода. Вы можете производить обновления, сохранять или отменять изменения сразу для группы файлов. -Если флажок сброшен, то, при получении фокуса ввода файлом, изменённым другой программой, &kate; задаст вопрос о необходимых действиях. +Синхронизировать терминал с активным документом +Если флажок установлен, встроенный терминал будет менять свой текущий каталог при каждой смене активного документа. Если сброшен, вам придётся перемещаться по дереву каталогов вручную. + + + + +Предупреждать об изменении файла другой программой +Если флажок установлен, &kate; уведомит вас об изменении файла другой программой, как только главное окно получит фокус ввода. Вы можете производить обновления, сохранять или отменять изменения сразу для группы файлов. +Если флажок сброшен, то, при получении фокуса ввода файлом, изменённым другой программой, &kate; задаст вопрос о необходимых действиях. - + - -Мета-данные + +Мета-данные - -Сохранять мета-данные прошлых сеансов -Если флажок установлен, &kate; сохранит мета-данные (закладки, настройку сеанса), даже когда вы закроете документ. Эти данные могут понадобиться, если документ вновь будет открыт в прежнем виде. + +Сохранять мета-данные прошлых сеансов +Если флажок установлен, &kate; сохранит мета-данные (закладки, настройку сеанса), даже когда вы закроете документ. Эти данные могут понадобиться, если документ вновь будет открыт в прежнем виде. - -Удалить настройки сеансов после -Устанавливает время, в течение которого будут храниться мета-данные файла. Долговременное хранение приводит к переполнению базы данных. + +Удалить настройки сеансов после +Устанавливает время, в течение которого будут храниться мета-данные файла. Долговременное хранение приводит к переполнению базы данных. - + -Страница <quote ->Сеансы</quote -> +Страница <quote>Сеансы</quote> -Раздел содержит параметры, связанные с использованием сеансов. +Раздел содержит параметры, связанные с использованием сеансов. - -Элементы сеансов + +Элементы сеансов -Восстанавливать настройку окна -Если флажок установлен, &kate; будет восстанавливать настройку окна в каждом новом сеансе. +Восстанавливать настройку окна +Если флажок установлен, &kate; будет восстанавливать настройку окна в каждом новом сеансе. - + - -Поведение при запуске приложения + +Поведение при запуске приложения -Определяет поведение &kate; при запуске. Эту настройку можно изменить параметрами командной строки. +Определяет поведение &kate; при запуске. Эту настройку можно изменить параметрами командной строки. -Начинать новый сеанс -Если установить этот флажок, &kate; при каждом запуске будет начинать новый безымянный сеанс. - - -Загрузить последний сеанс -При запуске &kate; может открывать прошлый сеанс. Удобно, если вы не любите менять настройки. - - -Выбрать сеанс -&kate; может предлагать на выбор несколько недавних сеансов. Эта настройка действует по умолчанию. Удобно для любителей частой смены настроек. +Начинать новый сеанс +Если установить этот флажок, &kate; при каждом запуске будет начинать новый безымянный сеанс. + + +Загрузить последний сеанс +При запуске &kate; может открывать прошлый сеанс. Удобно, если вы не любите менять настройки. + + +Выбрать сеанс +&kate; может предлагать на выбор несколько недавних сеансов. Эта настройка действует по умолчанию. Удобно для любителей частой смены настроек. - + - -Поведение при выходе из приложения или переключении сеанса + +Поведение при выходе из приложения или переключении сеанса -Не сохранять сеанс -Изменения данных сеанса (открывавшихся файлов и, если было включено, настройки окна) не сохранятся. Естественно, будет задан вопрос о сохранении изменённых файлов. Установите этот флажок - и при открытии нового сеанса ненужные файлы перестанут открываться. - - -Сохранить сеанс -&kate; сохранит данные любого сеанса, если он не безымянный. Если флажок установлен, ваш сеанс будет восстановлен в том самом виде, в котором вы его закрыли. Это поведение по умолчанию. - - -Спросить пользователя -Вопрос о сохранении сеанса будет задан при закрытии любого именованного сеанса. +Не сохранять сеанс +Изменения данных сеанса (открывавшихся файлов и, если было включено, настройки окна) не сохранятся. Естественно, будет задан вопрос о сохранении изменённых файлов. Установите этот флажок - и при открытии нового сеанса ненужные файлы перестанут открываться. + + +Сохранить сеанс +&kate; сохранит данные любого сеанса, если он не безымянный. Если флажок установлен, ваш сеанс будет восстановлен в том самом виде, в котором вы его закрыли. Это поведение по умолчанию. + + +Спросить пользователя +Вопрос о сохранении сеанса будет задан при закрытии любого именованного сеанса. - + -Страница <guilabel ->Панель выбора файла</guilabel -> +Страница <guilabel>Панель выбора файла</guilabel> -Панель инструментов -Выберите нужные вам кнопки для диалога выбора файла путём перемещения их в окно Выбранные действия. Расположение кнопок установите стрелками рядом с окном. +Панель инструментов +Выберите нужные вам кнопки для диалога выбора файла путём перемещения их в окно Выбранные действия. Расположение кнопок установите стрелками рядом с окном. -Автоматическая синхронизация -Диалог выбора файла может автоматически переходить к директории, содержащей текущий документ, при наступлении следующих событий:При активизации документаПри показе панели выбора файлов Даже если вы не пользуетесь этим свойством, синхронизацию можно выполнить вручную, нажав кнопку Синхронизировать. - - - -Сохранять расположение -Установите размер журнала. Сохраняются только фактические адреса, копии удаляются. - - - -Сохранять фильтры -Установите желаемое количество сохраняемых фильтров. Сохраняются только сами фильтры, копии удаляются. - - - -Сеанс +Автоматическая синхронизация +Диалог выбора файла может автоматически переходить к директории, содержащей текущий документ, при наступлении следующих событий:При активизации документаПри показе панели выбора файлов Даже если вы не пользуетесь этим свойством, синхронизацию можно выполнить вручную, нажав кнопку Синхронизировать. + + + +Сохранять расположение +Установите размер журнала. Сохраняются только фактические адреса, копии удаляются. + + + +Сохранять фильтры +Установите желаемое количество сохраняемых фильтров. Сохраняются только сами фильтры, копии удаляются. + + + +Сеанс -Определите, будет ли сохраняться расположение и фильтр для каждого сеанса. +Определите, будет ли сохраняться расположение и фильтр для каждого сеанса. @@ -443,207 +228,111 @@ -Страница <guilabel ->Список документов</guilabel -> +Страница <guilabel>Список документов</guilabel> -Подсветка фона -Позволяет вам включить визуализацию истории перехода по документам (через оттенки фона соответствующих пунктов списка), а также настроить используемые для этого цвета. Для подробностей, обратитесь к разделу Список документов. - - -Сортировать по -Порядок сортировки документов в списке. Эти же команды можно найти в контекстном меню списка документов. +Подсветка фона +Позволяет вам включить визуализацию истории перехода по документам (через оттенки фона соответствующих пунктов списка), а также настроить используемые для этого цвета. Для подробностей, обратитесь к разделу Список документов. + + +Сортировать по +Порядок сортировки документов в списке. Эти же команды можно найти в контекстном меню списка документов. -Страница <guilabel ->Модули</guilabel -> +Страница <guilabel>Модули</guilabel> -На этой странице представлены установленные модули &kate;. Для каждого отображается название и краткое описание. Для подключения нужного модуля нужно установить соответствующий флажок. +На этой странице представлены установленные модули &kate;. Для каждого отображается название и краткое описание. Для подключения нужного модуля нужно установить соответствующий флажок. -Если модуль настраиваемый, параметры его настройки появятся в дочернем окне этой страницы. +Если модуль настраиваемый, параметры его настройки появятся в дочернем окне этой страницы. -Внешние инструменты +Внешние инструменты -Меню Сервис содержит подменю Внешние инструменты. Эти инструменты вызывают внешние приложения для обработки данных соответствующего типа (интернет-адреса, директории, текста или выделения). На этой странице можно настраивать меню, редактировать, добавлять и удалять инструменты. +Меню Сервис содержит подменю Внешние инструменты. Эти инструменты вызывают внешние приложения для обработки данных соответствующего типа (интернет-адреса, директории, текста или выделения). На этой странице можно настраивать меню, редактировать, добавлять и удалять инструменты. -Внешний инструмент - это фактически команда оболочки с подстановкой данных текущего документа. +Внешний инструмент - это фактически команда оболочки с подстановкой данных текущего документа. -Свойства внешних инструментов +Свойства внешних инструментов -Название -Название пункта меню "Внешние инструменты". +Название +Название пункта меню "Внешние инструменты". -Сценарий -Сценарий, который будет выполнен при выборе пункта меню. Доступны следующие подстановки: +Сценарий +Сценарий, который будет выполнен при выборе пункта меню. Доступны следующие подстановки: -%URL -Полный адрес текущего документа или, если новый документ ещё не был сохранён, пустая строка. +%URL +Полный адрес текущего документа или, если новый документ ещё не был сохранён, пустая строка. -%URLS -Список полных адресов всех открытых файлов (кроме несохранённых) через пробел. +%URLS +Список полных адресов всех открытых файлов (кроме несохранённых) через пробел. -%directory -Папка текущего документа или пустая строка, если последний ещё не сохранён. +%directory +Папка текущего документа или пустая строка, если последний ещё не сохранён. -%filename -Имя текущего файла без пути или пустая строка, если файл ещё не сохранён. +%filename +Имя текущего файла без пути или пустая строка, если файл ещё не сохранён. -%line -Номер строки текущего документа, в которую будет вставлен курсор. +%line +Номер строки текущего документа, в которую будет вставлен курсор. -%column -Позиция курсора в текущей строке. +%column +Позиция курсора в текущей строке. -%selection -Выделенный текст или пустая строка, если такового нет. +%selection +Выделенный текст или пустая строка, если такового нет. -%text -Весь текст документа. Учтите, его длина может превысить максимально допустимую командной строки. Пользуйтесь осторожно. +%text +Весь текст документа. Учтите, его длина может превысить максимально допустимую командной строки. Пользуйтесь осторожно. - + -Исполняемый файл -Главный исполняемый файл - сценарий. Если его нет в папке, указанной в переменной окружения PATH, следует указать полный путь к нему. +Исполняемый файл +Главный исполняемый файл - сценарий. Если его нет в папке, указанной в переменной окружения PATH, следует указать полный путь к нему. -Mime-типы -Разделённый запятыми список mime-типов, для которых команда должна быть доступна. В настоящее время не используется. +Mime-типы +Разделённый запятыми список mime-типов, для которых команда должна быть доступна. В настоящее время не используется. -Сохранить -Дополнительно можно применить сохранение текущего или всех документов перед выполнением сценария. Удобно, если сценарий считывает файл с диска. +Сохранить +Дополнительно можно применить сохранение текущего или всех документов перед выполнением сценария. Удобно, если сценарий считывает файл с диска. -Название команды -Вы сможете вызвать этот внешний инструмент из Командной строки редактора введя exttool-команда_правки (т.е. название команды дополняет exttool-). +Название команды +Вы сможете вызвать этот внешний инструмент из Командной строки редактора введя exttool-команда_правки (т.е. название команды дополняет exttool-). @@ -653,238 +342,123 @@ -Настройка компонентов редактора -Группа содержит параметры, относящиеся к компонентам редактора. Большинство из них предустановлены, но могут быть изменены установками параметров Установки, специфичные для типов файлов, Переменные документа. Параметры для текущего документа можно также изменить динамически с помощью команд правки (F7). +Настройка компонентов редактора +Группа содержит параметры, относящиеся к компонентам редактора. Большинство из них предустановлены, но могут быть изменены установками параметров Установки, специфичные для типов файлов, Переменные документа. Параметры для текущего документа можно также изменить динамически с помощью команд правки (F7). -Внешний вид +Внешний вид -Перенос строк +Перенос строк -Динамический перенос строк -При установленном флажке строки будут переноситься в пределах окна. - - -Маркёры динамического переноса строк -Определяет отображение маркёров динамического переноса строк. - -Отступ динамически перенесённых строк до уровня: -Устанавливает отступ динамически перенесённой строки от уровня предыдущей. Такой код удобнее читать.Дополнительно можно установить предел отступов динамически перенесённых строк в процентах. Например, если установить этот параметр в 50%, экрана, то за этим пределом отступ применяться уже не будет. +Динамический перенос строк +При установленном флажке строки будут переноситься в пределах окна. + + +Маркёры динамического переноса строк +Определяет отображение маркёров динамического переноса строк. + +Отступ динамически перенесённых строк до уровня: +Устанавливает отступ динамически перенесённой строки от уровня предыдущей. Такой код удобнее читать.Дополнительно можно установить предел отступов динамически перенесённых строк в процентах. Например, если установить этот параметр в 50%, экрана, то за этим пределом отступ применяться уже не будет. -Сворачивание блоков кода +Сворачивание блоков кода -Показывать маркёры сворачивания блоков (если поддерживается) -Если флажок установлен, то в текущем документе будут показаны маркёры сворачивания блоков кода (если сворачивание доступно). +Показывать маркёры сворачивания блоков (если поддерживается) +Если флажок установлен, то в текущем документе будут показаны маркёры сворачивания блоков кода (если сворачивание доступно). -Границы +Границы -Показывать панель значков -Если флажок установлен, то слева от текстового поля будут отображаться значки, например значки закладок. - - -Показывать номера строк -Если флажок установлен, то слева от текста будут отображаться номера строк. - - -Показывать отметки -Если флажок установлен, то на полосе прокрутки текущего документа будут отображаться отметки, например закладки. +Показывать панель значков +Если флажок установлен, то слева от текстового поля будут отображаться значки, например значки закладок. + + +Показывать номера строк +Если флажок установлен, то слева от текста будут отображаться номера строк. + + +Показывать отметки +Если флажок установлен, то на полосе прокрутки текущего документа будут отображаться отметки, например закладки. -Меню управления закладками - +Меню управления закладками + -По позиции -Закладки будут упорядочены по номерам строк, на которые они установлены. - - -По времени создания -Новая закладка будет добавлена в конец списка, независимо от её положения в документе. +По позиции +Закладки будут упорядочены по номерам строк, на которые они установлены. + + +По времени создания +Новая закладка будет добавлена в конец списка, независимо от её положения в документе. - + -Отображать линии отступов -Если флажок установлен, в редакторе будут отображаться вертикальные линии для выравнивания отступов. +Отображать линии отступов +Если флажок установлен, в редакторе будут отображаться вертикальные линии для выравнивания отступов. -Шрифты и цвета +Шрифты и цвета -В этой части диалога можно настроить цвета и шрифты для любой выбранной вами цветовой схемы. Можно создать новую схему или удалить существующую. Каждая схема содержит пакет настроек шрифтов и цветов для обычного и выделенного текстов. +В этой части диалога можно настроить цвета и шрифты для любой выбранной вами цветовой схемы. Можно создать новую схему или удалить существующую. Каждая схема содержит пакет настроек шрифтов и цветов для обычного и выделенного текстов. -&kate; использует предустановленные параметры. Для включения иной схемы необходимо выбрать её в выпадающем списке. +&kate; использует предустановленные параметры. Для включения иной схемы необходимо выбрать её в выпадающем списке. -Цвета +Цвета -Фон текстового поля +Фон текстового поля -Обычный текст -Это основной цвет текстового поля. +Обычный текст +Это основной цвет текстового поля. -Выделенный текст -Фон выделенного текста. По умолчанию действует глобальная настройка &kde;. +Выделенный текст +Фон выделенного текста. По умолчанию действует глобальная настройка &kde;. -Текущая строка -Цвет текущей строки. Цветовое выделение поможет следить за фокусом ввода. +Текущая строка +Цвет текущей строки. Цветовое выделение поможет следить за фокусом ввода. -Закладка -В этом списке можно выбрать цвета для различных типов закладок. Этот цвет подмешивается к фону текущей строки, поэтому может не вполне соответствовать установленному. В эти же цвета окрашиваются отметки на полосе прокрутки. +Закладка +В этом списке можно выбрать цвета для различных типов закладок. Этот цвет подмешивается к фону текущей строки, поэтому может не вполне соответствовать установленному. В эти же цвета окрашиваются отметки на полосе прокрутки. @@ -892,61 +466,28 @@ -Другие элементы +Другие элементы -Фон левой границы -Определяет окраску всех панелей, находящихся слева от текстового поля (если они отображаются). - - -Номера строк -Этим цветом окрашиваются номера строк (если они отображаются). - - -Цвет фигурных скобок -Этим цветом окрашиваются соответствующие друг другу фигурные скобки. - - -Маркёры переноса строк -Этим цветом окрашиваются маркёры слева от динамически перенесённых строк (если они выровнены вертикально) и маркёры статического переноса строк. - - -Маркёры позиций табуляции -Этим цветом окрашиваются пустые пространства текста, если их отображение включено. +Фон левой границы +Определяет окраску всех панелей, находящихся слева от текстового поля (если они отображаются). + + +Номера строк +Этим цветом окрашиваются номера строк (если они отображаются). + + +Цвет фигурных скобок +Этим цветом окрашиваются соответствующие друг другу фигурные скобки. + + +Маркёры переноса строк +Этим цветом окрашиваются маркёры слева от динамически перенесённых строк (если они выровнены вертикально) и маркёры статического переноса строк. + + +Маркёры позиций табуляции +Этим цветом окрашиваются пустые пространства текста, если их отображение включено. @@ -956,101 +497,58 @@ -Шрифты -Выбор шрифта для схемы. Доступен любой шрифт из вашей системы, можно настроить размер по умолчанию. Образец текста приводится в нижней части диалога, поэтому результат изменения виден сразу. +Шрифты +Выбор шрифта для схемы. Доступен любой шрифт из вашей системы, можно настроить размер по умолчанию. Образец текста приводится в нижней части диалога, поэтому результат изменения виден сразу. -Стили обычного текста -Стили обычного текста наследуются из стилей выделенного, поэтому редактор может более вразумительно отображать текст. Например, текст комментария использует стили почти всех текстовых форматов, которые kate в состоянии обрабатывать. -Во время настройки стиля есть возможность предварительно просмотреть её результаты. -Для каждого стиля можно настроить обычные атрибуты, цвета фона и самого текста. Перенастроить фон можно через контекстное меню. +Стили обычного текста +Стили обычного текста наследуются из стилей выделенного, поэтому редактор может более вразумительно отображать текст. Например, текст комментария использует стили почти всех текстовых форматов, которые kate в состоянии обрабатывать. +Во время настройки стиля есть возможность предварительно просмотреть её результаты. +Для каждого стиля можно настроить обычные атрибуты, цвета фона и самого текста. Перенастроить фон можно через контекстное меню. -Стили подсветки текста -Здесь можно настроить стили текста для определённого правила подсветки. Имеются предустановленные настройки, но в выпадающем списке Подсветка можно установить другие параметры. -Во время настройки стиля есть возможность предварительно просмотреть её результаты. -Для каждого стиля можно настроить обычные атрибуты, цвета фона и самого текста. Перенастроить фон можно через контекстное меню. Есть возможность сравнить текущий стиль с предустановленным и устранить возможное несоответствие. -Можно заметить, что многие стили подсветки содержат другие стили, представленные группами в списке. Например, большинство стилей используют стиль Alert, а многие форматы языков программирования используют стиль Doxygen. Цвета редактирования для этих групп применяются только во время работы с соответствующими форматами. +Стили подсветки текста +Здесь можно настроить стили текста для определённого правила подсветки. Имеются предустановленные настройки, но в выпадающем списке Подсветка можно установить другие параметры. +Во время настройки стиля есть возможность предварительно просмотреть её результаты. +Для каждого стиля можно настроить обычные атрибуты, цвета фона и самого текста. Перенастроить фон можно через контекстное меню. Есть возможность сравнить текущий стиль с предустановленным и устранить возможное несоответствие. +Можно заметить, что многие стили подсветки содержат другие стили, представленные группами в списке. Например, большинство стилей используют стиль Alert, а многие форматы языков программирования используют стиль Doxygen. Цвета редактирования для этих групп применяются только во время работы с соответствующими форматами. -Курсор и выделение +Курсор и выделение -Перемещение курсора +Перемещение курсора -Умная реакция на home +Умная реакция на home -Если флажок установлен, то нажатие клавиши Home вызовет перемещение курсора в начало строки. +Если флажок установлен, то нажатие клавиши Home вызовет перемещение курсора в начало строки. -Переносить курсор +Переносить курсор -Если флажок установлен, то курсор ввода будет перемещаться клавишами Влево и Вправо на предыдущую/следующую строку в начало/конец строки, так же как в большинстве других редакторов.Если флажок сброшен, то курсор невозможно переместить левее начала строки, но можно переместить правее конца строки, что удобно для программистов. Когда флажок установлен, перемещение курсора стрелочными клавишами за конец строки (вправо) вызовет его смещение на начало следующей строки. Перемещение курсора левее начала строки вызовет его переход на конец предыдущей строки. Если флажок сброшен, то передвижение курсора вправо за конец строки приведёт только к движению его в пределах данной строки, а передвижение левее начала строки вообще невозможно. +Если флажок установлен, то курсор ввода будет перемещаться клавишами Влево и Вправо на предыдущую/следующую строку в начало/конец строки, так же как в большинстве других редакторов.Если флажок сброшен, то курсор невозможно переместить левее начала строки, но можно переместить правее конца строки, что удобно для программистов. Когда флажок установлен, перемещение курсора стрелочными клавишами за конец строки (вправо) вызовет его смещение на начало следующей строки. Перемещение курсора левее начала строки вызовет его переход на конец предыдущей строки. Если флажок сброшен, то передвижение курсора вправо за конец строки приведёт только к движению его в пределах данной строки, а передвижение левее начала строки вообще невозможно. -Клавиши Page Up/Page Down перемещают курсор +Клавиши Page Up/Page Down перемещают курсор -Этот параметр определяет реакцию курсора на нажатие клавиш Page Up или Page Down. Если флажок сброшен, то первое нажатие клавиши вызовет появление новой страницы. Если флажок установлен, то первое нажатие клавиши вызовет сначала перемещение курсора в начало или конец видимого текста, и только потом откроется новая страница. +Этот параметр определяет реакцию курсора на нажатие клавиш Page Up или Page Down. Если флажок сброшен, то первое нажатие клавиши вызовет появление новой страницы. Если флажок установлен, то первое нажатие клавиши вызовет сначала перемещение курсора в начало или конец видимого текста, и только потом откроется новая страница. -Автоцентровка курсора (строк): +Автоцентровка курсора (строк): -Количество строк, остающихся по возможности видимыми над и под курсором. +Количество строк, остающихся по возможности видимыми над и под курсором. @@ -1058,30 +556,19 @@ -Режим выделения +Режим выделения -Обычный +Обычный -Выделенный фрагмент будет перезаписан вводимым текстом, выделение будет снято при перемещении курсора. +Выделенный фрагмент будет перезаписан вводимым текстом, выделение будет снято при перемещении курсора. -Не снимать выделение +Не снимать выделение -При перемещении курсора и вводе текста фрагмент остаётся выделенным. +При перемещении курсора и вводе текста фрагмент остаётся выделенным. @@ -1092,108 +579,53 @@ -Редактирование +Редактирование -Табуляция +Табуляция -Заполнять отступы пробелами +Заполнять отступы пробелами -Если флажок установлен, то при нажатии клавиши TAB будут введены пробелы в количестве, определённом параметром . +Если флажок установлен, то при нажатии клавиши TAB будут введены пробелы в количестве, определённом параметром . -Показать символы табуляции +Показать символы табуляции -Если установить этот флажок, &kate; будет отображать символы табуляции маленькими точками. -Это может вызвать также отображение в виде точек завершающих пробелов. В будущих версиях &kate; будет исправлено. +Если установить этот флажок, &kate; будет отображать символы табуляции маленькими точками. +Это может вызвать также отображение в виде точек завершающих пробелов. В будущих версиях &kate; будет исправлено. -Ширина табуляции Этим параметром определяется количество пробелов, заменяющих символ табуляции при включённом параметре Заменять символы табуляции пробелами. +Ширина табуляции Этим параметром определяется количество пробелов, заменяющих символ табуляции при включённом параметре Заменять символы табуляции пробелами. -Статичный перенос строк -Перенос строк - это свойство редактора автоматически начинать новую строку и переносить курсор на её начало. &kate; автоматически начинает новую строку при достижении величины, определённой параметром Переносить после:. +Статичный перенос строк +Перенос строк - это свойство редактора автоматически начинать новую строку и переносить курсор на её начало. &kate; автоматически начинает новую строку при достижении величины, определённой параметром Переносить после:. -Переносить строки +Переносить строки -Включает/выключает статичный перенос строк. +Включает/выключает статичный перенос строк. -Отображать маркёры статичного переноса строк (если возможно) +Отображать маркёры статичного переноса строк (если возможно) -Если этот параметр включён, то на границе переноса строк будет отображаться вертикальная линия, как определено в меню Настройка Редактирование на вкладке Правка. Заметьте, что этот маркёр может отображаться, только если вы используете моноширинный шрифт. +Если этот параметр включён, то на границе переноса строк будет отображаться вертикальная линия, как определено в меню Настройка Редактирование на вкладке Правка. Заметьте, что этот маркёр может отображаться, только если вы используете моноширинный шрифт. -Переносить после: +Переносить после: -Здесь устанавливается количество символов, после которого начинается новая строка при включённом параметре Перенос строк. +Здесь устанавливается количество символов, после которого начинается новая строка при включённом параметре Перенос строк. @@ -1201,114 +633,39 @@ -Удалить завершающие пробелы -&kate; может автоматически удалять лишние завершающие пробелы. - - -Автоскобки Когда пользователь вводит левую скобку любого вида, &kate; автоматически подставляет аналогичную скобку справа от курсора. - - - Число шагов отмены: -Здесь устанавливается предельное число операций, которые &kate; будет сохранять в памяти. Чем больше это число, тем больше памяти будет занято откатами. Указав число 10, пользователь получит возможность кнопкой "Отменить действие" вернуться назад на десять своих последних шагов и выбрать из них наиболее удачный. - - Интеллектуальный поиск текста с: -Здесь определяется, где &kate; будет искать текст для поиска (этот текст будет автоматически помещён в диалог поиска текста): Не искать нигде:Поиск текста не производится.Только в выделении: Используется текущее выделение (если возможно). В выделении, затем в текущем слове: Используется, если возможно, текущее выделение, в противном случае текущее слово.Только в текущем слове: Используется, если возможно, только то слово, в котором находится курсор.Текущее слово, затем выделение: Используется, если возможно, текущее слово, в противном случае текущее выделение. Учтите, что, если во всех вышеописанных режимах строка для поиска не указана или не может быть найдена, в диалоге поиска текста появится последняя введённая строка. +Удалить завершающие пробелы +&kate; может автоматически удалять лишние завершающие пробелы. + + +Автоскобки Когда пользователь вводит левую скобку любого вида, &kate; автоматически подставляет аналогичную скобку справа от курсора. + + + Число шагов отмены: +Здесь устанавливается предельное число операций, которые &kate; будет сохранять в памяти. Чем больше это число, тем больше памяти будет занято откатами. Указав число 10, пользователь получит возможность кнопкой "Отменить действие" вернуться назад на десять своих последних шагов и выбрать из них наиболее удачный. + + Интеллектуальный поиск текста с: +Здесь определяется, где &kate; будет искать текст для поиска (этот текст будет автоматически помещён в диалог поиска текста): Не искать нигде:Поиск текста не производится.Только в выделении: Используется текущее выделение (если возможно). В выделении, затем в текущем слове: Используется, если возможно, текущее выделение, в противном случае текущее слово.Только в текущем слове: Используется, если возможно, только то слово, в котором находится курсор.Текущее слово, затем выделение: Используется, если возможно, текущее слово, в противном случае текущее выделение. Учтите, что, если во всех вышеописанных режимах строка для поиска не указана или не может быть найдена, в диалоге поиска текста появится последняя введённая строка. -Отступ +Отступ -Автоматический отступ +Автоматический отступ -Правила отступа: +Правила отступа: -Выбор используемого по умолчанию режима отступов. Настоятельно рекомендуется пользоваться значением Нет или Обычный, а для формирования других режимов использовать установки, специфичные для типов файлов, таких как файлов кода C/C++ или &XML;. +Выбор используемого по умолчанию режима отступов. Настоятельно рекомендуется пользоваться значением Нет или Обычный, а для формирования других режимов использовать установки, специфичные для типов файлов, таких как файлов кода C/C++ или &XML;. -Автоматически добавлять комментарии Doxygen при наборе +Автоматически добавлять комментарии Doxygen при наборе -При наборе комментариев в стиле doxygen к ним автоматически добавляются "*". Этот параметр применяется только там, где возможно. +При наборе комментариев в стиле doxygen к ним автоматически добавляются "*". Этот параметр применяется только там, где возможно. @@ -1316,42 +673,25 @@ -Отступ пробелами +Отступ пробелами -Отступы пробелами вместо символов табуляции +Отступы пробелами вместо символов табуляции -Символы табуляции заменяются пробелами в количестве, указанном тут же, в поле Количество пробелов:. +Символы табуляции заменяются пробелами в количестве, указанном тут же, в поле Количество пробелов:. -Смешанный режим в стиле Emacs +Смешанный режим в стиле Emacs -Применяется смешанный режим отступов табуляторами и пробелами. +Применяется смешанный режим отступов табуляторами и пробелами. -Количество пробелов: +Количество пробелов: -Устанавливает количество пробелов, вводимых для замены символов табуляции, если этот флажок установлен. +Устанавливает количество пробелов, вводимых для замены символов табуляции, если этот флажок установлен. @@ -1359,60 +699,29 @@ -Сохранять настройки отступов -Если этот флажок установлен, то редактор не будет убирать отступы в последующих строках выделения, когда в предыдущих отступы снимаются. Может быть полезно, если вам часто приходится снимать отступы с блоков кода. +Сохранять настройки отступов +Если этот флажок установлен, то редактор не будет убирать отступы в последующих строках выделения, когда в предыдущих отступы снимаются. Может быть полезно, если вам часто приходится снимать отступы с блоков кода. -Сохранять лишние пробелы -Отступы длиной более, чем заданное число пробелов, не будут сокращаться. +Сохранять лишние пробелы +Отступы длиной более, чем заданное число пробелов, не будут сокращаться. -Использовать клавиши +Использовать клавиши -Отступы клавишей Tab +Отступы клавишей Tab -Для отступов используется клавиша tab. +Для отступов используется клавиша tab. -Отступы клавишей Backspace +Отступы клавишей Backspace -Для отступов используется клавиша backspace. +Для отступов используется клавиша backspace. @@ -1420,52 +729,25 @@ -Отступы клавишей Tab, если ничего не указано +Отступы клавишей Tab, если ничего не указано -Вставлять символы отступа +Вставлять символы отступа -Клавишей Tab вставляются символы отступа. +Клавишей Tab вставляются символы отступа. -Вставить символ табуляции +Вставить символ табуляции -Клавишей Tab вставляются символы табуляции. +Клавишей Tab вставляются символы табуляции. -Сделать отступ на текущей строке +Сделать отступ на текущей строке -Клавишей Tab можно сделать отступ в текущей строке. +Клавишей Tab можно сделать отступ в текущей строке. @@ -1476,46 +758,30 @@ -Открытие/сохранение +Открытие/сохранение -Формат файла +Формат файла -Кодировка: +Кодировка: -Устанавливает кодировку по умолчанию для сохраняемых файлов. +Устанавливает кодировку по умолчанию для сохраняемых файлов. -Конец строки: +Конец строки: -Выбор необходимого формата окончания строк для текущего файла. Выбрать можно между форматами &UNIX;, DOS/&Windows; или Macintosh. +Выбор необходимого формата окончания строк для текущего файла. Выбрать можно между форматами &UNIX;, DOS/&Windows; или Macintosh. -Автоопределение формата конца строки +Автоопределение формата конца строки -Выбор этого параметра поредоставит редактору самостоятельно определять формат конца строки. Первое найденное окончание строки будет применено затем ко всему файлу. +Выбор этого параметра поредоставит редактору самостоятельно определять формат конца строки. Первое найденное окончание строки будет применено затем ко всему файлу. @@ -1523,24 +789,14 @@ -Использование памяти +Использование памяти -Количество загружаемых блоков для каждого файла: +Количество загружаемых блоков для каждого файла: -Редактор будет загружать в память указанное количество блоков текста (каждый примерно из 2048 строк). Если размер файла больше указанного предела, то остальные блоки будут сброшены на диск, а затем в случае надобности загружены в память. -Подобный сброс может вызывать задержки во время навигации по файлу. Большее количество блоков ускоряет работу за счёт увеличения количества используемой памяти. Лучше выбрать максимально доступное количество блоков. Ограничения разумны только в случае нехватки памяти. +Редактор будет загружать в память указанное количество блоков текста (каждый примерно из 2048 строк). Если размер файла больше указанного предела, то остальные блоки будут сброшены на диск, а затем в случае надобности загружены в память. +Подобный сброс может вызывать задержки во время навигации по файлу. Большее количество блоков ускоряет работу за счёт увеличения количества используемой памяти. Лучше выбрать максимально доступное количество блоков. Ограничения разумны только в случае нехватки памяти. @@ -1548,20 +804,13 @@ -Автоматическая очистка при открытии/сохранении +Автоматическая очистка при открытии/сохранении -Удалить завершающие пробелы +Удалить завершающие пробелы -Лишние пробелы в конце строки при загрузке и сохранении будут автоматически удаляться. +Лишние пробелы в конце строки при загрузке и сохранении будут автоматически удаляться. @@ -1569,20 +818,13 @@ -Папка файла настройки +Папка файла настройки -Глубина поиска файла настройки: +Глубина поиска файла настройки: -Редактор просмотрит заданное количество уровней иерархии папок в поисках файла настройки &kate; и загрузит из него строку настройки. +Редактор просмотрит заданное количество уровней иерархии папок в поисках файла настройки &kate; и загрузит из него строку настройки. @@ -1590,54 +832,31 @@ -Создавать резервную копию при сохранении -Создание резервной копии при сохранении означает, что при записи на диск изменённого файла будет записана также резервная копия с именем <prefix><filename><suffix>', без внесённых изменений. Суффикс по умолчанию ~, а префикс по умолчанию пуст. +Создавать резервную копию при сохранении +Создание резервной копии при сохранении означает, что при записи на диск изменённого файла будет записана также резервная копия с именем <prefix><filename><suffix>', без внесённых изменений. Суффикс по умолчанию ~, а префикс по умолчанию пуст. -Локальные файлы +Локальные файлы -Установите этот флажок, если хотите сохранять резервные копии локальных файлов. +Установите этот флажок, если хотите сохранять резервные копии локальных файлов. -Удалённые файлы +Удалённые файлы -Установите этот флажок, если хотите сохранять резервные копии удалённых файлов. +Установите этот флажок, если хотите сохранять резервные копии удалённых файлов. -Префикс +Префикс -Введите префикс для вставки перед именами сохраняемых резервных файлов. +Введите префикс для вставки перед именами сохраняемых резервных файлов. -Суффикс +Суффикс -Введите суффикс для вставки после имён сохраняемых резервных файлов. +Введите суффикс для вставки после имён сохраняемых резервных файлов. @@ -1649,87 +868,46 @@ -Подсветка -Эта группа параметров используется для изменения стилей подсветки для каждого типа языков программирования. Любые изменения, сделанные в других вкладках этого диалога, влияют только на данный стиль подсветки. +Подсветка +Эта группа параметров используется для изменения стилей подсветки для каждого типа языков программирования. Любые изменения, сделанные в других вкладках этого диалога, влияют только на данный стиль подсветки. -Подсветка: -Выбор языка для настройки. +Подсветка: +Выбор языка для настройки. -Сведения +Сведения -Просмотр сведений о правилах подсветки синтаксиса выбранного языка: имя автора и лицензия. +Просмотр сведений о правилах подсветки синтаксиса выбранного языка: имя автора и лицензия. -Свойства +Свойства -Расширения файлов: -Список расширений файлов, используемых для определения необходимого режима подсветки. - - -Типы MIME: -Нажатие кнопки с символом мастера вызовет диалог выбора доступных mime-типов.Текст в поле Расширения файлов при изменении mime-типа будет изменяться соответственно. - - -Приоритет: -Устанавливает приоритет правила подсветки. +Расширения файлов: +Список расширений файлов, используемых для определения необходимого режима подсветки. + + +Типы MIME: +Нажатие кнопки с символом мастера вызовет диалог выбора доступных mime-типов.Текст в поле Расширения файлов при изменении mime-типа будет изменяться соответственно. + + +Приоритет: +Устанавливает приоритет правила подсветки. -Загрузить... +Загрузить... -Нажатием этой кнопки можно загрузить новое или обновить существующее правило подсветки синтаксиса с веб-сайта &kate;. +Нажатием этой кнопки можно загрузить новое или обновить существующее правило подсветки синтаксиса с веб-сайта &kate;. @@ -1737,154 +915,67 @@ -Типы файлов -Здесь вы можете указать параметры редактора для разных типов файлов. При открытии документа, его тип определяется по расширению или mime-типу. Если подходят несколько типов, будет использован тип с высшим приоритетом. +Типы файлов +Здесь вы можете указать параметры редактора для разных типов файлов. При открытии документа, его тип определяется по расширению или mime-типу. Если подходят несколько типов, будет использован тип с высшим приоритетом. -Тип файла: -Тип файла с наивысшим приоритетом указывается в выпадающем списке первым. Если есть другие подходящие типы, они тоже присутствуют в списке. +Тип файла: +Тип файла с наивысшим приоритетом указывается в выпадающем списке первым. Если есть другие подходящие типы, они тоже присутствуют в списке. -Создать -Эта кнопка используется для создания нового типа файлов. При нажатии все поля под ней становятся редактируемыми, и в них вводятся те свойства, которыми должен обладать ваш новый тип файлов. - - -Удалить -Для удаления существующего типа файлов, выберите его в выпадающем списке и нажмите кнопку "Удалить". +Создать +Эта кнопка используется для создания нового типа файлов. При нажатии все поля под ней становятся редактируемыми, и в них вводятся те свойства, которыми должен обладать ваш новый тип файлов. + + +Удалить +Для удаления существующего типа файлов, выберите его в выпадающем списке и нажмите кнопку "Удалить". - + -Свойства текущего типа файлов -Тип файла с наивысшим приоритетом указывается в выпадающем списке первым. Если есть другие подходящие типы, они тоже присутствуют в списке. +Свойства текущего типа файлов +Тип файла с наивысшим приоритетом указывается в выпадающем списке первым. Если есть другие подходящие типы, они тоже присутствуют в списке. -Название: -Название типа текущего файла должно соответствовать тексту соответствующего пункта меню СервисТипы файлов . - - -Раздел: -Название раздела используется для организации типов файлов в меню СервисТипы файлов . - - -Переменные: -Это поле позволяет настроить обработку выбранных типов файлов с использованием переменных &kate;. Можно настроить почти любой параметр (подсветку, отступы, кодировку и т.п.).Список всех доступных переменных содержится в руководстве. - - -Расширения файлов: -Маски позволяют выбирать файлы по их расширению. Типичная маска состоит из звёздочки и расширения файла, например *.txt; *.text. Строка состоит из списка разделённых точкой с запятой масок. - - -Типы MIME: -Запускает мастер выбора mime-типов. - - -Приоритет: -Устанавливает приоритет типа файлов. Если при открытии файла к нему подходят несколько типов, будет использован тип с наивысшим приоритетом. +Название: +Название типа текущего файла должно соответствовать тексту соответствующего пункта меню СервисТипы файлов . + + +Раздел: +Название раздела используется для организации типов файлов в меню СервисТипы файлов . + + +Переменные: +Это поле позволяет настроить обработку выбранных типов файлов с использованием переменных &kate;. Можно настроить почти любой параметр (подсветку, отступы, кодировку и т.п.).Список всех доступных переменных содержится в руководстве. + + +Расширения файлов: +Маски позволяют выбирать файлы по их расширению. Типичная маска состоит из звёздочки и расширения файла, например *.txt; *.text. Строка состоит из списка разделённых точкой с запятой масок. + + +Типы MIME: +Запускает мастер выбора mime-типов. + + +Приоритет: +Устанавливает приоритет типа файлов. Если при открытии файла к нему подходят несколько типов, будет использован тип с наивысшим приоритетом. - + -Комбинации клавиш -Здесь можно изменить настройку горячих клавиш. Если хотите изменить настройки по умолчанию - выберите действие и нажмите кнопку По выбору. -Строка поиска позволяет просмотреть сочетания клавиш, определённые для различных действий. +Комбинации клавиш +Здесь можно изменить настройку горячих клавиш. Если хотите изменить настройки по умолчанию - выберите действие и нажмите кнопку По выбору. +Строка поиска позволяет просмотреть сочетания клавиш, определённые для различных действий. -Модули -На этой вкладке можно выбрать, какие модули вы хотели бы использовать. Выделив нужный модуль, с помощью появившейся кнопки можно Настроить его. +Модули +На этой вкладке можно выбрать, какие модули вы хотели бы использовать. Выделив нужный модуль, с помощью появившейся кнопки можно Настроить его. @@ -1893,702 +984,232 @@ -Настройка с помощью переменных документа +Настройка с помощью переменных документа -Переменные документа - аналог "modeline" в emacs и vi. Формат:kate: ИМЯ_ПЕРЕМЕННОЙ ЗНАЧЕНИЕ; [ ИМЯ_ПЕРЕМЕННОЙ ЗНАЧЕНИЕ; ... ], такие строки, конечно, могут быть расположены в комментариях (если такое понятие присутствует в формате файла). Имена переменных должны быть неразрывны. Всё, что расположено до следующих точки с запятой, есть значение. Точка с запятой необходимы. +Переменные документа - аналог "modeline" в emacs и vi. Формат:kate: ИМЯ_ПЕРЕМЕННОЙ ЗНАЧЕНИЕ; [ ИМЯ_ПЕРЕМЕННОЙ ЗНАЧЕНИЕ; ... ], такие строки, конечно, могут быть расположены в комментариях (если такое понятие присутствует в формате файла). Имена переменных должны быть неразрывны. Всё, что расположено до следующих точки с запятой, есть значение. Точка с запятой необходимы. -Пример строки с переменными, включающими расстановку отступов для файлов C++, java или javascript: // kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle; +Пример строки с переменными, включающими расстановку отступов для файлов C++, java или javascript: // kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle; -Поиск таких строк производится только в первых и последних 10 строках файла. +Поиск таких строк производится только в первых и последних 10 строках файла. -Кроме множества стандартных переменных katepart, таковые могут предоставляться модулями, в этом случае они должны быть описаны в документации к модулю. +Кроме множества стандартных переменных katepart, таковые могут предоставляться модулями, в этом случае они должны быть описаны в документации к модулю. -Как переменные обрабатываются в Kate - -Чтение конфигурации происходит в следующем порядке:Глобальная настройка.Данные восстановленного сеанса.Настройка "Типы файлов".Переменные документа.Изменённые во время работы параметры. При сохранении документа, все переменные в нём пересматриваются и перекрывают изменения (сделанные в меню или командами правки), произведённые во время работы. - -Переменные, не описанные ниже, хранятся в документе и могут использоваться другими объектами, такими как модули, для собственных целей. Например, переменная режима отступов использует для своей настройки переменные документа. - -Приведённые ниже переменные доступны в версии &kate; 2.4. В следующих версиях, возможно, будут добавлены другие. Возможны 3 типа значений переменных: -BOOL - on|off|true|false|1|0 -INTEGER - любое целое число -STRING - всё остальное +Как переменные обрабатываются в Kate + +Чтение конфигурации происходит в следующем порядке:Глобальная настройка.Данные восстановленного сеанса.Настройка "Типы файлов".Переменные документа.Изменённые во время работы параметры. При сохранении документа, все переменные в нём пересматриваются и перекрывают изменения (сделанные в меню или командами правки), произведённые во время работы. + +Переменные, не описанные ниже, хранятся в документе и могут использоваться другими объектами, такими как модули, для собственных целей. Например, переменная режима отступов использует для своей настройки переменные документа. + +Приведённые ниже переменные доступны в версии &kate; 2.4. В следующих версиях, возможно, будут добавлены другие. Возможны 3 типа значений переменных: +BOOL - on|off|true|false|1|0 +INTEGER - любое целое число +STRING - всё остальное -Доступные переменные - - -auto-bracketsBOOL -Включает/выключает автоскобки. - - - -auto-center-linesINT -Устанавливает количество строк автоцентровки. - - - -auto-insert-doxygenBOOL -Включает/выключает вставку лидирующей звёздочки в комментариях doxygen. Работает только с расстановщиком отступов cstyle. - - - -background-colorSTRING -Устанавливает фоновый цвет документа, например "#ff0000". - - - -backspace-indentsBOOL -Включает/выключает ввод отступов клавишей backspace. - - - -block-selectionBOOL -Включает/выключает поблочное выделение. - - - -bracket-highlight-colorSTRING -Устанавливает цвет подсветки скобок, например "#ff0000" - - - -current-line-colorSTRING -Устанавливает цвет активной строки, например "#ff0000". - - - -dynamic-word-wrapBOOL -Включает/выключает динамический перенос строк. - - - -eol | end-of-lineSTRING -Устанавливает режим конца строк. Возможные значения - unix, mac и dos - - - -encodingSTRING -Устанавливает кодировку документа. Называть кодировку нужно точно, например utf-8. - - - -font-sizeINT -Устанавливает размер шрифта. - - - -fontSTRING -Устанавливает гарнитуру шрифта. Называть гарнитуру нужно точно, например courier. - - - -icon-bar-colorSTRING -Устанавливает цвет панели значков, например #ff0000. - - - -icon-borderBOOL -Включает/выключает отображение панели значков. - - - -folding-markersBOOL -Включает/выключает отображение маркёров сворачивания блоков кода. - - - -indent-modeSTRING -Устанавливает режим расстановки переносов. Возможные значения - none, normal, cstyle, csands, python, xml. Подробности см. в разделе . - - - -indent-widthINT -Устанавливает ширину отступов. - - - -keep-extra-spacesBOOL -Включает/отключает учёт лишних пробелов при расчёте ширины отступа. - - - -keep-indent-profileBOOL -Если имеет значение true, то отступ не снимается с блока до тех пор, пока хоть одна строка сохраняет отступ. - - - -line-numbersBOOL -Включает/выключает отображение номеров строк. - - - -mixed-indentBOOL -Включает/выключает смешанные отступы в стиле Emacs. - - - -overwrite-modeBOOL -Включает/выключает режим замены. - - - -persistent-selectionBOOL -Включает/выключает снятие выделения текста при переводе курсора. - - - -remove-trailing-spaceBOOL -Включает/выключает динамическое удаление завершающих пробелов. - - - -replace-tabs-saveBOOL -Включает/выключает преобразование символов табуляции в пробелы при сохранении. - - - -replace-tabsBOOL -Включает/выключает динамическое преобразование символов табуляции в пробелы. - - - -replace-trailing-space-saveBOOL -Включает/выключает удаление завершающих пробелов при сохранении. - - - -schemeSTRING -Устанавливает цветовую схему. Строка должна содержать название одной из существующих в вашей системе цветовых схем. - - - -selection-colorSTRING -Устанавливает цвет выделенного текста, например "#ff0000". - - - -show-tabsBOOL -Включает/выключает отображение символов табуляции. - - - -smart-homeBOOL -Включает/выключает умную реакцию на Home. - - - -space-indentBOOL -Включает/выключает заполнение отступов пробелами. - - - -tab-indentsBOOL -Включает/выключает выполнение отступов символами табуляции. - - - -tab-widthINT -Устанавливает ширину табуляции. - - - -undo-stepsINT -Устанавливает максимальное количество откатов. - - - -word-wrap-columnINT -Устанавливает максимальную длину строк в случае, если включён автоматический перенос. - - - -word-wrap-marker-colorSTRING -Устанавливает цвет маркёров переноса, например "#ff0000". - - - -word-wrapBOOL -Включает/выключает жёсткий перенос слов. - - - -wrap-cursorBOOL -Включает/выключает перенос курсора. +Доступные переменные + + +auto-bracketsBOOL +Включает/выключает автоскобки. + + + +auto-center-linesINT +Устанавливает количество строк автоцентровки. + + + +auto-insert-doxygenBOOL +Включает/выключает вставку лидирующей звёздочки в комментариях doxygen. Работает только с расстановщиком отступов cstyle. + + + +background-colorSTRING +Устанавливает фоновый цвет документа, например "#ff0000". + + + +backspace-indentsBOOL +Включает/выключает ввод отступов клавишей backspace. + + + +block-selectionBOOL +Включает/выключает поблочное выделение. + + + +bracket-highlight-colorSTRING +Устанавливает цвет подсветки скобок, например "#ff0000" + + + +current-line-colorSTRING +Устанавливает цвет активной строки, например "#ff0000". + + + +dynamic-word-wrapBOOL +Включает/выключает динамический перенос строк. + + + +eol | end-of-lineSTRING +Устанавливает режим конца строк. Возможные значения - unix, mac и dos + + + +encodingSTRING +Устанавливает кодировку документа. Называть кодировку нужно точно, например utf-8. + + + +font-sizeINT +Устанавливает размер шрифта. + + + +fontSTRING +Устанавливает гарнитуру шрифта. Называть гарнитуру нужно точно, например courier. + + + +icon-bar-colorSTRING +Устанавливает цвет панели значков, например #ff0000. + + + +icon-borderBOOL +Включает/выключает отображение панели значков. + + + +folding-markersBOOL +Включает/выключает отображение маркёров сворачивания блоков кода. + + + +indent-modeSTRING +Устанавливает режим расстановки переносов. Возможные значения - none, normal, cstyle, csands, python, xml. Подробности см. в разделе . + + + +indent-widthINT +Устанавливает ширину отступов. + + + +keep-extra-spacesBOOL +Включает/отключает учёт лишних пробелов при расчёте ширины отступа. + + + +keep-indent-profileBOOL +Если имеет значение true, то отступ не снимается с блока до тех пор, пока хоть одна строка сохраняет отступ. + + + +line-numbersBOOL +Включает/выключает отображение номеров строк. + + + +mixed-indentBOOL +Включает/выключает смешанные отступы в стиле Emacs. + + + +overwrite-modeBOOL +Включает/выключает режим замены. + + + +persistent-selectionBOOL +Включает/выключает снятие выделения текста при переводе курсора. + + + +remove-trailing-spaceBOOL +Включает/выключает динамическое удаление завершающих пробелов. + + + +replace-tabs-saveBOOL +Включает/выключает преобразование символов табуляции в пробелы при сохранении. + + + +replace-tabsBOOL +Включает/выключает динамическое преобразование символов табуляции в пробелы. + + + +replace-trailing-space-saveBOOL +Включает/выключает удаление завершающих пробелов при сохранении. + + + +schemeSTRING +Устанавливает цветовую схему. Строка должна содержать название одной из существующих в вашей системе цветовых схем. + + + +selection-colorSTRING +Устанавливает цвет выделенного текста, например "#ff0000". + + + +show-tabsBOOL +Включает/выключает отображение символов табуляции. + + + +smart-homeBOOL +Включает/выключает умную реакцию на Home. + + + +space-indentBOOL +Включает/выключает заполнение отступов пробелами. + + + +tab-indentsBOOL +Включает/выключает выполнение отступов символами табуляции. + + + +tab-widthINT +Устанавливает ширину табуляции. + + + +undo-stepsINT +Устанавливает максимальное количество откатов. + + + +word-wrap-columnINT +Устанавливает максимальную длину строк в случае, если включён автоматический перенос. + + + +word-wrap-marker-colorSTRING +Устанавливает цвет маркёров переноса, например "#ff0000". + + + +word-wrapBOOL +Включает/выключает жёсткий перенос слов. + + + +wrap-cursorBOOL +Включает/выключает перенос курсора. diff --git a/tde-i18n-ru/docs/tdebase/kate/fundamentals.docbook b/tde-i18n-ru/docs/tdebase/kate/fundamentals.docbook index 35cd4cb8fe8..e891de5f96c 100644 --- a/tde-i18n-ru/docs/tdebase/kate/fundamentals.docbook +++ b/tde-i18n-ru/docs/tdebase/kate/fundamentals.docbook @@ -1,388 +1,141 @@ - -АндрейБалагута
uj2@mail.ru
Перевод на русскийНиколайШафоростов
shafff@ukr.net
Обновление перевода + +АндрейБалагута
uj2@mail.ru
Перевод на русскийНиколайШафоростов
shafff@ukr.net
Обновление перевода -Основы +Основы -Если вы когда-либо использовали текстовый редактор, у вас не возникнет проблем с &kate;. В следующих двух разделах Запуск &kate; и Работа в &kate; мы расскажем вам все, что нужно для того, чтобы начать продуктивно работать с редактором. +Если вы когда-либо использовали текстовый редактор, у вас не возникнет проблем с &kate;. В следующих двух разделах Запуск &kate; и Работа в &kate; мы расскажем вам все, что нужно для того, чтобы начать продуктивно работать с редактором. -Запуск &kate; +Запуск &kate; -Запустить &kate; можно двумя способами: из меню запуска или из командной строки. +Запустить &kate; можно двумя способами: из меню запуска или из командной строки. -Из меню запуска -Откройте меню программ &kde;, щёлкнув левой кнопкой мыши на значке с большой буквой K, которая находится на панели внизу вашего экрана. В появившемся меню запуска выберите подменю СлужебныеРедакторы. Появится список доступных редакторов. Выберите &kate;. - -Если вы не изменяли параметры конфигурации &kate;, он загрузит вам последние редактируемые файлы. Читайте раздел Настройка &kate;, чтобы узнать, как включить или выключить эту возможность. +Из меню запуска +Откройте меню программ &kde;, щёлкнув левой кнопкой мыши на значке с большой буквой K, которая находится на панели внизу вашего экрана. В появившемся меню запуска выберите подменю СлужебныеРедакторы. Появится список доступных редакторов. Выберите &kate;. + +Если вы не изменяли параметры конфигурации &kate;, он загрузит вам последние редактируемые файлы. Читайте раздел Настройка &kate;, чтобы узнать, как включить или выключить эту возможность. -Из командной строки +Из командной строки -Запустить &kate; можно набрав название программы в командной строке. Если вы укажете имя файла в качестве параметра, как это сделано в приведенном ниже примере, то редактор откроет или создаст этот файл. +Запустить &kate; можно набрав название программы в командной строке. Если вы укажете имя файла в качестве параметра, как это сделано в приведенном ниже примере, то редактор откроет или создаст этот файл. -%kate +%kate -Если у вас есть доступ в Internet, то можно открывать (и сохранять) удалённые файлы, благодаря реализации "прозрачной" работы с сетью в &kde;. +Если у вас есть доступ в Internet, то можно открывать (и сохранять) удалённые файлы, благодаря реализации "прозрачной" работы с сетью в &kde;. -%kate +%kate -Параметры командной строки -При запуске &kate; из командной строки можно указать следующие ключи: +Параметры командной строки +При запуске &kate; из командной строки можно указать следующие ключи: -kate +kate -Вывести основные ключи командной строки. +Вывести основные ключи командной строки. -kate +kate -Перечислить ключи, которые позволяют изменить способ взаимодействия &kate; и &Qt;. +Перечислить ключи, которые позволяют изменить способ взаимодействия &kate; и &Qt;. -kate +kate -Перечислить ключи, которые позволяют изменить способ взаимодействия &kate; и &kde;. +Перечислить ключи, которые позволяют изменить способ взаимодействия &kate; и &kde;. -kate сеанс +kate сеанс -Запустить kate и открыть сеанс сеанс. Если указанный сеанс не существует, он будет создан. Если &kate; с данным сеансом уже запущен, то переданные в командной строке файлы будут открыты в уже существующем окне программы. +Запустить kate и открыть сеанс сеанс. Если указанный сеанс не существует, он будет создан. Если &kate; с данным сеансом уже запущен, то переданные в командной строке файлы будут открыты в уже существующем окне программы. -kate URL +kate URL -Открыть файл в уже запущенном экземпляре &kate;, если такой есть. Так как &kate; имеет многодокументный интерфейс, в одном окне возможно открытие нескольких файлов (а служебная панель "Документы" позволяет переключаться между ними). Если вы хотите чтобы такое поведение было по умолчанию, вы можете соответствующим образом изменить привязки типов файлов в &kde; и создать alias в вашем интерпретаторе. +Открыть файл в уже запущенном экземпляре &kate;, если такой есть. Так как &kate; имеет многодокументный интерфейс, в одном окне возможно открытие нескольких файлов (а служебная панель "Документы" позволяет переключаться между ними). Если вы хотите чтобы такое поведение было по умолчанию, вы можете соответствующим образом изменить привязки типов файлов в &kde; и создать alias в вашем интерпретаторе. -kate PID +kate PID -Открыть файл в экземпляре с указанным PID (Process ID). Используется с ключом . +Открыть файл в экземпляре с указанным PID (Process ID). Используется с ключом . -kate кодировка URL -Кодировка файла. Вы можете, например, для файлов с расширением .cp1251 указать использовать кодировку Window$, а для .koi - KOI8-U. +kate кодировка URL +Кодировка файла. Вы можете, например, для файлов с расширением .cp1251 указать использовать кодировку Window$, а для .koi - KOI8-U. -kate строка URL -Перейти к строке с указанным номером после открытия документа. +kate строка URL +Перейти к строке с указанным номером после открытия документа. -kate позиция URL -Перейти в указанную позицию строки после открытия документа. +kate позиция URL +Перейти в указанную позицию строки после открытия документа. -kate -Получить текст из стандартного ввода. Аналогично указанию в качестве имени файла. +kate +Получить текст из стандартного ввода. Аналогично указанию в качестве имени файла. -kate -Поддерживается начиная с &kate; 2.5.1. Если она указана, переданные через командную строку файлы интерпретируются как временные и удаляются после закрытия, если только они не были изменены. +kate +Поддерживается начиная с &kate; 2.5.1. Если она указана, переданные через командную строку файлы интерпретируются как временные и удаляются после закрытия, если только они не были изменены. -kate +kate -Перечислить все ключи командной строки. +Перечислить все ключи командной строки. -kate +kate -Показать список авторов &kate; в окне терминала. +Показать список авторов &kate; в окне терминала. -kate +kate -Вывести версии &Qt;, &kde; и &kate;. +Вывести версии &Qt;, &kde; и &kate;. -kate +kate -Показать лицензию. +Показать лицензию. @@ -390,519 +143,183 @@ -Посредством Drag and Drop -&kate; использует протокол Drag and Drop &kde;. Файлы можно перетащить на &kate; с рабочего стола, из &konqueror; или с какого-нибудь удалённого сайта ftp, открытого в окне &konqueror;. +Посредством Drag and Drop +&kate; использует протокол Drag and Drop &kde;. Файлы можно перетащить на &kate; с рабочего стола, из &konqueror; или с какого-нибудь удалённого сайта ftp, открытого в окне &konqueror;. -Работа в &kate; -В разделе Начало работы вы узнаете о четырёх опциях, которые позволят вам быстро настроить основные возможности &kate;. Раздел Комбинации клавиш содержит описание некоторых сочетаний клавиш для тех, кто не может или не желает работать с мышью. +Работа в &kate; +В разделе Начало работы вы узнаете о четырёх опциях, которые позволят вам быстро настроить основные возможности &kate;. Раздел Комбинации клавиш содержит описание некоторых сочетаний клавиш для тех, кто не может или не желает работать с мышью. -Начало работы +Начало работы -В этом разделе описываются несколько подпунктов меню Настройка, которые помогут быстро настроить &kate; на ваш вкус. +В этом разделе описываются несколько подпунктов меню Настройка, которые помогут быстро настроить &kate; на ваш вкус. -Когда вы впервые запустите &kate; (если до сих пор ещё это не сделали) то увидите две области с белым фоном. Над ними будет находиться панель инструментов с наиболее часто используемыми командами. Ещё выше - строка меню. +Когда вы впервые запустите &kate; (если до сих пор ещё это не сделали) то увидите две области с белым фоном. Над ними будет находиться панель инструментов с наиболее часто используемыми командами. Ещё выше - строка меню. -Область слева - это боковая панель. В ней доступны список открытых файлов (вкладка "Документы") и проводник ("Проводник") в виде "служебных панелей". Переключаться между ними можно при помощи ярлыков, которые находятся вверху боковой панели. +Область слева - это боковая панель. В ней доступны список открытых файлов (вкладка "Документы") и проводник ("Проводник") в виде "служебных панелей". Переключаться между ними можно при помощи ярлыков, которые находятся вверху боковой панели. -Если &kate; запущен для открытия файла (например, из Konqueror), то в правой области вы увидите текст редактируемого файла, а в списке файлов, который находится на боковой панели -- его имя. С помощью селектора файлов можно просматривать файловую структуру и открывать файлы для редактирования. +Если &kate; запущен для открытия файла (например, из Konqueror), то в правой области вы увидите текст редактируемого файла, а в списке файлов, который находится на боковой панели -- его имя. С помощью селектора файлов можно просматривать файловую структуру и открывать файлы для редактирования. -Отобразить или скрыть служебные панели Проводник и Документы можно с помощью меню ОкноСлужебные панели. Это меню даст вам первое впечатление о мощи и гибкости &kate;. В этом разделе мы обсудим четыре пункта этого меню: +Отобразить или скрыть служебные панели Проводник и Документы можно с помощью меню ОкноСлужебные панели. Это меню даст вам первое впечатление о мощи и гибкости &kate;. В этом разделе мы обсудим четыре пункта этого меню: -Показать/Скрыть документы +Показать/Скрыть документы -Показать/скрыть список файлов. Если окно боковой панели не открыто, &kate; откроет его как отдельное, не присоединенное окно. Для того чтобы присоединить окно, зацепите его за две тонкие параллельные линии над закладками, щелкнув по ним левой кнопкой мыши, и, не отпуская кнопку, перетащите окно на редактируемую область. Когда вы найдёте то положение, которое вам нужно, отпустите левую кнопку мыши. +Показать/скрыть список файлов. Если окно боковой панели не открыто, &kate; откроет его как отдельное, не присоединенное окно. Для того чтобы присоединить окно, зацепите его за две тонкие параллельные линии над закладками, щелкнув по ним левой кнопкой мыши, и, не отпуская кнопку, перетащите окно на редактируемую область. Когда вы найдёте то положение, которое вам нужно, отпустите левую кнопку мыши. -Если вы успешно зацепили окно, указатель мыши превратится в две перпендикулярные двунаправленные стрелки -- курсор перетаскивания. +Если вы успешно зацепили окно, указатель мыши превратится в две перпендикулярные двунаправленные стрелки -- курсор перетаскивания. -Показать/Скрыть Проводник +Показать/Скрыть Проводник -Показать/скрыть селектор файлов. Этот пункт меню схож с предыдущим с одним различием: он управляет панелью проводника по файловой системе. +Показать/скрыть селектор файлов. Этот пункт меню схож с предыдущим с одним различием: он управляет панелью проводника по файловой системе. -Показать/Скрыть Терминал +Показать/Скрыть Терминал -Показать/скрыть эмулятор терминала внизу главного окна &kate;. Эмулятор терминала предоставляет вам командную строку внутри приложения. +Показать/скрыть эмулятор терминала внизу главного окна &kate;. Эмулятор терминала предоставляет вам командную строку внутри приложения. -Комбинации клавиш +Комбинации клавиш -Почти все сочетания клавиш &kate; можно перенастроить через меню Настройка. По умолчанию горячие клавиши в &kate; настроены следующим образом: +Почти все сочетания клавиш &kate; можно перенастроить через меню Настройка. По умолчанию горячие клавиши в &kate; настроены следующим образом: -Insert -Переключить режим ввода текста с режима вставки в режим замены. В режиме вставки при вводе символа текст справа от курсора будет смещён правее на одну позицию, и символ будет вставлен в освободившееся пространство. В режиме замены при вводе символ, который стоит справа от курсора, будет заменён введенным. +Insert +Переключить режим ввода текста с режима вставки в режим замены. В режиме вставки при вводе символа текст справа от курсора будет смещён правее на одну позицию, и символ будет вставлен в освободившееся пространство. В режиме замены при вводе символ, который стоит справа от курсора, будет заменён введенным. -Стрелка влево -Переместить курсор на один символ влево. +Стрелка влево +Переместить курсор на один символ влево. -Стрелка вправо -Переместить курсор на один символ вправо. +Стрелка вправо +Переместить курсор на один символ вправо. -Стрелка вверх -Переместить курсор на одну строку вверх. +Стрелка вверх +Переместить курсор на одну строку вверх. -Стрелка вниз -Переместить курсор на одну строку вниз. +Стрелка вниз +Переместить курсор на одну строку вниз. -Page Up -Переместить курсор на одну страницу вверх. +Page Up +Переместить курсор на одну страницу вверх. -Page Down -Переместить курсор на одну страницу вниз. +Page Down +Переместить курсор на одну страницу вниз. -Backspace -Удалить один символ слева от курсора +Backspace +Удалить один символ слева от курсора -Home -Переместить курсор на начало файла. +Home +Переместить курсор на начало файла. -End -Переместить курсор на конец файла. +End +Переместить курсор на конец файла. -Delete -Удалить один символ справа от курсора (или удалить весь выделенный текст). +Delete +Удалить один символ справа от курсора (или удалить весь выделенный текст). -&Shift;Стрелка влево -Выделить один символ текста слева от курсора. +&Shift;Стрелка влево +Выделить один символ текста слева от курсора. -&Shift;Стрелка вправо -Выделить один символ текста справа от курсора. +&Shift;Стрелка вправо +Выделить один символ текста справа от курсора. -F1 -Справка. +F1 +Справка. -&Shift;F1 -Что это? +&Shift;F1 +Что это? -&Ctrl;F -Поиск. +&Ctrl;F +Поиск. -F3 -Продолжить поиск. +F3 +Продолжить поиск. -&Ctrl;B -Поставить закладку. +&Ctrl;B +Поставить закладку. -&Ctrl;C -Копировать выделенный текст в буфер обмена. +&Ctrl;C +Копировать выделенный текст в буфер обмена. -&Ctrl;N -Создать документ. +&Ctrl;N +Создать документ. -&Ctrl;P -Печать. +&Ctrl;P +Печать. -&Ctrl;Q -Выход -- закрыть редактор. +&Ctrl;Q +Выход -- закрыть редактор. -&Ctrl;R -Замена. +&Ctrl;R +Замена. -&Ctrl;S -Сохранить текущий файл. +&Ctrl;S +Сохранить текущий файл. -&Ctrl;V -Вставить текст из буфера обмена. +&Ctrl;V +Вставить текст из буфера обмена. -&Ctrl;X -Скопировать выделенный текст в буфер обмена, после чего удалить его. +&Ctrl;X +Скопировать выделенный текст в буфер обмена, после чего удалить его. -&Ctrl;Z -Отменить действие. +&Ctrl;Z +Отменить действие. -&Ctrl;&Shift;Z -Повторить отмененное действие. +&Ctrl;&Shift;Z +Повторить отмененное действие. @@ -912,96 +329,36 @@ -Работа с сеансами - -Сеанс - это список документов, которые открываются при его открытии, и информация о расположении элементов интерфейса. Вы можете создавать бесконечное множество именованных сеансов и использовать безымянные и анонимные сеансы для файлов, открываемых только один раз. Благодаря реализации концепции сеансов появилась возможность запуска нескольких экземпляров &kate; одновременно - с разными сеансами в каждом. - -Поддержка сеансов присутствует в трёх областях: -Ключи командной строки - появилась возможность выбора сеанса, в котором следует открывать файлы. +Работа с сеансами + +Сеанс - это список документов, которые открываются при его открытии, и информация о расположении элементов интерфейса. Вы можете создавать бесконечное множество именованных сеансов и использовать безымянные и анонимные сеансы для файлов, открываемых только один раз. Благодаря реализации концепции сеансов появилась возможность запуска нескольких экземпляров &kate; одновременно - с разными сеансами в каждом. + +Поддержка сеансов присутствует в трёх областях: +Ключи командной строки - появилась возможность выбора сеанса, в котором следует открывать файлы. -Меню Сеанс - позволяет переключаться между сеансами. -Окно настройки - позволяет настроить параметры работы с сеансами. +Меню Сеанс - позволяет переключаться между сеансами. +Окно настройки - позволяет настроить параметры работы с сеансами. -При создании нового сеанса используется конфигурация Default Session. Для того чтобы сохранить конфигурацию окна в этом станартном сеансе, включите сохранение конфигурации окна на странице параметров сеансов (в настроках kate), загрузите станартный сеанс, настройте параметры окна и сохраните сеанс снова. - -При загрузке любого другого сеанса в заголовке окна &kate; выводится его имя, таким образом оно имеет формат "имя-сенаса: имя-документа-или-&URL; - &kate;" - -Если при открытии файлов из командной строк указывается ключ или он выбирается в диалоге выбора сеансов, то перед собственно открытием указанных файлов загружаются файлы их выбранного сеанса. Kate может открывать файлы всегда в новом сеансе. Для этого отметьте выберите соответствующий флажок на странице параметров сеанса в настройках программы, или укажите ключ с пустым аргументом: ''. - -Начиная с &kate; 2.5.1 PID текущего экземпляра экспортируется в переменную окружения KATE_PID. Для открытия файлов из встроенного терминала используется текущий экземпляр программы, если явно не указано иного. +При создании нового сеанса используется конфигурация Default Session. Для того чтобы сохранить конфигурацию окна в этом станартном сеансе, включите сохранение конфигурации окна на странице параметров сеансов (в настроках kate), загрузите станартный сеанс, настройте параметры окна и сохраните сеанс снова. + +При загрузке любого другого сеанса в заголовке окна &kate; выводится его имя, таким образом оно имеет формат "имя-сенаса: имя-документа-или-&URL; - &kate;" + +Если при открытии файлов из командной строк указывается ключ или он выбирается в диалоге выбора сеансов, то перед собственно открытием указанных файлов загружаются файлы их выбранного сеанса. Kate может открывать файлы всегда в новом сеансе. Для этого отметьте выберите соответствующий флажок на странице параметров сеанса в настройках программы, или укажите ключ с пустым аргументом: ''. + +Начиная с &kate; 2.5.1 PID текущего экземпляра экспортируется в переменную окружения KATE_PID. Для открытия файлов из встроенного терминала используется текущий экземпляр программы, если явно не указано иного. -Возврат к поведению, соответствующему старым версиям &kate; - -Использование нескольких сеансов позволяет эффективно организовать работу в разных областях - ведь для каждой из них требуется разный набор файлов. Однако, если вы отказываетесь принимать всё новое, вернуть старое поведение &kate; можно следующим образом: -Программа должна запускаться с ключом - добавьте его в команду запуска в привязках типов файлов, кроме того можно создать alias в вашем интерпретаторе. -Включите загрузку последнего сеанса при запуске программы. +Возврат к поведению, соответствующему старым версиям &kate; + +Использование нескольких сеансов позволяет эффективно организовать работу в разных областях - ведь для каждой из них требуется разный набор файлов. Однако, если вы отказываетесь принимать всё новое, вернуть старое поведение &kate; можно следующим образом: +Программа должна запускаться с ключом - добавьте его в команду запуска в привязках типов файлов, кроме того можно создать alias в вашем интерпретаторе. +Включите загрузку последнего сеанса при запуске программы. -Включите сохранение списка файлов при закрытии сеанса. -Загрузите сеанс по умолчанию +Включите сохранение списка файлов при закрытии сеанса. +Загрузите сеанс по умолчанию @@ -1011,70 +368,38 @@ -Получение помощи +Получение помощи -Получение помощи из &kate; +Получение помощи из &kate; -Данное руководство +Данное руководство -В нем детально описаны все команды меню, параметры настройки, инструменты, диалоговые окна, модули. Также здесь описано основное окно &kate;, сам редактор и различные понятия и концепции, которые используются в приложении. - -Чтобы открыть руководство, нажмите клавишу F1 или выберите пункт меню Справка Руководство &kate;. +В нем детально описаны все команды меню, параметры настройки, инструменты, диалоговые окна, модули. Также здесь описано основное окно &kate;, сам редактор и различные понятия и концепции, которые используются в приложении. + +Чтобы открыть руководство, нажмите клавишу F1 или выберите пункт меню Справка Руководство &kate;. -Контекстная помощь ("Что это?") +Контекстная помощь ("Что это?") -Контекстная помощь позволяет получить немедленную справку по какому-либо элементу графического окна, будь то кнопка или любая другая область окна. - -Мы постарались обеспечить контекстной помощью все элементы, для которых это имеет смысл. Окно настройки &kate; полностью снабжено контекстной помощью, также как и многие другие диалоговые окна. - -Чтобы вызвать контекстную помощь, нажмите сочетание клавиш &Shift;F1 или выберите пункт меню СправкаЧто это?. Указатель мыши изменится на стрелку со знаком вопроса; теперь вам просто нужно щелкнуть левой кнопкой мыши на нужном элементе окна -- небольшое окно с контекстной помощью тут же появится на экране (если, конечно, такая помощь доступна). +Контекстная помощь позволяет получить немедленную справку по какому-либо элементу графического окна, будь то кнопка или любая другая область окна. + +Мы постарались обеспечить контекстной помощью все элементы, для которых это имеет смысл. Окно настройки &kate; полностью снабжено контекстной помощью, также как и многие другие диалоговые окна. + +Чтобы вызвать контекстную помощь, нажмите сочетание клавиш &Shift;F1 или выберите пункт меню СправкаЧто это?. Указатель мыши изменится на стрелку со знаком вопроса; теперь вам просто нужно щелкнуть левой кнопкой мыши на нужном элементе окна -- небольшое окно с контекстной помощью тут же появится на экране (если, конечно, такая помощь доступна). -Кнопки помощи в диалоговых окнах +Кнопки помощи в диалоговых окнах -Некоторые диалоговые окна имеют кнопку Справка. Нажатие этой кнопки приведет к открытию соответствующего раздела документации в &khelpcenter;. +Некоторые диалоговые окна имеют кнопку Справка. Нажатие этой кнопки приведет к открытию соответствующего раздела документации в &khelpcenter;. @@ -1082,13 +407,9 @@ -Получение помощи из внешних файлов +Получение помощи из внешних файлов -Пока &kate; не предоставляет возможности чтения документации, относящейся к редактируемому документу. В зависимости от типа редактируемого файла, вам может быть полезен встроенный терминал &konsole;, например, для просмотра руководств &UNIX; (man-страницы) или документации в формате info. Вы также можете использовать &konqueror;. +Пока &kate; не предоставляет возможности чтения документации, относящейся к редактируемому документу. В зависимости от типа редактируемого файла, вам может быть полезен встроенный терминал &konsole;, например, для просмотра руководств &UNIX; (man-страницы) или документации в формате info. Вы также можете использовать &konqueror;. diff --git a/tde-i18n-ru/docs/tdebase/kate/highlighting.docbook b/tde-i18n-ru/docs/tdebase/kate/highlighting.docbook index 1d6c5867638..ea878e0651a 100644 --- a/tde-i18n-ru/docs/tdebase/kate/highlighting.docbook +++ b/tde-i18n-ru/docs/tdebase/kate/highlighting.docbook @@ -1,212 +1,105 @@ - -АндрейБалагута
uj2@mail.ru
Перевод на русскийАлексейОпарин
opaleksej@yandex.ru
Перевод на русский + +АндрейБалагута
uj2@mail.ru
Перевод на русскийАлексейОпарин
opaleksej@yandex.ru
Перевод на русский -Подсветка синтаксиса +Подсветка синтаксиса -Обзор +Обзор -Синтаксическая подсветка позволяет отображать текст в редакторе разными цветами и стилями, таким образом отделяя одни синтаксические понятия от других. Например, в исходном тексте программы можно ключевые слова выделить полужирным шрифтом, а типы данных и комментарии отображать разными цветами, выделяя их из основного текста. Это улучшает читаемость документа и повышает продуктивность работы автора. +Синтаксическая подсветка позволяет отображать текст в редакторе разными цветами и стилями, таким образом отделяя одни синтаксические понятия от других. Например, в исходном тексте программы можно ключевые слова выделить полужирным шрифтом, а типы данных и комментарии отображать разными цветами, выделяя их из основного текста. Это улучшает читаемость документа и повышает продуктивность работы автора. - -Функция Perl, отображенная с использованием синтаксической подсветки. -Функция Perl, отображенная с использованием синтаксической подсветки. + +Функция Perl, отображенная с использованием синтаксической подсветки. +Функция Perl, отображенная с использованием синтаксической подсветки. - -Та же самая функция, но без подсветки. -Та же самая функция, но без подсветки. + +Та же самая функция, но без подсветки. +Та же самая функция, но без подсветки. -Какой из примеров легче читать? - -&kate; имеет гибкую, легко настраиваемую систему синтаксической подсветки, в стандартную поставку редактора входят правила подсветки синтаксиса для большого числа языков программирования, разметки и других текстовых форматов. Все определения хранятся в простых текстовых файлах в формате &XML;, поэтому вы можете свободно создавать собственные правила. - -При открытии файла &kate; автоматически подбирает правила подсветки, основываясь на &MIME;-типе (который, в свою очередь, определяется расширением файла) или содержании файла, если расширения нет. Если &kate; неправильно определил тип файла, выберите нужный режим подсветки вручную в меню ДокументРежим подсветки. - -Вы можете настроить стили и цвета доступных синтаксических определений на вкладке Схемыдиалога Настройка &kate; , а соответствующие им &MIME;-типы - на вкладке Подсветка . +Какой из примеров легче читать? + +&kate; имеет гибкую, легко настраиваемую систему синтаксической подсветки, в стандартную поставку редактора входят правила подсветки синтаксиса для большого числа языков программирования, разметки и других текстовых форматов. Все определения хранятся в простых текстовых файлах в формате &XML;, поэтому вы можете свободно создавать собственные правила. + +При открытии файла &kate; автоматически подбирает правила подсветки, основываясь на &MIME;-типе (который, в свою очередь, определяется расширением файла) или содержании файла, если расширения нет. Если &kate; неправильно определил тип файла, выберите нужный режим подсветки вручную в меню ДокументРежим подсветки. + +Вы можете настроить стили и цвета доступных синтаксических определений на вкладке Схемыдиалога Настройка &kate; , а соответствующие им &MIME;-типы - на вкладке Подсветка . -Синтаксическая подсветка улучшает читаемость корректно оформленного текста, но не факт, что текст некорректен, если он неправильно отображается системой подсветки. Синтаксическая разметка текста - достаточно сложный процесс, сложность которого зависит от формата файла, поэтому авторы синтаксических определений считают удачей, если 98% текста отображается корректно, но не стоит забывать об оставшихся 2%. +Синтаксическая подсветка улучшает читаемость корректно оформленного текста, но не факт, что текст некорректен, если он неправильно отображается системой подсветки. Синтаксическая разметка текста - достаточно сложный процесс, сложность которого зависит от формата файла, поэтому авторы синтаксических определений считают удачей, если 98% текста отображается корректно, но не стоит забывать об оставшихся 2%. -На сайте &kate; вы можете загрузить обновлённые или дополнительные правила синтаксической подсветки. Для этого нужно щёлкнуть на кнопке Загрузить на вкладке Подсветка диалога Настройка &kate;. +На сайте &kate; вы можете загрузить обновлённые или дополнительные правила синтаксической подсветки. Для этого нужно щёлкнуть на кнопке Загрузить на вкладке Подсветка диалога Настройка &kate;. -Система синтаксической подсветки &kate; +Система синтаксической подсветки &kate; -В этом разделе подробно рассматривается механизм синтаксической подсветки &kate;. Прочитав его, вы сможете изменять существующие или создавать свои синтаксические определения. +В этом разделе подробно рассматривается механизм синтаксической подсветки &kate;. Прочитав его, вы сможете изменять существующие или создавать свои синтаксические определения. -Механизм работы - -Когда вы открываете файл, первое, что делает &kate; - определяет, какое синтаксическое определение использовать для него. При чтении и наборе система подсветки анализирует текст в редакторе, используя правила, указанные в синтаксическом определении, и помечает границы контекстов и стилей. - -При вводе система динамически анализирует текст, поэтому, если вы удалите символ, который был помечен как начало или конец контекста, стиль окружающего текста автоматически изменится. - -Синтаксические определения &kate; хранятся в &XML;-файлах. Они содержат: -Правила определения роли текста, организованного в контекстные блоки -Списки ключевых слов -Определения стилей +Механизм работы + +Когда вы открываете файл, первое, что делает &kate; - определяет, какое синтаксическое определение использовать для него. При чтении и наборе система подсветки анализирует текст в редакторе, используя правила, указанные в синтаксическом определении, и помечает границы контекстов и стилей. + +При вводе система динамически анализирует текст, поэтому, если вы удалите символ, который был помечен как начало или конец контекста, стиль окружающего текста автоматически изменится. + +Синтаксические определения &kate; хранятся в &XML;-файлах. Они содержат: +Правила определения роли текста, организованного в контекстные блоки +Списки ключевых слов +Определения стилей -Система подсветки анализирует текст последовательно от начала до конца. Указатель анализатора перемещается от символа к символу, проверяя текст на соответствие правилам и помечая границы контекстов. Правила применяются к текущей строке в порядке их объявления, и при соответствии к ней применяется контекст, указанный в правиле. После этого указатель смещается на конец области соответствия и начинается новый цикл проверки правил, принадлежащих установленному контексту. +Система подсветки анализирует текст последовательно от начала до конца. Указатель анализатора перемещается от символа к символу, проверяя текст на соответствие правилам и помечая границы контекстов. Правила применяются к текущей строке в порядке их объявления, и при соответствии к ней применяется контекст, указанный в правиле. После этого указатель смещается на конец области соответствия и начинается новый цикл проверки правил, принадлежащих установленному контексту. -Правила +Правила -Правила - это сердце системы подсветки. Правило может быть строкой, символом или регулярным выражением, с которым сравнивается текст документа. Оно содержит информацию о стиле, который будет применен к тексту, если последний соответствует правилу. Оно может переключить текущий контекст системы на явно указанный или предыдущий контекст. +Правила - это сердце системы подсветки. Правило может быть строкой, символом или регулярным выражением, с которым сравнивается текст документа. Оно содержит информацию о стиле, который будет применен к тексту, если последний соответствует правилу. Оно может переключить текущий контекст системы на явно указанный или предыдущий контекст. -Правила организованы в контекстные группы. Контекстная группа используется для определения главных понятий в формате, например, строка, заключенная в двойные кавычки, или блок комментария в исходном тексте программы. Такая организация правил позволяет предотвратить проверку правил, неприменимых к текущему контексту (правил из других контекстов). Эта структура делает систему подсветки более гибкой, позволяя определять одинаковые правила в разных контекстах, что делает возможным одинаковые последовательности символов отображать разными стилями в зависимости от контекста, в котором они находятся. +Правила организованы в контекстные группы. Контекстная группа используется для определения главных понятий в формате, например, строка, заключенная в двойные кавычки, или блок комментария в исходном тексте программы. Такая организация правил позволяет предотвратить проверку правил, неприменимых к текущему контексту (правил из других контекстов). Эта структура делает систему подсветки более гибкой, позволяя определять одинаковые правила в разных контекстах, что делает возможным одинаковые последовательности символов отображать разными стилями в зависимости от контекста, в котором они находятся. -Контексты могут образовываться динамически, чтобы сделать возможным использование правил, справедливых для данного момента. +Контексты могут образовываться динамически, чтобы сделать возможным использование правил, справедливых для данного момента. -Стили контекстов и ключевые слова +Стили контекстов и ключевые слова -В некоторых языках программирования целые и вещественные числа трактуются компилятором по-разному (компилятор - это программа, которая преобразует исходный текст программы в двоичный исполняемый файл). Синтаксис языка может определять символы, имеющие специальное значение, если они находятся в строке, заключенной в кавычки. В этих случаях есть смысл выделять их в тексте для более удобного чтения. Иногда бывает полезно выделять символы, не имеющие специального значения - это тоже под силу системе синтаксической подсветки &kate;. +В некоторых языках программирования целые и вещественные числа трактуются компилятором по-разному (компилятор - это программа, которая преобразует исходный текст программы в двоичный исполняемый файл). Синтаксис языка может определять символы, имеющие специальное значение, если они находятся в строке, заключенной в кавычки. В этих случаях есть смысл выделять их в тексте для более удобного чтения. Иногда бывает полезно выделять символы, не имеющие специального значения - это тоже под силу системе синтаксической подсветки &kate;. -Синтаксическое определение может содержать столько стилей, сколько нужно для данного формата. +Синтаксическое определение может содержать столько стилей, сколько нужно для данного формата. -Во многих форматах существуют списки слов, имеющих специальное значение. Например, в языках программирования такими словами будут являться управляющие операторы, названия типов данных и встроенные функции. Это концептуальные слова, поскольку они определяют саму суть синтаксиса. Система синтаксической подсветки &kate; использует списки подобных слов, чтобы подчеркнуть концептуальные элементы формата. +Во многих форматах существуют списки слов, имеющих специальное значение. Например, в языках программирования такими словами будут являться управляющие операторы, названия типов данных и встроенные функции. Это концептуальные слова, поскольку они определяют саму суть синтаксиса. Система синтаксической подсветки &kate; использует списки подобных слов, чтобы подчеркнуть концептуальные элементы формата. -Стили по умолчанию +Стили по умолчанию -Если вы откроете файл исходного кода на C++, на &Java; или документ HTML, то увидите, что разные форматы отображаются в одних и тех же цветах. Дело в том, что &kate; содержит предустановленный набор стандартных стилей. Синтаксические определения по возможности используют этот набор. +Если вы откроете файл исходного кода на C++, на &Java; или документ HTML, то увидите, что разные форматы отображаются в одних и тех же цветах. Дело в том, что &kate; содержит предустановленный набор стандартных стилей. Синтаксические определения по возможности используют этот набор. -Это позволяет подобным образом отображать похожие концепции в различных форматах. Например, комментарии есть почти во всех языках программирования, разметки и скриптах. +Это позволяет подобным образом отображать похожие концепции в различных форматах. Например, комментарии есть почти во всех языках программирования, разметки и скриптах. -Каждый стиль в синтаксическом определении основывается на одном из стандартных стилей. Поэтому, если вы часто используете какой-то формат с большим количеством стилей, следует проверить его конфигурацию на предмет их совпадения. Приведём небольшой пример. В &kate; определен всего один стандартный стиль для отображения строковых констант, но в языке программирования Perl существует два вида строк. Согласитесь, было бы гораздо лучше отображать их по разному - вы заходите в диалоговое окно настройки &kate; и изменяете соответствующие стили. Все доступные стандартные стили будут рассмотрены позже. +Каждый стиль в синтаксическом определении основывается на одном из стандартных стилей. Поэтому, если вы часто используете какой-то формат с большим количеством стилей, следует проверить его конфигурацию на предмет их совпадения. Приведём небольшой пример. В &kate; определен всего один стандартный стиль для отображения строковых констант, но в языке программирования Perl существует два вида строк. Согласитесь, было бы гораздо лучше отображать их по разному - вы заходите в диалоговое окно настройки &kate; и изменяете соответствующие стили. Все доступные стандартные стили будут рассмотрены позже. @@ -214,151 +107,59 @@ -&XML;-формат определения синтаксической подсветки +&XML;-формат определения синтаксической подсветки -Обзор - -В этом разделе вы познакомитесь с &XML;-форматом определения синтаксической подсветки. Вначале, на небольшом примере, будут кратко объяснены главные компоненты и их значение, затем мы более подробно остановимся на правилах подсветки. - -Формальное определение (DTD) находится в файле language.dtd, в каталоге $TDEDIR/share/apps/katepart/syntax. +Обзор + +В этом разделе вы познакомитесь с &XML;-форматом определения синтаксической подсветки. Вначале, на небольшом примере, будут кратко объяснены главные компоненты и их значение, затем мы более подробно остановимся на правилах подсветки. + +Формальное определение (DTD) находится в файле language.dtd, в каталоге $TDEDIR/share/apps/katepart/syntax. -Основные разделы файла определения синтаксической подсветки &kate; +Основные разделы файла определения синтаксической подсветки &kate; -В заголовке файла подсветки указаны версия XML и тип документа: +В заголовке файла подсветки указаны версия XML и тип документа: -<?xml version="1.0" encoding="UTF-8"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE language SYSTEM "language.dtd"> -Главная часть файла определений - элемент language. Доступные атрибуты: - - -Необходимые атрибуты: -name определяет название языка. Впоследствии оно появляется во всех меню и диалогах. -section указывает категорию. -extensions определяет расширения файлов, вроде "*.cpp;*.h" - -Дополнительные атрибуты: -mimetype связывает файл с определенным типом &MIME;. -version указывает текущую версию файла определений. -kateversion указывает новейшую из поддерживаемых версий &kate;. -casesensitive определяет чувствительность ключевых слов к регистру. -priority определяет приоритет в случае использования разных правил подсветки. Действует правило с высшим приоритетом. -author содержит имя и email-адрес автора. -license содержит лицензию, обычно LGPL, Artistic, GPL и т.п. -hidden определяет, будет ли отображаться название в меню &kate;. -Итак, следующая строка может быть примерно такой: -<language name="C++" version="1.00" kateversion="2.4" section="Sources" extensions="*.cpp;*.h" /> +Главная часть файла определений - элемент language. Доступные атрибуты: + + +Необходимые атрибуты: +name определяет название языка. Впоследствии оно появляется во всех меню и диалогах. +section указывает категорию. +extensions определяет расширения файлов, вроде "*.cpp;*.h" + +Дополнительные атрибуты: +mimetype связывает файл с определенным типом &MIME;. +version указывает текущую версию файла определений. +kateversion указывает новейшую из поддерживаемых версий &kate;. +casesensitive определяет чувствительность ключевых слов к регистру. +priority определяет приоритет в случае использования разных правил подсветки. Действует правило с высшим приоритетом. +author содержит имя и email-адрес автора. +license содержит лицензию, обычно LGPL, Artistic, GPL и т.п. +hidden определяет, будет ли отображаться название в меню &kate;. +Итак, следующая строка может быть примерно такой: +<language name="C++" version="1.00" kateversion="2.4" section="Sources" extensions="*.cpp;*.h" /> -Следующий элемент - highlighting, состоящий из необязательного list и обязательных - contexts и itemDatas. +Следующий элемент - highlighting, состоящий из необязательного list и обязательных - contexts и itemDatas. -Элемент list содержит список ключевых слов. В нашем случае это class и const.Списков можете добавить, сколько хотите. -Элемент contexts содержит все контексты. По умолчанию, подсветка начинается с первого контекста. В контексте Normal Text есть два правила, одно из которых проверяет наличие в тексте слов, соответствующих списку ключевых слов, другое определяет наличие кавычек и переключает контекст к строковому типу. Подробнее правила описаны в следующей главе. -Элемент itemDatas содержит сведения о цветах и стилях, применяющихся в контекстах и правилах. В нашем примере itemData использует контексты Normal Text, String и Keyword. -<highlighting> +Элемент list содержит список ключевых слов. В нашем случае это class и const.Списков можете добавить, сколько хотите. +Элемент contexts содержит все контексты. По умолчанию, подсветка начинается с первого контекста. В контексте Normal Text есть два правила, одно из которых проверяет наличие в тексте слов, соответствующих списку ключевых слов, другое определяет наличие кавычек и переключает контекст к строковому типу. Подробнее правила описаны в следующей главе. +Элемент itemDatas содержит сведения о цветах и стилях, применяющихся в контекстах и правилах. В нашем примере itemData использует контексты Normal Text, String и Keyword. +<highlighting> <list name="somename"> <item> class </item> <item> const </item> @@ -383,28 +184,12 @@ - Последня часть файла определения синтаксической подсветки - необязательный раздел general. Здесь могут содержаться сведения о ключевых словах, сворачивании блоков кода, комментариях и отступах. + Последня часть файла определения синтаксической подсветки - необязательный раздел general. Здесь могут содержаться сведения о ключевых словах, сворачивании блоков кода, комментариях и отступах. -Раздел comment определяет, какой строкой вводится однострочный комментарий. Можно пользоваться также многострочными комментариями, используя multiLine с дополнительным атрибутом end. Это используется тогда, когда пользователь нажимает комбинацию клавиш, назначенную для действия закомментировать/раскомментировать. -Секция keywords определяет чувствительность ключевых слов к регистру. Остальные атрибуты рассмотрим позднее. -<general> +Раздел comment определяет, какой строкой вводится однострочный комментарий. Можно пользоваться также многострочными комментариями, используя multiLine с дополнительным атрибутом end. Это используется тогда, когда пользователь нажимает комбинацию клавиш, назначенную для действия закомментировать/раскомментировать. +Секция keywords определяет чувствительность ключевых слов к регистру. Остальные атрибуты рассмотрим позднее. +<general> <comments> <comment name="singleLine" start="#"/> </comments> @@ -421,259 +206,80 @@ -Более подробно о разделах -В этой части указаны все возможные атрибуты для контекстов, itemDatas, ключевых слов, комментариев, сворачивания кодов и отступов. +Более подробно о разделах +В этой части указаны все возможные атрибуты для контекстов, itemDatas, ключевых слов, комментариев, сворачивания кодов и отступов. -Элемент context относится к группе contexts. Контекстом определяются некоторые особые правила (например, что происходит при достижении подсвеченной структурой конца строки). Доступные атрибуты: +Элемент context относится к группе contexts. Контекстом определяются некоторые особые правила (например, что происходит при достижении подсвеченной структурой конца строки). Доступные атрибуты: -name - название контекста. Правила используют это название для переключения на указанный контекст. -lineEndContext определяет, на какой контекст подсвеченная структура переключается при достижении конца строки. Это может быть название другого контекста, #stay, если контекст не меняется (т.е. не делать ничего) или #pop для выхода из контекста. Например, набор #pop#pop#pop приведет к троекратному выходу из контекста. -lineBeginContext определяет контекст при достижении начала строки. По умолчанию: #stay. -fallthrough определяет поведение в случае переключения подсвеченной структуры на контекст, указанный в fallthroughContext, если не найдено соответствующее правило. По умолчанию: false. -fallthroughContext указывает следующий контекст, если не найдено соответствующее правило. -Если dynamic имеет значение true, то контекст запоминает строки/метки-заполнители, сохранённые в динамических правилах. Это необходимо, например, для текущих документов. По умолчанию: false. +name - название контекста. Правила используют это название для переключения на указанный контекст. +lineEndContext определяет, на какой контекст подсвеченная структура переключается при достижении конца строки. Это может быть название другого контекста, #stay, если контекст не меняется (т.е. не делать ничего) или #pop для выхода из контекста. Например, набор #pop#pop#pop приведет к троекратному выходу из контекста. +lineBeginContext определяет контекст при достижении начала строки. По умолчанию: #stay. +fallthrough определяет поведение в случае переключения подсвеченной структуры на контекст, указанный в fallthroughContext, если не найдено соответствующее правило. По умолчанию: false. +fallthroughContext указывает следующий контекст, если не найдено соответствующее правило. +Если dynamic имеет значение true, то контекст запоминает строки/метки-заполнители, сохранённые в динамических правилах. Это необходимо, например, для текущих документов. По умолчанию: false. -Элемент itemData принадлежит группе itemDatas. Он определяет стиль и цвет шрифта, их можно устанавливать самому в тех случаях, когда это необходимо. И все же, рекомендуется придерживаться стандартных стилей, чтобы помочь пользователю свободно ориентироваться в любом языке . Название атрибута (name) и defStyleNum обязательны, остальные нет. Доступные атрибуты: +Элемент itemData принадлежит группе itemDatas. Он определяет стиль и цвет шрифта, их можно устанавливать самому в тех случаях, когда это необходимо. И все же, рекомендуется придерживаться стандартных стилей, чтобы помочь пользователю свободно ориентироваться в любом языке . Название атрибута (name) и defStyleNum обязательны, остальные нет. Доступные атрибуты: -name даёт название itemData. Контексты и правила будут использовать это название при обращении к itemData в своих атрибутах attribute. -defStyleNum определяет стиль, используемый по умолчанию. Доступные стандартные стили будут детально описаны ниже. -color определяет цвет. Правильные форматы '#rrggbb' или '#rgb'. -selColor определяет цвет выделенного текста. -Если italic имеет значение true, шрифт будет курсивным. -Если bold имеет значение true, шрифт будет полужирным. -Если underline имеет значение true, текст будет подчёркнут. -Если strikeout имеет значение true, текст будет зачёркнут. +name даёт название itemData. Контексты и правила будут использовать это название при обращении к itemData в своих атрибутах attribute. +defStyleNum определяет стиль, используемый по умолчанию. Доступные стандартные стили будут детально описаны ниже. +color определяет цвет. Правильные форматы '#rrggbb' или '#rgb'. +selColor определяет цвет выделенного текста. +Если italic имеет значение true, шрифт будет курсивным. +Если bold имеет значение true, шрифт будет полужирным. +Если underline имеет значение true, текст будет подчёркнут. +Если strikeout имеет значение true, текст будет зачёркнут. -Элемент keywords в группе general определяет свойства ключевых слов. Доступные атрибуты: +Элемент keywords в группе general определяет свойства ключевых слов. Доступные атрибуты: -casesensitive может быть true или false. Если true, все ключевые слова будут проверяться на соответствие с учетом регистра -weakDeliminator - это группа знаков, которые не могут разделять слова. Например, точка '.' - разделитель слов. Если ключевое слово в list содержит точку, оно будет использовано по назначению только, если точка будет определена как "нетвердый разделитель" (weak delimiter). -additionalDeliminator определяют дополнительные разделители. -wordWrapDeliminator определяют символы, после которых может происходить перевод строки. -По умолчанию разделителями слов и строк являются символы .():!+,-<=>%&*/;?[]^{|}~\, пробел (' ') и табуляция ('\t'). +casesensitive может быть true или false. Если true, все ключевые слова будут проверяться на соответствие с учетом регистра +weakDeliminator - это группа знаков, которые не могут разделять слова. Например, точка '.' - разделитель слов. Если ключевое слово в list содержит точку, оно будет использовано по назначению только, если точка будет определена как "нетвердый разделитель" (weak delimiter). +additionalDeliminator определяют дополнительные разделители. +wordWrapDeliminator определяют символы, после которых может происходить перевод строки. +По умолчанию разделителями слов и строк являются символы .():!+,-<=>%&*/;?[]^{|}~\, пробел (' ') и табуляция ('\t'). -Элемент comment в группе comments определяет свойства комментариев, которые используются в менюСервисЗакомментировать и СервисРаскомментировать. Доступные атрибуты: +Элемент comment в группе comments определяет свойства комментариев, которые используются в менюСервисЗакомментировать и СервисРаскомментировать. Доступные атрибуты: -name может быть singleLine или multiLine. Если выбрать multiLine, то потребуются атрибуты end и region. -start указывает строку начала комментария. В C++ это может быть "/*". -end указывает строку окончания комментария. В C++ это может быть "*/". -region должно быть названием сворачиваемого многострочного комментария. Допустим, если в ваших правилах указано beginRegion="Comment" ... endRegion="Comment", вы должны использовать region="Comment". В этом случае раскомментирование будет действовать, даже если не будет выделен весь текст многострочного комментария. Достаточно будет просто поместить курсор в его пределы. +name может быть singleLine или multiLine. Если выбрать multiLine, то потребуются атрибуты end и region. +start указывает строку начала комментария. В C++ это может быть "/*". +end указывает строку окончания комментария. В C++ это может быть "*/". +region должно быть названием сворачиваемого многострочного комментария. Допустим, если в ваших правилах указано beginRegion="Comment" ... endRegion="Comment", вы должны использовать region="Comment". В этом случае раскомментирование будет действовать, даже если не будет выделен весь текст многострочного комментария. Достаточно будет просто поместить курсор в его пределы. -Элемент folding в группе general определяет свойства сворачивания кода. Доступные атрибуты: +Элемент folding в группе general определяет свойства сворачивания кода. Доступные атрибуты: -Если indentationsensitive имеет значение true, то маркёры сворачивания кода будут располагаться с учетом отступов, как в языке сценариев Python. Чаще всего в этом нет необходимости, поэтому по умолчанию этот параметр определен как false. +Если indentationsensitive имеет значение true, то маркёры сворачивания кода будут располагаться с учетом отступов, как в языке сценариев Python. Чаще всего в этом нет необходимости, поэтому по умолчанию этот параметр определен как false. -Элемент indentation в группе general определяет формат отступов, однако мы настоятельно рекомендуем не менять этот элемент, так как отступы обычно определяются типом файла или добавлением режимной строки в текстовый файл. Если вы всё-таки укажете способ отступа, он может оказаться навязанным пользователю, которому совсем не нужен. Доступные атрибуты: +Элемент indentation в группе general определяет формат отступов, однако мы настоятельно рекомендуем не менять этот элемент, так как отступы обычно определяются типом файла или добавлением режимной строки в текстовый файл. Если вы всё-таки укажете способ отступа, он может оказаться навязанным пользователю, которому совсем не нужен. Доступные атрибуты: -mode - название формата отступов. Доступные форматы: normal, cstyle, csands, xml, python и varindent. +mode - название формата отступов. Доступные форматы: normal, cstyle, csands, xml, python и varindent. @@ -684,73 +290,26 @@ -Стандартные стили -Стандартные стили уже были кратко описаны: Стандартные стили предопределяют настройки цветов и шрифтов. +Стандартные стили +Стандартные стили уже были кратко описаны: Стандартные стили предопределяют настройки цветов и шрифтов. -Здесь приведен только список доступных стандартных стилей: - -dsNormal, для нормального текста. -dsKeyword, для ключевых слов. -dsDataType, для типов данных. -dsDecVal, для десятичных значений. -dsBaseN, для значений с основанием, отличным от10. -dsFloat, для значений с плавающей точкой. -dsChar, для символов. -dsString, для строк. -dsComment, для комментариев. -dsOthers, для всего остального. -dsAlert, для вывода предупреждений. -dsFunction, для вызова функций. -dsRegionMarker, для маркёров участков. -dsError, для подсветки ошибок и неверного синтаксиса. +Здесь приведен только список доступных стандартных стилей: + +dsNormal, для нормального текста. +dsKeyword, для ключевых слов. +dsDataType, для типов данных. +dsDecVal, для десятичных значений. +dsBaseN, для значений с основанием, отличным от10. +dsFloat, для значений с плавающей точкой. +dsChar, для символов. +dsString, для строк. +dsComment, для комментариев. +dsOthers, для всего остального. +dsAlert, для вывода предупреждений. +dsFunction, для вызова функций. +dsRegionMarker, для маркёров участков. +dsError, для подсветки ошибок и неверного синтаксиса. @@ -760,545 +319,262 @@ -Синтаксические правила +Синтаксические правила -В этом разделе описываются синтаксические правила. +В этом разделе описываются синтаксические правила. -При анализе строки каждое правило может запросить на проверку любое количество символов (даже ноль). Если правило подходит, к соответствующим символам применяется стиль или атрибут, определённый в правиле. Применяемое правило также может запросить переключение текущего контекста. +При анализе строки каждое правило может запросить на проверку любое количество символов (даже ноль). Если правило подходит, к соответствующим символам применяется стиль или атрибут, определённый в правиле. Применяемое правило также может запросить переключение текущего контекста. -Правило выглядит примерно так: +Правило выглядит примерно так: -<RuleName attribute="(identifier)" context="(identifier)" [rule specific attributes] /> +<RuleName attribute="(identifier)" context="(identifier)" [rule specific attributes] /> -Параметр attribute указывает, какой стиль применить к символам, соответствующим правилу. Параметр context определяет контекст, который будет установлен в случае применения правила. +Параметр attribute указывает, какой стиль применить к символам, соответствующим правилу. Параметр context определяет контекст, который будет установлен в случае применения правила. -Параметр context может принимать следующие значения: +Параметр context может принимать следующие значения: -Идентификатор, т.е. название контекста. +Идентификатор, т.е. название контекста. -order предписывает системе подсветки не менять текущий контекст (#stay) или вернуться к предыдущему контексту (#pop). -Чтобы вернуться назад на несколько контекстов, повторите нужное количество раз ключевое слово #pop: #pop#pop#pop +order предписывает системе подсветки не менять текущий контекст (#stay) или вернуться к предыдущему контексту (#pop). +Чтобы вернуться назад на несколько контекстов, повторите нужное количество раз ключевое слово #pop: #pop#pop#pop -Некоторые правила могут иметь дочерние правила, которые проверяются только в том случае, если текст соответствует родительскому правилу. Всей совпавшей строке будут присвоены атрибуты, определенные в родительском правиле. Вот пример правила с дочерними правилами: +Некоторые правила могут иметь дочерние правила, которые проверяются только в том случае, если текст соответствует родительскому правилу. Всей совпавшей строке будут присвоены атрибуты, определенные в родительском правиле. Вот пример правила с дочерними правилами: -<RuleName (attributes)> +<RuleName (attributes)> <ChildRuleName (attributes) /> ... </RuleName> -Параметры конкретных видов правил описаны в следующих разделах. +Параметры конкретных видов правил описаны в следующих разделах. -Общие атрибуты -У любого правила есть следующие атрибуты, (common attributes), доступные всегда. attribute и context обязательны, остальные - нет. +Общие атрибуты +У любого правила есть следующие атрибуты, (common attributes), доступные всегда. attribute и context обязательны, остальные - нет. -attribute: Атрибут, описывающий определённые itemData. +attribute: Атрибут, описывающий определённые itemData. -context: Определяет контекст, на который происходит переключение в случае соответствия правилу. +context: Определяет контекст, на который происходит переключение в случае соответствия правилу. -beginRegion: Начало сворачиваемого блока кода. По умолчанию: не установлен (unset). +beginRegion: Начало сворачиваемого блока кода. По умолчанию: не установлен (unset). -endRegion: Окончание сворачиваемого блока кода. По умолчанию: не установлен (unset). +endRegion: Окончание сворачиваемого блока кода. По умолчанию: не установлен (unset). -Если lookAhead имеет значение true, то система подсветки больше не будет обрабатывать соответствия. По умолчанию: false. +Если lookAhead имеет значение true, то система подсветки больше не будет обрабатывать соответствия. По умолчанию: false. -firstNonSpace: Соответствие, только если строка начинается не с пробела. По умолчанию: false. +firstNonSpace: Соответствие, только если строка начинается не с пробела. По умолчанию: false. -column: Соответствие, только если соответствует номер столбца. По умолчанию: не установлено (unset). +column: Соответствие, только если соответствует номер столбца. По умолчанию: не установлено (unset). -Динамические правила -У некоторых правил есть необязательный атрибут dynamic, имеющий логическое значение (по умолчанию false). Если dynamic установить true, то правило может использовать метки-заполнители, заменяющие текст, соответствующий правилу регулярного выражения, переключенного к текущему контексту по своим атрибутам string или char. В атрибуте string метка-заполнитель %N (где N - цифра) будет заменена номером N найденного регулярного выражения. В атрибуте char метка-заполнитель должна быть цифрой N, и будет заменена первым символом N найденного регулярного выражения. Чтобы правило могло использовать эти атрибуты, оно должно содержать параметр (dynamic). +Динамические правила +У некоторых правил есть необязательный атрибут dynamic, имеющий логическое значение (по умолчанию false). Если dynamic установить true, то правило может использовать метки-заполнители, заменяющие текст, соответствующий правилу регулярного выражения, переключенного к текущему контексту по своим атрибутам string или char. В атрибуте string метка-заполнитель %N (где N - цифра) будет заменена номером N найденного регулярного выражения. В атрибуте char метка-заполнитель должна быть цифрой N, и будет заменена первым символом N найденного регулярного выражения. Чтобы правило могло использовать эти атрибуты, оно должно содержать параметр (dynamic). -dynamic: логический атрибут (true|false). +dynamic: логический атрибут (true|false). -Более подробно о правилах +Более подробно о правилах -DetectChar +DetectChar -Проверка на совпадение с одним определенным символом. Используется, например, для определения завершающего символа строки, заключённой в кавычки. -<DetectChar char="(character)" (common attributes) (dynamic) /> -Параметр char определяет символ. +Проверка на совпадение с одним определенным символом. Используется, например, для определения завершающего символа строки, заключённой в кавычки. +<DetectChar char="(character)" (common attributes) (dynamic) /> +Параметр char определяет символ. -Detect2Chars +Detect2Chars -Проверка на совпадение с двумя символами в заданном порядке. -<Detect2Chars char="(character)" char1="(character)" (common attributes) (dynamic) /> -Параметр char определяет первый символ для проверки, char1 - второй. +Проверка на совпадение с двумя символами в заданном порядке. +<Detect2Chars char="(character)" char1="(character)" (common attributes) (dynamic) /> +Параметр char определяет первый символ для проверки, char1 - второй. -AnyChar +AnyChar -Проверка на совпадение с любым символом из заданного набора. -<AnyChar String="(string)" (common attributes) /> -Параметр String содержит набор допустимых символов. +Проверка на совпадение с любым символом из заданного набора. +<AnyChar String="(string)" (common attributes) /> +Параметр String содержит набор допустимых символов. -StringDetect +StringDetect -Проверка на совпадение со строкой. -<StringDetect String="(string)" [insensitive="true|false"] (common attributes) (dynamic) /> -Параметр String должен содержать строку, которую нужно проверить на соответствие. Атрибут insensitive по умолчанию имеет значение false, он влияет на сравнение строк. Если этот параметр установлен true, функция сравнения не будет учитывать регистр символов. +Проверка на совпадение со строкой. +<StringDetect String="(string)" [insensitive="true|false"] (common attributes) (dynamic) /> +Параметр String должен содержать строку, которую нужно проверить на соответствие. Атрибут insensitive по умолчанию имеет значение false, он влияет на сравнение строк. Если этот параметр установлен true, функция сравнения не будет учитывать регистр символов. -RegExpr +RegExpr -Проверка на совпадение с регулярным выражением. -<RegExpr String="(string)" [insensitive="true|false"] [minimal="true|false"] (common attributes) (dynamic) /> -Параметр String определяет регулярное выражение. -insensitive имеет то же значение, что и в предыдущем правиле; по умолчанию установлен false. -Параметр minimal по умолчанию имеет значение false и передаётся функции обработки регулярных выражений. -Символ перевода каретки (^) в начале регулярного выражения говорит о том, что данное правило будет применяться только к тем цепочкам символов, которые начинаются с новой строки. -Более подробно регулярные выражения рассматриваются в разделе Регулярные выражения. +Проверка на совпадение с регулярным выражением. +<RegExpr String="(string)" [insensitive="true|false"] [minimal="true|false"] (common attributes) (dynamic) /> +Параметр String определяет регулярное выражение. +insensitive имеет то же значение, что и в предыдущем правиле; по умолчанию установлен false. +Параметр minimal по умолчанию имеет значение false и передаётся функции обработки регулярных выражений. +Символ перевода каретки (^) в начале регулярного выражения говорит о том, что данное правило будет применяться только к тем цепочкам символов, которые начинаются с новой строки. +Более подробно регулярные выражения рассматриваются в разделе Регулярные выражения. -keyword +keyword -Проверка на ключевое слово из указанного списка. -<keyword String="(list name)" (common attributes) /> -В параметре String нужно указать название списка ключевых слов. Этот список должен существовать. +Проверка на ключевое слово из указанного списка. +<keyword String="(list name)" (common attributes) /> +В параметре String нужно указать название списка ключевых слов. Этот список должен существовать. -Int +Int -Проверка на целое число. -<Int (common attributes) (dynamic) /> -Это правило не имеет своих параметров. Дочерние правила обычно используются для определения комбинаций символов L и U после числа, которые конкретизируют тип целой константы в коде программы. Вообще, все правила могут быть использованы в качестве дочерних, хотя DTD разрешает использовать в качестве дочернего только правило StringDetect. -Пример проверки на целые числа, следующие за символом 'L'. <Int attribute="Decimal" context="#stay" > +Проверка на целое число. +<Int (common attributes) (dynamic) /> +Это правило не имеет своих параметров. Дочерние правила обычно используются для определения комбинаций символов L и U после числа, которые конкретизируют тип целой константы в коде программы. Вообще, все правила могут быть использованы в качестве дочерних, хотя DTD разрешает использовать в качестве дочернего только правило StringDetect. +Пример проверки на целые числа, следующие за символом 'L'. <Int attribute="Decimal" context="#stay" > <StringDetect attribute="Decimal" context="#stay" String="L" insensitive="true"/> </Int> - + -Float +Float -Проверка на число с плавающей точкой. -<Float (common attributes) /> -У этого правила нет особых атрибутов. AnyChar можно использовать как дочернее, обычно оно используется для проверки комбинаций. Для примера смотрите правило Int. +Проверка на число с плавающей точкой. +<Float (common attributes) /> +У этого правила нет особых атрибутов. AnyChar можно использовать как дочернее, обычно оно используется для проверки комбинаций. Для примера смотрите правило Int. -HlCOct +HlCOct -Проверка на восьмеричное число (должно начинаться с нуля). -<HlCOct (common attributes) /> -У этого правила нет особых атрибутов. +Проверка на восьмеричное число (должно начинаться с нуля). +<HlCOct (common attributes) /> +У этого правила нет особых атрибутов. -HlCHex +HlCHex -Проверка на шестнадцатеричное число (должно начинаться с символов 0x). -<HlCHex (common attributes) /> -У этого правила нет особых атрибутов. +Проверка на шестнадцатеричное число (должно начинаться с символов 0x). +<HlCHex (common attributes) /> +У этого правила нет особых атрибутов. -HlCStringChar +HlCStringChar -Проверка на управляющий символ. -<HlCStringChar (common attributes) /> -У этого правила нет особых атрибутов. - -Проверка на специальное представление символов, которое используется в языках программирования, например, \n (переход на новую строку) или \t (символ табуляции). - -Следующие символы соответствуют правилу, если они вводятся после обратной черты (\): abefnrtv"'?\. Также будут соответствовать шестнадцатеричные и восьмеричные числа, предварённые обратной чертой (например, \xff и \033). +Проверка на управляющий символ. +<HlCStringChar (common attributes) /> +У этого правила нет особых атрибутов. + +Проверка на специальное представление символов, которое используется в языках программирования, например, \n (переход на новую строку) или \t (символ табуляции). + +Следующие символы соответствуют правилу, если они вводятся после обратной черты (\): abefnrtv"'?\. Также будут соответствовать шестнадцатеричные и восьмеричные числа, предварённые обратной чертой (например, \xff и \033). -HlCChar +HlCChar -Проверка на символ C. -<HlCChar (common attributes) /> -У этого правила нет особых атрибутов. - -Правило находит символы C, заключенные в одинарные кавычки (например, 'c'). Внутри одинарных кавычек может быть как одиночный символ, так и управляющая последовательность, более подробно ознакомиться с которыми можно в описании правила HlCStringChar. +Проверка на символ C. +<HlCChar (common attributes) /> +У этого правила нет особых атрибутов. + +Правило находит символы C, заключенные в одинарные кавычки (например, 'c'). Внутри одинарных кавычек может быть как одиночный символ, так и управляющая последовательность, более подробно ознакомиться с которыми можно в описании правила HlCStringChar. -RangeDetect +RangeDetect -Проверка на строку, имеющую заданные начальный и конечный символы. -<RangeDetect char="(character)" char1="(character)" (common attributes) /> -char определяет символ, с которого начинается строка, а char1 - которым она заканчивается. -Это правило может быть использовано для поиска небольших строк, заключенных в кавычки, но, поскольку при проверке правила система подсветки работает с одной строкой, данное правило не сможет определить строку, разбитую символами перевода. +Проверка на строку, имеющую заданные начальный и конечный символы. +<RangeDetect char="(character)" char1="(character)" (common attributes) /> +char определяет символ, с которого начинается строка, а char1 - которым она заканчивается. +Это правило может быть использовано для поиска небольших строк, заключенных в кавычки, но, поскольку при проверке правила система подсветки работает с одной строкой, данное правило не сможет определить строку, разбитую символами перевода. -LineContinue +LineContinue -Проверка на символ перевода строки. -<LineContinue (common attributes) /> -У этого правила нет особых атрибутов. -Это правило может быть удобно для переключения контекста в конце строки, если последним знаком будет обратная черта ('\'). Это необходимо, например, в языках C/C++ для продолжения макросов и строк. +Проверка на символ перевода строки. +<LineContinue (common attributes) /> +У этого правила нет особых атрибутов. +Это правило может быть удобно для переключения контекста в конце строки, если последним знаком будет обратная черта ('\'). Это необходимо, например, в языках C/C++ для продолжения макросов и строк. -IncludeRules +IncludeRules -Включение правил из другого контекста или языка/файла. -<IncludeRules context="contextlink" [includeAttrib="true|false"] /> - -Атрибут context определяет контекст, из которого берётся правило. -Если это простая строка, то включаются все правила из другого контекста, например: <IncludeRules context="anotherContext" /> - -Если строка начинается с ##, то система подсветки найдёт описание для другого языка с указанным названием, например: <IncludeRules context="##C++" /> -Если includeAttrib выставить true, атрибут назначения должен быть таким же, как атрибут источника. Это необходимо, например, при вводе комментариев, если текст, соответствующий включаемому контексту, имеет иную подсветку, чем основной контекст. +Включение правил из другого контекста или языка/файла. +<IncludeRules context="contextlink" [includeAttrib="true|false"] /> + +Атрибут context определяет контекст, из которого берётся правило. +Если это простая строка, то включаются все правила из другого контекста, например: <IncludeRules context="anotherContext" /> + +Если строка начинается с ##, то система подсветки найдёт описание для другого языка с указанным названием, например: <IncludeRules context="##C++" /> +Если includeAttrib выставить true, атрибут назначения должен быть таким же, как атрибут источника. Это необходимо, например, при вводе комментариев, если текст, соответствующий включаемому контексту, имеет иную подсветку, чем основной контекст. -DetectSpaces +DetectSpaces -Поиск пробелов. -<DetectSpaces (common attributes) /> - -У этого правила нет особых атрибутов. -Используйте это правило, если вы уверены, что в тексте есть несколько пробелов подряд, например в начале строк с отступом. Это правило поможет пропустить все пробелы разом, вместо проверки каждого из них по нескольким параметрам. +Поиск пробелов. +<DetectSpaces (common attributes) /> + +У этого правила нет особых атрибутов. +Используйте это правило, если вы уверены, что в тексте есть несколько пробелов подряд, например в начале строк с отступом. Это правило поможет пропустить все пробелы разом, вместо проверки каждого из них по нескольким параметрам. -DetectIdentifier +DetectIdentifier -Поиск строк идентификаторов (таких как регулярные выражения: [a-zA-Z_][a-zA-Z0-9_]*). -<DetectIdentifier (common attributes) /> - -У этого правила нет особых атрибутов. -Используйте это правило, чтобы пропустить все буквенные символы разом, вместо проверки каждого из них по нескольким параметрам. +Поиск строк идентификаторов (таких как регулярные выражения: [a-zA-Z_][a-zA-Z0-9_]*). +<DetectIdentifier (common attributes) /> + +У этого правила нет особых атрибутов. +Используйте это правило, чтобы пропустить все буквенные символы разом, вместо проверки каждого из них по нескольким параметрам. @@ -1306,95 +582,45 @@ -Подсказки & Советы +Подсказки & Советы -Усвоив принцип действия переключения контекста, вы без труда сможете написать своё определение подсветки. Подумайте о том, в какой ситуации какое правило следует применить. Регулярные выражения - мощное средство, но, по сравнению с другими правилами, очень медленное. Поэтому стоит воспользоваться следующими советами. +Усвоив принцип действия переключения контекста, вы без труда сможете написать своё определение подсветки. Подумайте о том, в какой ситуации какое правило следует применить. Регулярные выражения - мощное средство, но, по сравнению с другими правилами, очень медленное. Поэтому стоит воспользоваться следующими советами. -Проверяя на соответствие только пару символов, воспользуйтесь Detect2Chars вместо StringDetect. То же относится к DetectChar. +Проверяя на соответствие только пару символов, воспользуйтесь Detect2Chars вместо StringDetect. То же относится к DetectChar. -Регулярные выражения несложны в использовании, но очень часто можно найти более быстрый способ. Допустим, вы ищете символ '#', это первый символ строки. Решение с регулярным выражением будет выглядеть примерно так: <RegExpr attribute="Macro" context="macro" String="^\s*#" />. Этой же цели можно достичь значительно быстрее: <DetectChar attribute="Macro" context="macro" char="#" firstNonSpace="true" />. Для поиска регулярного выражения '^#' можно применить DetectChar с атрибутом column="0". Отсчет для атрибута column идет посимвольно, поэтому знак табуляции для него - всего один символ. +Регулярные выражения несложны в использовании, но очень часто можно найти более быстрый способ. Допустим, вы ищете символ '#', это первый символ строки. Решение с регулярным выражением будет выглядеть примерно так: <RegExpr attribute="Macro" context="macro" String="^\s*#" />. Этой же цели можно достичь значительно быстрее: <DetectChar attribute="Macro" context="macro" char="#" firstNonSpace="true" />. Для поиска регулярного выражения '^#' можно применить DetectChar с атрибутом column="0". Отсчет для атрибута column идет посимвольно, поэтому знак табуляции для него - всего один символ. -Можно переключать контексты без специальных символов. Допустим, вы хотите переключить контекст при достижении строки */, но в новом контексте хотите продолжить обработку этой строки. Можно воспользоваться нижеследующим правилом, а атрибут lookAhead заставит систему подсветки сохранить найденную строку для нового контекста. <Detect2Chars attribute="Comment" context="#pop" char="*" char1="/" lookAhead="true" /> +Можно переключать контексты без специальных символов. Допустим, вы хотите переключить контекст при достижении строки */, но в новом контексте хотите продолжить обработку этой строки. Можно воспользоваться нижеследующим правилом, а атрибут lookAhead заставит систему подсветки сохранить найденную строку для нового контекста. <Detect2Chars attribute="Comment" context="#pop" char="*" char1="/" lookAhead="true" /> -Если известно, что в тексте много пробелов, воспользуйтесь DetectSpaces. +Если известно, что в тексте много пробелов, воспользуйтесь DetectSpaces. -Пользуйтесь DetectIdentifier вместо регулярного выражения '[a-zA-Z_]\w*'. +Пользуйтесь DetectIdentifier вместо регулярного выражения '[a-zA-Z_]\w*'. -Старайтесь использовать стандартные стили, это удобно для пользователя. +Старайтесь использовать стандартные стили, это удобно для пользователя. -Заглянув в другие XML-файлы, вы узнаете много нового о работе с правилами. +Заглянув в другие XML-файлы, вы узнаете много нового о работе с правилами. -Проверить правильность XML-файла можно командой xmllint --dtdvalid language.dtd mySyntax.xml. +Проверить правильность XML-файла можно командой xmllint --dtdvalid language.dtd mySyntax.xml. -Если сложное регулярное выражение встречается часто, воспользуйтесь ENTITIES. Пример: -<?xml version="1.0" encoding="UTF-8"?> +Если сложное регулярное выражение встречается часто, воспользуйтесь ENTITIES. Пример: +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE language SYSTEM "language.dtd" [ <!ENTITY myref "[A-Za-z_:][\w.:_-]*"> ]> -Теперь вместо регулярного выражения можно использовать &myref;. +Теперь вместо регулярного выражения можно использовать &myref;. diff --git a/tde-i18n-ru/docs/tdebase/kate/index.docbook b/tde-i18n-ru/docs/tdebase/kate/index.docbook index 4e9db8e5f3c..6b82ad5e600 100644 --- a/tde-i18n-ru/docs/tdebase/kate/index.docbook +++ b/tde-i18n-ru/docs/tdebase/kate/index.docbook @@ -13,163 +13,75 @@ - + ]> -Руководство &kate; +Руководство &kate; -&Anders.Lund; &Anders.Lund.mail; -&Seth.Rothberg; &Seth.Rothberg.mail; -&Dominik.Haumann; &Dominik.Haumann.mail; -АндрейБалагута
uj2@mail.ru
Перевод на русскийНиколайШафоростов
shafff@ukr.net
Редактирование переводаАлексейОпарин
opaleksej@yandex.ru
Перевод на русский +&Anders.Lund; &Anders.Lund.mail; +&Seth.Rothberg; &Seth.Rothberg.mail; +&Dominik.Haumann; &Dominik.Haumann.mail; +АндрейБалагута
uj2@mail.ru
Перевод на русскийНиколайШафоростов
shafff@ukr.net
Редактирование переводаАлексейОпарин
opaleksej@yandex.ru
Перевод на русский -2000 -2001 -&Seth.Rothberg; +2000 +2001 +&Seth.Rothberg; -200220032005 -&Anders.Lund; +200220032005 +&Anders.Lund; -2005 -&Dominik.Haumann; +2005 +&Dominik.Haumann; -&FDLNotice; +&FDLNotice; -2005-12-29 -2.5.0 +2005-12-29 +2.5.0 -&kate; — это текстовый редактор для программистов, для &kde; версии 2.2 и выше. +&kate; — это текстовый редактор для программистов, для &kde; версии 2.2 и выше. -В данном руководстве описан редактор &kate; версии 2.5.0 +В данном руководстве описан редактор &kate; версии 2.5.0 -KDE -tdebase -Kate -текст -редактор -программист -программирование -проекты -MDI -Многодокументный -Документы -интерфейс -терминал -консоль +KDE +tdebase +Kate +текст +редактор +программист +программирование +проекты +MDI +Многодокументный +Документы +интерфейс +терминал +консоль -Введение +Введение -Добро пожаловать в &kate; — мощный текстовый редактор для программистов, который работает в среде &kde; версии 2.2 и выше. Настраиваемая подсветка синтаксических конструкций для широкого диапазона языков программирования (начиная от C, C++ и HTML и заканчивая сценариями bash), возможность создавать и разрабатывать проекты, многодокументный интерфейс (MDI), встроенный эмулятор терминала — вот лишь небольшая часть возможностей &kate;. +Добро пожаловать в &kate; — мощный текстовый редактор для программистов, который работает в среде &kde; версии 2.2 и выше. Настраиваемая подсветка синтаксических конструкций для широкого диапазона языков программирования (начиная от C, C++ и HTML и заканчивая сценариями bash), возможность создавать и разрабатывать проекты, многодокументный интерфейс (MDI), встроенный эмулятор терминала — вот лишь небольшая часть возможностей &kate;. -&kate; — это больше, чем текстовый редактор для программистов. Многодокументный интерфейс позволит вам открыть и редактировать сразу несколько конфигурационных файлов &UNIX;. Этот документ был написан в &kate;. +&kate; — это больше, чем текстовый редактор для программистов. Многодокументный интерфейс позволит вам открыть и редактировать сразу несколько конфигурационных файлов &UNIX;. Этот документ был написан в &kate;. - -Редактирование этого руководства... + +Редактирование этого руководства... @@ -191,269 +103,127 @@ -Благодарности и лицензия +Благодарности и лицензия -Разработка © 2000-2005 Команда разработчиков &kate;. +Разработка © 2000-2005 Команда разработчиков &kate;. -Команда &kate;: +Команда &kate;: -Кристоф Куллманн (&Christoph.Cullmann;) &Christoph.Cullmann.mail; -Координатор проекта и ключевой разработчик +Кристоф Куллманн (&Christoph.Cullmann;) &Christoph.Cullmann.mail; +Координатор проекта и ключевой разработчик -Андерс Лунд (&Anders.Lund;) &Anders.Lund.mail; -Ключевой разработчик, подсветка синтаксиса для языка Perl, документация +Андерс Лунд (&Anders.Lund;) &Anders.Lund.mail; +Ключевой разработчик, подсветка синтаксиса для языка Perl, документация -Джозеф Веннингер (&Joseph.Wenninger;) &Joseph.Wenninger.mail; -Ключевой разработчик, подсветка синтаксиса +Джозеф Веннингер (&Joseph.Wenninger;) &Joseph.Wenninger.mail; +Ключевой разработчик, подсветка синтаксиса -Майкл Бартл (Michael Bartl) michael.bartl1@chello.at -Ключевой разработчик +Майкл Бартл (Michael Bartl) michael.bartl1@chello.at +Ключевой разработчик -Phlip phlip_cpp@my-deja.com -Компилятор проекта +Phlip phlip_cpp@my-deja.com +Компилятор проекта -Вальдо Бастиан (&Waldo.Bastian;) &Waldo.Bastian.mail; -Отличная система буферизации +Вальдо Бастиан (&Waldo.Bastian;) &Waldo.Bastian.mail; +Отличная система буферизации -Мэтт Ньювэл (Matt Newell) newellm@proaxis.com -Тестирование... +Мэтт Ньювэл (Matt Newell) newellm@proaxis.com +Тестирование... -Майкл Маккаллум (Michael McCallum) gholam@xtra.co.nz -Ключевой разработчик +Майкл Маккаллум (Michael McCallum) gholam@xtra.co.nz +Ключевой разработчик -Джохен Вилхемли (Jochen Wilhemly) digisnap@cs.tu-berlin.de -Автор KWrite +Джохен Вилхемли (Jochen Wilhemly) digisnap@cs.tu-berlin.de +Автор KWrite -Майкл Коч (&Michael.Koch;) &Michael.Koch.mail; -Перенос KWrite в KParts +Майкл Коч (&Michael.Koch;) &Michael.Koch.mail; +Перенос KWrite в KParts -Кристиан Гебайер (Christian Gebauer) gebauer@bigfoot.com -Точно не определено +Кристиан Гебайер (Christian Gebauer) gebauer@bigfoot.com +Точно не определено -Саймон Хаусман (&Simon.Hausmann;) &Simon.Hausmann.mail; -Точно не определено +Саймон Хаусман (&Simon.Hausmann;) &Simon.Hausmann.mail; +Точно не определено -Глен Паркер (Glen Parker) glenebob@nwlink.com -Журнал действий KWrite, интеграция KSpell +Глен Паркер (Glen Parker) glenebob@nwlink.com +Журнал действий KWrite, интеграция KSpell -Скотт Мэнсон (Scott Manson) sdmanson@alltel.net -Подсветка синтаксиса XML в KWrite +Скотт Мэнсон (Scott Manson) sdmanson@alltel.net +Подсветка синтаксиса XML в KWrite -Джон Файрбауг (&John.Firebaugh;) &John.Firebaugh.mail; -Заплатки и прочее +Джон Файрбауг (&John.Firebaugh;) &John.Firebaugh.mail; +Заплатки и прочее -Доминик Хаумани (&Dominik.Haumann;) &Dominik.Haumann.mail; -Разработчик, Мастер подсветки синтаксиса +Доминик Хаумани (&Dominik.Haumann;) &Dominik.Haumann.mail; +Разработчик, Мастер подсветки синтаксиса -Много других людей внесли свой вклад: +Много других людей внесли свой вклад: -Матэо Мэрли (Matteo Merli) merlim@libero.it -Подсветка для Spec-файлов RPM, Diff и прочее +Матэо Мэрли (Matteo Merli) merlim@libero.it +Подсветка для Spec-файлов RPM, Diff и прочее -Роки Скалетта (Rocky Scaletta) rocky@purdue.edu -Подсветка для VHDL +Роки Скалетта (Rocky Scaletta) rocky@purdue.edu +Подсветка для VHDL -Юрий Лебедев -Подсветка для SQL +Юрий Лебедев +Подсветка для SQL -Крис Роз (Chris Ross) -Подсветка для Ferite +Крис Роз (Chris Ross) +Подсветка для Ferite -Ник Роукс (Nick Roux) -Подсветка для ILERPG +Ник Роукс (Nick Roux) +Подсветка для ILERPG -Джон Файрбауг (John Firebaugh) -Подсветка для Java и прочее +Джон Файрбауг (John Firebaugh) +Подсветка для Java и прочее -Карстэн Найхаус (Carsten Niehaus) -Подсветка для LaTeX +Карстэн Найхаус (Carsten Niehaus) +Подсветка для LaTeX -Пэр Вигрэн (Per Wigren) -Подсветка файлов сборки, а также для Python +Пэр Вигрэн (Per Wigren) +Подсветка файлов сборки, а также для Python -Джэн Фритц (Jan Fritz) -Подсветка для Python +Джэн Фритц (Jan Fritz) +Подсветка для Python -Дэниэл Нэбер (&Daniel.Naber;) -Исправление ошибок, модуль XML +Дэниэл Нэбер (&Daniel.Naber;) +Исправление ошибок, модуль XML -Документация © 2000-2001 Сэт Ротберг (&Seth.Rothberg;) &Seth.Rothberg.mail; - -Документация © 2002-2005 Андерс Лунд (&Anders.Lund;) &Anders.Lund.mail; - -Перевод на русский: Андрей Балагута uj2@mail.ruРедакция и обновление перевода: Николай Шафоростов shafff@ukr.netОбновление перевода: Алексей Опарин opaleksej@yandex.ru +Документация © 2000-2001 Сэт Ротберг (&Seth.Rothberg;) &Seth.Rothberg.mail; + +Документация © 2002-2005 Андерс Лунд (&Anders.Lund;) &Anders.Lund.mail; + +Перевод на русский: Андрей Балагута uj2@mail.ruРедакция и обновление перевода: Николай Шафоростов shafff@ukr.netОбновление перевода: Алексей Опарин opaleksej@yandex.ru &underFDL; &underGPL; &highlighting-appendix; @@ -461,8 +231,7 @@ ®exp-appendix; -Установка +Установка &install.intro.documentation; diff --git a/tde-i18n-ru/docs/tdebase/kate/man-kate.1.docbook b/tde-i18n-ru/docs/tdebase/kate/man-kate.1.docbook index 65a3f45eece..3d77a4e0d6c 100644 --- a/tde-i18n-ru/docs/tdebase/kate/man-kate.1.docbook +++ b/tde-i18n-ru/docs/tdebase/kate/man-kate.1.docbook @@ -5,272 +5,96 @@ -Руководство пользователя KDE -&Lauri.Watts; &Lauri.Watts.mail; -07 июня 2005 K Desktop Environment +Руководство пользователя KDE +&Lauri.Watts; &Lauri.Watts.mail; +07 июня 2005 K Desktop Environment -kate -1 +kate +1 -kate -Улучшенный текстовый редактор для &kde; +kate +Улучшенный текстовый редактор для &kde; -kate name pid name line column Специфические параметры KDE Специфические параметры Qt +kate name pid name line column Специфические параметры KDE Специфические параметры Qt -Описание -&kate; — улучшенный текстовый редактор для &kde;. -&kate; также предоставляет компонент текстового редактора &kwrite; для других приложений. -Лишь некоторые из множества возможностей &kate;: настраиваемая подсветка синтаксиса для различных языков, от C и C++ до HTML и скриптов оболочки bash, возможность создавать и сопровождать проекты, многодокументный интерфейс (MDI) и встроенный эмулятор терминала. +Описание +&kate; — улучшенный текстовый редактор для &kde;. +&kate; также предоставляет компонент текстового редактора &kwrite; для других приложений. +Лишь некоторые из множества возможностей &kate;: настраиваемая подсветка синтаксиса для различных языков, от C и C++ до HTML и скриптов оболочки bash, возможность создавать и сопровождать проекты, многодокументный интерфейс (MDI) и встроенный эмулятор терминала. -&kate; — это больше чем редактор для программистов. Возможность открывать несколько файлов за раз делает его идеальным для редактирования множества конфигурационных файлов &UNIX;. Этот документ был написан в &kate;. +&kate; — это больше чем редактор для программистов. Возможность открывать несколько файлов за раз делает его идеальным для редактирования множества конфигурационных файлов &UNIX;. Этот документ был написан в &kate;. -Параметры +Параметры -, имя +, имя -Запуск &kate; с указанным сеансом. +Запуск &kate; с указанным сеансом. - -Применить к запущенному экземпляру (если возможно) + +Применить к запущенному экземпляру (если возможно) - pid -Использовать экземпляр с указанным идентификатором процесса pid + pid +Использовать экземпляр с указанным идентификатором процесса pid - имя -Использовать указанную кодировку для открываемого файлаИспользуйте этот параметр, чтобы файл был открыт в кодировке utf-8.Команда iconv -l выводит список доступных кодировок. + имя +Использовать указанную кодировку для открываемого файлаИспользуйте этот параметр, чтобы файл был открыт в кодировке utf-8.Команда iconv -l выводит список доступных кодировок. - строка -Перейти на указанную строку + строка +Перейти на указанную строку - столбец -Перейти на указанный столбец + столбец +Перейти на указанный столбец - -Читать со стандартного ввода + +Читать со стандартного ввода -См. также +См. также -kwrite(1) +kwrite(1) -Более подробная документация доступна по ссылке help:/kate (введите этот URL в &konqueror; или выполните команду khelpcenter help:/kate). +Более подробная документация доступна по ссылке help:/kate (введите этот URL в &konqueror; или выполните команду khelpcenter help:/kate). -Дополнительная информация доступна на веб-сайте &kate;. +Дополнительная информация доступна на веб-сайте &kate;. -Примеры +Примеры -Открыть файл source.cpp в существующем окне &kate;, установив курсор в столбце 15 и строке 25: -kate source.cpp +Открыть файл source.cpp в существующем окне &kate;, установив курсор в столбце 15 и строке 25: +kate source.cpp -Если у вас имеется подключение к Интернету, вы можете использовать преимущество сетевой прозрачности &kde;, открыв файл напрямую с сервера FTP. Если у вас нет права на запись на удалённый сервер, то файл будет открыт только для чтения и вам потребуется указать имя локального файла для сохранения сделанных изменений. Если же у вас имеется право на запись, то изменения будут сохранятся сразу по сети. -kate +Если у вас имеется подключение к Интернету, вы можете использовать преимущество сетевой прозрачности &kde;, открыв файл напрямую с сервера FTP. Если у вас нет права на запись на удалённый сервер, то файл будет открыт только для чтения и вам потребуется указать имя локального файла для сохранения сделанных изменений. Если же у вас имеется право на запись, то изменения будут сохранятся сразу по сети. +kate - -Авторы -Сопровождение &kate; осуществляет &Christoph.Cullmann; &Christoph.Cullmann.mail;. Полный список авторов и распространителей доступен в полной версии руководства пользователя, упомянутого выше. +Авторы +Сопровождение &kate; осуществляет &Christoph.Cullmann; &Christoph.Cullmann.mail;. Полный список авторов и распространителей доступен в полной версии руководства пользователя, упомянутого выше. diff --git a/tde-i18n-ru/docs/tdebase/kate/mdi.docbook b/tde-i18n-ru/docs/tdebase/kate/mdi.docbook index 27eac562a43..0b14e806aa8 100644 --- a/tde-i18n-ru/docs/tdebase/kate/mdi.docbook +++ b/tde-i18n-ru/docs/tdebase/kate/mdi.docbook @@ -1,84 +1,38 @@ -&Anders.Lund; &Anders.Lund.mail; -АндрейБалагута
uj2@mail.ru
Перевод на русский +&Anders.Lund; &Anders.Lund.mail; +АндрейБалагута
uj2@mail.ru
Перевод на русский -Работа с многодокументным интерфейсом &kate; +Работа с многодокументным интерфейсом &kate; -Обзор +Обзор -Окно, представление, документ, панель, редактор... Что означают эти понятия в терминологии &kate;? Эта глава даст ответы на все вопросы, связанные с окнами &kate;. +Окно, представление, документ, панель, редактор... Что означают эти понятия в терминологии &kate;? Эта глава даст ответы на все вопросы, связанные с окнами &kate;. -Главное окно +Главное окно -Главное окно Главное окно &kate; -- это стандартное окно приложения &kde; с несколькими служебными панелями, открываемыми через боковые вкладки. Главное окно содержит строку меню с расположенными на ней подменю и панель инструментов, на которой находятся кнопки для часто используемых команд. +Главное окно Главное окно &kate; -- это стандартное окно приложения &kde; с несколькими служебными панелями, открываемыми через боковые вкладки. Главное окно содержит строку меню с расположенными на ней подменю и панель инструментов, на которой находятся кнопки для часто используемых команд. -Самая главная часть окна -- это область редактирования; по умолчанию она содержит один компонент для редактирования текста, в котором вы будете работать с документами. +Самая главная часть окна -- это область редактирования; по умолчанию она содержит один компонент для редактирования текста, в котором вы будете работать с документами. -Окно инструментов может быть пристыковано к главному окну, после чего оно ведет себя как обычный элемент управления (посмотрите на панель инструментов -- и вы поймёте). Список окон инструментов, использующих возможности пристыковки: +Окно инструментов может быть пристыковано к главному окну, после чего оно ведет себя как обычный элемент управления (посмотрите на панель инструментов -- и вы поймёте). Список окон инструментов, использующих возможности пристыковки: -Список файлов -Файловая система -Встроенный эмулятор терминала +Список файлов +Файловая система +Встроенный эмулятор терминала -И, возможно, другие служебные панели, добавляемые модулями. +И, возможно, другие служебные панели, добавляемые модулями. -Размещение служебных панелей можно изменить. Для это щёлкните правой кнопкой на вкладке панели и выберите край экрана, в который следует её перенести. +Размещение служебных панелей можно изменить. Для это щёлкните правой кнопкой на вкладке панели и выберите край экрана, в который следует её перенести. -Служебная панель может иметь Постоянное размещение. В этом случае при переходе к другой служебной панели последней будет выделено не всё пространство, а при её скрытии будет показана служебная панель, имеющая постоянное размещение. +Служебная панель может иметь Постоянное размещение. В этом случае при переходе к другой служебной панели последней будет выделено не всё пространство, а при её скрытии будет показана служебная панель, имеющая постоянное размещение. @@ -87,173 +41,83 @@ -Область редактирования +Область редактирования -Область редактирования В &kate; можно редактировать несколько документов одновременно, разделив область редактирования на панели(наподобие тех, что используются в &konqueror; и emacs). Используя панели (фреймы), вы можете просматривать в области редактирования несколько документов (или несколько экземпляров одного документа). Например, если в начале файла у вас расположены важные определения, с которыми вы будете часто сверяться, то вы наверняка оцените эту возможность по достоинству. Ещё пример: если вы пишете программу, то удобно будет в одной панели открыть заголовочный файл, а в другом -- файл реализации. +Область редактирования В &kate; можно редактировать несколько документов одновременно, разделив область редактирования на панели(наподобие тех, что используются в &konqueror; и emacs). Используя панели (фреймы), вы можете просматривать в области редактирования несколько документов (или несколько экземпляров одного документа). Например, если в начале файла у вас расположены важные определения, с которыми вы будете часто сверяться, то вы наверняка оцените эту возможность по достоинству. Ещё пример: если вы пишете программу, то удобно будет в одной панели открыть заголовочный файл, а в другом -- файл реализации. -Если один и тот же документ открыть в нескольких панелях редактора, то все изменения (редактирование и выделение текста), сделанные в одной панели, будут немедленно отражены во всех остальных. Операция поиска и перемещение курсора действуют только в активной панели. +Если один и тот же документ открыть в нескольких панелях редактора, то все изменения (редактирование и выделение текста), сделанные в одной панели, будут немедленно отражены во всех остальных. Операция поиска и перемещение курсора действуют только в активной панели. -В текущей версии &kate; нельзя открыть один и тот же документ несколько раз в том смысле, что редактироваться будет только один экземпляр, и изменения не будут отражаться во втором. +В текущей версии &kate; нельзя открыть один и тот же документ несколько раз в том смысле, что редактироваться будет только один экземпляр, и изменения не будут отражаться во втором. -После разделения редактора на две панели они имеют одинаковую ширину и отображают текущий документ этого редактора. Новая панель будет снизу (в случае разделения по горизонтали) или справа (в случае разделения по вертикали). Активной становится новая панель -- об этом говорит маленький зелёный индикатор в строке состояния. +После разделения редактора на две панели они имеют одинаковую ширину и отображают текущий документ этого редактора. Новая панель будет снизу (в случае разделения по горизонтали) или справа (в случае разделения по вертикали). Активной становится новая панель -- об этом говорит маленький зелёный индикатор в строке состояния. -Список документов - -Список файлов Список файлов показывает все открытые документы в виде списка. Рядом с изменёнными файлами отображается небольшая пиктограмма в виде дискеты. - -Если открыты два или более файлов с одинаковыми именами (расположенные в разных каталогах), после имени второго будет добавлено <2> и т.д. Во всплывающей подсказке документа отображается полное имя, включающее путь - это поможет вам не запутаться и выбрать нужный файл. Чтобы отобразить документ в активной панели, щёлкните в списке на имени документа. - -Список файлов можно отсортировать посредством выбора команд из контекстного меню, это можно сделать по: +Список документов + +Список файлов Список файлов показывает все открытые документы в виде списка. Рядом с изменёнными файлами отображается небольшая пиктограмма в виде дискеты. + +Если открыты два или более файлов с одинаковыми именами (расположенные в разных каталогах), после имени второго будет добавлено <2> и т.д. Во всплывающей подсказке документа отображается полное имя, включающее путь - это поможет вам не запутаться и выбрать нужный файл. Чтобы отобразить документ в активной панели, щёлкните в списке на имени документа. + +Список файлов можно отсортировать посредством выбора команд из контекстного меню, это можно сделать по: -Порядку открытия -По порядку открытия +Порядку открытия +По порядку открытия -Имени документа -По имени документа. +Имени документа +По имени документа. -URL -По их полному имени (с протоколом). +URL +По их полному имени (с протоколом). -По умолчанию, история перехода по документам будет визуализироваться в списке файлов - самый последний документ документ будет иметь более тёмный фон. Это можно отключить на странице Параметры списка документов окна настроек программы. +По умолчанию, история перехода по документам будет визуализироваться в списке файлов - самый последний документ документ будет иметь более тёмный фон. Это можно отключить на странице Параметры списка документов окна настроек программы. -Стандартное положение списка в главном окне &kate; - слева. +Стандартное положение списка в главном окне &kate; - слева. -Обзор файловой системы +Обзор файловой системы -Обзор файловой системы Служебная панель Обзор файловой системы представляет собой окно просмотра каталогов, которое позволяет быстро открыть нужный файл в активном фрейме. +Обзор файловой системы Служебная панель Обзор файловой системы представляет собой окно просмотра каталогов, которое позволяет быстро открыть нужный файл в активном фрейме. -Служебная панель Обзор файловой системы состоит из следующих элементов, сверху вниз: +Служебная панель Обзор файловой системы состоит из следующих элементов, сверху вниз: -Панель инструментов +Панель инструментов -Содержит стандартные кнопки навигации: +Содержит стандартные кнопки навигации: -Домашний каталог -Отобразить в окне содержание вашего домашнего каталога. +Домашний каталог +Отобразить в окне содержание вашего домашнего каталога. -Вверх -Перейти в родительский каталог (по отношению к текущему), если это возможно. +Вверх +Перейти в родительский каталог (по отношению к текущему), если это возможно. -Предыдущий каталог -Отобразить в окне предыдущий посещенный каталог. Если в истории обзора нет предыдущих посещенных каталогов, эта кнопка будет недоступна. +Предыдущий каталог +Отобразить в окне предыдущий посещенный каталог. Если в истории обзора нет предыдущих посещенных каталогов, эта кнопка будет недоступна. -Следующий каталог -Перейти в следующий посещенный каталог. Это означает, что если вы в каталоге A нажали кнопку Предыдущий каталог и вернулись в каталог B, то, нажав на кнопку Следующий каталог, вы снова попадете в A. Если в истории обзора нет следующего посещенного каталога, эта кнопка будет недоступна. +Следующий каталог +Перейти в следующий посещенный каталог. Это означает, что если вы в каталоге A нажали кнопку Предыдущий каталог и вернулись в каталог B, то, нажав на кнопку Следующий каталог, вы снова попадете в A. Если в истории обзора нет следующего посещенного каталога, эта кнопка будет недоступна. -Текущий каталог документов -Перейти в каталог активного документа. Эта кнопка будет запрещена, если активный документ - новый, несохранённый файл или каталог, в котором находится файл, не может быть выбран. +Текущий каталог документов +Перейти в каталог активного документа. Эта кнопка будет запрещена, если активный документ - новый, несохранённый файл или каталог, в котором находится файл, не может быть выбран. @@ -261,41 +125,24 @@ -Строка адреса &URL; +Строка адреса &URL; -Здесь можно ввести путь к каталогу для обзора. Строка адреса содержит список предыдущих введенных каталогов; чтобы выбрать один из них, используйте кнопку со стрелкой справа от строки. -Строка адреса поддерживает возможность автозавершения текста, метод завершения можно выбрать из контекстного всплывающего меню, которое вызывается нажатием правой кнопки мыши на ней. +Здесь можно ввести путь к каталогу для обзора. Строка адреса содержит список предыдущих введенных каталогов; чтобы выбрать один из них, используйте кнопку со стрелкой справа от строки. +Строка адреса поддерживает возможность автозавершения текста, метод завершения можно выбрать из контекстного всплывающего меню, которое вызывается нажатием правой кнопки мыши на ней. -Окно обзора каталогов -Стандартное окно &kde; для обзора каталогов. +Окно обзора каталогов +Стандартное окно &kde; для обзора каталогов. -Строка фильтрации +Строка фильтрации -Позволяет задать фильтр для файлов, отображаемых в окне обзора каталогов. Фильтр состоит из стандартных символов; можно ввести несколько масок, разделяя их пробелами. Например: *.cpp *.h *.moc -Чтобы отобразить все файлы, введите один символ звездочки: *. -Строка фильтрации сохраняет последние десять введенных фильтров (необязательно, чтобы все они были введены в текущем сеансе работы), чтобы установить один из них, нажмите на кнопке со стрелкой справа от строки и выберите нужный из списка. +Позволяет задать фильтр для файлов, отображаемых в окне обзора каталогов. Фильтр состоит из стандартных символов; можно ввести несколько масок, разделяя их пробелами. Например: *.cpp *.h *.moc +Чтобы отобразить все файлы, введите один символ звездочки: *. +Строка фильтрации сохраняет последние десять введенных фильтров (необязательно, чтобы все они были введены в текущем сеансе работы), чтобы установить один из них, нажмите на кнопке со стрелкой справа от строки и выберите нужный из списка. @@ -305,51 +152,22 @@ -Встроенный эмулятор терминала - -Встроенный эмулятор терминала Встроенный эмулятор терминала - тот же &konsole;. Чтобы показать его, выберите пункт меню НастройкаПоказать эмулятор терминала или нажмите клавишу F7. Сразу после отображения окно эмулятора терминала получает фокус ввода. Если включена опция Синхронизировать &konsole; с активным документом, терминал будет сменять текущий каталог на каталог активного документа при его отображении и смене активного документа с одного на другой. - -Стандартное положение в главном окне &kate; - внизу, под областью редактирования. - -Вы можете настроить &konsole; через контекстное меню терминала; дополнительную информацию можно найти в руководстве &konsole;. +Встроенный эмулятор терминала + +Встроенный эмулятор терминала Встроенный эмулятор терминала - тот же &konsole;. Чтобы показать его, выберите пункт меню НастройкаПоказать эмулятор терминала или нажмите клавишу F7. Сразу после отображения окно эмулятора терминала получает фокус ввода. Если включена опция Синхронизировать &konsole; с активным документом, терминал будет сменять текущий каталог на каталог активного документа при его отображении и смене активного документа с одного на другой. + +Стандартное положение в главном окне &kate; - внизу, под областью редактирования. + +Вы можете настроить &konsole; через контекстное меню терминала; дополнительную информацию можно найти в руководстве &konsole;. -Внешние инструменты - -В меню Сервис находится подменю Внешние инструменты. Из него можно вызвать внешние программы, передав им какую-либо информацию о текущем документе, например его URL, выделенным текстом. - -Внешние инструменты определяются пользователем на соответствующей странице окна настройки программы. +Внешние инструменты + +В меню Сервис находится подменю Внешние инструменты. Из него можно вызвать внешние программы, передав им какую-либо информацию о текущем документе, например его URL, выделенным текстом. + +Внешние инструменты определяются пользователем на соответствующей странице окна настройки программы. diff --git a/tde-i18n-ru/docs/tdebase/kate/menus.docbook b/tde-i18n-ru/docs/tdebase/kate/menus.docbook index f08b537a3eb..615fcadcd3d 100644 --- a/tde-i18n-ru/docs/tdebase/kate/menus.docbook +++ b/tde-i18n-ru/docs/tdebase/kate/menus.docbook @@ -1,100 +1,33 @@ - -АндрейБалагута
uj2@mail.ru
Перевод на русскийАлексейОпарин
opaleksej@yandex.ru
Перевод на русский + +АндрейБалагута
uj2@mail.ru
Перевод на русскийАлексейОпарин
opaleksej@yandex.ru
Перевод на русский -Пункты меню +Пункты меню -Меню <guimenu ->Файл</guimenu -> +Меню <guimenu>Файл</guimenu> - &Ctrl;N Файл Создать + &Ctrl;N Файл Создать -По этой команде создаётся новый документ. Он будет добавлен в перечень Документы, который находится слева на боковой панели, и будет назван Безымянный. +По этой команде создаётся новый документ. Он будет добавлен в перечень Документы, который находится слева на боковой панели, и будет назван Безымянный. - &Ctrl;O Файл Открыть + &Ctrl;O Файл Открыть -Открывает диалог выбора файла &kde;, позволяющийоткрыть один или несколько файлов. +Открывает диалог выбора файла &kde;, позволяющийоткрыть один или несколько файлов. @@ -102,596 +35,272 @@ -Файл Открыть недавние +Файл Открыть недавние -Эта команда позволяет открыть файл, который вы недавно редактировали, выбрав его в подменю. +Эта команда позволяет открыть файл, который вы недавно редактировали, выбрав его в подменю. -Файл Открыть в +Файл Открыть в -В подменю выводится список приложений, связанных с mime-типом текущего файла. -Команда Открыть с помощью... открывает диалог со списком доступных программ, позволяя вам выбрать другое приложение и открыть в нём текущий файл. Ваш файл будет оставаться открытым в &kate;. +В подменю выводится список приложений, связанных с mime-типом текущего файла. +Команда Открыть с помощью... открывает диалог со списком доступных программ, позволяя вам выбрать другое приложение и открыть в нём текущий файл. Ваш файл будет оставаться открытым в &kate;. - &Ctrl;S Файл Сохранить + &Ctrl;S Файл Сохранить -Эта команда сохраняет текущий файл. Пользуйтесь ею почаще. Если текущий документ Безымянный, то вместо команды Сохранить будет выполнена команда Сохранить как. +Эта команда сохраняет текущий файл. Пользуйтесь ею почаще. Если текущий документ Безымянный, то вместо команды Сохранить будет выполнена команда Сохранить как. -Файл Сохранить как... +Файл Сохранить как... -С помощью этой команды вы можете назвать или переименовать файл. Она открывает диалог сохранения файла, который работает аналогично диалогу открытия. Вы можете перемещаться по файловой системе, быстро просматривать содержание файлов и фильтровать отображение файлов с помощью файловых масок. +С помощью этой команды вы можете назвать или переименовать файл. Она открывает диалог сохранения файла, который работает аналогично диалогу открытия. Вы можете перемещаться по файловой системе, быстро просматривать содержание файлов и фильтровать отображение файлов с помощью файловых масок. -Введите имя, которое вы хотите присвоить сохраняемому файлу, и нажмите OK. +Введите имя, которое вы хотите присвоить сохраняемому файлу, и нажмите OK. - &Ctrl;L Файл Сохранить все + &Ctrl;L Файл Сохранить все -Эта команда сохраняет все открытые файлы. +Эта команда сохраняет все открытые файлы. - F5 Файл Обновить + F5 Файл Обновить -Обновляет текущий файл. Эта команда удобна, если файл, открытый в &kate; изменен другой программой. +Обновляет текущий файл. Эта команда удобна, если файл, открытый в &kate; изменен другой программой. - &Ctrl;P Файл Печать... + &Ctrl;P Файл Печать... -Вывод текущего файла на печать. +Вывод текущего файла на печать. -Файл Экспортировать в HTML... +Файл Экспортировать в HTML... -Экспортирует текущий файл в формат HTML для просмотра в виде Интернет-страницы. +Экспортирует текущий файл в формат HTML для просмотра в виде Интернет-страницы. -Файл Отправить по почте... +Файл Отправить по почте... -Открывает почтовую программу и прикрепляет файл к письму. +Открывает почтовую программу и прикрепляет файл к письму. - &Ctrl;W Файл Закрыть + &Ctrl;W Файл Закрыть -Эта команда закрывает текущий файл. Если файл был изменён со времени последнего сохранения - будет предложено сохранить его перед закрытием. +Эта команда закрывает текущий файл. Если файл был изменён со времени последнего сохранения - будет предложено сохранить его перед закрытием. -Файл Закрыть все +Файл Закрыть все -Эта команда закрывает все файлы, которые были открыты в &kate;. +Эта команда закрывает все файлы, которые были открыты в &kate;. - &Ctrl;Q Файл Выход + &Ctrl;Q Файл Выход -Эта команда закрывает &kate; и все открытые файлы. Если вы изменили какие-либо из них с момента их последнего сохранения - будет предложено сохранить эти файлы. +Эта команда закрывает &kate; и все открытые файлы. Если вы изменили какие-либо из них с момента их последнего сохранения - будет предложено сохранить эти файлы. -Меню <guimenu ->Правка</guimenu -> -Меню Правка содержит набор команд для работы с текущим документом. +Меню <guimenu>Правка</guimenu> +Меню Правка содержит набор команд для работы с текущим документом. -Пункты меню +Пункты меню -&Ctrl;Z Правка Отменить действие +&Ctrl;Z Правка Отменить действие -Отменяет последнюю команду редактирования (ввод, копирование, вырезание и т.д.). -Если включён режим группировки отмены, эта команда может отменить несколько однотипных команд вроде ввода символов. +Отменяет последнюю команду редактирования (ввод, копирование, вырезание и т.д.). +Если включён режим группировки отмены, эта команда может отменить несколько однотипных команд вроде ввода символов. -&Ctrl;&Shift;Z Правка Повторить отмененное действие +&Ctrl;&Shift;Z Правка Повторить отмененное действие -Отменяет последний откат. +Отменяет последний откат. -&Ctrl;X Правка Вырезать +&Ctrl;X Правка Вырезать -Удаляет выделенный текст (если есть) и помещает его копию в буфер обмена. +Удаляет выделенный текст (если есть) и помещает его копию в буфер обмена. -&Ctrl;C Правка Копировать +&Ctrl;C Правка Копировать -Копирует выделенный текст (если есть) в буфер обмена. +Копирует выделенный текст (если есть) в буфер обмена. -Правка Скопировать как HTML +Правка Скопировать как HTML -Копирует выделенный текст с подсветкой синтаксиса, установленной для HTML. +Копирует выделенный текст с подсветкой синтаксиса, установленной для HTML. -&Ctrl;V Правка Вставить +&Ctrl;V Правка Вставить -Копирует первую запись из буфера обмена в позицию курсора. -Если включён режим замены выделенного фрагмента, вставленный текст заменит выделенный фрагмент (если он есть). +Копирует первую запись из буфера обмена в позицию курсора. +Если включён режим замены выделенного фрагмента, вставленный текст заменит выделенный фрагмент (если он есть). -&Ctrl;A Правка Выделить все +&Ctrl;A Правка Выделить все -Выделяется весь текст. +Выделяется весь текст. -&Ctrl;&Shift;A Правка Отменить выделение +&Ctrl;&Shift;A Правка Отменить выделение -Снимает выделение с текста (если есть). +Снимает выделение с текста (если есть). -&Ctrl;Shift B Правка Вертикальное выделение +&Ctrl;Shift B Правка Вертикальное выделение -Переключает режим выделения. Если выбран режим выделения BLOCK, то можно делать вертикальное выделение, например, выделить столбцы с пятого по десятый в строках 9-15. -Строка состояния показывает текущий режим выделения (NORM или BLOCK). +Переключает режим выделения. Если выбран режим выделения BLOCK, то можно делать вертикальное выделение, например, выделить столбцы с пятого по десятый в строках 9-15. +Строка состояния показывает текущий режим выделения (NORM или BLOCK). -&Ctrl;F Правка Найти... +&Ctrl;F Правка Найти... -Открывает диалог поиска, который позволяет найти нужный текст в редактируемом документе. +Открывает диалог поиска, который позволяет найти нужный текст в редактируемом документе. -F3 Правка Продолжить поиск +F3 Правка Продолжить поиск -Переход к нижележащему совпадению с текущим шаблоном, начиная от позиции курсора. +Переход к нижележащему совпадению с текущим шаблоном, начиная от позиции курсора. -&Shift;F3 Правка Искать в обратном направлении +&Shift;F3 Правка Искать в обратном направлении -Переход к вышележащему совпадению с текущим шаблоном, начиная от позиции курсора. +Переход к вышележащему совпадению с текущим шаблоном, начиная от позиции курсора. -&Ctrl;R Правка Заменить... +&Ctrl;R Правка Заменить... -Открывает диалог замены одной текстовой строки другой строкой. +Открывает диалог замены одной текстовой строки другой строкой. -&Ctrl;G Правка Перейти на строку... +&Ctrl;G Правка Перейти на строку... -Открывает диалог перехода к нужной строке по её номеру. +Открывает диалог перехода к нужной строке по её номеру. @@ -700,68 +309,29 @@ -Меню <guimenu ->Документ</guimenu -> -В меню Документ для каждого открытого документа существует отдельный пункт, выбор которого приводит к переходу фокуса ввода на соответствующий файл. Если открыты несколько фреймов, то редактор для текущего документа будет отображен в активном. -Кроме того, для перехода по открытым документам доступны пункты меню: -Пункты меню +Меню <guimenu>Документ</guimenu> +В меню Документ для каждого открытого документа существует отдельный пункт, выбор которого приводит к переходу фокуса ввода на соответствующий файл. Если открыты несколько фреймов, то редактор для текущего документа будет отображен в активном. +Кроме того, для перехода по открытым документам доступны пункты меню: +Пункты меню -&Alt;Влево Документ Назад +&Alt;Влево Документ Назад -Загружает в редактор предыдущий документ очереди. Если открыты несколько фреймов, то документ будет загружен в активный. Порядок следования документов в очереди определяется порядком, в котором документы были открыты. Это противоречит логической предыстории редактирования (сравните с поведением браузера). Возможно, эта непредсказуемость будет исправлена в будущих версиях &kate;. +Загружает в редактор предыдущий документ очереди. Если открыты несколько фреймов, то документ будет загружен в активный. Порядок следования документов в очереди определяется порядком, в котором документы были открыты. Это противоречит логической предыстории редактирования (сравните с поведением браузера). Возможно, эта непредсказуемость будет исправлена в будущих версиях &kate;. -&Alt;Вправо Документ Вперёд +&Alt;Вправо Документ Вперёд -Загружает в редактор следующий документ очереди. Если открыты несколько фреймов, то документ будет загружен в активный. -Порядок следования документов в очереди определяется порядком, в котором документы были открыты. Это противоречит логической предыстории редактирования (сравните с поведением браузера). Возможно, эта непредсказуемость будет исправлена в будущих версиях &kate;. +Загружает в редактор следующий документ очереди. Если открыты несколько фреймов, то документ будет загружен в активный. +Порядок следования документов в очереди определяется порядком, в котором документы были открыты. Это противоречит логической предыстории редактирования (сравните с поведением браузера). Возможно, эта непредсказуемость будет исправлена в будущих версиях &kate;. @@ -769,264 +339,96 @@ -Меню <guimenu ->Вид</guimenu -> +Меню <guimenu>Вид</guimenu> -Меню Вид позволяет управлять фреймами и настраивать параметры, относящиеся к текущему редактору. +Меню Вид позволяет управлять фреймами и настраивать параметры, относящиеся к текущему редактору. -Пункты меню - - -F7 ВидПереключиться в командную строку -С помощью этой команды можно перемещать фокус ввода из области редактирования на командную строку и обратно. - - - -ВидСхема -Это меню содержит доступные схемы. Здесь можно изменить схему для текущего документа, а для изменения предустановленной схемы воспользуйтесь диалогом настройки - - - - -F10 ВидДинамический перенос строк +Пункты меню + + +F7 ВидПереключиться в командную строку +С помощью этой команды можно перемещать фокус ввода из области редактирования на командную строку и обратно. + + + +ВидСхема +Это меню содержит доступные схемы. Здесь можно изменить схему для текущего документа, а для изменения предустановленной схемы воспользуйтесь диалогом настройки + + + + +F10 ВидДинамический перенос строк -Включает/отключает динамический перенос строк текущего документа. При динамическом переносе текст в окне можно просматривать без горизонтальной перемотки, то есть строка, непрерывная на самом деле, для удобства делится на несколько. +Включает/отключает динамический перенос строк текущего документа. При динамическом переносе текст в окне можно просматривать без горизонтальной перемотки, то есть строка, непрерывная на самом деле, для удобства делится на несколько. -ВидМаркеры статического переноса строк -Включает/отключает отображение вертикальных линий, указывающих позицию переноса строк, заданную в диалоге настройки. Эта функция доступна только для моноширинных шрифтов. +ВидМаркеры статического переноса строк +Включает/отключает отображение вертикальных линий, указывающих позицию переноса строк, заданную в диалоге настройки. Эта функция доступна только для моноширинных шрифтов. -F6 Вид Показать/Скрыть панель значков +F6 Вид Показать/Скрыть панель значков -Скрывает/отображает панель значков слева от окна редактирования. +Скрывает/отображает панель значков слева от окна редактирования. -F11 Вид Показать/Скрыть номера строк +F11 Вид Показать/Скрыть номера строк -Скрывает/отображает панель с номерами строк слева от окна редактирования. - - - - -ВидПоказать отметки на полосе прокрутки -Включает/отключает отображение закладок (или других отметок) на полосе вертикальной прокрутки. Если включено, то на полосе прокрутки отображаются тонкие линии, окрашенные в цвет отметки. Щёлкните на такой линии средней кнопкой мыши, и курсор переместитcя в отмеченную область. - - - -F9 ВидПоказать полосу сворачивания кода -Включает/отключает отображение панели маркеров сворачивания блоков кода слева от окна редактирования. Более подробно об этом написано в разделе Сворачивание блоков кода. +Скрывает/отображает панель с номерами строк слева от окна редактирования. + + + + +ВидПоказать отметки на полосе прокрутки +Включает/отключает отображение закладок (или других отметок) на полосе вертикальной прокрутки. Если включено, то на полосе прокрутки отображаются тонкие линии, окрашенные в цвет отметки. Щёлкните на такой линии средней кнопкой мыши, и курсор переместитcя в отмеченную область. + + + +F9 ВидПоказать полосу сворачивания кода +Включает/отключает отображение панели маркеров сворачивания блоков кода слева от окна редактирования. Более подробно об этом написано в разделе Сворачивание блоков кода. -Сворачивание блоков кода +Сворачивание блоков кода -&Ctrl; Shift- Свернуть верхний уровень +&Ctrl; Shift- Свернуть верхний уровень -Сворачивает все блоки верхнего уровня в документе. - - -&Ctrl; Shift+ Развернуть верхний уровень +Сворачивает все блоки верхнего уровня в документе. + + +&Ctrl; Shift+ Развернуть верхний уровень -Разворачивает все блоки верхнего уровня в документе. - - -&Ctrl; - Свернуть локальный уровень +Разворачивает все блоки верхнего уровня в документе. + + +&Ctrl; - Свернуть локальный уровень -Сворачивает ближайший к курсору блок. - - -&Ctrl; + Развернуть локальный уровень +Сворачивает ближайший к курсору блок. + + +&Ctrl; + Развернуть локальный уровень -Разворачивает ближайший к курсору блок. +Разворачивает ближайший к курсору блок. @@ -1038,102 +440,45 @@ -Меню <guimenu ->Закладки</guimenu -> +Меню <guimenu>Закладки</guimenu> -Меню Закладки позволяет работать с закладками активного документа. +Меню Закладки позволяет работать с закладками активного документа. -Ниже описанных здесь пунктов меню располагаются пункты самих закладок. Текст каждого такого пункта -- номер и несколько символов строки, на которую указывает эта закладка. Выбрав пункт меню закладки, вы попадете на начало помеченной строки. Редактор автоматически выполнит прокрутку текста, если эта строка будет не видна. +Ниже описанных здесь пунктов меню располагаются пункты самих закладок. Текст каждого такого пункта -- номер и несколько символов строки, на которую указывает эта закладка. Выбрав пункт меню закладки, вы попадете на начало помеченной строки. Редактор автоматически выполнит прокрутку текста, если эта строка будет не видна. -Пункты меню +Пункты меню -&Ctrl;B Закладки Поставить/Убрать закладку +&Ctrl;B Закладки Поставить/Убрать закладку -Устанавливает или удаляет закладку для текущей строки активного документа (если закладки не было, она устанавливается, иначе удаляется). +Устанавливает или удаляет закладку для текущей строки активного документа (если закладки не было, она устанавливается, иначе удаляется). -Закладки Убрать все закладки +Закладки Убрать все закладки -Удаляет все закладки из текущего документа. +Удаляет все закладки из текущего документа. -&Alt; Page Up ЗакладкиПредыдущая +&Alt; Page Up ЗакладкиПредыдущая -Переместит курсор на начало вышележащей строки с закладкой. Текст пункта включает номер и несколько первых символов строки. Этот пункт появляется, только если выше курсора есть строка с закладкой. +Переместит курсор на начало вышележащей строки с закладкой. Текст пункта включает номер и несколько первых символов строки. Этот пункт появляется, только если выше курсора есть строка с закладкой. -&Alt; Page Down ЗакладкиСледующая -Переместит курсор на начало нижележащей строки с закладкой. Текст пункта включает номер и несколько первых символов строки. Этот пункт появляется, только если ниже курсора есть строка с закладкой. +&Alt; Page Down ЗакладкиСледующая +Переместит курсор на начало нижележащей строки с закладкой. Текст пункта включает номер и несколько первых символов строки. Этот пункт появляется, только если ниже курсора есть строка с закладкой. @@ -1142,333 +487,128 @@ -Меню <guimenu ->Сервис</guimenu -> +Меню <guimenu>Сервис</guimenu> -СервисПеренаправить в консоль -Перенесет выделенный текст во встроенный эмулятор терминала. Новая строка к тексту не добавляется. - - - -СервисВнешние инструменты -Это подменю содержит все настроенные вами внешние инструменты. - - - -Сервис Режим "Только для чтения" +СервисПеренаправить в консоль +Перенесет выделенный текст во встроенный эмулятор терминала. Новая строка к тексту не добавляется. + + + +СервисВнешние инструменты +Это подменю содержит все настроенные вами внешние инструменты. + + + +Сервис Режим "Только для чтения" -Устанавливает статус "Только для чтения" для текущего документа, тем самым предохраняя его от любых возможных изменений. +Устанавливает статус "Только для чтения" для текущего документа, тем самым предохраняя его от любых возможных изменений. -Сервис Тип файла +Сервис Тип файла -Выбор типа файла для текущего документа. Перекрывает параметр тип файла, указанный в Настройка Настроить редактор... на вкладке Типы файлов. - - - - -Сервис Подсветка +Выбор типа файла для текущего документа. Перекрывает параметр тип файла, указанный в Настройка Настроить редактор... на вкладке Типы файлов. + + + + +Сервис Подсветка -Выбор нестандартной схемы подсветки для текущего документа. Перекрывает глобальный режим подсветки, указанный в Настройка Настроить редактор... . - - - - -Сервис Отступ +Выбор нестандартной схемы подсветки для текущего документа. Перекрывает глобальный режим подсветки, указанный в Настройка Настроить редактор... . + + + + +Сервис Отступ -Выбор режима отступов для текущего документа. Перекрывает глобальный режим отступов, указанный в Настройка Настроить редактор... . - - - - -Сервис Кодировка +Выбор режима отступов для текущего документа. Перекрывает глобальный режим отступов, указанный в Настройка Настроить редактор... . + + + + +Сервис Кодировка -Выбор кодировки для текущего документа, отличной от указанной в Настройка Настроить редактор... на вкладке Открытие/Сохранение. Если файл не изменён, то он будет открыт повторно в указанной кодировке, а если изменён - то будет выполнено преобразование текущего текста в указанную кодировку. - - - - -Сервис Конец строки +Выбор кодировки для текущего документа, отличной от указанной в Настройка Настроить редактор... на вкладке Открытие/Сохранение. Если файл не изменён, то он будет открыт повторно в указанной кодировке, а если изменён - то будет выполнено преобразование текущего текста в указанную кодировку. + + + + +Сервис Конец строки -Выбор окончания строки для текущего документа. Перекрывает стандартную настройку в Настройка Настроить редактор... . +Выбор окончания строки для текущего документа. Перекрывает стандартную настройку в Настройка Настроить редактор... . -Сервис Проверка правописания... +Сервис Проверка правописания... -Запускает проверку правописания -- программу, разработанную для помощи пользователям в поиске и исправлении ошибок правописания. Щелчок на этом пункте меню вызывает окно проверки орфографии, где вы можете контролировать процесс проверки. В этом диалоге есть три поля ввода, расположенные вертикально, с надписями, описывающими их назначение, слева. Предназначение этих полей ввода: +Запускает проверку правописания -- программу, разработанную для помощи пользователям в поиске и исправлении ошибок правописания. Щелчок на этом пункте меню вызывает окно проверки орфографии, где вы можете контролировать процесс проверки. В этом диалоге есть три поля ввода, расположенные вертикально, с надписями, описывающими их назначение, слева. Предназначение этих полей ввода: -Неизвестное слово: -Здесь программа проверки орфографии показывает рассматриваемое слово. Это происходит, когда программа не находит этого слова в своём словаре -- файле, содержащим список правильно написанных слов, с которыми сверяется каждое проверяемое слово. - - -Заменить на: -Если программа обнаруживает в своём словаре похожие слова, первое из них будет показано в этом поле. Вы можете принять предлагаемое слово, ввести свой вариант или выбрать другой вариант из списка ниже. - - -Предлагаемые слова: -Программа проверки орфографии может разместить здесь список возможных замен для проверяемого слова. При щелчке на любом из предлагаемых слов оно появляется в поле ввода Заменить на:, расположенном выше. - - -Язык: -Если у вас есть несколько словарей, то здесь вы можете выбрать, какой из них использовать. +Неизвестное слово: +Здесь программа проверки орфографии показывает рассматриваемое слово. Это происходит, когда программа не находит этого слова в своём словаре -- файле, содержащим список правильно написанных слов, с которыми сверяется каждое проверяемое слово. + + +Заменить на: +Если программа обнаруживает в своём словаре похожие слова, первое из них будет показано в этом поле. Вы можете принять предлагаемое слово, ввести свой вариант или выбрать другой вариант из списка ниже. + + +Предлагаемые слова: +Программа проверки орфографии может разместить здесь список возможных замен для проверяемого слова. При щелчке на любом из предлагаемых слов оно появляется в поле ввода Заменить на:, расположенном выше. + + +Язык: +Если у вас есть несколько словарей, то здесь вы можете выбрать, какой из них использовать. -В правой части диалога расположены 5 кнопок для управления проверкой правописания: +В правой части диалога расположены 5 кнопок для управления проверкой правописания: -Добавить в словарь -При нажатии этой кнопки Ошибочное слово: будет добавлено в словарь программы проверки орфографии, т.е. в дальнейшем это слово будет считаться написанным правильно. - - -Заменить -При нажатии на эту кнопку в документе происходит замена рассматриваемого слова словом из поля ввода Заменить на:. - - -Заменить все -При нажатии на эту кнопку будет исправлено не только Ошибочное слово:, но и все экземпляры этого слова в документе. - - -Игнорировать -При нажатии на эту кнопку проверка будет продолжена без изменения текущего слова. - - -Игнорировать везде -При нажатии на эту кнопку программа проверки будет пропускать все экземпляры неизвестного слова в документе. Игнорируемые слова не запоминаются программой, то есть при следующуй проверке правописания это будет отмечено вновь. +Добавить в словарь +При нажатии этой кнопки Ошибочное слово: будет добавлено в словарь программы проверки орфографии, т.е. в дальнейшем это слово будет считаться написанным правильно. + + +Заменить +При нажатии на эту кнопку в документе происходит замена рассматриваемого слова словом из поля ввода Заменить на:. + + +Заменить все +При нажатии на эту кнопку будет исправлено не только Ошибочное слово:, но и все экземпляры этого слова в документе. + + +Игнорировать +При нажатии на эту кнопку проверка будет продолжена без изменения текущего слова. + + +Игнорировать везде +При нажатии на эту кнопку программа проверки будет пропускать все экземпляры неизвестного слова в документе. Игнорируемые слова не запоминаются программой, то есть при следующуй проверке правописания это будет отмечено вновь. -Ещё три кнопки расположены внизу диалога проверки правописания: +Ещё три кнопки расположены внизу диалога проверки правописания: -Справка -Вызывает справочную систему &kde; и открывает этот документ. +Справка +Вызывает справочную систему &kde; и открывает этот документ. -Готово -Останавливает процесс проверки правописания с сохранением внесенных изменений +Готово +Останавливает процесс проверки правописания с сохранением внесенных изменений -Отмена -Отменяет внесенные изсенения и завершает процесс проверки правописания. +Отмена +Отменяет внесенные изсенения и завершает процесс проверки правописания. @@ -1477,258 +617,82 @@ -Сервис Проверка правописания (от курсора)... +Сервис Проверка правописания (от курсора)... -Запускает проверку правописания, но начинается она от позиции курсора, а не от начала документа. +Запускает проверку правописания, но начинается она от позиции курсора, а не от начала документа. -Сервис Проверка правописания в выделенном фрагменте... +Сервис Проверка правописания в выделенном фрагменте... -Проверяет правописание в выделенном фрагменте. +Проверяет правописание в выделенном фрагменте. - &Ctrl;I СервисВставить отступ + &Ctrl;I СервисВставить отступ -Увеличивает отступ параграфа на один шаг. Размер шага зависит от параметров расстановки отступов. +Увеличивает отступ параграфа на один шаг. Размер шага зависит от параметров расстановки отступов. -&Ctrl;&Shift;I Сервис Снять отступ +&Ctrl;&Shift;I Сервис Снять отступ -Уменьшает отступ параграфа на один шаг. Размер шага зависит от параметров расстановки отступов. +Уменьшает отступ параграфа на один шаг. Размер шага зависит от параметров расстановки отступов. -СервисПривести в порядок отступы -Приводит в порядок отступы в выделенном фрагменте или в текущей строке. Это обеспечивает соответствие режима отступов установленному вами правилу. +СервисПривести в порядок отступы +Приводит в порядок отступы в выделенном фрагменте или в текущей строке. Это обеспечивает соответствие режима отступов установленному вами правилу. -Сервис Выравнивание +Сервис Выравнивание -Выравнивает текущую строку или строки в выделенном фрагменте согласно правилам отступа для документа. - - - - -&Ctrl;D Сервис Закомментировать -Добавляет знак комментария, отделенный от начала текста в строке пробелом. - - - - - &Ctrl;&Shift;D Сервис Раскомментировать -Удаляет знак комментария и пробел, которым этот знак отделялся от начала текста в строке. - - - - &Ctrl;U Сервис ВЕРХНИЙ РЕГИСТР -Переводит выделенный текст или букву под курсором в верхний регистр. - - - - &Ctrl;&Shift;U Сервис нижний регистр -Переводит выделенный текст или букву под курсором в нижний регистр. - - - - &Alt;&Ctrl;U Сервис Как в предложениях -Переводит заглавные буквы выделенного текста в верхний регистр. - - - - &Ctrl;J Сервис Объединить строки -Объединяет выделенные строки (или текущую строку с нижележащей) в одну, разделяя их пробелом. Пробелы в начале и конце строк удаляются. - - - -Сервис Перенос слов в документе -Включает статический перенос строк в документе, то есть если длина строки превышает величину, указанную на вкладке настройки редактора в поле "Переносить после" меню НастройкаНастроить редактор..., будет вставлен символ новой строки. +Выравнивает текущую строку или строки в выделенном фрагменте согласно правилам отступа для документа. + + + + +&Ctrl;D Сервис Закомментировать +Добавляет знак комментария, отделенный от начала текста в строке пробелом. + + + + + &Ctrl;&Shift;D Сервис Раскомментировать +Удаляет знак комментария и пробел, которым этот знак отделялся от начала текста в строке. + + + + &Ctrl;U Сервис ВЕРХНИЙ РЕГИСТР +Переводит выделенный текст или букву под курсором в верхний регистр. + + + + &Ctrl;&Shift;U Сервис нижний регистр +Переводит выделенный текст или букву под курсором в нижний регистр. + + + + &Alt;&Ctrl;U Сервис Как в предложениях +Переводит заглавные буквы выделенного текста в верхний регистр. + + + + &Ctrl;J Сервис Объединить строки +Объединяет выделенные строки (или текущую строку с нижележащей) в одну, разделяя их пробелом. Пробелы в начале и конце строк удаляются. + + + +Сервис Перенос слов в документе +Включает статический перенос строк в документе, то есть если длина строки превышает величину, указанную на вкладке настройки редактора в поле "Переносить после" меню НастройкаНастроить редактор..., будет вставлен символ новой строки. @@ -1737,105 +701,42 @@ -Меню <guimenu ->Сеансы</guimenu -> +Меню <guimenu>Сеансы</guimenu> -Это меню содержит пункты для использования сеансов и управления ими. +Это меню содержит пункты для использования сеансов и управления ими. -Сеансы Создать -Создает новый сеанс. Все текущие файлы будут закрыты. +Сеансы Создать +Создает новый сеанс. Все текущие файлы будут закрыты. -СеансыОткрыть... -Открывает один из существующих сеансов, для выбора предоставляется диалог. +СеансыОткрыть... +Открывает один из существующих сеансов, для выбора предоставляется диалог. -СеансыБыстрое открытие -Это подменю позволяет быстро открыть существующий сеанс. +СеансыБыстрое открытие +Это подменю позволяет быстро открыть существующий сеанс. -СеансыСохранить -Сохраняет текущий сеанс. Если сеанс безымянный, будет предложено назвать его. +СеансыСохранить +Сохраняет текущий сеанс. Если сеанс безымянный, будет предложено назвать его. -СеансыСохранить как... -Сохраняет текущий сеанс под именем, которое будет предложено ввести. +СеансыСохранить как... +Сохраняет текущий сеанс под именем, которое будет предложено ввести. -СеансыУправление... -Отображает диалог управления сеансами, где их можно переименовывать и удалять. +СеансыУправление... +Отображает диалог управления сеансами, где их можно переименовывать и удалять. @@ -1845,66 +746,36 @@ -Меню <guimenu ->Настройка</guimenu -> +Меню <guimenu>Настройка</guimenu> -Меню Настройка позволяет настроить свойства главного окна, например, отображение панелей инструментов, а также предоставляет доступ к другим окнам настройки. +Меню Настройка позволяет настроить свойства главного окна, например, отображение панелей инструментов, а также предоставляет доступ к другим окнам настройки. -Настройка Панели инструментов +Настройка Панели инструментов -Это подменю представляет все доступные панели инструментов, каждый пункт включает/отключает соответствующую панель. +Это подменю представляет все доступные панели инструментов, каждый пункт включает/отключает соответствующую панель. -НастройкаПолноэкранный режим -Включает/отключает полноэкранное отображение. -В будущих версиях &kate; эта команда переместится в меню Окно. +НастройкаПолноэкранный режим +Включает/отключает полноэкранное отображение. +В будущих версиях &kate; эта команда переместится в меню Окно. -Настройка Комбинации клавиш... +Настройка Комбинации клавиш... -Отображает стандартный диалог &kde; Настройка комбинаций клавиш. +Отображает стандартный диалог &kde; Настройка комбинаций клавиш. @@ -1912,34 +783,20 @@ -Настройка Настроить панели инструментов... +Настройка Настроить панели инструментов... -Отобразить стандартное окно &kde; Настроить панели инструментов +Отобразить стандартное окно &kde; Настроить панели инструментов -Настройка Настроить &kate;... +Настройка Настроить &kate;... -Открыть диалоговое окно Настройки &kate; +Открыть диалоговое окно Настройки &kate; @@ -1948,266 +805,110 @@ -Меню <guimenu ->Окно</guimenu -> +Меню <guimenu>Окно</guimenu> -Окно Новое окно +Окно Новое окно -Открывает ещё одно окно &kate;. Новое окно будет точно таким же, как предыдущее. +Открывает ещё одно окно &kate;. Новое окно будет точно таким же, как предыдущее. -&Ctrl;&Shift;L Окно Разделить по вертикали +&Ctrl;&Shift;L Окно Разделить по вертикали -Разделяет фрейм (который может быть главной областью редактирования) на два равных фрейма, причем новый будет располагаться слева от текущего. Новый фрейм становится активным, и в него загружается тот же документ. -См. также Работа с многодокументным интерфейсом &kate; +Разделяет фрейм (который может быть главной областью редактирования) на два равных фрейма, причем новый будет располагаться слева от текущего. Новый фрейм становится активным, и в него загружается тот же документ. +См. также Работа с многодокументным интерфейсом &kate; -&Ctrl;&Shift;T Окно Разделить по горизонтали +&Ctrl;&Shift;T Окно Разделить по горизонтали -Разделяет фрейм (который может быть главной областью редактирования) на два равных фрейма, причем новый будет располагаться в нижней половине. Новый фрейм становится активным, и в него загружается тот же документ. -См. также Работа с многодокументным интерфейсом &kate; +Разделяет фрейм (который может быть главной областью редактирования) на два равных фрейма, причем новый будет располагаться в нижней половине. Новый фрейм становится активным, и в него загружается тот же документ. +См. также Работа с многодокументным интерфейсом &kate; -&Ctrl;&Shift;R Окно Закрыть текущий вид +&Ctrl;&Shift;R Окно Закрыть текущий вид -Закрывает текущий фрейм. Если область редактирования не была разделена на фреймы, этот пункт будет недоступен. При закрытии фрейма документ, который был загружен в этот фрейм, не закрывается -- он все еще будет доступен из меню Документ и списка файлов. См. также Работа с многодокументным интерфейсом &kate; +Закрывает текущий фрейм. Если область редактирования не была разделена на фреймы, этот пункт будет недоступен. При закрытии фрейма документ, который был загружен в этот фрейм, не закрывается -- он все еще будет доступен из меню Документ и списка файлов. См. также Работа с многодокументным интерфейсом &kate; -F8 ОкноВперёд -Если окно разделено, то передает фокус следующему фрейму. +F8 ОкноВперёд +Если окно разделено, то передает фокус следующему фрейму. -&Shift;F8 ОкноНазад -Если окно разделено, то передает фокус предыдущему фрейму. - - - -ОкноСлужебные панели +&Shift;F8 ОкноНазад +Если окно разделено, то передает фокус предыдущему фрейму. + + + +ОкноСлужебные панели - -ОкноСлужебные панели Показать/Скрыть Боковые панели -Включает/выключает боковые панели. Команда не действует на панели с органами управления, боковые паели остаются видимыми, и, конечно, продолжают действовать горячие клавиши. + +ОкноСлужебные панели Показать/Скрыть Боковые панели +Включает/выключает боковые панели. Команда не действует на панели с органами управления, боковые паели остаются видимыми, и, конечно, продолжают действовать горячие клавиши. -ОкноСлужебные панели Показать/Скрыть Документы +ОкноСлужебные панели Показать/Скрыть Документы -Включает/выключает отображение списка файлов &kate;. +Включает/выключает отображение списка файлов &kate;. -ОкноСлужебные панели Показать/Скрыть Проводник +ОкноСлужебные панели Показать/Скрыть Проводник -Включает/выключает отображение служебной панели Проводник. +Включает/выключает отображение служебной панели Проводник. -ОкноСлужебные панели Показать/Скрыть Поиск в файлах +ОкноСлужебные панели Показать/Скрыть Поиск в файлах -Включает/выключает отображение инструмента Поиск в файлах. +Включает/выключает отображение инструмента Поиск в файлах. -ОкноСлужебные панели Показать/Скрыть Терминал +ОкноСлужебные панели Показать/Скрыть Терминал -Включает/выключает отображение встроенного эмулятора терминала. -Терминал создается при первом включении этого пункта. -При отображении эмулятор терминала получает фокус ввода, так что вы сразу можете вводить команды. Если включен параметр Синхронизировать терминал с активным документом, который находится на странице Общая диалога настройки, то текущий каталог будет изменён на каталог текущего документа, если это локальный файл. +Включает/выключает отображение встроенного эмулятора терминала. +Терминал создается при первом включении этого пункта. +При отображении эмулятор терминала получает фокус ввода, так что вы сразу можете вводить команды. Если включен параметр Синхронизировать терминал с активным документом, который находится на странице Общая диалога настройки, то текущий каталог будет изменён на каталог текущего документа, если это локальный файл. @@ -2222,17 +923,9 @@ -Меню <guimenu ->Справка</guimenu -> - -Если вы установили пакет tdeaddons, то вместе со стандартными пунктами меню Справка у вас будут пункты меню Справка по модулям. +Меню <guimenu>Справка</guimenu> + +Если вы установили пакет tdeaddons, то вместе со стандартными пунктами меню Справка у вас будут пункты меню Справка по модулям. &help.menu.documentation; diff --git a/tde-i18n-ru/docs/tdebase/kate/part.docbook b/tde-i18n-ru/docs/tdebase/kate/part.docbook index dd66eb93412..c5cc69cff42 100644 --- a/tde-i18n-ru/docs/tdebase/kate/part.docbook +++ b/tde-i18n-ru/docs/tdebase/kate/part.docbook @@ -1,372 +1,155 @@ -&Anders.Lund; &Anders.Lund.mail; -АндрейБалагута
uj2@mail.ru
Перевод на русский +&Anders.Lund; &Anders.Lund.mail; +АндрейБалагута
uj2@mail.ru
Перевод на русский -Редактирование текста в &kate; +Редактирование текста в &kate; -Обзор +Обзор -Редактор &kate; -- это область редактирования в главном окне &kate;. Этот же редактор используется в &kwrite;, а также в &konqueror; для отображения текстовых файлов, находящихся на вашем компьютере или в сети. +Редактор &kate; -- это область редактирования в главном окне &kate;. Этот же редактор используется в &kwrite;, а также в &konqueror; для отображения текстовых файлов, находящихся на вашем компьютере или в сети. -Редактор состоит из следующих частей: +Редактор состоит из следующих частей: -Область редактирования -Здесь отображается текст вашего документа. +Область редактирования +Здесь отображается текст вашего документа. -Полосы прокрутки +Полосы прокрутки -Полосы прокрутки показывают положение видимой части текста документа; они используются для перемещения по документу. При перемещении ползунка курсор вставки остается на месте. -Полосы прокрутки отображаются только если размер текста документа выходит за пределы области редактирования; и наоборот, когда нет необходимости в прокручивании текста, полосы прокрутки не отображаются. +Полосы прокрутки показывают положение видимой части текста документа; они используются для перемещения по документу. При перемещении ползунка курсор вставки остается на месте. +Полосы прокрутки отображаются только если размер текста документа выходит за пределы области редактирования; и наоборот, когда нет необходимости в прокручивании текста, полосы прокрутки не отображаются. -Граница пиктограмм +Граница пиктограмм -Граница пиктограмм -- это небольшая панель слева от области редактирования. На ней отображаются маленькие пиктограммы напротив помеченных строк. -Вы можете установить или убрать закладку на какой-либо строке, просто щёлкнув левой кнопкой мыши на границе пиктограмм напротив этой строки. -Отображение границы пиктограмм переключается пунктом меню Вид Показать границы пиктограмм +Граница пиктограмм -- это небольшая панель слева от области редактирования. На ней отображаются маленькие пиктограммы напротив помеченных строк. +Вы можете установить или убрать закладку на какой-либо строке, просто щёлкнув левой кнопкой мыши на границе пиктограмм напротив этой строки. +Отображение границы пиктограмм переключается пунктом меню Вид Показать границы пиктограмм -Панель номеров строк +Панель номеров строк -Панель номеров строк показывает номера видимых строк документа. -Отображение панели номеров строк переключается пунктом меню Вид Показать номера строк. +Панель номеров строк показывает номера видимых строк документа. +Отображение панели номеров строк переключается пунктом меню Вид Показать номера строк. -Полоса сворачивания блоков +Полоса сворачивания блоков -Полоса сворачивания блоков позволяет сворачивать и разворачивать отдельные блоки кода. Группировка строк в блоки осуществляется на основе правил подсветки синтаксиса. +Полоса сворачивания блоков позволяет сворачивать и разворачивать отдельные блоки кода. Группировка строк в блоки осуществляется на основе правил подсветки синтаксиса. -Содержание этой главы: -Навигация по тексту -Работа с выделением -Копирование и вставка текста -Поиск и замена текста -Использование закладок -Автоматический перенос текста по словам -Использование автоотступа +Содержание этой главы: +Навигация по тексту +Работа с выделением +Копирование и вставка текста +Поиск и замена текста +Использование закладок +Автоматический перенос текста по словам +Использование автоотступа -Навигация по тексту - -Перемещение по тексту в &kate; производится аналогично большинству графических редакторов - клавишами со стралками и Page Up, Page Down, Home, End, а также их разными комбинациями с клавишами Ctrl и Shift. Клавиша Shift позволяет выделять текст, а Ctrl имеет разные значения для разных клавиш, с которыми она выступает в комбинации: -Для клавиш Вверх и Вниз: прокрутка документа вместо перемещения курсора. -Для клавиш Влево и Вправо: перемещение по словам, а не по символам. -Для клавиш Page Up и Page Down: перемещение на край видимой области. +Навигация по тексту + +Перемещение по тексту в &kate; производится аналогично большинству графических редакторов - клавишами со стралками и Page Up, Page Down, Home, End, а также их разными комбинациями с клавишами Ctrl и Shift. Клавиша Shift позволяет выделять текст, а Ctrl имеет разные значения для разных клавиш, с которыми она выступает в комбинации: +Для клавиш Вверх и Вниз: прокрутка документа вместо перемещения курсора. +Для клавиш Влево и Вправо: перемещение по словам, а не по символам. +Для клавиш Page Up и Page Down: перемещение на край видимой области. -Для клавиш Home и End: перемещение в начало или конец документа, а не строки. +Для клавиш Home и End: перемещение в начало или конец документа, а не строки. -&kate; также предоставляет возможность перехода от открывающей скобки (в т.ч. фигурной и квадратной) к соответствующей закрывающей и наоборот: Поместите курсор перед открывающей или после закрывающей скобки (обе скобки должны выделиться жёлтым фоном) и нажмите Ctrl6. +&kate; также предоставляет возможность перехода от открывающей скобки (в т.ч. фигурной и квадратной) к соответствующей закрывающей и наоборот: Поместите курсор перед открывающей или после закрывающей скобки (обе скобки должны выделиться жёлтым фоном) и нажмите Ctrl6. -Кроме того для быстрого перехода в заданную позицию в документе, можно использовать закладки. +Кроме того для быстрого перехода в заданную позицию в документе, можно использовать закладки. -Работа с выделением +Работа с выделением -Существует два основных способа выделения текста в &kate;: с помощью мыши и с помощью клавиатуры. +Существует два основных способа выделения текста в &kate;: с помощью мыши и с помощью клавиатуры. -Чтобы выделить текст мышью, щёлкните левой кнопкой на начале текста, который хотите выделить, и, не отпуская кнопки, переместите курсор мыши на конец текста. Выделенная область текста меняется по мере перемещения указателя. +Чтобы выделить текст мышью, щёлкните левой кнопкой на начале текста, который хотите выделить, и, не отпуская кнопки, переместите курсор мыши на конец текста. Выделенная область текста меняется по мере перемещения указателя. -Двойной щелчок левой кнопкой мыши позволяет выделить слово. +Двойной щелчок левой кнопкой мыши позволяет выделить слово. -Тройной щелчок выделяет всю строку. +Тройной щелчок выделяет всю строку. -Если при нажатии левой кнопки мыши была нажата клавиша &Shift;, текст будет выделен следующим образом: +Если при нажатии левой кнопки мыши была нажата клавиша &Shift;, текст будет выделен следующим образом: -Если ничего не было выделено, от позиции ввода (текстовый курсор) до позиции курсора мыши. -Если был выделен текст, то от этого выделения и до позиции курсора мыши, включая само выделение. +Если ничего не было выделено, от позиции ввода (текстовый курсор) до позиции курсора мыши. +Если был выделен текст, то от этого выделения и до позиции курсора мыши, включая само выделение. -При выделении текста мышью он автоматически копируется в буфер обмена. Его можно вставить в редактор или в другое приложение, щёлкнув средней кнопкой мыши в нужном месте. +При выделении текста мышью он автоматически копируется в буфер обмена. Его можно вставить в редактор или в другое приложение, щёлкнув средней кнопкой мыши в нужном месте. -Чтобы выделить текст при помощи клавиатуры, нажмите клавишу &Shift; и выделите нужный блок текста, используя клавиши навигации (клавиши со стрелками, Page Up, Page Down, Home и End, возможно, в комбинации с &Ctrl;) - -Дополнительную информацию можно найти в разделе Навигация по тексту в этой главе. - -Чтобы скопировать выделенный фрагмент текста, выберите пункт меню Правка Копировать или нажмите соответствующий акселератор (по умолчанию &Ctrl;C). - -Чтобы снять выделение, выберите пункт меню Правка Отменить выбор или нажмите соответствующую быструю клавишу (по умолчанию &Ctrl;&Shift;A), или просто щёлкните левой кнопкой мыши где-нибудь в редакторе. +Чтобы выделить текст при помощи клавиатуры, нажмите клавишу &Shift; и выделите нужный блок текста, используя клавиши навигации (клавиши со стрелками, Page Up, Page Down, Home и End, возможно, в комбинации с &Ctrl;) + +Дополнительную информацию можно найти в разделе Навигация по тексту в этой главе. + +Чтобы скопировать выделенный фрагмент текста, выберите пункт меню Правка Копировать или нажмите соответствующий акселератор (по умолчанию &Ctrl;C). + +Чтобы снять выделение, выберите пункт меню Правка Отменить выбор или нажмите соответствующую быструю клавишу (по умолчанию &Ctrl;&Shift;A), или просто щёлкните левой кнопкой мыши где-нибудь в редакторе. -Вертикальное выделение +Вертикальное выделение -Когда режим вертикального выделения включен, вы можете выделить определённые столбцы символов в нескольких строках (проще говоря, выделить прямоугольный блок текста). Например, этот режим выделения может пригодиться, если у вас строки разделены табуляцией. +Когда режим вертикального выделения включен, вы можете выделить определённые столбцы символов в нескольких строках (проще говоря, выделить прямоугольный блок текста). Например, этот режим выделения может пригодиться, если у вас строки разделены табуляцией. -Режим вертикального выделения можно переключить, выбрав пункт меню Правка Вертикальное выделение +Режим вертикального выделения можно переключить, выбрав пункт меню Правка Вертикальное выделение -Замена выделенного фрагмента +Замена выделенного фрагмента -Если режим замены выделенного фрагмента включен, любой ввод или вставка текста приведёт к замене выделенного к этому моменту текста на новый текст. Если этот режим выключен, новый текст будет добавлен в позиции текстового курсора. +Если режим замены выделенного фрагмента включен, любой ввод или вставка текста приведёт к замене выделенного к этому моменту текста на новый текст. Если этот режим выключен, новый текст будет добавлен в позиции текстового курсора. -По умолчанию режим замены выделенного фрагмента включен. +По умолчанию режим замены выделенного фрагмента включен. -Включить или выключить этот режим можно на странице "Выделение" в окне настройки. +Включить или выключить этот режим можно на странице "Выделение" в окне настройки. -Постоянное выделение +Постоянное выделение -Если включен режим постоянного выделения, ввод символов или перемещение текстового курсора не вызовет снятия выделения с ранее выделенного фрагмента. Это значит, что вы можете переместить курсор за пределы выделения и вводить текст. +Если включен режим постоянного выделения, ввод символов или перемещение текстового курсора не вызовет снятия выделения с ранее выделенного фрагмента. Это значит, что вы можете переместить курсор за пределы выделения и вводить текст. -По умолчанию режим постоянного выделения отключен. +По умолчанию режим постоянного выделения отключен. -Включить или выключить этот режим можно на странице "Выделение" в окне настройки. +Включить или выключить этот режим можно на странице "Выделение" в окне настройки. -Если режимы постоянного выделения и замены выделенного фрагмента включены, ввод или вставка текста в позицию курсора, если последний находится в пределах выделенного фрагмента, вызовет его замену и снятие выделения. +Если режимы постоянного выделения и замены выделенного фрагмента включены, ввод или вставка текста в позицию курсора, если последний находится в пределах выделенного фрагмента, вызовет его замену и снятие выделения. @@ -375,329 +158,155 @@ -Копирование и вставка текста - -Чтобы скопировать текст, выделите его и выберите пункт меню Правка Копировать. Также при выделении текста мыши он автоматически копируется в буфер выделения X-сервера. - -Для вставки текста, находящегося в буфере обмена, выберите пункт меню ПравкаВставить. - -Также вы можете вставить текст из буфера выделения (последний выделенный с помощью мыши текст) в редактор нажатием средней кнопки мыши в нужном месте. +Копирование и вставка текста + +Чтобы скопировать текст, выделите его и выберите пункт меню Правка Копировать. Также при выделении текста мыши он автоматически копируется в буфер выделения X-сервера. + +Для вставки текста, находящегося в буфере обмена, выберите пункт меню ПравкаВставить. + +Также вы можете вставить текст из буфера выделения (последний выделенный с помощью мыши текст) в редактор нажатием средней кнопки мыши в нужном месте. -Если вы используете рабочий стол &kde;, вы можете выбрать ранее скопированный текст, используя программу &klipper;, чей значок находится в лотке &kicker;. +Если вы используете рабочий стол &kde;, вы можете выбрать ранее скопированный текст, используя программу &klipper;, чей значок находится в лотке &kicker;. -Поиск и замена текста +Поиск и замена текста -Диалоговые окна <guilabel ->Поиск текста</guilabel -> и <guilabel ->Замена текста</guilabel -> +Диалоговые окна <guilabel>Поиск текста</guilabel> и <guilabel>Замена текста</guilabel> -Диалоговые окна поиска и замены текста очень похожи, с той только разницей, что в диалоговом окне замены текста присутствует поле для ввода строки замены и еще несколько дополнительных параметров. +Диалоговые окна поиска и замены текста очень похожи, с той только разницей, что в диалоговом окне замены текста присутствует поле для ввода строки замены и еще несколько дополнительных параметров. -Следующие параметры являются общими: +Следующие параметры являются общими: -Искать текст -Здесь нужно ввести строку поиска. Интерпретация строки зависит от параметров, описанных ниже. +Искать текст +Здесь нужно ввести строку поиска. Интерпретация строки зависит от параметров, описанных ниже. -Регулярное выражение +Регулярное выражение -Если эта опция включена, строка поиска считается регулярным выражением. Кнопка слева предназначена для графического редактирования выражения (кнопка будет доступна, если параметр включен). -Подробнее о регулярных выражениях написано в соответствующей главе. +Если эта опция включена, строка поиска считается регулярным выражением. Кнопка слева предназначена для графического редактирования выражения (кнопка будет доступна, если параметр включен). +Подробнее о регулярных выражениях написано в соответствующей главе. -С учётом регистра +С учётом регистра -Если параметр включен, поиск будет различать регистр букв. +Если параметр включен, поиск будет различать регистр букв. -Только слово целиком +Только слово целиком -Если эта опция включена, сопоставление будет положительным только в том случае, если с обоих сторон найденной строки будут стоять разделители слов, т.е. не алфавитно-цифровые символы -- любой другой отображаемый символ или конец строки. +Если эта опция включена, сопоставление будет положительным только в том случае, если с обоих сторон найденной строки будут стоять разделители слов, т.е. не алфавитно-цифровые символы -- любой другой отображаемый символ или конец строки. -От курсора +От курсора -Если эта опция включена, поиск начнётся с позиции текстового курсора, иначе -- с первой строки документа. +Если эта опция включена, поиск начнётся с позиции текстового курсора, иначе -- с первой строки документа. -Искать назад +Искать назад -Если эта опция включена, поиск будет искать первое совпадение, которое находится до стартовой точки (позиция курсора или начало документа, если включена опция С начала документа). +Если эта опция включена, поиск будет искать первое совпадение, которое находится до стартовой точки (позиция курсора или начало документа, если включена опция С начала документа). -Диалоговое окно Замена текста содержит несколько дополнительных опций: +Диалоговое окно Замена текста содержит несколько дополнительных опций: -Заменить на: -Здесь нужно ввести заменяющую строку. +Заменить на: +Здесь нужно ввести заменяющую строку. -В выделенном фрагменте +В выделенном фрагменте -Эта опция недоступна, если нет выделенного текста или включена опция Подтверждать замену. Она позволяет выполнить замену совпавших фрагментов только в выделенном фрагменте текста. +Эта опция недоступна, если нет выделенного текста или включена опция Подтверждать замену. Она позволяет выполнить замену совпавших фрагментов только в выделенном фрагменте текста. -Подтверждать замену -Если эта опция включена, то перед каждой заменой будет выдано небольшое диалоговое окно, которое предложит вам несколько вариантов возможных действий: +Подтверждать замену +Если эта опция включена, то перед каждой заменой будет выдано небольшое диалоговое окно, которое предложит вам несколько вариантов возможных действий: -Да -Заменить текущее совпадение (в редакторе оно отображается выделенным). +Да +Заменить текущее совпадение (в редакторе оно отображается выделенным). -Нет -Не заменять текущее совпадение и перейти к следующему совпадение (если оно есть). +Нет +Не заменять текущее совпадение и перейти к следующему совпадение (если оно есть). -Все -Заменить все оставшиеся совпадения без выдачи предупреждающего окна. +Все +Заменить все оставшиеся совпадения без выдачи предупреждающего окна. -Закрыть -Пропустить текущее совпадение и завершить процесс поиска. +Закрыть +Пропустить текущее совпадение и завершить процесс поиска. - + -В текущей версии &kate; не предусмотрено возможности задания т.н. минимальных регулярных выражений (т.е. тех, которые берут совпадение по минимуму). Это будет исправлено в будущих версиях. +В текущей версии &kate; не предусмотрено возможности задания т.н. минимальных регулярных выражений (т.е. тех, которые берут совпадение по минимуму). Это будет исправлено в будущих версиях. -Поиск текста - -Если вам нужно найти какой-то текст, откройте диалоговое окно Поиск текста, нажав сочетание клавиш &Ctrl;F или выбрав пункт меню Правка Найти..., введите строку для поиска, установите нужные параметры и нажмите на OK. Если поиск начинался с позиции курсора и ничего не было найдено до конца документа (или начала -- при поиске в обратном направлении), вам будет предложено произвести поиск в оставшейся части документа. - -При нахождении, совпадение выделяется в редакторе и диалоговое окно Поиск текста исчезает с экрана, но его настройки сохраняются, это делает поиск следующего совпадения очень простым: - -Чтобы найти следующее совпадение в том же направлении поиска, выберите пункт меню Правка Продолжить поиск или нажмите клавишу F3. - -Чтобы вернуться к предыдущему совпадению, выберите пункт меню Правка Продолжить поиск назад или нажмите сочетание клавиш &Shift;F3. - -Если при поиске была достигнута граница документа (начало или конец), вам будет предложено начать поиск с другой границы документа. +Поиск текста + +Если вам нужно найти какой-то текст, откройте диалоговое окно Поиск текста, нажав сочетание клавиш &Ctrl;F или выбрав пункт меню Правка Найти..., введите строку для поиска, установите нужные параметры и нажмите на OK. Если поиск начинался с позиции курсора и ничего не было найдено до конца документа (или начала -- при поиске в обратном направлении), вам будет предложено произвести поиск в оставшейся части документа. + +При нахождении, совпадение выделяется в редакторе и диалоговое окно Поиск текста исчезает с экрана, но его настройки сохраняются, это делает поиск следующего совпадения очень простым: + +Чтобы найти следующее совпадение в том же направлении поиска, выберите пункт меню Правка Продолжить поиск или нажмите клавишу F3. + +Чтобы вернуться к предыдущему совпадению, выберите пункт меню Правка Продолжить поиск назад или нажмите сочетание клавиш &Shift;F3. + +Если при поиске была достигнута граница документа (начало или конец), вам будет предложено начать поиск с другой границы документа. -Замена текста - -Если вам нужно заменить какой-то текст на другой, откройте диалоговое окно Замена текста, нажав сочетание клавиш &Ctrl;R или выбрав пункт меню Правка Заменить..., введите строку для поиска и, если нужно, заменяющую строку (если она будет пуста, каждое совпадение будет просто удалено), установите нужные параметры и нажмите на OK. +Замена текста + +Если вам нужно заменить какой-то текст на другой, откройте диалоговое окно Замена текста, нажав сочетание клавиш &Ctrl;R или выбрав пункт меню Правка Заменить..., введите строку для поиска и, если нужно, заменяющую строку (если она будет пуста, каждое совпадение будет просто удалено), установите нужные параметры и нажмите на OK. -При использовании регулярных выражений в поиске и замене текста можно добавлять обратные ссылки, чтобы использовать текст документа, совпавший с подвыражением, заключенным в скобках (собственно, это подвыражение и есть обратная ссылка). -Подробнее об этом читайте в разделе . +При использовании регулярных выражений в поиске и замене текста можно добавлять обратные ссылки, чтобы использовать текст документа, совпавший с подвыражением, заключенным в скобках (собственно, это подвыражение и есть обратная ссылка). +Подробнее об этом читайте в разделе . -В командной строке доступны команды find, replace и ifind (поиск по мере набора). +В командной строке доступны команды find, replace и ifind (поиск по мере набора). @@ -705,276 +314,140 @@ -Использование закладок +Использование закладок -Закладки позволяют вам отметить некоторые строки, чтобы потом было легко их найти. +Закладки позволяют вам отметить некоторые строки, чтобы потом было легко их найти. -Вы можете установить или убрать закладку двумя способами: +Вы можете установить или убрать закладку двумя способами: -Переместите курсор ввода на нужную строку и выберите пункт меню ЗакладкиПереключить закладку (&Ctrl;B) +Переместите курсор ввода на нужную строку и выберите пункт меню ЗакладкиПереключить закладку (&Ctrl;B) -Щёлкните напротив нужной строки на границе пиктограмм. +Щёлкните напротив нужной строки на границе пиктограмм. -Закладки находятся в меню Закладки. Каждая из них представлена в виде отдельного пункта меню с надписью, состоящей из номера строки и первых нескольких символов этой строки. Чтобы переместить курсор ввода на строку, помеченную закладкой, откройте это меню и выберите нужную закладку. - -Для быстрого переходе между закладкам воспользуйтесь меню ЗакладкиСледующая (Alt Page Down) или ЗакладкиПредыдущая (AltPage Up ). +Закладки находятся в меню Закладки. Каждая из них представлена в виде отдельного пункта меню с надписью, состоящей из номера строки и первых нескольких символов этой строки. Чтобы переместить курсор ввода на строку, помеченную закладкой, откройте это меню и выберите нужную закладку. + +Для быстрого переходе между закладкам воспользуйтесь меню ЗакладкиСледующая (Alt Page Down) или ЗакладкиПредыдущая (AltPage Up ). -Автоматический перенос по словам - -Эта возможность позволяет отформатировать текст таким образом, чтобы ни одна строка не выходила за пределы определенной максимальной длины строки; для этого длинная строка разбивается на две или более строк, причем она разбивается на границе ближайших двух слов. - -Чтобы включить или выключить её, воспользуйтесь опцией Перенос строк на странице правки диалогового окна Настройки. - -Чтобы установить максимальную длину строки (в символах), воспользуйтесь параметром Переносить после на странице правки диалогового окна Настройки. - -Если перенос строк включен, готовьтесь к следующим полтергейстам: -При наборе редактор автоматически вставит разрыв строки при достижении максимальной длины строки. -При загрузке документа редактор автоматически разобьёт длинные строки на несколько строк нормальной длины (если они содержат пробелы -- иначе перенос строк невозможен). +Автоматический перенос по словам + +Эта возможность позволяет отформатировать текст таким образом, чтобы ни одна строка не выходила за пределы определенной максимальной длины строки; для этого длинная строка разбивается на две или более строк, причем она разбивается на границе ближайших двух слов. + +Чтобы включить или выключить её, воспользуйтесь опцией Перенос строк на странице правки диалогового окна Настройки. + +Чтобы установить максимальную длину строки (в символах), воспользуйтесь параметром Переносить после на странице правки диалогового окна Настройки. + +Если перенос строк включен, готовьтесь к следующим полтергейстам: +При наборе редактор автоматически вставит разрыв строки при достижении максимальной длины строки. +При загрузке документа редактор автоматически разобьёт длинные строки на несколько строк нормальной длины (если они содержат пробелы -- иначе перенос строк невозможен). -В текущей версии невозможно установить перенос строк только для определенных типов файлов, или хотя бы ограничить действие этого параметра на уровне документа. Это будет исправлено в будущих версиях &kate;. +В текущей версии невозможно установить перенос строк только для определенных типов файлов, или хотя бы ограничить действие этого параметра на уровне документа. Это будет исправлено в будущих версиях &kate;. -Использование автоотступа - -Компонент редактора &kate; поддерживает множество различных режимов автоматической расстановки отступов для разных форматов. Выбрать один из них можно посредством СервисВставить отступ. Модуль расстановки отступов также предоставляет пункт меню СервисВыравнивание, который пересчитывает отступ выделенного текста или текущей строки. - -Во всех режимах отступа используются параметры текущего документа, связанные с расстановкой отступов. - -Все такие параметры можно задать с помощью переменных документа и типов файлов. +Использование автоотступа + +Компонент редактора &kate; поддерживает множество различных режимов автоматической расстановки отступов для разных форматов. Выбрать один из них можно посредством СервисВставить отступ. Модуль расстановки отступов также предоставляет пункт меню СервисВыравнивание, который пересчитывает отступ выделенного текста или текущей строки. + +Во всех режимах отступа используются параметры текущего документа, связанные с расстановкой отступов. + +Все такие параметры можно задать с помощью переменных документа и типов файлов. -Доступные режимы расстановки отступов +Доступные режимы расстановки отступов -Нет -Выключить расстановку отступов. +Нет +Выключить расстановку отступов. -Обычный -Расстановка отступов аналогично предыдущей непустой строке. Вы можете совмещать его с командами расстановки отступов меню Сервис. +Обычный +Расстановка отступов аналогично предыдущей непустой строке. Вы можете совмещать его с командами расстановки отступов меню Сервис. -Стиль C -Для исходных текстов на языках, подобных C -- C++, C#, java, javascript и т.д. Этот режим не будет работать со сценарными языками, такими как Perl или PHP. +Стиль C +Для исходных текстов на языках, подобных C -- C++, C#, java, javascript и т.д. Этот режим не будет работать со сценарными языками, такими как Perl или PHP. -Стиль SS C -Альтернативный режим для C-подобных языков, с теми же ограничениями. +Стиль SS C +Альтернативный режим для C-подобных языков, с теми же ограничениями. -Стиль Python -Специально для сценариев на языке Python. +Стиль Python +Специально для сценариев на языке Python. -XML -Отступы для разметки XML. Это не работает для HTML, а только для XHTML, из-за неправильной работы со старым стилем тегов HTML (например <br>) +XML +Отступы для разметки XML. Это не работает для HTML, а только для XHTML, из-за неправильной работы со старым стилем тегов HTML (например <br>) -Отступ по переменным +Отступ по переменным -Экспериментальный и может изменить своё поведение или вообще исчезнуть в будущем. +Экспериментальный и может изменить своё поведение или вообще исчезнуть в будущем. -Он отличается тем, что его параметры можно настроить переменными в самом документе (или в настройках типа файла). Распознаются следующие переменные: +Он отличается тем, что его параметры можно настроить переменными в самом документе (или в настройках типа файла). Распознаются следующие переменные: -var-indent-indent-after +var-indent-indent-after -Регулярное выражение строки, после которой следует добавить один отступ. var-indent-indent: Регулярное выражение строки, в которой следует добавить один отступ. +Регулярное выражение строки, после которой следует добавить один отступ. var-indent-indent: Регулярное выражение строки, в которой следует добавить один отступ. -var-indent-unindent +var-indent-unindent -Регулярное выражение строки, в которой следует снять один отступ. +Регулярное выражение строки, в которой следует снять один отступ. -var-indent-triggerchars +var-indent-triggerchars -Список символов, приводящих к автоматическому перерасчёту отступов при наборе +Список символов, приводящих к автоматическому перерасчёту отступов при наборе -var-indent-handle-couples +var-indent-handle-couples -Список скобок для обработки. Любая комбинация квадратных, фигурных и круглых скобок. Каждые из них обрабатываются так: если найдена одна открывающая скобка, добавляется один отступ, если закрывающая - снимается. +Список скобок для обработки. Любая комбинация квадратных, фигурных и круглых скобок. Каждые из них обрабатываются так: если найдена одна открывающая скобка, добавляется один отступ, если закрывающая - снимается. -var-indent-couple-attribute +var-indent-couple-attribute -При поиске открывающих/закрывающих скобок, учитывать только символы с данным атрибутом. Это должно быть имя атрибута из файла определения синтаксиса, например "Symbol". Если не указано, используется 0 (обычно это 'Normal Text'). +При поиске открывающих/закрывающих скобок, учитывать только символы с данным атрибутом. Это должно быть имя атрибута из файла определения синтаксиса, например "Symbol". Если не указано, используется 0 (обычно это 'Normal Text'). - + diff --git a/tde-i18n-ru/docs/tdebase/kate/plugins.docbook b/tde-i18n-ru/docs/tdebase/kate/plugins.docbook index 97baee24423..9666a5622cd 100644 --- a/tde-i18n-ru/docs/tdebase/kate/plugins.docbook +++ b/tde-i18n-ru/docs/tdebase/kate/plugins.docbook @@ -2,38 +2,17 @@ -&Anders.Lund; &Anders.Lund.mail; -АндрейБалагута
uj2@mail.ru
Перевод на русский +&Anders.Lund; &Anders.Lund.mail; +АндрейБалагута
uj2@mail.ru
Перевод на русский -Работа с модулями +Работа с модулями -В Kate предусмотрены две формы модулей - модули собственно для &kate; и модули для компонента редактора. Последний используется другими приложожениями, такими как KDevelop, Quanta, KWrite. +В Kate предусмотрены две формы модулей - модули собственно для &kate; и модули для компонента редактора. Последний используется другими приложожениями, такими как KDevelop, Quanta, KWrite. -Оба типа модулей настраиваются в окне параметров, в котором также можно настроить сами модули, если они это предусматривают +Оба типа модулей настраиваются в окне параметров, в котором также можно настроить сами модули, если они это предусматривают -Многие модули помещены в пакет tdeaddons, другие модно найти поиском в Интернет. несколько модулей поставляются вместе с компонентом редактора -- модуль автозавершения, заклвдок, вставки файлов, тезауруса, проверки орфографии и поиска по мере набора. +Многие модули помещены в пакет tdeaddons, другие модно найти поиском в Интернет. несколько модулей поставляются вместе с компонентом редактора -- модуль автозавершения, заклвдок, вставки файлов, тезауруса, проверки орфографии и поиска по мере набора. diff --git a/tde-i18n-ru/docs/tdebase/kate/regular-expressions.docbook b/tde-i18n-ru/docs/tdebase/kate/regular-expressions.docbook index cf75800799f..843d2fa3f07 100644 --- a/tde-i18n-ru/docs/tdebase/kate/regular-expressions.docbook +++ b/tde-i18n-ru/docs/tdebase/kate/regular-expressions.docbook @@ -1,470 +1,157 @@ -&Anders.Lund; &Anders.Lund.mail; -АндрейБалагута
uj2@mail.ru
Перевод на русский +&Anders.Lund; &Anders.Lund.mail; +АндрейБалагута
uj2@mail.ru
Перевод на русский -Регулярные выражения +Регулярные выражения -Это приложение содержит краткое, но, надеюсь, достаточно ясное введение в мир регулярных выражений. Здесь описаны регулярные выражения в той форме, в которой они используются в &kate;; к сожалению, они не совместимы с с регулярными выражениями perl и grep. +Это приложение содержит краткое, но, надеюсь, достаточно ясное введение в мир регулярных выражений. Здесь описаны регулярные выражения в той форме, в которой они используются в &kate;; к сожалению, они не совместимы с с регулярными выражениями perl и grep. -Введение - -Регулярные выражения - это средство, позволяющее описывать содержание строк в некотором формализованном виде, что даёт возможность приложениям определять принадлежность той или иной строки определённому формату. В дополнение ко всему некоторые приложения могут сохранять части совпавшей строки для их последующего использования. - -Приведём небольшой пример. Допустим, вы хотите найти в тексте все абзацы, которые начинаются с фамилий Петров или Иванов, за которыми следует любая форма глагола рассказывать (для чистоты эксперимента возьмём всего две формы рассказал и рассказывал). - -С помощью обычного поиска вам бы понадобилось сначала найти фамилию Петров, возможно, дополненную буквами рассказ, что-то вроде этого: Петров рассказ. При поиске совпадений пришлось бы пропускать все строки, которые стоят не в начале абзаца. После этого последовал бы повторный поиск для второй фамилии... - -Регулярные выражения позволяют произвести такую операцию поиска за один раз, причём с гораздо большей точностью. - -Регулярные выражения содержат правила, позволяющие точно выразить вид строки для поиска. Наш пример можно выразить словесно: Строка, начинающаяся со слов Петров или Иванов, перед которыми могут стоять до четырёх пробелов или символов табуляции, после фамилии должен стоять пробел, за пробелом - рассказ, после чего может (необязательно!) стоять суффикс ыв, и, наконец, суффикс ал. Посмотрите, как это можно записать в форме регулярного выражения: ^[ \t]{0,4}(Петров|Иванов) рассказ(ыв)?ал - -Этот пример демонстрирует четыре основных понятия современных регулярных выражений: +Введение + +Регулярные выражения - это средство, позволяющее описывать содержание строк в некотором формализованном виде, что даёт возможность приложениям определять принадлежность той или иной строки определённому формату. В дополнение ко всему некоторые приложения могут сохранять части совпавшей строки для их последующего использования. + +Приведём небольшой пример. Допустим, вы хотите найти в тексте все абзацы, которые начинаются с фамилий Петров или Иванов, за которыми следует любая форма глагола рассказывать (для чистоты эксперимента возьмём всего две формы рассказал и рассказывал). + +С помощью обычного поиска вам бы понадобилось сначала найти фамилию Петров, возможно, дополненную буквами рассказ, что-то вроде этого: Петров рассказ. При поиске совпадений пришлось бы пропускать все строки, которые стоят не в начале абзаца. После этого последовал бы повторный поиск для второй фамилии... + +Регулярные выражения позволяют произвести такую операцию поиска за один раз, причём с гораздо большей точностью. + +Регулярные выражения содержат правила, позволяющие точно выразить вид строки для поиска. Наш пример можно выразить словесно: Строка, начинающаяся со слов Петров или Иванов, перед которыми могут стоять до четырёх пробелов или символов табуляции, после фамилии должен стоять пробел, за пробелом - рассказ, после чего может (необязательно!) стоять суффикс ыв, и, наконец, суффикс ал. Посмотрите, как это можно записать в форме регулярного выражения: ^[ \t]{0,4}(Петров|Иванов) рассказ(ыв)?ал + +Этот пример демонстрирует четыре основных понятия современных регулярных выражений: -Шаблоны -Утверждения -Квантификаторы -Обратные ссылки +Шаблоны +Утверждения +Квантификаторы +Обратные ссылки -Значок ^, с которого начинается выражение - это утверждение, которое подтверждает совпадение только в том случае, если совпавшая цепочка символов начинается с новой строки. - -[ \t] и (Петров|Иванов) рассказ(ыв)?ал - это шаблоны. Первый представляет собой символьный класс, который совпадает либо с пробелом, либо с символом табуляции. Второй содержит вложенный шаблон, совпадающий со словами Петров или Иванов, затем идёт проверка на точное совпадение со строкой рассказ, потом ещё один вложенный шаблон, который определяет вхождение символов ыв, и, в самом конце, проверка на точное совпадение с символами ал - -Строка {0,4} и символ вопроса после вложенного шаблона (ыв) - это квантификаторы. Первый можно трактовать следующим образом: возможен повтор предыдущего символа от 0 до 4 раз. Второй квантификатор действует аналогично, позволяя повторить стоящий перед ним вложенный шаблон 0 или 1 раз. - -Все приложения, работающие с регулярными выражениями и поддерживающие обратные ссылки, при совпадении сохраняют всю строку и вложенные шаблоны в некоторой области памяти и предоставляют средства для получения этих значений. Поэтому мы можем получить всю совпавшую строку (при поиске в редакторе она обычно выделяется цветом) или, например, только фамилию. - -Как вы могли убедиться на предыдущем примере, регулярные выражения - это очень эффективное средство поиска, позволяющее найти именно то, что вам нужно, без особых усилий. - -В следующих разделах подробно рассмотрены шаблоны, символьные классы, утверждения, квантификаторы и обратные ссылки. В конце этой главы вы найдёте несколько полезных примеров. +Значок ^, с которого начинается выражение - это утверждение, которое подтверждает совпадение только в том случае, если совпавшая цепочка символов начинается с новой строки. + +[ \t] и (Петров|Иванов) рассказ(ыв)?ал - это шаблоны. Первый представляет собой символьный класс, который совпадает либо с пробелом, либо с символом табуляции. Второй содержит вложенный шаблон, совпадающий со словами Петров или Иванов, затем идёт проверка на точное совпадение со строкой рассказ, потом ещё один вложенный шаблон, который определяет вхождение символов ыв, и, в самом конце, проверка на точное совпадение с символами ал + +Строка {0,4} и символ вопроса после вложенного шаблона (ыв) - это квантификаторы. Первый можно трактовать следующим образом: возможен повтор предыдущего символа от 0 до 4 раз. Второй квантификатор действует аналогично, позволяя повторить стоящий перед ним вложенный шаблон 0 или 1 раз. + +Все приложения, работающие с регулярными выражениями и поддерживающие обратные ссылки, при совпадении сохраняют всю строку и вложенные шаблоны в некоторой области памяти и предоставляют средства для получения этих значений. Поэтому мы можем получить всю совпавшую строку (при поиске в редакторе она обычно выделяется цветом) или, например, только фамилию. + +Как вы могли убедиться на предыдущем примере, регулярные выражения - это очень эффективное средство поиска, позволяющее найти именно то, что вам нужно, без особых усилий. + +В следующих разделах подробно рассмотрены шаблоны, символьные классы, утверждения, квантификаторы и обратные ссылки. В конце этой главы вы найдёте несколько полезных примеров. -Шаблоны +Шаблоны -Шаблоны состоят из символов и символьных классов. Допускается вложенность, в этом случае вложенные шаблоны заключаются в круглые скобки. +Шаблоны состоят из символов и символьных классов. Допускается вложенность, в этом случае вложенные шаблоны заключаются в круглые скобки. -Управляющие последовательности +Управляющие последовательности -И в шаблонах, и в символьных классах некоторые символы имеют специальное значение. Если вы хотите использовать эти символы при поиске именно как символы, нужно записать их определённым образом, чтобы анализатор регулярных выражений считал их обычными литералами. +И в шаблонах, и в символьных классах некоторые символы имеют специальное значение. Если вы хотите использовать эти символы при поиске именно как символы, нужно записать их определённым образом, чтобы анализатор регулярных выражений считал их обычными литералами. -Делается это очень просто, нужно всего лишь поставить перед таким символом обратную косую черту (\). +Делается это очень просто, нужно всего лишь поставить перед таким символом обратную косую черту (\). -Анализатор регулярных выражений игнорирует обратную черту перед символами, которые не имеют специального значения в контексте; например, если вы вместо обычного символа j напишете \j, анализатор его воспримет просто как j. Таким образом, если вы не уверены, имеет ли символ специальное значение, можете спокойно ставить перед ним обратную косую черту. +Анализатор регулярных выражений игнорирует обратную черту перед символами, которые не имеют специального значения в контексте; например, если вы вместо обычного символа j напишете \j, анализатор его воспримет просто как j. Таким образом, если вы не уверены, имеет ли символ специальное значение, можете спокойно ставить перед ним обратную косую черту. -Для указания символа обратной косой черты (в качестве литерала), продублируйте его: \\. +Для указания символа обратной косой черты (в качестве литерала), продублируйте его: \\. -Символьные классы и сокращения - -Символьный класс - это выражение, которое позволяет проверить один символ на принадлежность определённому набору символов. Чтобы использовать его в регулярных выражениях, нужно в квадратных скобках записать все верные символы или сокращённые классы, описанные ниже. - -Простые символьные классы содержат один или несколько символов, например, [abc] (проверка на любой из символов a, b или c) или [0123456789] (проверка на любую цифру). - -Поскольку буквы и цифры упорядоченны логически, вы можете сокращать классы, используя диапазоны: [a-c] аналогично [abc], [0-9] аналогично [0123456789]. Можно комбинировать диапазоны с обычным перечислением символов: [a-fynot1-38] (проверка на любой из символов a,b,c,d, e,f,y,n,o,t, 1,2,3 или 8). - -Чтобы проверить символ без учёта регистра в любом случае (регулярное выражение может учитывать или не учитывать регистр символов), нужно написать примерно следующее: [aAbB]. - -Можно создать исключающий класс, который проверяет символ на не вхождение в заданный набор символов. Обычный символьный класс превращается в исключающий добавлением символа ^ перед набором символов: - -[^abc] - проверка на любой символ, кроме a, b и c. - -В дополнение к обычным литералам можно использовать следующие сокращения: +Символьные классы и сокращения + +Символьный класс - это выражение, которое позволяет проверить один символ на принадлежность определённому набору символов. Чтобы использовать его в регулярных выражениях, нужно в квадратных скобках записать все верные символы или сокращённые классы, описанные ниже. + +Простые символьные классы содержат один или несколько символов, например, [abc] (проверка на любой из символов a, b или c) или [0123456789] (проверка на любую цифру). + +Поскольку буквы и цифры упорядоченны логически, вы можете сокращать классы, используя диапазоны: [a-c] аналогично [abc], [0-9] аналогично [0123456789]. Можно комбинировать диапазоны с обычным перечислением символов: [a-fynot1-38] (проверка на любой из символов a,b,c,d, e,f,y,n,o,t, 1,2,3 или 8). + +Чтобы проверить символ без учёта регистра в любом случае (регулярное выражение может учитывать или не учитывать регистр символов), нужно написать примерно следующее: [aAbB]. + +Можно создать исключающий класс, который проверяет символ на не вхождение в заданный набор символов. Обычный символьный класс превращается в исключающий добавлением символа ^ перед набором символов: + +[^abc] - проверка на любой символ, кроме a, b и c. + +В дополнение к обычным литералам можно использовать следующие сокращения: -\a -Проверка на ASCII-символ звонка (BEL, 0x07). +\a +Проверка на ASCII-символ звонка (BEL, 0x07). -\f -Проверка на ASCII-символ перевода страницы (FF, 0x0C). +\f +Проверка на ASCII-символ перевода страницы (FF, 0x0C). -\n -Проверка на символ перевода строки (LF, 0x0A, символ перехода на новую строку в Unix). +\n +Проверка на символ перевода строки (LF, 0x0A, символ перехода на новую строку в Unix). -\r -Проверка на символ возврата каретки (CR, 0x0D). +\r +Проверка на символ возврата каретки (CR, 0x0D). -\t -Проверка на символ горизонтальной табуляции (HT, 0x09) +\t +Проверка на символ горизонтальной табуляции (HT, 0x09) -\v -Проверка на символ вертикальной табуляции (VT, 0x0B). +\v +Проверка на символ вертикальной табуляции (VT, 0x0B). -\xhhhh - -Проверка на символ в кодировке Unicode, соответствующий номеру hhhh (в пределах 0x0000-0xFFFF). \0ooo (первый символ - ноль) - проверка на символ в кодировке ASCII/Latin-1, соответствующий восьмеричному номеру ooo (в пределах 0-0377). +\xhhhh + +Проверка на символ в кодировке Unicode, соответствующий номеру hhhh (в пределах 0x0000-0xFFFF). \0ooo (первый символ - ноль) - проверка на символ в кодировке ASCII/Latin-1, соответствующий восьмеричному номеру ooo (в пределах 0-0377). -. (точка) -Проверка на любой символ (включая переход на новую строку). +. (точка) +Проверка на любой символ (включая переход на новую строку). -\d -Проверка на цифровой символ. Аналогично классу [0-9]. +\d +Проверка на цифровой символ. Аналогично классу [0-9]. -\D -Проверка на любой символ, не являющийся цифровым. Аналогично [^0-9] или [^\d] +\D +Проверка на любой символ, не являющийся цифровым. Аналогично [^0-9] или [^\d] -\s -Проверка на пробельный символ. Фактически аналогично классу [ \t\n\r] +\s +Проверка на пробельный символ. Фактически аналогично классу [ \t\n\r] -\S -Проверка на любой символ, не являющийся пробельным. Фактически равнозначно [^ \t\r\n] и аналогично [^\s] +\S +Проверка на любой символ, не являющийся пробельным. Фактически равнозначно [^ \t\r\n] и аналогично [^\s] -\w -Проверка на любой алфавитно-цифровой символ (как вы поняли, сюда включаются все буквы и цифры). Подчёркивание (_) не входит в этот класс, в отличие от регулярных выражений perl. Это сокращение аналогично классу [a-zA-Z0-9] +\w +Проверка на любой алфавитно-цифровой символ (как вы поняли, сюда включаются все буквы и цифры). Подчёркивание (_) не входит в этот класс, в отличие от регулярных выражений perl. Это сокращение аналогично классу [a-zA-Z0-9] -\W -Проверка на любой символ, не являющийся алфавитно-цифровым. Аналогично классу [^a-zA-Z0-9] или [^\w] +\W +Проверка на любой символ, не являющийся алфавитно-цифровым. Аналогично классу [^a-zA-Z0-9] или [^\w] @@ -472,71 +159,31 @@ -Аббревиатурные классы можно помещать в обычные классы; например, чтобы выполнить проверку на алфавитно-цифровой символ, точку или пробел, вы можете написать так: [\w \.] +Аббревиатурные классы можно помещать в обычные классы; например, чтобы выполнить проверку на алфавитно-цифровой символ, точку или пробел, вы можете написать так: [\w \.] - В текущей версии не поддерживается нотация классов POSIX ([:<class name>:]). + В текущей версии не поддерживается нотация классов POSIX ([:<class name>:]). -Символы со специальным значением в символьных классах +Символы со специальным значением в символьных классах -Ниже перечислены символы, имеющие специальное значение в определениях символьных классов ([]). Для использования в качестве обычных литералов они должны быть предварены обратной косой чертой. +Ниже перечислены символы, имеющие специальное значение в определениях символьных классов ([]). Для использования в качестве обычных литералов они должны быть предварены обратной косой чертой. -] -Закрывает символьный класс. Этот символ должен быть предварён обратной косой чертой, кроме тех случаев, когда стоит непосредственно в начале класса или сразу после символа ^ +] +Закрывает символьный класс. Этот символ должен быть предварён обратной косой чертой, кроме тех случаев, когда стоит непосредственно в начале класса или сразу после символа ^ -^ -Если стоит в начале, объявляет исключающий класс. Чтобы использовать как литерал в начале класса, нужно поставить обратную косую черту. +^ +Если стоит в начале, объявляет исключающий класс. Чтобы использовать как литерал в начале класса, нужно поставить обратную косую черту. -- (дефис) -Определяет логический диапазон. Чтобы использовать в качестве литерала, всегда нужно ставить обратную косую черту. +- (дефис) +Определяет логический диапазон. Чтобы использовать в качестве литерала, всегда нужно ставить обратную косую черту. -\ (обратная черта) -Спецсимвол (escape character). Чтобы использовать как литерал, продублируйте. +\ (обратная черта) +Спецсимвол (escape character). Чтобы использовать как литерал, продублируйте. @@ -547,248 +194,110 @@ -Альтернативы: проверка на <quote ->один из</quote -> нескольких шаблонов - -Если вы хотите выполнить проверку на один (любой) шаблон из определённого набора, используйте альтернативы. Чтобы объявить альтернативу, нужно все шаблоны набора записать через канал (|). - -Например, чтобы найти любое из имён Вася и Петя, нужно использовать такое выражение: Вася|Петя. +Альтернативы: проверка на <quote>один из</quote> нескольких шаблонов + +Если вы хотите выполнить проверку на один (любой) шаблон из определённого набора, используйте альтернативы. Чтобы объявить альтернативу, нужно все шаблоны набора записать через канал (|). + +Например, чтобы найти любое из имён Вася и Петя, нужно использовать такое выражение: Вася|Петя. -Вложенные шаблоны +Вложенные шаблоны -Вложенными называются шаблоны, заключённые в круглые скобки. Они используются в разных целях: +Вложенными называются шаблоны, заключённые в круглые скобки. Они используются в разных целях: -Определение альтернатив - -Используя вложенные шаблоны, вы можете группировать набор альтернатив внутри сложных шаблонов. Напомню, альтернативы разделяются символом перенаправления через канал (|). - -Например, чтобы найти одно из слов int, float или double, вы можете использовать шаблон int|float|double. Если же вы хотите найти одно из этих слов, за которым идут пробелы, а за ними какие-то символы, то вы должны оформить альтернативу как вложенный шаблон: (int|float|double)\s+\w+. +Определение альтернатив + +Используя вложенные шаблоны, вы можете группировать набор альтернатив внутри сложных шаблонов. Напомню, альтернативы разделяются символом перенаправления через канал (|). + +Например, чтобы найти одно из слов int, float или double, вы можете использовать шаблон int|float|double. Если же вы хотите найти одно из этих слов, за которым идут пробелы, а за ними какие-то символы, то вы должны оформить альтернативу как вложенный шаблон: (int|float|double)\s+\w+. -Захват совпавшего текста (обратные ссылки) - -Чтобы создать обратную ссылку, оформите как вложенный шаблон ту часть выражения, которую нужно запомнить. - -Например, если вы хотите найти два одинаковых слова, разделённых запятой и, возможно, пробелами, можно использовать такое выражение: (\w+),\s*\1. Вложенный шаблон \w+ ищет цепочку алфавитно-цифровых символов, а всё выражение ищет ту же цепочку, за которой следует запятая, далее могут идти пробелы, а за ними точно такая же цепочка (строка \1 ссылается на первый вложенный шаблон, заключённый в круглые скобки). - - +Захват совпавшего текста (обратные ссылки) + +Чтобы создать обратную ссылку, оформите как вложенный шаблон ту часть выражения, которую нужно запомнить. + +Например, если вы хотите найти два одинаковых слова, разделённых запятой и, возможно, пробелами, можно использовать такое выражение: (\w+),\s*\1. Вложенный шаблон \w+ ищет цепочку алфавитно-цифровых символов, а всё выражение ищет ту же цепочку, за которой следует запятая, далее могут идти пробелы, а за ними точно такая же цепочка (строка \1 ссылается на первый вложенный шаблон, заключённый в круглые скобки). + + -Просматривающие утверждения - -Просматривающее утверждение - это вложенный шаблон, который начинается с символов ?= или ?!. - -Например, чтобы найти слово Билл, за которым может следовать что угодно, кроме слова Гейтс, нужно составить такое выражение: Билл(?! Гейтс) (оно совпадёт с Билл Клинтон, Билли хороший мальчик, но не с именем известного магната). - -Вложенные шаблоны, использующиеся в качестве утверждений, не запоминаются. - -Смотрите также раздел Утверждения +Просматривающие утверждения + +Просматривающее утверждение - это вложенный шаблон, который начинается с символов ?= или ?!. + +Например, чтобы найти слово Билл, за которым может следовать что угодно, кроме слова Гейтс, нужно составить такое выражение: Билл(?! Гейтс) (оно совпадёт с Билл Клинтон, Билли хороший мальчик, но не с именем известного магната). + +Вложенные шаблоны, использующиеся в качестве утверждений, не запоминаются. + +Смотрите также раздел Утверждения -Символы со специальным значением в шаблонах +Символы со специальным значением в шаблонах -Следующие символы имеют специальное значение в шаблонах, поэтому, чтобы использовать их в качестве обычных символов, нужно впереди ставить обратную черту: +Следующие символы имеют специальное значение в шаблонах, поэтому, чтобы использовать их в качестве обычных символов, нужно впереди ставить обратную черту: -\ (обратная черта) -С него должны начинаться все спецсимволы. +\ (обратная черта) +С него должны начинаться все спецсимволы. -^ -Проверка на начало строки. +^ +Проверка на начало строки. -$ -Проверка на конец строки. +$ +Проверка на конец строки. -() (левая и правая круглые скобки) -Объявление вложенного шаблона. +() (левая и правая круглые скобки) +Объявление вложенного шаблона. -{} (левая и правая фигурные скобки) -Объявление числового квантификатора. +{} (левая и правая фигурные скобки) +Объявление числового квантификатора. -[] (левая и правая квадратные скобки) -Объявление символьного класса. +[] (левая и правая квадратные скобки) +Объявление символьного класса. -| (вертикальная черта) -Логическое ИЛИ. Используется для разделения альтернатив. +| (вертикальная черта) +Логическое ИЛИ. Используется для разделения альтернатив. -+ (плюс) -Квантификатор один или более. ++ (плюс) +Квантификатор один или более. -* (звёздочка) -Квантификатор ноль или более. +* (звёздочка) +Квантификатор ноль или более. -? (знак вопроса) -Необязательный символ. Можно считать его квантификатором ноль или один. +? (знак вопроса) +Необязательный символ. Можно считать его квантификатором ноль или один. @@ -800,125 +309,58 @@ -Квантификаторы - -Квантификатор выполняют проверку на определённое количество повторений символа, шаблона или символьного класса. - -Квантификаторы записываются в фигурных скобках ({ и }). Общий вид квантификатора: {[минимальное-количество-совпадений][,[максимальное-количество-совпадений]]} - -Использование квантификаторов лучше пояснить на примерах: +Квантификаторы + +Квантификатор выполняют проверку на определённое количество повторений символа, шаблона или символьного класса. + +Квантификаторы записываются в фигурных скобках ({ и }). Общий вид квантификатора: {[минимальное-количество-совпадений][,[максимальное-количество-совпадений]]} + +Использование квантификаторов лучше пояснить на примерах: -{1} -Ровно одно появление +{1} +Ровно одно появление -{0,1} -Ноль или одно появление +{0,1} +Ноль или одно появление -{,1} -То же самое, но набирать меньше ;) +{,1} +То же самое, но набирать меньше ;) -{5,10} -Как минимум 5 повторений, максимум - 10. +{5,10} +Как минимум 5 повторений, максимум - 10. -{5,} -Как минимум 5 повторений (без верхней границы). +{5,} +Как минимум 5 повторений (без верхней границы). -Также определены несколько сокращений: +Также определены несколько сокращений: -* (звёздочка) -аналогично {0,}, найти любое количество повторений (вплоть до нуля повторений). +* (звёздочка) +аналогично {0,}, найти любое количество повторений (вплоть до нуля повторений). -+ (плюс) -аналогично {1,}, как минимум одно появление. ++ (плюс) +аналогично {1,}, как минимум одно появление. -? (знак вопроса) -аналогично {0,1}, ноль или одно появление. +? (знак вопроса) +аналогично {0,1}, ноль или одно появление. @@ -927,96 +369,39 @@ -Максимально возможная подстрока +Максимально возможная подстрока -Используя квантификаторы без ограничений максимума, регулярное выражение захватывает строку по максимуму, такое поведение называется жадным. +Используя квантификаторы без ограничений максимума, регулярное выражение захватывает строку по максимуму, такое поведение называется жадным. -Современные анализаторы позволяют определять как жадные, так и не жадные регулярные выражения. В основном, это проявляется в соответствующих элементах графического интерфейса, например, в диалоге поиска может быть опция Минимальное совпадение. +Современные анализаторы позволяют определять как жадные, так и не жадные регулярные выражения. В основном, это проявляется в соответствующих элементах графического интерфейса, например, в диалоге поиска может быть опция Минимальное совпадение. -Примеры использования +Примеры использования -Здесь приведено несколько примеров использования квантификаторов. +Здесь приведено несколько примеров использования квантификаторов. -^\d{4,5}\s -Совпадёт с 1234 вперёд и 12345 стоп, но не совпадёт ни с 567 восемь, ни с 223459 много. +^\d{4,5}\s +Совпадёт с 1234 вперёд и 12345 стоп, но не совпадёт ни с 567 восемь, ни с 223459 много. -\s+ -Проверка на один или более пробельных символов. +\s+ +Проверка на один или более пробельных символов. -(ля){1,} -Совпадёт с ляляля и с подстрокой ля в словах кляча и земля +(ля){1,} +Совпадёт с ляляля и с подстрокой ля в словах кляча и земля -/?> -Совпадёт с /> в <closeditem/>, а также с > в строке <openitem>. +/?> +Совпадёт с /> в <closeditem/>, а также с > в строке <openitem>. @@ -1026,166 +411,56 @@ -Утверждения - -Утверждения накладывают дополнительные условия на проверку регулярного выражения. - -Утверждение не проверяет символы, скорее, оно анализирует совпавшую строку перед тем как подтвердить совпадение. Например, утверждение граница слова не пытается найти символ-разделитель слов, наоборот, оно проверяет, что в данной позиции нет алфавитно-цифрового символа. Это означает, что утверждение будет верно даже в случае отсутствия символа-разделителя, например, в конце строки поиска. - -Некоторые утверждения являются шаблонами, но они лишь проверяют, есть или нет в данном месте строки совпадение заданному шаблону, не включая его в конечный результат (т.е. в "совпавший текст"). - -Регулярные выражения, описанные в этом руководстве, поддерживают следующие утверждения: - - -^ (начало строки) -Проверка на начало строки. Выражение ^Пётр совпадёт с Пётр в строке Пётр, здравствуйте!, но не в строке Здравствуйте, Пётр!. +Утверждения + +Утверждения накладывают дополнительные условия на проверку регулярного выражения. + +Утверждение не проверяет символы, скорее, оно анализирует совпавшую строку перед тем как подтвердить совпадение. Например, утверждение граница слова не пытается найти символ-разделитель слов, наоборот, оно проверяет, что в данной позиции нет алфавитно-цифрового символа. Это означает, что утверждение будет верно даже в случае отсутствия символа-разделителя, например, в конце строки поиска. + +Некоторые утверждения являются шаблонами, но они лишь проверяют, есть или нет в данном месте строки совпадение заданному шаблону, не включая его в конечный результат (т.е. в "совпавший текст"). + +Регулярные выражения, описанные в этом руководстве, поддерживают следующие утверждения: + + +^ (начало строки) +Проверка на начало строки. Выражение ^Пётр совпадёт с Пётр в строке Пётр, здравствуйте!, но не в строке Здравствуйте, Пётр!. -$ (конец строки) -Проверка на конец строки поиска. - -Выражение ты\?$ совпадёт с последним ты в строке - Ты не сделаешь этого! - А ты?, но не совпадёт ни с какой частью строки Ты не сделал этого, так?. +$ (конец строки) +Проверка на конец строки поиска. + +Выражение ты\?$ совпадёт с последним ты в строке - Ты не сделаешь этого! - А ты?, но не совпадёт ни с какой частью строки Ты не сделал этого, так?. -\b (граница слова) -Проверяет, есть ли в данном месте с одной стороны алфавитно-цифровой символ, а с другой - не алфавитно-цифровой (необязательно разделитель!). -Это утверждение используется для поиска границ слов; например, можно использовать два таких утверждения, чтобы найти целое слово. Выражение \bиз\b совпадёт с отдельным словом из во фразе Он выпал из этого окна, хорошо хоть, что тут низко, но не совпадёт с из в слове низко. +\b (граница слова) +Проверяет, есть ли в данном месте с одной стороны алфавитно-цифровой символ, а с другой - не алфавитно-цифровой (необязательно разделитель!). +Это утверждение используется для поиска границ слов; например, можно использовать два таких утверждения, чтобы найти целое слово. Выражение \bиз\b совпадёт с отдельным словом из во фразе Он выпал из этого окна, хорошо хоть, что тут низко, но не совпадёт с из в слове низко. -\B (нет границы слова) -Действие этого утверждения обратно утверждению \b. -Это значит, что данное утверждение будет совпадать, например, в середине слова: выражение \Bце\B совпадёт с це в строке сцена, но не в целое. +\B (нет границы слова) +Действие этого утверждения обратно утверждению \b. +Это значит, что данное утверждение будет совпадать, например, в середине слова: выражение \Bце\B совпадёт с це в строке сцена, но не в целое. -(?=ШАБЛОН) (подтверждающий просмотр) -Просматривающие утверждения действуют аналогично обычным шаблонам, с той лишь разницей, что текст, совпавший (или не совпавший, в зависимости от типа просмотра) с утверждением, не будет включен в результирующее совпадение. Подтверждающий просмотр проверяет текст на предмет совпадения с ШАБЛОНОМ утверждения. -Выражение программ(?=\w) совпадёт с программ в слове программист, но не во фразе Он написал много хороших программ!. +(?=ШАБЛОН) (подтверждающий просмотр) +Просматривающие утверждения действуют аналогично обычным шаблонам, с той лишь разницей, что текст, совпавший (или не совпавший, в зависимости от типа просмотра) с утверждением, не будет включен в результирующее совпадение. Подтверждающий просмотр проверяет текст на предмет совпадения с ШАБЛОНОМ утверждения. +Выражение программ(?=\w) совпадёт с программ в слове программист, но не во фразе Он написал много хороших программ!. -(?!ШАБЛОН) (отрицающий просмотр) - -Отрицающий просмотр проверяет текст на предмет несовпадения с ШАБЛОНОМ. -Выражение const \w+\b(?!\s*&) совпадёт с const char в строке const char* foo, но не совпадёт с const QString в const QString& bar, поскольку & совпадает с шаблоном отрицающего просмотра. +(?!ШАБЛОН) (отрицающий просмотр) + +Отрицающий просмотр проверяет текст на предмет несовпадения с ШАБЛОНОМ. +Выражение const \w+\b(?!\s*&) совпадёт с const char в строке const char* foo, но не совпадёт с const QString в const QString& bar, поскольку & совпадает с шаблоном отрицающего просмотра. @@ -1197,11 +472,9 @@ -- cgit v1.2.1