|
.: www4mail russian
От переводчика:
Перевёл я это дело, стараясь как можно точнее донести смысл.
Некоторые строки, типа, вода мокрая, небо голубое, жизнь –
говно, мной вырезались. Грамматические и орфографические ашипки
здесь точно есть, просьба о них сообщать с указанием строки
и самой ошибки конечно. Также если кто заметит огрехи в переводе,
тоже выслушаю и исправлю.
PS: Ссылки пока не работают
Eugene Nuke eugenew@peterlink.ru
~~~~~~~~~~~~~~~~~~~~~~~~( HELP file for www4mail
)~~~~~~~~~~~~~~
http://www.ictp.trieste.it/~www4mail
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Web Navigation & Database Search by E-Mail (The Next
Generation)
www4mail - QUICK HELP GUIDE - version 3.0/2001
Что такое www4mail?
~~~~~~~~~~~~~~~~~~~
www4mail - это open source application, которое позволяет
вам в off-line ходить и искать информацию в интернете при
помощи электронной почты (e-mail) используя любой стандартный
броузер и почтовую программу, поддерживающюю MIME (Multipurpose
Internet Mail Exchange). Электронные сообщения, посылаемые
серверам www4mail автоматически попадают в вашу почтовую программу*,
как только вы выбирете (одну или несколько) кнопок, которые
ссылаются на другие Web документы с данной страницы. Множество
опций доступно для ведения статистики, кодирования ответов
и т.д.
*)Здесь имеется ввиду вариант, когда вы отправляете запрос
без модификаторов типа tsource – в ответ вам приходит страница,
которую можно открыть в броузере и там напротив ссылок можно
ставить галочки, после чего нажатием на кнопку в конце страницы
вы отправите письмо через вашу почтовую программу на сервер.
- Прим. пер.
Как использовать www4mail?
~~~~~~~~~~~~~~~~~~~~~~~~~~
.. Это просто!
В теле e-mail сообщения для www4mail просто укажите интернет
адрес, называемый Uniform Resource Locator (URL), Web сайта(ов)/страниц(ы)
которую вы хотите получить. По умолчанию, ответ будет представлен
в виде аттача(вложения). Для получения Web документов в теле
письма вы можете добавить одну из этих опций SEND, GET, GET
SOURCE, или XSOURCE, как описано ниже. Можете использовать
XUUENCODE для получения uue-кодированного ответа.
Получение подробной справки
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Так же вы можете получить справку по конкретной теме послав
письмо серверу www4mail написав в теле письма, например, следуующее:
help COOKIES
Другие разделы:
Получение Web документов в виде аттачей
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Получение Web документов в виде аттачей позволяет сохранять
документы и использовать их повторно; например для отложенного
поиска в Интернет.
Например, для получения страниц с The Abdus Salam International
Centre for Theoretical Physics Web server в Trieste, Italy,
создайте такое сообщение:
To: www4mail@wm.ictp.trieste.it
Subject: (... что угодно)
и напишите (от 1-го до 5-ти запросов) в теле письма:
http://www.ictp.trieste.it/
http://www.ictp.trieste.it/~www4mail
...
www4mail вышлет запрошенные Web документы в виде аттачей,
которые вы можете открыть и посмотреть в любом стандартном
броузере(Netscape, MS Internet explorer, Lynx и т.д.). В них
будет сохранено оригинальное содержание(таблицы, цвета и т.д.).
Вы можете получить интересующие вас страницы отметив соответствующие
кнопки выбора и нажав на кнопку `Get Selected Document(s)'
в конце страницы, сделав таким образом новый запрос на www4mail.
Если вы хотите получить оригинальный, НЕМОДИФИЦИРОВАННЫЙ
HTML код в виде аттача, который можно просмотреть в стандартном
броузере, тогда напишите:
TSOURCE http://www.ictp.trieste.it/
Оригинальное содержание страницы (таблицы, фпеймы, цвета
и т.д.) будет сохранено.
Вы можете указать до 5 запросов такого типа в теле письма,
но по одному запросу на строку.
Получение Web документов в теле письма
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Так же поддерживается совместимость с альтернативными серверами
типа "Agora" и "GetWeb". Подобно сервисам
"Agora" и "GetWeb", вы можете получать
Web страницы (конвертированные из html в текст) в теле письма,
если вам так больше нравится.
Для предыдущего примера, создайте такой запрос:
To: www4mail@wm.ictp.trieste.it
Subject: (... что угодно)
и напишите в теле письма одну из представленных опций:
GET http://www.ictp.trieste.it/
или
SEND http://www.ictp.trieste.it/
Для дальнейшего подобного хождения по Web используйте запросы,
определённые в вышеприведённом примере.
Если вы хотите получить НЕМОДИФИЦИРОВАННЫЙ HTML код в теле
письма, используйте любую из следующих опций:
GET SOURCE http://www.ictp.trieste.it/
или, просто,
SOURCE http://www.ictp.trieste.it/
Если ваша почтовая программа не поддерживает MIME, вы можете
получать фильтрованный www4mail HTML код в теле письма используя
следующую опцию:
XSOURCE http://www.ictp.trieste.it/
Вы можете указать до 5 запросов такого типа в теле письма,
но по одному запросу на строку.
Как обрабатываются фреймы (Frames)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Если запрашиваемый URL представлен в виде фреймов (т.е.,
главная страница содержит несколько других страниц), то www4mail
по умолчанию использует собственный конвертор “фреймы_в_таблицы”("frames2table")
и вы получаете результат в виде аттача. Если использовалась
опция SOURCE для получения URL содержащего фреймы, то www4mail
отсылает вам только страницу содержащую описание структуры
фреймов (FRAMESET).
Написание длинных URL
~~~~~~~~~~~~~~~~~~~~~
Если запрашиваемый URL очень длинный, и не умещается на одной
строке, вы можете разбить его на части заканчивая строку обратной
косой чертой backslash (`\'). Например,
To: www4mail@wm.ictp.trieste.it
Subject: (... что угодно)
http://www.ictp.trieste.it/cgi-bin/ICTPsmr/mkhtml/smr2htm\
l.pl?smr1099/Announcement
Автоматическое разбиение сообщений
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Все бинарные файлы, размером более 300kB, но меньше 6 MB
автоматически разбиваются на части по 300kB каждая и отсылаются
в виде аттача, закодированного MIME BASE64*.
*)На практике, происходит разбиение на части, по 204Кб. Прим.
пер.
Все ТЕКСТОВЫЕ и HTML файлы, размер которых больше 300kB и
меньше 6 MB автоматически упаковывоются pkzip’ом и далее обрабатываются
как бинарные файлы, при необходимости разбиваются и кодируются
MIME.
Так же существует возможность кодировать бинарные файлы в
uue, используя опцию UUENCODE в запросе.
Разбиение сообщений
~~~~~~~~~~~~~~~~~~~
Если ваша почтовая программа или шлюз имеет лимит на максимальный
размер письма меньший, чем 300kB, то вы можете указать www4mail
разбивку сообщения на более мелкие части. Для уменьшения этого
значения используйте команду GETSIZE.
Например, следующая команда разобьёт файл на куски по 10k
каждый:
To: www4mail@wm.ictp.trieste.it
Subject: (... что угодно)
GETSIZE 10000 только по одной опции на строку!
URL_here
GETSIZE устанавливает размер ответного письма www4mail в
байтах (символы, отличные от цифр не допускаются). Вы можете
указывать столько URL в теле письма, сколько вам надо, но
только по одному URL на строку.
www4mail, отвечая на команду GETSIZE всегда высылает запрашиваемый
документ в виде аттача. Вам нужно будет с помощью вашей почтовой
программы сохранить этот аттач. И, затем, использовать подходящую
программу для сборки всех кусков (в UNIX-подобной системе
используйте:
"cat file.1 file.2 file.3 > file"
а в DOS’е:
"copy /b file.1+file.2+file.3 file").
Если вы просматриваете Web документы присланные www4mail
в броузере, и хотите запрашиваемые документы разбить на меньшие
части, то вы можете ввести максимальный размер письма-ответа
www4mail в специальном поле, расположенном рядом с кнопкой
`Get Selected Document(s)’ в конце страницы.
Запрос одной из частей разбитого на части сообщения
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Следующая команда позволяет запросить необходимуою часть
сообщения.
Сделайте такой запрос:
To: www4mail@wm.ictp.trieste.it
Subject: (...что угодно)
GETPART 1, 2 3 , 5-8 только по одной опции на строку!
GETSIZE 10000 только по одной опции на строку!
URL_here
GETPART определяет номера частей письма, которые вы хотите
получить. Если не указать GETSIZE, www4mail будет использовать
значение по умолчанию – см. раздел Автоматическое разбиение
сообщений (Automatic Splitting of Messages) (выше).
Когда www4mail отвечает на команду GETPART, запрашиваемые
Web документы ВСЕГДА высылаются в виде аттача. Вам нужно будет
с помощью вашей почтовой программы сохранить этот аттач. И,
затем, использовать подходящую программу для сборки всех кусков
(в UNIX-подобной системе используйте:
"cat file.1 file.2 file.3 > file"
а в DOS’е:
"copy /b file.1+file.2+file.3 file").
UUE кодорование сообщений
~~~~~~~~~~~~~~~~~~~~~~~~~
Следующая команда позволяет получать uue кодированные документы.
Составте такой запрос:
To: www4mail@wm.ictp.trieste.it
Subject: (... что угодно)
XUUENCODE (только по одной опции на строку!)
URL_here
Когда www4mail отвечает на команду XUUENCODE, запрашиваемые
Web документы всегда высылаются в теле письма. www4mail всегда
отвечает с указанием вашей статистики. Если запрашиваемый
файл больщой, то вы можете использовать команду GETPART, указав
номера нужных вам частей и команду GETSIZE, указав размер
части в байтах. Например,
To: www4mail@wm.ictp.trieste.it
Subject: (... что угодно)
GETPART 1, 2 3 , 5-8 (только по одной опции на строку!)
GETSIZE 10000 (только по одной опции на строку!)
XUUENCODE
URL_here
Используйте подходящую программу или команду (например, UNIX
cat file1 file2 file3 > output) для сборки всех частей
после uue декодирования каждой части.
Получение Web страниц в виде PostScript или PDF файлов
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Следующая команда позволяет вам получить любой Web документ,
конвертированный в PostScript файл (включая изображения, если
есть, в документе).
Составте такой запрос:
To: www4mail@wm.ictp.trieste.it
Subject: (... что угодно)
GETPS только по одной опции на строку!
URL_here
Используйте GETPDF для получения файла в формате Portable
Document Format. Если другие команды не используются вместе
с GETPS или GETPDF (такие как GETSIZE для установки размера
письма-ответа www4maile), то www4mail использует значения
по умолчанию – см. раздел Автоматическое разбиение сообщений
(Automatic Splitting of Messages) (выше).
При ответе www4mail на команды GETPS/GETPDF, запрашиваемые
Web документы ВСЕГДА высылаются в виде аттачай.
Если запрашиваемый файл больше, чем 300kB, то он будет автоматически
разбит и выслан несколькими письмами. Используйте подходящую
программу или команду (например в UNIX: "cat file1 file2
file3 > output.ps") для сборки файла.
Для получения Web страниц в виде PostScript или PDF файлов
в теле письма и uue кодированных, используйте следующую конструкцию:
To: www4mail@wm.ictp.trieste.it
Subject: (... что угодно)
GETPS (только по одной опции на строку!)
XUUENCODE
URL_here
Используйте GETPDF для получения файлов Portable Document
Format.
Запрос Web/FTP сайтов с паролями
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
www4mail также поддерживает аутентификацию пользователя для
сайтов, защищённых паролем. Для доступа к таким Web сайтам/страницам
используется следующая конструкция `protocol://username:password@site/directory'
вы должны знать (для успешного доступа) корректные USERNAME
и PASSWORD.
Создайте письмо
To: www4mail@wm.ictp.trieste.it
Subject: (... что угодно)
И напишите в теле письма:
http://username:password@site/path
или
ftp://username:password@site/path
где site/path – это хост, домен, директория, файл (machine,
domain, directory, file) который вы хотите получить, а значок
@ используется для отделения строки `username:password' от
site/path.
Получив один раз ответ от www4mail, вы можете продолжать
запросы к защищённым страницам уже без аутентификации. www4mail
сделает это за вас.
Конечно вы можете получить нужную информацию в теле письма
как простой текст, используя опции GET или SEND, или как HTML
код, используя опции GET SOURCE, SOURCE или XSOURCE.
НО ПОЖАЛУЙСТА ПОМНИТЕ, пароли, указанные таким образом, как
и всё что передаётся по e-mail, могут быть перехвачены, потому
что:
www4mail ведёт локальные логи всех транзакций.
HTTP/FTP транзакции через почту с любым сервером идут незашифрован-ными
и могут быть перехвачены.
Secured Web servers (https://) также доступны через www4mail.
www4mail ограничения
~~~~~~~~~~~~~~~~~~~~
Период действия квот на бесплатном сервисе www4mail зависит
от системного администратора. Обычно это ограничение на 100-300
запросов (в зависимости от категории - html или текстовые
или бинарные файлы) в неделю.
Если вы достигли вашей недельной квоты, www4mail информирует
вас об этом сообщением "503 Error Message - Service Unvailble
(quota finished)" и после этого перестанет отвечать на
ваши запросы!
ВНИМАНИЕ: Ваша квота значительно изменяется, когда вы запрашиваете
бинарные файлы, такие как ".exe", ".zip".
Эти типы файлов используют в 3-5 раз большее значение квоты.
Картинки, такие как ".jpg", ".gif" используют
квоту в 20 раз больше!
www4mail стремится упростить доступ и поиск (HTML) Web документов.
Каждый ответ, получаемый вами от www4mail несёт в себе информацию
о вашей оставшейся квоте и о дне последнего обращения (usage
within the quota
week). Для примера, в теле каждого ответа www4mail вы можете
увидеть что-то похожее на это:
Dear User,
Statistics of your (per week) usage of this service
===================================================
Remaining Quota : 196
Used Quota : 4
Last access : html on Tue Jan 8 14:08:04 2001
Существует возможность ПРОВЕРИТЬ ВАШУ НЕДЕЛЬНУЮ КВОТУ в любой
момент, просто создайте запрос:
To: www4mail@wm.ictp.trieste.it
Subject: (... что угодно)
и напишите в теле письма:
XMYQUOTA
www4mail Список Контроля Доступа (Access Control List (ACL))
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Пожалуйста помните, что все бесплатные сервисы www4mail посволяют
вам путешествовать по всему Internet через e-mail, но они
не предоставляют доступ к Web сайтам/документам, которые защищены
авторскими правами (Copyright) или лицензированы(licensed),
подобно большинству Журналам/Газетам on-line, Библиотекам
CD-ROM, и т.д.
www4mail имеет собственный Список Контроля Доступа (Access
Control List (ACL)), который постоянно обновляется. См. раздел
Соглашения (Disclaimer) (ниже).
FTP и двоичные файлы через www4mail
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Если вы используете www4mail для получения, например, файлов-изображений
(расширения `.jpg', `.gif'), программ (расширения `.tar',
`.hqx'), файлов Word'а (расширение `.doc') или WordPerfect’а
(расширение `.wp'), или сжатых файлов (расширения `.gz', `Z'),
то www4mail вышлет вам файлы в виде аттачей.
Для примера, если вы отошлёте такое письмо:
To: www4mail@wm.ictp.trieste.it
Subject: (... что угодно)
ftp://ftp.andrew.cmu.edu/pub/mpack/mpack15d.zip
или
http://www.ictp.trieste.it/images/ProfSalam.gif
Вы получите бинарное сообщение в виде BASE64 MIME аттача.
Также доступно uue кодирование бинарных файлов – используйте
опцию UUENCODE в запросе. Помните, что существует ограничение
на количество байт, которое www4mail может выслать вам! –
см. раздел Автоматическое разбиение сообщений (Automatic Splitting
of Messages) (выше).
Если размер запрашиваемого файла больше, чем 300 килобайт
(300kb), www4mail автоматически разобьёт его на два (или более)
300 килобайтных файла, и вышлет каждый файл отдельным письмом.
Если так и произошло, вы должны будете собрать оригинальный
файл из этих кусков. Используйте подходящую программу или
команду для сборки (в UNIX-подобной системе спользуйте:
"cat file.1 file.2 file.3 > file",
а под DOS:
"copy /b file.1+file.2+file.3 file").
Ваша квота значительно изменяется при заказе бинарных файлов!
Специальные Опции www4mail
~~~~~~~~~~~~~~~~~~~~~~~~~~
Можно расширить возможности www4mail включая более специализированные
опции для настройки языка и набора символов, разрешения ссылок
на изображения, и т.д.
Эти новые опции были введены как результат опроса тест-команды
в течение первого пробного месяца.
Например, вы также можете использовать любую из этих опций:
XIMAGE (только по одной опции на строку!)
Эта опция позволяет включать ссылки на изображения в Web
документе, высланном как аттач.
XLANGUAGE xx , xx (только по одной опции на строку!)
Эта опция позволяет задать список (разделённый запятыми)
предпочтительных языков для запрашиваемых Web документов (помните,
что языковая поддержка работает только в случае, если она
доступна на указанном Web сервере). Примеры кодов языков:
de (for German), en for English, fr for French, ru для России
и т.д.
XCHARSET xxxxx , xxxxx (только по одной опции на строку!)
Эта опция позволяет определить список (разделённый запятыми)
предпочтительных кодировок для запроса Web документов (помните,
что поддержка предпочтительных кодировок работает только в
случае, если она доступна на указанном Web сервере). Примеры
кодировок: euc-cn (for Chinese), euc-jp (for Japanese), iso-8859-6
(for Arabic) и т.д.
XMIME (только по одной опции на строку!)
Некоторые почтовые программы отображают HTML или текстовые
аттачи своими средствами. Для таких программ www4mail может
генерировать различные Content-Type: заголовки для документов
HTML. Если происходит именно так, то используя XMIME вы можете
заставить www4mail высылать вам аттачи html с использованем
MIME заголовков application/html. Это полезно для того, чтобы
запретить вашей почтовой программе отображать своими средствами
html аттач.
XURLCODE (только по одной опции на строку!)
Заполняя HTML формы через e-mail, есть возможность того,
что ваши вводимые данные могут быть повреждёны, в этом случае
вы можете получить запрос на повторную пересылку данных с
Web сервера. Используя опцию XURLCODE www4mail инструктирует
ваш броузер закодировать данные перед отправкой сообщения.
Это позволяет сохранить целостность данных заполненной формы.
XBYJS (только по одной опции на строку!)
Некоторые броузеры не могут отправлять данные через e-mail,
например, MS-IE v3.0. Эта проблема обычно обнаруживается после
того как вы отметили ссылки, которые хотели бы получить и
нажали кнопку "Get Selected Document(s)". Всё что
вы получите – это – запуститься ваша почтовая программа, откроется
новое сообщения с адресом сервера www4mail и пустым телом.
Вы можете использовать опцию XBYJS для обхода этой проблемы,
используя броузер, поддерживающий JavaScript. Примечание:
Этот способ автоматически пытается заполнить поле Тема(Subject)
вместо тела сообщения. Но если вы заметили, что поле Тема
пустое, то вам нужно вырезать всесимволы, начинающиеся со
знака ?, размещённого в поле Кому(To) и всавить их в поле
Тема вручную.
Соглашения
~~~~~~~~~~
Все запросы, использование или оскорбление любого из доступных
сервисов www4mail сохраняются в лог-файлах.
Авторы, предоставившие исходный код на Perl для www4mail
не отвечают за содержание, представление (или отсутствие такового)
Web документов, запрошенных из Internet используя любой из
публичных или приватных серверов www4mail.
Свежую информацию по www4mail вы можете найти по адресу:
http://www.ictp.trieste.it/~www4mail
... Have a nice Internet navigation with www4mail!
... Поимей хороший Internet c www4mail!
... Хорошего вам Internet c www4mail!
---EOF типа, енд оф филе и всё такое, гы-гы
| 
