Макросы для создания и модификации текстовых файлов в формате Pre-HTML, HTML и Си-подобных языков.

Макросы Multi Edit

Содержание:
I. Назначение макросов
II. Преимущества и новизна данных макросов
III. Лицензионное соглашение
IV. Описание макросов
V. Документация для макросов
VI. Установка макросов
VII. Синтаксис макросов
VIII. Возможные проблемы при работе с макросами
IX. Download

Скачать макросы для Multi Edit 7.0 (MS-DOS);
Скачать макросы для Multi Edit 8.0 (Win32);
Скачать макросы для Multi Edit 2008 (Win32);

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

I. Назначение макросов
Данные макросы предназначены для преобразования текстовых файлов и файлов текстового редактора ЛЕКСИКОН 1.4 для ДОС в форматы 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) и является бесплатными для некоммерческого использования.

* Просмотреть текст лицензии GNU GPL v.2 (оригинал на англ. языке);
* Неофициальные перевод лицензии (на русском языке).

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, но в качестве ссылок формируют расширения .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».
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 – программами 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. Конфликт версий;
Автор отмечает, что он создавал и тестировал свои макросы только для версий 7.0 и 8.0 редактора: Multi Edit. Поэтому эти макросы могут некорректно работать в редакторах Multi Edit других версий. Для получения нужных версий этого редактора пишите <a>автору проекта: mailto: yudenisov{at}aport2000.ru</a>.

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

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

IX. Download

Скачать макросы для Multi Edit 7.0 (MS-DOS);
Скачать макросы для Multi Edit 8.0 (Win32);
Скачать макросы для Multi Edit 2008 (Win32);

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

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

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

По всем вопросам, связанным с установкой редактора и макросов, алгоритмами функционирования макросов (в том числе и логическими ошибками в алгоритмах), пожелания по поводу улучшений пишите автору в гостевую книгу или на адрес электронной почты: mailto: Юрий <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 и к его скриптовому языку;