|
|
SciTE |
|
|
Редактирование текста в SciTE работает одинаково как в большинстве редакторов на Windows и Macintosh с автоматическим форматированием текста. SciTE может одновременно удерживать в памяти несколько файлов, только один будет виден. Конфигурация SciTE по умолчанию настроена на удерживание в памяти только одного файла, это может быть изменено исправлением значения свойств буфера. Выделение областей в SciTE активируется удерживанием кнопки Alt в Windows или Ctrl в GTK+ во время выделение текста.
В SciTE две панели, панель редактирования и панель вывода. Панель вывода расположена справа от панели редактирования или снизу. По умолчанию её размер равен нулю, но она может быть увеличена перетаскиванием разделителя между панелью редактирования и панелю вывода. Команда Options | Vertical Split позволяет переместить панель вывода под панель редактирования.
SciTE может запускать команды на компиляцию или запуска исходных текстов с выводом консольных сообщений в панель вывода.
Например, если Python установлен на компьютере, откройте документ и напишите в нем:
print "Hi"Сохраните документ как printhi.py.
print "hi" >python -u
printhi.py
hi
>Exit code: 0
SciTE частично обрабатывает сообщения об ошибках возвращаемых Python, GCC, Visual C++, Borland C++, PHP и другими инструментами которые используют такой-же формат как и одни из перечисленных. Для того чтобы увидеть это добавим ошибку в Python файл добавлением второй строки в файл:
print
"hi"
mistake
Запустите Tools | Go команду. Результа должен выглядеть так:
>python -u printhi.py hi Traceback (innermost last): File "printhi.py", line 2, in ? mistake NameError: mistake >Exit code: 1
Пока легко увидеть где проблема в этом простом примере, но когда файл больше команда Tools | Next Message может использоваться для показа каждой из сообщенных ошибок. После выполнения команды Tools | Next Message, первая строка с ошибкой будет выделена желтым фоном и помещен индикатор рядом с текущим сообщением об ошибке. Каретка передвинута на строку с ошибкой и, если нужно, панель редактирование передвинута для показа этой строки. Теперь SciTE выглядит так:
SciTE в большинстве случаев распознает имя файла и строку с ошибкой в сообщении об ошибке и может открыть другой файл (например заголовочный) если ошибка произошла в нем. Эта функция не работает если название файла включает пробелы или ".."
Если выполнение было не удачным или занимает слишком много времени, для её завершения выполните команду Tools | Stop Executing.
В Windows, SciTE по умолчанию запускает программу как консольную. При выполнении GUI программы, в этом режиме, программа запуститься без показа окна. Опция command.subsystem используется для настройки запуска в GUI режиме. По умолчанию значение равно 0, это для консольных программ, 1 - для программ которые создают окна и 2 для выполнения вызова "ShellExecute" (команда передается ОС для выполнения). "ShellExecute" хороший способ для открытия HTML файлов и похожих, это похоже на то, что пользователь открыл файл из ОС. Параметр 3 - для вызова расширения или внешнего приложения. 4 - для вызова специальной "HtmlHelp" программы и 5 для вызова специальной функции Windows - "WinHelp". В GTK+, значение по умолчанию 0, выполняет программу и ждет её завершения, вывод перенаправляет в панель вывода и значение 2 выполняет программу в фоне.
Параметры командной строки в SciTE включает название файлов, команды и свойства. Командам и свойствам предшествет символ "-" и разделяеться символом ':' если первый символ не '.' или буква. Параметры командной строки используют синтакс файлов свойств и перекрывают любые свойства установленные в этих файлах. Если значение не передаеться, оно устанавливаеться в 1. Параметры в которых используються пробелы должны быть целиком в двойных кавычках, а не только название файла. Например "-open:x y.txt" - работает, а -open:"x y.txt" - нет. On Linux, the standard shell quoting is available. При использовании параметра "-p" SciTE печатает файл и закрываеться.
Например, SciTE "-font.base=font:MS Gothic,size:11"
-save.recent ScintillaGTK.cxx
запускает SciTE, открывает файл
ScintillaGTK.cxx, открывает последние файлы, и использует 11 размер MS
Gothic как базовый шрифт.
Свойства могут быть сохранены в файле свойств
(расширение ".properties") и для импорта использует командную
строку:SciTE "-import c:\os\web_work" SciTEDoc.html
| команда | Параметр |
|---|---|
| close: | |
| cwd: | смена рабочей папки |
| find: | искомый текст |
| goto: | номер строки[,номер столбца] |
| open: | имя файла для открытия |
| quit: | |
| replaceall: | заменяемый текст\000текст на который нужно заменить |
| saveas: | имя сохраняемого файла |
| Эскейп последовательность | Значение |
|---|---|
| \\ | Обратный слэш |
| \a | Синал |
| \b | Возврат каретки |
| \f | form feed |
| \n | Новая строка |
| \r | Возврат каретки |
| \t | Табуляция |
| \v | Вертикальная табуляция |
| \<ooo> | Восьмеричное значение оформленное 1, 2 или 3 цифрами. |
| \x<hh> | Шестнадцатеричное значние оформленное 2 цифрами |
SciTE -open:/big/icon.txt SciTE "-open:C:\\Program
Files\\SciTE\\SciTEDoc.html" -goto:123 Параметры командной строки читаються слева на право, в двух фазах т.к. для открытия файлов необходим интерфейс пользователя, а некоторые установки пользователя должны быть применены до отображения пользовательского интерфейса. Первая фаза анализирует параметры до команды открытия первого файла. Вторая фаза анализирует оставшиеся параметры.
Так, если вам нужно выполнить команду "find:" или "goto:" для файла, вы должны поместить команды после названия файла, чтобы SciTE открыл файл до выполнения команды.
Для Windows:
Если параметр название
файла содержит название папки, откроеться диалог открытия файла - это
настравиеться в свойстве
"open.dialog.in.file.directory"
Если в своейтве
"buffers" выставлено значение больше 1 и название название файла
соответвует существующему файлу или обозначает поиск шаблона в одном или
нескольких файлах. Количестов загруженных файлов удовлетворяющих условию
будет не больше выставленного значения свойства "buffers". Папки не
учитываються в данном случае.
Если в названии файла указано
расширение слудующее за путем к файлу и нет файлов удовлетворяющих
условию, откроеться диалог открытия файлов с установленным
расширением.
Если название файла не сожержит расширения, свойство
"source.default.extensions" используеться для установки расширения
по умолчанию, чтобы попытаться найти существующий файл.
SciTE может быть настроен на использование от 1 до 100 буферов каждый содержащий файл. Значение по умолчанию 1 это эффективно выключает буферы. Со значением более еденицы, меню Buffers может быть использованно для переключения между буферами. Можно переключиться на буффер выбором названия файла или использовав команды "Previous (F6)" и "Next (Shift+F6)" Установка количества буферов более 10 может повлечь проблемы обрезания названия файлов в меню и файлы с длинными именами могут быть не доступны.
Когда все буферы содеражат файлы, и производиться открытие нового файла буфер может быть использован повторно, что может потребовать сохранение файла. В этом случае отображаеться окно в котором пользователю предлагаеться сохранить файл перед закрытием.
Сессии это сохраненный список файлов. Вы можете полностью сохранить сессию открытых файлов на данный момент для последующей быстрой, автоматической загрузки файлов Сессия сохраняються в файлах простого текста с расширением ".ses".
Используйте команду File | Load Session and File | Save Session для загрузки/сохранения сесий. Вы можете активировать/деактивировать загрузку последней сесии использовав свойство SciTE изменив занчение параметра "save.session".
Если занчение параметра "buffers" установленно в "0" управление сессиями отключаеться.
Загрузка сохраненной сесии закроет открытые файлы, но вы не потеряете свои данные т.к. во время сохранения программа предложит сохранить изменные файлы.
Открытие файла из командной строки перекрывает опцию "save.session". Когда вы запускаете SciTE с параметром командной строки открытия файла последня сессия не восстановиться даже если значение параметра "save.session" было выставленно в "1". Это делает параметр "save.session" безопастным и вы никогда не откроете много файлов когда хотите открыть один.
На данный момент SciTE способен применить автоматическое форматирование текста для языков:
Запуск и компиляция для некоторых из этих языков были настроены, но эти настройки т.к. они установленны для работы у большинства людей.
Определение языка произходит из расширения файла, но язык может быть изменен выбором другого языка в меню "Language". Меню "Language" может быть изменено редактированием свойства "menu.language".
SciTE имеет функцию поиска слов, регулярных выражений, сравнение с искомым, в обратном направлении, начинает поиск с начала документа после его конца. С подобные эскейп последовательности могут быть использованы в командной строке, в заданиях для поиска и замены. Замена может быть выполненна индивидуально, для выделенной секции, для всего файла. Когда используеться регулярные выражения в замене текста, могут быть использованы теги.
Введение в регулярные выражения в SciTE.
SciTE использует заданные по умолчанию в Scintilla клавиатурные
команды, так в большинстве случаев SciTE следует установленным в Windows
и GTK+ стандартам. Все клавиши передвижения (курсоры, page up/down, home
and end) подерживают выделение строк при удерживании клавиши Shift и
выделение областей при удерживани клавиш Shift и Alt. Некоторые команды
могут быть недоступны с некоторыми национальными раскладками или по
причине контроля этих команд системой такой как Windows или GTK+.
Свойство "user.shortcuts" может быть использованно для задания
функции клавиатурной команде.
Примечание: Назначение функции
клавиши "Home" делаеться редактированием свойства "vc.home.key
option". Задаваемые клавиатурные команды эквиваленты командам меню.
Некоторые клавиатурные команды не имеющие эквивалента командам в меню:
| Увеличить размер текста. | Ctrl+Keypad+ |
| Уменьшить размер текста. | Ctrl+Keypad- |
| Восстановить размер текста по умолчанию. | Ctrl+Keypad/ |
| Цикличное переключение между открытими файлами. | Ctrl+Tab |
| Добавить отсутп. | Tab |
| Убрать отступ. | Shift+Tab |
| Удалить слово слева от курсора. | Ctrl+BackSpace |
| Удалить слово справа от курсора. | Ctrl+Delete |
| Удалить строку слева от курсора. | Ctrl+Shift+BackSpace |
| Удалить строку справа от курсора. | Ctrl+Shift+Delete |
| Переход к началу документа. | Ctrl+Home |
| Выделить фрагмент от курсора до начала документа. | Ctrl+Shift+Home |
| Переход к началу строки. | Alt+Home |
| Выделить фрагмент текста до начала строки. | Alt+Shift+Home |
| Переход к концу документа. | Ctrl+End |
| Выделить фрагмент от курсора до конца документа. | Ctrl+Shift+End |
| Переход к концу строки. | Alt+End |
| Выделить фрагмент текста до конца строки. | Alt+Shift+End |
| Свернуть/Развернуть сворачивание(folding). | Ctrl+Keypad* |
| Установить/Удалить закладку. | Ctrl+F2 |
| Передти к следующей закладке. | F2 |
| Найти выделенное. | Ctrl+F3 |
| Найти выделенное в обратном порядке. | Ctrl+Shift+F3 |
| Прокрутка вверх. | Ctrl+Up |
| Прокрутка вниз. | Ctrl+Down |
| Вырезать строку. | Ctrl+L |
| Скопировать строку. | Ctrl+Shift+T |
| Удалить строку. | Ctrl+Shift+L |
| Поменять местами строки. | Ctrl+T |
| Дубликат строки. | Ctrl+D |
| Find matching preprocessor conditional, skipping nested ones. | Ctrl+K |
| Select to matching preprocessor conditional. | Ctrl+Shift+K |
| Find matching preprocessor conditional backwards, skipping nested ones. | Ctrl+J |
| Select to matching preprocessor conditional backwards. | Ctrl+Shift+J |
| Предыдущий параграф. Удерживание клавиши Shift активирует выделение. | Ctrl+[ |
| Следующий параграф параграф. Удерживание клавиши Shift активирует выделение. | Ctrl+] |
| Предыдущее слово. Удерживание клавиши Shift активирует выделение. | Ctrl+Left |
| Следущее слово. Удерживание клавиши Shift активирует выделение. | Ctrl+Right |
| Предыдущая часть слова. Удерживание клавиши Shift активирует выделение. | Ctrl+/ |
| Следующая часть слова. Удерживание клавиши Shift активирует выделение. | Ctrl+\ |
Для использования сокращений, наберите и выполните команду "Expand Abbreviation" или сочетание клавишь Ctrl+B. Сокращения заменяеться абревиатурой заданной в файле расшифровок. Вы можете открыть файл сокращений командой меню "Options | Open Abbreviations File" и добавить сокращения.
Каждая строка в этом файле выглядит как
"сокращение=расшифровка".
Название сокращения может иметь любые символы
(исключая управляющие символы, и конечно перевод строки (CR) и возврат
каретки (LF)), включая Ascii символы(high Ascii chars)(акцентированные
символы(accented chars))
Сокращения имеют ограничения файлов свойств:
сокращения не могут начинаться с символа шарп("#"), пробела, табуляции (но
могут иметь пробелы внутри), и не могут иметь символ равенства ("=")
внутри.
Сокращения ограничено 32-я символами. Этого должно хватить для
сокращений...
Сокращения могут иметь символы перевода на новую строку '\n' и символ
позиции каретки обозначенный как '|'. Для включения символа '|'
используйте '||'.
Некоторые простые примеры включеные в дистрибутив
файла сокращений.
При расшифровке сокращения аббревиатура может быть не
отделена от остального текста. Т.е. Если вы определите сокращение 'й' как
'é' вы можете его расшифровать прямо в слове.
Если одно
сокращение заканчивает другое, будет расшифрованно только меньшее. Т.е.
если вы поределите сокращения 'ring' и 'gathering', будет расшифрованно
только 'ring'.
if=if(|)\n{\n\n}
SciTE поддерживает свертку для Python, HTML/XML, Pascal, и C++/C/Java/JavaScript. Свертка основанна на отступах для Python и скобках для других языков. Кликом на символе свертки можно развернуть и свернуть свертку. Ctrl+Shift+Клик на символе свертки сворачивает или разворачивает все верхнего уровня свертки. Ctrl+Клик на символе свертки выполняет ту-же операцию для дочерних. Shift+Клик на символе свертки показывает все дочерние.
Поведение SciTE может быть изменено редактированием файлов настроек.
Здесь используется 4 файла настроек:
Параметры в локальном файле настроек перекрывают теже параметры в файле настройки папки, которые перекрывают параметры в файле пользовательских настроек, которые в свою очередь перекрывают параметры в файле глобальных настроек. Системные переменные окружения также доступны как параметры и могут перекрываться явным заданием значения в одном из файлов настроек.
Файл настройки папки может использоватся как файл с настройками проекта, где команды пользователя и команды компиляции и сборки должны работать одинаково и в подпапках проекта. Смысл в том что файлы локальных настроек в подпапках заменяются одним файлом настроек в корневой папке прокета. Использование файлов настроек папок по-умолчанию отключено и включается установкой параметра properties.directory.enable равным 1 в файле пользовательских или глобальных настроек.
Файл пользовательских настроек предназначен для редактирования пользователем, оставьте файл глобальных настроек для настроек по умолчанию. Главное предназначение файла глабальных настроек для изменения параметров запуска, компиляции и сборки файлов в папках. Например, я использую "javac" компилятор из "Java Development Kit" для большинства работ, так файл "SciTEGlobal.properties" устанавливает команду для компиляции файлов ".java" с помощью "javac". Если я захочу использовать "jvc" копилятор для файлов в одной папке, тогда файл SciTE.properties в этой папке устанавливаю для использования "jvc" копилятора.
В Windows файл глобальных настроек находиться в папке с исполняемым файлом SciTE. Файл пользовательских настроек находится в папке с профилем пользователя которая задана переменной окружения USERPROFILE или в папке с исполняемым файлом SciTE если переменная USERPROFILE не установлена. В GTK+ файл пользовательских находиться в домашней папке пользователя и файлы глобальных настроек в папке установленной во время сборки - обычно "/usr/share/scite". Если параметр SciTE_HOME выставлен в Windows или GTK+ оба файла глобальных и пользовательских настроек SciTE ищет в этой папке.
В меню Options есть команды для открытия каждого из файлов свойств.
Файлы свойств приблизительно имеют тот-же формат, что и файлы свойств в "Java", которые имеют формат простого текста. Строки начинающиеся с '#' или полность пустые - комментарии. Остальные строки имеют формат:
свойство=значение
Для длинных значений символ '\' в конце строки продолжает переменную на
следующую строку. Пробелы значимы, так x =1 определяет
переменную названную как "x ". Значения могут включать в себя
значения других переменных использованием "$(название_переменной)"
Некоторые переменные устанавливаються средой для правильного доступа к
файлу:
| Название | Пояснение |
|---|---|
| FilePath | Полный путь для текущего файла |
| FileDir | Папка текущего файла без отслеживания(trailing) слеша |
| FileName | Имя файла без расширения |
| FileExt | Расширение текущего файла |
| FileNameExt | $(FileName).$(FileExt) |
| SessionPath | Полный путь текущей сесии |
| CurrentSelection | Значение выделенного текста на данный момент |
| CurrentWord | Значение слова на котором символ каретки или около него |
| Replacements | Число замен сделанное полсдней коммендой замены |
| SelectionStartColumn | Столбец начала выделения |
| SelectionStartLine | Строка начала выделения |
| SelectionEndColumn | Столбец окончания выделения |
| SelectionEndLine | Строка окончания выделения |
| SciteDefaultHome | Папка где найден файл глобальных настроек |
| SciteUserHome | Папка где найден файл настроек пользователя |
Некоторые характеристики используют образцы названия файлов для
определения какие значения необходимо использовать. Например lexer может
установить переменные как для конкретного файла, так и для группы файлов
удовлетворяющих шаблону: lexer.makefile=makefile показывает, что
lexer должен применить значения для "makefile" файлов, для файлов имена
которых соответсвуют "makefile".
lexer.*.cxx=cpp показывает, что
lexer должен применить занчения для "cpp", для файлов имена которых имеют
"cxx" расширения.
Подстановка переменной произходит слева от файлового
шаблона и выглядит
так:
file.patterns.html=*.html;*.htm;*.asp;*.shtml
command.go.$(file.patterns.html)=file://$(FilePath)
Команда 'import' включает файл свойств так как если-бы текст из файла включили в строку с этой командой. Импортированные файлы свойств должны быть в той-же папке где и текущий файл. Следовательно команда "import Lua" в файле "c:\os\scite\bin\SciTEGlobal.properties" исмпортирует "c:\os\scite\bin\Lua.properties".
Команда 'if'(если) принимает один параметр который может быть обьявлен ранее в этом файле свойств или в базовом файле свойств. Если параметр равен '0' тогда команда потерпит неудачу. Пустая строка или необьявленное свойство приравниваеться '0'. Into the very top property set is inserted one of 'PLAT_GTK' with value '1' or 'PLAT_WIN' with value '1'. If the test succeeds then following indented statements are executed. When a non-indented statement is found the if clause is finished. Only simple set statements are allowed in if clauses. The evaluation of if statements occurs at read time, not at evaluation time.
SciTE имеет 4 параметра $(1) .. $(4), которые можно использовать для запуска команд с изменяемыми параметрами. Для установки параметров используйте команду "Вид"-"Параметры" для отображения независимого окна "Параметры", где показаны действующие значения парметров и можно определить новые. Клавиши быстрого доступа для основного окна остаются рабочими пока этот диалог отображается, так можно использовать для быстрого запуска команд с различными параметрами несколько раз. В качестве альтернативы команда может отображать модальное окно "Параметры" при выполнении если указать "*", которая потом игнорируется. Если было открыто не модальное окно "Параметры", то "*" игнорируется.
SciTE автоматически определяет кодировку используемую для файлов Unicode, которые начинаются с "метки расположения байтов" (Byte Order Mark (BOM)). Кодировки UTF-8 и UCS-2 распознаются включая "сначала старшие" и "сначала младшие" варианты UCS-2.
Файлы UTF-8 будут также распознаны если содержат параметры кодировки в первых 2 строках.
Параметры кодировки выглядят как "coding: utf-8" ("coding" следом ':'
или '=', опционально пробел, опционально кавычки, "utf-8") и обычно расположены в комментарии:
Для других кодировок установите параметры code.page и character.set properties.
Некоторые свойства доступны только для Windows или GTK+.
| position.left position.top position.width position.height |
Содержат начальный размер и положение окна программы. Если они не заданы, размер и положение устанавливаются в зависимости от настроек ОС и ее оболочки. Окно программы открывается на полный экран, если position.width или position.height установлены в -1. |
| position.tile | При установке этой опции и запуске дополнительной версии SciTE,
её position.left устанавливается в position.left + position.width первого окна. Таким образом, можно видеть одновременно оба окна без их перекрывания. Идеальным решением будет, установка position.left в 0 и position.width в половину ширины экрана. |
| buffers | Отвечает за максимальное количество одновременно открытых файлов
- то есть количество буферов для их размещения в памяти. Может иметь значение от 1 до 100. Значения вне диапазона устанавливается в его граничные значения. По умолчанию устанавливается в 1. Это приводит к отключению свойства интерфейса при работе с буферами (исчезают закладки открытых файлов). Это значение считывается только при запуске программы и только из файлов глобальных настроек(SciTEGlobal.properties). Чтобы изменение этого свойства вступило в силу нужно перегрузить SciTE. |
| buffers.zorder.switching | Данный параметр определяет порядок переключения буферов при нажатии Ctrl+Tab. Если значение параметра равно 1, то буферы переключаются в порядке их предыдущего выбора, если равно 0 - то в порядке заданном номерами буферов. |
| are.you.sure are.you.sure.for.build |
Обычно, при закрытии изменённого файла программа спрашивает,
нужно ли сохранить его. Установив are.you.sure в 0 и файл будет автоматически сохраняться, не беспокоя пользователя. Чтобы отказаться от сохранения изменений используйте команду File | New, которая всегда спрашивает "Вы уверенны?", давая возможность отказаться от сохранения файла. Установив are.you.sure.for.build в 1 программа также будет спрашивать о сохранении файла перед его выполнением, компиляцией или запуском других команд из меню Tools. |
| save.all.for.build |
SciTE по умолчанию сохраняет только текущий буфер при выполнении команд "Собрать", "Компилировать" и "Выполнить". Для того чтобы сохранять все буферы поставте значение равное 1. |
| view.whitespace view.indentation.whitespace |
Установите view.whitespace равным 1, чтобы сделать
пробелы видимыми. Установите view.indentation.whitespace равным 0, чтобы сделать отступы видимыми. |
| whitespace.fore whitespace.back |
С помощью этой команды можно установить цвет и фон пробелов /
отступов |
| view.indentation.guides highlight.indentation.guides | Установите view.indentation.guides равным 1 чтобы,
сделать видимыми вертикальные линии в пределах интервала указанного
командой indent.size Свойство highlight.indentation.guides установленное в 1 добавляет автоматическей отступ у скобки. Setting highlight.indentation.guides to 1 highlights the indentation guide associated with a brace when that brace is highlighted. |
| view.eol | Свойство view.eol установленное в 1 позволяет
видеть символы конца/переноса строки, они будут видны аналогично
(CR), (LF) или (CR), (LF). Оно полезно для редактирования или просмотра файлов созданных в других операционных системах. |
| eol.mode | Заданный по умолчанию режим конца строки зависит от вашей
платформы. Вы можете изменить его поведение изменяя свойство:
LF для формата UNIX
Как Вы видите Windows объединила все самое лучшее ;-)
CR для формата Macintosh CRLF для формата DOS/Windows |
| eol.auto | Данный параметр перекрывает значение параметра eol.mode и выбирает символ конца строки на основе текущего содержимого файла, когда он загружается. Выбирется большинство используемых символов конца строки. |
| blank.margin.left blank.margin.right |
Размер пустого, незаполненного отступа с обеих сторон текста. |
| margin.width | Это свойство позволяет задать размер колонки отображающего
нумерацию строк. Размер задается в пикселях. Маркеры(bookmarks) отображаются в этом же поле. |
| fold.margin.colour fold.margin.highlight.colour |
Два этих свойста позволяют задать цвет колонки отображающего
нумерацию строк. Если они не определены(закоментированы), то они
выставляются по умолчанию. Пример, fold.margin.colour=#FF0000 и fold.margin.highlight.colour=#0000FF, смесь красного и синего . |
| full.screen.hides.menu | При установке данного свойства в full.screen.hides.menu=1
в полноэкранном режиме меню будет скрыто, только для Windows В GTK+ меню - всегда видимо. |
| minimize.to.tray | Свойство установленное в 1 при минимизирует редактор в системный трей. |
| line.margin.visible line.margin.width |
SciTE отображает колонку номеров строк. При установке данного
свойства line.margin.visible=1 колонка будет видна при
запуске радактора. Свойство line.margin.width резервирует ширину колонки, с точки зрения количества цифр в номере. Для автоматического увеличения ширины поля, необходимо добавить + после цифры, например:line.margin.width=3+ |
| tabbar.visible tabbar.hide.one |
Устанавливая свойство "tabbar.visible=1" делает панель
файловых вкладок(таббар) видимой. Для работы этой опции, количество буферов( "buffers" ) должно быть больше 1. Эта свойство работает в операционных системах: Windows, GTK+2.x, GTK+1.x его не поддерживает. |
| tabbar.multiline | Свойство "tabbar.multiline" использует многочисленные линии для панели файловых вкладок(таббара). |
| toolbar.visible | Свойство "toolbar.visible=1" делает видимой панель иконок. |
| toolbar.detachable | Установка данного параметра равным 1 делает панель инструментов отделимой от главного окна. |
| toolbar.usestockicons | SciTE имеет встроенный набор иконок для панели инструментов, если сделать этот параметр равным 1, то SciTE использует иконки предоставляемые текущей темой рабочего стола GNOME. |
| menubar.detachablemenubar.detachable | Установка данного параметра равным 1 делает панель меню отделимой от главного окна. |
| undo.redo.lazy | Установка данного параметра равным 1, изменяет способ определения активности и неактивности кнопок на панели инструментов, делая его менее точным. Это свойство может увеличить скорость работы Scite на медленных машинах. |
| statusbar.visible | Свойство установленное "statusbar.visible=1" делает видимым статус бар. |
| statusbar.number statusbar.text.number |
"statusbar.text.1" свойство определяет информацию
отображенную в статус баре включенную по умолчанию для всех
платформ. В значениях свойств может быть использован $() синтаксис. Обычно используются свойства: ReadOnly, EOLMode, BufferLength, NbOfLines (in buffer), SelLength (chars), SelHeight (lines). Дополнительные свойства определенные для статус бара LineNumber, ColumnNumber, and OverType которые меняются как "OVR" или "INS" в зависимости от заменяющего статуса. Так же вы можете использовать файловые свойства, которые не меняются на продолжении редактирования(нажатий клавиш) данного файла: FileName(имя файла) или FileNameExt(имя файла для выполнения), FileDate(дата создания/изменения) и FileTime(время создания/изменения) и FileAttr. Так же есть свойства: CurrentDate(текущая дата) и CurrentTime(текущее время). Только для платформы Windows можно установить "statusbar.text.2", тогда можно будет переключаться между информацией отображенной на статус баре щелчками мыши. Эта опция позволяет определить количество "statusbar.text.number". |
| use.palette | Выставляя это свойство как "1" вы устанавливаете цветовую
палитру в 8 бит. Без этой опции Scite покажет только те цвета
которые уже доступны в стандартной 20 палитрах Windows. При
включении этой опции во время активации окна Scite возможно
некоторое мигание. Эта функция не используется в GTK+, где палитра всегда использована. |
| buffered.draw | Предпочтительней устанавливать это свойство в "0" (по умолчанию "1"), в этом случае Scite выводит данные непосредственно на экран, иначе - сначала в буфер, и только потом на экран. Буферизованный вывод предотвращает мерцания экрана, но и работает медленнее (две операции вместо одной и используется дополнительная память). |
| two.phase.draw | Рисование текста за два прохода имеет лучшее качество отображения, но работатет медленее. В однофазной отрисовке каждый символ рисуется вместе с фоном, который задан стилем. Если конец одного символами "нависает" над началом другого символа, например: "V_" где стиль "V" отличается от стиля "_", то правая часть символа "V" будет перекрыта фоном "_". Двухфазная решает эту проблему, при этом сначала рисуются фоны символов согласно их стилей, затем рисуются сами символы с прозрачным фоном. Двухфазная отрисовка может вызывать более сильное мерцание чем однофазная если buffered.draw не включен. По умолчанию включена двухфазная отрисовка. |
| load.on.activate save.on.deactivate |
Свойство "load.on.activate" позволяет Scite проверять
текущий файл был ли он изменен другим процессом, всякий раз при
активации. Это очень полезно когда другой редактор, например WYSIWYG
HTML editor используется в связке со Scite. Свойство save.on.deactivate позволяет Scite сохранять текущий файл всякий раз, как Scite теряет фокус. Это свойство очень полезно при разработке HTML страниц, когда вы сворачиваетесь, чтобы проверить в браузере результат изменений. |
| are.you.sure.on.reload | Когда это свойство включено("are.you.sure.on.reload=1") и
свойство "load.on.activate=1", Scite спросит вас,
действительно хотите перезагрузить модифицированный файл. По умолчанию это свойство выключено, чтобы не мешать вам глупыми вопросами :). |
| reload.preserves.undo | Когда это свойство приравнено к "1" при перезагрузке
файла не удаляется история отмены. Эта команда полезна когда свойство "load.on.activate" используется в связке с командами фильтра. |
| check.if.already.open | Когда это свойство установленно как "1", Scite проверяет
есть ли другая загруженная копия Scite'а. Если это так, то он не
дает загрузить другую копию Scite.
When this option is set and SciTE is started, it checks to see if there are any other instances of SciTE open. If there is, another instance is activated and this one exits. An arbitrary instance is chosen and asked to open the command line argument. |
| read.only | Когда это свойство активно, то первый документ открывается только для чтения. Новые настройки не используют это свойство. |
| quit.on.close.last | Если эта опция установленна, то при закрытии последнего файла
программа Scite завершится. ( По умолчанию эта опция отключена, т.е. Scite при закрытие последнего файла Scite останется открытым и создаст новый чистый документ когда последний файл будет закрыт) |
| selection.fore selection.back selection.alpha |
Устанавливает цвета используемые для отображения выделенного текста. Если эти параметры не заданы, тогда используются цвета по умолчанию. Настройки по умолчанию меняют фон на серый не меняя цвет текста. Прозрачность выделения задается параметром selection.alpha |
| caret.fore | Устанавливает цвет каретки. |
| caret.line.back caret.line.back.alpha |
Устанавливает цвет фона и прозрачность строки на которой установлена каретка. Прозрачность задается от 0 (прозрачный) до 255 (непрозрачный), 256 совсем отключает прозрачность, которая может замедлить работу. |
| caret.period | Устанавливает период мерцания каретки. Период исчисляется в миллисекундах. Величина "0" отключает мерцание каретки. |
| caret.width | Устанавливает ширину каретки в пикселях. Можно установить только следующие значения: 1,2,3. |
| caret.policy.xslop caret.policy.width caret.policy.xstrict caret.policy.xeven caret.policy.xjumps caret.policy.yslop caret.policy.lines caret.policy.ystrict caret.policy.yeven caret.policy.yjumps |
Чтобы определить окраину (slop), необходимо задать ширину окраины в
xslop и высоту в yslop. Если параметр strict установлен, политика осуществляеться...
более строго Если jumps установлено, экран прокручивается быстрее чем каретка
может сдивинуться в том-же направлении, перед тем как настройки
применяться снова. Если even не задано, вместо симметричной НЗ, левая и нижняя
НЗ расширяются до правой и верхней НЗ соответствено. Смотрите таблицу ниже как эти настройки взаимодействуют. |
| visible.policy.strict visible.policy.slop visible.policy.lines |
Опеределяет как показывать после Go to команды или похощей например Find или Next Message. Настройка аналогична caret.policy.*. |
| edge.mode edge.column edge.colour |
Показывает длинные линии. По умолчанию edge.mode, 0, не отображает длинные линии так edge.mode = 1 используеться для вертикальных линий для выделения опеределенной колонки. и установка edge.mode в 2 изменяеть цвет фона символов на этой колонке.Для пропорциональных шрифтов, значение 2 более удобно чем 1. |
| control.char.symbol | Устанавливает символ для отображения контрольных символов. Если он не установлен, контрольные символы показываются как МНЕМОНИКИ. |
| error.marker.fore error.marker.back |
Этими двумя величинами устанавливается цвет указания ошибки и
линий предупреждений выходного окна. Этим цветом будет выделяться символ при сообщениях об ошибке в панели вывода, Если на панели есть поле тогда символ отображаеться в поле для отображения сообщения об ошибке на панели вывода или линия вызывающая ошибку на панели редактирования. error.marker.back используеться как как цвет символов и error.marker.fore как outline colour. Если нет поля, тогда цвет фон линии устанавливаеться опцией error.marker.back. |
|
bookmark.fore bookmark.back bookmark.alpha |
Цвета используемые для отображения закладок в поле. Если параметр bookmark.fore не задан, то используется голубой шарик. Когда отображение полей отключено, закладки отображаются изменением фона строки с прозрачностью заданой параметром bookmark.alpha. |
| find.mark | Если установлен, то команда "Пометить все" в диалоге "Найти" отметит каждую найденную строку полупрозрачным прямоугольником. |
| error.select.line | Когда выполнение команды вызывает появление сообщения об ошибке, и вы переключаетесь между соответствующими строками кода с помощью F4, данный параметр выбирает строку где произошла ошибка. Самое полезное если сообщение об ошибке также содержит номер позиции в строке, то выделение будет с данной позиции. Сообщение об ошибке должно содержать позицию в строке и должно быть понимаемо SciTE (сейчас поддерживается только HTML Tidy). Размер табулятора используемый внешней утилитой должен совпадать с размером табулятора в вашем файле, для корректного определения позиции. |
| openpath.filepattern | Определяет путь для открытия выделенного файла в меню файла.
Путь просматривается если в имени файла не абсолютный путь к нему,
или если файл не найден в директории документа. Директории отделены
знаком ";" в Windows и знаком ":" в
GTK+. Пример:
openpath.*.txt=c:\dos\;f:\;
openpath.$(file.patterns.cpp)=$(cpp_includes) |
| open.suffix.filepattern | Определяет расширение добавляемое к указанным именам файлов при
использовании команды Open Selected Filename из меню
File. Это свойство используется в языках где расширение не
указывается при вызове файла. Пример - Pyton, где "import xlib" будет наиболее часто обозначать импортирование из файла "xlib.py". Пример: opensuffix.*.py=.py |
| strip.trailing.spaces | При сохранении для экономии удаляются пробелы на концах строк. |
| ensure.final.line.end | При сохранении добавляет в конец файла один перенос строки.
Проверять окончание файла символом окончания строки при сохранении файла. |
| ensure.consistent.line.ends | Проверять окончание всех линий текущим символом окончания строки при сохранении файла. |
| abbreviations.filepattern |
Загружает файл с абревиатурой для определенного
языка, перекрывая файл абревиатур по умолчанию. Например:
abbreviations.*.c=$(SciteUserHome)/c_abbrev.properties
|
| api.filepattern | Загружает файлы API для указанного языка. При присутствии более
одного файла API, файлы разделяются знаком ";". Файлы API
содержат отсортированный список прототипов функций и идентификаторов
по указанных одному на строку. Команда "Complete Identifier" смотрит
на символы перед кареткой и отображает список функций и т.д. из
файла API начинающегося с этих символов. При подачи команды "Complete Identifier", начинается поиск символа находящегося перед картекой по файлу API, и если прототип найден, то он отображается как выпадающий список. Пример настройки команды: api.*.c=w.apiмогут быть использованы с w.api файлом содержащим fclose(FILE*
fileClose)автодополнение и выпадающие списки для некоторых файловых функций C. Лучше всего использовать полный путь к файлу API или держать их в текущей дирктории. См. секцию создания API файлов, для их создания. |
| autocomplete.choose.single | Если данному символу при использовании "autocompletion" удовлетворяет только одно ключевое слово, то элемент автоматически будет дополнен. |
| autocomplete.lexer.ignorecase autocomplete.*.ignorecase |
При включение этого свойства поиск элементов автодополнения
чувствителен к регистру. В противном случае при поиске элементов
регистр игнорируется. Свойство "autocomplete.*.ignorecase=1" используется для файлов без специфических настроек в Lexer. |
| autocomplete.lexer.start.characters autocomplete.*.start.characters |
Если это свойство не пустое, т.е. в нем указан какой-нибудь
символ, то при указании оного, автоматически выходит выпадающее меню
начинающееся с этого символа. Например, если
"autocomplete.python.start.characters" и API файл для языка
Python содержит "string.rjust" и "string.replace" и мы
напечатаем "string." тем самым autocompletion отобразит оба
идентификатора. Свойство "autocomplete.*.start.characters" используется для файлов без специфических настроек в Lexer. |
| autocomplete.lexer.fillups autocomplete.*.fillups |
Если это свойство установленно, то печатая любой символ вы
вызываете "autocompletion" с его завершением. Для примера,
если установлено "autocomplete.python.fillups=(" и API файл
для языка Python содержит "string.replace" при печатании
"string.r(" автоматически дополнит до
"string.replace(". Свойство "autocomplete.*.fillups" используется для файлов без специфических настроек в Lexer. |
| autocompleteword.automatic | Если это свойство установленно "autocompleteword.automatic=1" и при набивке какого-нибудь слова в списке "autocompletion" находится только одно подходящее, оно будет автоматически дополненно. |
| calltip.lexer.ignorecase calltip.*.ignorecase |
Когда свойство установленно как "1", поиск элементов
списка функций по API файлу нечувствителен к регистру. Свойство "calltip.*.ignorecase" используется для файлов без специфических настроек в Lexer. |
| calltip.lexer.word.characters calltip.*.word.characters |
To determine the identifier to look up for calltips, a search is performed allowing the characters in this set to be included in the identifier. While the same setting can be used as for word.characters, sometimes additional characters may be allowed. For example, in Python, '.' is not normally considered part of a word when selecting text, but it is good to allow "string.replace" to show a calltip so calltip.python.word.characters=._$(chars.alpha) would be a reasonable setting. The * form is used if there is no lexer specific setting. |
|
calltip.lexer.parameters.start calltip.lexer.parameters.end calltip.lexer.parameters.separators calltip.*.parameters.start calltip.*.parameters.end calltip.*.parameters.separators |
Данные параметры позволяют указывать символы которые начинают, заканчивают и разделяют параметры. Для большинства языков это левая скобка для начала, правая для конца и запятая или точка с запятой для разделения параметров. Например в CSS двоеточие в начале, пробел для разделения и ничего в конце. Можно указать больше параметров для каждого опции. Параметры с "*" используются для всех лексеров. |
| calltip.lexer.end.definition calltip.*.end.definition |
API файлы могут содержать описание параметров после каждого
определения функции. Для отображения параметров во второй строке,
настройте это свойство на символ используемый в конце определения
функции. Для большинства языков, это ")". Свойство "calltip.*.end.definition" используется для файлов без специфических настроек в Lexer. |
|
calltip.lexer.automatic calltip.*.automatic |
Yстановка этого параметра в 0 означает что не будет происходить автоматическое отображение окошка с calltip'ом при наборе текста, но останется возможность вызвать его вручную. (Только в SciTE-Ru) |
| calltip.lexer.show.per.page calltip.*.show.per.page |
Возможность указать количество определений, отображаемых одновременно в calltip'е. Значение по умолчанию - 1. (Только в SciTE-Ru) |
| calltip.lexer.word.wrap calltip.*.word.wrap |
Опция включает возможность переноса по словам длинных calltip'ов, её значение определяет максимальный размер строки calltip'а в символах, 0 означает что данная функция будет отключена. (Только в SciTE-Ru) |
| xml.auto.close.tags | Устанавливая это свойство как "1", для HTML и XML при наборе ">" набираемый тег будет автоматически закрыт. Например набирая "<td>" тег будет автоматически закрыт "<td></td>" и картека встанет между тегами. |
| html.tags.case.sensitive | При установке данного свойства как "1", у HTML и XML теги становятся регистрочувствительными. |
| asp.default.language | По умолчанию в файлах ASP подсветка установленна как в JavaScript. Для изменения подсветки на VBScript установите asp.default.language в 2, на Python в 3. |
| lexer.cpp.allow.dollars | Если параметр равен 0, то символ "$" запрещается в идентификаторах в лексере С++. |
| sql.backslash.escapes | Активирует бэкслеш и эскейп символы в SQL. |
| styling.within.preprocessor | Данный параметр определяет как применять стиль препроцессора, для всего препроцессорного кода (0 по умолчанию) или только для команд начинающихся на # и до конца командного слова (1). |
| tab.timmy.whinge.level | For Python code, checks whether indenting is consistent. The
default, 0 turns off indentation checking, 1 checks whether each
line is potentially inconsistent with the previous line, 2 checks
whether any space characters occur before a tab character in the
indentation, 3 checks whether any spaces are in the indentation, and
4 checks for any tab characters in the indentation. 1 is a good level to use. |
| user.shortcuts |
Привязывает клавиатурные сочетания к командам. Значения разделяются
"|". Команда указывается или по имени или числовым идентификатором.
Числовые идентификаторы более 2000 являются командами Scintilla и действуют
на активную панель. Именованые и числовые идентификаторы меньше 2000 являются
командами меню SciTE. Описание команд находиться в
Команды SciTE и Scintilla.
Модификаторы - Ctrl, Shift и Alt, именованые клавиши - Left, Right, Up, Down, Insert, End, Home, Enter, Space, Tab, KeypadPlus, KeypadMinus, KeypadMultiply, KeypadDivide, Escape, Delete, PageUp, PageDown, Slash, Question, Equal, Win.
user.shortcuts=\ Ctrl+Shift+I|IDM_OPEN|\ Ctrl+Shift+Left|IDM_CLOSE| |
| user.context.menu |
Объявлет дополнительные команды
для контекстного меню. Это список элементов меню и команд, разделяемый "|",
такой же как в user.shortcuts. Пустой элемент создает разделитель.
user.context.menu=\
||\ Next File|IDM_NEXTFILE|\ Prev File|IDM_PREVFILE| |
| magnification output.magnification |
Устанавливает начальный показатель увеличение шрифта окон
выходной и редактирования. Это полезно когда вы хотите изменить
зазмер текста глобально, как например после изменения разрешения
экрана без необходимости делать это вручную. По умолчанию стоит "0" т.е. размер не меняется, отрицательные величины уменьшают размер, положительные увеличивают. |
| split.vertical output.horizontal.size output.vertical.size |
Если свойство установленно как "1", то панель вывода
будет размещена справа от панели редактирования. Если будет
установлена как "0", то панель вывода будет находиться ниже
окна редактирования. Свойства output.*.size определяют начальные размеры панели вывода. |
| clear.before.execute | Если свойство установленно как "1", то панель вывода очищается перед запуском любой команды. |
| horizontal.scrollbar horizontal.scroll.width output.horizontal.scrollbar output.horizontal.scroll.width output.scroll end.at.last.line |
Если "horizontal.scrollbar" установлен как "0" то
в окне редактирования горизонтальная прокрутка показана не
будет. "horizontal.scroll.width" - ширина горизонтальной области прокрутки. Аналогично настраиваются элементы горизонтальной прокрутки выходной панели ("output.horizontal.scrollbar" и "output.horizontal.scroll.width"). Для отключения автоматической прокрутки выходного окна, установите свойство "output.scroll" как "0". Для включения автоматичкой прокрутки выходного окна и возврата назад к команде выполнения, установите свойство как "1". Если вы хотите чтобы прокрутка в выходном окне перемещалось и оставалось внизу после выполнения, установите "output.scroll" как "2". Вертикальный скролинг Установите "end.last.line" как "0" чтобы позволить прокручивать окно редактора на одну страницу ниже текста. Вертикальная прокрутка установлена по количеству строк в файле. The vertical scroll range is normally set so that maximum scroll position has the last line at the bottom of the view. |
| wrap output.wrap |
Если свойство wrap включено "1", тогда текст будет
автоматически переносится по границе экрана. Если свойство wrap
включено "1", тогда текст в панели вывода будет автоматически
переносится по границе экрана. Оба свойства замедляют редактора пропорционально количеству текста, поэтому они должны быть отключены на относительно медленных машинах. |
| wrap.visual.flags | Управляет отображением маркеров для обозначения конца и начала переноса строк. При 0 - маркеры не отображаются (по умолчанию), 1 - отображаются маркеры отмечающие конец перенесенных строк, 2 - отображаются маркеры отмечающие начало перенесенных строк и 3 - отображаются маркеры отмечающие конец и начало. |
| wrap.visual.flags.location | Управляет положением маркеров отмечающих перенос строки (если включены) рядом с текстом или рядом с границей. При 0 - маркеры начала и конца переноса отображаются рядом с границей (по умолчанию), 1 - маркеры конца рядом с текстом, 2 - маркеры начала рядом с текстом и 3 - оба маркера рядом с текстом. |
| wrap.visual.startindent | Управляет отступом перенесенных строк для лучшей их видимости. По умолчанию 0 - без отступа. Но если wrap.visual.flags равен 2 или 3 (отображение маркера начала переноса) стока будет иметь отступ как минимум 1, даже если wrap.visual.startindent равен 0. |
| wrap.aware.home.end.keys | Параметр управляет поведением клавиш "Home" и "End" когда включен динамический пернос строк. Когда 0 (по умолчанию) - при нажатии этих клавиш каретка передвинется на самое(ый) начало/конец "логической" строки, имеет та перенос или нет. Когда параметр равен 1 - каретка передвигается на конец "отображаемой" строки если нажали "End" и на самый конец "логической" строки если нажать "End" еще раз. Также при нажатии "Home" первый раз каретка переходит на начало "отображаемой" строки, затем на начало "логической" строки. На панели где динамический пернос строк не активен, данный параметр не имеет значения. |
| cache.layout output.cache.layout |
Значительную часть времени редактор тратит на "выкладывание" текста перед его отрисовкой. Эта информация в основном не меняется между перерисовками экрана, поэтому ее можно скэшировать данным параметром. Есть 4 уровня кэша: 0 - кэширование отключено, 1 - кэшируется строка на которой находиться каретка, 2 - кэшируется видимая страница, 3 - кэшируется весь документ. Чем больше кэшируется тем больше памяти используется, при 3 уровне используется в 7 раз больше памяти чем сам документ. Однако, при 3 уровне скорость при динамическом переносе в больших документах возрастает в 25 раз, так что это полезная штука при включенном переносе и большом количестве памяти. |
| open.filter |
Этот параметр используется для указания типов файлов доступных
в диалоге "Открыть файл". Для каждого типа файла надо указать
описание, символ "|", несколько шаблонов, снова символ "|".
В распространяемом фале настроек SciTEGlobal.properties
символ переноса строк "\" используется для разделения значений по одному на строку.
Данные значения отображаются при раскрытии списка "Тип файлов:".
Первое значение принимается по умолчанию, поэтому можно указать
первым тип файлов которые часто используются. В GTK+ данная опция работает только с версии GTK+ 2.4 и выше. |
| max.file.size | Для избежания загрузки экстремально больших файлов на медленных машинах или просто для гарантии того что SciTE используется для правки понимаемого человеком кода, можно задать в данном параметре лимит для загружаемых файлов. Если параметр не задан или равен 0 - проверка не производится. Если задан размер в байтах и файл превышает этот размер, то будет сделан запрос пользователю о загрузке файла. Если пользователь примет, то файл загрузится как обычно, если нет - то файл не загрузится и буфер не создаться. |
| save.deletes.first | Заставялет удалять файлы перед
сохранением. Используется в Windows, для сохранения файлов с тем же имененем,
но имя записано другим регистром, например: myfile.htm -> MyFile.HTM |
| save.recent save.session |
Параметр save.recent
указывает сохранять список недавно использованых файлов при выходе из программы
и загружать при запуске программы. Для GTK+ файл называется ".SciTE.recent" и храниться
в папке заданной переменной SciTE_HOME или, если она не задана, то в папке
заданной переменной HOME или, если и она не задана, в папке верхнего уровня.
Для Windows файл называется "SciTE.recent" и находиться в папке заданной переменной
SciTE_HOME или, если она не задана, в папке заданной переменной
USERPROFILE или, если и она не задана, то в папке с исполняемым файлом SciTE. Если задать "save.session=1" то сессия будет автоматически сохраняться в файл "SciTE.ses" в Windows или ".SciTE.ses" в GTK+ расположенный там же где "SciTE.recent". Когда запустите программу в следующий раз сессия будет автоматически загружена. |
| session.bookmarks session.folds |
Параметр session.bookmarks указывает сохранять список закладок в файл сессии. Если включен параметр session.folds то состояние свертки будет записано в файл сессии. Если параметр fold.on.open включен, то состояние свертки не восстановиться. |
| open.dialog.in.file.directory | Параметр
open.dialog.in.file.directory указывает открывать диалог
"Открыть файл" в папке где находиться текущий редактируемый файл.
Если параметр не включен, то открывается папка указанная системой по умолчанию, в
Windows это последняя папка открытая в диалоге "Открыть файл" в любой копии SciTE.
В этом случае довольно трудно использовать при нескольких запущеных
копиях SciTE. В некоторых версиях GTK+ также может открываться в неожиданных местах. |
| find.replace.matchcase find.replace.regexp find.replace.wrap find.replace.escapes find.replacewith.focus |
Данные параметры
указывают начальное состояние для команд поиска и замены.
Параметр find.replace.matchcase включает опцию "Учитывать регистр",
параметр find.replace.regexp включает "Регулярные выражения",
параметр find.replace.wrap включает "Возвращаться к началу" и
параметр find.replace.escapes включает "Преобразовывать backslash-выражения".
Если параметр find.replacewith.focus включен, то в диалоговом окне "Заменить" фокус встанет на поле "Чем:" если поле "Что:" не пустое. |
| find.replace.regexp.posix | Параметр изменяет поведение поиска с использованием регулярных выражений. Если стоит 0 (по умолчанию) - символы "(" и ")" должны записываться с символом "\" чтобы использоваться как регулярные метасимволы. Если стоит 1 - эти символы являются метасимволами. |
| find.replace.advanced | Параметр find.replace.advanced разрешает команду "Замена в буферах" и включает опцию "Только в этом стиле". Если включен, то поиск ограничен только определенным стилем. |
| find.command find.input |
Команда "Поиск в файлах"
работает похожим образом как команды сборки, выполняемые в командной
строке с перенаправлением вывода в панель вывода. Если команда производит
вывод понимаемый by one of the error output passes, как grep, тогда можно
использовать клавиши F4 и Shift+F4 для перемещения между найдеными совпадениями.
Переменые $(find.what), $(find.files) и $(find.directory)
могут использоваться в диалоговом окне "Поиск в файлах". Есть несколько скриптов в Perl которые работают лучше чем grep, здесь и здесь. Этот пример работает с Cygwin в Windows, с указанием папки с установленым Cygwin:
find.command=cmd /c c:\cygwin\bin\find "$(find.directory)"
-name "$(find.files)" -print0 |
c:\cygwin\bin\xargs -0 fgrep -G -n "$(find.what)"
В Windows, строка поиска может быть задана команде поиска
через стандартный входной поток для избежания проблем с интерпретацией кавычек.
Для этого укажите find.input быть строкой поиска, $(find.what).
Если команда find.command не задана, SciTE использует собственный код для поиска, он не поддерживает регулярные выражения и выполняется быстрее чем внешние утилиты. |
| find.files | Здесь указывается набор файлов
по умолчанию используемый командой "Поиск в файлах". Параметр find.files
список наборов файлов разделенных "|", например "*.cxx *.h|*.py *.pyw|*.html"
где определено 3 значения в истории и первое будет значением по умолчанию. Обработка данного параметра немного необычна, так как каждое значение из файлов настроек добавляется в конец списка, если ранее не было добавлено. Это значит что при открытии файлов из разных папок будут будут добавляться значения параметра find.files из локальных файлов настройки. |
| find.in.dot | Если параметр find.in.dot равен 1, тогда "Поиск в файлах" ищет в папках начинающихся на ".". По умолчанию SciTE не производит поиск совпадений в немодифицированных версиях файлов, хранимых Subversion в папках .svn. |
| find.in.binary | Если параметр find.in.binary равен 1, тогда "Поиск в файлах" отображает совпадения в двоичных файлах. Двоичным SciTE считает файл содержащий байт NUL в первых 64 Kb. |
| find.in.files.close.on.find | Если параметр find.in.files.close.on.find равен 0, тогда диалоговое окно "Поиск в файлах" не закроется после нажатия кнопки "Найти". |
| code.page output.code.page |
Для поддержки языков с двухбайтными
кодовыми страницами, такими как японский, кодовая страница должна быть указана здесь.
Это для того чтобы двухбайтные символы считались единым целым и каретка не никогда не
встала между двумя байтами в двухбайтном символе. В Windows, 0 (набор однобайтных символов)
и 65001 (UTF-8) всегда будут работать и остальные параметры будут работать в зависимости от настроек
Windows, включая 932 (Japanese Shift-JIS), 936 (Simplified Chinese GBK), 949 (Korean), 950 (Traditional Chinese
Big5) и 1361(Korean Johab). В GTK+ данный параметр может принимать значения 0 или 65001, где SciTE поддерживает только однобайтные символы и Unicode. При установке code.page равным 65001 включается режим Unicode и документ распознается как набор символов UTF-8. Корректные глифы будут отображаться если выбранный шрифт содержит все необходимые глифы. Для Windows рекомендуется шрифт Tahoma. Этот параметр не может указывать на однобайтный набор символов. Для GTK+ локаль должна быть установлена в локаль Unicode, установкой свойства LC_CTYPE. Для русской машины это может быть LC_CTYPE=ru_RU.UTF-8
{так ли это??? - переводчик} Шрифты с регистром "iso10646" должны использоваться
в наборе шрифтов. Наборы шрифтов это разделенный "|" список частичных спецификаций
шрифта, где каждая спецификация должна быть в виде foundry-fontface-charsetregistry-encoding *OR*
fontface-charsetregistry-encoding *OR* foundry-fontface *OR* fontface.
Например: "misc-fixed-iso10646-1|*".Параметр output.code.page используется если настройки панели вывода отличаются от панели редактора. |
| character.set | Данный параметр позволяет изменять набор символов, который запрашивается при настройке шрифтов. Для использования кирилицы установите character.set равным 204. Другие значения могут включать Chinese (GB2312=134 or BIG5=136), Korean (129), Greek (161), Eastern European (238), Baltic (186), Turkish (162), Hebrew (177), Arabic (178), Thai (222) или Japanese (128). Все эти значения могут работать в Windows, но в GTK+ Baltic, Turkish, Thai и Vietnamese возможно не будут работать. Пожалуста сообщите электронной почтой если используете данные языки и они работают или нет, или у вас есть информация как обеспечить поддержку других языков. |
| comment.block.lexer comment.block.at.line.start.lexer comment.stream.start.lexer comment.stream.end.lexer comment.box.start.lexer comment.box.middle.lexer comment.box.end.lexer |
Данные параметры используются для
комментирования текста через меню "Правка" и объявляются раздельно для
каждого лексера. Не все языки поддерживают и потоковые и блочные комментарии. Блочный комментарий - начинается с определенной строки и продолжается до конца строки. Параметр comment.block указывает строку, которая вставляется или удаляется в начале комментируемой строки когда выполняются команды "Закомментировать или раскомментировать текст". Чтобы эта команда разумно обрабатывала несколько строк текста, который уже содержит комментарии и код, необходимо добавить в значение параметра символ который обычно не используется в реальных комментариях, такой как "~". Для того чтобы символы блочного комментария вставлялись в начало строки, установите параметр comment.block.at.line.start равным 1, иначе символы будут вставляться перед первым непустым символом. Потоковый комментарий начинается с определенной строки и заканчивается определенной строкой, и может выходить за конец строки. Символы начала и конца потокового комментария определяются в comment.stream.start и comment.stream.end. Линейный комментарий - это форма потокового комментария, который использует различные строки для начала комментария, конца и промежуточных строк. Это объявляется в параметрах comment.box.start, comment.box.middle и comment.stream.end. |
| preprocessor.symbol.filepattern preprocessor.start.filepattern preprocessor.middle.filepattern preprocessor.end.filepattern |
Данные параметры влияют на обработку команд условного перехода и выбора препроцессора. Символ который определяет строку препроцессора указывается в preprocessor.symbol. Ключевые слова препроцессора которые задают начало (if), середину (else) и конец (end) команд состояния препроцессора задаются в других трех параметрах. Может быть несколько значений для каждого из них, например в C используются "if", "ifdef" и "ifndef" для начала команды состояния препроцессора. |
| lexer.filepattern | Лексер разбирает файл на синтаксические части. SciTE затем отображает эти части в различных визуальных стилях. В SciTE доступно несколько лексеров для популярных языков программирования, таких как Python, Java, C/C++, JavaScript и VB. Часто несколько типов файлов относятся к одному языку .cpp, .cc, .h для C++) и следовательно к одному лексеру. Эти параметры ассоциируют имя файла с лексером. |
| shbang.command | В Unix командные файлы часто не имеют расширения и вместо этого указывают интерпретатор в начальной строке, начинающейся с "#!". Если другим путем не определить лексер и файл начинается с "#!", то начальная строка разбивается на слова и к словам добавляется "shbang.". Если такой параметр существует, то его значение рассматривается как тип файла. Например, при параметре:shbang.python=py если первая строка в файле #!/usr/bin/env python, то этот файл будет распознан как Python. |
| lexerpath.filepattern | Свойство определяет путь ко внешнему Lexer модулю загружаемому в Scintilla. |
| keywords.filepattern keywords2.filepattern keywords3.filepattern keywords4.filepattern keywords5.filepattern keywords6.filepattern keywords7.filepattern keywords8.filepattern keywords9.filepattern keywordclass.lexer |
Большинство лексеров различают имена и ключевые слова и
для этого используются переменные keywords. Для избежания повторения списка
ключевых слов для каждого типа файлов, где несколько типов файлов используется
для одного языка, в распространяемых файлах свойств объявлена переменная keywordclass,
однако это просто соглашение. Некотроые лексеры определяют второй набор ключевых слов, который отображается в
отличном стиле от первого набора. Это используется в лексере HTML для отображения
ключевых слов JavaScript в стиле отличном от стиля тегов и аттрибутов HTML. Ключевые слова могут задаваться префиксом, так например ^GTK_ будет считать ключевыми словами все что начинается с "GTK_". |
| default.file.ext | Указывает какой язык используется по умолчанию до того как файл получит имя. Например: если default.file.ext=.py , то команда "New" создаст новый документ со стилем языка Python. |
| word.characters.filepattern | Указывает какие символы являются частью слов. По умолчанию это все цифро-буквенные символы и символ подчеркивания "_", что приемлемо для языков таких как C++. |
| whitespace.characters.filepattern | Указывает какие символы являются разделителями слов. По умолчанию изначально это задано Scintilla, и содержит пробел и все символы менее 0x20. Значения в данном параметре заставляют Scintilla использовать другие символы как разделители слов (например пунктуацию) для действий таких как управление кареткой (ctrl+влево/вправо). |
| style.*.stylenumber style.lexer.stylenumber |
Лексеры указывают номер
стиля используемый для каждого лексического типа: ключевого слова, комментария,
цифры и т.д. Эти параметры определяют визуальный стиль для каждого номера стиля
для каждого лексера. Значение каждого параметра есть набор полей, разделенных ",", некоторые поля имеют подзначение, указанное после ":". Это поля: font, size, fore, back, italics, notitalics, bold, notbold, eolfilled, noteolfilled, underlined, notunderlined и case. Поле font имеет подзначение, которое есть имя шрифта, поля fore и back имеют подзначение задающее цвет, поле size имеет подзначение размера в цифровом виде, поле case имеет одно из подзначений "m", "u" или "l" для смешанного, верхнего или нижнего регистра, поля bold, italics и eofilled не имеют подзначений. Значение "fore:#FF0000,font:Courier,size:14" представляет текст красного цвета, шрифтом Courier, размером 14 pt. Глобальный стиль может быть определен параметром style.*.stylenumber. Любые пареметры стиля в глобальных настройках наследуются каждым лексером пока не перекроются. В GTK+ 2, сглаженный шрифт Pango может быть выбран указанием перед именем шрифта "!", например: "font:!Sans". |
| style.lexer.32 style.lexer.33 style.lexer.34 style.lexer.35 style.lexer.36 style.lexer.37 |
Так же как стили генерируются
лексером, есть несколько нумерованных стилей. Стиль 32 является стилем по умолчанию и наследуется всеми другими стилями пока не перекроется. Стиль 33 используется для отображения номеров строк. Стили 34 и 35 используются для отображения согласованых и несогласованых скобок. Стиль 36 используется для контрольных символов. Это не полный стиль, так как цвета текста и фона для контрольных символов определяются их лексическим состоянием. Стиль 37 используется для отображения направляющих отступа. Используются только цвета текста и фона. Символ "*" может использоваться для указания глобальных настроек стиля. |
| use.monospaced | {Из оригинальной документации параметр удален - При установке параметра равным "1", используется моноширинный шрифт.} |
| braces.check braces.sloppy style.lexer.34 style.lexer.35 braces.lexer.style |
Подсветка скобок используется отображения скобок когда каретка стоит сразу после их. Это полесное свойство при использовании текста со множеством вложеных скобок. Символы "(", ")", "[", "]", "{" и "}" являются скобками. Параметр по умолчанию отключен (поскольку замедляет перемещение каретки), включается указнием 1 параметру braces.check. Если параметр braces.sloppy равен 1, то если перед кареткой нет скобки, тогда проверяется символ после каретки. Подсветка осуществляется стилем 34 или 35 если нет соответствующей скобки. Пока это полный стиль, для избежания частичного отображения скобки, то лучше сделать этот стиль отличающимся от стандартного стиля для скобок только цветом текста и цветом фона. Только скобки со стилем установленым параметром braces.lexer.style, (который по умолчанию равен 0) являются кандидатами для подсветки соответствующих скобок. |
| font.monospace | Указывает имя шрифта и размер, который будет использоваться при выполнении команды "Использовать моноширинные шрифты". Синтаксис тот-же как для параметров стиля. |
| command.compile.filepattern command.compile.subsystem.filepattern command.build.filepattern command.build.subsystem.filepattern command.build.directory.filepattern command.go.filepattern command.go.subsystem.filepattern |
Эти параметры указывают
какие команды выполняются при выборе пунктов меню "Компилировать", "Собрать" и "Выполнить".
Опция subsystem указывает для Windows как запускать утилиту:
как командную строку (0), в оконном режиме (1), через ShellExecute (2) или
интерфейс Директора (3). Если исходные файлы в находятся не в той папке куда они должны собираться, необходимо указать в параметре command.build.directory путь к папке для сборки перед выполнением сборки. |
| command.go.needs.filepattern command.go.needs.subsystem.filepattern |
Иногда требуется собрать или
компилировать файлы перед выполнением. В этом случае в параметре
указывается какая команда запускается перед выполнением. Когда файл
скомпилируется, его состояние будет запомнено и при следующих запусках
компиляция и сборка выполнятся не будут. Чтобы создать команду
"Компилировать и выполнить" для .c файлов:
command.go.*.c=$(FileName)
command.go.needs.*.c=g++ $(FileNameExt) -o $(FileName) |
| command.name.number.filepattern command.number.filepattern command.is.filter.number.filepattern command.subsystem.number.filepattern command.save.before.number.filepattern command.input.number.filepattern command.replace.selection.number.filepattern command.quiet.number.filepattern command.mode.number.filepattern command.shortcut.number.filepattern |
Дополнительные команды,
которые можно добавить в меню "Tools". Например для оптимизатора кода
astyle файл настроек должен содержать: command.name.0.*.cc=Indent Первая строка объявляет то что
будет отображаться в меню "Tools" сразу после команды "Выполнить". Вторая
строка это командная строка, такая же как для команд "Компилировать", "Собрать"
и "Выполнить". Необязательный параметр command.is.filter указывает
что команда изменяет файл и его необходимо прочитать после выполнения команды, если
параметр load.on.activate включен.command.0.*.cc=astyle -taO $(FileNameExt) command.is.filter.0.*.cc=1 Опция subsystem указывает для Windows как запускать утилиту: как командную строку (0), в оконном режиме (1), через ShellExecute (2), интерфейс Директора (3), для запуска HTML-справки в Windows (4) и для запуска WinHelp в Windows. При использовании значений 4 и 5, команда состоит из 2 частей разделенных "!", первая часть указывает топик который ищется и вторая часть - имя файла справки. Если параметр command.save.before равен 1 SciTE автоматически сохранит файл перед выполнением. Если равен 2 SciTE сделает запрос на сохранение. В Windows необязательный параметр command.input указывает что будет передаваться команде. Это может быть ссылка на другой параметр: command.input.0.*.cc=$(CurrentSelection) будет передано текущее выделение командному процессу. Параметр command.input поддерживается только для подсистемы 0 (командная строка). В Windows необязательный параметр command.replace.selection может использоваться для указания того что результат переписывает текущее выделение текста или вставляет текст если нет выделения. Данный параметр имеет 3 значения: 0 (по умолчанию) - не изменяет выделенный текст, 1 - изменяет выделенный по зварешению выполнения команды, 2 - изменяет выделеный текст если команда завершилась с кодом 0. Если пользователь отменяет выполнение команды через "Остановить выполнение" выделенный текст не будет переписан в режиме 1. Примечание: команды выполняются асинхронно, поэтому вы не предупреждены от изменения документа или переключения буферов. Однако, помните, что параметр command.replace.selection пошлет изменения в активное окно когда команды выполнится. Параметр command.quiet поддерживается только в Windows. Значение равное 1 показывает что ввод-вывод команды не отображается на панели вывода. Это может быть полезно в комбинации с command.inputcommand.replace.selection Значение параметра command.mode есть список флагов/настроек разделенный запятыми. Каждая настройка режима может иметь аргумент, отделенный ":". Для большинства из них аргументы не обязательны, если встретиться имя настройки без аргумента, это будет считаться как "setting:yes". Если настройка включена в command.mode но также встретиться как отдельный параметр команды, настройка режима будет перекрыта. Также если одна настройка встретиться более одного раза с различными аргументами, только последний правильный аргумент будет иметь приоритет. Поддерживаемые настройки command.mode:
filter - принимает аргументы yes и no
Сейчас все из них, за исключением groupundo, основаны
на индивидуальных параметрах с похожими именами, поэтому они здесь не описаны.
Настройка groupundo работатет с подсистемой 3(lua/director) и указывает
SciTE принимать все изменения сделанные командой как одно действие отмены.
Команда, которая использует groupundo, не должна менять активный буфер.quiet - принимает аргументы yes и no replaceselection - принимает аргументы yes, no и auto savebefore - принимает аргументы yes, no и prompt subsystem - console, windows, shellexec, lua, director, winhelp, htmlhelp groupundo - принимает аргументы yes и no Параметр command.shortcut указывает клавиатурное сочетание для данной команды. По умолчанию, команды от 0 до 9 имеют сочетания от Ctrl+0 до Ctrl+9 соответственно, но это можно изменить. Для команд с номером больше 9 нет сочетаний по умолчанию. Для описания используется синтаксис как у параметра user.shortcuts. Если текст команды начинается с "*" тогда отобразиться диалоговое окно "Параметры" для запроса параметров перед выполнением. Начальная "*" не включается в команду при выполнении. |
| command.help.filepattern command.help.subsystem.filepattern |
Определяет команду которая выполняется при выполнении команды "Справка" или нажатии кнопки F1. В Windows в основном используется подсистема 4, как описано выше. В Linux запуск man'а или браузера - обычный способ отображения справки. Слово на котором стоит каретка копируется в $(CurrentWord) и это можно использовать при вызове справки. Опция subsystem работает также как у других параметров. |
| command.scite.help command.scite.help.subsystem |
Определяет команду для вызова справки SciTE, обычно отображается данный файл. |
| command.print.filepattern command.print.subsystem.filepattern |
Определяет команду выполняемую при печати в GTK+. |
| win95.death.delay | В Windows 95 может быть задержка между завершением процесса и доступом к выводу. В данном параметре указывается количество миллисекунд для ожидания после завершения процесса, для того чтобы вся выходная информация была доступна. По умолчанию равно 500, и может быть необходимость в увеличии для медленных машин. |
| time.commands | Когда команда выполнена выводит время выполнения в секундах. |
| print.magnification | Печать обычно происходит с теми же настройками что и для экрана. Для того чтобы сделать печать меньше или больше установите в параметре print.magnification значение которое добавиться к размеру каждого шрифта. Для получения хорошей минитюаризации текста установите равным -4. |
| print.colour.mode | Некоторые люди предпочитают светлый текст на темном фоне на экране, но темный текст на светлом фоне при печати. Если параметр print.colour.mode равен 1 каждый цвет инвертируется при печати. Если равен 2 - тогда печатается черный текст на белом фоне. Если 3 - делает фон белым, 4 - делает фон по умолчанию белым. |
| print.margins | Указывает поля по умолчанию для печати в Windows в порядке: левое правое верхнее нижнее. Единица зависит от локали или сотые миллиметра или тысячные дюйма. Какие единицы используются можно увидеть в диалоге "Параметры страницы". Данный параметр считывается только при запуске SciTE. |
| print.header.format print.footer.format |
Данные параметры указывают
что будет печататься в верхнем и нижнем колонтитуле. Параметры могут ссылаться на
другие параметры используя синтаксис $(параметр). Есть несколько
дополнительных переменных CurrentPage, FileTime, FileDate, CurrentDate,
и CurrentTime (на начало печати). Обычно используются переменные
FileNameExt и FilePath. Верхний колонтитул может быть такой:
print.header.format=$(FileNameExt) - Напечатан $(CurrentDate),$(CurrentTime) - Страница $(CurrentPage)
|
| print.header.style print.footer.style |
Указывается стиль для колонтитулов, используется тот же синтаксис как для других стилей. Поддерживаются только аттрибуты: fore, back, font, size, bold, italics и underlined. |
| export.keep.ext | В данном параметре указывается как имя файла (например: LineMarker.cxx) трансформируется при экспорте, добавляя соответствующее экспортируемому формату расширение - .html для HTML и .rtf для RTF. Если параметр export.keep.ext равен 0 (по умолчанию) то текущее расширение заменяется (LineMarker.html). Если равен 1 - то добавляется расширение соответствующее экспортируемому формату (LineMarker.cxx.html). Если 2 - тогда последняя "." заменяется на "_" и добавляется расширение соответствующее экспортируемому формату (LineMarker_cxx.html). |
| export.html.wysiwyg export.html.tabs export.html.folding export.html.styleused export.html.title.fullpath |
Когда параметр export.html.wysiwyg
равен 0, то при экспорте в HTML получается файл меньшего размера, но менее
детально описанный, поэтому он может выглядеть подругому при выводе на экран.
Если параметр export.html.tabs равен 1 и параметр export.html.wysiwyg
равен 0, то символы табулятора будут экспортироваться как символы табулятора, иначе как
набор пробелов. Экспортируемый файл может иметь свертку на браузерах хорошо поддерживающих CSS (Mozilla и Internet Explorer), для этого установите параметр export.html.folding равным 1. Будут экспортированы только используемые стили при установке параметра export.html.styleused равным 1. Полный путь к файлу будет вставлен в заголовок если параметр export.html.title.fullpath равен 1, иначе только имя файла. |
| export.rtf.wysiwyg export.rtf.tabs export.rtf.font.face export.rtf.font.size export.rtf.tabsize |
Когда параметр export.rtf.wysiwyg
равен 0, то при экспорте в HTML получается файл меньшего размера, но менее
детально описанный, поэтому он может выглядеть подругому при выводе на экран.
Если параметр export.rtf.tabs равен 1 и параметр export.rtf.wysiwyg
равен 0, то символы табулятора будут экспортироваться как символы табулятора, иначе как
набор пробелов. Параметры export.rtf.font.face и export.rtf.tabs используются для выбора определенного шрифта и размера для экспорта в RTF. Параметр export.rtf.tabsize задает отличный от tabsize размер табулятора. |
| export.pdf.magnification export.pdf.font export.pdf.pagesize export.pdf.margins |
Значение параметра
export.pdf.magnification добавляется к размеру шрифта используемого по умолчанию.
Положительное значение увеличивает размер шрифта в документе PDF и наоборот. Параметр export.pdf.font принимает однословное значение которое указывает шрифт по умолчанию в документе PDF: Courier, Helvetica или Times. Helvetica используется по умолчанию. При использовании Helvetica и Times нельзя переносить строки, при использовании Courier можно. Параметр export.pdf.pagesize используется для задания размера страницы PDF. Единица измерения - точка (1/72 дюйма). Формат Letter (8.5 дюймов x 11 дюймов) будет указан как 612,792. Параметр export.pdf.margins задает ширину полей страницы. По умолчанию равно 72 pt или 1 дюйм. Экспортер в PDF сильно ограничен в возможностях, поскольку PDF является архивным форматом документа. Поддержка всех возможностей раздует SciTE. Адекватный перенос Helvetica или Times не возможен без управления метриками и кернингом шрифтов. Документ PDF создается с использованием WinAnsiEncoding, поэтому перекодировку необходимо сделать до экспорта, если вы хотите использовать расширеный набор символов. |
| export.xml.collapse.spaces export.xml.collapse.lines |
Параметры указывают как пустые строки и набор из нескольких пробелов подряд конвертируются в XML. Чтобы включить, установите равным 1. Символы "TAB" всегда конверитруются в XML в набор пробелов согласно параметра tabsize. |
| fold fold.margin.width fold.symbols fold.on.open |
Параметры для управления сверткой. Свертка включается установкой параметра fold в 1. Параметр fold.symbols указывает какие символы используются для свертки. 0 (по умолчанию) - используется стиль MacOS, стрелка вправо для свернутого текста, стрелка вниз для развернутого, 1 - свернутый текст отмечается "+", развернутый "-", 2 - плоская древовидная структура с круглыми значками и закругленными соединениями, 3 - плоская древовидная структура с квадратными значками. Для автоматической свертки загружаемых файлов установите fold.on.open равным 1. |
| fold.flags | По настоящему недокументировано ;). Битовые флаги которые могут исчезнуть в будущих версиях. 2, 4, 8 и 16 - управляют рисованием линий выше и ниже свертываемых строк в свернутом и развернутом состоянии. Установите параметр равным 64 для отладки свертки, тогда в поле будут отображаться уровни свертки в шестнадцатеричном виде. |
| fold.compact |
Для файлов HTML, XML, Lua, C++ и подобных при включении данного параметра, свертываются и пустые строки после элемента свертки. По умолчанию включено. |
| fold.html | Включает и выключает использование свертки для HTML и XML файлов. Параметр fold также должен быть включен. |
| fold.comment | Данный параметр разрешает использование свертки для многострочных комментариев и явно указаных точек свертки при использовании лексера C++. Точки свертки позволяют добавлять свертку секции заданной //{ в начале секции и //} в конце. |
| fold.at.else | Данный параметр разрешает свертку строки "} else {" в операторе if. |
| fold.preprocessor | Данный параметр разрешает свертку директив препроцессора при использовании лексера C++. Включая определенные в C# директивы свертки #region и #endregion. |
| fold.comment.python fold.quotes.python |
Данный параметр разрешает использовать свертку для строк в кавычках при использовании лексера Python. параметр fold.comment.python из оригинальной документации удален - "для многострочных комментариев" | fold.perl.package fold.perl.pod |
Данные параметры разрешают использовать свертку для пакетов и POD-блоков при использовании лексера Perl. |
| title.full.path | Указывает способ отображения имени файла в заголовке окна. Когда равен 0 (по умолчанию) - показывает имя файла, 1 - показывает полный путь, 2 - показывает в виде "файл в папке". |
| title.show.buffers | Когда равен 1, отображается номер текущего буфера в заголовке окна. |
| tabsize tab.size.filepattern indent.size indent.size.filepattern use.tabs use.tabs.filepattern indent.auto tab.indents backspace.unindents |
Параметр tabsize
определяет размер табулятора в символах пробела в стиле определенном по
умолчанию. Параметр indent.size - определяет размер отступа
при выполнении автоматического отступа и может отличаться от размера табулятора.
Многие указывают размер табулятора равным 8 и размер отступа равным 4. При создании
отступа параметр use.tabs определяет как заполнять отступ: набором пробелов или
смешанным набором табуляторов и пробелов, используя как можно больше табуляторов.
Глобальные параметры tabsize, indent.size, use.tabs могут быть перекрыты для файлов соответствующих определенному шаблону: indent.size.*.pas=3Если indent.auto включен, то tabsize и indent.size принимаются равными согласно содержимого открытого документа. Если tab.indents включен, при нажатии TAB для отступа строки будет применен размер indent.size, а не tabsize. Если включен backspace.unindents, тогда при нажатии Backspace внутри отступа, то отступ будет сдвинут на indent.size. |
| indent.automatic indent.opening indent.closing indent.maintain.filepattern |
Определяют вид автоматического отступа
Автоматический отступ включается когда параметр indent.automatic равен 1.
Для отступа открывающей скобки в начале блочного оператора установите параметр
indent.opening равным 1, также для закрывающей скобки. Например если оба параметра
равны 0, то:
if (c)
если оба равны 1:{ s; }
if (c)
Автоматический отступ может быть изменен простым повторением отступа предыдущей строки
для определенных файлов, если параметр indent.maintain.filepattern равен 1.
Это перекрывает другие специфичные для языка настройки.
{ s; } |
| statement.indent.filepattern statement.lookback.filepattern block.start.filepattern block.end.filepattern |
Данные настройки влияют
на распознавание блочных операторов, таких как begin...end, if..else,
while...wend. Параметр начинается с номера стиля и затем набора слов или
набора символов. Если в значении параметра более 1 пробела, то это трактуется
как набор слов, иначе это набор символов. Набор ключевых слов используемый для
обозначения начала блочного оператора объявляется в statement.indent.
Например: {Из оригинальной документации удалено упоминание параметра
statement.end.filepattern который аналогично statement.indent
описывает окончание блочного оператора. Например, для C++ точка с запятой является
концом блочного оператора: Количество строк просматриваемых для применения отступа может быть задано в
statement.lookback. Это используется для ограничения времени работы данной задачи
или для указания чтобы проверять только последнюю строку. |
| vc.home.key | Выбирает способ обработки клавиш Home и Shift+Home. При 1 (по умолчанию) переносит каретку как в Visual C++ на конец отступа (начало текста) и если каретка уже там то на начало строки. При 0 переносит каретку на начало строки. |
| warning.findwrapped warning.notfound warning.wrongfile warning.executeok warning.executeko warning.nootherbookmark |
Параметры позволяют воспроизводить звуки и мигать окном при возникновении
определенных событий. Значение параметра состоит из 3 частей разделенных ";"
: продолжительность мигания окна, звук и продолжительность звука. Если звук задан числом,
то это считается высотой звука и проигрывается с заданой продолжительностью в милисекундах.
Иначе, это считается путем к файлу для воспроизведения. Если не хотите
мигания укажите 0 как продолжительность мигания. Например:
warning.wrongfile=0,C:\Windows\Media\SFX\Glass.wav
будет воспроизведен файл при попытке открыть файл с неправильным именем. findwrapped произойдет когда операция поиска дойдет до конца файла, notfound - когда поиск или команды условного перехода препроцессора не дадут результатов, executeok - когда команда такая как "Собрать" выполнится успешно, executeko - когда команда выполниться с ошибкой и nootherbookmark когда нет закладок для поиска. |
| fileselector.width fileselector.height |
В версии для GTK+ определяет начальные размеры окна диалога выбора файлов вызываемого командами Открыть(Open) и Сохранить(Save). В Windows данный параметр не работает. |
| fileselector.show.hidden | В GTK+ если параметр равен 1, то в диалоге выбора файлов, вызываемом командой "Открыть", автоматически отображаются скрытые файлы. |
| translation.missing | При использовании локализованной версии и отсутствии термина в locale.properties используется значение параметра translation.missing. Установив этот параметр как "***" можно легко проверить какие термины не поддерживаются переводом. |
| menu.language | Определяет пункты в меню Подсветка (Language) и расширения
файлов которые они отображают. Каждый пункт меню объявляется 3 элементами: название языка, расширение и возможный клавиатурный эквивалент. Каждый элемент заканчивается '|'. Например: H&ypertext|html|F12| Пункты меню могут быть закомментированы указанием перед именем '#'. |
| menukey.* | Параметр menukey.* позволяет пользователю переопределить клавиши
быстрого доступа для меню без необходимости изменения исходных кодов
SciTE. Синтаксис для параметра такой:
menukey.menu_title.menu_name=<модификатор>клавиша Например, быстрый доступ к File | Exit будет объявлен как: menukey.file.exit=<control>Q Пробелы в заголовках меню и именах должны быть заменены символом подчеркивания и многоточия в конце должны быть удалены. Например, "File | Save As...." будет представлено как "menukey.file.save_as". Может быть определено несколько модификаторов, однако каждый из них должен быть заключен в одиночные скобки. Распознаваемые модификаторы такие же как в параметре user.shortcuts описанном выше. Распознаваемые именованые клавиши тоже такие же как для user.shortcuts с добавлением "none" для указания, что никакие клавиши быстрого доступа не могут быть объявлены для определенных пунктов меню. |
| source.default.extensions | Если имя указанное в командной строке не может быть найдено как
директория или файл - включая поиск по маске, содержимое свойства
трактуется как расширение по умолчанию, чтобы определить имя
файла. Например: .cxx|.cpp|.c|.hxx|.hpp|.h|.bat|.txt|.lua При попытке открыть win32\SciTEWin будет открыт win32\SciTEWin.cxx, так как совпадение будет раньше чем win32\SciTEWin.h Если значение свойства содержит Bar.cxx|.cxx и Вы пытаетесь открыть win32\SciTEWin, то будет открыт ScTEWinBar.cxx, так как это совпадение будет раньше. |
| ext.lua.startup.script ext.lua.auto.reload ext.lua.reset extension.filepattern |
Свойства ext.lua специфичны для SciTE Lua Scripting Extension.
Свойство extension.filepatten является частью общего SciTE Extension
Interface, но в настоящее время используется только в Lua Scripting
Extension. Свойство ext.lua.startup.script указывает на имя файла со скриптом Lua, который будет загружаться вместе со SciTE и настраивать глобальное окружение для Lua. Вы должны использовать абсолютные пути для этого свойства, но можно использовать свойства(переменные) $(SciteDefaultHome) или $(SciteUserHome). Здесь могут быть объявлены обработчики глобальных событий, командные функции, а также другие функции и объекты. Свойство ext.lua.auto.reload определяет, что случиться если Вы сохраните загрузочный скрипт или скрипт для активного расширения из SciTE. Если оно установлено в 0 (по умолчанию), изменения в загрузочном скрипте будут приняты только во время загрузки или когда Вы переключаете буферы (зависит от ext.lua.reset), и изменения в скрипте для расширения будут приняты только когда Вы переключаете буферы. Если ext.lua.auto.reload установлено в 1, SciTE переинициализирует глобальное окружение как только данный скрипт будет сохранен в SciTE. Однако когда свойство ext.lua.auto.reload включено, SciTE не уведомляет если файлы были изменены другой программой. Почему так, смотрите ниже ext.lua.reset. Свойство ext.lua.reset в основном используется для отладки. Если ext.lua.reset установлено в 0 (по умолчанию), свойство ext.lua.startup.script будет проверяться только один раз - при запуске SciTE. Если свойство ext.lua.reset изменить на 1, SciTE будет проверять свойство ext.lua.startup.script и перезагружать загрузочный скрипт каждый раз когда Вы переключаете буферы. Раз так, это имеет отличающийся (больший) набор сторонних эффектов чем ext.lua.auto.reload. В некоторых ситуациях может создаться чувство что оба свойства auto.reload и reset должны быть включены, но обычно достаточно ext.lua.auto.reload. Свойство ext.lua.reset может уйти в будущих версиях SciTE, возможно будет переписано с новой установкой ext.lua.auto.reload=2. Кроме ext.lua.startup.script, свойство extension.filepattern дает возможность для загрузки дополнительных функций и обработчиков событий специфичных для конкретных типов файлов. Если значение свойства extension заканчивается на .lua и ссылается на существующий файл, расширение Lua определяет скрипт так что обработчики событий и команды объявленые в скрипте будут доступны пока этот буфер активен. Функции и объекты объявленные через ext.lua.startup.script также доступны, но могут быть перекрыты. Свойство extension может также определять поведение специфичное для данной директории. Если имя файла (не путь) указано в свойстве extension, Scite ищет файл в путях(path) (см. Настройки windows) начиная с текущей папки. Это может быть очень полезно в комбинации с локальным файлом SciTE.properties. |
| caret.sticky | Controls when the last position of the caret on the line is modified. When set to 1, the position is not modified when you type a character, a tab, paste the clipboard content or press backspace. The default is 0 which turns off this feature. |
| properties.directory.enable | Разрешает или запрещает использование файлов настроек папки. По умолчанию 0 - запрещено, любое другое значение разрешает использование этих файлов настройки. |
caret.policy.{x|y}<param> взаимодействие:
| slop | strict | jumps | even | Каретка может достигнуть границы | Когда достигает предела (собирается выйти за пределы видимости или собирается войти в НЗ), то экран... |
|---|---|---|---|---|---|
| 0 | 0 | 0 | 0 | Да | двигается, помещая каретку вверху/справа |
| 0 | 0 | 0 | 1 | Да | двигается на 1 позицию |
| 0 | 0 | 1 | 0 | Да | двигается, помещая каретку вверху/справа |
| 0 | 0 | 1 | 1 | Да | помещает каретку в центр |
| 0 | 1 | - | 0 | Каретка всегда вверху/справа экрана | - |
| 0 | 1 | - | 1 | Нет, каретка всегда в центре | - |
| 1 | 0 | 0 | 0 | Да | двигается, помещая каретку вне несимметричной НЗ |
| 1 | 0 | 0 | 1 | Да | двигается, помещая каретку вне НЗ |
| 1 | 0 | 1 | 0 | Да | двигается, помещая каретку на 3НЗ от верхней/правой границы |
| 1 | 0 | 1 | 1 | Да | двигается, помещая каретку на 3НЗ от границы |
| 1 | 1 | - | 0 | Каретка всегда на НЗ от верхней/правой границы | - |
| 1 | 1 | 0 | 1 | Нет, избегает НЗ | двигается на 1 позицию |
| 1 | 1 | 1 | 0 | Нет, избегает НЗ | двигается, помещая каретку на 3НЗ от границы |
Для языков очень похожих уже поддерживаемые, которые отличаються только незначительно, например применяемыми ключевыми словами, могут быть использованны уже существующие описания lexer. Установление ключевых слов может изменить настройку для использования нового языка. Настройки Java и JavaScript могут использовать настройки lexer от С++. Настройки Java были добавленны только для поддержки комментариев (doc comments).
Для языков которых нельзя применить существующие настройки, новые настройки конкретного языка могут быть написаны на C++. Это так-же может быть встроенно в "Scintilla", или положено во внешний модуль и быть загружено при старте SciTE(см. lexerpath)
Установка lexer в SciTEФайл "open.filter" должен быть исзменен для включения файла расширения нового языка и данные добавлены в файл command.compile, command.build, command.go and command.go.needs для нового языка.
*.api файлы могут быть созданны вручную или с использованием программ.
Для C/C++ заголовков, файлы API могут быть сделаны с использованием ctags и потом tags2api Python script (обрабатывает C/C++ исходные тексты) в файле тегов для выполения захвата портатипов функций располоденных в нескольких строках. Некоторые заголовки могут иметь в списке параметров "__P" макрос и комментарии Утилиита "cleanapi" может быть использована для таких файлов.
Для создания API файлов для Python модулей gen_python скрипт.
Для создания API файлов для Java классов ApiBuilder.java.
SciTE может быть переведен на другие языки.
Для компиляции SciTE см. файл README в папке scite исходных кодов.
Существует 2 пути расширения SciTE:
SciTE Extension Interface для расширения SciTE кодом скомипилированным в SciTE (SciTE Lua Scripting Extension позволяющее использовать сценарии LUA внутри SciTE, использует именно его) и
SciTE Director Interface для управления SciTE в Windows из других программ.