Назад… К содержанию… Далее…
Макросы Multi Edit
Содержание:
Данные макросы предназначены для преобразования текстовых файлов и файлов текстового редактора ЛЕКСИКОН 1.4 для MS-DOS в форматы Pre-HTML и HTML-формат посредством внутренних команд редактора Multi-Edit версий 7.0, 8.0 и 2008.
Формат Pre-HTML имеет следующие особенности:
- все абзацы представлены одной строкой, максимальная длина которой – 2044 символов;
- все специальный символы: амперсант, двойные кавычки, знаки «больше» и «меньше» заменены соответствующими знаками HTML-разметки;
- в тексте присутствует разметка начертания текста: «bold», «italic», «underline» в HTML-формате;
Кроме того, эти макросы способны заменять:
- двойные дефисы – на знак «тире»;
- обычные двойные кавычки – на знаки «кавычки» (ёлочки, лапки) для русского текста;
- три точки — на многоточие;
- убирать лишние пробелы в тексте;
- убирать «пустые строки» в тексте;
- Данные макросы предоставляют возможность просто, без многократного обращения к командам текстового редактора Multi-Edit производить поиск и «контекстную» замену повторяющихся участков текста, набором имени только одного макроса.
- Кроме того, эти макросы могут переноситься на другие текстовые редакторы: Ultra Edit, Notepad++, а также системы программирования C/C++, VBA и Perl.
- Все макросы имеют простой алгоритм, который реализуется во всех версиях Multi-Edit, и может переноситься на разные платформы.
Данные макросы распространяются по публичной лицензии GPL v.2 (open source) и является бесплатными для некоммерческого использования.
Используемые макросы разбиты по нескольким категориям:
- Директория 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 – вставляет восемь символов пробела в начало каждой строки.
- Директория 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, но в качестве ссылок формируют расширения .shtml (вместо .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».
- Директория SRCTHIRD. В данной директории находятся макросы для генерации словарных статей глоссария из текстовых файлов. Здесь находятся следующие макросы:
- Директория SRCFIRTH. В данной директории находятся различные функции для манипуляции с текстовыми файлами, в частности:
- HLT_COMM.S – Вырезает из файла с исходным текстом программы код программы (на языках: Си, Си++, Java и Multi Edit Macro Script), оставляя одни комментарии.
- Директория 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.
Необходимые комментарии и описания алгоритмов, используемых при написании макросов, содержатся в их тексте.
Данные макросы компилируются стандартными средствами редакторов Multi Edit:
- для редактора Multi Edit 7.0 – программой CMAC.EXE
- для редактора Multi Edit 8.0 и 2008 – программами cmacwin.exe, cmacwin.bat и mac4all.bat
Автор гарантирует отсутствие синтаксических ошибок в макросах. Если при компиляции макросов ошибки всё же возникают, проверьте правильность установки и настройки программы Multi Edit. Также можно в этом случае написать автору.
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.
Для использования указанных макросов необходимо:
- скомпилировать макросы Multi Edit (см. предыдущий раздел).
- загрузить файл, к которому необходимо применить макрос, в окно редактора Multi Edit;
- нажать сочетание клавиш Shift+F10;
- в открывшемся окне необходимо набрать имя макроса. Оно совпадает с именем файла с макросом, только не содержит расширения: «.S» («.MAC»);
ВНИМАНИЕ! Соблюдайте логическую последовательность при запуске макросов. Некоторые макросы запускаются только в последовательности, указанной в документации (комментариям) к ним.
- дождитесь окончания выполнения макроса. Изменённые макросом строки «подсвечиваются» в текстовом редакторе;
- нажмите клавишу F2 для записи изменений, сделанных макросом в файле, или Alt+X -> «Don't Save» для отмены изменений и выхода из программы Multi Edit.
- Нарушение логической последовательности при запуске макросов;
См. документацию к макросам;
- Конфликт версий;
Автор отмечает, что он создавал и тестировал свои макросы только для версий 7.0 и 8.0 редактора: Multi Edit. Поэтому эти макросы могут некорректно работать в редакторах Multi Edit других версий. Для получения нужных версий этого редактора пишите автору проекта: yudenisov{at}aport2000.ru.
- Невозможность компиляции, не связанная с конфликтом версий;
На некоторых ЭВМ компиляция макросов из окна редактора невозможна. В этом случае попробуйте воспользоваться командным файлом CMACWIN.BAT, поставляемых вместе с исходными текстами макросов. Там же найдёте и документацию к нему.
- Ограничения доступа к каталогам;
Войдите в компьютер под учётной записью администратора, и только после этого установите макросы.
Автор считает, что разработанные им макросы являются лучшими из всех макросов, выпущенных по лицензии 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!
- beu.txt – файл с описанием правил форматирования работ автора;
- Работа автора: «Интерфейсы» (http://yudenisov.narod.ru/EIS/Vol11/index.htm), посвящённая интерфейсам работы с компьютером;
- Работа автора «Командные файлы», (http://simple-clerk.narod.ru/LEARNING/PROG_WRI/files/bapp06.hjt), посвящённая работе в командной строке операционной системы;
- Финогентов К.Г. MS-DOS 5.0 (Настольная книга пользователя ПК) в 2-х частях. Ч.1. - М.: МП «Малип», 1992. - 64 с.;
- Финогентов К.Г. MS-DOS 5.0 (Настольная книга пользователя ПК) в 2-х частях. Ч.2. - М.: МП «Малип», 1992. - 64 с.;
- Фигурнов В.Э. IBM PC для пользователя. Изд. 7-е. - М.: ИНФРА-М, 1997. 640 с., ил.;
- MS-DOS 6.0. Справочное руководство для пользователей компьютеров IBM PC. - М.: Продукция фирмы «ВА Принт», 1994. - 319 с.;
- Онлайн руководство к текстовому редактору Multi Edit v. 8.0f;
- Онлайн руководство к текстовому редактору Multi Edit v. 7.0 и к его скриптовому языку;
Назад… К содержанию… Далее…