Return to README CVS log

Up to [Local Repository] / processmail

Wrote readme

    1: Итак, вашей команде надо дежурить в соревнованиях Интернет-клуба. Вы
    2: написали красивые вопросы, защитились от кверулянтов и апеллянтов, и
    3: готовитесь к приему ответов. Но вот проблема -- как справиться с
    4: десятками писем от команд-участниц?
    5: 
    6: Комплекс программ Интернет-Клуба ``Что? Где? Когда'' поможет вам.
    7: 
    8: 1. УСТАНОВКА И НАСТРОЙКА ПРОГРАММ
    9: 
   10: А. Зайдите на http://internet.chgk.info/boris/processmail и
   11: скачайте файл 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.pdf -- техническая документация к программам
   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: Вот эти параметры задать ОБЯЗАТЕЛЬНО:
   33:  
   34:  $NAME[1] и $NAME[2] -- названия зачетов
   35:  $MINQUEST[1], $MAXQUEST[1],  $MINQUEST[2], $MAXQUEST[2] -- номера
   36:       первого и последнего вопросов в каждом зачете
   37:  $FILES[1], $FILES[2] -- названия файлов, куда вы складываете письма
   38:       с ответами в каждом зачете.  Э
   39: 
   40: Вот эти параметры нужны для программы reminder:
   41: 
   42:  $fromaddress задает Ваш обратный адрес
   43:  $DK задает название Вашей команды
   44:  $date -- системная процедура, которая выдает московское время
   45:     (если Вы не можете его вычислить, напишите просто $date="";)
   46:  процедуры printheader и printfooter печатают заголовок Вашего
   47:    письма-напоминания на лист z-info
   48: 
   49: 2. РАБОТА С ПРОГРАММАМИ
   50: 
   51: А. Просмотрите каждое письмо с ответами -- соблюден ли в нем
   52: формат. Вот пример правильно оформленных ответов:
   53: *** "Марсиане", 343
   54: #1. Дедка
   55: #2. Бабка
   56: #3. Внучка
   57: #4. Жучка, кошка
   58: и мышка
   59: ***
   60: 
   61: ПОМНИТЕ: если команда прислала несколько писем, написание названия
   62: команды в них должно быть одинаковым.
   63: 
   64: Если у команды еще нет регистрационного номера, поле ``номер'' может
   65: быть пропущено. Программа присвоит такой команде регистрационный номер
   66: 0. Напомните капитану такой команды, чтобы он срочно связался с
   67: Секретарем клуба.
   68: 
   69: Б. Складывайте все ответы на данный зачет в один файл, например,
   70: sprint.mail и stayer.mail. Если от команды пришло несколько писем,
   71: бросайте туда ВСЕ. Проверьте, что более поздние письма следуют за
   72: более ранними.
   73: 
   74: В. Время от времени запускайте 
   75: reminder.pl -r номер_зачета  
   76: 
   77: Например,
   78: reminder.pl -r 1
   79: или
   80: reminder.pl -r 2
   81: 
   82: Это пошлет на лист z-info сводку о командах, чьи ответы получены. Но
   83: не злоупотребляйте сводками, дабы не рассердить Почтмейстера.
   84: 
   85: Г. Когда ответов скопится достаточно, запустите
   86: processmail.pl  -o scores
   87: Тогда у Вас получится файл scores примерно такого типа:
   88: 
   89: #1. Frequency: 1. Score: ?
   90:   Хам
   91: #1. Frequency: 2. Score: ?
   92:   Bog
   93: ....
   94: 
   95: Замените "?" на "+" и "-" и запишите файл. Если придут новые письма,
   96: бросьте их все в тот же файл (НЕ УБИРАЯ СТАРЫХ!!!).  Команда
   97: processmail.pl -t scores  -o scores
   98: добавит в файл scores ответы, которых Вы еще не оценили.
   99: 
  100: Примечания:
  101: -----------
  102: (1) Если файла scores еще не существует, команда
  103: processmail.pl -t scores  -o scores
  104: выдает ошибку. Используйте
  105: processmail.pl   -o scores
  106: (2) НЕ используйте команду типа
  107: processmail.pl -t scores > scores
  108: Это приведет к уничтожению ваших старых оценок.
  109: 
  110: Д. Когда срок приема ответов истечет, ПРОВЕРЬТЕ ваши оценки. Неприятно
  111: наталкиваться на собственную небрежность, правда?
  112: 
  113: Команда
  114: createtable.pl  -t scores -o table
  115: создаст файл table с таблицей результатов, а команда
  116: collection.pl  -t scores -o collection
  117: создаст файл collecton с собранием сочинений.
  118: 
  119: Если вопросов много, формат вывода команды createtable.pl может
  120: оказаться неудобным.  В этом случае используйте формат
  121: createtable.pl -s  -t scores -o table
  122: Ключ -s (от Short) выводит ответы в "сжатом" формате.
  123: 
  124: 
  125: Перед посылкой на общий лист просмотрите файлы еще раз -- а вдруг
  126: ошиблись Вы или я?
  127: 
  128: Вот и все!
  129: 
  130: 3. РАЗНЫЕ РАЗНОСТИ
  131: 
  132: В файле process.tex хранится техническая документация к
  133: программaм. Если Вы хотите разобраться, как именно работает система,
  134: этот файл для Вас.
  135: 
  136: Все программы позволяют при вызове указать ключ -d (debug). С этим
  137: ключом программы печатают массу всякой дополнительной информации --
  138: полезной и не очень...
  139: 
  140: 4. АВТОР
  141: 
  142: Борис Вейцман, borisv@lk.net
  143: 
  144: Я благодарен Якову Зайдельману, Льву Горенштейну, Алексу Покрасу и
  145: Дмитрию Рубинштейну за помощь в разработке этой программы.
  146: 
  147: $Id: README,v 2.4 2005/02/20 03:24:43 boris Exp $