White Tiger
WWW Board система поддержки WWW-конференции
[English version here]
[Документация]
[Демонстрация]
[Тестирование]
[Обновление]
[Разработка]
Инструкция по переходу с ранних версий скриптов на версию 2.(x)b
находится здесь. Обязательно прочтите ее перед тем,
как обновлять программное обеспечение, иначе вы рискуете сделать форум временно
неработоспособным, а также утратить часть сообщений.
Демонстрационный форум на основе White Tiger WWW Board
с доступными функциями администрирования находится здесь
Содержание
- Введение
- Что здесь учтено?
- Возможности администрирования
- Технические требования
- Подготовка и установка программного обеспечения форума
- Сопровождающие файлы
- Обслуживание и администрация форума
- Авторские права и дистрибуция
- Благодарности
- Ответственность
- Internet и e-mail адрес разработчика
- Подключаемые модули (plug-ins)
- Подмеченные тонкости обслуживания, а также некоторые неофициальные моменты (FAQ)
- Изменения в версиях
- Что будет?
- Некоторые форумы, работающие на White Tiger WWW Board
- Последняя версия и ее download
1. Введение
Существует немало скриптов для организации работы WWW-конференции, они
широко и активно используются в Internet. Однако большинство из них
предоставляются на платной основе, не обеспечивая в то же время некоторые
очевидные моменты.
Данный программный продукт обеспечивает автоматизацию довольно широкого
круга действий в отношении файлов форума (включая автоматическую архивацию),
а кроме того, учитывает несколько характерных отличий русского литературного
стиля (как то: абзацный отступ, длинное тире, открывающие и закрывающие кавычки
и т.д.). Также возможна настройка некоторых параметров индивидуально для
каждого участника форума. Оформление форума можно полностью адаптировать к
дизайну вашего сайта. Подключаемые модули (plug-ins) позволяют производить
прочие действия, не предусмотренные самой программой.
White Tiger WWW Board лицам из России и стран бывшего СССР можно
использовать бесплатно, т.е. FREEWARE. В остальных случаях программа
имеет статус SHAREWARE, при этом функциональных ограничений не
предусматривается. Подробнее см. пункт Авторские права и дистрибуция.
2. Что здесь учтено?
Главные особенности форума, реализованного посредством White Tiger WWW
Board, следующие.
- Максимально оптимизирован код основной страницы, используется минимально
возможное количество технической информации. Также по возможности меньше места
занимает код самих сообщений.
- Поддерживается как классический стиль форума в виде иерархии сообщений
(иначе древовидной структуры), так и в виде списка основных тем
с автоматическим закрытием темы по истечении указанного срока.
- Учитывается абзацный отступ, принятый в российском книгопечатании.
Абзацы не отделяются друг от друга расстоянием (если это не оговорено
специально), а выделяются красной строкой. (Однако не все браузеры
поддерживают используемые теги <dd> и </dd> корректно. Некоторые просто
переводят текст на новую строку
аналогично тегу <br>, иногда сдвигают вправо весь абзац. Полностью
корректный документ получается в
браузерах Netscape Navigator 4.x,
Internet Explorer 4.x, частично
ранние их версии, а также прочие браузеры.) Имеется также возможность
изменить теги начала и конца абзаца.
- Создание сообщения происходит в специальной форме. Если это ответ,
то содержание предыдущего сообщения вставляется как цитата, причем знак
цитирования можно переопределить. Нежелательные посетители, указанные
в игнор-листе, информируются о том, что находятся
в режиме read-only, т. е. «только чтение». Отправить
сообщение на форум они не могут.
- Можно настроить форму ввода сообщения под каждого пользователя
скрыть поля ввода ссылок, предписать автоматическое подставление пароля; можно
также включить перенаправление после создания сообщения на это сообщение
либо на основную страницу.
- Если пользователь не ввел пароль, то ему еще раз предлагается ввести его,
набранный текст при этом не теряется.
- Во время ввода текста в окне при достижении правой границы предложение
автоматически продолжается на следующей строке, так что текст всегда
у вас перед глазами. На количество абзацев это не влияет.
- Дефисы, отбитые пробелами, и двойные дефисы автоматически преобразуются
в тире; этим, к сожалению, почти всегда пренебрегают на форумах и в Интернете
вообще, и очень часто даже в современном книгоиздании.
- Возможно также определить дополнительные элементы контекстной замены,
например замену нецензурных слов на что-нибудь нейтральное. При этом можно
использовать регулярные выражения (regexp).
- Ответное сообщение можно поместить в корень, что бывает полезным, когда
происходит длительное обсуждение какого-либо вопроса. Подобные сообщения
помечаются звездочкой перед названием (символ можно переопределить).
- Перед отправлением сообщения на форум можно посмотреть, как оно будет
выглядеть после публикования и при необходимости исправить некорректные моменты.
- Строка, добавляемая при генерации нового сообщения на основную страницу
форума, полностью настраивается. При этом можно использовать литерные названия
дней недели и месяцев, которые также настраиваются.
- Новые сообщения в течение какого-то времени могут быть помечены
специальным значком. Можно также запретить публикацию пустых сообщений, чтобы
не превращать форум в чат.
- Защищены используемые имена. При отправке сообщения требуется ввести
пароль. Если сообщение отправляется впервые, то новый участник форума вносится
в базу, и в дальнейшем указанным именем может пользоваться только он. Здесь
учтена вероятность подстановки схожих символов кириллицы и латиницы.
Комбинации наподобие и прочие, отображающиеся в браузере как
обычные символы, удаляются. Таким образом, подделать подпись этим путем не
представляется возможным.
- Адрес электронной почты сохраняется после первого ввода и в дальнейшем
подставляется автоматически. При желании его можно и изменить.
- Производится автоматическая подстановка имени и адреса e-mail
зарегистрированного пользователя. Используются два механизма: первый
по приоритету посылка/прием cookies; второй, при отсутствии или неудаче
первого, по IP-адресу пользователя (второй вариант не всегда работает
с клиентами крупных провайдеров, имеющими динамический адрес IP).
- При автоматической подстановке темы к названию предыдущего письма добавляется
«Re:», как признак ответа. При дальнейших ответах «Re:»
нумеруется по восходящей.
- Возможна индивидуальная настройка некоторых параметров для каждого
участника форума. Сюда входят:
- приветственная надпись сообщения;
- прощальная надпись сообщения;
- включение/выключение цитирования письма при ответе;
- включение/выключение использования cookies для данного участника;
- настройка извещений участника форума о новых сообщениях, появившихся
за время его отсутствия;
- настройка перенаправления браузера после создания сообщения;
- включение/выключение отображения полей для ввода ссылок в форме создания
сообщения;
- рекомендация автоматической подстановки пароля;
- настройка кнопок предпросмотра и сброса;
- другие настройки...
- Возможна архивация форума, то есть перенесение части файлов в другой
каталог. При этом архивы консервируются. Отвечать на них можно, но ответ
появится на рабочей основной странице как корневое сообщение, причем оно будет
отмечено двумя звездочками перед названием (символ можно переопределить; ответ
на сообщение из архива невозможен, если архивация происходит с одновременным
сжатием в файл формата zip или rar).
- Есть возможность объявить форум частным. В этом случае писать в него
могут только зарегистрированные участники. Регистрация же происходит не
автоматически, а производится одним из администраторов.
- Для особо срочных или важных сообщений, которые должны прочитать все, введена
«новостная строка» ограниченное временными рамками сообщение,
которое с заданными параметрами форматирования выводится между заголовком
и ссылкой на создание нового сообщения (по умолчанию, так как место вывода
можно изменить).
- Производится автоматическая замена встречающихся в сообщениях
последовательностей << и >> на кавычки « и »;
также возможна автоматическая замена смайликов на соответствующие рожицы из
шрифта Wingdings.
- Примитивные выделения наподобие *word*, _word_, __word__ автоматически
преобразуются в word, word, word. Так же можно выделять
и целые предложения. Ссылки в Internet и
адреса e-mail выделяются соответствующими тегами.
- Существует возможность поиска сообщений по заданному шаблону.
- Можно просмотреть список сообщений, появившихся на форуме после некоторой
даты, либо начиная с определенного номера.
- По статистике («Сервис») можно найти адрес e-mail нужного участника,
а также увидеть активность форума за последние пятнадцать дней.
- И многое другое...
Также необходимо упомянуть о следующих возможностях White Tiger WWW Board.
- Возможно создание нескольких форумов на основе одного комплекта скриптов.
- В качестве языка технических сообщений и информационных строк форума можно
использовать любой язык, необходим лишь соответствующий языковой ресурс,
представляющий собой обычный текстовый файл. В данный момент доступен
русский модуль. Языковые модули для поддержки форума на английском языке
находятся в работе.
- Существует достаточно гибкая возможность подключения дополнительных
скриптов для выполнения некоторых специфических действий, не предусмотренных
самой программой.
Выше перечислена только часть возможностей программы. Представление обо
всех функциях и режимах программы можно составить, просмотрев главу
«Изменения в версиях».
Демонстрационный вариант форума с доступными функциями администрирования
расположен здесь. Вы можете
испытать работу, прежде чем решите взять White Tiger WWW Board в качестве
основы для своего форума. Там же вы можете задать вопросы, касающиеся настройки
скриптов.
3. Возможности администрирования
White Tiger WWW Board предоставляет широкие возможности
администрирования форума.
- Изменение «на лету» названия, цветового оформления, шапки и
нижней части основной страницы, самих сообщений, форм и прочих динамических
страниц, генерируемых при работе форума.
- Изменение списка администраторов с варьированием их прав.
- Изменение статуса форума (частный/общедоступный).
- Изменение адреса e-mail администратора.
- Изменение тегов начала и конца абзаца.
- Изменение символа признака цитирования.
- Изменение способа выделения цитируемого фрагмента.
- Изменение признака ответа в цитированной теме.
- Глобальное включение/выключение цитирования сообщения при ответе.
- Удаление, преобразование в текст, частичное преобразование или
игнорирование тегов, имеющихся в теле сообщения.
- Определение расширения файлов сообщений.
- Глобальное включение/выключение идентификации участника форума при помощи cookie.
- Включение/выключение вторичной идентификации участника форума на основании IP-адреса.
- Включение/выключение возможности индивидуальной настройки для каждого участника форума.
- Включение/выключение подстановки размера сообщения в основной лист форума.
- Включение/выключение подстановки IP-адреса отправителя сообщения.
- Определение параметров и элементов выводимой статистики.
- Изменение списка участников форума, их паролей, адресов e-mail и прав
доступа при необходимости.
- Изменение списка игнорируемых хостов (по цифровому IP-адресу) и игнорируемых
имен (также с использованием cookie) с возможностью приведения причины игнорирования.
- Просмотр статистики ошибочных или несанкционированных входов на форум и
в административную часть.
- Редактирование строк файла индекса.
- Удаление ссылок на выбранные сообщения с основной страницы.
- Удаление файлов сообщений и ссылок на них. Бывает
полезно, когда на форум забредает какой-нибудь хулиган. Можно также использовать
для удаления различных тестовых сообщений.
- Архивация форума с сохранением архива в другом каталоге.
- Архивация форума с компрессией в файл формата zip.
- Архивация форума с удалением архива.
- Автоматическая архивация всеми перечисленными методами.
- Автоматические регистрация архивов и извещение участников форума о
создании архива.
- Добавление новостных строчек с различными параметрами отображения.
- Операции по восстановлению утраченного или поврежденного листа форума:
- с учетом структуры (необходим дополнительный файл, генерируемый при работе
форума параллельно с основным листом, но занимающий гораздо меньше места);
- только на основе имеющихся сообщений.
- И многое другое...
4. Технические требования
Для работы форума на сервере должна иметься поддержка языка Perl версии
5.005_03 или позже (на более ранних работать скорее всего тоже будет, но не гарантированно).
Крайне желательна поддержка SSI (Server Side Includes) для возможности отображения
«новостной строки» и полноценной работы сервисных функций.
Если поддержка возможна, но не включена, попросите
администратора сервера включить ее.
Оптимальным для размещения форума является вариант с Linux/Unix и установленным
web-сервером Apache со включенной поддержкой SSI.
Хотя форум работоспособен и под Windows NT, однако
эта система не всегда корректно поддерживает SSI.
Программа разрабатывалась на P-200MMX/64 (в данный момент
K6-2-300/64) под Windows 95 с установленными Perl
for Windows 95, version 5.003_07 (в данный момент
ActivePerl version 5.005_03
build 518), Netscape Navigator 3.x
и 4.x, а также TinyWeb 1.6
и Small HTTP server 1.2
by Max Feoktistov (в данный
момент версия 1.215).
Отладка производилась на сервере с установленными OS Linux,
Apache 1.3.3. Достоверно известно, что форум
нормально функционирует на FreeBSD/NCSA и Windows NT/MS IIS.
Желающие первоначально проверить работу форума у себя на компьютере, могут
воспользоваться инструкцией, расположенной здесь.
Работает также демонстрационная версия форума.
5. Подготовка и установка программного обеспечения форума
Сразу определитесь, на каком языке будет функционировать ваш форум. Файлы
данного дистрибутива ориентированы на работу форума на русском
языке. Английская версия дистрибутива в настоящее время находится в работе.
Впрочем, если вы не собираетесь ждать, можете перевести файлы ресурсов на
английский или любой другой язык самостоятельно. Разработчик готов дать
консультации, если будет такая необходимость.
Все настройки соответствуют расположению и названиям файлов
в дистрибутивном архиве. Параметры по умолчанию определяют работу одного
форума. Форум уже в изначальном варианте вполне работоспособен.
Мы, однако, настоятельно рекомендуем заменить названия некоторых
файлов на другие, чтобы тем самым исключить
возможность взлома форума злоумышленником, знакомым с этими скриптами.
Ниже перечислены файлы, названия которых надо изменить.
- wtbini.txt файл, содержащий названия файлов для каждого форума
- wtboard.txt название файла настроек и параметров форума
- wtbaccess.txt название файла игнорируемых хостов
- wtbadmin.txt название файла с именами и паролями администраторов
- wtbnames.txt название файла с именами и паролями участников
- wtbnews.txt название файла, содержащего новостные строки
- wtbreplace.txt название файла с фрагментами для контекстной
замены вхождений в сообщениях, названиях и именах
- wtwrong.txt название log-файла подозрительных вхождений
и записи регистрации
- wtblast.txt название файла со счетчиком сообщений
- wtblang.txt название файла с языковым модулем
- wtbstruct.txt название файла для структуры основного листа
Имена этих файлов перечислены в файле <wtbini.txt>, их следует
поправить только в нем. В файле <wtbext.cgi>
(в самом начале) необходимо изменить название файла wtbini.txt и, возможно,
каталога data.
Далее нужные значения подставляются автоматически.
Возможно также поменять названия основных скриптов wtboard.cgi и
wtbedit.cgi, но тогда необходимо соответственно заменить все вхождения
в этих и прочих файлах на новые. (В целом этого делать не рекомендуется.)
Далее впишите в файл <wtbadmin.txt> строку главного администратора
для возможности администрирования форума. Формат строки следующий:
name;;password;;a
Здесь «a» все привилегии. Более подробная
информация о привилегиях сообщается при администрировании.
Рекомендуем подробно изучить файл <wtboard.txt>. В нем хранятся основные
настройки форума, которые изменять нужно исключительно осторожно.
Произведите необходимые, по вашему мнению, замены в файле index.shtml,
не забывая при этом, что шапка и нижняя часть должны занимать по одной строчке,
не важно, сколько информации они при этом содержат. Исправьте все пути к
скриптам и файлам на действительные.
ВНИМАНИЕ! Для модификации файла
index.shtml не пользуйтесь специализированными HTML-редакторами, они могут
внести изменения в структуру файла, что крайне негативно отразится на работе
форума. Изменения лучше производить простым текстовым редактором наподобие
Notepad, Aditor, встроенного редактора оболочки
Far Manager и т. д.
Также посмотрите файлы faq.htm, который содержит примерный свод правил
поведения на форуме; service.shtml, содержащий формы сервисных функций; и
archive.htm, предназначенный для регистрации архивов форума,
и сделайте в них необходимые исправления.
5.1. Модификация путей
Проверьте соответствие каталогов названиям и путям, указанным в пунктах
dirkonf, dirrealkonf, dircgi и realpath файла <wtboard.txt>. Здесь:
- dirkonf путь к каталогу форума, каким его видит браузер
- dirrealkonf путь к каталогу форума, каким его видит сервер у себя
на винчестере
- dircgi путь к каталогу скриптов, каким его видит браузер
- realpath путь к каталогу, в котором расположены директории форума;
к примеру, если dirrealkonf=../wtboard, то realpath=..
- dirarc название каталога, в который будет производиться
автоматическая архивация
Возможно использовать как относительные пути, так и абсолютные. То есть
вы можете в dirkonf написать и http://www.yourhost.com/wtboard, и просто
../wtboard (иногда возникают проблемы,
они обычно решаются выбором второго варианта вместо первого либо наоборот).
Соответственно и в dirrealkonf можно написать как /www/user/root/forum/wtboard, так и ../wtboard.
В файле <wtbext.cgi>
найдите переменную $data, содержащую путь к каталогу с файлами
данных: ../data и при необходимости измените
ее значение.
Обратите внимание: слеш (значок «/») после названия
во всех случаях ставить не нужно.
Перекодируйте файлы в соответствующую используемой вашим сервером
кодировку кириллических символов WinCP-1251, KOI-8, Alt866, Mac или ISO 8859-5
(первоначальная кодировка скриптов CP-1251). Вместе со скриптами поставляется
файл .htaccess, настроенный на CP-1251, и, возможно, при его использовании вам
не нужно будет производить каких бы то ни было дополнительных перекодировок.
Обратите внимание: на некоторых серверах использования файла .htaccess может
вызвать сбой работы скриптов. В таком случае удалите его и отключите в настройках
форума автоматическое создание этого файла.
5.2. Настройка файла <wtbreplace.txt>
Есть возможность замены ряда слов, встречающихся в сообщениях,
на другой, определенный вами набор символов. Список замены определяется в файле
<wtbreplace.txt> и является следующим форматным:
xxx;;yyy
где xxx строка, подлежащая замене, yyy
заменяющая строка. Таким образом,
вы можете указать ряд нежелательных слов на вашем форуме и их замену на нечто
типа [beep], [skipped], ..., [censored], (нецензурно), (пропущено из-за
недостаточной информативности), [---] или в том же духе. Имейте при этом в
виду, что многие нецензурные слова могут являться составной частью слов вполне
культурных (велик, блин, и могуч русский язык).
Кстати, преобразование дефиса, разделенного пробелами, в тире также
определено в файле <wtbreplace.txt>.
Возможно управление заменой с помощью специальных символов. Таковых
несколько: # @ * ; ! % < > \.
Их предназначение в следующем:
# предписывает производить замену только в заголовке (теме)
сообщений;
@ предписывает производить замену
только в теле сообщения;
* предписывает производить замену
и в теле сообщения, и в заголовке (значение по умолчанию, подразумевается при
отсутствии всяких ключей);
; строка комментария;
% рекомендует рассматривать
шаблон поиска как регулярное выражение, по умолчанию отключен;
! позволяет участнику форума
отключить данный элемент контекстной замены для своих сообщений;
< предписывает производить
замену только при генерации формы ответа в цитируемом тексте;
> предписывает производить замену только при приеме сообщения
на сервере;
\ применим в первой позиции в том
случае, если нужно заменять фрагмент, содержащий один из перечисленных
спецсимволов.
Управляющих символов может быть не более пяти, например: #%!>XXX;;YYY производить замену XXX на YYY
только в заголовках только при приеме сообщения на сервере, при этом XXX
рассматривать как регулярное выражение, плюс участник форума может отключить
в своих сообщениях такую замену; \*ONE;;+TWO всегда заменять *ONE на +TWO. При
этом символы #, @ и *, если они есть, должны быть в начале, после них может
следовать рекомендация %, и лишь потом указатели направления < и >.
5.3. Настройка многофорумности
Организация работы на одном комплекте скриптов не представляет особой
сложности. Можно, конечно, полностью разделить форумы и сделать их независмыми,
но тогда придется каждый раз при обновлении программы заменять все обновившиеся
файлы по нескольку раз. Зачем, если можно сделать это единожды для всех форумов
сразу?
Для поддержки многофорумности необходимо внести изменения в файл <wtbini.txt>.
Структура файла <wtbini.txt>:
ID;file1;file2;file3;...;fileN;
Здесь ID идентификационный номер
форума (при работе единственного форума рекомендуется идентификатор 0,
тогда идентификатор fid не будет обязательным),
file1, file2
и т. д. названия файлов данных в следующей последовательности:
- <wtbaccess.txt>
- <wtbadmin.txt>
- <wtblang.txt>
- <wtblast.txt>
- <wtbnames.txt>
- <wtbnews.txt>
- <wtboard.txt>
- <wtbreplace.txt>
- <wtbstruct.txt>
- <wtwrong.txt>
Точка с запятой является обязательным символом-разделителем названий файлов.
Пробелов быть не должно. Проставляются только названия файлов, без ограничивающих
скобок.
Для создания второго, третьего и т. д. форума на основе скриптов сделайте
в файле <wtbini.txt> новую строчку, в которой в соответствии с форматом
запишите идентификатор форума и названия файлов его данных. Будьте
внимательны: файлы данных разных форумов не должны иметь одинаковые
названия, форумы должны располагаться в разных каталогах и архивироваться
в разные директории. Настройки форумов производите соответственно
указанным в файлах данным.
(Вообще, реально должны отличаться файлы <wtboard.txt>,
<wtblast.txt>, <wtbnews.txt>, <wtbstruct.txt>. Они строго
индивидуальны. Прочие же файлы можно сделать общими, тогда их указания будут
распространяться на все форумы, работающие под управлением этого набора скриптов.)
В файлах index.shtml, service.shtml, wtbadmin.htm и <wtboard.txt>
второго, третьего и т. д. форумов произведите глобальную замену идентификатора,
находящегося после фрагмента fid=,
на текущий.
Каталог <dirarc> для каждого форума должен быть разным, иначе
возможна потеря данных.
5.4. Установка
Для установки форума в рабочее состояние закачайте файлы соответственно
по каталогам на сервер. Для этого рекомендуем воспользоваться любым FTP-клиентом,
например CuteFTP. Если же вы предпочитаете
работать через telnet или каким-то еще подобным образом, то не забывайте,
что, чтобы файлы корректно понимались
сервером на базе Unix-подобной операционной системы, необходимо привести их
в соответствующий вид. Скорее всего, для этого потребуется выполнить команду
dos2ux (или dos2unix) с соответствующими параметрами.
Передача файлов с помощью FTP-клиента должна осуществляться в режиме ASCII.
Тогда необходимые замены DOS ® *x производятся FTP-клиентом.
Хотя файлы дистрибутива по умолчанию поставляются с уже конвертированными
концами строк, редактор, которым вы воспользовались для изменения некоторых файлов,
мог восстановить их в стандартный формат DOS.
Названия каталогов должны быть набраны строчными
буквами, так как во многих операционных системах строчные и прописные буквы
различаются. Далее сделайте файлы <wtboard.cgi>, <wtbedit.cgi>,
<wtbservice.cgi>, <wtbext.cgi>, а также service.shtml и
index.shtml (в каталоге wtboard) исполнимыми то есть присвойте им атрибуты
читаемости и исполнимости (файлу index.shtml также и атрибут
записываемости). Все файлы в каталоге data необходимо сделать читаемыми и
записываемыми. Каталоги <data> и <wtboard> также должны быть
доступны для чтения и записи. Все остальное можно оставить так, как есть.
Минимально требуемый и максимально безопасный набор атрибутов
rwxr-xr-x или, в восьмеричном представлении, 755. В случае, если при
таких установках форум не работает должным образом, установите все права
доступа и проверьте результат. Если все нормально, то можно неторопливо, снимая
по атрибуту с файлов и каталогов, выявить необходимый минимум. Абсолютно полный
доступ ставить все-таки не рекомендуется в целях безопасности форума.
Ниже представлена таблица, демонстрирующая, каким образом примерно
должен отображать ваш ftp-клиент содержимое каталогов на сервере.
Файл или каталог | Права доступа |
archive | drwxr-xr-x |
.htaccess | r--r--r-- |
index.htm | rw-r--r-- |
cgi-bin | drwxr-xr-x |
index.htm | rw-r--r-- |
wtbedit.cgi | rwxr-xr-x |
wtbext.cgi | rwxr-xr-x |
wtboard.cgi | rwxr-xr-x |
wtbservice.cgi | rwxr-xr-x |
wtbupdate.cgi | rwxr-xr-x |
data | drwxr-xr-x |
.htaccess | r--r--r-- |
index.htm | rw-r--r-- |
wtbaccess.txt | rw-r--r-- |
wtbadmin.txt | rw-r--r-- |
wtbini.txt | rw-r--r-- |
wtblang.txt | rw-r--r-- |
wtblast.txt | rw-r--r-- |
wtbnames.txt | rw-r--r-- |
wtbnews.txt | rw-r--r-- |
wtboard.txt | rw-r--r-- |
wtbreplace.txt | rw-r--r-- |
wtbstruct.txt | rw-r--r-- |
wtwrong.txt | rw-r--r-- |
wtboard | drwxr-xr-x |
.htaccess | r--r--r-- |
archive.htm | rw-r--r-- |
faq.htm | rw-r--r-- |
wtbadmin.htm | rw-r--r-- |
index.shtml | rwxr-xr-x |
service.shtml | rwxr-xr-x |
В зависимости от настроек сервера файл .htaccess может быть невидим.
Сделайте несколько тестовых сообщений, желательно создать разветвленное
дерево. После этого проверьте администрирование по всем актуальным в данный
момент пунктам. Если все
работает, значит, вы успешно установили программное обеспечение форума. Если
же что-то не ладится, проверьте еще раз произведенные вами замены: не
пропустили ли вы чего-нибудь. (Возможно, необходимая информация найдется в
пункте «Подмеченные тонкости обслуживания, а также некоторые
неофициальные моменты».)
Желательно, чтобы при подготовке файлов вы не удаляли следующую строку:
© 1998-2000, <a href=http://wtiger.ncport.ru>White Tiger</a>.
Хотя ее отсутствие ничему не повредит, оставив ее, вы тем самым проявите
уважение к затраченному времени и труду разработчика.
6. Сопровождающие файлы
Полный список поставляемых файлов:
- .htaccess файл объявления кодировки (работает в
Apache).
- register.txt файл с регистрационной карточкой пользователя программы.
- file_id.diz краткий файл-описание.
- read.me логотип и информация.
- wtboard/index.shtml файл основной страницы, сделанный в соответствии с SSI для
возможности отображения новостной строки. Внимание: новостная строка работает
не на всех серверах.
- wtboard/service.shtml файл со ссылками и формами сервисных служб форума, сделанный
в соответствии с SSI. Внимание: перед установкой форума файл требуется отредактировать
согласно инструкциям внутри него.
- wtboard/wtbadmin.htm файл входа администраторов.
- wtboard/faq.htm файл примера правил. В большинстве случаев нужно только
немного изменить его, после чего можно применять в форуме.
- wtboard/archive.htm файл регистрации архивов. Формат свободный,
однако необходимо учесть, что регистрация всегда вносится в четвертую строку
файла, одновременно сдвигаются последующие строки.
- archive/index.htm основной файл каталога архивов, отсылает запрос
к файлу wtboard/archive.htm.
- cgi-bin/wtboard.cgi модуль обеспечения работы форума.
- cgi-bin/wtbedit.cgi модуль администрирования форума.
- cgi-bin/wtbservice.cgi модуль обеспечения сервисных функций.
- cgi-bin/wtbext.cgi модуль внутренних подпрограмм.
- cgi-bin/wtbupdate.cgi модуль обновления конфигурационного файла.
- data/wtbaccess.txt конфигурационный файл со списком игнорирования.
- data/wtbadmin.txt конфигурационный файл со списком административных доступов.
- data/wtbini.txt общий конфигурационный файл со списком названий прочих файлов.
- data/wtblang.txt языковой модуль.
- data/wtblast.txt файл, определяющий нумерацию сообщений.
- data/wtbnames.txt файл с именами и настройками участников форума.
- data/wtbnews.txt файл новостных строк.
- data/wtboard.txt основной конфигурационный файл форума, содержащий все настройки и переменные.
- data/wtbreplace.txt файл со списком контекстной замены.
- data/wtbstruct.txt файл со структурой сообщений форума.
- data/wtwrong.txt файл для записи критических событий форума.
- docs/wtb2new.htm документация по переходу на новые версии программы.
- docs/wtboard.htm полная документация по настройке и установке программного обеспечения форума.
- docs/wtboardhome.htm инструкция по установке программного обеспечения форума на локальный компьютер под управлением Windows 95/98/NT.
- docs/wtboardplugs.htm информация для разработчика о внешних модулях программы.
- docs/wtbdev.cgi модуль вывода всех внутренних параметров (для разработчика).
- */index.htm присутствует в каждом каталоге (кроме wtboard и docs), отсылает запрос
в каталог wtboard.
7. Обслуживание и администрация форума
После корректной установки форум способен неопределенно долгое время
находиться в работоспособном состоянии без каких-либо дополнительных
усилий со стороны держателя форума. Однако сбои все-таки возможны по
различным причинам, например, исчерпался лимит места на диске, либо
администрация сервера проводила широкомасштабные эксперименты по настройке
серверного софта, в результате чего произошли незначительные изменения,
в частности, сшибло все признаки исполнимости файлов. Или же
общение на форуме стало затруднительным по причине значительных размеров
основной страницы и, как следствие, продолжительности ее обработки
скриптом. Кроме того, на публичном форуме могут происходить неприятности,
связанные с несовершенством человеческой нравственности. Поэтому
администратор должен иногда проверять работу форума и при необходимости
вносить определенные коррективы.
Ниже представлено краткое руководство администратора с некоторыми
рекомендациями. Конкретные указания и описания параметров администрирования
даются в непосредственных примечаниях к ним.
7.1. Текущая администрация
Текущая администрация форума подразумевает периодическую проверку
состояния основной страницы и работоспособности скриптов. Время от времени
возможны сообщения об ошибках со стороны сервера, в таком случае вам придется
войти на него ftp- или telnet-клиентом и восстановить необходимые права
доступа к файлам. Обычно это помогает. Если же нет придется искать
другие причины и устранять их.
Общение на форумах периодически оживляется появлением натуралистически
настроенных субъектов, знающих два-три слова неформального русского языка
и вовсю эти слова использующих в различных падежах и неожиданными способами.
Задачей администратора является пресечение подобных явлений и, возможно,
предотвращение их в дальнейшем. WTBoard предоставляет для этого несколько
различных инструментов.
а). Вы можете воспользоваться сервисом удаления сообщений. Для этого
необходимо войти в раздел администрирования форума через страницу wtbadmin.htm.
Вам предлагается меню, доступ в пункты которого ограничен правами
администратора (минимум прав указан в скобках верхним индексом). Необходимо
выбрать пункт «Модерирование: удаление сообщений». Обратите внимание,
что вам доступны широкие возможности модерирования: удаление сообщений по
номерам, по темам и по участникам, причем в третьем случае можно сразу
поместить такого-то участника в список игнорирования.
б). Ограничить доступ определенных участников к общению можно средствами
списка игнорирования. Раздел «Модерирование: изменение списка участников,
игнор-лист» позволяет осуществить такое действие. Участник в списке
игнорирования может быть представлен либо IP-адресом, либо IP-адресом,
урезанным на последнюю цифру, либо идентификатором. Идентификатор участника
символьный параметр, представляющий собой его имя или псевдоним на
форуме, модифицированный на предмет схожести букв латинского алфавита и
кириллицы. Идентификатор участника можно выяснить в списке участников, это
первый элемент учетной записи. Перед идентификатором или IP-адресом нужно
поставить минус для определения режима «read-only» или восклицательный
знак для полного прекращения доступа. Имейте в виду, что игнорирование по
IP-адресу может отсечь ряд других пользователей, входящих на форум с того
же провайдера или через тот же прокси-сервер. Поэтому данной опцией
следует пользоваться осмотрительно.
в). Возможно осуществлять фильтрацию входящих сообщений по некоторым
заданным словам. Мониторинг включается в разделе «Основные параметры:
обработка сообщения».
Следует заметить, что при удалении сообщения может произойти сбой. Это
маловероятно, однако определенная вероятность существует. В таком случае
нужно войти в раздел «Параметры самообслуживания: сервис восстановления
Index» и попытаться восстановить основную страницу с использованием
структуры. При этой команде скрипт использует информацию о древовидной структуре
форума из дополнительной базы, что позволяет ему полностью восстановить
основную страницу с учетом ответов, пересенных в корень.
В некоторых случаях файл структуры может быть поврежден. Тогда придется
восстановить форум с потерей структуры. При этом будут просканированы
все сообщения в указанном диапазоне номеров, и на основе полученной информации
сгенерирован файл, в котором перенос ответов в корень окажется утерянным.
Однако данный способ восстановления основывается только на файлах
сообщений и никакой дополнительной информации не требует. Обратите внимание,
что имя файла можно указать отличным от задаваемого по умолчанию, что бывает
иногда полезным.
После восстановления форума только на основе сообщений рекомендуется
сгенерировать структуру, чтобы в дальнейшем было возможным полное
восстановление.
Еще один полезный сервис редактирование. Оно разделено на
редактирование строк основной страницы и собственно заданных файлов. Строки
основной страницы вынесены отдельно по очевидной причине частого ее изменения.
Имя файла можно указать любое, при условии что файл находится в каталоге,
определенном параметром dirrealkonf. Это все файлы сообщений, faq.htm,
wtbadmin.htm, service.shtml, archive.htm, еще какие-то файлы, которые вы могли
положить в каталог. Файлы в других каталогах как вышестоящих, так и
вложенных к редактированию не принимаются по соображениям безопасности.
7.2. Архивирование и параметры самообслуживания
Отдельного обсуждения требует архивация и самообслуживание форума.
На данный момент самообслуживание форума реализовано только в части
автоматической архивации. В перспективе предполагается разработка механизмов
автомодерирования, автомониторинга, автовосстановления, периодического
самотестирования.
Длительная работа форума обычно приводит к увеличению размеров основной
страницы. В конце концов ее загрузка и отображение могут стать весьма
затруднительными. В таком случае необходимо прибегнуть к архивации форума
значительному сокращению основной страницы за счет перенесения части
устаревших сообщений в другой каталог и соответствующего усечения индексного
файла.
Раздел администрирования «Параметры самообслуживания: архивация форума
и установки автоархивации» позволяет осуществить все необходимые действия
по архивации форума. Он состоит из двух частей: текущая архивация и параметры
автоматической архивации. Величины, определенные во второй части, сохраняются
в файле <wtboard.txt> для дальнейшего применения, определенные же в части
первой используются только один раз.
Указав в первой части параметры и отослав их скрипту, вы тем самым дадите
ему команду немедленно попытаться заархивировать форум. Если все величины
корректны, со стороны сервера отказов нету, то будут осуществлены
соответствующие изменения. Основная страница будет сокращена, и дополнительно
станет доступна страница архива.
Автоматическая архивация предполагает периодическую проверку форума
на достижение некоторых критериев (количества сообщений либо дней) и при
реализации одного из них запуск архивации. При этом установка параметров,
которые вы указывали в текущей архивации, производится самим скриптом, после
чего вызывается стандартная подпрограмма архивации. Так что автоматическая
архивация отличается от текущей только самостоятельным определением значений.
Разумеется, автоматическую архивацию можно отключить.
В WTBoard предусмотрено несколько вариантов архивирования.
а). Обычный, при этом файлы и индекс переносятся в другой каталог,
на сообщения архива можно отвечать на основной странице, и ответы помечаются
специальным значком.
б). Сжатие в zip перенос файлов и индекса в другой каталог с
последующей компрессией их стандартным алгоритмом zip. При этом используется
внешний архиватор zip, реализация которого
есть практически под любую платформу.
в). Сжатие в rar аналогично б), но сжатие производится архиватором
Rar. Реализации Rar также существуют под
значительное количество платформ, однако на вашем сервер он может отсутствовать.
Тогда сжатия просто-напросто не произойдет, и архивация останется на уровне а).
Если Rar имеется, то это наиболее оптимальный вариант, поскольку выигрыш
относительно zip составляет до десяти раз, не говоря уже об обычной архивации.
г). Удаление говорит само за себя.
Более подробные комментарии к каждому параметру архивации можно прочитать
в соответствующем разделе администрирования.
8. Авторские права и дистрибуция
Авторские права на программное обеспечение форума принадлежат White Tiger
(Copyright © 1998-2000, White Tiger) и защищены Законом об авторских правах.
Использование скриптов бесплатно на территории России и стран бывшего СССР.
Для регистрации в соответствующем пункте административного раздела укажите
следующий параметр («RUWTB»):
Russian user of White Tiger WWW Board//WTH7LyGpAUp0M
Если вы хотите получить индивидуальную регистрацию, потребуется оплата. Сумма
невелика, причем в каждом конкретном случае может быть оговорена особо. Для
этого свяжитесь с разработчиком.
Использование скриптов с уведомлением об этом факте разработчика при
условии использования лицензии «RUWTB» разрешается
и приветствуется. Использование скриптов без ведома разработчика при условии
использования лицензии «RUWTB» разрешается, но не приветствуется.
Коммерческое использование скриптов без ведома разработчика не разрешается и не
приветствуется ни под каким видом.
Если вы хотите распространять данный продукт и делать это бесплатно
на территории России под лицензией «RUWTB», никаких возражений
не имеется, но желательно уведомление об этом разработчика. Если вы хотите
распространять либо использовать его КОММЕРЧЕСКИ, в том числе и на
территории России, свяжитесь с разработчиком
по e-mail, данный вопрос требует непосредственного обсуждения.
Функциональных ограничений в незарегистрированной версии White Tiger WWW
Board нет. Информация о регистрации выводится на экране «About»
программы, вызываемом посредством запуска скриптов wtboard.cgi или wtbservice.cgi
с ключами fid=FID&about, либо через
Сервис/О программном обеспечении.
О модификации скриптов см. пункт «Ответственность».
9. Благодарности
Разработчик выражает признательность существовавшему некогда сайту
«Русская Доктрина», «Правила поведения» на форуме которого
позаимствованы при составлении примерного свода рекомендуемых манер (faq.htm).
Непосредственным преемником этого сайта является
Rossia.org,
форум которого в настоящее время
работает на основе White Tiger WWW Board. Также спасибо
Константину Крылову, основателю
и администратору сайтов «Русская Доктрина», Rossia.org и
«Традиция», общение
с которым подвигло разработчика на создание скриптов. Искренняя признательность
Лилии Шишикиной, хозяйке сайта Юрия Никитина,
в результате двух лет общения на форуме которого
Корчме были выявлены и
обдуманы некоторые проблемы функционирования интернет-конференций. Отдельная благодарность
компании Newcom Port, на сервере которой
происходит окончательная отладка программ. Администрация этого сервера имеет исключительное
право на бесплатное или коммерческое распространение и использование данного
программного обеспечения форума.
Громадная благодарность выражается автору программы
Small HTTP server Максиму
Феоктистову за это гениальное произведение программистского искусства,
потрясающе функциональное при столь малом размере, а также реализацию в нем
некоторых пожеланий.
10. Ответственность
Разработчик дает некоторую гарантию на работоспособность программного
обеспечения. Почти все версии White Tiger WWW Board имеют окончание «b»,
что значит «beta-версия». Это не признак недостаточной доработки
программы, просто разработчик придерживается несколько иного, нежели многие другие
программисты, мнения. Ни одна программа, если она способна обеспечивать
сколь-нибудь широкий круг действий, не может быть лишена ошибок. Поэтому
релиз White Tiger WWW Board, скорее всего, не выйдет никогда.
Также дается полная гарантия на то, что скрипты не содержат
«троянских» фрагментов, способных вывести сервер из строя или нарушить
безопасность системы. Все возможные сбои системы целиком обусловлены конкретной
настройкой программного обеспечения сервера. Доказательством тому служит
бесперебойное функционирование нескольких форумов в течение многих месяцев.
Никакая информация с сервера ни по каким адресам не распространяется и
не высылается, и высылаться не будет, за исключением проверки регистрационной
информации форума на сайте White Tiger.
При желании вы можете проверить это утверждение, текст скриптов вполне
разборчив. ;-) (Просьба не вносить предложения о почтовых или каких-то иных
рассылках, при необходимости вы можете организовать для этого внешний
модуль.)
Разработчик не несет ответственности за неразумные действия пользователя
с правами администратора форума, приведшие к неисправностям в работе форума.
Административная часть программы выполнена с предположением, что администратор
более или менее разбирается в языке HTML и способен указать верные параметры,
не нарушающие работу форума и/или скриптов, а также не будет стремиться сделать
это специально. Предполагается также, что администратор способен
читать поясняющие надписи и примечания и поступать в соответствии с их
содержанием. Большая гибкость настройки форума, к сожалению, имеет и
неприятную сторону становится легче определить неверный html-код,
который приведет к неправильному отображению страниц. (Сказанное не относится
к основному и сервисному скриптам программы, они разработаны с учетом возможных
попыток недоброжелателей повредить форум.) Поэтому рекомендуется
первоначально не отходить далеко от поставляемых в комплекте конфигурационных
файлов. При определенном опыте, разумеется, вносить некритические изменения
будет проще.
Допускается модификация скриптов под конкретные параметры сервера. Однако
этим самым снимается гарантия совместимости следующих версий программы с
модифицированной. Модифицированный вариант White Tiger WWW Board ни под каким
видом не может распространяться наравне со стандартным. В то же
время, возможно внести
ваши изменения в стандартный вариант программы, если это повысит ее
функциональность и гибкость. Для этого свяжитесь с разработчиком.
Кроме того, вы можете разработать внешний модуль, взаимодействующий с базовыми
скриптами программы и осуществляющий некоторые не предусмотренные ими функции,
и даже разместить ссылку на ваш модуль на странице документации программы.
Необходимая информация находится здесь.
11. Internet и e-mail адрес разработчика
Добро пожаловать на сайт White Tiger!
Здесь вы можете ознакомиться со
значительным количеством информации, узнать о других продуктах (и не только)
White Tiger, взять самую свежую версию программного обеспечения,
разрабатываемого White Tiger.
Официальный сайт: http://wtiger.ncport.ru
Маска: http://wtiger.da.ru
Адрес e-mail: wtiger@mail.ru
Fidonet: 2:5049/91.38
12. Подключаемые модули (plug-ins)
Программа организована таким образом, что существует возможность подключения
дополнительных модулей с использованием уже реализованных в базовом наборе
процедур получения и сохранения данных. Информация для разработчиков находится
здесь. В дальнейшем API будет совершенствоваться
для более удобного и полного интегрирования дополнительных модулей.
На сегодняшний день существуют следующие модули:
- WWWPage(R),
автор ColoneL.
Скрипт для постраничного вывода основного листа форума. Можно задать количество
ссылок, размещаемых на странице. Позволяет настраивать отображение форума
в широком диапазоне вариантов.
- White Tiger Citate,
автор Edward Muhutdinov.
Модуль для отображения цитаты, выбранной заранее заданного списка случайным
образом.
- White Tiger Mail
LE, автор Edward Muhutdinov.
Модуль для дублирования ответов на указанный адрес e-mail.
- White Tiger
Show, автор Edward
Muhutdinov. Модуль для вывода всяких мелочей характеристик форума.
13. Подмеченные тонкости обслуживания,
а также некоторые неофициальные моменты (FAQ)
1. При установке форума может выявиться проблема следующего плана:
не находятся скрипты форума, причем вполне очевидно, что они есть. В таком
случае попробуйте переименовать название каталога, содержащего исполнимые
файлы форума.
2. В режим администрирования форума можно попасть через страницу
wtbadmin.htm. Вы вольны переименовать ее в какую-то иную, если хотите
иметь дополнительный уровень защиты, но посторонний человек и так не будет
допущен к администрированию.
3. Если вы не уверены, что правильно указали строчку в <wtbadmin.txt>,
и вас не допускают до администрации, попробуйте войти под именем «admin»
и паролем «admin». По умолчанию в файле данных изначально содержится
эта строка, которую
рекомендуется удалить при первом же администрировании, чтобы исключить
возможность взлома форума.
Постарайтесь, кроме того, не использовать русские буквы при регистрации
администратора.
4. Некоторые параметры сгенерированных сообщений могут не работать
в Internet Explorer. Например, перевод каретки и абзацный отступ по умолчанию
осуществляются
тэгами <dd> и </dd>, которые реально работает в NN, а в IE ранних версий
только наполовину, исключая
абзацный отступ. Также в IE может не работать выключка текста по ширине окна.
Впрочем, упомянутые теги можно перенастроить.
5. Как избежать мата в сообщениях и можно ли отфильтровать такие письма?
Для контекстной замены слов во входящих сообщениях внесите изменения в файл
<wtbreplace.txt>, формат шаблонов описан выше.
Возможна также фильтрация сообщений по определенным словам, встречающимся
в них. Запрещенные слова явно определяются в настройках форума, режим
мониторинга включается там же (раздел администрирования Элементы
интерфейса). Случаи фильтрации регистрируются в лог-файле
<wtwrong.txt>.
6. Могу ли я быстро изменить названия каталогов форума?
Да, такое стало возможным начиная с версии 1.2b. В файле <wtboard.txt>
определяются названия каталогов, которые можно изменить:
dirkonf каталог, в котором находятся html-файлы форума, доступный
по URL через браузер; по умолчанию dirkonf=../wtboard.
dirrealkonf тот же каталог, но его физическое соответствие для доступа
cgi-скриптами на сервере. Как правило, совпадает с dirkonf, но может быть и иначе;
по умолчанию dirrealkonf=../wtboard (может быть,
скажем, dirrealkonf=c:/www/user/root/forum/wtboard).
dircgi каталог расположения cgi-скриптов, доступный по
URL через броузер; по умолчанию dircgi=../cgi-bin.
dirarc название каталога расположения архивов, не полный путь,
а только само название каталога. По умолчанию
dirarc=archive.
Если вы хотите изменить названия каталогов форума, необходимо скачать
с сервера файл <wtboard.txt> в том состоянии, в котором он там находится, и
вручную поправить в нем описанные параметры. После чего обновить файл на
сервере и переименовать обозначенные директории соответственно изменениям.
Через административный доступ описанные изменения невозможны.
7. Почему при отправлении сообщения меня выкидывает в каталог со скриптами?
Очевидно, вы неправильно отправили файлы на сервер. Дистрибутив поставляется
в формате DOS, а его отличие от Unix (в том числе FreeBSD, Linux) в том, что
признак конца строки определяется двумя символами, а не одним. Таким образом,
вместо одной строки, указывающей браузеру, куда отправлять сообщение,
получается несколько, результатом чего становится обыкновенный переход в каталог
со скриптами. Чтобы этого избежать, необходимо либо закачать файлы на сервер
при помощи какого-либо FTP-клиента в режиме ASCII, либо выполнением прямо на
сервере команды dos2ux над всеми файлами форума. Они будут преобразованы
в соответствующий формат.
8. У меня проблемы с кодировками...
Н-да... Это сложный вопрос. Остается только посоветовать методом проб и
ошибок, размещением файлов в разных кодировках, использованием принудительной
кодировки посредством файла .htaccess или добавлением meta-тегов в сообщения
найти правильный вариант.
P.S. С версии 2.2b имеется автоматическая генерация файла .htaccess
с определением заданной кодировки.
9. Я включил вырезание тегов, но хочу все-таки иногда использовать
их для выделения особо важных моментов в письмах. Как это можно сделать, не
включая их снова?
Можно установить частичный запрет/разрешение на публикацию тегов, а
также определить список разрешенных тегов.
10. Почему у меня главный лист форума показывается не так, как нужно,
а демонстрирует содержимое html-кода? (Вариант: Мой Netscape выводит html-код
файла, а IE все показывает нормально.)
Это проблема, связанная с настройками сервера. Обычно по массе расширений,
в которые входят и .htm, .html, .stm, .shtml, сервер выдает браузеру информацию,
как смотреть эти файлы как реализованный соответственно стандарту HTML,
как простой текст или как бинарный файл (например, архив). Netscape
Navigator/Communicator ориентируется на сообщения сервера и показывает
полученные файлы согласно этим сообщениям. IE же может наплевать на них
и показать так, как сам захочет. Скорее всего, в вашем случае сервер не считает
файлы .shtml форматными файлами HTML (недостаток настройки) и посылает их как
text/plain, чем и обуславливает такой их просмотр. Свяжитесь с администратором
сервера и попросите его исправить настройки либо найдите другой сервер,
удовлетворяющий общепринятым стандартам Internet.
11. Как удалить новостную строку?
Административный вход, раздел Прочие операции/Операции с новостными
строками. Редактирование новостных строк не предусмотрено.
12. Не обновляются параметры в <wtboard.txt>.
Тут может быть несколько причин.
1) Параметр просто не прописан в <wtboard.txt>. Вносить изменения можно
только в зарегистрированные в этом файле переменные. Так реализован алгоритм
программы. Впрочем, из этого получается еще одна фича программы вы можете
изъять из <wtboard.txt> параметры, которые никогда, ни при каких
условиях не должны изменяться ни вами, ни другими администраторами форума,
и произвести их изменение в файле <wtbext.cgi>, в котором они определяются
по умолчанию. В дальнейшем необходимо будет просто вносить соответствующие
исправления в новые версии.
2) Если значение параметра является нулевой величиной (то есть отсутствует,
хотя сам параметр прописан в <wtboard.txt>, то в некоторых случаях может
не произойти его обновление через административный раздел. В таком случае
необходимо вручную поправить файл <wtboard.txt>. В дальнейшем изменения
через административный раздел будут вноситься исправно.
3) Не соответствуют права доступа к файлу <wtboard.txt>. Установите
необходимые.
13. Мне нужно сделать в странице код, который принципиально не может быть
размещен одной строкой, как того требует формат файлов форума. Что делать?
Да, действительно, формат html-файлов и конфигурационных форума требует,
чтобы «шапки» и «подвалы» файлов размещались одной строкой.
Особенно это требование важно для файла основной страницы, поскольку некоторые
процедуры производятся с обязательным учетом одной строки, и при наличии лишних
строчек последствия становятся непредсказуемыми. Тем не менее, существует одна
очевидная возможность обеспечить выдачу пользователю основной страницы, имеющей
в начале должным образом оформленный код (например, java-скрипт), не нарушая
упомянутого требования.
Для этого нужно просто использовать SSI. Запишите многострочный фрагмент в
обычный текстовый файл и положите его, к примеру, в каталог <data> форума
(пусть это будет файл ../data/include.txt).
Далее в любое место строки, обеспечивающей начало или конец файла, вставьте
следующий фрагмент:
<!--#include file="../data/include.txt"-->.
Другой способ заключается в использовании внешних вызовов текстовых
строк, обрабатывающихся программой на определенной стадии как часть программного
кода. Подробнее о внешних вызовах см. Информацию для
разработчика.
14. Хулиганят со временем: пишут невесть что в спрятанных переменных
форм, и после этого получается бардак в строке индекса. Что делать?
Определить в шаблоне строки индекса соответствующие переменные с префиксом
s $ssec, $smin, $shour, $sday, $sweek, $smonth, $swmonth. Тогда
при генерации сообщения будут использоваться только текущие время и дата,
невзирая на то, что указано в передаваемых данных.
15. Можно ли отредактировать файлы форума с помощью скриптов?
Да, можно. Для этого есть специальный раздел в административной части,
в котором вы можете указать название редактируемого файла.
Для правки строк индекса выделен отдельный пункт, который позволяет с минимальным
риском повредить основную страницу форума внести необходимые изменения.
16. После изменения параметров форума index.shtml почему-то остается
старым...
Просто примите изменения еще раз. Иногда бывает, что при первой отсылке
данные только сохраняются в файл настройки <wtboard.txt>, и лишь при
второй обновляются остальные файлы. Такая ситуация обусловлена несколько кривой
организацией административного скрипта, и попытка ее исправления может привести
к некоторым глюкам, поэтому я пока оставляю как есть.
17. При попытке тестирования программы скриптов до полного размещения
всех оговоренных файлов на сервере возможна выдача сообщения об ошибке исполнения.
Это не страшно. Для работоспособности форума необходимо, чтобы все нужные для
работы файлы были доступны. С версии 2.5b добавлена диагностика ошибок, которая,
в идеале, должна такие ошибки распознавать, но не гарантированно.
18. В чем достоинства и недостатки ваших скриптов?
Хм... По сравнению с полностью скриптовыми?
Поясню. Насколько я понимаю ситуацию, существует два принципиально различных
способа организации интернет-конференции с помощью скриптов. Первый
полностью скриптовой, то есть не только запись и регистрация сообщений
осуществляется с помощью скриптов, но и вывод запрошенных писем, а также
списка (основной страницы). Тексты же и сопутствующая информация хранятся
в какой-либо базе данных. Пример сеть форумов на сайте
«Компьютерры».
Второй способ основан на записи каждого сообщения в отдельный файл. Скрипты
выполняются только для записи и регистрации приходящих писем и, в отдельных
случаях, для каких-то дополнительных функций. Так работает WTBoard.
Преимущества второго способа заключаются в том, что прочитать сообщения
можно будет в любом случае, даже если программная часть слетит, и отправлять/принимать
письма будет невозможно. Отрицательный же момент состоит в том, что в результате
записи избыточного повторяющегося кода html, который совершенно не обязательно
сохранять в базу в первом случае, в каждом сообщении форум занимает довольно
обширное место на жестком диске. Кроме того, на формат налагаются некоторые
ограничения, обусловленные необходимостью четкого различения некоторых
параметров сообщений.
19. Чем отличается WTBoard от куда более распространенной WWWBoard
Мэта Райта, RPGBoard и прочих? Есть ли стимул по сравнению с ними для перехода
на WTBoard? Насколько похожа WTBoard на WWWBoard?
Не знаю. Честно говоря, я мало этим интересовался. Наверняка существуют
аналогичные скрипты, реализующие куда больше возможностей и на более высоком
уровне. По мере своих сил я стараюсь сделать WTBoard удобнее и гибче, добавлять
какие-то новые функции, в которых чувствуется объективная необходимость.
Никакой агитации по переходу с прочих программ поддержки форумов я не
проводил и проводить не собираюсь. Соревнованиям типа
«WTBoard vs. WWWBoard» тоже здесь не быть. Я лишь предлагаю
программу с максимально возможной с моей стороны поддержкой и достаточно
быстрым исправлением найденных ошибок. Использовать или не использовать ее
дело ваше.
По поводу похожести... Как-то было высказано предположение, что WTBoard
основывается на WWWBoard (в частности, поэтому я ее здесь постоянно
упоминаю;). Могу уверить, что это не так. Код White Tiger WWW Board полностью
писался с нуля. Некоторые процедуры
специально для WTBoard любезно написаны сторонними людьми, о чем конкретно
оговаривается при их использовании. Все остальное эксклюзивная
разработка, даже если в чем-то порой совпадает с другими программами.
20. Что подразумевается под внешними вызовами? А то не совсем понятно...
Внешний вызов фрагмент перл-программы, который записывается в
конфигурационный файл как обычная текстовая строка и выполняется в
определенном для него месте. Преимущество очевидно основной код я
могу переписывать и изменять как мне заблагорассудится, а внешний
вызов останется без изменений. Недостаток им может в полной мере
воспользоваться только человек, умеющий программировать на перле.
Впрочем, если таковой (вызов) будет определен посредством плагина (для
чего он и предназначен в первую очередь), то перл знать не обязательно.
21. Не получается принудительная архивация, пишет: «Неверный номер
сообщения».
Да иногда возможна такая ситуация. Перед осуществлением принудительной
архивацией установите параметры автоматической архивации нужным вам образом.
После этого принудительная архивация должна получиться.
Для окончательной фиксации этого глюка обновите версию программы.
22. Хочу использовать таблицы стилей (CSS) для оформления страниц. Это
возможно?
Разумеется. Причем очень легко. Для этого модифицируйте параметры begbody и
endbody, которые добавляются в начало и конец всех технических сообщений
форума. Кроме того, указав ключи $begbody и $endbody в настраиваемых шаблонах,
вы можете «одним движением» менять оформление на желаемое.
23. Выдает ошибку в mod_perl и завершается...
Программа WTBoard несовместима с mod_perl. При работе Perl-скриптов через
mod_perl тело скрипта превращается в тело процедуры, отсюда несколько другие
правила локализации переменных. В WTBoard же используется механизм
динамического создания переменных, причем динамически определяются не только
их значения, но и названия. Поэтому, по всей видимости, к сожалению, WTBoard
неработоспособна в mod_perl, по крайней мере на данный момент. Возможно,
в следующих версиях mod_perl будет более близок стандарту.
24. Почему в скрипте wtbext.cgi нет строчки !#/usr/bin/perl? Может
ли это привести к ошибке исполнения скриптов?
CL: Данный скрипт (wtbext.cgi) не запускается напрямую,
а вызывается из других скриптов по сути, просто библиотека часто
используемых подпрограмм. Верхняя строка необходима для указания
ОС местонахождения интерпретатора Perl'a, но только для отдельно исполняемых
скриптов. Поскольку данная библиотека никогда не запускается как отдельный
скрипт, указывать первую строку с путем к интерпретатору нет необходимости.
EM: Впрочем, возможно, если ничто другое не помогает, поможет
добавление этой строчки. Но сомнительно.
25. Не могу настроить архивацию (вариант: нет времени разбираться). Есть
ли еще какие-то способы ее осуществления?
ZZW:
Мне, как веб-мастеру, привыкшему писать html ручками, намного проще делать
ее вручную, чем разбираться почему не работает автоархивация и что надо
сделать, чтобы она работала.
На всякий случай, вдруг кому понадобится, расскажу как это делается.
а). Лезете на сервер и скачиваете себе индекс и все файлы сообщений.
б). Удаляете с сервера индекс и все файлы сообщений. (Для пользователей это
безболезненно 5 минут посмотрят на 404-error или missing-файл
ничего с ними не случится.)
в). Кладете на сервер индекс из дистрибутива
г). Лезете админом в настройки шаблонов и просто еще раз подтверждаете их,
чтобы скрипт передизайнил индекс. Там же добавляете ссылку на индекс-файл
архивов.
д). Собстно делаете из скаченного архив, индексный файл и кладете на сервер.
Я вас уверяю, что эта операция из 5-ти пунктов намного менее геморойна, чем
разбираться с архивацией и автоархивацией, тем более, что она не всегда
применима по самым разным соображениям.
26. Выдает ошибку при отправлении сообщения. Форма создается нормально.
Что делать?
Возможно, дело в некорректной настройке контекстных замен. Проверьте это
отключением контекстной замены при приеме сообщения. Если ошибка исчезла,
то оставьте так или замените файл шаблонов замены <wtbreplace.txt>
на последнюю версию. Настройка контекстных замен вопрос весьма хитрый,
время от времени шаблоны оптимизируются и совершенствуются.
Если не помогло, попробуйте поставить последнюю наиболее устойчивую версию.
Примечание:
CL ColoneL
EM Edward Muhutdinov
ZZW ZeroZoneWebMaster
default Edward Muhutdinov
14. Изменения в версиях
В отношении нумерации версий White Tiger WWW Board осуществляется следующая
политика. Исправление мелких багов, глюков, внесение мелких изменений и небольшой
косметический ремонт вторая цифра после точки. Более крупные изменения,
добавление новых функций и возможностей, оптимизация программного кода,
внесение новых параметров в конфигурационный файл
первая цифра после точки. Наконец, существенные изменения в работе программы
или значительное количество небольших цифра до точки. Изменение первой
цифры после точки, а также до точки может также происходить при логическом
переходе к следующей версии с накоплением и обнулением соответствующей цифры. Уфф...
Значки: [+] добавление, улучшение; [-] удаление, изъятие; [!]
модификация, исправление.
0.0a (26/X/98)
[+] тестовая альфа;
1.0b (13/XI/98)
[+] первая версия;
1.1b (1/XII/98)
[!] подправлены некоторые незначительные баги, улучшен
внешний вид сообщений;
[+] цитируемый текст выделяется курсивом. Признак цитирования
по умолчанию >;
[+] введена выключка текста по ширине окна;
1.2b (27/XII/98)
[+] введена новостная строка. В связи с этим название
индексного файла форума изменилось на index.shtml;
[+] появилась возможность быстро определять названия
каталогов форума;
[+] упростилась процедура подготовки форума к работе;
1.3b (21/I/99)
[+] стало возможным редактировать отдельные строки
в Index-файле, используя административный вход;
[!] исправлены некоторые ошибки,
в частности, приводящая к неправильному цитированию заголовков писем при
ответе;
[-] упразднена «дыра» в административной части,
позволявшая производить несанкционированное администрирование форума;
1.4b (7/II/99)
[+] добавлена автоматическая подстановка имени и адреса e-mail по IP-адресу;
[!] улучшена обработка заголовка;
[!] подстановка многих «Re:» заменена одним с восходящей нумерацией
при необходимости;
[+] процедура подготовки форума к работе еще более упростилась;
[+] стало возможным объявить абсолютные пути к каталогам форума;
[+] счетчик сообщений вынесен в отдельный файл;
[+] введена проверка на наличие в форуме отправляемого сообщения
во избежание его дублирования;
[+] в административую часть добавлены два варианта восстановления
Index-листа форума, первый с сохранением структуры,
второй без;
[+] добавлены сервисные функции поиск;
1.41b (15/II/99)
[!] пофиксен мелкий баг в wtbservice.cgi;
1.5b (23/III/99)
[+] все тексты вынесены в отдельный файл в целях многоязычности форума;
[-] удалена кнопка «Очистить (Reset)» из форм, как вредная и
не нужная;
[+] добавлена поддержка многофорумности;
[+] упрощена подготовка форумов;
[+] стандартные файлы форума сделаны более универсальными;
[!] улучшена обработка цитирования темы;
[!] пофиксена ошибка с потерей плюсов в сообщениях;
[!] поправлена логическая неувязка при цитировании вместо
«Re (1):» теперь подставляется «Re (2):»;
[+] добавлена подстановка размера сообщения в Index-файл (опционально);
[+] добавлена публикация IP-адреса отправителя сообщения (опционально);
[+] добавлена автоматическая подстановка интервалов при поиске
в «Сервис»;
[+] добавлена возможность получения списка сообщений, появившихся на форуме
после какого-то времени;
[!] модули скрипта wtbnews.cgi и wtbservice.cgi объединены в один;
[+] контекстная замена теперь производится не только в сообщениях, но также
в именах и темах;
[+] расширены возможности списка игнорирования;
[!] изменен способ архивирования, теперь архивация должна происходить
успешно;
[+] добавлен отказ от кэширования сообщений;
[+] добавлено удаление тегов из полей «Имя», «E-mail»,
«Тема». Теги в самом сообщении поддерживаются;
1.51b (27/III/99)
[+] статистика форума дополнена графиком активности;
[!] доработана архивация форума, архивировать можно и в рабочий каталог;
[!] поправлены некоторые недочеты в <wtboard.txt>;
1.52b (3/IV/99)
[-] удаление тегов пока изъято, из-за нестабильной работы;
[+] теги в заголовках, именах и адресах e-mail преобразуются в обычный
текст;
[!] пофиксена ошибка с потерей части цитированной темы при наличии кавычки
";
1.53b (13/IV/99)
[+] добавлена первоначальная идентификация с помощью cookies; если не
срабатывает она, скрипт по-прежнему пытается узнать пользователя по IP-адресу;
[+] добавлена обработка тегов в сообщении двумя способами:
1) преобразование в текст; 2) удаление тегов. Естественно, можно оставлять
их без изменений;
[+] добавлено включение/выключение цитирования письма при ответе
(административная часть);
[!] доработана контекстная замена в соответствии с файлом <wtbreplace.txt>;
[!] исправлена ошибка с новостной строкой в предыдущей версии, из-за
которой новостная строка не проявлялась;
2.0b (14/VII/99)
[!] существенно оптимизирован программный код;
[!] усовершенствован механизм учета сходства разных букв латинского
и русского алфавитов;
[!] усовершенствован механизм выделения цитирования: теперь пара тегов
<i></i> подставляется корректно и не конфликтует с другими;
[+] добавлена возможность пометки новых сообщений, продолжительность
и признак настраиваются;