# Руководство &knewsticker;

&Frerich.Raabe; &Frerich.Raabe.mail;
&Jonathan.Singer; &Jonathan.Singer.mail;

    batalov@twiga.kz

2001, 2002, 2003 &Frerich.Raabe;
&FDLNotice;
2003-10-14
2.00.00

&knewsticker; - это монитор новостей для панели &kde; (известной как &kicker;).

KDE KNewsTicker kdenetwork news ticker applet

## Введение

&knewsticker; является аплетом системной панели &kde; (также известной как &kicker;) и предоставляет простой и удобный способ доступа к новостям с некоторых сайтов (типа Slashdot, &Linux; Weekly News или Freshmeat).

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

### Краткая информация о файлах &RSS;

Файлы &RSS; становятся всё более популярными, и этот аплет - не первое приложение, которое использует их. Но что из себя представляют файлы &RSS;? Этот раздел попробует дать краткий ответ на этот вопрос и предоставит ссылки на другие ресурсы по этой теме.

Коротко, &RSS; - это базирующийся на &XML; формат для получения содержимого из Интернет.

&RSS; часто используется как сокращение для Rich Site Summary (расширенного резюме сайта) – это не полное определение, но даёт представление о том что создатели &RSS; имели в виду. Фактически &RSS; не сокращение, а скорее название.

Первоначально &RSS; был разработан в 1999 году NetScape как формат поставки данных для их собственного сайта my.netscape.com. Самая первая версия &RSS; была выпущена под номером 0.9. Спустя несколько месяцев &Netscape; выпустила &RSS; версии 0.91, который включал в себя большинство особенностей формата <scriptingNews>.

Базовая концепция всех файлов &RSS; - предоставлять чистый, простой и переносимый способ распространения содержимого интернет, в основном, новостей: сайты новостей предоставляют файлы &RSS;, обычно содержащие заголовок и &URL; ссылающийся на полную статью. Файл &RSS; также содержит общую информацию о сайте новостей: его имя и адрес домашней страницы, которая может быть использована &knewsticker;.

В настоящее время существует несколько расширенных версий формата &RSS; (0.91, 0.92, 0.93, 1.0 и текущая версия формата 2.0), но первый две версии до сих пор используются в 85% файлов, представленных в Интернете. Однако все версии вплоть до 2.0 могут быть обработаны &knewsticker;!

Конечно, это краткая и не очень полная попытка объяснить основные идеи, заложенные в файлы &RSS;. Если вы интересуетесь этой темой, то можете посетить одну из следующих ссылок, которые указывают на более полные источники информации.

http://www.webreference.com/authoring/languages/xml/rss/intro/

  Очень прагматичное введение в формат &RSS;, с конкретными примерами и рекомендациями. Совместно с авторитетными спецификациями это даёт очень хорошее введение для людей, которые хотят использовать &RSS; на своих домашних страницах.

http://www.oreillynet.com/rss/

  Страница &RSS; издательства O'Reilly содержит множество статей об использовании файлов &RSS;, последние новости о &RSS;, информацию о сообществе разработчиков, а также информация для веб-разработчиков, которые хотят использовать &RSS;.

http://blogspace.com/rss/

  Это страница - другой превосходный источник новостей о развитии &RSS;, которая особенно интересна разработчикам, работающим с технологиями, базирующимися на &RSS;.

http://www.w3.org/RDF/

  Авторитетный источник по RDF, базирующемуся на языке &XML;, от которого происходят современные версии &RSS;, издаётся Консорциумом World Wide Web. Он содержит ссылки на другие сайты по этой теме, а также процесс развития RDF, обзоры архитектуры, архив статей о RDF, тщательно подобранный список инструментальных средств разработки для RDF.

Разработчики могут использовать авторитетные спецификации различных версий &RSS;:

Спецификации &RSS;

1. Версия 0.90: http://www.purplepages.ie/rss/netscape/rss0.90.html

2. Версия 0.91: http://backend.userland.com/rss091

3. Версия 0.92: http://backend.userland.com/rss092

4. Версия 0.93: http://backend.userland.com/rss093

5. Версия 1.0: http://web.resource.org/rss/1.0/

6. Версия 2.0: http://backend.userland.com/rss

Если вы нашли другие сайты или документы по этой теме, и считаете, что они стоят упоминания здесь, сообщите о них &Frerich.Raabe; &Frerich.Raabe.mail;, чтобы они были включены в этот документ и помогли другим.

Заранее благодарю!

## Запуск &knewsticker;

Это снимок экрана &knewsticker; в панели &kde;
Это снимок экрана &knewsticker; в панели &kde;

&knewsticker; запускается также, как и другие аплеты &kicker;. Вы должны только добавить его в панель (или любую дочернюю панель). Для этого щёлкните правой кнопкой мыши на панели &kde; и выберите в контекстном меню Добавить Аплет &knewsticker; .

Это снимок экрана &knewsticker; в дочерней панели.
Это снимок экрана &knewsticker; в дочерней панели.

Другой способ использования &knewsticker; - это поместить его в дочернюю панель. Создайте новую дочернюю панель, выбрав в контекстном меню панели Добавить Панель Дочерняя панель . Теперь вы должны щёлкнуть правой кнопкой мыши на дочерней панели и выбрать &knewsticker;, как было описано ранее.

Это снимок экрана &knewsticker; в отдельном окне.
Это снимок экрана &knewsticker; в отдельном окне.

Третий популярный способ запустить &knewsticker; - это выбрать в меню K Интернет&knewsticker; (Монитор новостей). Это запустит &knewsticker; в собственном окне. Вы можете перемещать и изменять его размеры по своему усмотрению.

## Настройка &knewsticker;

Вы можете вызвать диалог настройки &knewsticker;, щёлкнув правой кнопкой мыши на бегущей строке, либо щёлкнув на кнопке со стрелкой возле него и выбрав к контекстном меню Настроить KNewsTicker...

### Общие параметры

Вкладка Общие диалога настройки.
Вкладка Общие диалога настройки.

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

Чувствительность колёсика мыши:

  Этот бегунок позволяет определить скорость прокрутки текста при использовании колёсика мыши.

Интервал запроса новостей

  Здесь вы определяете интервал, через который &knewsticker; будет опрашивать серверы новостей на наличие новых заголовков. Он зависит от того, как быстро вы хотите получать новости и какую нагрузку вы готовы создать в сети:

  - Малый интервал (меньше 15 минут) позволяет вам получать новости очень быстро, если это вам необходимо. Обратите внимание, что это значительно увеличит сетевой трафик. Поэтому малое значение интервала не должно использоваться для популярных сайтов новостей (типа Slashdot или Freshmeat) поскольку они достаточно сильно загружены обработкой запросов.

  - Большое значение интервала (больше 45 минут) не позволит вам также быстро получать новости. Хотя для некритичных по времени приложений это может быть приемлемо. Положительный момент длительного интервала - это более низкая загрузка сети, что сберегает её ресурсы и нервы администраторов сайтов новостей.

  Значение по умолчанию (30 минут) является оптимальным в большинстве случаев.

Использовать другие имена для сайтов новостей

  Установите этот параметр, чтобы использовать собственные имена сайтов новостей (доступен на вкладке Источники новостей), вместо предоставляемых сайтами. Это может быть удобно, если сайты предоставляют очень длинные или бесполезные имена.

### Настройка источников новостей

Вкладка Источники новостей диалога настройки.
Вкладка Источники новостей диалога настройки.

На этой вкладке вы можете управлять списком сайтов новостей, которые будет опрашивать &knewsticker;. Щелчок правой кнопкой мыши на имени сайта открывает контекстное меню, которое позволяет вам удалить текущую запись или добавить новую. В нижней части диалога расположены три кнопки, которые имеют такое же предназначение.

#### Добавление сайта новостей

Существует четыре способа добавить новый сайт новостей в список:

- Вы можете щёлкнуть на кнопке Добавить....

- Вы можете щёлкнуть правой кнопкой мыши на таблице и выбрать Добавить новый источник.

- Вы можете перенести в таблицу любой файл &RSS; из другого приложение (типа &konqueror;). Это добавит новую запись в список под именем Неизвестный и устанавливает максимальное количество заголовков в 10.

- И последнее: вы можете щёлкнуть на любом файле &RSS; в менеджере файлов &konqueror; чтобы добавить его в список.

В любом случае появится Диалог источника новостей, который позволяет настроить свойства добавляемого источника новостей.

#### Изменение существующих сайтов новостей

Существует два способа настроить свойства существующего сайта новостей:

- Вы можете нажать кнопку Изменить....

- Вы можете щёлкнуть правой кнопкой мыши на имени сайта и выбрать в контекстном меню Изменить '...'

Независимо от того, какой способ вы выбрали, появится Диалог источника новостей, содержащий текущие параметры выбранного сайта новостей.

#### Удаление сайта новостей

Конечно, вы можете в любое время удалить сайт новостей из списка.

- Нажмите кнопку Удалить.

- Щёлкните правой кнопкой мыши на имени сайта и выберите в контекстном меню Удалить '...'

В обоих случаях появится диалог подтверждения удаления сайта из списка.

Вы можете удалить несколько сайтов за один раз, удерживая нажатой клавишу &Ctrl; и щёлкая на записях, которые вы хотите удалить, либо при нажатой левой кнопке мыши перемещайте её по записям, которые вы хотите выбрать.

#### Диалог сайта новостей

Диалог для добавление и изменения сайтов новостей.
Диалог для добавление и изменения сайтов новостей.

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

Имя:

  Это имя сайта новостей.

  Этот текст будет использоваться только если во вкладке Общие установлен параметр Использовать другие имена для сайтов новостей.

Файл источника новостей:

  Здесь вы можете указать &URL;, ссылающийся на файл &RSS; для этого сайта, это может быть ссылка на локальный файл либо на файл, расположенным в сети. Вы также можете нажать кнопку справа от поля и открыть диалог выбора файла и в нём выбрать файл, который вы хотите использовать, вместо того, чтобы набирать его &URL; вручную.

Файл является программой

  Если опция включена, &knewsticker; будет предполагать что &URL; (указанный в поле Файл источника новостей) не является ссылкой на файл &RSS;, а указывает на программу (обычно сценарий). При выполнении запроса к этому сайту новостей &knewsticker; запустить программу и обработает её вывод как разметку &RSS;. Это очень удобно для преобразующих сценариев, которые загружают файл &HTML; и обрабатывают его, преобразуя в формат &RSS;, который пригоден для использования в &knewsticker;.

  Вы можете найти некоторые сценарии в каталоге `knewsticker-scripts` модуля kdeaddons.

Категория:

  Здесь вы можете указать категорию, которой принадлежит сайт. Разделение сайтов по категориям позволяет упростить управление большими списками сайтов новостей.

Максимальное количество статей:

  Этот параметр определяет сколько статей с этого сайта &knewsticker; будет хранить в своём кэше. Это значение никогда не будет превышаться.

  Это особенно удобно для сайтов, которые предоставляют только по три статьи за один раз, но вы хотите видеть, например, последние десять; &knewsticker; будет загружать эти три статьи и добавлять их в список содержащий предыдущие семь статей.

Пиктограмма:

  Здесь вы можете указать &URL; файла изображения (предпочтительно размером 16x16 точек), которое будет использоваться для этого сайта новостей. Пиктограммы позволяют различать множество сайтов новостей, и определить какому сайту принадлежит прокручиваемый в &knewsticker; заголовок.

В нижней части диалога вы можете найти несколько кнопок, одна из которых заслуживает особого внимания: нажатие кнопки Определить автоматически указывает &knewsticker; попытаться определить подходящие значения для большинства параметров, если вы указали &URL; корректного исходного файла.

Это означает, что обычно вы можете только вставлять в поле Файл источника новостей, &URL; файла &RSS;, нажать кнопку Определить автоматически и затем изменить предложенные значения, если они вас чем-то не устраивают.

### Фильтры

Вкладка Фильтры диалога настройки.
Вкладка Фильтры диалога настройки.

Эта вкладка позволяет вам определить фильтры, которые будут применяться перед отображением заголовка в бегущей строке.

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

Основная часть вкладки занята таблицей, содержащей текущие фильтры. Каждый фильтр имеет переключатель - выбор которого включает фильтр, отмена выбора временно отключает фильтр без удаления его из списка.

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

- Чтобы добавить фильтр, просто установите его параметры (детальное описание различных параметров фильтра смотрите в Компоненты фильтра), используя поля ввода в разделе Свойства фильтра и нажмите кнопку Добавить.

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

- Для удаления фильтра, выберите его в таблице и нажмите кнопку Удалить.

#### Компоненты фильтра

Каждый фильтр состоит из четырёх частей:

Компоненты фильтра

1. Действие – может быть Показать либо Скрыть и определяет, что произойдёт с заголовком, когда он будет соответствовать фильтру.

2. Сайт новостей – здесь вы можете определить, на какой сайт новостей фильтр будет воздействовать, либо он будет применяться ко всем сайтам.

3. Условие – это глагол, который совместно с выражением определяет соответствие фильтра. Условие может быть ⪚ содержит, не равен либо соответствует. Дальше они описаны более подробно.

4. Выражение - это определённое пользователем строка, которая совместно с условием формирует тело фильтра. Более подробное описание этого компонента смотрит ниже.

Все эти компоненты могут быть настроены с использованием средств в разделе Свойства фильтра. Возможные состояния компоненты Условие заслуживают отдельного объяснения:

- содержит, не содержит: этот фильтр соответствует, если заголовок содержит или не содержит указанное выражение.

  Выражение не зависит от регистра, так KDE, kDE либо kde будет соответствовать всем заголовкам, содержащим KDE.

- равен, не равен: фильтр соответствует если заголовок равняется или не равняется указанному выражению.

  Выражение обрабатывается с учётом регистра, так что из Linux, linux и LINUX только первое будет соответствовать заголовку Linux.

- соответствие: использование этого условия указывает &knewsticker; интерпретировать выражение как регулярное. Более подробную информацию о регулярных выражения вы можете найти в этой статье опубликованной www.evolt.org.

### Свойства прокрутки

Вкладка Полоса прокрутки диалога настройки.
Вкладка Полоса прокрутки диалога настройки.

Эта вкладка позволяет определить некоторые параметры бегущей строки &knewsticker;:

Скорость прокрутки

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

Направление прокрутки

  Эти параметры определяют в каком направлении текст будет прокручиваться, ⪚ влево либо вправо, вверх или вниз. Здесь вы также можете повернуть текст на 90 или 270 градусов, для лучшего чтения, что имеет смысл для вертикально расположенных панелей.

Шрифт

  Нажмите кнопку Шрифт... для выбора шрифта, который будет использоваться для отображения прокручиваемого текста.

  Некоторые шрифты читаются тяжелее, чем другие, особенно когда они прокручиваются. Так что вы должны выбрать шрифт, который легко читается в движении.

Цвет текста

  Нажатие этой кнопки открывает диалог выбора цвета прокручиваемого текста.

Цвет фона

  Нажатие этой кнопки открывает диалог выбора цвета фона аплета.

Цвет выделения

  Нажатие этой кнопки открывает диалог выбора цвета, который будет использоваться для отображения подсвеченного текста (когда вы помещаете курсор мыши над ним).

Прокручивать только самые свежие новости

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

Показывать пиктограммы

  Включение этой опции указывает &knewsticker; отображать пиктограмму (если она доступна) перед каждым заголовком, что позволяет легко определить, какому сайту принадлежит конкретный заголовок.

Временно замедленная прокрутка

  Включение этой опции указывает &knewsticker; снижать скорость прокрутки, если вы перемещаете курсор мыши на прокручиваемый текст. Это делает щелчки на элементах намного более простыми.

Подчёркивать выделенную новость

  Включите эту опцию, чтобы выделенный заголовок (находящийся под курсором мыши) подчёркивался.

## Использование &knewsticker;

Использование &knewsticker; является достаточно простым и не должно вызывать у вас затруднений, если вы уже настроили &knewsticker;. Независимо от того, выполняется ли &knewsticker; в главной, дочерней панели или в собственном окне, программа работает в виде бегущей строки и кнопки со стрелкой.

### Основной интерфейс

Область (белая по умолчанию, но вы можете изменить цвет фона в диалоге параметров) с бегущим текстом называется полоса прокрутки новостей. Она прокручивает загруженные заголовки (либо недавние заголовки) и обеспечивает простой переход к статьям. Если вы видите интересную статью, просто щёлкните по ней, чтобы открыть браузер &konqueror;, отображающий полную статью, на заголовке которой вы щёлкнули. Если вы заметили, что интересный заголовок был уже прокручен, у вас есть несколько способов повлиять на прокрутку.

- Вы можете щёлкнуть на полосе прокрутки левой кнопкой мыши и переместить мышь (при нажатой левой кнопке). Полоса прокрутки продолжит прокрутку, когда вы отпустите кнопку мыши.

- Если у вас мышь с колёсиком, вы можете использовать его для прокручивания заголовков назад и вперёд.

Есть также очень мощное контекстное меню, вызвать которое вы можете, щёлкнув правой кнопкой мыши на полосе прокрутки, либо нажав кнопку со стрелкой. Это меню - самая интересная часть аплета, поскольку содержит все функциональные возможности.

### Контекстное меню

Контекстное меню &knewsticker; когда вы используете сайты новостей, настроенные по умолчанию.
Контекстное меню &knewsticker; когда вы используете сайты новостей, настроенные по умолчанию.

Контекстное меню разделено на две функциональные части.

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

Нижняя часть содержит пять пунктов (описываются сверху вниз):

Проверить новости

  Этот пункт имеет пиктограмму . Если вы хотите, чтобы &knewsticker; проверил настроенные сайты на наличие новых статей, выберите его.

  Это не перезапустит внутренний таймер, который автоматически выполняет опрос сайтов через определённые промежутки времени.

Автономный режим

  Этот пункт не имеет пиктограммы. Выберите его, чтобы установить специальный автономный режим, который приостанавливает внутренний таймер опроса серверов новостей. Автономный режим бывает полезен, когда вы оставляете свой компьютер на некоторое время не подключённым к Интернету. Это приостановит показ сообщений об ошибках, которые происходят при попытках опроса сервера новостей.

  Выбирая соответствующий пункт Проверить новости, вы можете вызвать загрузку свежих статей с одного или всех сайтов.

Справка

  Этот пункт отмечен пиктограммой . Щелчок на нём откроет документацию по &knewsticker; (который вы сейчас читаете), который описывает все особенности и возможности &knewsticker;.

О программе &knewsticker;.

  Этот пункт отмечен пиктограммой . Щелчок на нём откроет небольшой диалог с информацией о разработчиках &knewsticker; и обо всех, кто принимал участие в разработке.

Параметры

  Этот пункт легко опознаётся по пиктограмме . Выбор этого пункта откроет диалог настройки, где вы можете настроить все опции &knewsticker;.

## Часто задаваемые вопросы

&reporting.bugs;

Где я могу найти файлы &RSS; для сайта новостей XYZ?

Возможно сайт, к которому вы обращаетесь, не предоставляет вообще никаких файлов &RSS;. Ниже представлен список сайтов, которые предоставляют доступ к тысячам файлов &RSS;, отсортированных по языку и/или теме.

- WebReference.com

- NewsIsFree

- MoreOver

Если вы нашли любые интересные сайты, предоставляющие такие возможности, напишите о них &Frerich.Raabe; &Frerich.Raabe.mail;, чтобы они были включены в следующие выпуски!

Как сделать, чтобы &knewsticker; открывал статьи в другом браузере (например, Mozilla)?

&knewsticker; использует браузер, который связан с типом &MIME; text/html. Браузер по умолчанию, используемый для страниц &HTML; - это &konqueror;.

Вы можете найти поменять привязку приложения к типу MIME в Центре управления &kde;: Компоненты KDE Привязки файлов.

## Авторы и лицензия

&knewsticker;

Авторское право на программу 2000, 2001, 2002, 2003 &Frerich.Raabe; &Frerich.Raabe.mail;

Принимали участие:

- Malte Starostik malte.starostik@t-online.de

- &Wilco.Greven; &Wilco.Greven.mail;

- Adriaan de Groot adrig@sci.kun.nl

Авторское право на документацию 2001, 2002, 2003 &Frerich.Raabe; &Frerich.Raabe.mail;

Олег Баталов - Перевод на русский batalov@twiga.kz

Редакция русского перевода - Григорий Мохин mok@kde.ru

&underFDL; &underBSDLicense;

## Глоссарий

Эта глава предназначена для объяснения значений всевозможных сокращений, которые используются в документации &knewsticker;. Если вы видите, что некоторые сокращения отсутствуют в этом списке, сообщите об этом &Frerich.Raabe; &Frerich.Raabe.mail;, чтобы они были сюда добавлены!

RDF

  Resource Description Framework (Структура описания ресурса). Язык, основанный на &XML;, который описывает метаданные. Обычно используется как внутренний формат для статей и других публикаций. Поле подробную информацию о файлах RDF, вы можете найти на официальной странице файлов RDF Консорциума World Wide Web.

&RSS;

  RDF Site Summary (Резюме сайта RDF) -- расширение языка RDF. Цитата из официальной спецификации &RSS; v1.0:

  RDF Site Summary (&RSS;) - облегчённое многоцелевое расширяемое описание метаданных и формат объединения в синдикаты. &RSS; является приложением &XML;, соответствует спецификации W3C RDF и расширяем через пространство имён &XML; и/или базирующийся на RDF модуляризации.

&XML;

  Extensible Markup Language (расширяемый язык разметки) - универсальный формат для структурированных документов и данных в Интернете. Это производный язык от SGML, который соответствует потребностям Интернета. Для получения дополнительной информации вы можете посетить страницу расширяемого языка разметки в Консорциуме World Wide Web.

W3C

  Сокращение для Консорциум World Wide Web. Цитата с официальной страницы W3C, Консорциум World Wide Web (W3C) разрабатывает технологии взаимодействия (спецификации, руководства, программное обеспечение и инструментарии), чтобы раскрыть полный потенциал сети как места для информации, торговли, общения и коллективного взаимопонимания.

&URL;

  &URL; означает Uniform Resource Locator (универсальный указатель ресурса) -- специально оформленную строку, указывающую на какой-либо ресурс типа изображения, документа и другого объекта в Интернете. Более детальную информацию по этой теме вы можете найти на этой странице.

&DCOP;

  Desktop COmmunication Protocol (Протокол взаимодействия на рабочем столе) - способ связи между приложениями. Например, диалог настройки &knewsticker; использует &DCOP;, чтобы сообщить аплету текущие параметры.

  &knewsticker; предоставляет интерфейс &DCOP;, который позволяет управлять большинством функций &knewsticker; из командной строки.

  Более детальную информацию о &DCOP; можно найти по адресу http://developer.kde.org/documentation/library/2.0-api/dcop/HOWTO.html.

## Информация для разработчиков и продвинутых пользователей

&knewsticker; имеет богатый и постоянно развивающийся интерфейс &DCOP;. Он может использоваться не только для связи между приложениями, но и позволяет управлять &knewsticker; из сценариев. Чем больше возможностей предоставляет интерфейс, тем гибче можно управлять &knewsticker; из сценариев.

Для вызова функций &DCOP; вы можете использовать утилиту командной строки dcop, либо удобное графическое приложение KDCOP. Обе они предоставляют одинаковые функциональные возможности, так что какую из программу использовать -- дело вашего личного вкуса. :-)

В этой главе предполагается, что вы используете dcop. Для доступа к функциям &DCOP; &knewsticker; удостоверьтесь, что он запущен и затем введите в консоли что-либо вроде:

    % dcop knewsticker KNewsTicker [function]

Если появится ошибка, говорящая что `dcop` не может быть найден, проверьте, существует ли в каталоге `$`KDEDIR`/bin` файл `dcop` и правильно ли у него установлены права доступа.

В командной строке замените [function] на реальное имя функции, то есть, наберите

    % dcop knewsticker KNewsTicker updateNews

чтобы указать &knewsticker; проверить сайты новостей и загрузить с них статьи, если это необходимо.

### Справочник по &DCOP;

В этом разделе описаны все методы &DCOP; интерфейса &knewsticker;.

`updateNews`

  Эта функция указывает &knewsticker; обновить внутренний список статей (например, опрашиваются источники новостей, которые были настроены, на получение новых статей) и загрузить их при необходимости.

  Эта функция работает только если &knewsticker; находится в автономном режиме.

  Пример:

      % dcop knewsticker KNewsTicker updateNews

`reparseConfig`

  Команда `reparseConfig` указывает &knewsticker; перезагрузить параметры из файла конфигурации. Эта функция используется диалогом настройки, чтобы сообщить &knewsticker; об изменении параметров, но вы можете использовать её при ручном изменении файла конфигурации.

  Параметры настройки сохраняются в файле `~/.kde/share/config/knewsticker_appletrc`

  Пример:

      % dcop knewsticker KNewsTicker reparseConfig

`setOfflineMode [bool]`

  Вы можете использовать эту функцию, чтобы перевести &knewsticker; в автономный режим (то есть должен ли &knewsticker; загружать статьи из настроенных источников новостей).

  Пример:

      % dcop knewsticker KNewsTicker setOfflineMode true

  для включения автономного режима, либо наберите

      % dcop knewsticker KNewsTicker setOfflineMode false

  для его отключения.

`interval`

  Возвращает установленный интервал опроса сайтов новостей в минутах.

  Пример:

      % dcop knewsticker KNewsTicker interval
                              30
                              %

`scrollingSpeed`

  Возвращает установленную скорость прокрутки текста. Скорость указывается в точках в секунду.

  Пример:

      % dcop knewsticker KNewsTicker scrollingSpeed
                              20
                              %

`mouseWheelSpeed`

  Возвращает количество точек прокрутки, приходящиеся на один шаг колёсика мыши.

  Пример:

      % dcop knewsticker KNewsTicker mouseWheelSpeed
                              15
                              %

`scrollingDirection`

  Возвращает целое число, соответствующее направление прокрутки текста:

  - 1 = влево

  - 2 = вправо

  - 3 = вверх

  - 4 = вниз

  - 5 = вверх, повёрнуто

  - 6 = вниз, повёрнуто

  Пример:

      % dcop knewsticker KNewsTicker scrollingDirection
                              1
                              %

`customNames`

  Возвращает 'true' или 'false' в зависимости от того, используются ли в &knewsticker; другие имена для источников новостей.

  Пример:

      % dcop knewsticker KNewsTicker customNames
                              false
                              %

`endlessScrolling`

  Возвращает 'true' или 'false' в зависимости от того, включена ли в &knewsticker; опция бесконечной прокрутки.

  Пример:

      % dcop knewsticker KNewsTicker endlessScrolling
                              true
                              %

`scrollMostRecentOnly`

  Возвращает 'true' или 'false' в зависимости от того, использует ли &knewsticker; только самые последние новости каждого сайта.

  Пример:

      % dcop knewsticker KNewsTicker scrollMostRecentOnly
                              false
                              %

`offlineMode`

  Возвращает 'true' или 'false' в зависимости от того, находится ли &knewsticker; в автономном режиме.

  Пример:

      % dcop knewsticker KNewsTicker offlineMode
                              false
                              %

`underlineHighlighted`

  Возвращает 'true' или 'false' в зависимости от того, подчёркивает ли &knewsticker; выделенные заголовки, находящиеся под курсором мыши.

  Пример:

      % dcop knewsticker KNewsTicker underlineHighlighted
                              true
                              %

`showIcons`

  Возвращает 'true' или 'false' в зависимости от того, отображает ли &knewsticker; пиктограммы соответствующих сайтов перед каждым заголовком.

  Пример:

      % dcop knewsticker KNewsTicker showIcons
                              true
                              %

`slowedScrolling`

  Возвращает 'true' или 'false' в зависимости от того, установлен ли в &knewsticker; параметр замедление прокрутки.

  Пример:

      % dcop knewsticker KNewsTicker slowedScrolling
                              false
                              %

`foregroundColor`

  Возвращает текущий цвет текста в формате #rrggbb, где rr, gg и bb - двухзначные значения, представляющие соответственно красную, зелёную и синюю компоненты в диапазоне 00-ff.

  Пример:

      % dcop knewsticker KNewsTicker foregroundColor
                              #804000
                              %

`backgroundColor`

  Возвращает текущий цвет фона в формате #rrggbb, где rr, gg и bb - двухзначные значения, представляющие соответственно красную, зелёную и синюю компоненты в диапазоне 00-ff.

  Пример:

      % dcop knewsticker KNewsTicker backgroundColor
                              #0030ff
                              %

`highlightedColor`

  Возвращает текущий цвет подсвеченного текста в формате #rrggbb, где rr, gg и bb - двухзначные значения, представляющие соответственно красную, зелёную и синюю компоненты в диапазоне 00-ff.

  Пример:

      % dcop knewsticker KNewsTicker highlightedColor
                              #000080
                              %

`newsSources`

  Возвращает список настроенных источников новостей. Обратите внимание, что возвращаются все источники новостей, а не только выбранные. Каждый источник выводится на отдельной строке.

  Пример:

      % dcop knewsticker KNewsTicker newsSources
                              Freshmeat
                              GNOME News
                              dot.kde.org
                              Slashdot.org
                              %

&documentation.index;