Исходные коды

Макросы для навигации по HTML-страницам и для обратной связи с читателями

Содержание:

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

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

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

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

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

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

VII. Установка макросов

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

IX. Download

X. Возможные проблемы

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

XII. Полезные ссылки и использованная литература

Подробнее о работе в командной строке операционных систем можно прочитать в [3-8].

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

Данные макросы решают следующие задачи:

Реализуют представление кнопки: «Назад» на веб-странице в виде гиперссылки;
Реализуют функцию: «уничтожителя фреймов» на веб-странице;
Позволяют организовать средствами MS-DOS и Norton Utilities «псевдографическое меню» для выбора файла;
Позволяет автоматически выводить дату изменения HTML-файла;
Исправляет «особенности набора» текста в текстовом редакторе (заменяет знаки: «двойной дефис» («--») на «тире» («–»), три точки – на многоточие, кавычки – на «ёлочки» и т.п.), макрос toWord.pl;
Убирает из исходных кодов программ и файлов настройки приложений (таких, как веб-сервер apache) собственно текст, оставляя только комментарии, макросы: c_javadoc.pl и perl_apache_doc.pl;
По исходному файлу-шаблону веб-страницы генерирует макросы multi edit (perlSRCgen.pl) и CGI-Perl (perlCGIgen.pl), позволяющие применять эти шаблоны к «почти готовым» размеченным файлам содержания (content) страницы;
Файл для вставки в текст на место директивы SSI: «include» — содержимое файлов, на которые ссылается данная директива, макрос ssi_exchange.pl;
Различные корректировки html файлов (см. файл memac.txt);
Командные файлы DOS/Windows для запуска сценариев Perl из текущей папки (perlexe.bat) и «пользовательской папки» (perlbat.bat);
и многое другое…;

У автора ежемесячно пишутся различные макросы, с которыми он с удовольствием делится с читателями.

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

Данные макросы были созданы или адаптированы под свои нужды техническим писателем Юрием А. Денисовым за период с 1992 г. по 2012 г. Преимущество этих макросов состоит в том, что с их помощью можно писать полезные программы, не владея «универсальными» языками программирования, такими как Си, C++ и Visual Basic. Адаптировать под свои нужды эти макросы сможет любой пользователь, освоивший школьный курс информатики.

Не смотря на то, что технология макросов достаточно стара, она и сегодня находит широкое применение на веб-страницах, при администрировании операционных систем (прежде всего – подобных UNIX), при настройке пользовательских интерфейсов и программ.

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

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

Неофициальный перевод лицензии (на русском языке).

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

На 17.12.2011 доступны следующие макросы:

Командные файлы DOS/Windows:

all2lwr.bat — Командный файл для перевода имени файла в нижний регистр;
all2upr.bat — Командный файл для перевода имени файлов в верхний регистр;
pars4all.bat — Программа для вставки SSI вложений и переименования файлов (см. описание в файле);
PARSER.bat — Файл с командой старта вставки/замены в файлах .htm файлов с SSI Include;
perlbat.bat — Командный файл для вызова интерпретатора perl;
perlbt.bat — Командный файл для вызова интерпретатора perl;
perlex.bat — Командный файл для вызова интерпретатора perl;
perlexe.bat — Командный файл для вызова интерпретатора perl;
sedbat.bat — Программа для запуска макросов SED (из родной директории C:\Scripts\Sed\);
sedbt1.bat — Программа для запуска макросов SED (из родной директории C:\Scripts\Sed\);
toText4DOS.bat — Командный файл для преобразования «типографского» текста в «машинописный» набор;
toWord.bat — Командный файл для преобразования «машинописного» текста в «типографский» набор;
path2html_tab.cmd — Командный файл используется для преобразования дерева файлов, полученного программой nickfiletree, в карту сайта в виде таблицы;

Макросы Perl:

c_javadoc.pl — Скрипт для создания документации из файлов формата C/C++ и Java;
ftnot1??.pl — Скрипт создаёт начальную и завершающую панель навигации для HTML-страницы (см. файл ftnot1xx.pl.txt);
hCorr.pl — Скрипт для формирования и редактирования заголовков в html-файлах;
html2text4dos.pl — Скрипт для преобразования «специальных символов» HTML в текстовый эквивалент (Demo!);
LibraryGen — Скрипт LibraryGen создает стандартный заголовок и окончание HTML-страницы для проекта: «Library» (шаблон);
path2html_tab.pl — Скрипт используется для преобразования дерева файлов, полученного программой nickfiletree, в карту сайта в виде таблицы;
pCorr.pl — Скрипт для формирования и редактирования текстовых тегов в html-файлах;
perl_apache_doc.pl — Макрос для создания документации из файлов формата Perl и Apache;
perlCGIgen.pl — Скрипт для генерирования CGI-сценария по HTML-файлу;
perlSRCgen.pl — Скрипт для генерирования SRC-сценария Multi-Edit по HTML-файлу;
ProgSourceCode00.pl — Скрипт для создания файла проекта: «Sourcecode»;
SINGLSTR.pl — для перевода абзаца текста, разбитого построчно, в единый абзац одной строкой. При этом абзацы разделяются пустыми строками;
ssi_exchange.pl — Скрипт для вставки файлов вместо SSI инструкций (современная версия);
text4dos2html.pl — Скрипт для преобразования части символов текста в «специальные символы» html (Demo!);
toExtensionTrimm.pl — Скрипт для «обрезания» расширений файлов (c *.htm.htm до *.htm);
toLowerName.pl — Скрипт для перевода имени файла в нижний регистр;
toText4DOS — Скрипт для преобразования «типографского» текста в «машинописный» набор
toUpperName.pl — Скрипт для перевода имени файлов в верхний регистр;
toWord — Скрипт для преобразования «машинописного» текста в «типографский» набор (как в Word'е). (реализовано для Microsoft Word), заменяет двойные кавычки (") в русском тексте на открывающиеся и закрывающиеся «русские» кавычки (ёлочки, лапки), двойной дефис – на тире, а повторяющиеся три точки – на многоточие;
TXT2HTML — Скрипт для генерации HTML-файла из текстового файла;

Макросы Sed:

NONEOL.sh — Скрипт для удаления пустых строк в файле;
SHTMLCORR.sh — Скрипт для замены окончаний файлов в HTML-ссылках. Он заменяет в *.HTM файлах ссылки c окончанием на .htm ссылками с расширением .htm;
TXT2HTML.sh — Скрипт для преобразования текстового файла в файл формата HTML (в формате text/html). Он удаляет пустые строки, переводит символы &, <, > и " в соответствующие метасимволы HTML, «окольцовывает» абзацы тегами <P>...</P>, и разделяет абзацы пустой строкой;
TXT2LiveJ.sh — Скрипт для преобразования текстового файла в файл формата Live Journal (в формате text/html). Файл со скриптом удаляет пустые строки, переводит символы &, <, > и " в соответствующие метасимволы HTML, «окольцовывает» абзацы тегами <P>...</P>, а абзацы, окольцованные в «квадратные скобки», выделяет тегами <H4>…</H4>, а текст, окольцованный в двойные квадратные скобки, выделяет синим цветом;

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

Документация к макросам расположена в архиве вместе с макросами.

В настоящее время автор продолжает писать новые макросы и обновлять документацию к ним.

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

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

a) Для bat-файлов (макросов MS-DOS):

IBM PC – совместимый компьютер с процессором i486 и 8 Мб RAM, или лучший;
операционная система: MS-DOS 6.22 и выше. Наличие графической оболочки не обязательно;
Комплект Norton Utilities для MS-DOS версий 6.0 – 8.0.

b) Для макросов браузера на языке Jscript и VBScript:

IBM PC – совместимый компьютер, с процессором Pentium III или Celeron, 128 Мбайт RAM или лучший;
Операционная система Microsoft Windows 2000 и выше;
Один из следующих браузеров:

Internet Explorer v. 5.5 и выше;
Mozilla FireFox v. 1.5 и выше;
Opera 5.0 и выше;
Google Chrome любых версий
Apple Safari любых версий

c) Для макросов на языке Perl:

IBM PC – совместимый компьютер, с процессором Pentium III или Celeron, 256 Мбайт RAM или лучший;
Операционная система Microsoft Windows 2000 и выше;
Установленный дистрибутив ActiveState Perl версии 5.6.0 и выше.

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

В дистрибутиве с макросами нет программы для их установки. Для установки макросов используйте следующие инструкции:

a) Установка системного окружения на диске C:

Войдите в систему с привилегиями администратора;
Скопируйте скаченный из Интернета файл: env….zip в корень файловой системы C:\ ;
С помощью программ-архиваторов (WinRAR, 7z, pkzip25.exe и других) распакуйте архив в текущее местоположение (C:\);
Перейдите в каталог: «C:\INSTALL», и запустите оттуда файл: «install.bat»;
Затем осуществите двойной щелчок на файле: «SYSTEM_ENVIRONMENT.reg»;
Далее откройте файл: PATH.txt в этом же каталоге, и скопируйте его содержимое в буфер обмена;
После этого перейдите к диалоговому окну: «Старт» -> «Панель инструментов» -> «Система» -> «Дополнительно» -> «Переменные среды»;
В пункте: «Системные переменные», выберите переменную: «Path», и затем — кнопку: «Изменить»;
В конец строки редактирования необходимо вставить (оставив слева прежний текст!) содержимое буфера обмена, и нажать кнопку: «Ok»;
Закройте все окна и перегрузите компьютер;

b) .bat – файлы;

Скопируйте файлы из папки BAT (полностью!) в каталог, прописанный в переменную окружения PATH операционной системы (например, C:\WINDOWS), однако, лучше для этого использовать каталог «C:\Scripts\bin», инсталлированный в пункте a);

Внимание! Для доступа к каталогам и переменным окружения Вам могут понадобиться права администратора.

В командной строке это копирование можно сделать, например, следующим способом:

>xcopy .\BAT\*.* C:\WINDOWS\*.* /v
В качестве альтернативы можно запустить установочный файл bat_inst.bat, который появится в каталоге, в который Вы распаковали архив. При этом Вы никак не сможете повлиять на порядок установки макросов!

c) Для макросов Perl:

Скопируйте каталог user вместе со всеми его подкаталогами в папку с установленным дистрибутивом Perl (по-умолчанию – C:\Perl):

>xcopy .\user\*.* C:\Perl\user\*.* /v /s /e

В качестве альтернативы можно запустить установочный файл perl_inst.bat, который появится в каталоге, в который Вы распаковали архив. При этом Вы никак не сможете повлиять на порядок установки макросов!

d) Для макросов VBScript и Jscript

Откройте файл макроса и веб-страницу в текстовом редакторе (например, в блокноте);
Скопируйте текст макроса в текст веб-страницы в нужное место;
Сохраните текст веб-страницы;

На основании текста веб-страницы впоследствии Вы сможете сделать шаблон.

e) Для макросов Sed и других программ GnuWin32, а также .bat и .cmd файлов для запуска макросов в Windows:

Войдите в систему с полномочиями администратора;
Скопируйте скаченный из Интернета файл: scripts….zip в корень файловой системы C:\ ;
С помощью программ-архиваторов (WinRAR, 7z, pkzip25.exe и других) распакуйте архив в текущее местоположение (C:\);
Перейдите к диалоговому окну: «Старт» -> «Панель инструментов» -> «Система» -> «Дополнительно» -> «Переменные среды»;
В пункте: «Системные переменные», выберите переменную: «Path», и затем — кнопку: «Изменить»;
В конец строки редактирования дописать: «;C:\Scripts\bin», и нажмите кнопку: «Ok»;

Внимание! пункты 4 – 6 нужно делать только в том случае, если Вы не пропустили инсталляцию каталогов и системного окружения в разделе VII. a);

Закройте все окна и перегрузите компьютер;

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

IX. Download

Скачать макросы:

X. Возможные проблемы

Теоретически возможен конфликт версий для данных скриптов. Внимательно смотрите системные требования к макросам, а также следуйте алгоритмам установки.
Макросы сами по себе не работают! Для их функционирования требуются: интерпретатор Activestate Perl, программа Sed из пакета GnuWin32, Multi Edit, программы для редактирования веб-страниц с подсветкой синтаксиса. Ищите эти программы в Интернете, или отправьте письмо автору.

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

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

XII. Полезные ссылки и использованная литература

1. Матросов А.В., Чаунин М.П. Perl. Программирование на языке высокого уровня. Учебник для вузов. — СПб.: Питер, 2003. — 608 с.: ил.;

2. Онлайн руководство по пакету программ: Norton Utilities v. 8.0 Rus.;

3. Работа автора: «Интерфейсы» (http://yudenisov.narod.ru/EIS/Vol11/index.htm), посвящённая интерфейсам работы с компьютером;

4. Работа автора «Командные файлы», (http://simple-clerk.narod.ru/LEARNING/PROG_WRI/files/bapp06.hjt), посвящённая работе в командной строке операционной системы;

5. Финогентов К.Г. MS-DOS 5.0 (Настольная книга пользователя ПК) в 2-х частях. Ч.1. - М.: МП "Малип", 1992. - 64 с.;

6. Финогентов К.Г. MS-DOS 5.0 (Настольная книга пользователя ПК) в 2-х частях. Ч.2. - М.: МП "Малип", 1992. - 64 с.;

7. Фигурнов В.Э. IBM PC для пользователя. Изд. 7-е. - М.: ИНФРА-М, 1997. 640 с., ил.;

8. MS-DOS 6.0. Справочное руководство для пользователей компьютеров IBM PC. - М.: Продукция фирмы "ВА Принт", 1994. - 319 с.;

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

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

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