Documentación para o TWBlue - 0.88

índice

Atención!

Estás lendo documentación producida para un programa en estado de desenvolvemento. A intención deste manual é clarificar algúns detalles sobre o funcionamento do programa. Ten en conta que ao ser activamente desenvolto, o software pode cambiar parte desta documentación nun futuro relativamente cercano, así que é recomendable botar unha ollada de vez en cando para non perderte demasiado.

Se queres ver o que cambiou con respecto á versión anterior, le a listaxe de novidades aquí.

Introducción

TW Blue é unha aplicación para empregar twitter de maneira sinxela, rápida, mentres se evita consumir tantos recursos como sexa posible. Coa aplicación poderás facer accións en twitter tales como:

Uso

Twitter é unha rede social ou ferramenta de micro-blogging que che permite compoñer curtas actualizacións de estado das túas actividades en 280 caracteres ou menos. Twitter é un xeito para que amigos, familiares e compañeiros de traballo se comuniquen e permanezan conectados a través do intercambio de mensaxes rápidas e frecuentes. Podes restrinxir a entrega de actualizacións aos membros do teu círculo de amigos ou, de xeito predeterminado, permitir que calquera persoa teña aceso a elas.

Podes monitorizar as actualizacións de estado dos teus amigos, familia e compañeiros de traballo (o que se coñece como seguir a alguén), e eles á vez poden ver as actualizacións que ti publicas (o que se coñece como seguidores). As actualizacións chámanse chíos. Os chíos publícanse no teu perfil en Twitter e poden verse en blogs e outras páxinas web.

Para usar o TWBlue, primeiro debes ter creada unha conta no sitio web de Twitter. O proceso de rexistro en Twitter é moi accesible. Ó te rexistrar, terás que escoller un nome de usuario. issto sirve para dous propósitos. A través do teu nome de usuario a xente comunicarase contigo, pero o máis importante, é que se necesitará o teu nome de usuario e un contrasinal para dar permiso ó TWBlue para usar a túa conta. Xuxerímosche que escollas un nome de usuario que resulte doado de lembrar para ti e para os teus futuros seguidores.

Para esta guía asumirase que tes unha conta de Twitter e o seu contrasinal correspondente.

Autorizando a aplicación

Antes de nada, o primeiro que se precisa é autorizar ao programa para que este poida acceder á túa conta de Twitter, e dende ela realizar o que lle pidas. O proceso de autorización é bastante doado , e en ningún momento o programa poderá ter acceso aos teus datos como o usuario e contrasinal. Para autorizar a aplicación, só tes que abrir o arquivo principal do programa, chamado TW Blue.exe (nalgúns PC, só se amosa como TW Blue) se o explorador de Windows non está configurado para amosar as extensións de arquivos). Se usas unha versión portable, suxerímosche crear un acceso directo no escritorio para acceder ó programa máis rápida e cómodamente.

Podes comezar a sesión con varias contas de Twitter ó mesmo tempo. O programa refírese a cada conta que teñas configurada como "sesión". Se é a primeira vez que abres o TWBlue, ou se non configuraches antes unha sesión, verás o xestor de sesións. Este diálogo permíteche autorizar todas as contas que desexes. Se premes sobre o botón "Nova conta", unha mensaxe informarache de que se abrirá o teu navegador para autorizar a aplicación. Preme "si" para comezar o proceso.

A continuación, o teu navegador predeterminado abrirase coa páxina de Twitter solicitándoche autorizar a aplicación. Escrebe, se non estás autenticado xa, o teu nome de usuario e contrasinal, logo busca o botón autorizar, e prémeo.

Unha vez que autorizaras a túa conta de Twitter, Twitter redirixirache cara unha páxina que che notificará que o TWBlue foi correctamente autorizado. Agora podes pechar o navegador e voltar ó xestor de sesións. Na lista de sesións, poderás ver un novo elemento chamado temporalmente "Conta autorizada x", onde x é un número. O nome cambiará unha vez que comeces esa sesión.

Para arrancar o TWBlue, preme o botón aceptar no xestor de sesións. De xeito predeterminado, TWBlue inicia todas as sesións configuradas automáticamente, nembargantes, podes modificar este comportamento máis adiante.

Se todo saíu ben , a aplicación comezará a reproducir un grupo de sons en sinal de que se están a actualizar os teus datos.

Cando o proceso remate, o programa reproducirá outro son, e o lector de pantalla dirá "listo" (Isto pode configurarse dende as opcións globais).

Conceptos xerais

Antes de profundizar no uso do TWBlue, é necesario explicar algúns conceptos que se usarán extensivamente ao longo desta guía.

Búfer

Un Búfer é unha lista de elementos para manexar a información que provén do Twitter, despois de seren procesada pola aplicación. Cando configuras e comezas unha sesión no TWBlue, este crea algúns búferes. Cada un deles pode conter elementos cos que traballa o programa: Chíos, mensaxes directas, usuarios, tendencias ou eventos. Dependendo do búfer no que te atopes, serás capaz de realizar distintas accións cos seus elementos.

A continuación vai unha descripción para cada búfer e os diferentes tipos de elementos que poden conter.

Se un chío contén un enderezo web, podes premer intro na interfaz gráfica ou control + Windows + Intro na interfaz invisible para abrilo. Se inclúe un arquivo de audio, podes premer Control + Enter ou control + Alt + Windows + Enter para reproducilo, respectivamente. TWBlue reproducirá un son cando o chío conteña a etiqueta #audio, pero os chíos poderían incluir ficheiros de audio sen esta etiqueta. Finalmente, se o chío inclúe información xeográfica, podes premer Control + Windows + G na interfaz invisible para recuperala.

Campos para nome de usuario

Estos campos esperan un nome de usuario de Twitter (sen o signo de arroba). Están presentes nos diálogos para enviar mensaxes directas así como no diálogo de accións de usuario. Estos diálogos serán tratados máis tarde. O valor inicial de estos campos depende do lugar dende onde foron abertos. Estos campos rechéanse automáticamente co nome de usuario do chío actual (se foi aberto dende o búfer principal ou dende enviados, dende unha liña temporal dun usuario ou unha lista), o usuario que enviou a mensaxe directa actual (se se abre dende o búfer de mensaxes directas ou mensaxes directas enviadas) ou do usuario actual (dende o búfer de amigos ou seguidores). Se un destos diálogos se abre dende un chío, e se hai máis de un usuario mencionado, podes usar as frechas de arriba/abaixo para conmutar entre eles. Alternativamente, podes escreber manualmente o usuario de Twitter no campo de texto.

A interfaz do programa

A interfaz gráfica de usuario (GUI)

A interfaz gráfica do TWBlue está formada por unha ventá que contén os seguintes elementos:

As accións dispoñibles para cada un destos elementos serán retomadas máis adiante.

En resume, a interfaz gráfica contén dous compoñentes importantes. Estos son o grupo de controis que atoparás se premes tab na ventá gráfica, e os diferentes elementos que están na barra de menú.

Botóns na aplicación

Ten en cuenta que os botóns aparecerán según as accións que se podan facer na lista onde esteas. Por exemplo, na liña principal, menciones, enviados, chíos marcados como gústame e as liñas temporais dos usuarios poderás ver os catro botóns; mentres que na lista de mensaxes directas só estará dispoñible o botón de "Mensaxe Directa" e "chío", e nas listas de amigos e seguedores, verase o botón para "Chío" e o de "Mensaxe directa" xunto con "mencionar".

Visualmente, na parte superior da ventá do programa poderás atopar unha barra de menú que fai as mesmas cousas, e algunhas cantas máis. Á barra de menú accédese premendo a tecla ALT, e conta neste momento con seis menús para diferentes accións: Aplicación, chío, usuario, Búfer, audio e Axuda. Nesta sección descríbense as accións para cada un deles.

A interfaz invisible de usuario

A interfaz invisible, tal como o indica o seu nome, non ten ventá gráfica e funciona directamente cos lectores de pantalla como JAWS for Windows, NVDA e System Access. Esta interfaz atópase desactivada por defecto, pero podes activala premendo Control + M. Funciona de forma parecida a The Qube e Chicken Nugget. as Súas combinacións de teclado son semellantes ás que existen en ambos os dous clientes. Ademáis, o programa inclúe soporte para mapas de teclado para estos clientes, os mesmos que podes configurar dende o diálogo de opcións globais. De xeito predeterminado, non podes usar os atallos de teclado de esta interfaz dende a ventá gráfica, pero esto é configurable tamén dende o diálogo de opcións globais.

A seguinte sección amosa a lista de atallos de teclado para ambas interfaces. Ten en conta que aquí só se describirán as combinacións de teclas para o mapa de teclado por defecto.

Atallos de teclado

Atallos de teclado da interfaz gráfica de usuario (GUI)

Atallos de teclado para a interfaz invisible (mapa de teclado predeterminado)

A interfaz invisible do TWBlue pode modificarse usando un mapa de teclado. Cada mapa de teclado define un grupo de combinacións de teclas que poden usarse xunto coa interfaz invisible. Podes cambiar o mapa de teclado no diálogo de opcións globais, no menú aplicacións na barra de menú, e revisar ou editar as combinacións de teclado para o mapa en uso dende o editor de combinacións de teclado, tamén accesible dende o menú aplicacións.

Configuración

Como se describiu anteriormente, a aplicación ten dous diálogos de configuración. O diálogo de opcións globais e o diálogo de opcións de conta.

O diálogo opcións de conta

Pestana xeral

Pestana búferes

Esta pestana amosa a lista dos búferes dispoñibles no TWBlue, coa excepción das procuras, liñas temporais, liñas temporais de gústame e listas. Dende aquí podes amosalos, agachalos e movelos.

A pestana clientes ignorados

Nesta pestana, podes engadir e eliminar clientes que serán ignorados polo programa.

Pestana son

Nesta pestana podes axustar o volume do son, seleccionar o dispositivo de entrada e saída e establecer o paquete de sons que o programa usará para a sesión actual.

Pestana de servizos de audio

Nesta pestana podes introducir a túa API Key de SndUp (no caso que teñas unha) para subir audios a este servicio. Ten en conta que se non se escrebe ningunha API Key válida, os audios subiranse de forma anónima a SndUp.

Opcións Globais

Este diálogo permíteche configurar algunhas opcións que afectan ó funcionamento de toda a aplicación.

Pestana Xeral {#general-tab_1}

Pestana proxi

Nesta pestana podes configurar o TWBlue para usar un servidor proxy compretando os campos amosados (tipo, servidor, porto, usuario e contrasinal).

Licencia, código fonte e doacións

Tw Blue é software libre, licenciado baixo a licencia GNU GPL, tanto na versión 2 ou, ó teu criterio, calquer versión posterior. Podes ver a licencia no ficheiro chamado license.txt, ou en liña en http://www.gnu.org/licenses/old-licenses/gpl-2.0.html.

O código fonte do programa está dispoñible en GitHub en https://www.github.com/manuelcortez/twblue.

Se queres donar ao proxecto, podes facelo en https://twblue.es/donate. ¡Grazas polo teu apoio!

Contactar

Se aínda tes preguntas despois de ler este documento, se desexas colaborar co proxecto dalgún outro xeito, ou se só queres contactar co creador da aplicación, segue as contas de Twitter @tw_blue2 ou @manuelcortez00. Tamén podes visitar o noso sitio web

Créditos

TWBlue desenvólvese e mantense por Manuel Cortéz e José Manuel Delicado.

Tamén nos gostaría agradecer ós traductores do TWBlue, quenes permitiron a difusión da aplicación.

Moitas grazas tamén á xente que traballou na documentación. Inicialmente, Manuel Cortez fixo a documentación en español, e traduciuse ó inglés por Bryner Villalobos, Robert Spangler, Sussan Rey, Aníbal Hernández, e Holly Scott-Gardner. Actualizouse por Sukil Etxenike, con algunhas correccións valiosas por Brian Hartgen e Bill Dengler.


Copyright © 2013-2017. Manuel Cortéz