Return to README CVS log

Up to [Local Repository] / processmail

Annotation of processmail/README, revision 2.3

2.1       boris       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: 
2.2       boris     102: Если вопросов много, формат вывода команды createtable.pl может
                    103: оказаться неудобным.  В этом случае используйте формат
                    104: createtable.pl -s -m answers -t scores -o table
                    105: Ключ -s (от Short) выводит ответы в "сжатом" формате.
                    106: 
                    107: В ИЧБ принят особый формат: он состоит из предварительного и основного
                    108: тура, причём при равенстве ответов в основном туре преимущество у
                    109: команды, у которой лучше результат в предварительном туре.  Для этого
                    110: формата работает специальная программа createtable2.pl.  Она
                    111: вызывается так:
2.3     ! boris     112: createtable2.pl -s -T scores1 -M answers1 -m answers -t scores -o table
2.2       boris     113: где scores1 и answers1 относятся к предварительному туру, а
                    114: scores и answers -- к основному.
                    115: 
2.1       boris     116: Перед посылкой на общий лист просмотрите файлы еще раз -- а вдруг
                    117: ошиблись Вы или я?
                    118: 
                    119: Вот и все!
                    120: 
                    121: 3. РАЗНЫЕ РАЗНОСТИ
                    122: 
                    123: В файле process.tex хранится техническая документация к
                    124: программaм. Если Вы хотите разобраться, как именно работает система,
                    125: этот файл для Вас.
                    126: 
                    127: Все программы позволяют при вызове указать ключ -d (debug). С этим
                    128: ключом программы печатают массу всякой дополнительной информации --
                    129: полезной и не очень...
                    130: 
                    131: 4. АВТОР
                    132: 
                    133: Борис Вейцман, boris@plmsc.psu.edu
                    134: http://www.plmsc.psu.edu/~boris
                    135: 
                    136: Я благодарен Якову Зайдельману, Льву Горенштейну, Алексу Покрасу и
                    137: Дмитрию Рубинштейну за помощь в разработке этой программы.
                    138: 
2.3     ! boris     139: $Id: README,v 2.2 2005/01/24 03:36:37 boris Exp $