Make your own free website on Tripod.com

English

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

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

Установка:

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

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

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

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

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

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

Настройка:

Оперативная настройка производится установкой параметров файла SSxDsc.xml:
  • ParamsIntoText="0"  - вставка параметров функций в редактируемый текст
  • ParamsIntoClipboard="1" - вставка параметров функций в буфер обмена
  • ParamsIntoTitle="0" - вставка параметров функций в заголовок окна редактора
  • ProcessImmediate="1" - исполнять команды сразу после ввода (иначе, если "0", - после вызова скрипта через меню плагинов)
  • IFaceLang = "rus" - установить русский интерфейс
(Значения "1" - логическое TRUE, "0" - FALSE.)
"Синтаксические" настройки на языки и библиотеки хранятся в файлах SSx*.xml, для подключения которых имя файла  необходимо указать в списке в теге <LoadFiles> файла SSxDsc.xml. В дистрибутиве имеются такие файлы для языков VBScript, JavaScript, для библиотек FarSH, WSH, MSXML и некоторые др. 

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

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

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

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

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

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

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

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

  • S&S.vbs  - основной файл программы
  • SSxDsc.xml - конфигурационный файл
  • SSxIFace.xml - настройка интерфейса программы.
  • SSx*.xml - файлы описаний языков и библиотек
  • SSxDsc.xdr - схема для файлов SSx*.xml
  • MakeHelp.xsl - программа для генерации файла помощи.

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

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