СПИСОК МАКРОСОВ,
ДОСТУПНЫХ В ШАБЛОНАХ ПИСЕМ THEBAT!
Сортировка по группам, перевод Garry V. Dorohin <dorohin@ssga.ru>
GVD: С версии 1.29 (иногда) *все* макросы доступны в области
редактирования шаблона при нажатии на кнопку "Макро"
ОГЛАВЛЕНИЕ:
----------
1. ТЕКСТ
2. ОТПРАВИТЕЛЬ (SENDER INFO)
3. ПОЛУЧАТЕЛЬ (RECIPIENT INFO)
4. МАКРОСЫ ПОЛЕЙ (PRE-DEFINED INFO)
5. ПРОЧЕЕ (MISCELLANEOUS)
-------------------------------<>--------------------------------------
1. ТЕКСТ
%CURSOR позиция курсора в редакторе
%QUOTES оригинальное сообщение как цитата
%TEXT текст оригинального сообщения
%COOKIE девиз
%HEADERS для включения служебной информации письма AKA kludges
%QHEADERS служебной информации письма как цитата
-----------
%DATE настоящая дата полностью
%DATESHORT настоящая дата в укороченном виде
%TIME настоящее время в укороченном виде
%TIMELONG настоящее время полностью
%DOW настоящий день недели
%ODATE дата оригинального сообщения полностью
%ODATESHORT дата
%OTIME время оригинального сообщения (коротко)
%OTIMELONG время оригинального сообщения полностью
%ODOW день недели оригинального сообщения полностью
-----------
%SUBJ Тема настоящего сообщения
%OSUBJ Тема оригинального сообщения
-------------------------------<>--------------------------------------
2. ОТПРАВИТЕЛЬ (SENDER INFO)
%FROMNAME Имя и фамилия отправителя
%FROMFNAME Имя отправителя
%FROMLNAME Фамилия отправителя
%REPLYNAME Имя и фамилия из обратного адреса
%REPLYFNAME Имя из обратного адреса
%REPLYLNAME Фамилия из обратного адреса
%FROMADDR E-mail адрес отправителя
%REPLYADDR Обратный E-mail адрес отправителя
-----------
%OFROMNAME Имя и фамилия отправителя оригинального сообщения
%OFROMFNAME Имя отправителя оригинального сообщения
%OFROMLNAME Фамилия отправителя оригинального сообщения
%OREPLYNAME Имя и фамилия из обратного адреса оригинального сообщения
%OREPLYFNAME Имя из обратного адреса оригинального сообщения
%OREPLYLNAME Фамилия из обратного адреса оригинального сообщения
%OFROMADDR E-mail адрес отправителя оригинального сообщения
%OREPLYADDR Обратный E-mail адрес отправителя оригинального сообщения
-------------------------------<>--------------------------------------
3. ПОЛУЧАТЕЛЬ (RECIPIENT INFO)
%TONAME Имя и фамилия адресата
%TOFNAME Имя адресата
%TOLNAME Фамилия адресата
%TOADDR E-mail адрес получателя
-----------
%OTONAME Имя и фамилия адресата оригинального сообщения
%OTOFNAME Имя адресата оригинального сообщения
%OTOLNAME Фамилия адресата оригинального сообщения
%OTOADDR E-mail адрес получателя оригинального сообщения
-------------------------------<>--------------------------------------
4. МАКРОСЫ ПОЛЕЙ (PRE-DEFINED INFO)
%SUBJECT="" Новая тема сообщения
%TO="" Дополнительный адресат
%CC="" Дополнительный получатель копии
%BCC="" Дополнительный невидимый адресат
%FROM="" Дополнительный отправитель From
%REPLYTO="" Дополнительный отправитель REPLY-TO
%RETURNPATH="" Дополнительный отправитель RETURN-PATH
-------------------------------<>--------------------------------------
5. ПРОЧЕЕ (MISCELLANEOUS)
Названия этих макрокоманд не перечислены на всплывающее меню кнопки
"Макро". Хотя вы получите реакцию на них после щелчка по пунктам "
Прикрепить файл...", " Включить файл шаблона ... " и "Вставить Текстовый
файл ... ".
%INCLUDE
%PUT
%ATTACHFILE
Это английское и американское написание макросов, а The BAT! безразлично
%ORGANISATION Название организации
%ORGANIZATION
%OORGANISATION Название организации из оригинального сообщения
%OORGANIZATION
Появились в v1.00 build 1349 (смотри README).
%READCONFIRM - Установить "Reading Confirmation" для сообщения
%RCPTCONFIRM - Установить "Receipt Confirmation" для сообщения
%SIGNCOMPLETE - Подписать сообщение (PGP) после завершения редактирования
%ENCRYPTCOMPLETE - Зашифровать сообщение (PGP) после завершения редактирования
Эти макросы появились в v1.043 и полностью документированы в README:
%WINDOWSMAJORVERSION - Получить старший номер версии ОС. Например, для
версии 3.51 Windows NT, старший номер версии - 3; и для версии 4.0 Windows
NT старший номер - 4. Эта макрокоманда используется по умолчанию в шаблоне
"Сообщения об ошибке".
%WINDOWSMINORVERSION - Получить младший номер версии ОС. Например, для
версии 3.51 Windows NT, младший номер версии - 51; и для версии 4.0 Windows
NT младший номер - 0. Эта макрокоманда используется по умолчанию в шаблоне
"Сообщения об ошибке".
%WINDOWSBUILDNUMBER - Идентифицирует номер компоновки операционной
системы Эта макрокоманда используется по умолчанию в шаблоне "Сообщения об
ошибке".
%WINDOWSCSDVERSION - Для Windows NT: содержит строку с нулевым символом в
конце, типа " Service Pack 3 ", который указывает самый последний Сервисный
Пакет установленный в системе. Если никакой Сервисный Пакет не был
установлен, строка пуста; для Windows 95: содержит строку с нулевым символом
в конце Это обеспечивает произвольную дополнительную информацию относительно
ОС. Эта макрокоманда используется по умолчанию в шаблоне "Сообщения об
ошибке".
%WINDOWSPLATFORMNAME - Идентифицирует имя платформы Windows, например,
Windows NT, Windows 95 или Windows 98. Эта макрокоманда используется по
умолчанию в шаблоне "Сообщения об ошибке".
%THEBATVERSION - Выдает номер версии The Bat! Эта макрокоманда
используется по умолчанию в шаблоне "Сообщения об ошибке".
%ACCOUNTNAME - Имя текущего почтового ящика
%FOLDERNAME - Имя текущей папки
%FOLDERFROMNAME - Показывает имя из поля "From:" для текущего почтового
ящика.
%FOLDERFROMADDR - Показывает e-mail адрес из поля "From:"для текущего
почтового ящика.
%FOLDERREPLYNAME - Показывает имя из поля "Reply-To:" для текущего почтового
ящика.
%FOLDERREPLYADDR - Показывает e-mail адрес из поля "Reply-To:" для текущего
почтового ящика.
Появились в версии v.1.1
%BLANK - Эта макрокоманда всегда вставляет пустую строку, можно
использовать, если Вы желаете иметь пустой шаблон в папке.
Эти макросы показывают дату/время по-английски, независимо от установленный
в настоящее время системного языка
%DATEEN
%ODATEEN
%TIMELONGEN
%OTIMELONGEN
%OTEXTSIZE - Размер оригинального сообщения, in bytes.
%CHARSET - Допускает изменение набора символов сообщения
Показывает список присоединенных файлов, с полными именами. если их нет,
показывает "<none>".
%ATTACHMENTS
%OATTACHMENTS
%PAGENUMBER - для получения номера страницы в шаблоне печати сообщения.
Доступно с версии v1.14
%ATTACHVCARD - присоединяет визитную карточку VCard к сообщению (Вы можете
изменять VCard - Account|Properties, кнопка "Редактировать VCard").
%SINGLERE - не применять нумерацию ответов. "Re:" вместо "Re[n]:"
Доступно с версии v1.36 Beta/3
%REGEXPTEXT
%REGEXPQUOTES.
Применяется в шаблонах для формирования сообщения из содержимого
оригинального письма.
Регулярные выражения то же самое что и regexp роцедуры в UNIX
Используются следующие метасимволы (egrep - стандарт)
\ - считать следующий метасимвол как обычный символ
^ - начало строки
. - один произвольный символ. Кроме '\n' - конец строки
$ - конец строки
| - альтернатива (или)
() - группировка
[] - класс символов
\w - алфавитно-цифровой или "_"
\W - не алфавитно-цифровой
\s - один пробел
\S - один не пробел
\d - одна цифра
\D - одна не цифра
Мнимые метасимволы
\b - граница слова
\B - не граница слова
\A - начало строки
\Z - конец строки
Метасимволы имеют модификаторы
* - повторяется 0 или большее число раз
+ - повторяется 1 или большее число раз
? - 1 или 0 раз
{n} - очно n раз
{n,} - по меньшей мере n раз
{n,m}- не меньше n но и не более m
Примеры
Например чтобы выдернуть из письма из строки
Name: Serg Demchenko_____________________
Нужно выполнить следующий макрос
%REGEXPTEXT="^\s*Name:\s*(.+?)\s*_*\s*$"
(С начала строки, более одного пробела до слова "Name:", после него
скушать лишние пробелы сгруппировать и вывести любые символы до символов
"_" повторяющихся более одного раза ....)
Данные макросы можно применять для переформатирования любой информации
из оригинального письма. Эффективное средство для построения различный
роботов (отсылка выбранных фрагментов писем на пэйджер или SMS сообщения на
радиотелефон)
%TOLIST список адресатов
%CCLIST
%BCCLIST
%OTOLIST список адресатов оригинального сообщения
%OCCLIST
%OBCCLIST
Доступно с версии v1.38
!!!!! Теперь макросы полностью рекурсивны, например можно писать такое
%SUBJECT="Ответ на письмо от %ODATE время %OTIME"
%FOLDERORGANISATION Поле Организация текущей папки (Свойства папки,
вкладка Поля)
%SETPATTREGEXP="" устанавливает шаблон регулярного выражения для макроса
%REGEXPMATCH
%REGEXPMATCH="" возвращает подстроку, которая удовлетворяет шаблону (а
может, лучше написать - регулярному выражению?), установленному ранее с
помощью макроса %SETPATTREGEXP
%CLEAR макрос для "быстрых шаблонов" удаляющий весь текст из редактора
перед вставкой шаблона.
%REPLYCOUNTER/%ORERPLYCOUNTER для составления строки (или текста)
"Re[n]:" в соответствии с количеством ответов (или со счетчиком ответов)
(может быть полезно при составлении поля Тема с помощью макросов)
%ISSIGNATURE макрос, вставленный в Быстрый шаблон, указывает, что этот
быстрый шаблон является подписью. Когда он используется, текущая подпись
заменяется на текст шаблона, при этом позиция курсора не меняется.
%ACCOUNT="account name" макрос для выбора активного почтового ящика (не
работает для автоматических сообщений).
%LANGUAGE="language id" для выбора словаря при проверке орфографии
письма. Имеет значения
AM - American English
EA - Australian English
BR - British English
CT - Catalan
CZ - Czech
DA - Danish
FI - Finnish
FR - French
FC - French Canadian
GE - German
IT - Italian
NO - Norwegian (Bokmal)
NN - Norwegian (Nynorsk)
NL - Dutch
PB - Portuguese (Brazil)
PT - Portuguese (Iberian)
PL - Polish
SP - Spanish
SW - Swedish
RU - Russian
HU - Hungarian
Для использования Common Speller API , Language ID должен получить
префикс "CSAPI". E.g. %LANGUAGE="CSAPI RU"
%INSERTPGPKEY="title" макрос для присоединения публичного ключа PGP с
характерным признаком. Работает только со встроенным PGP. Например строка
%INSERTPGPKEY="%FROMADDR" вставит ваш собственный открытый ключ.
%QINCLUDE="Псевдоним быстрого шаблона" макрос для вставки быстрых
шаблонов в стандартные шаблоны. Остерегайтесь рекурсивных быстрых шаблонов!
Мы не исключили возможность рекурсивного включения, поскольку это может
быть полезно при работе в регулярными выражениями. RegExps.
Эти макросы были причиной Access Violation, если использовались в шаблоне
нового письма, и письмо создавалось в момент, когда ни одна папка не была
выбрана в списке (или дереве) папок.
%FOLDERFROMNAME,
%FOLDERFROMADDR,
%FOLDERREPLYNAME,
%FOLDERREPLYADDR
%FOLDERNAME
Доступно с версии v1.41
%TRACKINGNUMBER (случайное 32-bit число, в шестнадцатиричной системе).
Доступно с версии v1.42
%FROM="smth", %REPLYTO="smth", %RETURNPATH="smth" не требуют обнуления
своих значений, можно сразу указать значение.
Доступно с версии v1.44
%QClipboard/%QuoteClipboard Содержимое клипборда в виде цитаты.
%OneLine/%SingleLine Если используется в быстром шаблоне, результат
обработки шаблона будет отсформатирован в одну строку - удобно для
определения сложных вспомогательных шаблонов для генерации одной строки.
QUOTESTYLE="expression" - изменение стиля цитирования, после этого
макроса.
Допустимы следующие значения:
NONE - пустой префикс (стандартно)
I - используются инициалы отправителя
IF - первый инициал отправителя
N - полное имя отправителя
F - первое имя отправителя
L - последнее имя (фамилия) отправителя
=text - используется "text" как цитирование, e.g. %QUOTESTYLE="=-|"
[*] Можно использовать апострофы. Для облегчения жизни, можно писать
%TO='"My Name" <address>' вместо %TO="""My Name"" <address>"
Доступно с версии v1.44
%PRIORITY="H/N/L" Приоритет писем высокий/обычный/низкий
|