Документация для TWBlue - 0.88

Содержание

Внимание!

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

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

Введение

TWBlue - это программа, делающая работу с твиттером простой и быстрой, используя минимум ресурсов. При помощи TWBlue можно выполнять следующие действия:

Использование

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

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

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

Мы начнем, исходя из того, что у вас уже есть учетная запись в Твиттере с соответствующими именем пользователя и паролем.

Авторизация приложения

Прежде всего, для того, чтобы программа могла получить доступ к вашей учетной записи в Твиттере и работать от вашего имени, ее нужно авторизовать. Процесс авторизации довольно прост, и такие данные, как ваш пароль, нигде не сохраняются. Для того, чтобы авторизовать приложение, нужно всего лишь запустить основной исполняемый файл, TWBlue.exe (на некоторых компьютерах он может называться просто TWBlue, если в проводнике Windows не включено отображение расширений). Для удобства мы советуем создать на рабочем столе ярлык, указывающий на этот файл.

Вы можете одновременно входить под несколькими учетными записями. Каждая учетная запись (аккаунт), в программе называется "сессией". Если вы впервые запустили TWBlue, и ни одной сессии не существует, появится менеджер сессий. В этом диалоговом окне можно авторизовать сколько угодно учетных записей. Если вы нажмете клавишу Таб, дойдете до кнопки "Добавить аккаунт", и активируете ее Пробелом, откроется диалоговое окно, предлагающее открыть ваш интернет браузер по умолчанию для того, чтобы авторизовать приложение, и вам будет предложено продолжить. Активируйте кнопку "Да" нажав букву "Y" и процесс запустится.

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

Как только ваша учетная запись будет авторизована, сайт Твиттера перенаправит вас на страницу, сообщающую о том, что авторизация TWBlue прошла успешно. Теперь вы можете закрыть страницу, нажав Альт + F4 и вернуться в менеджер сессий. В списке сессий появится новый элемент под временным названием "Авторизованный аккаунт X", где x - это номер. Название сессии изменится сразу же, как только вы ее откроете.

Чтобы начать работу с TWBlue, нажмите кнопку ОК в диалоге менеджера сессий. По умолчанию, программа запускает все созданные сессии автоматически, однако, это можно изменить.

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

По окончании этого процесса, по умолчанию прозвучит еще один звук и программа экранного доступа скажет "Готово" (это тоже можно перенастроить).

Основные понятия

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

Буфер

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

Ниже дано описание каждого из буферов TWBlue и типа элементов, с которым он работает.

Если в твите содержится ссылка, ее можно открыть, нажав клавишу Ввод в окне программы, либо нажав сочетание клавиш Контрол + Виндовс + Ввод в невидимом интерфейсе. Если присутствует аудио, его можно прослушать, нажав Контрол + Ввод или Контрол + Виндовс, + Альт, + Ввод соответственно. Если в твите присутствует хэштег (метка) #audio, TWBlue проиграет звук, но аудио может содержаться и в твитах, не имеющих этой метки. Наконец, если в твите содержится информация о местоположении, нажмите Контрол + Виндовс + G в невидимом интерфейсе, чтобы ее прочитать.

Поля ввода имени пользователя

В эти поля можно вводить имя пользователя Твиттера без знака Собачка (эт). Их можно увидеть в диалоговых окнах отправки личных сообщений и меню действий с пользователем. Об этих диалоговых окнах мы поговорим позже. Первоначальное значение этих полей зависит от того, где они были открыты. Такое поле ввода заполняется именем пользователя, написавшего твит, находящийся в фокусе (если он открыт из главной ленты, ленты отправленных твитов, ленты пользователя или из списка); именем отправителя личного сообщения (в буферах полученных и отправленных личных сообщений), или, если в фокусе находится пользователь (в буферах Читающие и Читаемые. Если одно из этих диалоговых окон открыто из твита, и, если в нем упомянуто несколько пользователей, перемещаться по ним можно клавишами стрелок. Либо, вы можете сами ввести имя пользователя

Интерфейс программы

Графический пользовательский интерфейс

Графический интерфейс TWBlue представляет собой окно, содержащее:

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

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

Кнопки приложения

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

Меню

Визуально, в верхней части главного окна программы, находится строка меню, в котором представлены многие из функций, описанных в предыдущем разделе, а также некоторые другие элементы. Чтобы войти в строку меню, нажмите клавишу Альт. Откроется список из шести меню: Приложение, Твит, Пользователь, Буфер, Аудио и Помощь. В данном разделе описаны элементы каждого из них.

Меню Приложения
Меню Твит
Меню Пользователь
Меню Буфер
Меню Аудио
Меню Помощь

Невидимый интерфейс

Невидимый интерфейс, как следует из названия, не имеет графического окна и работает напрямую с программами экранного доступа, такими как JAWS для Windows, NVDA и System Access. По умолчанию этот интерфейс отключен, но его можно включить нажав Контрол + M. Он работает подобно TheQube и Chicken Nugget. Горячие клавиши также похожи на те, что используются в этих клиентах. Кроме того, в программе имеется возможность редактирования клавиатурных команд, которую можно выбрать в Основных настройках. По умолчанию, с горячими клавишами этого интерфейса невозможно работать в графическом окне, но этот параметр можно изменить в Основных настройках.

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

Список горячих клавиш

Горячие клавиши для графического интерфейса

Горячие клавиши для невидимого интерфейса

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

Настройка

Как описано выше, в данном приложении имеется два диалога настроек: диалог основных настроек и диалог настройки учетной записи.

Диалог настройки учетной записи

Вкладка Общие

Вкладка Буферы

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

Вкладка Игнорируемые клиенты

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

Вкладка Звук

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

Вкладка Сервис аудио

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

Основные настройки

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

Вкладка Общие

Вкладка Прокси

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

Лицензия, исходный код и пожертвования

Tw Blue - это бесплатная программа, распространяемая по лицензии GNU GPL, начиная с версии 2 и выше (на ваше усмотрение. Просмотреть текст лицензии на английском языке можно в файле license.txt, или он-лайн по ссылке http://www.gnu.org/licenses/old-licenses/gpl-2.0.html.

Исходный код программы доступен на GitHub, на странице https://www.github.com/manuelcortez/twblue.

Если вы хотите внести материальное пожертвование для проекта,сделать это можно на https://twblue.es/donate. Спасибо за вашу поддержку!

Контакт

Если, после прочтения этого документа, у вас все еще остались вопросы, если вы хотите каким-либо образом сотрудничать с проектом, или, если вы просто хотите связаться с разработчиком этого приложения, начните читать в Твиттере пользователя @tw_blue2 или @manuelcortez00.. Вы также можете посетить наш сайт

Благодарности

Разрабатывают и поддерживают TWBlue Мануэль Кортес и Хосе Мануэль Деликадо.

Также хотим выразить благодарность переводчикам TWBlue, сделавшим возможным распространение приложения.

Также огромная благодарность всем, кто работал над документацией. Изначально Мануэль Кортес создал документацию на испанском языке, затем она была переведена на английский пользователями Bryner Villalobos, Robert Spangler, Sussan Rey, Anibal Hernandez, и Holly Scott-Gardner. Текст был обновлен пользователем Sukil Etxenike, ценные исправления внесли Brian Hartgen и Bill Dengler.


Авторское право © 2013-2017. Manuel Cortéz