В руководстве есть три основных компонента. Я ссылаюсь на них по их местным URL -адресам на www.midwinter.com.
Первый раздел, который является основной частью сайта, представляет собой дерево каталогов статических HTML-файлов с несколькими серверными HTML-файлами (для сервера) добавлено), а также один короткий сценарий PHP.
Внутри этого каталога есть куча подкаталогов, в основном соответствующие основным разделам сайта. Я доберусь до них через мгновение, но сначала слово о том, как создаются некоторые из файлов.
Самая большая вещь, о которой нужно знать,-это сценарий Python под названием «Gen.py», версия которого живет в каждом из каталогов, который содержит HTML-файлы для эпизодов. Сценарий отвечает за сборку статического HTML -файла из раздела заголовка (генерируется для каждого эпизода; он включает в себя название эпизода, среди прочего), файл тела и раздел нижнего колонтитула.
Файлы тела содержат мясо страниц. Они имеют те же имена файлов, что и HTML -файлы, минус расширение .html. В большинстве случаев это всего лишь 3-значный номер эпизода, например,/lurk/guide/056.html содержит файл тела «056» из подкаталера Гида. Когда я хочу добавить новый комментарий на страницу для эпизода 33, например, I CD в каталог руководства, отредактируйте файл «033», а затем запустите «Gen.py 033». Результатом является новая версия 033.html, причем старая версия перенесена в сторону #033.html в качестве меры предосторожности.
Еще одна вещь, которую делают некоторые версии Gen.py, это добавлять временные метки в элементы. Идея состоит в том, что когда я изменяю страницу, я хочу выделить изменения, чтобы люди, которые уже прочитали предыдущую версию, могли быстро прокрутить новый материал. С этой целью Gen.py ищет специальный токен "@@@" (который должен за счет пробела или конец линии) в файле тела. Когда он находит токен, он заменяет его на «@@ nnn», где NNN является текущей временной меткой в формате Unix Time_t. Это изменение внесено в сам файл тела. Затем, когда Gen.py генерирует HTML -файл из файла тела, он вводит дату жирным шрифтом, где бы он ни видел недавнюю метку времени. Раз в день скрипт восстанавливает все файлы HTML, так что через некоторое время маркеры даты исчезают (удержание их заставляет страницы выглядеть уродливо и затрудняет быстрое местонахождение новых элементов).
Когда вы видите файл «Skel», это прототип файл тела. Я копирую это в соответствующее имя файла, когда новый эпизод/роман/и т. Д. выходит.
Во многих подкаталогах вы увидите сценарий "genall.csh". Это всего лишь ярлык, который запускает «Gen.py» для каждого эпизода. Я использую это только тогда, когда вношу изменение в структуру заголовков/нижних фунтов стерлингов и хочу применить его везде.
Кроме того, в каталоге верхнего уровня есть сценарий «Gen». Это работает Gen.py в каждом из подкаталогов. Я использую это, когда, например, я добавляю картинку для эпизода и хочу, чтобы она была отображена на всех страницах для этого эпизода.
«История до сих пор» для каждого эпизода сезонов 1-4. 5 сезон еще должен быть написан. Доступные пользователи файлы здесь-все файлы .shtml. Вы заметите, что здесь нет никаких файлов тела. Вместо этого, фон/Gen.py использует несколько других исходных файлов. Существует несколько различных вступительных резюме, которые находятся в файлах sum-*. Например, SUM-66 суммирует историю вплоть до эпизода 66 и включена в качестве первой части фона для эпизодов 67 и позже. После того, как соответствующий файл sum-*, Gen.py смотрит в story.html. Этот файл содержит параграфы для эпизодов, которые включены в раздел «Совсем недавно ...» на фоновых страницах, под вступлениями. Только параграф для эпизодов между резюме и текущим эпизодом включены, например, для эпизода 75, Gen.py включает в себя SUM-66 и параграфы для эпизодов 67-74.
Биос некоторых персонажей. Они связаны с разделом «Вселенная». Простые плоские HTML -файлы.
Руководство страницы для комиксов. Файлы тела и Gen.py.
Единственный HTML -файл, непосредственно здесь, - это index.html, который представляет собой список всех стран, для которых у меня есть информация о расписании. Каждая страна имеет подкаталог под здесь (название каталога, как правило, является 2-буквенным кодом страны). Одним из псевдонтрит, примечания является «Мастер», который содержит список мастер-эпизодов с эпизодами в правильном порядке (оригинальный порядок эфирного анализа США был немного неправильным).
Внутри каталога каждой страны находится файл eplist.html с расписанием для этой страны, плюс символические ссылки на различные подкаталогов с эпизодами. Используя относительные пути в моих URL -адресах, я позволил браузеру запомнить график страны, на которую пользователь смотрел, не прибегая к файлам cookie (который еще не существовал в качестве концепции, когда этот сайт впервые начался!) SE/eplist.html имеет ссылку на «Руководство/056.html», которая на самом деле является тем же файлом, что и/lurk/guide/056.html, поскольку/lurk/ound/se/guide является символом/lurk/guide. Но поскольку браузер этого не знает, ссылка 056.html обратно на страницу эпизода «../eplist.html», которая восходит к шведскому графику.
index.html - это ссылка на eplist.html в страновых каталогах. Существует сценарий «mkcountry.sh» для создания нового кантри -каталога. Есть также списки эпизодов скелета для всех 5 сезонов (Skel, Skel2, Skel3 и т. Д.)
Когда я редактирую график страны, я использую сценарий "print-weeks.py", который описан позже, поэтому мне не приходится даты типа ручного типа.
Эпизод титров.
Короткий скрипт PHP, который делает простой поиск доменного имени пользователя, чтобы выяснить список эпизодов страны. Возможно, менее актуально сейчас, когда шоу в значительной степени не в эфире, но когда в разных странах появлялись разные сезоны, это было удобно для пользователей.
Сознание в списке эпизодов США, так что любые ссылки на «../EPLIST.HTML» в каталогах руководства без кантри будут полезным. (См. Обсуждение каталога «стран» выше.)
Стандартный нижний колонтитул страницы, используемый по всему сайту. Не используется программно, но я загружаю это в свой текстовый редактор, когда создаю новую страницу.
Скрипт, который управляет Gen.py для эпизода в каждом из связанных с эпизодами подкакаторий.
Довольно самоэкспланирующая. Все изображения, связанные с невигацией, живут здесь. (Некоторые из них являются JPEGS, несмотря на имя каталога.)
Страницы «Руководство эпизода».
Стоимость сайта. Это упоминается по имени «Помощь» вместо этого, чтобы избежать путаницы с часто задаваемыми вопросами USENET B5.
Симлинвя, чтобы скрываться .html.
Файлы данных, используемые Gen.py и CGIS:
СПИСОК РУКОВОДСТВО ЭПИПИАЛЬНОГО РУКОВОДСТВА И СИН -СТАРИЗАЦИИ, заказанные по времени модификации. Генерируется утилитой "lastupdate.py".
Домашняя страница без черного фона, так как некоторые люди находят пользовательские фон раздражают. Это автоматически генерируется из Lurker.html с помощью задания Cron, которая работает «производить» в каталоге верхнего уровня.
Домашняя страница.
Однажды этот Makefile используется для восстановления Lurker-nobg.html, и один раз в день он используется, чтобы убедиться, что я не забыл запустить Gen.py на чем-то. Он также обновляет файл b5tvlist.txt в архиве FTP.
Раздел «Создание B5» сайта. Плоские HTML -файлы.
Imagemaps для Navbar.
Разные документы, которые не подходят в другом месте, например, о том, почему Клаудия Кристиан покинула шоу.
Навигационные изображения. Вторичная функция заключается в том, что его index.html - это страница «предварительно загружать ваш кэш изображений здесь», которая ускоряет сайт для людей, позволяя им страдать от боли загрузки изображений NAV за один выстрел.
Новые страницы. Этот раздел неполный - нет страниц для последнего раунда романов.
Результаты опроса 5 просмотра для каждого эпизода.
Кнопки и навигационные изображения в их оригинальных формах без потерь.
Раздел «Справочник» сайта. В основном плоские HTML-файлы, но несколько страниц имеют серверную сторону, которые включают в себя текстовые файлы из области FTP.
Больше не упоминается, но, возможно, исторического развлечения.
Раздел «Другие ресурсы» сайта. Плоские HTML -файлы.
Содержит некоторый случайный код поддержки. Подробнее об этом позже.
Эпизод Синопсы.
Карта сайта.
Раздел «Вселенная и символы» сайта. Плоские HTML -файлы. 5 сезон еще должен быть записан.
Упражнение в наивности; Я сам сделал все это сам!
Сообщение JMS о том, что B5 занимает первое место по зрителям по качественному телевидению.
Введение на сайт после перехода на текущий вид и ощущение.
Какая новая страница. Когда это становится большим, я помещаю все старые предметы в архивные страницы и ссылки на них в нижней части этой страницы.
Midwinter.com использовался для размещения архива FTP с текстовыми файлами и изображениями; В настоящее время все доступны через руководство из скрывающихся и хранятся в подкаталоге «FTP».
См. Файл индекса FTP (доступный как в тексте, так и в HTML) для описания различных файлов в архиве FTP. Руководство Lurker указывает на различные файлы здесь, включая некоторые серверные, включающие ссылки.
Есть несколько утилит, источник которого вы найдете в /lurk /src, если не указано иное. Некоторые обсуждались выше, но вот список:
Это запускается один раз в день с работы Cron. Он восстанавливает все направляющие страницы. Если регенерированная страница не отличается от старой версии, старая версия перемещается обратно на место, чтобы сохранить дату его модификации. Цель здесь состоит в том, чтобы истечь срок действия времен на новых элементах на страницах руководства (см. Обсуждение сценария Gen.py, выше).
Бежать один раз в час от Крона; Это обновления /lurk/lastmod.html и довольно эксплуатационно.
