Zaval Advanced TV Guide
(ATV)

Версия 1.0



Руководство пользователя



Zaval Creative Engineering Group

http://www.zaval.org


Содержание.

Введение.

Устанавливаем Zaval Advanced TV Guide.

  Требования.

  Процедура установки.

Устанавливаем Zaval ATV Parser.

  Требования.

  Процедура установки.

Работа с Zaval Advanced TV Guide.

  Общие сведения.

  Программы телепередач.

Работа с Zaval ATV Parser.

  Команда parse.

  Команды load/save.

  Команды list/fulllist.

  Команда now.

  Команда purge.

  Файл конфигурации atv.ini.

  TimeZone, разница во времени и т.п.

  Правила include/exclude.

  Кодировки.

  Примеры использования.

  Работа под разными операционками и кодировки.

Дальнейшие планы.

Поддержка.

Рассылка (последние новости).


Введение

Zaval Advanced TV Guide (более известный как ATV) -- это небольшая и удобная программа, которая позволяет просматривать программы телепередач на вашем PDA, таким образом, вы всегда будете в курсе последних новостей. С помощью нашего продукта вы можете легко отслеживать интересующие вас программы.

Zaval Advanced TV Guide лёгок в использовании, имеет интуитивно понятный интерфейс, а также обладает большими возможностями по работе с программой телепередач. В настоящее время существуют модули для работы со следующими сайтами:

Это включает в себя такие всемирно известные каналы как EuroTV, BBC World, CNN, Discovery, а также российские ОРТ, НТВ, РТР и многие другие. При необходимости можно легко дописать отдельный модуль для любого другого сайта.

Zaval Advanced TV Guide поставляется в 3-х вариантах: с русским, английским и немецким интерфейсом. При необходимости этот список может быть расширен.

Zaval Advanced TV Guide состоит из 2-х программ:

  1. ATV-Palm - собственно программа для Palm'а;
  2. ATV Parser - программа для загрузки/просмотра/конвертации ТВ-программы;

Устанавливаем Zaval Advanced TV Guide

Этот раздел подробно описывает процесс инсталляции Zaval ATV Guide.

Требования

PalmOS версии 3.5 или выше.

Процедура установки

  1. Распакуйте архив (zip или tar.gz) с ATV в пустую директорию.
  2. Если Вы ранее использовали предыдущие версии ATV, то вначале удалите их (вместе с программами телепередач).
  3. Установите файл atvpalm_LL_XXX.prc с привычной для вас локализацией на свой PDA:
    1. atvpalm_ru_XXX.prc - русифицированная версия;
    2. atvpalm_de_XXX.prc - немецкая версия;
    3. atvpalm_en_XXX.prc - английская версия;

Если Вы успешно выполнили вышеописанное, то программа готова к работе. Для работы Вам необходимы сами программы телепередач. Для получения более подробной информации, как и где их достать, см. раздел Работа с Zaval Advanced TV Guide -> Программы телепередач.

Устанавливаем Zaval ATV Parser

Этот раздел подробно описывает процесс инсталляции Zaval ATV Parser. В действительности Zaval ATV Parser нужен только в случае, когда вы хотите самостоятельно формировать файлы с ТВ-программами. Для получения более подробной информации см. раздел Работа с Zaval Advanced TV Guide -> Программы телепередач.

Требования

Java Runtime Environment (или JDK) версии 1.4.x или выше. Можно скачать с java.sun.com (выберите интернациональную версию).

Процедура установки

Собственно, это и всё - ATV Parser готов к использованию.

Работа с Zaval Advanced TV Guide

Этот раздел подробно описывает все возможности продукта и на примерах поясняет принципы его работы.

Общие сведения

Для начала обратим внимание на внешний вид Zaval Advanced TV Guide - см Рис.1):

Рис.1 ATV - внешний вид

В принципе, всё интуитивно понятно - список каналов со списком программ для каждого из них. Кроме того, имеются фильтры - возможность просматривать не всю доступную информацию, а лишь определённую часть.

Zaval Advanced TV Guide поддерживает 3 типа фильтров:

Рассмотрим на примерах.

Примечание: для скроллинга можно использовать не только полосу прокрутки, но и кнопки "вверх" и "вниз".

Допустим, нужно просмотреть только программы, которые идут прямо сейчас (на протяжении какого-то времени от текущего момента включительно). Для этого существует фильтр по времени (см. Рис.2). Аналогично можно просмотреть только программу на "сегодня" и т.д.

Рис.2 ATV - фильтр по времени

Другой тип фильтров - это фильтры на основе выбора. Предположим, что, просмотрев программу, Вы выбрали (отметили галочками) интересные, на Ваш взгляд, передачи и теперь хотели бы видеть лишь список выбранных. Именно для этого и предназначен данный фильтр - см. Рис.3.

Рис.3 ATV - фильтр на основе выбора

Ещё один тип фильтров - это фильтр по каналам. Довольно удобно просматривать программу не на все каналы сразу, а оперировать лишь небольшим списком. С помощью данного фильтра это как раз и делается - см. Рис.4.

Рис.4 ATV - фильтр по каналам

Если необходимо просмотреть программы лишь для одного канала - тоже не проблема, применяем опять же фильтр по каналам - см. Рис.5.

Рис.5 ATV - просматриваем программу на один канал

В некоторых газетах публикуют программу с краткими аннотациями к некоторым передачам. Аналогичная возможность предусмотрена и у нас - см. Рис.6. Для просмотра аннотации достаточно кликнуть на выделенной передаче.

Рис.6 ATV - аннотация к программе

Для удобства работы некоторые из настроек можно менять:

И некоторые другие - см. Рис.7.

Рис.7 ATV - настройки

Программы телепередач

Программы телепередач - это xml-файлы, с которыми и работает ATV Guide. Существует несколько способов их достать:

  1. Самый простой - скачать их с нашего сайта http://www.zaval.org/products/atv/data/. Мы их постоянно обновляем, так что никаких проблем с актуальностью быть не должно.
  2. Вы можете сформировать их сами с помощью ATV Parser - подробную инструкцию см. далее.
  3. Вы можете подписаться на нашу рассылку TV schedule via e-mail и бесплатно получать программы выбранных каналов на e-mail - более подробная информация доступна на сайте http://www.zaval.org/products/atv/
    Примечание: рассылка TV schedule via e-mail сейчас проходит тестирование и поэтому пока недоступна - для получения последней информации по нашим продуктам Вы можете подписаться на новости - см. раздел Рассылка (последние новости).

Примечание: все программы телепередач хранятся в формате pdb.

После того, как вы скачали/сформировали нужные вам ТВ-программы, закачайте соответствующие pdb-файлы на свой PDA.

Работа с Zaval ATV Parser

Zaval ATV Parser -- это утилита, позволяющая самостоятельно создавать ТВ-программы, просматривать их и преобразовывать в другие форматы.

Синтаксис: java -jar atv.jar <command>

Поддерживаемые команды:

Рассмотрим каждую более подробно.

Команда parse

Эта наиболее интересная команда служит для загрузки ТВ-программы из внешних источников.

Синтаксис:

java -jar atv.jar parse [имя_модуля] [--charset=<>] [файл1]...[файлN]

где:

Команды load/save

Команда служит для конвертации между разными форматами хранения ТВ-программ.

Синтаксис:

java -jar atv.jar load [имя_модуля] [файл1]...[файлN]

или

java -jar atv.jar save [имя_модуля] [имя_файла]

Если имя модуля не указано - выдается список доступных модулей. На текущий момент доступны следующие модули: listtv(для ListTV), palm(для atv-palm), jtv(для JTV), internal(для atv). Команда загружает/сохраняет данные из/в нужный формат. Обычно в команде save имя файла можно не указывать - в этом случае используется имя по умолчанию. Аналогично с командой load.

Модуль JTV имеет свои особенности. Команда save использует имя файла как префикс, т.е. вы можете указывать имя каталога, куда будут сохраняться файлы. Команде load нужно указывать имена файлов без их расширения, так как на каждый канал должно существовать 2 файла с разными расширениями. Также можно указать после "load jtv" ключ --fromdir=<каталог> -- тогда будут загружены все файлы jtv из этого каталога.

Модуль Palm также имеет дополнительные параметры для команды save. Это значит, что программа для каждого канала выводится в отдельный pdb, а не в один и тот же. За это отвечает ключ --separate-channels. Другая возможность - выводить данные для всех каналов определённого сайта в один файл, но для разных сайтов это разные файлы.За эту фичу отвечает ключ --separate-sites.
Синтаксис: java -jar atv.jar save palm [--separate-channels | --separate-sites] [префикс_имени_файла_с_путём_до_файла]

Команды list/fulllist

Показывает список каналов(list) или список всех сохраненных программ(fulllist).

Команда now

Показывает список программ, идущих в данный момент.

Синтаксис:

java -jar atv.jar now [кол-во_часов]

где:

Команда purge

Удаляет информацию о старых передачах. Этой командой и надо чистить базу.

Синтаксис:

java -jar atv.jar purge [с_какого_времени]

Если не указано, с какого времени, то удаляются все передачи старше 24 часов.

Файл конфигурации atv.ini

Общее правило - часть строк, начинающаяся с символа '#', является комментарием и игнорируется.

Команды настройки прокси:

Команды настройки списка программ:

TimeZone, разница во времени и т.п.

В связи с тем, что живем мы все в разных часовых поясах, приходится просчитывать разницу во времени начала программ. Внутри atv все время хранится в GMT, что упрощает эти расчеты. При выводе на экран (и сохранении в большинство форматов) время переводится в местное с помощью системной TimeZone. В Unix-системах ее можно установить переменной окружения TZ или в файле /etc/timezone. В Windows - мышью ;)

В качестве расчетов разницы во времени выбрана именно TimeZone, а не смещение от GMT и смещение для каждой программы. Это позволяет решить проблему перехода на зимнее и летнее время автоматически. Однако, если вам не нравится установленное значение, вы можете его изменить в atv.ini строкой local.TimeZone, в значение которой прописывается нужная TimeZone.

Ниже приведён список всех модулей с их TimeZone'ами по умолчанию:

Правила include/exclude

Введены следующие правила загрузки/незагрузки каналов (см. файл atv.ini):

Глобальные:

Для каждого модуля:

В каждом из этих параметров могут быть перечислены названия каналов (через ';'). Параметры для каждого модуля имеют приоритет, т.е. если в list.exclude указан какой-то канал и он же указан в <имя модуля>.include -- канал будет грузиться, но только этим модулем. Если канал указан в list.include и в <имя модуля>.exclude -- грузиться этим модулем он не будет. Если хоть один канал определен в include, никакие другие каналы, кроме этого, загружаться не будут. Если не определен ни один include (локальный для модуля или глобальный) -- модуль будет грузить все каналы, кроме exclude.

Кодировки

Все модули, поддерживающие load/save, понимают параметр <имя модуля>.charset. Этот параметр говорит, в какой кодировке будут загружаться и сохраняться данные. Если параметр не определен -- используется локальная кодировка Вашей системы. Кодировка должна быть в виде, воспринимаемой Java.

Примеры использования

"java -jar atv.jar parse citycat" - загружает программу из Интернета с сайта citycat

"java -jar atv.jar parse vm --charset=Cp1251 1.html 2.html 3.html" - загружает программу из файлов 1.html,2.html,3.html, которые взяты с сайта vm.agava.ru в кодировке 1251

"java -jar atv.jar save palm" - конвертирует ТВ-программу в формат palm (TVProgram.pdb)

"java -jar atv.jar load jtv ОРТ НТВ" - загружает программу из формата jtv из файлов ОРТ.* и НТВ.*

"java -jar atv.jar now 3" - показывает передачи, которые идут сейчас или будут идти на протяжении еще 3 часов

"java -jar atv.jar purge" - удаляет старые передачи

Работа под разными операционками и кодировки

По умолчанию в Windows используется кодировка Cp1251(при установке русского языка в региональных настройках), и файл atv.ini приведен именно в этой кодировке.

Для Unix-систем ситуация другая. Кодировка устанавливается в переменной окружения LANG, причем из-за особенностей java работать с кодировкой 1251 не получается. Есть два варианта -- пользоваться KOI8-R, тогда нужно установить LANG=ru_RU.KOI8-R, или Unicode(UTF8), для этого прописываем LANG=ru_RU.UTF-8. Второй вариант, IMHO, является более правильным.

Файл atv.ini должен быть в текущей выбранной кодировке, иначе java не сможет его распознать.

Дальнейшие планы

Текущая реализация программы представляет собой лишь необходимый минимум, в дальнейшем планируется добавить следующие фичи:

Поддержка

Все найденные баги и вопросы по технической реализации продукта высылайте по адресу support@zaval.org с subject "Re: Zaval ATV Guide Support" в формате plain text. Поскольку продукт распространяется на правах General Public License и сопровождается его авторами на некоммерческой основе, Ваши запросы будут обработаны по мере возможности, но не позднее чем через 5 рабочих дней.

Zaval Creative Engineering Group выполняет оптимизацию существующих продуктов под нужды заказчика и разработку новых продуктов "с нуля". За дополнительной информацией обращайтесь по адресу info@zaval.org.

Рассылка (последние новости)

Дабы получать все сообщения о новых версиях продуктов нашей группы, а также найденных багах и путях их исправления, рекомендуется подписаться на рассылку. Для этого отправьте письмо по адресу news-subscribe@zaval.org. Сама рассылка довольно апериодична и в среднем составляет 2-3 письма в месяц, а то и реже.


Для получения дополнительной информации о продукте пишите нам - мы всегда рады услышать Ваше мнение.

Спасибо за Ваш выбор,
Zaval CE Group.