faqs.org.ru

 Главная > Программное обеспечение > Программы для Интернет >

Список макросов, доступных в шаблонах писем The Bat!

			     СПИСОК МАКРОСОВ,
		    ДОСТУПНЫХ В ШАБЛОНАХ ПИСЕМ 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" Приоритет писем высокий/обычный/низкий

Вернуться в раздел "Программы для Интернет" - Обсудить эту статью на Форуме
Главная - Поиск по сайту - О проекте - Форум - Обратная связь

© faqs.org.ru