snownews - консольная программа для чтения RSS-новостей
                           
        snownews [-huV] [--help|--update|--version]
                         
        Snownews  -  компактная  консольная  программа для чтения RSS/RDF лент.
        Поддерживаются ленты RSS 1.0,  соответствующие  спецификации  W3C  RDF,
        однако версии 0.91 и 2.0 также поддерживаются.

        На  основном  экране программы, отображаемом сразу после запуска, можно
        добавить/удалить ленты, а также обновить их вручную. С  правой  стороны
        экрана   для  каждой  новостной  ленты  отображается  количество  новых
        записей.  Для добавления ленты  нажмите  'a'  и  введите  URL,  Который
        должен  быть  полностью  корректным  HTTP  адресом,  включая  http:// в
        начале. Для удаления ленты выделите ее с  помощью  курсорных  клавиш  и
        нажмите 'D'.  Появится диалог с запросом подтверждения.

        Для    навигации   по   меню   лент   используйте   курсорные   клавиши
        "вверх","вниз", а также 'n' и 'p' которые также перемещают курсор вверх
        и  вниз.  Нажатие  'r' вызовет перезагрузку выделенной ленты с сервера,
        нажатие 'R' обновит все ленты в вашем списке.

        Для сортировки списка лент по  алфавиту,  используйте  's'  Передвигать
        ленты вверх и вниз можно с помощью 'P' и 'N'.

        Если установить курсор на ленту и нажать Enter, программа отобразит все
        записи в данной ленте. Здесь вы также можете пользоваться для навигации
        курсорными  клавишами,  как  и  клавишами  'n'  и 'p'.  При нажатии 'r'
        произойдет обновление текущей ленты. При этом  записи  могут  полностью
        пропасть из списка, и новые записи будут выводится жирным шрифтом.

        Для  просмотра  описания  записи,  выберите  ее  и  нажмите Enter. Если
        описание отсутствует, вместо него появится текст "Описание недоступно."
        Здесь  можно  пользоваться  курсорными  клавишами "влево" и "вправо", и
        соответственно 'p' и 'n' , чтобы перейти  к  предыдущей  или  следующей
        записи  в  списке.  Нажатием  'o'  вы сможете открыть ссылку в браузере
        (обычно по ссылке имеется полный текст новости)

        Браузер по умолчанию - lynx, однако вы можете это изменить, нажав 'B' в
        основном  меню  (на  основном  экране),  и  ввести новую строку запуска
        браузера   по    умолчанию.    Либо    можно    отредактировать    файл
        ~/.snownews/browser.   программы заменит %s соответствующим адресом при
        обработке этой  строки.   (как  организовать  использование  mozilla  в
        качестве     браузера     для     snownews,     смотрите     в     FAQ:
        http://home.kcore.de/~kiza/software/snownews/faq#toc2.1 )

        Сетевые соединения могут быть прерваны нажатием 'z' во время скачивания
        или   соединения,   если  программа  застывает  в  ожидании  данных  от
        вебсервера.

        Переименовать ленту можно, нажав 'c' и введя новое имя для  неё.  Чтобы
        сбросить имя в изначальное, введите в текстовом поле только знак '-'.

        Контекстная помощь доступна всегда, по умолчанию на клавише 'h'.                                                           

        Для   более   удобной   навигации  по  списку  лент  в  Snownews  можно
        использовать возможность инкрементного поиска. При нажатии клавиши  TAB
        строка  статуса  становится  полем  для  ввода текста. Когда вы вводите
        текст  для  поиска,  курсор  списка   автоматически   перемещается   на
        соответствующие  текущей  строке  поиска  элементы  списка. Если выбран
        нужный вам  элемент,  для  его  открытия  просто  нажмите  enter.  Если
        совпадают  несколько элементов, между ними можно переключаться, нажимая
        TAB. Чтобы выйти из инкрементного поиска, удалите введенный текст,  или
        нажмите CTRL+G

        Для  управления большим списком лент в snownews используются категории.
        Для ленты можно назначить любое желаемое  количество  категорий.  Далее
        можно  использовать  фильтр  из основного меню, чтобы отображать только
        ленты, подходящие по выбранной категории.  Для  лент,  которым  указана
        категория,  имя  этой  категории  отображается в основном меню сразу за
        именем ленты.

        Чтобы добавить или удалить ленту из категории, нажмите 'C' когда нужная
        лента  подсвечена  курсором.  Если  уже есть определенные категории для
        других лент, будет отображен  список  существующих  категорий.   Просто
        нажмите  цифру, соответствующую номеру категории, и текущая лента к ней
        добавится. Чтобы занести ленту в новую категорию, нажмите 'A' и введите
        имя категории. Удаление ленты из категории производится нажатием цифры,
        соответствующей номеру категории, в которой присутствует лента (в  меню
        категорий).

        Категории, определенные для ленты, отображаются в информации о ленте.

        Переопределить    назначение    клавиш   можно,   отредактировав   файл
        ~/.snownews/keybindings. Формат записей -  "описание  функции:клавиша".
        Строку  "описание  функции"  изменять  нельзя.  Единичный  символ после
        двоеточия описывает клавишу, которую программа назначит соответствующей
        функции.  Если описание будет удалено из файла, или программа не сможет
        по какой либо причине  обработать  файл  настроек,  будут  использованы
        стандартные настройки.

                                          HTML

        Snownews  пытается конвертировать HTML-содержимое в обычный текст перед
        отображением. Тэги полностью отбрасываются, некоторые  распространенные
        HTML-коды  конвертируются.  По  умолчанию  конвертируются  только  пять
        кодов, определенных в XML (< (<), > (>), &  (&),  "  (")
        and  '  ('))  плюс определенные в стандартных настройках snownews.
        Это  можно  изменить  в  файле  ~/.snownews/html_entities.   Дальнейшие
        объяснения смотрите в комментариях в начале этого файла.

        Snownews   может   импортировать   файлы   подписок   opml   из  других
        RSS-просмотрщиков в свой собственный  формат  с  помощью  включенной  в
        поставку    программы   "opml2snow".    Конвертирование   opml-подписки
        производится командой "opml2snow MySubsriptions.opml", где  MySubscrip-
        tions.opml  -  имя файла, который вы желаете конвертировать.  Программа
        выдает  сконвертированные  данные   на   стандартный   вывод.   Команда
        "opml2snow  file.opml  >converted"  поместит сконвертированные данные в
        файл "converted", команда "opml2snow  file.opml  >>~/.snownews/urls"  -
        добавит   их   в  список  лент  Snownews.  Для  примеров  использования
        программы, запустите "opml2snow -h".                       :

        Во  время  просмотра  записи,  для  возвращения  к  предыдущему  экрану
        нажимайте 'q' или Enter. Курсор автоматически переместится на следующую
        непрочитанную запись.  Все новые записи в ленте можно прочитать подряд,
        последовательно  нажимая  Enter.   Программа выведет содержимое записи,
        Возвратится к списку, перескочит к следующей  непрочитанной  записи,  и
        опять же выведет ее содержимое. Вам остается только жать Enter.

                                          HTTP                     

        Клиент    HTTP   в   Snownews   следует   перенаправлениям   (redirect)
        HTTP-сервера.    Если   введенный   URL   указывает    на    постоянное
        перенаправление,  программа  изменит  используемый  ей  URL на новый. С
        этого момента запросы будут производиться по новому адресу.

        Snownews поддерживает HTTP и Cookies.  Чтобы подписаться
        на  ленту,  требующую аутентификации, используйте URL вида http://user-
        name:password@server/feed.rss.  Возможно также использовать cookies для
        передачи  аутентификационной  информации  на  вебсервер. Snownews будет
        использовать cookies, которые вы поместите в файл  ~/.snownews/cookies.
        Файл  должен быть в стандартном формате Netscape-овского cookies.txt. К
        примеру,  Mozilla  использует  этот  формат.   Snownews   автоматически
        посылает  нужные  cookie  на  нужный  вебсервер.  Возможно также просто
        создать символическую ссылку на файл с cookie вашего браузера, но лучше
        не   стоит.   Если  время  действия  cookie  прошло,  Snownews  выведет
        предупреждение при запуске, и не будет использовать этот  cookie.  Если
        cookie   помечен  как  безопасный  (должен  использоваться  только  при
        безопасном соединении через SSL), он также будет проигнорирован.

        При необходимости использования  для доступа в  интернет,
        установите   переменную   окружения   "http_proxy".   Snownews  ожидает
        получить   эту   переменную   в   формате   http://ваш_прокси.org:PORT/
        (http://proxy.ваш_провайдер.com:8080/).                             

        Раз  в  неделю  программа автоматически проверяет наличие новой версии.
        Будет произведен запрос файла с именем "version" с  вебсервера  проекта
        snownews   и   сравнение   полученного  значения  с  локальной  версией
        программы. Если они различаются, пользователю сообщается о  доступности
        новой  версии. Это делается при выходе из программы, чтобы сообщение не
        было  слишком  надоедливым.  Таким  образом  вы  можете  его   спокойно
        игнорировать,  если  не  желаете  или  не  можете  по каким-то причинам
        обновлять программу, например если используете пакет, поставлявшийся  с
        дистрибутивом  вашей  системы  и  т.п.  Для отключения данной проверки,
        впишите значение -1 в файл ~/.snownews/updatecheck.  Snownews  передает
        ничего  на  сервер  проекта.  Просто  скачивает  файл, содержащий номер
        версии и локально его сравнивает.

        --update or -u, Автоматически обновить все ленты при старте  программы.

        --help or -h, Вывести краткую справку об использовании, доступные опции
        командной строки и завершиться.  Show usage summary and available  com-
        mand line options and exit.

        --version or -V, Вывести версию программы и завершиться.
               
        /usr/local/bin/snownews
                               
        Вы спросите - почему "Snownews"? Ну, я согласен, эта программа не имеет
        ничего общего со снегом (snow), но если вы однажды заглянете ко мне  на
        веб-страницу, то сможете связать название с моим интересом к пушистости
        и снежным барсам.   Отсюда  и  название  "Snownews",  и  ничего  более,
        честно.  Первой  идеей  было  что-то  вроде rssnews или yarssnr, но мне
        показалось что это звучит  по-дурацки,  и  сменил  название  на  что-то
        совершенно  случайное  и  бессмысленное.   "Snownews" - это первое, что
        пришло в голову.

        Да, кстати, нажмите 'A' на основном экране.
                             
        http_proxy

               Snownews выходит в интернет через прокси-сервер, установленный в
               этой        переменной.         ожидаемый        формат        -
               http://ваш_прокси.org:PORT/.

        Если вы считаете, что нашли ошибку в Snownews, пожалуйста,  сообщите  о
        ней.   Всё, что приводит с краху программы, вне зависимости от того что
        вы делали - это ошибка, и её  необходимо  устранить.  Ошибки  обработки
        XML,  вероятно, не устранимы в самой Snownews, так как за обработку XML
        документа отвечает libxml.  Однако  сообщать  о  проблемных  лентах  не
        возбраняется, это может быть все же ошибка в Snownews.

        Пожалуйста,  прочтите   http://kiza.kcore.de/software/snownews/faq#toc4
        перед тем, как сообщать об ошибке.
               
        Oliver Feiler <kiza at kcore.de>