Return to README CVS log

Up to [Local Repository] / processmail

Annotation of processmail/README, revision 2.4

2.1       boris       1: Итак, вашей команде надо дежурить в соревнованиях Интернет-клуба. Вы
                      2: написали красивые вопросы, защитились от кверулянтов и апеллянтов, и
                      3: готовитесь к приему ответов. Но вот проблема -- как справиться с
                      4: десятками писем от команд-участниц?
                      5: 
                      6: Комплекс программ Интернет-Клуба ``Что? Где? Когда'' поможет вам.
                      7: 
                      8: 1. УСТАНОВКА И НАСТРОЙКА ПРОГРАММ
                      9: 
2.4     ! boris      10: А. Зайдите на http://internet.chgk.info/boris/processmail и
        !            11: скачайте файл processmail.tgz. Распакуйте этот
        !            12: файл на Вашм компьютере. Вы найдете:
2.1       boris      13: 
                     14:  - README -- этот файл
                     15:  - processmail.pl, createtable.pl, reminder.pl, collection.pl --
                     16:      скрипты для обработки почты.
                     17:  - subroutines.pl -- вспомогательный файл, используемый прочими
                     18:      скриптами 
                     19:  - parameters.pl -- файл, содержащий настраиваемые параметры программ
2.4     ! boris      20:  - process.tex, process.pdf -- техническая документация к программам
2.1       boris      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: изменить ряд параметров:
2.4     ! boris      31: 
        !            32: Вот эти параметры задать ОБЯЗАТЕЛЬНО:
2.1       boris      33:  
2.4     ! boris      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: 
2.1       boris      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: 
2.4     ! boris      69: Б. Складывайте все ответы на данный зачет в один файл, например,
        !            70: sprint.mail и stayer.mail. Если от команды пришло несколько писем,
        !            71: бросайте туда ВСЕ. Проверьте, что более поздние письма следуют за
        !            72: более ранними.
2.1       boris      73: 
                     74: В. Время от времени запускайте 
2.4     ! boris      75: reminder.pl -r номер_зачета  
        !            76: 
        !            77: Например,
        !            78: reminder.pl -r 1
        !            79: или
        !            80: reminder.pl -r 2
        !            81: 
2.1       boris      82: Это пошлет на лист z-info сводку о командах, чьи ответы получены. Но
                     83: не злоупотребляйте сводками, дабы не рассердить Почтмейстера.
                     84: 
                     85: Г. Когда ответов скопится достаточно, запустите
2.4     ! boris      86: processmail.pl  -o scores
2.1       boris      87: Тогда у Вас получится файл scores примерно такого типа:
                     88: 
                     89: #1. Frequency: 1. Score: ?
                     90:   Хам
                     91: #1. Frequency: 2. Score: ?
                     92:   Bog
                     93: ....
                     94: 
                     95: Замените "?" на "+" и "-" и запишите файл. Если придут новые письма,
                     96: бросьте их все в тот же файл (НЕ УБИРАЯ СТАРЫХ!!!).  Команда
2.4     ! boris      97: processmail.pl -t scores  -o scores
2.1       boris      98: добавит в файл scores ответы, которых Вы еще не оценили.
                     99: 
                    100: Примечания:
                    101: -----------
                    102: (1) Если файла scores еще не существует, команда
2.4     ! boris     103: processmail.pl -t scores  -o scores
2.1       boris     104: выдает ошибку. Используйте
2.4     ! boris     105: processmail.pl   -o scores
2.1       boris     106: (2) НЕ используйте команду типа
2.4     ! boris     107: processmail.pl -t scores > scores
2.1       boris     108: Это приведет к уничтожению ваших старых оценок.
                    109: 
                    110: Д. Когда срок приема ответов истечет, ПРОВЕРЬТЕ ваши оценки. Неприятно
                    111: наталкиваться на собственную небрежность, правда?
                    112: 
                    113: Команда
2.4     ! boris     114: createtable.pl  -t scores -o table
2.1       boris     115: создаст файл table с таблицей результатов, а команда
2.4     ! boris     116: collection.pl  -t scores -o collection
2.1       boris     117: создаст файл collecton с собранием сочинений.
                    118: 
2.2       boris     119: Если вопросов много, формат вывода команды createtable.pl может
                    120: оказаться неудобным.  В этом случае используйте формат
2.4     ! boris     121: createtable.pl -s  -t scores -o table
2.2       boris     122: Ключ -s (от Short) выводит ответы в "сжатом" формате.
                    123: 
                    124: 
2.1       boris     125: Перед посылкой на общий лист просмотрите файлы еще раз -- а вдруг
                    126: ошиблись Вы или я?
                    127: 
                    128: Вот и все!
                    129: 
                    130: 3. РАЗНЫЕ РАЗНОСТИ
                    131: 
                    132: В файле process.tex хранится техническая документация к
                    133: программaм. Если Вы хотите разобраться, как именно работает система,
                    134: этот файл для Вас.
                    135: 
                    136: Все программы позволяют при вызове указать ключ -d (debug). С этим
                    137: ключом программы печатают массу всякой дополнительной информации --
                    138: полезной и не очень...
                    139: 
                    140: 4. АВТОР
                    141: 
2.4     ! boris     142: Борис Вейцман, borisv@lk.net
2.1       boris     143: 
                    144: Я благодарен Якову Зайдельману, Льву Горенштейну, Алексу Покрасу и
                    145: Дмитрию Рубинштейну за помощь в разработке этой программы.
                    146: 
2.4     ! boris     147: $Id: README,v 2.3 2005/01/25 16:56:23 boris Exp $