English

.Net-плагины

Программа предназначена для помощи в редактировании текстов программ в текстовом редакторе файлового менеджера ФАР. В процессе редактирования программа в соответствии с обстоятельствами помогает формировать правильные синтаксические языковые конструкции (в духе незабвенного редактора Multi Edit) и выражения с использованием функций, методов и свойств (как в IDE MS VBA, MS VS.NET, Delphi и др.).

Программа работает под управлением плагина Far Script Host  и состоит из основного скрипта S&S.vbs и вспомогательных программных и настроечных файлов. Имеет русский  и английский интерфейс, язык интерфейса можно переключать установкой соответствующего параметра в файле конфигурации программы.

Версия программы для работы под плагином SHPCE поддерживается и распространяется Максимом Белугиным  belugin@mail.ru

Установка:

Загрузите архив S_S.zip, распакуйте содержащиеся в нём файлы в каталог скриптов плагина Far Script Host (напр., %Far%/Plugins\ScrHost\Scripts\S_S\).

Eсли в Вашей системе установлена версия 4.0 MSXML (xml-парсер), запустите "на исполнение" файл SSxml_4.reg. Иначе запустите SSxml_3.reg

Использование:

Программа функционирует в фоновом режиме и обрабатывает нажатия клавиш. При этом обрабатываются следующие "команды":

  • . (точка) - выдача списка свойств или методов для объекта
  • ( (левая скобка) - выдача списка параметров функции или метода
  • ?? - вывод списка всех "специальных" ключевых слов
  • s? - вывод списка всех синтаксических заготовок для текущего языка в редактируемом файле;
  • f? - вывод списка всех функций для текущего языка в редактируемом файле;
  • o? - вывод списка объектов, которые могут быть использованы в текущем контексте (языковые и библиотечные)
  • i? - переключение режима непосредственного исполнения команд
  • h? - вывод всех загруженных описаний языков/библиотек в окне IE
  • w? - переход на Веб-страницу программы
  • r? - повторная загрузка настроек плагина (из xml-файлов)
  • a? - проговорить выделенный текст
  • l? - проговорить текст в буфере обмена

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

Примечание: Вставка управляющих конструкций (шаблонов) производится либо по команде s?, либо после ввода ключа (см.ниже) и вызова программы через меню плагинов.

Настройка:

Оперативная настройка производится установкой параметров файла SSxDsc.xml:
  • ParamsIntoText="0"  - вставка параметров функций в редактируемый текст
  • ParamsIntoClipboard="1" - вставка параметров функций в буфер обмена
  • ParamsIntoTitle="0" - вставка параметров функций в заголовок окна редактора
  • ProcessImmediate="1" - исполнять команды сразу после ввода (иначе, если "0", - после вызова скрипта через меню плагинов). См.также команду i?.
  • IFaceLang = "rus" - установить русский интерфейс
(Значения "1" - логическое TRUE, "0" - FALSE.)
  • SpecCommands - список команд и ключей
"Синтаксические" настройки на языки и библиотеки хранятся в файлах SSx*.xml, для подключения которых имя файла необходимо указать в списке в теге <LoadFiles> файла SSxDsc.xml. Тег <language> может иметь атрибуты tabsize="хх" и expandtabs="1/0", соответствующие параметрам настройки редактора ФАРа "Размер табуляции" и "Пробелы вместо табуляции". Настройки редактора изменяются в соответствии с этими атрибутами при редактировании файлов. В дистрибутиве имеются файлы настроек для языков VBScript, JavaScript, для библиотек FarSH, WSH, MSXML и некоторые др.

Описания функций, объектов, методов, событий и свойств очевидны. При описании шаблонов управляющих конструкций можно использовать метакоманды:

  • [-cr] - перевод строки
  • [-cri] - то же, плюс smart indent
  • [-tab] - табуляция
  • [-val0..9] - ответы на соотв. подсказки (prompt0...9)
  • [-block] - вставить выделенный фрагмент текста
  • [-blockcp] - вырезать выделенный текст, на его место вставить конструкцию, вернуть текст обратно(работает только с потоковыми блоками, иначе действует как [-block])
  • [-cur] - положение курсора после вставки конструкции
  • [-cur2] - то же с рекурсивным вызовом скрипта s&s.vbs
  • [-guid] - вставить случайное значение guid
  • [-filename] - вставить имя редактируемого файла

Само описание шаблона оформляется в виде тега <statement>, атрибут name тега рассматривается как ключевое слово или команда. Текст шаблона желательно заключать в "скобки" <![CDATA[ ... ]]>

Системные требования:

MS Windows 2000/9x с установленными компонентами

Возможности по модификации программы:

Программа поставляется в виде исходного кода. При написании программы использованы языки VBScript, DHTML, CSS, XML, XSL. Для модификации программы требуется лишь простейший текстовый редактор, компилятор не нужен.

Назначение файлов программы:

  • S&S.vbs  - основной файл программы
  • SSxDsc.xml - конфигурационный файл
  • SSxIFace.xml - настройка интерфейса программы.
  • SSx*.xml - файлы описаний языков, библиотек и шаблонов:
    • SSxVBS.xml - описания для языка VBScript
    • SSxJS.xml - описания для языка JS
    • SSxCS.xml - описания для языка CSharp(C#)
    • SSxPerl.xml - описания для языка Perl
    • SSxHTM.xml - описания объектов IIS
    • SSxXML.xml - описания объектов MS XML
    • SSxFarSH.xml - описания объектов FarScriptingHost
  • SSxDsc.xsd, SSxDsc.xdr - схемы для файлов SSx*.xml
  • List*.xsl - программы для генерации списков объектов.
  • MakeHelp.xsl - программа для генерации файла помощи.

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

% Загрузка архива с программой site-1 site-2.