Return to README CVS log

Up to [Local Repository] / processmail

Cleaned up

    1: Итак, вашей команде надо дежурить в соревнованиях Интернет-клуба. Вы
    2: написали красивые вопросы, защитились от кверулянтов и апеллянтов, и
    3: готовитесь к приему ответов. Но вот проблема -- как справиться с
    4: десятками писем от команд-участниц?
    5: 
    6: Комплекс программ Интернет-Клуба ``Что? Где? Когда'' поможет вам.
    7: 
    8: 1. УСТАНОВКА И НАСТРОЙКА ПРОГРАММ
    9: 
   10: А. Зайдите на http://www.kulichki.com/znatoki/boris/processmail и
   11: возьмите либо processmail.zip, либо processmail.tgz. Распакуйте эти
   12: файлы на Вашм компьютере. Вы найдете:
   13: 
   14:  - README -- этот файл
   15:  - processmail.pl, createtable.pl, reminder.pl, collection.pl --
   16:      скрипты для обработки почты.
   17:  - subroutines.pl -- вспомогательный файл, используемый прочими
   18:      скриптами 
   19:  - parameters.pl -- файл, содержащий настраиваемые параметры программ
   20:  - process.tex, process.ps -- техническая документация к программам
   21:      (если Вы не собираетесь ``влезать вовнутрь'', Вам она не
   22:      понадобится )
   23: 
   24: Б. В каждом из файлов processmail.pl, createtable.pl, reminder.pl,
   25: collection.pl замените первую строку (#!/usr/local/bin/perl) на ссылку
   26: на положение перла в Вашей системе. Сделайте эти файлы выполняемыми (в
   27: Юниксе это делает chmod a+x *.pl)
   28: 
   29: В. Посмотрите внимательно файл parameters.pl. В нем Вы можете захотеть
   30: изменить ряд параметров:
   31:  
   32:  $fromaddress задает Ваш обратный адрес
   33:  $DK задает название Вашей команды
   34:  $date -- системная процедура, которая выдает московское время
   35:     (если Вы не можете его вычислить, напишите просто $date="";)
   36:  процедуры printheader и printfooter печатают заголовок Вашего
   37:    письма-напоминания на лист z-info
   38: 
   39: 2. РАБОТА С ПРОГРАММАМИ
   40: 
   41: А. Просмотрите каждое письмо с ответами -- соблюден ли в нем
   42: формат. Вот пример правильно оформленных ответов:
   43: *** "Марсиане", 343
   44: #1. Дедка
   45: #2. Бабка
   46: #3. Внучка
   47: #4. Жучка, кошка
   48: и мышка
   49: ***
   50: 
   51: ПОМНИТЕ: если команда прислала несколько писем, написание названия
   52: команды в них должно быть одинаковым.
   53: 
   54: Если у команды еще нет регистрационного номера, поле ``номер'' может
   55: быть пропущено. Программа присвоит такой команде регистрационный номер
   56: 0. Напомните капитану такой команды, чтобы он срочно связался с
   57: Секретарем клуба.
   58: 
   59: Б. Складывайте все ответы в один файл, например, answers. Если от
   60: команды пришло несколько писем, бросайте туда ВСЕ. Проверьте, что
   61: более поздние письма следуют за более ранними.
   62: 
   63: В. Время от времени запускайте 
   64: reminder.pl -m answers
   65: Это пошлет на лист z-info сводку о командах, чьи ответы получены. Но
   66: не злоупотребляйте сводками, дабы не рассердить Почтмейстера.
   67: 
   68: Г. Когда ответов скопится достаточно, запустите
   69: processmail.pl -m answers -o scores
   70: Тогда у Вас получится файл scores примерно такого типа:
   71: 
   72: #1. Frequency: 1. Score: ?
   73:   Хам
   74: #1. Frequency: 2. Score: ?
   75:   Bog
   76: ....
   77: 
   78: Замените "?" на "+" и "-" и запишите файл. Если придут новые письма,
   79: бросьте их все в тот же файл (НЕ УБИРАЯ СТАРЫХ!!!).  Команда
   80: processmail.pl -t scores -m answers -o scores
   81: добавит в файл scores ответы, которых Вы еще не оценили.
   82: 
   83: Примечания:
   84: -----------
   85: (1) Если файла scores еще не существует, команда
   86: processmail.pl -t scores -m answers -o scores
   87: выдает ошибку. Используйте
   88: processmail.pl  -m answers -o scores
   89: (2) НЕ используйте команду типа
   90: processmail.pl -t scores -m answers > scores
   91: Это приведет к уничтожению ваших старых оценок.
   92: 
   93: Д. Когда срок приема ответов истечет, ПРОВЕРЬТЕ ваши оценки. Неприятно
   94: наталкиваться на собственную небрежность, правда?
   95: 
   96: Команда
   97: createtable.pl -m answers -t scores -o table
   98: создаст файл table с таблицей результатов, а команда
   99: collection.pl -m answers -t scores -o collection
  100: создаст файл collecton с собранием сочинений.
  101: 
  102: Перед посылкой на общий лист просмотрите файлы еще раз -- а вдруг
  103: ошиблись Вы или я?
  104: 
  105: Вот и все!
  106: 
  107: 3. РАЗНЫЕ РАЗНОСТИ
  108: 
  109: В файле process.tex хранится техническая документация к
  110: программaм. Если Вы хотите разобраться, как именно работает система,
  111: этот файл для Вас.
  112: 
  113: Все программы позволяют при вызове указать ключ -d (debug). С этим
  114: ключом программы печатают массу всякой дополнительной информации --
  115: полезной и не очень...
  116: 
  117: 4. АВТОР
  118: 
  119: Борис Вейцман, boris@plmsc.psu.edu
  120: http://www.plmsc.psu.edu/~boris
  121: 
  122: Я благодарен Якову Зайдельману, Льву Горенштейну, Алексу Покрасу и
  123: Дмитрию Рубинштейну за помощь в разработке этой программы.
  124: 
  125: $Id: README,v 2.1 2005/01/24 03:19:57 boris Exp $