Мой логотип Исходные коды
 

 

 

Назад…   К содержанию…   Далее…

 

Макросы Multi Edit

Содержание:

I. Назначение макросов

Данные макросы предназначены для преобразования текстовых файлов и файлов текстового редактора ЛЕКСИКОН 1.4 для MS-DOS в форматы Pre-HTML и HTML-формат посредством внутренних команд редактора Multi-Edit версий 7.0, 8.0 и 2008.

Формат Pre-HTML имеет следующие особенности:

  • все абзацы представлены одной строкой, максимальная длина которой – 2044 символов;
  • все специальный символы: амперсант, двойные кавычки, знаки «больше» и «меньше» заменены соответствующими знаками HTML-разметки;
  • в тексте присутствует разметка начертания текста: «bold», «italic», «underline» в HTML-формате;

Кроме того, эти макросы способны заменять:

  • двойные дефисы – на знак «тире»;
  • обычные двойные кавычки – на знаки «кавычки» (ёлочки, лапки) для русского текста;
  • три точки — на многоточие;
  • убирать лишние пробелы в тексте;
  • убирать «пустые строки» в тексте;

II. Преимущества и новизна данных макросов

  • Данные макросы предоставляют возможность просто, без многократного обращения к командам текстового редактора Multi-Edit производить поиск и «контекстную» замену повторяющихся участков текста, набором имени только одного макроса.
  • Кроме того, эти макросы могут переноситься на другие текстовые редакторы: Ultra Edit, Notepad++, а также системы программирования C/C++, VBA и Perl.
  • Все макросы имеют простой алгоритм, который реализуется во всех версиях Multi-Edit, и может переноситься на разные платформы.

III. Лицензионное соглашение

Данные макросы распространяются по публичной лицензии GPL v.2 (open source) и является бесплатными для некоммерческого использования.

IV. Описание макросов

Используемые макросы разбиты по нескольким категориям:

  1. Директория SRCMAIN: содержит макросы для преобразования из формата ЛЕКСИКОН в формат Pre-Html. Она содержит следующие макросы:
    • SPEC_C.S – для трансляции специальных символов ('"', '&', '<', '>', '№') в формат Pre-HTML;
    • POST_LEX.S – для вставки символов окончания форматирования лексикона в текст файла Лексикона (вставляются оконечные символы <ALT+255>0 (нормальное начертание) в конец строки или <Alt+255>. (без подчёркивания) в конец строки при изменении начертания или подчёркивания в середине текста);
    • FONTLEX.S – для перевода шрифтового оформления файла типа ЛЕКСИКОН в Pre-HTML-файл;
    • HYPER.S – для перевода гиперссылок формата ЛЕКСИКОН в формат Pre-HTML;
    • SINGLSTR.S – для перевода абзаца текста, разбитого построчно, в единый абзац одной строкой. При этом абзацы разделяются пустыми строками;
    • NONEOL.S – уничтожает пустые строки в файлах;
    • ABZATS.S – вставляет восемь символов пробела в начало каждой строки.
  2. Директория SRCSEC: содержит макросы для преобразования текстов в формате Pre-HTML и текстовом формате в формат HTML. Она содержит следующие основные макросы:
    • SPEC_C01.S – заменяет двойные кавычки (") в русском тексте на открывающиеся и закрывающиеся «русские» кавычки (ёлочки, лапки), двойной дефис – на тире, а повторяющиеся три точки – на многоточие;
    • BRGEN.S – образует «псевдорусское» оформление абзацев (пробельными символами и знаком <BR />). Автором практически не используется.
    • PARGEN.S – разбивает текст в формате Pre-HTML и чисто текстовые файлы (абзац - одной строкой) на абзацы (в начало – знак начала параграфа <P>, в окончание – знак конца параграфа </P>), и вставляя пустую строку между параграфами;
    • P2LI.S – преобразует параграфы-списки (начинающиеся на «* », «- », «1. », «1) » и др. в формат списков HTML.

      • Примечание: знаки начала и конца списков («<UL>…</UL>», «<OL>…</OL>») должны быть проставлены заранее;

    • P2H.S – преобразует абзацы, с которых начинаются названия частей и разделов (начинаются с буквы с точкой, за которой идёт номер), в заголовки нужного уровня;
    • H_CORR.S – центрирует заголовки с первого по третий уровень и добавляет к ним (в зависимости от контекста) полужирное или полужирное курсивное начертание;
    • H_CORR01.S – добавляет якорь к каждому заголовку (имя якоря потом вписывается вручную);
    • H_CORR02.S – дописывает информацию об используемом шрифте для центрированных заголовков;
    • P_CORR.S – осуществляет стилевое оформление абзацев, начинающихся со слов: «Примечание», «Copyleft», «Copyright»;
    • P_CORR1.S – осуществляет стилевой оформление (вставляет атрибут «выравнивание по ширине») для абзацев по-умолчанию.
    • FTNOTE??.S – дописывают панель навигации к уже сформированной веб-странице;
    • FTNOT1??.S – выполняют те же действия, что и макросы FTNOTE??.S, но в качестве ссылок формируют расширения .htm (вместо .htm);
    • HF_WIN??.S, HF_KOI??.S – добавляют стандартный заголовок и окончание веб-страницы;
    • DATAMIN1.S – добавляют стандартные заголовок и окончания веб-страницы, и дополнительно вставляет в текст SSI-инструкции. Функция оптимизирована для проекта «Учебник по датамайнингу»
    • SN00.S – добавляют стандартные заголовок и окончания веб-страницы, и дополнительно вставляет в текст SSI-инструкции. Функция оптимизирована для проекта: «Самые Начала…».
    • AUTH_N00.S – вставляет в HTML-документ информацию об авторе – Ю.А. Денисове (старый вариант).
    • AUTH_00.S – вставляет в HTML-документ информацию об авторе – Ю.А. Денисове (новый вариант). Вставляются теги: «REV=made», «REL=copyright», «REV=publisher», «NAME=author», а также с документом ассоциируется таблица стилей «seria.css»: «REL=StyleSheet HREF=seria.css».
  3. Директория SRCTHIRD. В данной директории находятся макросы для генерации словарных статей глоссария из текстовых файлов. Здесь находятся следующие макросы:
    • MESYS.S – определения макросов «DEL_TO_HOME» (для удаления текста с предыдущей позиции до начала строки) и BSWORD (для удаления слова слева от текущей позиции);
    • GLS2CSV.S, GLS2CSVD.S – преобразует файл формата глоссария в формат «Coma separated values» (величины, разделённые запятыми);
    • CSV2GLS.S – преобразуют файл формата «Coma Separated Values» (величины, разделённые запятыми) в файл формата глоссария;

      • Примечание: работа над этими макросами временно прекращена. Автор не рекомендует их использовать.

  4. Директория SRCFIRTH. В данной директории находятся различные функции для манипуляции с текстовыми файлами, в частности:
    • HLT_COMM.S – Вырезает из файла с исходным текстом программы код программы (на языках: Си, Си++, Java и Multi Edit Macro Script), оставляя одни комментарии.
  5. Директория SRCFIFTH. В данной директории находятся различные функции для манипуляции с текстовыми файлами, в частности:
    • PUTS_GEN.S – для преобразования строк текста в «сырой» файл на языке Си/Си++, осуществляющий вывод самого текста средствами стандартной библиотеки ANSI C (командой fputs);
    • SPEC_CPP.S – для замены специальных знаков: '"' на '\"', '\' на '\\', которая необходима для представления текста на Си подобных языках (в частности, для вывода текста функцией fputs – см. программу выше).
    • SPECCPP0.S – делает почти то же самое, что и предыдущая функция, только осуществляет также замену '№' на 'N'.
    • SPLTXTGN.S – разбивает строку текста на куски размером < 128 символов. Данная последовательность используется для вставки оператора вставки текста внутри макроса Multi-Edit.
    • TXTS_GEN.S – вставляет последовательность: 'TEXT( "' в начало и '" );' в конец каждой строки текста. Эта функция используется вместе с другими функциями (SPLTXTGN, SPEC_CPP) для преобразования текста в «сырой» файл на языке Multi-Edit Macro, осуществляющий вывод самого текста средствами вставки текстовых фрагментов макросом редактора Multi Edit.

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

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

Данные макросы компилируются стандартными средствами редакторов Multi Edit:

  • для редактора Multi Edit 7.0 – программой CMAC.EXE
  • для редактора Multi Edit 8.0 и 2008 – программами cmacwin.exe, cmacwin.bat и mac4all.bat

Автор гарантирует отсутствие синтаксических ошибок в макросах. Если при компиляции макросов ошибки всё же возникают, проверьте правильность установки и настройки программы Multi Edit. Также можно в этом случае написать автору.

VI. Установка макросов:

 a) Компиляция макросов:

Для компиляции макроса из редактора Multi Edit необходимо:

  • Распаковать архив с макросами в любую директорию, например, C:\USERS\PROG;
  • Открыть этот макрос в окне редактора Multi Edit;
  • Нажать клавишу F9 на своём компьютере;
  • Выбрать режим компиляции (лучше всего выбирать режим по умолчанию);
  • Дождаться окончания компиляции макроса;
  • После компиляции последнего макроса перегрузите редактор (не саму операционную систему!) Multi Edit.

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

В случае если компиляция макросов из самого редактора невозможна, используйте файлы: CMACWIN.BAT и MAC4ALL.BAT, – также содержащиеся в архиве с макросами. Документация к ним находится в тексте макросов.

 b) Установка «бинарных файлов» (с расширением .MAC):

Для установки файлов с расширением: .MAC необходимо:

  • Распаковать указанный архив с опциями по-умолчанию;
  • Перейти в командной строке операционной системы в каталог, содержащий файлы с расширением: .mac. Для редактора Multi-Edit 7.0 этот каталог имеет расширение: .ME7, для редактора Multi Edit 8.0 – .ME8, а для редактора Multi Edit 2008 – .ME08;
  • Набрать и выполнить в командной строке операционной системы следующую команду:

    • >copy .\*.mac %ME_PATH%\MAC

    где переменная ME_PATH содержит путь к каталогу с установленными файлами редактора: Multi Edit, – например:

    • C:\PROGRA~1\MULTI-~1 – для программы: Multi Edit 2008;
    • C:\PROGRA~1\MULTIE~1 – для программы: Multi Edit 8.0;
    • C:\ME – для программы Multi Edit 7.0;
  • Перезагрузить Multi Edit.

VII. Синтаксис макросов

Для использования указанных макросов необходимо:

  • скомпилировать макросы Multi Edit (см. предыдущий раздел).
  • загрузить файл, к которому необходимо применить макрос, в окно редактора Multi Edit;
  • нажать сочетание клавиш Shift+F10;
  • в открывшемся окне необходимо набрать имя макроса. Оно совпадает с именем файла с макросом, только не содержит расширения: «.S» («.MAC»);

    • ВНИМАНИЕ! Соблюдайте логическую последовательность при запуске макросов. Некоторые макросы запускаются только в последовательности, указанной в документации (комментариям) к ним.

  • дождитесь окончания выполнения макроса. Изменённые макросом строки «подсвечиваются» в текстовом редакторе;
  • нажмите клавишу F2 для записи изменений, сделанных макросом в файле, или Alt+X -> «Don't Save» для отмены изменений и выхода из программы Multi Edit.

VIII. Возможные проблемы при работе с макросами

  1. Нарушение логической последовательности при запуске макросов;

    2. См. документацию к макросам;

  2. Конфликт версий;

    3. Автор отмечает, что он создавал и тестировал свои макросы только для версий 7.0 и 8.0 редактора: Multi Edit. Поэтому эти макросы могут некорректно работать в редакторах Multi Edit других версий. Для получения нужных версий этого редактора пишите автору проекта: yudenisov{at}aport2000.ru.

  3. Невозможность компиляции, не связанная с конфликтом версий;

    4. На некоторых ЭВМ компиляция макросов из окна редактора невозможна. В этом случае попробуйте воспользоваться командным файлом CMACWIN.BAT, поставляемых вместе с исходными текстами макросов. Там же найдёте и документацию к нему.

  4. Ограничения доступа к каталогам;

    5. Войдите в компьютер под учётной записью администратора, и только после этого установите макросы.

IX. Download

X. Заключение

Автор считает, что разработанные им макросы являются лучшими из всех макросов, выпущенных по лицензии GPL и предназначенных для преобразования форматирования текстов средствам текстовых редакторов, в частности, для преобразования: text/plain -> text/html. При этом автор придерживался собственного стиля оформления страниц, который описан в <a>файле beu.txt</a>. Пользователь, знакомый с программированием, может самостоятельно изменить исходные файлы.

Работа с макросами предполагает умение пользователя работать в командной строке. Этим навыкам он может научиться в работе автора: «Интерфейсы», – опубликованной на http://www.yudenisov.narod.ru/EIS/Vol11/c000.htm, а также в первоисточниках [2-7]

По всем вопросам, связанным с установкой редактора и макросов, алгоритмами функционирования макросов (в том числе и логическими ошибками в алгоритмах), пожелания по поводу улучшений пишите автору в гостевую книгу или на адрес электронной почты: yudenisov{at}aport2000.ru.

Успехов Вам в использование программ! Good Luck! Dankon!

XI. Полезные ссылки и литература

  1. beu.txt – файл с описанием правил форматирования работ автора;
  2. Работа автора: «Интерфейсы» (http://yudenisov.narod.ru/EIS/Vol11/index.htm), посвящённая интерфейсам работы с компьютером;
  3. Работа автора «Командные файлы», (http://simple-clerk.narod.ru/LEARNING/PROG_WRI/files/bapp06.hjt), посвящённая работе в командной строке операционной системы;
  4. Финогентов К.Г. MS-DOS 5.0 (Настольная книга пользователя ПК) в 2-х частях. Ч.1. - М.: МП «Малип», 1992. - 64 с.;
  5. Финогентов К.Г. MS-DOS 5.0 (Настольная книга пользователя ПК) в 2-х частях. Ч.2. - М.: МП «Малип», 1992. - 64 с.;
  6. Фигурнов В.Э. IBM PC для пользователя. Изд. 7-е. - М.: ИНФРА-М, 1997. 640 с., ил.;
  7. MS-DOS 6.0. Справочное руководство для пользователей компьютеров IBM PC. - М.: Продукция фирмы «ВА Принт», 1994. - 319 с.;
  8. Онлайн руководство к текстовому редактору Multi Edit v. 8.0f;
  9. Онлайн руководство к текстовому редактору Multi Edit v. 7.0 и к его скриптовому языку;

 

Назад…   К содержанию…   Далее…

 

Copyright © Юрий А. Денисов
(yudenisov)
2006-2012. Все права защищены

Версия 0.2. Alpha от 19.04.2012

Гостевая книга Обсуждение работ в блоге. Отправить E-mail Автору проекта.

CopyLeft (L) by Юрий А. Денисов
(yudenisov)
Hosted by uCoz