mcvsoftware/twblue
1
0
Fork 0
mirror of https://github.com/MCV-Software/TWBlue.git synced 2024-10-16 09:29:15 +02:00
Code Issues Actions Packages Projects Releases Wiki Activity

The new documentation system has been finished. Doc needs to be updated

Browse Source
This commit is contained in:
Manuel Cortez 2014-11-07 16:28:27 -06:00
parent 76a2b0b1ac
commit 9e79bdfbcb
39 changed files with 20386 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

0
doc/__init__.py Normal file
View File

23
doc/documentation_importer.py Normal file
View File

@ -0,0 +1,23 @@
# -*- coding: utf-8 -*-
""" This script converts the hold documentation (saved in markdown files) in a python file with a list of strings to translate it using gettext."""
def prepare_documentation_in_file(fileSource, fileDest):
""" This takes documentation written in a markdown file and put all the contents in a python file, to create a internationalized documentation.
@fileSource str: A markdown(.md) file.
@fileDest str: A file where this will put the new strings"""
f1 = open(fileSource, "r")
f2 = open(fileDest, "w")
lns = f1.readlines()
f2.write("# -*- coding: utf-8 -*-\n")
f2.write("documentation = []\n")
for i in lns:
if len(i) > 2:
newvar = "documentation.append(_(u\"\"\"%s\"\"\"))\n" % (i[:-2])
else:
newvar = "documentation.append(_(u\"\"\"%s\"\"\"))\n" % (i)
f2.write(newvar)
f1.close()
f2.close()

42
doc/generator.py Normal file
View File

@ -0,0 +1,42 @@
# -*- coding: utf-8 -*-
import markdown
import os
from codecs import open as _open
import languageHandler
languageHandler.setLanguage("en")
import strings
# the list of supported language codes of TW Blue
languages = ["en", "es", "fr", "gl"]
#"eu", "ar", "ca", "es", "fi", "fr", "gl", "hu", "it", "pl", "pt", "ru", "tr"]
def generate_document(language):
reload(languageHandler)
languageHandler.setLanguage(language)
reload(strings)
markdown_file = markdown.markdown("\n".join(strings.documentation[1:]), extensions=["markdown.extensions.toc"])
first_html_block = """<!doctype html>
<html lang="%s">
<head>
<title>%s</title>
<meta charset="utf-8">
</head>
<body>
<header><h1>%s</h1></header>
""" % (language, strings.documentation[0], strings.documentation[0])
first_html_block = first_html_block+ markdown_file
first_html_block = first_html_block + "\n</body>\n</html>"
if not os.path.exists(language):
os.mkdir(language)
mdfile = _open("%s/manual.html" % language, "w", encoding="utf-8")
mdfile.write(first_html_block)
mdfile.close()
def create_documentation():
print("Creating documentation in the supported languages...\n")
for i in languages:
print("Creating documentation for: %s" % (i,))
generate_document(i)
print("Done")
create_documentation()

176
doc/languageHandler.py Normal file
View File

@ -0,0 +1,176 @@
import __builtin__
import os
import sys
import ctypes
import locale
import gettext
#import paths
import platform
# A fix for the mac locales
if platform.system() != 'Windows':
if locale.getlocale()[0] is None:
locale.setlocale(locale.LC_ALL, 'en_US')
#a few Windows locale constants
LOCALE_SLANGUAGE=0x2
LOCALE_SLANGDISPLAYNAME=0x6f
curLang="en"
def localeNameToWindowsLCID(localeName):
"""Retreave the Windows locale identifier (LCID) for the given locale name
@param localeName: a string of 2letterLanguage_2letterCountry or or just 2letterLanguage
@type localeName: string
@returns: a Windows LCID
@rtype: integer
"""
#Windows Vista is able to convert locale names to LCIDs
func_LocaleNameToLCID=getattr(ctypes.windll.kernel32,'LocaleNameToLCID',None)
if func_LocaleNameToLCID is not None:
localeName=localeName.replace('_','-')
LCID=func_LocaleNameToLCID(unicode(localeName),0)
else: #Windows doesn't have this functionality, manually search Python's windows_locale dictionary for the LCID
localeName=locale.normalize(localeName)
if '.' in localeName:
localeName=localeName.split('.')[0]
LCList=[x[0] for x in locale.windows_locale.iteritems() if x[1]==localeName]
if len(LCList)>0:
LCID=LCList[0]
else:
LCID=0
return LCID
def getLanguageDescription(language):
"""Finds out the description (localized full name) of a given local name"""
desc=None
if platform.system() == "Windows":
LCID=localeNameToWindowsLCID(language)
if LCID!=0:
buf=ctypes.create_unicode_buffer(1024)
if '_' not in language:
res=ctypes.windll.kernel32.GetLocaleInfoW(LCID,LOCALE_SLANGDISPLAYNAME,buf,1024)
else:
res=0
if res==0:
res=ctypes.windll.kernel32.GetLocaleInfoW(LCID,LOCALE_SLANGUAGE,buf,1024)
desc=buf.value
elif platform.system() == "Linux" or not desc:
desc={
"am":pgettext("languageName","Amharic"),
"an":pgettext("languageName","Aragonese"),
"es":pgettext("languageName","Spanish"),
"pt":pgettext("languageName","Portuguese"),
"ru":pgettext("languageName","Russian"),
"it":pgettext("languageName","italian"),
"tr":pgettext("languageName","Turkey"),
"gl":pgettext("languageName","Galician"),
"ca":pgettext("languageName","Catala"),
"eu":pgettext("languageName","Vasque"),
"pl":pgettext("languageName","polish"),
"ar":pgettext("languageName","Arabic"),
"ne":pgettext("languageName","Nepali"),
"sr":pgettext("languageName","Serbian (Latin)"),
}.get(language,None)
return desc
def getAvailableLanguages():
"""generates a list of locale names, plus their full localized language and country names.
@rtype: list of tuples
"""
#Make a list of all the locales found in NVDA's locale dir
l=[x for x in os.listdir("locales") if not x.startswith('.')]
l=[x for x in l if os.path.isfile('locales/%s/LC_MESSAGES/twblue-documentation.mo' % x)]
#Make sure that en (english) is in the list as it may not have any locale files, but is default
if 'en' not in l:
l.append('en')
l.sort()
#For each locale, ask Windows for its human readable display name
d=[]
for i in l:
desc=getLanguageDescription(i)
label="%s, %s"%(desc,i) if desc else i
d.append(label)
#include a 'user default, windows' language, which just represents the default language for this user account
l.append("system")
# Translators: the label for the Windows default NVDA interface language.
d.append(_("User default"))
#return a zipped up version of both the lists (a list with tuples of locale,label)
return zip(l,d)
def makePgettext(translations):
"""Obtaina pgettext function for use with a gettext translations instance.
pgettext is used to support message contexts,
but Python 2.7's gettext module doesn't support this,
so NVDA must provide its own implementation.
"""
if isinstance(translations, gettext.GNUTranslations):
def pgettext(context, message):
message = unicode(message)
try:
# Look up the message with its context.
return translations._catalog[u"%s\x04%s" % (context, message)]
except KeyError:
return message
else:
def pgettext(context, message):
return unicode(message)
return pgettext
def setLanguage(lang):
system = platform.system()
global curLang
try:
if lang=="system":
if system == "Windows":
windowsLCID=ctypes.windll.kernel32.GetUserDefaultUILanguage()
localeName=locale.windows_locale[windowsLCID]
else:
localeName=locale.getlocale()[0]
trans=gettext.translation('twblue-documentation', localedir="locales", languages=[localeName])
curLang=localeName
else:
trans=gettext.translation("twblue-documentation", localedir="locales", languages=[lang])
curLang=lang
localeChanged=False
#Try setting Python's locale to lang
try:
locale.setlocale(locale.LC_ALL, lang)
localeChanged=True
except:
pass
if not localeChanged and '_' in lang:
#Python couldn'tsupport the language_country locale, just try language.
try:
locale.setlocale(locale.LC_ALL, lang.split('_')[0])
except:
pass
#Set the windows locale for this thread (NVDA core) to this locale.
if system == "Windows":
LCID=localeNameToWindowsLCID(lang)
ctypes.windll.kernel32.SetThreadLocale(LCID)
except IOError:
trans=gettext.translation("twblue-documentation",fallback=True)
curLang="en"
trans.install(unicode=True)
# Install our pgettext function.
__builtin__.__dict__["pgettext"] = makePgettext(trans)
def getLanguage():
return curLang
def normalizeLanguage(lang):
"""
Normalizes a language-dialect string in to a standard form we can deal with.
Converts any dash to underline, and makes sure that language is lowercase and dialect is upercase.
"""
lang=lang.replace('-','_')
ld=lang.split('_')
ld[0]=ld[0].lower()
#Filter out meta languages such as x-western
if ld[0]=='x':
return None
if len(ld)>=2:
ld[1]=ld[1].upper()
return "_".join(ld)

BIN
doc/locales/ar/lc_messages/twblue-documentation.mo Normal file
View File

Binary file not shown.

1295
doc/locales/ar/lc_messages/twblue-documentation.po Normal file
View File

File diff suppressed because it is too large Load Diff

178
doc/locales/ca/changes.md Normal file
View File

@ -0,0 +1,178 @@
% Lista de Cambios
#¡Peligro!
Antes de continuar con la prueba del programa, considera que es una versión en desarrollo. Específicamente la versión 0.42. Esto quiere decir que no solo es posible que encuentres errores, sino que los vas a encontrar. La idea es reportar lo más que salga, para que se puedan resolver para las próximas alphas.
Aquí la lista de cambios del programa. Si quieres leer como usarlo, [mira este documento.](manual.html) Si ves un enlace con un signo de número (#) y un código que empieza por varios números, estás viendo un error que se ha reportado en el Sistema de seguimiento de incidencias. Siéntete libre de publicar tus propios errores y peticiones de mejoras y nuevas características a través de esta herramienta, disponible desde el menú ayuda en TW Blue.
## Cambios introducidos en esta nueva versión
* Se arregla un error que no permitía mostrar en buffer listas con acentos o caracteres especiales.
* Ahora TW blue no debería dejar de actualizar los tuits repentinamente.
* Ahora TW blue soporta la opción "mute" de Twitter. Cuando silencias a un usuario, no podrás ver sus tuits ni sus menciones, pero no lo dejarás de seguir, con lo que podrás seguir teniendo contacto con él a través de mensaje directo. A diferencia del bloqueo o de dejar de seguirlo, con esta opción el usuario no se dará cuenta que lo tienes silenciado. Busca esto desde el diálogo de acciónes de usuario, o desde el menú de usuario.
* Se añade una nueva página de sonido en el diálogo de configuración que permite seleccionar los dispositivos de entrada y salida, ajustar el volumen y silenciar globalmente TW Blue. Algunas otras opciones se han movido desde la página "general" hacia "sonido".
* Se ha rediseñado el fichero de configuración. La mayoría de las opciones se deberán reconfigurar de nuevo.
* Es posible desactivar Sapi5 para que no intervenga si no hay ningún lector de pantalla soportado en ejecución.
* Dentro de la pestaña General, se puede cambiar manualmente de idioma. Tw Blue reqiere reiniciarse.
* Se incluye un diálogo nuevo que ayuda a entender los sonidos de TW Blue.
* es posible desactivar el sonido y notificaciones de un buffer. El resto del cliente funcionará correctamente. Pulsa Control+win+shift+m(interfaz no visible) o selecciónalo desde el menú buffer para conmutar entre esta característica.
*Ahora puedes realizar búsquedas por usuarios y tuits. Las búsquedas de tuits quedarán guardadas en la configuración mientras que las de usuarios se eliminarán al salir. Pulsa Ctrl+Shift+guion o selecciónalo desde el menú aplicación.
* puedes abrir buffer para ver los favoritos de un usuario desde el menú "usuario".
* Con control+win+shift arriba y abajo en la interfaz no visible, y control arriba y abajo en la interfaz gráfica, puedes ir hacia el anterior o siguiente tweet en la conversación. Para que esto funcione deben estar los tweets de la conversación en la línea principal.
* Durante la grabación de un audio para adjuntar, puedes pausar y reanudar la grabación para omitir partes que puedan generar un audio muy grande.
* Es posible subir audios a Dropbox. Para ello configura el servicio en la pestaña "servicios de audio" en el diálogo de configuración.
* ahora que se pueden subir audios a Dropbox, en el diálogo de adjuntar un audio podrás seleccionar al servicio que deseas subir.
* se incluye un diálogo de corrección ortográfica para los tuits o mensajes. Por ahora los idiomas disponibles son Español, inglés, portugués, ruso y polaco. El idioma será seleccionado automáticamente de acuerdo con la configuración de TW Blue.
* Se ha introducido la lectura automática de los tuits para un buffer. Activando esta característica se puede hacer que TW Blue lea automáticamente los tuits que lleguen a los buffers que tengan activada esta opción. Pulsando control+Win+e conmutarás esta característica.
* En el diálogo de configuración ahora puedes especificar si deseas que TW Blue inicie con la interfaz oculta.
* Las URL se muestran en su versión original. Únicamente las fotos de Twitter se siguen mostrando como acortadas, y las que hayan sido acortadas manualmente antes de enviarlas en un tuit.
## Cambios introducidos en la versión 0.40
* Se puede cambiar entre diferentes paquetes de sonidos y crear los propios. Cada paquete debe ir en un directorio por separado dentro de la carpeta sounds. Para cambiar el paquete de sonido se puede seleccionar desde el diálogo de configuración.
* Los archivos de sonido van en formato OGG.
* Ahora TW Blue debe ser capaz de cerrar correctamente.
* La hora está escrita teniendo en cuenta el formato de 12 horas.
* La hora se escribe de acuerdo con la zona horaria de Twitter establecida en tu cuenta.
* Añadidas nuevas traducciones al portugués, polaco y ruso. Gracias chicos!
* TW Blue elimina de la configuración líneas temporales de usuarios que han cambiado su nombre o borrado su cuenta.
* ahora se maneja la gran mayoría de los eventos en Twitter con el buffer de eventos.
* Ya se puede ver el texto de los eventos, con Control+shift+V (GUI) y control+win+V (interfaz no visible).
* Manejo de listas: Se puede crear, editar, borrar, ver una lista como buffer en TW Blue, añadir y borrar miembros de una lista.
* Ahora si durante el inicio TW Blue intenta cargar una línea temporal que no existe, automáticamente la elimina de la configuración y continúa la carga normalmente.
* Solo se cargará hasta los 400 amigos y seguidores para evitar problemas con la API. Se corregirá en próximas versiones.
* Para el modo no visible, Se incluyen atajos para escuchar nuevamente el tweet sobre el que se está situado (control+win+espacio) y para copiar el mensaje al portapapeles (control+win+c).
## Cambios introducidos en la versión 0.38
* Se ha corregido un fallo que impedía cerrarse al darle la orden.
* Ahora los tweets no terminan en un punto obligatoriamente. Si el programa detecta que el tweet termina en una letra o número, coloca un punto automáticamente. Si no es así, deja el texto tal y como está.
* Ya se pueden subir imágenes a los tweets y respuestas. Ten en cuenta que el tamaño de las imágenes es establecido por twitter.
* Al desplazarte hacia la izquierda y derecha usando el modo no visible, ahora solo se anuncia información de la posición en la lista de elementos.
* TW Blue ya debería funcionar para Windows XP al momento de autorizar la aplicación.
* Se ha añadido una nueva opción en el diálogo de configuración que permite revertir los buffers. Esto significa que puedes escojer si quieres ver los tweets como hasta ahora, o que los más nuevos se coloquen arriba y los viejos debajo.
* Se pueden subir fotos al perfil de Twitter, disponible desde el diálogo para actualizar tu perfil.
* Se ha añadido un buffer de eventos, donde se guardan por ahora algunos eventos que ocurren en twitter, como seguir o hacer que alguien te siga, marcar un favorito, que un tweet tuyo sea marcado como favorito, etc. Se puede activar y desactivar este buffer desde el diálogo de configuración.
* Ahora se pueden eliminar líneas temporales ya creadas que no contengan tweets, y no se permitirá crear líneas temporales de usuarios sin tweets.
* La interfaz de la aplicación es traducible. Ahora cualquier usuario puede hacer sus propias traducciones a diferentes idiomas.
## Cambios introducidos en la versión 0.36
* Los usuarios brasileños podrán ver algunos mensajes en portugués. (Usuários brasileiros poderão ver algumas mensagens em Português).
* Se ha arreglado un fallo que hacía que algunos sonidos se escucharan y otros no. Ahora deberían escucharse todos.
* La reconexión también ha recivido un arreglo, pues en ocasiones se efectuaba de forma incorrecta y había que volver a abrir la aplicación.
* Ahora TW Blue permite eliminar únicamente líneas temporales con el comando correspondiente. Antes se mostraba el diálogo sin importar en qué buffer se estaba.
* Se vuelve a poder ver los detalles de los usuarios con Enter estando en el buffer para amigos o seguidores.
* A partir de esta versión no hay soporte para bases de datos.
* Escucharás una notificación por voz cuando alguien marque como favorito uno de tus tweets.
* Los amigos y seguidores ya se actualizan.
* Cuando sigues a alguien, ya no arroja ningún error si no se muestran los amigos. Pasa lo mismo con los seguidores.
* Puedes limpiar un buffer pulsando Shift suprimir en la ventana visible, y Control+win+Shift+Suprimir en la ventana no visible. Esto vaciará todos los tweets en el buffer actual.
## cambios introducidos en la versión 0.35
* Existe un sitio web oficial para el programa, ve a [twblue.com.mx.](http://twblue.com.mx) Desde este espacio encontrarás el sistema de seguimiento de errores, el blog con las noticias recientes, y la última versión disponible.
* TW Blue anuncia cuando eres mencionado, y cuando te llega un mensaje directo.
* Jaws ya no habla el atajo de teclado que se presiona en el modo oculto. [#11](http://twblue.a12x.net/errores/view.php?id=11)
* En el modo no visible, los comandos Control+Win+inicio, control+Win+Fin, control+win+avance de página y control+win+retroceso de página van al principio de la lista, al final, 20 elementos hacia abajo y 20 elementos hacia arriba respectivamente. [#10,](http://twblue.a12x.net/errores/view.php?id=10) [#21,](http://twblue.a12x.net/errores/view.php?id=21) [#22](http://twblue.a12x.net/errores/view.php?id=22)
* Ahora se pueden reproducir audios de Audioboo.
* Ahora el Stream debería poder conectarse luego de que la máquina regresa de una suspensión.
* Es posible grabar audios o subir archivos a SndUp.net. Si estás registrado en esta página, podrás poner en la configuración tu API Key para que los archivos se suban a tu nombre. Puedes subir archivos Wav, OGG y MP3. Los archivos wav se recodificarán a OGG.
* Si no estás usando ningún lector de pantalla, algunas acciones de TW blue usarán la síntesis de voz Sapi 5.
* Hay disponible una versión para arquitecturas de 64 Bits. Gracias a [@jmdaweb](https://twitter.com/jmdaweb) por tomarse el trabajo de hacer funcionar la aplicación en esta arquitectura y prepararla para su distribución.
* Cambio en los sonidos del cliente. Gracias a [@guilevi_es](https://twitter.com/guilevi_es) por la colaboración con el pack de sonidos.
* Algunos mensajes del programa se pueden traducir. En futuras versiones será internacionalizada la totalidad de su interfaz.
* Y Corrección de algunos cuantos errores más ([#5,](http://twblue.com.mx/errores/view.php?id=5) [#7,](http://twblue.com.mx/errores/view.php?id=7) [#8,](http://twblue.com.mx/errores/view.php?id=8) [#9,](http://twblue.com.mx/errores/view.php?id=9) [#12,](http://twblue.com.mx/errores/view.php?id=12))
## Cambios introducidos en la versión 0.3
* Ya se puede actualizar tu perfil desde TW Blue. [#19](http://twblue.a12x.net/issues/view.php?id=19)
* Ahora se pueden crear nuevamente las líneas temporales y no dan problemas. [#24](http://twblue.a12x.net/issues/view.php?id=24)
* Ahora los archivos de errores se guardarán en el directorio "logs".
* Cuando crees una línea temporal, se actualizará en tiempo real desde el principio en lugar de actualizar cada 2 minutos.
* Ya puedes solicitar más llamadas a la API que funcionarán para obtener 200 tweets cada una. Una llamada equivale a 200 elementos de la lista principal, menciones, mensajes directos, favoritos y líneas temporales. En el archivo de configuración se puede editar la opción en [twitter]/max_api_calls. Es recomendable no pedirle a Twitter más de 2 llamadas a la API, o de lo contrario llegará al límite de llamadas permitidas muy pronto y la aplicación fallará.
* Cuando respondes a un Tweet, este se envía como respuesta al mismo y no como si fuera un tweet nuevo.
* El antiguo sistema de reporte de errores tuvo que ser cambiado. A partir de esta versión, podrás reportar los errores directamente desde la aplicación. La opción Reportar un Error abrirá un diálogo que te preguntará detalles sobre tu error y enviará el reporte automáticamente.
* Ya se borran los amigos cuando dejas de seguir a un usuario.
* También los favoritos, al momento de quitar un tweet como favorito, realizan el cambio.
* Se añade un diálogo de configuración que permite controlar el número de llamadas a la API a realizar, si usar o no bases de datos, y ocultar y mostrar las listas de amigos, seguidores y favoritos.
* Al citar tweets, las comillas que cierran el mensaje ahora están separadas por un espacio de la última letra. Esto es así porque antes, cuando había una URL, causaba que las comillas hicieran parte de la dirección enviando a sitios inexistentes.
* Mejoras con algunas líneas temporales. Ahora puede guardar sin problemas cualquier línea temporal. No debería dar errores.
* Ahora los audios se reproducirán únicamente con Control+Intro, mientras que las URL se abrirán con Intro.
* El stream se intentará reconectar al fallar la conexión a internet.
* Ahora desde los seguidores y amigos se puede mencionar a un usuario.
* Ahora se proporciona un modo "invisible". Bajo el menú aplicación, la opción "Esconder ventana" o pulsando Control+M. Para mostrar la ventana de nuevo se pulsa Control+Win+M.
## Cambios introducidos en la versión 0.025
Ten en cuenta que cuando un usuario te deja de seguir o tú dejas de seguir a alguien más, no se actualizará en la lista de amigos o seguidores por ahora. Al reiniciar el programa sí aparecerá la información correcta.
* Corregido un error que impedía cerrar la aplicación hasta que el programa anunciara que estaba listo. [#17](http://twblue.a12x.net/issues/view.php?id=17) y [#18](http://twblue.a12x.net/issues/view.php?id=18)
* Cambiado el modo de organizar las líneas temporales en la configuración. Es necesario volver a crearlas.
* Ahora puede enviarse un mensaje directo a los amigos y seguidores usando el botón. Esto no funcionaba en las versiones 0.02 y 0.021.
* Se puede subir y bajar el volumen desde la lista de seguidores y amigos.
* En el diálogo para escribir un tweet, se puede ahora traducir el mensaje usando Google Traductor. Aparecerá un diálogo para preguntar por los idiomas de origen y destino.
* El menú archivo tiene la opción salir.
* A partir de esta versión solo se reproducirán archivos de audio pulsando enter si estos llevan la etiqueta #audio.
* Puedes intentar reproducir una URL cualquiera sin que lleve la etiqueta #audio pulsando Control Enter. Este comando intentará reproducir la primer URL encontrada.
* Se ha mejorado el buscador de URLS, haciendo más rápida la función y ahora debería ser capaz de detectar todas las URLS. [#21](http://twblue.a12x.net/issues/view.php?id=21)
* Ahora el diálogo que se muestra para seleccionar el usuario del que se desea ver detalles permite además de seleccionarlo de una lista, escribir el nombre de usuario que desees.
## Cambios introducidos en versión 0.02 y 0.021
* El mensaje que se reproducía al seguir un usuario ahora dice "ahora sigues a x usuario" en lugar de "ahora no sigues a x usuario". [#5](http://twblue.a12x.net/issues/view.php?id=5)
* Al salir un diálogo te preguntará si deseas hacerlo. Ahora se sale de una forma mucho más limpia del programa, evitando varios errores durante el cierre.
* Cambio de los sonidos para los dm entrante y saliente. Gracias a [@marcedsosa](https://twitter.com/marcedsosa) por los nuevos sonidos.
* El nombre de usuario de twitter se lee en el título de la ventana.
* Los sonidos del programa también leen el volumen desde la configuración. El módulo de sonido debería tomar menos tiempo en reproducir varios de los sonidos de la aplicación.
* Las acciones de subir y bajar volumen reproducen un sonido que indica que tan fuerte suena.
* Ya no se muestran las menciones de personas que no te siguen en tu línea principal. [#1](http://twblue.a12x.net/issues/view.php?id=1)
* Ahora puedes eliminar tweets y mensajes directos. Solo podrás eliminar los tweets que tú hayas escrito.
* Arreglado un error que impedía cargar correctamente las diferentes listas si en alguna de ellas no había ningún tweet, usuario o mensaje directo. Esto afectaba especialmente a cuentas con 0 favoritos, 0 tweets, 0 enviados o 0 mensajes directos. [#2](http://twblue.a12x.net/issues/view.php?id=2)
* Ahora cada que se publique una nueva versión, se te notificará de ello. Si accedes a descargarla, el programa la descargará y copiará todo lo necesario.
* Ya se puede obtener la lista completa de amigos y seguidores.
* Se añade la fecha del último tweet de los seguidores y amigos.
* Se actualizan ahora los amigos y seguidores a tiempo real. (ToDo: Los amigos y seguidores no muestran la fecha de su último tweet cuando se actualizan a tiempo real. Lo hacen al recargarse una vez reiniciada la aplicación).
* El orden de las pestañas se ha cambiado. Ahora se ordenan comenzando por el principal, menciones, mensajes directos y enviados.
* Ahora se muestran los mensajes directos en la lista de tweets enviados cuando se carga el stream por primera vez. Esto no pasaba y si el usuario enviaba un DM desde otro cliente cuando Tw Blue no estaba abierto, al abrir la aplicación no mostraba dicho DM. [#8](http://twblue.a12x.net/issues/view.php?id=8)
* Con Control+A, se puede seleccionar todo el texto de un mensaje. Funciona con Jaws y NVDA.
* Hay atajos de teclado (detallados en la [Documentación)](leeme.html) para muchas de las acciones que puede hacer el programa.
* Ahora TW Blue detecta más audios en URLS que vienen en retweets, y audios compartidos desde Dropbox. [#3](http://twblue.a12x.net/issues/view.php?id=3)
* Se incluye documentación para la aplicación y créditos.
* Si la conexión a internet deja de funcionar, el stream intentará reconectarse por 30 minutos.
* Se ha escrito un documento que detalla como usar el programa.
* Se ha abierto el [Sistema de seguimiento de incidencias](http://twblue.a12x.net/issues/) donde los usuarios podrán reportar los errores y si lo desean, aportar nuevas ideas para el desarrollo de la aplicación. Hay disponible un acceso directo al formulario de reporte desde el menú ayuda.
* Ahora hay créditos de la versión actual.
* Se añade en el menú usuario la opción para ver los detalles. También funciona si se presiona intro sobre un amigo o seguidor.
## Cambios introducidos en la versión Prealpha1
Ten en cuenta que en esta versión los amigos y seguidores no se actualizan automáticamente. Esto será añadido en otra versión. Tampoco se puede borrar ningún tweet, o DM. Todos los tweets, mensajes directos, menciones, favoritos, seguidores y amigos se actualizarán descargando un máximo de 200. Pronto se podrán añadir más a la cantidad de actualizaciones. Aquí los cambios desde la primer versión.
* La fecha se ve bien, de acuerdo con la zona horaria del usuario.
* Ahora el cursor se pone al principio cuando se va a responder o hacer un retweet.
* Si se pulsa Control+E en los cuadros de texto, se seleccionará todo el mensaje.
* Algunas correcciones para el manejo de las líneas temporales (necesito hacer mejoras en la manera de administrar esto).
* Los favoritos se actualizan en tiempo real.
* Escucharás un sonido cuando pasas por un tweet que podría contener un audio reproducible.
* Se soporta reproducción de audio con la etiqueta #audio y una URL. Pulsa enter para escuchar la canción. Pulsa F5 para bajar el volumen un 5%, o f6 para subirlo un 5%. Si quieres detener la reproducción, ve hacia donde haya un audio, y pulsa intro. Si el programa es incapaz de reproducir algo, te avisará. El volumen de la música (no de los sonidos del programa por ahora) quedará guardado en la configuración, y el programa lo recordará la próxima vez que reproduzcas algo.
* Puedes ver los primeros 200 amigos y seguidores con sus nombres de usuario, nombre real y algo de información útil. En futuras versiones podrás ver todos si tienes más de 200. Ten en cuenta que hay acciones que no podrás hacer con estos usuarios en la lista (por ejemplo, responder o retwittear, porque no son tweets, son usuarios), pero sí podrás seguirlos, dejarlos de seguir, y hacer casi todo (menos enviar DM por ahora) lo que podrías hacer desde el menú de usuario.
Ahora hay que usar y probar, y cuando encuentres un error, por favor mira en la carpeta de la aplicación, pues se ha de generar un archivo con el nombre del ejecutable pero con un .log al final. Bien, ese es vital para que yo pueda saber dónde se ha roto el programa, y te agradecería me lo enviaras junto con una descripción de qué era más o menos lo que estabas haciendo, cuando la aplicación no hizo lo que tenía que hacer. Por ejemplo, "intenté enviarme un DM, pero el cuadro de diálogo de mensaje directo nunca se abrió". Si puedes subirlo a un servidor de almacenamiento (como [Dropbox,](https://www.dropbox.com) por ejemplo), y enviármelo ya sea mencionando a [@tw_blue2](https://twitter.com/tw_blue2) o a [@manuelcortez00,](https://twitter.com/manuelcortez00) sería genial.
¡Infinitas gracias por probar!
## Novedades de la versión prealpha 0
* Hacer tweets, responder a los tweets de los demás, mencionando a todos los usuarios cuando haya más de uno en el tweet, retwittear lo que te agrada, añadiendo o no un comentario al retweet y eliminarlos.
* Añadir y quitar de favoritos un tweet.
* Acortar y desacortar direcciones URL cuando escribes un tweet o dm (puedes seleccionar cual deseas acortar o desacortar desde una lista cuando sean más de una).
* Abrir un navegador web con la dirección URL que viene en el tweet, pulsando enter. Cuando haya más de una dirección, verás una lista donde te preguntará por la que desees.
* Usuarios: puedes seguir, dejar de seguir, reportar como spam, bloquear y enviar un mensaje directo a los usuarios.
* Puedes abrir y eliminar líneas temporales individuales para cada usuario.
* También verás tus favoritos.
* y por ahora, a menos que se me esté pasando algo, es todo.
---
Copyright © 2013-2014, Manuel Cortéz

BIN
doc/locales/ca/lc_messages/twblue-documentation.mo Normal file
View File

Binary file not shown.

1359
doc/locales/ca/lc_messages/twblue-documentation.po Normal file
View File

File diff suppressed because it is too large Load Diff

BIN
doc/locales/es/LC_MESSAGES/twblue-documentation.mo Normal file
View File

Binary file not shown.

1655
doc/locales/es/LC_MESSAGES/twblue-documentation.po Normal file
View File

File diff suppressed because it is too large Load Diff

BIN
doc/locales/eu/lc_messages/twblue-documentation.mo Normal file
View File

Binary file not shown.

1271
doc/locales/eu/lc_messages/twblue-documentation.po Normal file
View File

File diff suppressed because it is too large Load Diff

BIN
doc/locales/fi/lc_messages/twblue-documentation.mo Normal file
View File

Binary file not shown.

1366
doc/locales/fi/lc_messages/twblue-documentation.po Normal file
View File

File diff suppressed because it is too large Load Diff

178
doc/locales/fr/changes.md Normal file
View File

@ -0,0 +1,178 @@
% Liste des Changements
#Attention !
Avant de poursuivre l'essai du programme, il est considéré que c'est une version de développement. Plus précisément, la version 0.42. Cela signifie qu'il n'est pas seulement possible de trouver des erreurs, mais que vous les trouverez. L'idée est de signaler le plus d'erreurs possibles afin qu'ils puisse être résolus pour les prochaines alphas.
Voici la liste des changements dans le programme. Si vous voulez lire comment l'utiliser, [voir ce document.](manual.html) Si vous voyez un lien avec un signe dièse (#) et un code qui commence par plusieurs numéro, vous voyez une erreur qui a été signalé dans le Système de suivi d'incidences. N'hésitez pas à publier vos propres erreurs et demandes d'améliorations et nouvelles fonctionnalités à travers de cet outils, disponible dans le menu Aide de TW Blue.
## Changements ajouter dans cette nouvelle version
* Correction d'une erreur qu'elle ne permettait pas d'afficher les listes avec des accents ou des caractères spéciaux dans un tampon.
* Maintenant TW blue ne devrait pas actualiser les Tweets soudainement.
* Maintenant TW blue supporte l'option "muet" de Twitter. Lorsque cette option est activée pour un utilisateur, vous ne pouvez pas voir ces tweets ni ces mentions, mais vous le suivez toujours, et vous serez en mesure de être en contact avec lui à travers de message direct. Ceci est différent de la fonction Bloquer ou Ne pas suivre, avec cette option l'utilisateur sera pas au courant que vous avez activée l'option muet. sette option se trouvent dans la boîte de dialogue des actions utilisateur de l'interface invisible, ou dans le menu Utilisateur de l'interface graphique.
* Un onglet "Audio" a été ajoutée dans la boîte de dialogue de configuration qui vous permet de sélectionner les périphériques d'entrée et de sortie, régler le volume et activer/ désactiver tous les sons pour TW Blue. D'autres options ont été déplacées depuis l'onglet "Général" vers l'onglet "Audio".
* Le fichier de configuration a été repensé. La plupart des options devront être reconfigurés à nouveau.
* Vous pouvez maintenant désactiver SAPI5 afin qu'il n'intervienne pas s'il n'y a aucun lecteur d'écran supporté en cours d'exécution.
* Dans l'onglet Général, Vous pouvez modifier manuellement la langue. Tw Blue reqiere redémarré.
* Maintenant il y a une nouvelle boîte de dialogue où vous pouvez apprendre les différents sons de TW Blue.
* Il est possible maintenant de désactiver le son et notification d'un tampon. Le reste du client fonctionnera correctement. Appuyez sur Contrôle+Windows+Maj+m (interface invisible) ou le sélectionnez depuis le menu "Tampon" (interface visible) pour basculer entre cette fonctionnalité.
* Vous pouvez maintenant rechercher par utilisateur et par tweets. Les recherches de tweets sont sauvegardées dans la configuration, tandis que ceux des utilisateurs seront supprimer lors de la fermeture. Appuyez sur Ctrl+Windows+- (tiret) (interface invisible) ou le sélectionnez depuis le menu "Application" (interface visible).
* Vous pouvez ouvrir le tampon pour voir les favoris d'un utilisateur dans le menu "Utilisateur".
* Maintenant avec Contrôle+Windows+Maj+Flèche Haut / Bas (dans l'interface graphique) et Contrôle+Windows+Flèche Haut / Bas (dans l'interface invisible), vous pouvez aller au tweet précédent ou suivant dans la conversation. Pour que cela fonctionne les tweets de la conversation doivent être dans la chronologie principale.
* Au cours d'un enregistrement audio pour ajouter, maintenant vous pouvez mettre en pause ou reprendre l'enregistrement pour sauter des parties qui peuvent générer un audio très long.
* Il est maintenant possible de charger de l'audio vers Dropbox. Pour configurer le service aller dans l'onglet "Services audio" dans la boîte de dialogue de Configuration.
* Maintenant que vous pouvez charger de l'audio vers Dropbox, dans la boîte de dialogue pour ajouter un audio vous pouvez sélectionner le service auquelle vous souhaitez charger.
* Maintenant il comprend une boîte de dialogue pour la correction orthographique pour les tweets ou messages. Les langues actuellement disponibles sont: Espagnol, Anglais, Portugais, Russe et Polonais. La langue sera sélectionnée automatiquement selon la configuration de TW Blue.
* Ajouter la lecture automatique des Tweets pour un tampon. L'activation de cette fonctionnalité peut faire que TW Blue lit automatiquement les tweets lors de l'arrivée dans les tampons qui ont cette option activée. Appuyez sur Contrôle+Windows+e pour basculer entre cette fonction.
* Dans la boîte de dialogue de Configuration maintenant vous pouvez spécifiez si vous voulez que TW Blue démarre avec l'interface invisible.
* Les URLs s'affiche dans leur version originale. Uniquement les photos de Twitter ils apparaissent toujours comme réduites, et celles qui ont été réduites manuellement avant de les envoyer dans un tweet.
## Changements ajouter dans la version 0.40
* Vous pouvez changer entre les différents paquets de sons utilisé par TW Blue et de créer vos propres sons. Chaque paquet doit être dans un répertoire par séparé dans le dossier sounds. Pour modifier le paquet de sons vous pouvez le sélectionner dans la boîte de dialogue de configuration.
* Les fichiers audio doivent être au format OGG.
* TW Blue doit être maintenant en mesure de fermer correctement.
* L'heure est écrit tenant en compte le format 12 heures (AM /P M).
* L'heure est écrit d'accord au fuseau horaire que vous avez défini dans votre compte Twitter.
* Ajout de nouvelles traductions en Portugais, Polonais et Russe. Merci les gars !
* TW Blue supprime de la configuration la chronologie de l'utilisateur qui ont changé leur noms ou supprimer leurs comptes Twitter.
* Maintenant est gérés la grande majorité des événements dans Twitter avec le tampon des événements.
* Il est maintenant possible de voir le texte des événements avec Contrôle+Maj+V (GUI) ou Contrôle+Windows+V (interface invisible).
* Gestionnaire de listes: Vous pouvez créer, modifier, supprimer, afficher une liste comme tampon dans TW Blue, ajouter et supprimer des membres d'une liste.
* Maintenant, si au démarrage de TW Blue il tente de charger une chronologie qui n'existe pas, automatiquement il la supprime de la configuration et il continue à charger normalement.
* Seuls seront chargées jusqu'à 400 following et followers pour éviter les problèmes avec l'API. Elle sera corrigée dans les versions futures.
* Pour le mode invisible, il inclus des raccourcis pour réentendre le tweet sur lequel vous êtes (Contrôle+Windows+espace) et pour copier le message dans le presse-papiers (Contrôle+Windows+c).
## Changements ajouter dans la version 0.38
* Correction d'une erreur qui empêchait en donnant l'ordre de fermer.
* Maintenant les tweets ne finissent pas par un point obligatoirement. Si le programme détecte que le tweet se termine par une lettre ou un chiffre, il va placez un point automatiquement. Si ce n'est pas le cas, il va laisser le texte tel qu'il est.
* Il est maintenant possible de charger des images aux tweets et réponses. Veuillez noter que la taille des images est mis en place par twitter.
* Pour se déplacer vers la gauche ou vers la droite en utilisant le mode invisible, maintenant il s'annonce uniquement des informations de la position dans la liste d'éléments.
* TW Blue devrait maintenant fonctionner pour Windows XP au moment de la demande d'autorisation pour l'application.
* Ajouté une nouvelle option dans la boîte de dialogue de configuration qui vous permet de revenir à vos tampons. Cela signifie que vous pouvez choisir si vous voulez voir les tweets comme jusqu'à maintenant, ou que les plus nouveaux soit placés vers le haut et les anciens vers le bas.
* Maintenant les photos peuvent être chargées aux profil de Twitter, disponible à partir de la boîte de dialogue Mettre à jour votre profil.
* Ajouté un tampon d'événements, où ils sont stockés pour le moment quelques événements qui se déroulent dans Twitter, comme suivre ou faire que quelqu'un vous suivent, marquer un favori, que un de vos tweet soit marqué comme favoris, Etc. Vous pouvez activer et désactiver ce tampon de la boîte de dialogue de configuration.
* Maintenant, vous pouvez supprimer des chronologies déjà créé qui ne contiennent pas des tweets, et il ne sera pas permit de créer des chronologies pour les utilisateurs sans tweets.
* L'interface de l'application est traduisible. Maintenant, n'importe quel utilisateur peut faire leurs propres traductions en différentes langues.
## Changements ajouter dans la version 0.36
* Les utilisateurs brésiliens pourront voir quelques messages en Portugais. (Usuários brasileiros poderão ver algumas mensagens em Português).
* Correction d'une erreur qui fait que quelques sons ils peuvent s'entendre et d'autres non. Maintenant, ils devraient s'entendre tous.
* La réconnexion aussi a reçu une correction, parce que parfois, il s'effectué de façon incorrecte et il devait s'ouvrir à nouveau l'application.
* Maintenant TW Blue permet de supprimer uniquement les chronologies avec la commande correspondante. Avant il s'affichées la boîte de dialogue peu importe dans quel tampon vous aviez été.
* Vous êtes en mesure à nouveau de voir les détails des utilisateurs avec la touche Entrée étant dans le tampon pour les following ou followers.
* À partir de cette version, il n'y a pas de support pour les bases de données.
* Vous entendrez une notification vocale lorsque quelqu'un marque comme favori un de vos tweets.
* Les following et followers sont déjà mis à jour.
* lorsque vous suivez quelqu'un, il ne se produit aucune erreur Si ne sont pas affichées les following. C'est la même chose avec les followers.
* Vous pouvez effacer un tampon en appuyant sur Maj+Supprimer dans la fenêtre visible, et Contrôle+Windows+Maj+Supprimer dans la fenêtre invisible. Ceci va vider tous les tweets dans le tampon courant.
## Changements ajouter dans la version 0.35
* Il existe un site Web officiel pour le programme, aller sur [twblue.com.mx.](http://twblue.com.mx) Dans cet espace, vous trouverez le système de suivi d'erreurs, le blog avec les dernières nouvelles, et la dernière version disponible.
* TW Blue il annonce lorsque vous êtes mentionné, et lorsque vous obtenez un message direct.
* Jaws il ne dit pas le raccourci clavier qui est appuyé dans le mode invisible. [#11](http://twblue.a12x.net/errores/view.php?id=11)
* Dans le mode invisible, les commandes Contrôle+Windows+Origine, Contrôle+Windows+Fin, Contrôle+Windows+Page Suivante et Contrôle+Windows+Page Précédente va aller vers le haut de la liste, vers la fin, 20 éléments vers le bas et 20 éléments vers le haut respectivement. [#10,](http://twblue.a12x.net/errores/view.php?id=10) [#21,](http://twblue.a12x.net/errores/view.php?id=21) [#22](http://twblue.a12x.net/errores/view.php?id=22)
* Maintenant vous pouvez lire l'audios d'Audiobook.
* Maintenant, le flux doit être connecté une fois que la machine revient d'une suspension.
* Il est possible d'enregistrer de l'audio ou charger fichiers sur SndUp.net. Si vous êtes inscrit dans cette page, vous pouvez mettre dans la configuration votre API Key pour que les fichiers se charge sur votre nom. Vous pouvez charger des fichiers Wav, OGG et MP3. Les fichiers wav ils seront récodifier en OGG.
* Si vous n'utilisez aucun lecteur d'écran, quelques actions de TW blue utilisent la synthèse vocale SAPI5.
* Il existe une version pour les architectures de 64 Bits. Merci à [@jmdaweb](https://twitter.com/jmdaweb) pour prendre le travail de faire fonctionner l'application dans cette architecture et la préparez pour sa distribution.
* Changement dans les sons du client. Merci à [@guilevi_es](https://twitter.com/guilevi_es) pour la collaboration avec le paquet de sons.
* Quelques messages du programme peuvent être traduits. Dans des futures versions la totalité de l'interface sera internationalisé.
* Et quelques correction d'erreur en plus ([#5,](http://twblue.com.mx/errores/view.php?id=5) [#7,](http://twblue.com.mx/errores/view.php?id=7) [#8,](http://twblue.com.mx/errores/view.php?id=8) [#9,](http://twblue.com.mx/errores/view.php?id=9) [#12,](http://twblue.com.mx/errores/view.php?id=12))
## Changements ajouter dans la version 0.3
* Maintenant vous pouvez mettre à jour votre profil à partir de TW Blue. [#19](http://twblue.a12x.net/issues/view.php?id=19)
* Maintenant vous pouvez créer les chronologies à nouveau et ils ne donne pas de problèmes. [#24](http://twblue.a12x.net/issues/view.php?id=24)
* Maintenant les fichiers d'erreur sont enregistrés dans le répertoire "logs".
* Lorsque vous créez une chronologie, il sera mis à jour en temps réel dès le début au lieu de le mettre à jour toutes les 2 minutes.
* Vous pouvez maintenant demander davantage d'appels à l'API qui fonctionnera pour obtenir 200 tweets chaqu'une. Un appel est équivalent à 200 éléments de la liste principal, mentions, messages directs, favoris et chronologies. Dans le fichier de configuration Vous pouvez modifier l'option dans [twitter]/max_api_calls. Il est recommandé de ne pas demander à Twitter plus de 2 appels à l'API, ou sinon vous arriverez bientôt à la limite des appels autorisés et l'application échouera.
* Lorsque vous répondez à un Tweet, c'est envoyé comme réponse au même et pas comme s'il s'agissait d'un nouveau tweet.
* L'ancien système de rapport d'erreurs il a dû être changée. À partir de cette version, vous pouvez signaler des erreurs, directement depuis l'application. L'option Signaler une erreur ouvrira une boîte de dialogue qui vous demande des détails sur votre erreur et il va envoyer le rapport automatiquement.
* Ils sont déjà supprimées les following lorsque ils ne suivent pas un utilisateur.
* Aussi les favoris, au moment de retirer un tweet comme favori, il exécutent le changement.
* Ajouté une boîte de dialogue de configuration qui permet de contrôler le nombre d'appels à l'API à exécuter, si oui ou non utiliser des bases de données, et masquer ou afficher les listes de following, followers et favoris.
* En mentionnant les tweets, les guillemets qui entourent le message maintenant sont séparés par un espace de la dernière lettre. Il en est ainsi parce qu'avant, lorsque il y avait une URL, il causé que les guillemets facent partie de l'URL en envoyant vers des sites inexistants.
* Améliorations avec quelques chronologies. Vous pouvez maintenant enregistrer une chronologie sans problèmes. Il ne devrait pas faire des erreurs.
* Maintenant, l'audio est joué seulement avec Contrôle+Entrée, tandis que l'URL s'ouvrira avec la touche Entrée.
* Le flux tentera de se reconnecter à l'échec de la connexion internet.
* Maintenant depuis les followers et following on peut mentionner un utilisateur.
* Maintenant il est fournit un mode "invisible". Sous le menu "Application", dans l'option "Masquer la fenêtre" ou en appuyant sur Contrôle+M. Pour afficher la fenêtre à nouveau appuyez sur Contrôle+Windows+M.
## Changements ajouter dans la version 0.025
Veuillez noter que lorsque un utilisateur vous ne sui pas ou vous ne suivez pas quelqu'un d'autre, la liste des following ou des followers il ne sera pas mis à jour pour le moment. Lorsque vous redémarrez le programme, si les informations son correctes ils seront afficher.
* Correction d'une erreur qui rendait impossible de fermer l'application jusqu'à ce que le programme a annoncé qu'elle était prête. [#17](http://twblue.a12x.net/issues/view.php?id=17) y [#18](http://twblue.a12x.net/issues/view.php?id=18)
* Changé la façon d'organiser les chronologies dans la configuration. Il est nécessaire de les recréer.
* Maintenant, vous pouvez envoyer un message direct aux following et followers en utilisant le bouton. Cela ne fonctionnait pas dans la version 0.02 et 0.021.
* Vous pouvez augmenter et diminuer le volume depuis la liste des followers et following.
* Dans la boîte de dialogue pour écrire un tweet peut être maintenant traduit le message à l'aide de Google Traductor. Une boîte de dialogue s'affiche pour demander les langues source et destination.
* Le menu fichier contient l'option Sortir.
* À partir de cette version ils se jouera uniquement les fichiers de'audio en appuyant sur Entrée s'ils contienne le hashtag #audio.
* Vous pouvez essayer de jouer une URL quelconque sans qui comporte le hashtag #audio en appuyant sur Contrôle+Entrée. Cette commande va tenter de reproduire la première URL trouvée.
* A été amélioré le moteur de recherche d'URLS, en rendant plus rapide la fonction et maintenant, devrait être capable de détecter toutes les URLS. [#21](http://twblue.a12x.net/issues/view.php?id=21)
* Maintenant, la boîte de dialogue qui s'affiche pour sélectionner l'utilisateur que vous souhaitez afficher les détails permet en plus de le sélectionner dans une liste, écrire le nom de l'utilisateur que vous souhaitez.
## Changements ajouter dans la version 0.02 et 0.021
* Le message qui se reproduicé lorsque vous suivez un utilisateur maintenant dit "maintenant vous suivez à x utilisateur" en lieu de "maintenant vous ne suivez pas à x utilisateur". [#5](http://twblue.a12x.net/issues/view.php?id=5)
* Lorsque vous sorter une boîte de dialogue vous demandera si vous voulez le faire. Maintenant vous sorter d'une façon beaucoup plus proprement du programme, empêchant plusieurs erreurs pendant la fermeture.
* Changement des sons pour les dm entrant et sortant. Merci à [@marcedsosa](https://twitter.com/marcedsosa) pour les nouveaux sons.
* Le Nom d'utilisateur de twitter il se lit dans le titre de la fenêtre.
* Les sons du programme aussi peuvent lire le volume depuis la configuration. Le module de sons devrait prendre moins de temps pour reproduire plusieurs des sons de l'application.
* Les actions d'augmenter et de diminuer le volume ils reproduisent un son indiquant que tant forts ça sonne.
* Il n'affichent plus les mentions de personnes qui ne vous suivent pas dans votre chronologie principal. [#1](http://twblue.a12x.net/issues/view.php?id=1)
* Vous pouvez maintenant supprimer les tweets et les messages directs. Vous ne pouvez supprimer que les tweets que vous avez écrit.
* Correction d'une erreur qui empêchait de charger correctement les différentes listes si dans quelques une d'elles ils n'y avait aucun tweet, utilisateur ou message direct. Ceci affectant surtout les comptes avec 0 favoris, 0 tweets, 0 envoyés ou 0 messages directes. [#2](http://twblue.a12x.net/issues/view.php?id=2)
* Maintenant à chaque fois qu'une nouvelle version est disponible, vous serez informé de cela. Si vous avez accès pour le télécharger, le programme va télécharger et copier tout ce dont vous avez besoin.
* Maintenant, vous pouvez obtenir la liste complète des following et followers.
* Ajouter la date du dernier tweet des followers et following.
* Les following et followers sont maintenant mis à jour en temps réel. (ToDo: Les following et followers ils ne montrent pas la date de ces dernier tweet lorsque une mise à jour est faite en temps réel. Ils le font lors du rechargement une fois redémarrée l'application).
* L'ordre des onglets il a changé. Maintenant ils sont classés en commençant par Principal, Mentions, Messages directs et Envoyés.
* Maintenant dans la liste de tweets envoyés les messages directs sont affichés lorsque le flux est chargé pour la première fois. Ceci ne était pas le cas et si l'utilisateur envoyés un DM à partir d'un autre client lorsque Tw Blue n'était pas ouvert, lors de l'ouverture de l'application il ne montré pas la dite DM. [#8](http://twblue.a12x.net/issues/view.php?id=8)
* Con Control+A, se puede seleccionar todo el texto de un mensaje. Funciona con Jaws y NVDA.
* Il y a des raccourcis clavier (détaillés dans la [Documentation)](leeme.html) pour un grand nombre d'actions qui peut faire le programme.
* Maintenant TW Blue détecte plus d'audio dans les URLS qui vienne dans les retweets, et des audio partagé à partir de Dropbox. [#3](http://twblue.a12x.net/issues/view.php?id=3)
* Inclut la documentation pour l'application et les crédits.
* Si la connexion internet s'arrête de fonctionner, le flux va essayer de se reconnecter pendant 30 minutes.
* On a écrit un document qui détaille comment utiliser le programme.
* Il a été ouvert le [Système de suivi d'incidents](http://twblue.a12x.net/issues/) où les utilisateurs peuvent signaler des erreurs et si vous le souhaitez, vous pouvez apporter de nouvelles idées pour le développement de l'application. Il existe un accès direct au formulaire réservée au rapport d'incidents dans le menu Aide.
* Il y a maintenant des crédits à partir de la version actuelle.
* Ajout d'une option dans menu Utilisateur pour afficher les détails. Cela fonctionne également si vous appuyez sur entrer sur un following ou follower.
## Changements ajouter dans la version Prealpha1
Veuillez noter que dans cette version les following et les followers ne sont pas mis à jour automatiquement. Cela s'ajoutera à une autre version. Vous ne pouvez pas également supprimer des tweet, ou DM. Tous les tweets, messages directs, mentions, favoris, followers et following lors de la mise à jour seront télécharger un maximum de 200. Bientôt ils s'ajouteront plus à la quantité lors des mises à jour. Ici les changements à partir de la première version.
* La date il s'affiche bien, selon le fuseau horaire de l'utilisateur.
* Maintenant, le curseur est placé au début lorsque vous allez à répondre ou faire un retweet.
* Si vous appuyez sur contrôle + E dans les zones d'édition, l'intégralité du message sera sélectionné.
* Quelques corrections pour la gestion des chronologies (j'ai besoin d'apporter des améliorations dans la façon de gérer cela).
* Les favoris sont mises à jour en temps réel.
* Vous entendrez un son lorsque vous passez par un tweet qui pourrait contenir un audio jouable.
* Supporte la lecture audio avec le hashtag #audio et une URL. Appuyez sur Entrée pour entendre la chanson. Appuyez sur F5 pour diminuer le volume de 5%, ou f6 pour augmenter d'un 5%. Si vous souhaitez arrêter la lecture, aller où il y a une audio, puis appuyez sur Entrée. Si le programme est incapable de reproduire quelque chose, il vous avertira. Le volume de la musique (pas pour les sons du programme pour l'instant) est enregistré dans la configuration, et le programme va le mémorisé pour la prochaine fois que vous jouez quelque chose.
* Vous pouvez voir les 200 premiers following et followers avec leurs noms d'utilisateur, nom réel et un peu d'informations utiles. Dans des futures versions vous pourrez tout voir si vous avez plus de 200. Veuillez noter que il y a des actions que vous ne pouvez pas faire avec ces utilisateurs dans la liste (par exemple, répondre ou retweet, parce qu'ils ne sont pas des tweets, sont utilisateurs), Mais oui, vous pouvez les suivre, ne pas les suivre, et faire presque tout (moins envoyer DM pour l'instant) ce que vous pourriez faire dans le menu Utilisateur.
Maintenant, il faut l'utiliser et le tester et lorsque vous trouvez une erreur, s'il vous plaît veuillez regarder dans le dossier de l'application, puis il doit générer un fichier avec le nom du fichier exécutable, mais avec une extension .log à la fin. Eh bien, c'est vital pour moi de savoir où le programme a été cassé, et vous devriez être reconnaissant si vous me l'envoyer ainsi qu'une description de ce qui était plus ou moins ce qu'ils faisaient quand l'application fait ce qu'il avait à faire. Par exemple, « j'ai essayé de m'envoyer un DM, mais la boîte de dialogue de message direct jamais elle a été ouverte". Si vous pouvez le charger vers un serveur de stockage (comme Dropbox,](https://www.dropbox.com) par exemple), et me l'envoyer soit en mentionnant à [@tw_blue2](https://twitter.com/tw_blue2) ou à [@manuelcortez00,](https://twitter.com/manuelcortez00) ce serait formidable.
Merci infiniment de l'essayer !
## Nouveautés dans la version prealpha 0
* Faire des tweets, répondre aux tweets des autres, mentionner tous les utilisateurs, lorsque il y a plus d'un dans le tweet, retweet ce qui vous plaît, ajouter ou non un commentaire au retweet et les supprimez.
* Ajouter ou supprimer des favoris un tweet.
* Réduire et élargir une URL lorsque vous écrivez un tweet ou dm (vous pouvez sélectionner quelle URL vous souhaitez réduire et élargir à partir d'une liste lorsque ils sont plus d'une).
* Ouvrir un navigateur Web avec l'URL venant dans le tweet, en appuyant sur Entrée. Lorsque il y a plusieurs URLs, vous verrez une liste où on vous demandera la quelles vous voulez.
* Utilisateurs: Vous pouvez Suivre, Ne pas suivre, Signaler comme spam, Bloquer et Envoyer un message direct aux utilisateurs.
* Vous pouvez ouvrir et supprimer des chronologies individuels pour chaque utilisateur.
* Vous pourrez aussi voir vos favoris.
* Et pour l'instant, à moins qu'il m'arrive d'oublier quelque chose, c'est tout.
---
Copyright © 2013-2014, Manuel Cortéz

BIN
doc/locales/fr/lc_messages/twblue-documentation.mo Normal file
View File

Binary file not shown.

1720
doc/locales/fr/lc_messages/twblue-documentation.po Normal file
View File

File diff suppressed because it is too large Load Diff

287
doc/locales/fr/manual.md Normal file
View File

@ -0,0 +1,287 @@
% Documentation pour TW Blue 0.42
# Version 0.42 (alpha)
# Attention !
Vous lisez un document généré pour une application qui est en cours de développement. Le but de ce manuel est de clarifier quelques détails sur le fonctionnement du programme. Veuillez noter que pour être activement développé, le logiciel peut modifier une partie de cette documentation dans un avenir relativement proche, il est donc conseillé de jeter un œil de temps à autre pour ne pas perdre toute nouvelle information.
Si vous voulez voir ce qui a changé par rapport à la version précédente, [lire la liste des nouveautés ici.](changes.html)
# TW Blue
TW Blue est une application pour utiliser Twitter de manière simple, rapide et éviter dans la mesure des possibilités, consommer trop de ressources de l'ordinateur en cours d'utilisation. Avec l'application TW Blue, vous pouvez effectuer des actions sur Twitter tels que:
* Écrire, répondre, retwitter et supprimer les tweets;
* Marquer comme favori, supprimer des favoris un tweet;
* Envoyer et supprimer des messages directs (DM);
* Voir ceux qui vous suivent et ceux que vous suivez;
* Suivre, ne pas suivre, signaler comme spam ou bloquer un utilisateur;
* Ouvrir une chronologie pour un utilisateur spécifique, ce qui permet de lire tous les tweets d'un utilisateur dans une seule liste;
* Ouvrir les URLs s'il sont présente dans un tweet ou dans un message direct;
* Lire plusieurs types de fichiers ou adresses qui contiennent de l'audio;
* Et plus encore!.
# Table des matières
Pour utiliser une application comme TW Blue qui permet de gérer un compte Twitter, vous devez d'abord être inscrit dans ce réseau social. Cette documentation n'est pas destinée à expliquer la procédure pour ce faire. Nous partirons du principe où vous avez déjà un compte avec son respectifs nom d'utilisateur et mot de passe. La documentation couvrira ces sections.
* [Autoriser l'application](#autoriser)
* [L'interface du programme](#interface)
* [Commandes](#commandes)
* [L'Interface Graphique (GUI)](#gui)
* [Boutons de l'application](#boutons)
* [La barre de Menus](#menus)
* [Menu Aplication](#app)
* [Menu Tweet](#tweet)
* [Menu Utilisateur](#utilisateur)
* [Menu Tampon](#tampon)
* [Menu Aide](#aide)
* [L'interface invisible](#interface_invisible)
* [Raccourcis Clavier pour l'interface graphique](#raccourcis)
* [Raccourcis Clavier pour l'interface invisible](#raccourcis_invisibles)
* [Listes](#listes)
* [Signaler une erreur depuis le Web](#signaler)
* [Contact](#contact)
## Autoriser l'application {#autoriser}
Tout d'abord, la première chose que vous devez faire est d'autoriser le programme afin que celui-ci puisse accéder à votre compte Twitter, et depuis il va réaliser se que vous lui demandez. Le processus d'autorisation est assez simple, et n'aura à aucun moment accès à vos données, telles que le nom d'utilisateur et mot de passe. Pour autoriser l'application, il suffit d'ouvrir le fichier principal du programme, appelé TW Blue.exe (dans certains PC, seulement se montre comme TW Blue).
Lors de l'exécution, Si vous n'avez pas déjà configuré le programme, il s'affichera une boîte de dialogue où il dit que vous serez amené à Twitter afin d'autoriser l'application dès que vous appuyez sur le bouton "OK". Pour commencer avec le processus d'autorisation il faut appuyez sur le seule bouton disponible de cette boîte de dialogue.
Ensuite, votre navigateur par défaut s'ouvre sur la page Twitter vous demandant d'autoriser l'application. Entrée votre nom d'utilisateur et mot de passe si vous n'êtes pas encore connecté, puis vous recherchez le bouton autoriser et appuyez sur celui-ci.
Lisez les instructions que vous obtiendrez si le processus est réussi. En résumé, vous recevrez un code numérique à plusieurs chiffres, que vous devez coller sur un champ d'édition ouvert par l'application sur une autre fenêtre.
Collez le code de vérification et appuyez sur la touche Entrée.
Si tout va bien, l'application commence à jouer un groupe de sons, pour vous signaler que vous mettez à jour vos données.
Lorsque le processus est terminé, le programme jouera un autre son, et le lecteur d'écran dira"prêt".
## L'interface du programme {#interface}
La meilleure façon de décrire l'interface graphique de l'application est la d'une fenêtre avec une barre de menus avec cinq menus (application, tweet, utilisateur, tampon et aide) ; une liste avec plusieurs éléments et, dans la plupart des cas, trois boutons: Tweet, Retweet et Répondre. Les actions disponibles pour chaque élément sont décrits ci-dessous.
Les éléments qui sont dans les listes peuvent être des tweets, des messages directs ou des utilisateurs. TW Blue crée différents onglets pour chaque liste, puis ces éléments peuvent être des Tweets envoyés, des Tweets reçus dans la chronologie principal, favoris ou les messages directs et chaque onglet contient un seul type de Tweet. Ces onglets sont appelés des listes ou des tampons.
Pour basculer entre les listes il faut Appuyez sur Contrôle+Tab pour aller en avant, et Contrôle+Maj+Tab pour revenir en arrière. A tout moment les lecteurs d'écran annoncera la liste vers la quelle se obtiendera le focus de l'application. Ici sont les listes de base de TW Blue, qui se présente si vous utiliser la configuration par défaut.
* Principal: Ici vont tous les tweets qui s'affichent dans la chronologie principal. Ceci sont les tweets provenant des utilisateurs que vous suivez.
* Mentions: Si un utilisateur (vous suit ou ne vous suit pas) vous mentionne sur Twitter, apparaîtra dans cette liste.
* Messages directs: Ici sont les messages directes (privés) que vous pouvez échanger uniquement avec les utilisateurs que vous suivez et qui vous suivent. Cette liste affiche uniquement les messages reçus.
* Envoyés: Dans cette liste il s'affiche tous les Tweets et les messages directs qui ont été envoyés depuis votre compte.
* Favoris: ici, vous pourrez voir tous les tweets que vous avez marqués comme favoris.
* Followers: Lorsque les utilisateurs suivent votre compte, vous les verrez dans cette liste, ainsi que quelques informations sur leur compte Twitter.
* Following: Même que pour la liste précédente, mais ce sont les utilisateurs que vous suivez.
* Événements: Un événement dans TW Blue est "quelque chose" qui se passe sur Twitter. Dans la chronologie des événements, vous pourrez voir enregistré les événements les plus courants (par exemple. Ont vous a commencé à suivre, ont vous a marqués ou supprimé un tweet des favoris, vous vous êtes abonné à une liste). Ils sont comme des petites notifications qui envoie Twitter et TW Blue l'organise dans une liste afin que vous ne manquez pas ce qui s'est passé avec votre compte.
* Chronologie d'un utilisateur: ce sont des listes, que vous pouvez créer. C'est une liste qui contient uniquement les tweets d'un utilisateur spécifique. Ils sont utilisés de sorte que vous pouvez voir les tweets réalisé par une seule personne et vous ne voulez pas regarder partout dans votre chronologie. Vous pouvez en créer autant que vous le souhaitez.
* Listes: Une liste ressemble à une chronologie, mais constitué des tweets de chaque utilisateur qui en fait partie. La liste est actuellement une fonctionnalité expérimentale de TW Blue. Si vous décidez de l'utiliser, veuillez S'il vous plaît nous contactez et nous signalez tout problème que vous rencontrez.
* Rechercher: Un tampon de recherche contient les résultats d'une recherche faites dans TW Blue. Les recherches peuvent être par tweets, au dans le cas que vous recherchez un terme dans le contenus des tweets pertinent de Twitter, ou par utilisateurs, où les résultats sont des noms d'utilisateurs de Twitter.
* Favoris d'un utilisateur: Il est possible de demander à TW Blue de vous afficher les tweets qu'un utilisateur a marqué comme favori.
Remarque: Uniquement pour cette version de TW Blue, la liste des following et followers peuvent mettre à jour jusq'à 400, ou autour de 400. Dans la prochaine version, nous proposons une méthode pour voir les following et followers pour éviter les erreurs causées par l'utilisation de l'API de Twitter, très fréquente entre les personnes avec plus de 600 following ou followers.
Veuillez noter que la configuration par défaut permet seulement d'afficher les 200 derniers tweets pour les listes principal, mentions, messages directs et chronologie d'un utilisateur. Vous pouvez le modifier dans la boîte de dialogue de configuration dans le menu Application sous Préférences. Pour la list envoyés il s'affichera les 200 derniers tweets et les 200 messages directs. Dans les versions futures ont vous permettra de modifier ce paramètre.
S'il y a une URL dans un tweet, TW Blue va essayer de l'ouvrir lorsque vous appuyez sur entrée sur celle-ci. S'il en existe plusieurs, il vous montrera une liste avec toutes les URLs afin que vous choisissez cellci que vous voulez ouvrir. Si vous êtes sur la boîte de dialogue de la liste des following ou followers, lorsque vous appuyez sur la touche entrée il s'affichera une fenêtre avec les détails de l'utilisateur sélectionné.
Si vous appuyez sur Contrôle+Entrée, TW Blue va lire un audio si disponible à partir du tweet ayants le focus système, tant qu'il existe une URL. Si le tweet a le hashtag #audio, vous entendrez un son lorsque vous passer sur lui en vous faisant alerter que se tweet contient un audio et vous pouvez essayer de le jouer. Toutefois, dans un tweet il peut manquer le hashtag mais TW Blue sera toujours capable de le jouer, tant qu'il comporte une URL avec l'audio.
## Commandes {#commandes}
À partir de la version 0.36, il existe un support pour une interface qui ne nécessite pas d'une fenêtre visible. Celle-ci peut être activé en appuyant sur Contrôle+m, ou en sélectionnant dans le menu Application l'option "Masquer la fenêtre". Cette interface est gérée complètement avec des raccourcis clavier. Ces raccourcis sont différentes de celles utilisées par l'interface graphique. chaqu'une d'entre elles peuvent utiliser uniquement les raccourcis qui lui corresponde, ce qui signifie que vous ne pourrai pas utiliser les raccourcis de l'interface invisible si vous avez activé l'interface graphique. Dans cette section il vous sera détailler tantôt l'interface graphique comme l'interface invisible.
### L'Interface Graphique (GUI) {#gui}
Voici ci-dessous une liste divisée en deux parties. D'une part, les boutons qui sont accessibles en appuyant sur Tab ou Maj + tab dans l'interface du programme et d'autre part, les différents éléments qui existent dans la barre de menus.
#### Boutons de l'application {#boutons}
* Tweet: Ce bouton ouvre la boîte de dialogue pour écrire un tweet. Le message ne doit pas dépasser au-delà de 140 caractères. Lorsque vous écrivez le caractère numéro 141, un son sera joués pour vous avertir que vous avez dépassé la limite permise par Twitter. Vous pouvez réduire ou élargir une URL si celle-ci est incluse dans votre tweet afin de gagner plus d'espace, afin que vous puissiez continuer à écrire. Pour cela, ils existes ces boutons avec ces noms. Appuyez sur entrée pour envoyer le tweet. Si tout s'est bien passé, le message sera envoyé et vous entendrez un son de confirmation. Dans le cas contraire, le lecteur d'écran indiquera un message d'erreur en anglais décrivant le problème.
* Retweet: Ce bouton s'occupe de retwitter le tweet que vous lisez. En appuyant sur ce bouton une fenêtre s'ouvre et ont vous demandera si Vous souhaitez ajouter un commentaire à ce tweet original (mentionner) ou simplement l'envoyer comme il a été écrit sans ajouter quoi que ce soit d'autre.
* Répondre: Lorsque vous visualiser un Tweet, vous pouvez répondre à l'utilisateur qui l'a écrit en cliquant sur ce bouton. Il s'ouvre la même boîte de dialogue que pour le bouton Tweet, mais avec le nom de l'utilisateur (par exemple: @utilisateur), donc il suffit d'écrire le message que vous souhaitez répondre. Si dans le tweet il y a plus d'un utilisateur mentionné, appuyez sur Maj+Tab et cliquez sur le bouton "Mentionner à tous". Lorsque vous êtes dans la liste des following ou followers, ce bouton s'appellera "Mention" à la place.
* Message direct: Exactement pareil que pour envoyer un tweet, mais c'es un message privé qui verra seulement l'utilisateur auquel vous l'envoyez. Appuyez sur Maj+Tab pour voir le destinataire de votre message. Si dans le tweet où vous étiez pour envoyer le message,il y a plus d'un utilisateur mentionné, vous pouvez naviguer avec les flèches haut et bas pour sélectionner un destinataire différent, ou écrivez manuellement le nom de l'utilisateur (sans le signe arobase).
Veuillez noter que les boutons s'affichent selon les actions qui peuvent être effectuées dans la liste où que vous soyez. Par exemple, dans la chronologie principal, mentions, envoyés, favoris et la chronologie de l'utilisateur vous verrez quatre boutons ; alors que dans la liste des messages directs seulement sera disponible le bouton "Message Direct" et "Tweet", et dans les listes following et followers, s'affichera le bouton "Tweet" et celle du "Message direct" à côté de "Mention".
#### La barre de Menus {#menus}
En haut de la fenêtre du programme, vous trouverez une barre de menus qui a les mêmes fonctions et un peu plus, d'où vous pouvez exécuter plusieurs actions dont celles mentionnées ci-dessus. La barre de menu est accessibles en appuyant sur la touche ALT, et actuellement compte avec quatre menus pour différentes actions: Application, Tweet, Utilisateur et Aide. Ci-dessous, nous décrivons les actions pour chaque menu.
##### Menu Application {#app}
* Mettre à jour le profil: Il ouvre une boîte de dialogue où vous pouvez mettre à jour une partie de vos informations sur Twitter. Nom, Localisation, URL et Description. Si vous avez déjà un de ces champs dans le profil ils sont automatiquement préremplis avec les informations existantes dans votre configuration personnelle sur Twitter. Vous pouvez également charger une photo à votre profil.
* Masquer la fenêtre: Il va désactiver l'interface graphique. Lire le paragraphe sur l'interface invisible pour plus de détails sur cette fonctionnalité.
* Rechercher: Affiche une boîte de dialogue où vous pouvez rechercher par tweets ou par utilisateurs sur Twitter.
* Gestionnaire de listes: Afin d'utiliser les listes de Twitter, vous devez d'abord les créer. Cette boîte de dialogue vous permet de voir vos listes, les modifiez, les créez, les supprimez. Éventuellement les listes seront afficher dans les tampons comme vous le feriez avec les chronologies.
* Tutoriel de sons: Ouvre une boîte de dialogue où vous verrez une liste avec les différents sons de TW blue, ainsi vous pouvez les apprendre afin de vous aider à vous familiariser avec eux et vous faciliter l'utilisation de TW Blue.
* Préférences: Ouvre une boîte de dialogue de configuration où vous pouvez contrôler certains aspects du programme. Les options ne nécessitent pas d'explication.
* Sortir: Ouvre une boîte de dialogue pour confirmer si vous souhaitez fermer le programme. Si la réponse est oui, l'application s'arrête.
##### Menu Tweet {#tweet}
* Les premiers éléments du menu sont tweet, répondre et retweet, qui correspondent aux boutons du même nom.
* Ajouter aux favoris: marque le tweet que vous visualisez comme favori.
* Supprimer des favoris: Supprime un tweet de vos favoris. Cela ne signifie pas qui sont supprimés à partir de Twitter, mais n'apparaîtra plus dans votre liste de favoris.
* Voirr tweet: Il ouvre une boîte de dialogue où vous pouvez voir le tweet, message direct, folowing ou follower sur le quelle se trouve le focus de l'application. Vous pouvez lire le texte avec les flèches. C'est la même boîte de dialogue utilisée pour écrire des tweets.
* Supprimer Tweet: Supprime le tweet ou message direct sur le quelle vous êtes, il va être supprimer définitivement de Twitter et il va être supprimer de vos listes. Veuillez noter que dans le cas des Tweets, Twitter permet uniquement de supprimer les tweets que vous avez écrit vous-même.
##### Menu Utilisateur {#utilisateur}
Veuillez noter que les six premier éléments de ce menu ouvrent la même boîte de dialogue. Cette boîte de dialogue comporte une zone d'édition où vous pouvez sélectionner l'utilisateur sur lequel vous voulez agir, bien en utilisant les flèches haut et bas ou en écrivant vous-même le nom. Puis ensuite, vous trouverez un groupe de boutons radio pour suivre, ne pas suivre, muet, désactiver muet, signaler comme spam et bloquer. Si vous choisissez l'élément Suivre dans le menu, le bouton radio Suivre dans la boîte de dialogue sera coché, et il en va de même pour les bboutons radio Ne pas suivre, Signaler comme spam et Bloquer. Appuyez sur le bouton OK pour que le programme essaye d'exécuter l'action. Si le programme ne réussit pas, vous entendrez le message d'erreur en anglais.
Les autres éléments du menu sont décrits ci-dessous:
* Message direct: La même action que le bouton.
* Ajouter à la liste: Afin de voir les tweets d'un utilisateur dans vos listes, vous devez les ajouter tout d'abord. Cette option ouvrira une boîte de dialogue où vous pouvez sélectionner l'utilisateur que vous souhaitez ajouter, ensuite il s'ouvre une autre fenêtre où vous pouvez sélectionner la liste à laquelle vous souhaitez ajouter cet utilisateur. Une fois cela fait, la liste contiendra un nouveau utilisateur et vous verrez ces tweets.
* Voir le profil de l'utilisateur: Il ouvre une boîte de dialogue qui vous permet de sélectionner l'utilisateur auquel vous souhaitez voir le profil.
* Chronologie: Il ouvre une boîte de dialogue où vous pouvez sélectionner l'utilisateur pour lequel la chronologie sera créée. En appuyant sur entrée, il sera créé. Si vous faite une chronologie pour un utilisateur qui n'a aucun Tweets, le programme échouera. Si vous créez une chronologie qui existe déjà le programme vous avertira et il ne vous permettra pas de la créer à nouveau.
* Voir les favoris: Il s'ouvre un tampon où vous pouvez voir quels tweets ont été marquer comme favori par un utilisateur spécifique.
##### Menu Tampon {#tampon}
* Muet: Rend complètement muet le tampon, afin que vous n'entendrez aucun son lorsque les nouveaux tweets arrivent.
* Lecture automatique des tweets pour ce tampon: Cette option active ou désactive la lecture automatique des Tweets. Si cell-ci est activé, le lecteur d'écran ou la voix Sapi5 (si celle-ci est activé) lit automatiquement les nouveau tweet quand ils arrivent au tampon sélectionné.
* Effacer le tampon: Il va vider tous Les éléments afficher dans ce tampon.
* Supprimer le tampon: Efface la liste sur laquelle vous êtes actuellement focalisé.
##### Menu Aide {#aide}
* Documentation: Ouvre ce fichier, où vous pouvez lire quelques concepts intéressants du programme.
* Quoi de neuf dans cette version ?: Ouvre un document avec la liste des changements de la version actuelle, jusqu'à la première version existante.
* Vérifier les mises à jour: Chaque fois que vous ouvrez le programme il recherche automatiquement les nouvelles versions. S'il y a une, il vous demandera si vous voulez la télécharger ; si vous acceptez, TW Blue va télécharger la nouvelle version puis va l'installer et il vous demandera de redémarrer le programme ; (c'est quelque chose qui fait automatiquement). Cette option vérifie les nouvelles mises à jour sans avoir à redémarrer l'application.
* Site Web de TW Blue: Accédez à notre [page d'accueil](http://twblue.com.mx) où vous pouvez trouver toutes les informations pertinentes et téléchargements pour TW Blue, et devenir une partie de la communauté.
* Signaler une erreur: Ouvre une boîte de dialogue pour signaler une erreur en remplissant deux champs d'édition. Le titre et une brève description de ce qui s'est passé. En appuyant sur le bouton "Envoyer le rapport" le rapport d'erreur sera envoyé. Si l'opération ne réussit pas, le programme affichera un message d'avertissement.
* A propos de TW Blue: Affiche les informations de version et les crédits du programme.
### Interface invisible {#interface_invisible}
Si vous appuyez sur Contrôle+M, ou si dans le menu Application vous sélectionnez "Masquer la fenêtre", vous êtes entrain d'activez une interface qui ne peut pas être utilisée de la manière habituelle, parce qu'il est invisible.
Chaque action sur l'interface invisible se fait grâce à des raccourcis clavier, même pour parcourir les listes. Finalement, on peut ouvrir les boîtes de dialogue et ceux-ci seront visibles, mais pas la fenêtre principale de l'application. Lire la section sur les raccourcis clavier de l'interface invisible pour savoir quels sont ceux que vous pouvez utiliser actuellement.
### Raccourcis clavier pour l'interface graphique {#raccourcis}
Au lieu d'utiliser les menus et les boutons, la plupart des actions peuvent être effectuées en appuyant sur une combinaison de touches. Ceux disponibles à l'heure actuelle sont décrits ci-dessous:
* Entrée: Ouvrir une URL. S'il y a plus d'une, vous obtiendrez une liste qui vous permettra de choisir celle que vous voulez. Si vous êtes sur la liste des following ou followers, il affichera les détails de l'utilisateur sélectionné.
* Contrôle+Entrée: Lire un audio si disponible si dans le Tweet il y a une URL contenant de l'audio.
* F5: Diminue de 5% le volume des sons. Ceci affecte les sons joués par le programme ainsi que l'audio que vous pouvez entendre à travers de lui.
* F6: Augmente de 5% le volume des sons de l'application.
* Contrôle+N: Ouvre la boîte de dialogue pour écrire un nouveau Tweet.
* Contrôle+M: Masque la fenêtre.
* Contrôle+Q: Ferme l'application.
* Contrôle+R: Ouvre la boîte de dialogue pour répondre un Tweet.
* Contrôle+Maj+R: Équivalent à l'action de Retweet.
* Contrôle+D: Envoyer un message direct.
* Contrôle+F: Marquer comme favori.
* Contrôle+Maj+F: Supprimer des favoris.
* Contrôle+Maj+V: Voir Tweet.
* Contrôle+S: Suivre un utilisateur.
* Contrôle+Maj+S: Ne pas suivre un utilisateur.
* Contrôle+K: Bloquer un utilisateur.
* Contrôle+Maj+K: Signaler comme spam.
* Contrôle+I: Ouvrir une chronologie d'un utilisateur.
* Contrôle+Maj+I: Supprimer une chronologie d'un utilisateur.
* Contrôle+p: Modifier le profil.
* Supprimer: Supprimer un tweet ou un message direct.
* Maj+supprimer: Vider le tampon en retirant tous les éléments. Cela ne les supprime pas de Twitter.
### Raccourcis clavier pour l'interface invisible {#raccourcis_invisibles}
Voici les raccourcis clavier que vous pouvez utiliser à partir de l'interface invisible. Veuillez noter que lorsque l'affichage de l'interface graphique est activé aucun d'entre eux peut être utilisé. Lorsque ont parle de "Windows", nous nous référons à la touche Windows de gauche.
* Contrôle+Windows+Flèche Haut: Parcourir la liste actuelle vers le haut.
* Contrôle+Windows+Flèche bas: Parcourir la liste actuelle vers le bas.
* Contrôle+Windows+Flèche Gauche: Aller à l'onglet précédent.
* Contrôle+Windows+Flèche Droite: Aller à l'onglet suivant.
* Contrôle+Windows+Origine: Aller au premier élément de la liste.
* Contrôle+Windows+Fin: Aller au dernier élément de la liste.
* Contrôle+Windows+Page Suivante: Sauter de 20 éléments vers le bas dans la liste actuelle.
* Contrôle+Windows+Page Précédente: Sauter de 20 éléments vers le haut dans la liste actuelle.
* Contrôle+Windows+Alt+Flèche Haut: Augmenter le volume de 5%.
* Contrôle+Windows+Alt+Flèche Bas: Diminuer le volume de 5%.
* Contrôle+Windows+Entrée: Ouvrir l'URL dans le tweet actuel, ou voir les détails d'un utilisateur si vous êtes dans la liste following ou follower.
* Contrôle+Windows+Alt+Entrée: Lire un audio si disponible.
* Contrôle+Windows+M: Affiche l'interface graphique, en désactivant l'interface invisible.
* Contrôle+Windows+N: Nouveau tweet.
* Contrôle+Windows+R: Répondre à un tweet.
* Contrôle+Windows+Maj+R: Retweet.
* Contrôle+Windows+D: Envoyer un message direct.
* Contrôle+Windows+Supprimer: Supprimer un tweet ou un message direct.
* Contrôle+Windows+Maj+Supprimer: Vider le tampon en retirant tous les éléments. Cela ne les supprime pas de Twitter.
* Windows+Alt+F: Marquer comme favori.
* Windows+Alt+Maj+F: Supprimer des favoris.
* Contrôle+Windows+S: Suivre un utilisateur.
* Contrôle+Windows+Maj+S: Ne pas suivre un utilisateur.
* Contrôle+Windows+Alt+N: Voir les détails d'un utilisateur.
* Contrôle+Windows+V: Voir le tweet dans une zone d'édition.
* Contrôle+Windows+I: Ouvrir une chronologie d'un utilisateur.
* Contrôle+Windows+Maj+I: Supprimer une chronologie d'un utilisateur.
* Alt+Windows+P: Modifier le profil.
* Contrôle+Windows+Espace: Voir le tweet actuel.
* Contrôle+Windows+c: Copier dans le Presse-papiers le tweet sélectionné.
* Contrôle+Windows+a: Ajouter un utilisateur à une liste.
* Contrôle+Maj+Windows+a: Supprimer l'utilisateur de la liste.
* Contrôle+Windows+Maj+M: Activer / désactiver les sons pour le tampon actuel.
* Contrôle+Windows+E: Activer ou désactiver la lecture automatique pour les tweets entrants dans le tampon actuel.
* Contrôle+Windows+Maj+Flèche Haut: Aller au tweet précédent dans la conversation.
* Contrôle+Windows+Maj+Flèche Bas: Aller au tweet suivant dans la conversation.
* Windows+Alt+M: Activer / désactiver tous les sons pour TW Blue.
* Contrôle+Windows+- (tiret): Rechercher sur Twitter.
* Contrôle+Windows+F4: Sortir du programme.
## Listes {#listes}
Une des caractéristiques plus intéressantes de Twitter sont les listes, car ils sont un moyen pour rester à jour sans avoir à lire les tweets de tous les utilisateurs que vous suivez. Avec une liste de Twitter seulement vous verrez les tweets de ces membres (ceux qui sont sur la liste). Il est similaire à une chronologie, mais pour beaucoup plus d'utilisateurs.
Dans TW blue Nous avons commencé à fournir un support pour cette fonctionnalité. Pour le moment nous allons lentement, mais il est possible d'utiliser cette fonction. Ont va vous expliquer étape par étape comment faire pour ouvrir une liste avec TW Blue.
* Tout d'abord, vous devrez aller dans le menu Application, sélectionnez "Gestionnaire de listes".
* Dans la boîte de dialogue "Gestionnaire de listes", vous verrez toutes les listes auxquelles vous êtes inscrit, à commencer par ceux que vous avez créée. Si vous ne voyez aucune liste dans cette boîte de dialogue, cela signifie que vous n'avez pas créé ou que vous n'êtes pas un membre d'une liste. C'est bien.
* Vous verrez un groupe de bouton: "Créer une nouvelle liste", "Modifier", "Effacer "et "Ouvrir dans un tampon". Le dernier d'entre eux est peut-être un peu moins explicite, c'est-à-dire il ouvrira la liste dans un nouveau tampon pour que TW Blue actualise la liste des Tweets de la même manière comme pour une chronologie.
Une fois que vous avez créé une nouvelle liste, la prochaine étape sera d'ajouter des utilisateurs à cette liste. Si vous deviez ouvrir dès maintenant une liste dans un tampon, elle sera vide et aucun tweets ne seraient présent dans cette liste. C'est pour cela que vous ne devez pas ouvrir celle-ci dans un tampon. En tout cas pas immédiatement, parce que vous n'avez pas aucun membre dans cette liste et cela signifie que lorsque les tweets sont chargés pour commencer à actualiser la liste vous ne verrez rien. Il est recommandé tout d'abord d'ajouter des utilisateurs à la liste, donc pour cela procédez comme suit:
* Lorsque vous avez fermé la boîte de dialogue "Gestionnaire de listes", et que vous naviguez entre les Tweets des utilisateurs, rechercher l'utilisateur auquel vous souhaitez ajouter à la liste.
* Une fois trouvé, cliquez sur le raccourci Windows+Contrôle+A ; ou allez dans le menu Utilisateur et sélectionnez l'option "Ajouter à la liste".
* La prochaine chose que vous verrez est une boîte de dialogue qui vous permet de sélectionner l'utilisateur, assurez-vous que c'est l'utilisateur qui est par défaut et si c'est celui-ci que vous voulez, ou changez si nécessaire. Le nom de l'utilisateur contenant le tweet que vous venez de sélectionner devrait déjà être dans la zone. Il suffit de confirmer qu'il est correcte et appuyez sur le bouton "OK".
* Une autre boîte de dialogue s'affiche, mais ici sont toutes vos listes. Sélectionner une liste. Flèche sur celle que vous voulez et appuyez sur le bouton "Ajouter".
* Pour supprimer un utilisateur d'une liste répètez la même procédure, mais appuyez sur Contrôle+Windows+Maj+A ; ou allez dans le menu Utilisateur et sélectionnez l'option "Supprimer de la liste", et, dans la boîte de dialogue qui apparaît, Choisissez la liste dont vous souhaitez supprimer l'utilisateur sélectionné et appuyez sur le bouton "Effacer".
## Signaler une erreur depuis le Web {#signaler}
Remarque: Si vous utilisez également le programme vous pouvez signaler une erreur depuis le même, en utilisant l'option dans le menu Aide. Cette procédure seulement vous demande de remplir les deux zones d'édition, et il gère le reste. Ces étapes sont rédigés pour ceux qui ne peut pas ouvrir le programme, ne l'ont pas en cours d'utilisation actuellement ou tout simplement il souhaite le signaler depuis le Web au lieu du système intégré de rapports d'erreurs.
Les choses de ce monde (oui, y compris le logiciel) sont loin de être parfait, si souvent, que vous rencontrerez des erreurs inattendues dans l'application. Mais l'intention est toujours d'améliorer, vous êtes libre (il serait formidable si vous le fassiez) de signaler les erreurs que vous vous allez y trouver dans le programme afin qu'ils puissent être réviser et éventuellement être corriger.
Pour accéder à la page Web qui est en espagnol réservée au rapport d'incidents, suivez [Ce lien.](http://twblue.com.mx/errores/bug_report_page.php) C'est une page Web qui est en espagnol avec un formulaire où vous devrez remplir plusieurs champs. Seulement trois d'entre eux sont vraiment obligatoires (ceux qui sont marqué d'un astérisque), mais entre plus de champs que vous pourriez remplir, ce sera mieux.
A titre d'information!: J'ai fait la traduction de la page en espagnol vers le français contenant les différents champs du formulaire et ce que vous devez entrer, vous le trouverez ci-dessous. Les champs marqués d'un * (astérisque) sont obligatoire!.
Voici les différents champs du formulaire et ce que vous devez entrer dans chaqu'un d'entre eux. N'oubliez pas que seulement les champs marqués d'un astérisque (*) sont obligatoires.
* Catégorie: Cette zone de liste déroulante permet de choisir à quelle catégorie est assigner l'erreur. Il peut être dans la catégorie Générale, si c'est une erreur du programme, ou de documentation, si vous avez trouvé une erreur dans ce fichier ou dans la liste des changements. Ce champ est obligatoire.
* Reproductibilité: Ici, vous devez indiquer combien il est facile ou il est difficile de reproduire l'erreur. Les options disponibles sont Inconnus, Non reproductibles, Pas essayé (par défaut), aléatoire, parfois ou toujours. Selon la question de savoir si vous pouvez reproduire l'erreur ou non, vous devez choisir le plus près à votre situation. Si vous faites une demande de fonctionnalité, ce champ n'est pas pertinent.
* Gravité: Ici vous choisissez combien elle affecte le programme. Les options disponibles sont fonctionnalités (choisissez cette option pour une demande de fonctionnalité), Trivial, Texte, Réglage, Mineur, Majeur, Incident ou Blocage. Remarquez que les options augmentent de niveau. Choisissez celui qui correspond le mieux a la situation. Si vous ne savez pas lequel choisir vous pouvez le laisser tel qu'il est.
* Priorité: Dans cette zone de liste déroulante il faut choisir en fonction de l'importance de l'erreur ou fonctionnalité demandée. Les options disponibles sont Aucun, Faible, Normale, Haute, Urgent et Immédiat.
* Sélectionner Profil: ici vous pouvez choisir la configuration d'architecture (32 ou 64 bits), et le système d'exploitation (Windows 7 pour l'instant). Si non, vous pouvez remplir les trois champs d'édition qui se trouvent dans le tableau ci-dessous avec vos informations spécifiques.
* Version du produit: Choisissez la version du programme que vous utilisez pour être en mesure de savoir où l'erreur a été générée. Dans cette zone de liste déroulante vous aurez la liste des versions dans l'ordre. Bien qu'il n'est pas obligatoire, cela aiderait beaucoup à résoudre plus rapidement l'erreur.
* Résumé: Un titre pour l'erreur, expliquant en quelques mots En quoi consiste le problème. C'est un champ d'édition obligatoire.
* Description: Ce champ est obligatoire Il vous demande de décrire plus en détail ce qui s'est passé avec le programme.
* Étapes pour reproduire: Ce champ est utilisé si vous savez comment l'application a pu générer l'erreur. Il n'est pas nécessaire, mais cela aiderait beaucoup de savoir comment le programme arrive à l'erreur afin de mieux le traquer.
* Information supplémentaire: Si vous avez un commentaire ou une remarque à ajouter, il peut aller ici. Il n'est pas obligatoire.
* Charger un fichier: Ici vous pouvez charger le fichier TW Blue.exe.log qui a été créé contenant l'erreur génèré par le programme. Il n'est pas obligatoire.
* Visibilité: Choisissez si vous voulez que l'erreur soit public ou soit privé. Par défaut il est public, et il est recommandé de le garder de cette façon.
* Envoyer le rapport: Appuyez sur le bouton figurant sur la page pour envoyer le rapport d'erreur et attendre que celui-ci soit pris en charge.
Merci beaucoup pour votre participation à signaler des erreurs et d'essayer de nouvelles fonctionnalités.
## Contact {#contact}
Si ce qui est exposé dans le présent document n'est pas suffisant, si vous voulez contribuer d'une autre manière, ou si vous voulez tout simplement entrer en contact avec le développeur de l'applications, suivez le compte Twitter, [@tw_blue2](https://twitter.com/tw_blue2) ou [@manuelcortez00.](https://twitter.com/manuelcortez00) Vous pouvez également visiter notre [Site Web à](http://twblue.com.mx)
---
Copyright © 2013-2014. Manuel Cortéz.

BIN
doc/locales/gl/lc_messages/twblue-documentation.mo Normal file
View File

Binary file not shown.

1641
doc/locales/gl/lc_messages/twblue-documentation.po Normal file
View File

File diff suppressed because it is too large Load Diff

BIN
doc/locales/hu/lc_messages/twblue-documentation.mo Normal file
View File

Binary file not shown.

1265
doc/locales/hu/lc_messages/twblue-documentation.po Normal file
View File

File diff suppressed because it is too large Load Diff

BIN
doc/locales/it/lc_messages/twblue-documentation.mo Normal file
View File

Binary file not shown.

1620
doc/locales/it/lc_messages/twblue-documentation.po Normal file
View File

File diff suppressed because it is too large Load Diff

274
doc/locales/it/manual.md Normal file
View File

@ -0,0 +1,274 @@
% Guida utente TW Blue
# Versione 0.42 (alfa)
# Attenzione!
Questo manuale fa riferimento a una versione in sviluppo. L'intento del manuale è dare alcuni dettagli sul funzionamento del programma. Considerare che il programma è continuamente in sviluppo, alcune funzioni del software possono non corrispondere, è consigliabile seguire lo sviluppo per non perdere nuove informazioni.
Per leggere le novità rispetto alle precedenti versioni, [Leggi le novità quì.](changes.html)
# TW Blue
TW Blue è un'applicazione che consente di utilizzare Twitter in modo semplice, rapido, con l'utilizzo di poche risorse del computer in uso. Di seguito le azioni che puoi eseguire in Twitter attraverso TWBlue:
* Scrivere, rispondere, Ritwittare e eliminare Tweet;
* Segnare come favorito, eliminare dai favoriti un tweet;
* Inviare ed eliminare messaggi diretti (DM);
*Visualizzare i tuoi seguitori e chi stai seguendo;
* •Seguire, non seguire, riportare come spam o bloccare un utente;
* Aprire una linea temporale specifica per un utente, che permette di leggere i tweet dell'utente scelto in un unico elenco;
* Aprire collegamenti a pagine web se presenti in un tweet o nei messaggi;
* Riprodurre file o collegamenti che contengono audio;
* E ancora di più!.
# Tabella dei contenuti
Per utilizzare un client come TW Blue che permette di gestire un account Twitter, occorre esser registrati al social network. Questa documentazione non ha l'intento di spiegare la procedura per iscriversi a Twitter. Per iniziare ti occorre il tuo nome utente e password che usi per accedere al tuo account. La documentazione riguarderà queste sezioni.
* [Autorizzare l'applicazione](#autorizar)
* [L'interfaccia del programma](#interfaz)
* [Comandi](#controles)
* [Interfaccia grafica (GUI)](#gui)
* [Pulsanti dell'applicazione](#botones)
* [Menu](#menus)
* [Menu Applicazione](#app)
* [Menu Tuit](#tuit)
* [Menú Utente](#usuario)
* [Menú buffer](#buffer)
* [Menú Aiuto](#ayuda)
* [Interfaccia Invisibile](#interfaz_no_visible)
* [Shortcuts per l'interfaccia Grafica](#atajos)
* [Shortcuts per l'interfaccia invisibile](#atajos_invisibles)
* [Liste](#listas)
* [Riportare un errore](#reportar)
* [Contatti](#contacto)
## Autorizzare l'applicazione {#autorizar}
Prima di tutto, è necessario autorizzare il programma perché questo possa accedere al tuo account Twitter. Il processo di autorizzazione è abbastanza semplice, il programma non potrà in nessun momento aver accesso ai tuoi dati. Per autorizzare l'applicazione eseguire TW Blue.exe.
Al primo avvio del programma si aprirà una finestra di dialogo la quale informa che sarai collegato alla pagina di Twitter per autorizzare l'applicazione. Premere il pulsante "Accetto" per iniziare il processo di autorizzazione.
Una pagina si aprirà nel browser con la richiesta di autorizzazione. inserisci i tuoi dati di accesso, e premi il pulsante Autorizza.
Se il processo di login ha avuto esito positivo, si apre una pagina con le istruzioni proposte da Twitter. Viene visualizzato un codice alfa-numerico che si dovrà copiare e inserire nell'apposita finestra del programma.
Premi invio per accettare il codice di autorizzazione.
Se tutto è andato a buon fine, l'applicazione riproduce un set di suoni che confermano che si stanno aggiornando i tuoi dati.
Al termine, si udirà un altro suono di avvio e lo Screen Reader annuncerà "Pronto!".
## Interfaccia del programma {#interfaz}
Il modo più semplice per descrivere l'interfaccia grafica è quella di una finestra con una barra che contiene cinque menu (Applicazione, Tweet, Utente, Buffer ed Aiuto). Un elenco nel riquadro principale e, nella maggior parte dei casi, tre pulsanti; Tweet, retweet e Rispondi. Le azioni per ciascuno di questi elementi saranno descritti di seguito.
Gli elementi presenti nell'elenco possono esser Tweet, messaggi diretti o utenti. TW Blue visualizza diverse schede per vari elenchi, quindi questi elementi possono esser Tuits inviati, Tweet ricevuti nella linea temporale principale, favoriti, o messaggi diretti. Ogni scheda contiene un solo tipo di questi elementi, queste schede sono chiamate buffers.
Per selezionare i buffer premere Control+Tab o Control+Shift+Tab per retrocedere. Ogni qual volta si cambia buffer il lettore di schermo annuncia il riquadro focalizzato. Di seguito i buffer presenti in TW Blue.
* Linea Temporale: quì verranno visualizzati i Tweet nella linea temporale principale. Sono i Tweet degli utenti che stiamo seguendo attualmente.
* Menzioni: Se un utente (seguitore o meno) ti menziona in Twitter, verrà visualizzato in questo buffer il tweet.
* Messaggi Diretti: visualizza i messaggi diretti (DM privati) che puoi scambiare solo con gli utenti che segui e che ti seguono. Questo elenco visualizza solo i messaggi ricevuti.
* Inviati: visualizza i Tweet e i messaggi diretti inviati dal tuo account.
* •Favoriti: l'elenco dei tweet segnalati come favoriti.
* Followers: elenco degli utenti che ti stanno seguendo, con alcune informazioni riguardo il loro account Twitter.
* Following: elenco degli utenti che stai seguendo.
* Notifiche: alcuni eventi vengono registrati come notifiche in Twitter. In questo buffer verranno visualizzate le notifiche più comuni (per esempio qualcuno ha iniziato a seguirti, hanno segnalato o rimosso un tuo tweet come favorito, ti sei iscritto a una lista). Sono tutte le notifiche che invia twitter e TW Blue organizza in un elenco per non perderti ciò che accade al tuo account.
* Linea Temporale di un utente: è possibile creare linee temporali per specifici utenti. In questo elenco appariranno solo i tweet di uno specifico utente. Utile per cercare i tweet di una determinata persona, senza dover scorrere tutta la Linea Temporale principale. Si possono creare più linee temporali specifiche per ogni utente, a seconda delle necessità.
* Lista: Una lista È simile a una linea temporale, ma visualizza solo i tweets degli utenti che ne fanno parte. Attualmente questa caratteristica è sperimentale in TW Blue. In caso si verificano problemi con questa caratteristica, si prega di contattarci e segnalare l'errore.
* Ricerca: Un buffer contenente i risultati della ricerca con TW Blue. Le ricerche possono essere per tweets, nel caso si cerca un termine contenuto in tweet, o per utenti, dove i risultati sono i nomi utente di Twitter.
* Favoriti di un utente: è possibile visualizzare in TW Blue i tweet che un utente ha contrassegnato come preferito.
Nota: Solo per questa versione di TW Blue, l'elenco degli utenti che segui e che ti seguono si aggiorna a 400, o circa 400. Ci proponiamo per le prossime versioni un metodo per evitare gli errori della API di Twitter, segnalato da persone con più di 600 utenti che segue o che stanno seguendo.
Di default vengono visualizzati 200 tweet nel buffer principale, menzioni, messaggi diretti e linee temporali specifiche. Dal menu preferenze è possibile cambiare questa impostazione. Per gli elementi inviati verranno visualizzati gli ultimi 200 Tuits e 200 messaggi diretti. Le versioni future vi permetteranno di impostare anche questo parametro.
Se è presente un link nei tweet, TW Blue tenterà di aprirla premendo Invio. Se son presenti più collegamenti, si aprirà una finestra di dialogo per selezionare il link che si desidera aprire. Nell'elenco dei follower o following, premendo Invio verrà mostrata una finestra con i dettagli dell'utente.
Premendo Control+Invio, TW Blue riproduce l'audio inserito nel tweet selezionato, se è presente un collegamento audio. Se il tweet contiene l'etichetta #audio, verrai avisato da un suono che è possibile riprodurre l'audio. Può comunque accadere che non appare nessuna etichetta, ma TW Blue può riprodurre ugualmente l'audio, sempre che ci sia un collegamento.
## Comandi da tastiera {#controles}
Dalla versione 0.36, Vi è il supporto per un'interfaccia che non richiede una finestra visibile. Questa può esser attivata premendo Control+m, o dal menu Applicazione selezionando "Nascondi la finestra". Questa interfaccia è completamente gestita con le scorciatoie da tastiera. Queste scorciatoie sono diverse da quelle utilizzate per l'interfaccia grafica. Ogni interfaccia ha i suoi comandi specifici, ciò significa che non si possono usare i comandi dell'interfaccia grafica se è attiva l'interfaccia invisibile. Vediamo in dettaglio i comandi per l'interfaccia grafica e l'interfaccia invisibile.
### Interfaccia grafica (GUI) {#gui}
Di seguito un elenco diviso in due parti. Da una parte i pulsanti che si raggiungono premendo Tab o Shift+Tab nell'interfaccia del programma, e in secondo luogo, i diversi elementi della barra dei menu.
#### Pulsanti dell'applicazione {#botones}
* Twit: Questo pulsante apre una finestra di dialogo per digitare un tweet. Il limite è 140 caratteri, Quando si scrive il numero di carattere 141, verrà riprodotto un suono per avvisarti che hai superato il limite consentito da Twitter. È possibile accorciare o espandere un link, se vuoi includerlo,per guadagnare più spazio. Premere Invio per inviare il tweet. Se tutto è andato a buon fine, il messaggio viene inviato e si sente un suono di conferma. In caso contrario verrai avisato da un messaggio del mancato invio.
* Retweet: Reinvìa il tweet selezionato. È possibile aggiungere un commento al tweet originale (citandolo) o semplicemente inviarlo senza modifiche.
* Rispondi: È possibile rispondere al tweet selezionato premendo questo pulsante. Si apre una finestra di dialogo uguale a quella per i Tweet, con l'aggiunta del l'utente menzionato (per esempio @nomeutente). Se nel tweet ci son più utenti menzionati, premere Shift+Tab e premere il pulsante "Menziona a tutti". Nell'elenco follower e following, Questo pulsante è chiamato Menziona.
* Messaggio Diretto: come per la finestra per inviare Tweet, ma è un messaggio privato che può visualizzare solo l'utente a cui si invia. Premendo Shift+Tab si legge il destinatario del messaggio. Se nel tweet usato per richiamare il messaggio diretto sono presenti più utenti menzionati, si può navigare con le freccie per scegliere un destinatario diverso, o digitare manualmente il nome utente (senza il simbolo chiocciola).
Si noti che i pulsanti appariranno a seconda delle azioni che possono essere eseguite nel buffer focalizzato. Per esempio, nella linea temporale principale e specifica, menzioni, inviati, e preferiti verranno visualizzati i quattro pulsanti comuni. Invece nella scheda messaggi Diretti saranno presenti i pulsanti "Messaggio Diretto" e "tweet", mentre negli elenchi dei follower o following appare il pulsante "Twit" e "Messaggio Diretto" con quello "Menziona".
#### Barra del Menu {#menus}
Nella parte superiore della finestra del programma troverete una barra dei menu dal quale è possibile eseguire vari comandi compresi quegli sopra citati. Si accede al menu con il tasto Alt, attualmente sono presenti quattro menu per diverse azioni: Applicazione, Tweet, Utente e Aiuto. Di seguito si descrivono le azioni per ciascun menu.
##### Menú applicazione {#app}
* Aggiorna il profilo: apre una finestra dal quale è possibile modificare informazioni del tuo profilo in Twitter. Nome, localizzazione, indirizzo web e una descrizione. Inizialmente verranno visualizzati i dati attualmente inseriti nella tua configurazione personale di Twitter. È anche possibile inserire una foto al profilo.
* Nascondi la finestra: Disattiva l'interfaccia grafica. Leggere la sezione relativa all'interfaccia invisibile per maggiori dettagli su questa caratteristica.
* Ricerca: apre una finestra di dialogo per effettuare una ricerca per tweet o per utente in twitter.
* Gestione liste: Per utilizzare le liste di Twitter, è necessario prima crearle. Questa finestra di dialogo permette di visualizzare le tue liste, modificarle, crearne nuove, eliminarla. Le liste verranno visualizzate nell'area buffer così come sono le linee temporali.
* Tutorial dei suoni: Apre una finestra di dialogo con l'elenco dei suoni usati da TW blue, per aiutarti a famigliarizzare e facilitare l'utilizzo di TW Blue.
* Preferenze: Apre una finestra di configurazione dove è possibile controllare alcuni aspetti del programma.
* Esci: apre una finestra di dialogo per la conferma in caso si vuol uscire dal programma.
##### Menú Tweet {#tuit}
* I primi elementi del menu sono:Tweet, Rispondi e retweet, che corrispondono ai pulsanti con lo stesso nome.
* Aggiungi ai preferiti: segna il tweet selezionato come preferito.
* Rimuovi dai preferiti: Elimina un tweet dai preferiti. Questo non significa che vengono cancellati da Twitter, ma non verrà più visualizzato nell'elenco preferiti.
* Visualizza tweet: Apre una finestra per visualizzare un Tweet, un messaggio diretto selezionato . Permette di leggere il testo usando il cursore, molto simile alla finestra per scrivere Tweet.
* Elimina tweet: elimina il tweet o il messaggio diretto selezionato, rimuovendolo da Twitter e togliendolo dall'elenco. Si noti che nel caso di Tweets, Twitter consente di eliminare solo i tweet che hai scritto.
##### Menú Utente {#usuario}
Le prime sei opzioni di questo menu aprono la stessa finestra. Nel campo editazione è possibile indicare l'utente sulla quale si intende agire. Le varie azioni sono selezionabili con dei pulsanti radio. Se dal menu si sceglie Segui, nella finestra apparirà selezionato lo stesso pulsante radio, così per le altre azioni come unmute, non seguire, blocca ecc... Per accettare ed eseguire l'azione premere Invio. In caso l'azione scelta non può esser eseguita, verrai avvisato da un messaggio.
Di seguito le altre opzioni del menu Utente:
* Messaggio Diretto: la stessa azione del pulsante.
* Aggiungi alla lista: Per visualizzare i tweet di un utente nella tua lista, occorre prima aggiungerlo. Questa opzione apre una finestra di dialogo da cui è possibile selezionare l'utente che si desidera aggiungere, quindi apre un'altra finestra dove è possibile selezionare la lista a cui aggiungere l'utente. Una volta fatto, la lista conterrà un nuovo utente e visualizzerà i suoi tweet.
* Visualizza il profilo utente: Apre una finestra di dialogo in cui è possibile selezionare l'utente che si desidera vedere il profilo.
* Linea temporale: Apre una finestra da cui è possibile selezionare l'utente per il quale verrà creata una linea temporale specifica. Premendo Invio verrà creata. Se si tenta di creare una linea temporale di un utente che non ha nessun Tweet, il programma avrà esito negativo. Se una linea temporale per l'utente è già esistente verrai avvisato da un messaggio, non si possono creare linee temporali già esistenti.
* Visualizza preferiti: Apre un buffer per visualizzare i favoriti di un utente specifico
##### Menú Buffer {#buffer}
* Mute: silenzia il buffer, non verrà riprodotto nessun suono al verificarsi di nuovi eventi per questo buffer.
* Leggi automaticamente tweet per questo buffer: Questa opzione abilita o disabilita la lettura automatica di tweet. Se attivato, il lettore di schermo o SAPI5 vocale (se abilitato) leggerà i nuovi tweet quando arrivano al buffer selezionato.
* Ripulisci l'elenco: svuota gli elementi visualizzati nel buffer.
* Elimina elenco: elimina il buffer attualmente focalizzato.
##### Menú Aiuto {#ayuda}
* Documentazione: Apre questa guida per apprendere le caratteristiche e funzioni del programma.
* Cosa c'è di nuovo in questa versione?: apre un documento con l'elenco delle modifiche della versione attuale, rispetto alla prima versione.
* Ricerca di aggiornamenti: questa opzione controlla la disponibilità di aggiornamenti senza dover riavviare l'applicazione. Ogni volta che TW Blue si avvia, questo controlla automaticamente se ci sono nuove versioni. In caso di aggiornamenti verrai avisato ed apparirà una richiesta di conferma per scaricare; se si accetta, TW Blue scaricherà la nuova versione, quindi installa e riavvia il programma in automatico.
* Sito web di TW Blue: vai alla nostra Home page dove si possono trovare tutte le informazioni e download relative a TW Blue, e partecipare alla comunità.
* Riporta un errore: apre una finestra per segnalare eventuali errori compilando due campi editazione. Il titolo e una breve descrizione di ciò che è accaduto. Premendo il pulsante "Invia", il rapporto di errore verrà inviato. In caso di mancato invio, verrai avvisato da un messaggio.
* Informazioni su TW Blue: Mostra informazioni sulla versione e credits del programma.
### Interfaccia invisibile {#interfaz_no_visible}
Premendo Control+M, o dal menu Applicazione selezioni Nascondi Finestra, si attiva un'interfaccia per la quale non si usano i comandi convenzionali, è l'interfaccia invisibile.
Nell'interfaccia invisibile si possono eseguire solo comandi da tastiera, incluso quelli per scorrere gli elenchi. Potranno apparire messaggi di dialogo visibili, ma l'interfaccia principale sarà non visibile. Vai alla sezione scorciatoie da tastiera per l'interfaccia invisibile per conoscere i comandi attualmente disponibili.
### Scorciatoie da tastiera per l'interfaccia grafica {#atajos}
Oltre ai pulsanti e menu, La maggior parte delle azioni possono essere eseguite premendo una combinazione di tasti. Di seguito le shortcuts disponibili:
* Invio: Permette di aprire un link. Se in un tweet ci son più link, verrà visualizzato un elenco dei link che potrai aprire. Nell'elenco dei follower o following, visualizza dettagli dell'utente selezionato.
* Control+Invio: Riproduce l'audio contenuto nel tweet.
* F5: Diminuisce il volume (5%). Riguarda sia il volume dei suoni che dell'audio riprodotto con il programma.
* F6: aumenta il volume (5%) dei suoni dell'applicazione.
* Control+N: Apre una finestra per scrivere un nuovo Tweet.
* Control+M: Nasconde la finestra.
* Control+Q: esce dall'applicazione.
* Control+R: apre la finestra per rispondere a un tweet.
* Control+Shift+R: Equivalente all'azione Retweet.
* Control+D: Invia un messaggio diretto.
* Control+F: segna come preferito.
* Control+Shift+F: cancella dai preferiti.
* Control+Shift+V: visualizza tweet.
* Control+S: segui un utente.
* Control+Shift+S: non seguire più.
* Control+K: blocca utente.
* Control+Shift+K: riportare come Spam.
* Control+I: apre una linea temporale specifica.
* Control+Shift+I: elimina la linea temporale in uso.
* Control+p: modifica profilo.
* Delete: elimina il tweet o il messaggio diretto selezionato.
* Shift+Delete: svuota il buffer, rimuovendo tutti gli elementi ricevuti. Gli elementi non verranno rimossi da Twitter.
### Tasti di scelta rapida per l'interfaccia invisibile {#atajos_invisibles}
Queste sono le scorciatoie da tastiera che è possibile utilizzare nell'interfaccia invisibile. Si noti che quando l'interfaccia grafica è attivata nessuno di questi può essere utilizzato. Con il tasto "windows", ci riferiamo al tasto Windows di sinistra.
* Control+Windows+Freccia sù: Scorre l'elenco verso l'alto.
* Control+Windows+Freccia giù: Scorre l'elenco verso il basso.
* Control+Windows+Freccia sinistra: Passa alla scheda di sinistra.
* Control+Windows+Freccia destra: Passa alla scheda a destra.
* Control+Windows+Home: Vai alla prima voce dell'elenco.
* Control+Windows+Fine: Vai all'ultima voce dell'elenco.
* Control+Windows+pagina giù: salta 20 voci dell'elenco verso il basso.
* Control+Windows+Pagina sù: salta 20 voci dell'elenco verso l'alto.
* Control+Windows+Alt+Freccia sù: aumenta il volume del 5%.
* Control+Windows+Alt+Freccia giù: abbassa il volume del 5%.
* Control+Windows+Invio: apre un link nel tweet, apre i dettagli di un utente se ti trovi nell'elenco follower o following.
* Control+Windows+Alt+Invio: riproduce audio se disponibile.
* Control+Windows+M: visualizza l'interfaccia grafica, disattivando l'interfaccia invisibile.
* Control+Windows+N: nuovo tweet.
* Control+Windows+R: rispondi a un tweet.
* Control+Windows+Shift+R: retweet.
* Control+Windows+D: invia un messaggio diretto.
* Control+Windows+Delete: elimina un tweet o un messaggio diretto.
* Control+win+Shift+Delete: svuota buffer, rimuovendo tutte le voci fino a questo momento. Le voci non vengono eliminate da Twitter.
* Windows+Alt+F: segna come preferito.
* Windows+Alt+Shift+F: rimuovi dai preferiti.
* Control+Windows+S: segui.
* Control+Windows+Shift+S: non seguire più.
* Control+Windows+Alt+N: Visualizza i dettagli di un utente.
* Control+Windows+V: visualizza tweet.
* Control+Windows+I: Apri una linea temporale.
* Control+Windows+Shift+I: elimina una linea temporale specifica.
* Alt+Windows+P: Modifica il tuo profilo.
* Control+win+Spazio: visualizza il tweet attuale.
* Control+win+c: copia negli appunti il tweet selezionato.
* Control+windows+a: Aggiungere un utente ad una lista.
* Control+shift+windows+a: rimuovi dalla lista.
* Control+Windows+Shift+freccia sù: vai al tweet precedente nella conversazione.
* Control+Windows+freccia giù: vai al tweet successivo nella conversazione.
* Control+Windows+Shift+M: Attivare o disattivare i suoni per il buffer attuale.
* Windows+Alt+M: abilita o disabilita tutti i suoni per TW Blue.
* Control+Windows+E: attiva o disattiva la lettura automatica dei tweet nel buffer attuale.
* Control+windows+-(trattino): ricerca in Twitter.
* Control+Windows+F4: Chiude il programma.
## Le liste {#listas}
Una delle caratteristiche più interessanti di Twitter sono le liste, un modo comodo per rimanere aggiornati su alcuni argomenti specifici senza dover leggere tutti i tweet degli utenti che segui. Con una lista di Twitter vedrete soltanto i tweet dei suoi membri. Simile alla linea temporale specifica, ma può includere più utenti.
In TW blue Abbiamo cominciato a dare supporto per questa funzionalità. Lo sviluppo procede man mano, è però possibile sfruttare questa caratteristica. Spieghiamo passo passo come aprire una lista con TW Blue.
* Dal menù Aplicazione seleziona Gestione Liste.
* nel gestore Liste vengono visualizzate tutte le liste a cui sei iscritto, a partire da quelle che hai creato. Se non si vede alcun elenco in questa finestra di dialogo, significa che non ne hai creato, o non sei membro di nessuna lista.
* Vengono visualizzati alcuni pulsanti che non hanno bisogno di spiegazione: Crea nuova lista, Modifica, Elimina, apri in un buffer (apre un nuovo buffer in modo che TW Blue aggiorna l'elenco dei tweet allo stesso modo delle linee temporali).
Appena creata una nuova lista, non si dovrebbe aprire in un buffer. Non immediatamente, In quanto al principio non ci sono membri e quindi non verranno caricati tweet. Si consiglia di aggiungere persone alla lista, così come spiegato:
* Creata la lista e chiuso il Gestore Liste, cerca l'utente che desideri aggiungere alla tua lista.
* Una volta trovato, premi Control+Win+A, o dal menù Utente selezionare l'opzione "Aggiungi alla Lista".
* Appare una finestra che ti permette di selezionare l'utente da aggiungere, assicurati che quello selezionato sia quello che hai scelto, o modìficalo se necessario e premi Invio per accettare;
* Si apre un'altra finestra di dialogo dove son visualizzate tutte le tue liste. Seleziona quella al quale vuoi aggiungere l'utente e premi il pulsante Aggiungi;
* Per rimuovere un utente da una lista, si ripete lo stesso procedimento, premendo però Control+Win+Shift+A, o selezionando "Rimuovi dalla lista", e nella finestra delle liste premere "Rimuovi".
## Riportare un errore {#reportar}
Nota: Se si sta utilizzando il programma è anche possibile segnalare un errore attraverso l'apposito menu Aiuto. Questo processo richiede la semplice compilazione di due campi di editazione. Per chi vuole segnalare via Web oltre al sistema di segnalazione integrato a TW Blue, è disponibile una pagina dedicata.
Tutte le cose del mondo (sí sì, inclusi i software) son molto lontani dalla perfezione, è facile incontrare quindi imprevisti che causano errori. La buona intezione è sempre quella di migliorare, sentiti libero (o meglio, sarebbe ottimo se lo facessi) di riportare eventuali errori che incontri nel programma in modo da poterli correggere.
Per entrare nella pagina riservata alla segnalazione errori, vai a [questo link.](http://twblue.com.mx/errores/bug_report_page.php)
La pagina è in spagnolo e contiene un form da compilare. I campi contrassegnati da un * (asterisco) sono obbligatori, più campi vengono compilati meglio si può valutare l'errore.
Grazie per la partecipazione riportando errori e provando le nuove funzioni di TW Blue.
## Contatti: {#contacto}
Se ciò che viene presentato in questo documento non è sufficiente, se vuoi collaborare in altri modi, o se volete semplicemente tenervi in contatto con chi sviluppa questa applicazione segui [@tw_blue2](https://twitter.com/tw_blue2) oppure [@manuelcortez00.](https://twitter.com/manuelcortez00) Potete anche visitare il nostro [sito Web.](http://twblue.com.mx)
---
Copyright © 2013-2014. Manuel Cortéz.

BIN
doc/locales/pl/lc_messages/twblue-documentation.mo Normal file
View File

Binary file not shown.

1266
doc/locales/pl/lc_messages/twblue-documentation.po Normal file
View File

File diff suppressed because it is too large Load Diff

BIN
doc/locales/pt/lc_messages/twblue-documentation.mo Normal file
View File

Binary file not shown.

1271
doc/locales/pt/lc_messages/twblue-documentation.po Normal file
View File

File diff suppressed because it is too large Load Diff

285
doc/locales/pt/manual.md Normal file
View File

@ -0,0 +1,285 @@
% Documentação do TW Blue 0.42
# Versão 0.42 (alpha)
# ¡Perigro!
Você está lendo um documento gerado para uma aplicação em fase de desenvolvimento. A intenção deste manual é esclarecer alguns detalhes sobre o funcionamento do programa. Note-se que sendo desenvolvido ativamente, o software pode mudar um pouco em relação a esta documentação num futuro próximo. Por isso é aconselhável dar uma olhada de vez em quando para não se perder muito.
Si quieres ver lo que ha cambiado con respecto a la versión anterior, [lee la lista de novedades aquí.](changes.html)
# TW Blue
TW Blue é um aplicativo para utilizar o Twitter de forma simples e rápida, além de evitar tanto quanto possível consumir demasiados recursos do computador. Com ele é possível realizar ações do Twitter, tais como:
* Crear, responder, reenviar y eliminar Tuits,
* Marcar como favorito, eliminar de tus favoritos un tuit,
* Enviar y eliminar mensajes directos,
* Ver tus amigos y seguidores,
* Seguir, dejar de seguir, reportar como spam y bloquear a un usuario,
* Abrir una línea temporal para un usuario, lo que permite obtener todos los Tuits de ese usuario únicamente,
* Abrir direcciones URL cuando vayan en un tuit o mensaje directo,
* Reproducir varios tipos de archivos o direcciones que contengan audio.
* Y más.
# Tabla de contenidos
Para poder utilizar una aplicación como TW Blue que te permita gestionar una cuenta de Twitter, primero tienes que estar registrado en esta red social. Esta documentación no tiene como objetivo explicar el procedimiento para hacerlo. Partiremos desde el punto que tienes una cuenta con su respectivo nombre de usuario y contraseña. La documentación cubrirá estas secciones.
* [Autorizar la aplicación](#autorizar)
* [La interfaz del programa](#interfaz)
* [Controles](#controles)
* [La interfaz gráfica (GUI)](#gui)
* [Botones de la aplicación](#botones)
* [Menús](#menus)
* [Menú aplicación](#app)
* [Menú Tuit](#tuit)
* [Menú Usuario](#usuario)
* [Menú buffer](#buffer)
* [Menú ayuda](#ayuda)
* [La interfaz No Visible](#interfaz_no_visible)
* [Atajos de Teclado para la Interfaz Gráfica](#atajos)
* [Atajos de Teclado para la Interfaz no Visible](#atajos_invisibles)
* [Listas](#listas)
* [Reportando Errores desde la web](#reportar)
* [Contacto](#contacto)
## Autorizando la aplicación {#autorizar}
Antes de nada, lo primero que se necesita es autorizar al programa para que este pueda acceder a tu cuenta de Twitter, y desde ella realizar lo que le pidas. El proceso de autorización es bastante sencillo, y en ningún momento el programa podrá tener acceso a tus datos como usuario y contraseña. Para autorizar la aplicación, solo tienes que abrir el archivo principal del programa, llamado TW Blue.exe (en algunos PC, solo se muestra como TW Blue).
Al hacerlo, si no has configurado ninguna vez el programa, se mostrará un cuadro de diálogo donde te informa que serás llevado a Twitter para autorizar la aplicación una vez pulses sobre "aceptar". Para empezar con el proceso de autorización presiona sobre el único botón de ese diálogo.
A continuación, tu navegador predeterminado se abrirá con la página de Twitter solicitándote autorizar la aplicación. Escribe, si no estás autenticado ya, tu nombre de usuario y contraseña, luego busca el botón autorizar, y presiónalo.
De la página a la que serás redirigido (si el proceso ha tenido éxito), busca las instrucciones que te proporciona Twitter. En resumen, te dará un código numérico de varios dígitos que deberás pegar en un cuadro de texto que la aplicación ha abierto en otra ventana.
Pega el código de verificación, y pulsa la tecla Intro.
Si todo ha salido bien, la aplicación empezará a reproducir un grupo de sonidos en señal que se están actualizando tus datos.
Cuando termine, el programa reproducirá otro sonido, y el lector de pantalla dirá "listo".
## La interfaz del programa {#interfaz}
La forma más simple de describir la interfaz gráfica de la aplicación es la de una ventana con una barra de menú con cinco menús (aplicación, tuit, usuario, buffer y ayuda); una lista de varios elementos y en la mayoría de los casos tres botones. Tuit, retuit y responder. Las acciones para cada uno de estos elementos serán descritas más adelante.
Los elementos que hay en las listas pueden ser Tuits, mensajes directos o usuarios. TW Blue crea diferentes pestañas para cada lista, pues estos elementos pueden ser Tuits enviados, Tuits recividos en la línea principal, favoritos, o mensajes directos, y cada pestaña tiene un solo tipo de Tuit. Estas pestañas se llaman listas o buffers.
Para cambiar entre las listas se hace presionando Control+Tab si se desea avanzar, y Control+Shift+Tab para retroceder. En todo momento los lectores de pantalla anunciarán la lista hacia la que se cambie el foco de la aplicación. Aquí están las listas básicas de TW Blue, que aparecen si se usa la configuración por defecto.
* Principal: Aquí van todos los Tuits que se muestran en la línea principal. Estos son los Tuits de los usuarios a los que sigues.
* Menciones: Si un usuario (lo sigas o no) te menciona en Twitter, lo verás en esta lista.
* Mensajes directos: Aquí están los mensajes directos (privados) que intercambias con los usuarios que sigues y te siguen. Esta lista solo muestra los mensajes recividos.
* Enviados: En esta lista se muestran todos los Tuits y mensajes directos que se han enviado desde tu cuenta.
* Favoritos: Aquí verás los Tuits que has marcado como favoritos.
* Seguidores: Cuando los usuarios sigan tu cuenta, podrás verlos en esta lista, junto con un poco de información de la cuenta.
* Amigos: Igual que la lista anterior, pero estos usuarios son a los que tú sigues.
* Eventos: Un evento en TW Blue es "algo" que pase en Twitter. En la línea de eventos, podrás ver registrados los eventos más comunes (p. Ej. Te han comenzado a seguir, han marcado o removido un tweet tuyo de los favoritos, te has suscrito a una lista). Son como pequeñas notificaciones que envía Twitter y TW Blue organiza para que no te pierdas lo que ha pasado con tu cuenta.
* Línea temporal de un usuario: Estas son listas que tú deberás crear. Es una lista que contiene únicamente los Tuits de un usuario. Se usan si algún día necesitas o quieres ver los Tuits que ha realizado solo una persona y no deseas buscar por todo tu timeline. Puedes crear tantas como usuarios necesites.
* Lista: Una lista es parecida a una línea temporal, pero compuesta por los tweets de cada usuario que forme parte de ella. De momento las listas son una característica experimental de TW Blue. Si experimentas problemas con ellas, por favor escríbenos para contárnoslo.
* Búsqueda: Un buffer de búsqueda contiene los resultados de una búsqueda hecha en TW Blue. Las búsquedas pueden ser por tuits, en cuyo caso buscas un término en los tuits relevantes de Twitter, o por usuarios, donde los resultados son nombres de usuario de Twitter.
* Favoritos de un usuario: Es posible pedirle a TW Blue que te muestre los tuits que un usuario ha marcado como favoritos.
Nota: Únicamente para esta versión de TW Blue, los amigos y seguidores actualizarán hasta 400, o cerca a los 400. En la próxima versión proporcionaremos un método para ver los amigos y seguidores sin exponerse tanto a los errores causados por el uso de la API de Twitter, muy frecuente entre personas con más de 600 amigos o seguidores.
Ten en cuenta que por defecto la configuración solo permite obtener los 200 últimos Tuits para las listas principal, menciones, mensajes directos y líneas temporales. Esto puedes cambiarlo desde el diálogo de configuración. Para los enviados se obtendrán los últimos 200 Tuits y 200 mensajes directos. En versiones futuras se permitirá ajustar este parámetro.
Si hay una dirección URL en algún tuit, TW Blue intentará abrirla cuando presiones Intro sobre ella. Si hay más de una, te mostrará una lista con todas para que selecciones la que quieras abrir. Si estás en el cuadro de diálogo de los amigos o seguidores, la tecla intro te mostrará detalles del mismo.
Si pulsas Control+Intro, TW Blue intentará reproducir el audio que tenga el tuit sobre el que está el foco del sistema, siempre que tenga una URL. Si el tuit lleva la etiqueta #audio, un sonido al pasar por él te alertará que es un audio y puedes intentar reproducirlo. No obstante, también puede que no esté etiquetado y que TW Blue pueda reproducirlo, siempre que lleve a una dirección URL donde exista audio.
## Controles {#controles}
A partir de la versión 0.36, existe soporte para una interfaz que no requiere de una ventana visible. Esta puede ser activada pulsando Control+m, o seleccionando desde el menú aplicación la opción "Esconder ventana". Esta interfaz se maneja completamente con atajos de teclado. Estos atajos son diferentes a los que se utilizan para la interfaz gráfica. Cada una de ellas podrá utilizar solo los atajos que le correspondan, lo que quiere decir que no se permitirá utilizar los atajos de la interfaz no visible si se tiene activada la interfaz gráfica. En esta sección se detallará tanto la interfaz gráfica como la no visible.
### Interfaz gráfica (GUI) {#gui}
Aquí una lista dividida en dos partes. Por un lado, los botones que encontrarás si presionas Tab o Shift+Tab en la interfaz del programa, y por otro, los diferentes elementos que hay en la barra de menú.
#### Botones de la aplicación {#botones}
* Twit: Este botón abre el diálogo para escribir un tuit. El mensaje solo debe tener 140 caracteres. Al escribir el caracter número 141, un sonido será reproducido para indicarte que te has pasado del límite permitido por Twitter. Puedes querer acortar o desacortar una URL si la incluye tu tuit a fin de ganar más espacio donde escribir, para eso están los botones con esos nombres. Pulsa Intro para enviar el tuit. Si todo sale bien, el mensaje se enviará y tú escucharás un sonido que te lo confirme, si no, el lector de pantalla te responderá con un error en inglés, que indica por qué no se ha podido enviar el mensaje.
* Retuit: Este botón se encarga de reenviar el tuit sobre el que estás leyendo. Al presionarlo se te preguntará si deseas añadirle un comentario al tuit original (citándolo) o simplemente enviarlo como se ha escrito sin añadir nada más.
* Responder: Cuando estés visualizando un Tuit, puedes responderle al usuario que lo escribió pulsando sobre este botón. Se abrirá el mismo diálogo de Tuit, pero con el nombre del usuario (por ejemplo @usuario) en el, para que solo escribas el mensaje que quieres responderle. Si en el tuit hay más de un usuario mencionado, pulsa Shift+Tab y pulsa el botón "Mencionar a todos los usuarios". Cuando estés en la lista de amigos o seguidores, este botón se llamará mencionar.
* mensaje directo: Exactamente igual que enviar un Tuit, pero es un mensaje privado que solo podrá ver el usuario al que se lo envías. Pulsa Shift+Tab para ver el destinatario de tu mensaje. Si en el Tuit donde estabas para enviar el mensaje había más de un usuario mencionado, puedes navegar con las flechas de arriba y abajo para seleccionar otro, o escribir tú mismo el usuario (sin el signo de arroba).
Ten en cuenta que los botones aparecerán según las acciones que se puedan hacer en la lista donde estés. Por ejemplo, en la línea principal, menciones, enviados, favoritos y las líneas temporales de los usuarios podrás ver los cuatro botones; mientras que en la lista de mensajes directos solo estará disponible el botón de "Mensaje Directo" y "tuit", y en las listas de amigos y seguidores, se verá el botón para "Twit" y el de "Mensaje directo" junto a "mencionar".
#### Menús {#menus}
En la parte superior de la ventana del programa podrás encontrar una barra de menú que hace las mismas cosas, y algunas cuantas más. A la barra de menú se accede presionando la tecla ALT, y cuenta en este momento con cuatro menús para diferentes acciones: Aplicación, Tuit, usuario y Ayuda. En esta sección se describen las acciones para cada uno de ellos.
##### Menú aplicación {#app}
* Actualizar Perfil: Abre un diálogo desde donde se podrá actualizar parte de tu información en Twitter. Nombre, ubicación, dirección URL y descripción. Si ya tienes alguno de estos campos actualmente en el perfil se llenarán automáticamente con lo que tiene tu configuración de Twitter. También podrás subir una foto a tu perfil.
* Esconder Ventana: Desactiva la interfaz gráfica. Lee el apartado sobre la interfaz no visible para más detalles sobre este comportamiento.
* Búsqueda: Muestra un cuadro de diálogo desde donde puedes buscar por tuits o por usuarios en twitter.
* Gestor de listas: Para poder utilizar las listas de Twitter, primero necesitarás crearlas. Este diálogo permite ver tus listas, editarlas, crearlas, borrarlas y, opcionalmente, verlas en buffers tal como lo harías con las líneas temporales.
* Tutorial de sonidos: Abre un diálogo donde verás una lista de los sonidos de TW blue, para que puedas aprenderlos y no te cueste trabajo familiarizarte con TW Blue.
* Preferencias: Abre un diálogo de configuración desde donde se pueden controlar algunos aspectos del programa. Las opciones no necesitan de explicación.
* Salir: pregunta si quieres salir o no del programa. Si la respuesta es que sí, cierra la aplicación.
##### Menú Tuit {#tuit}
* Las primeras opciones del menú son Twit, responder y retuit, que corresponden a los botones del mismo nombre.
* Marcar como favorito: Marca el tuit que estés viendo como favorito.
* Quitar tuit de favoritos: Elimina el tuit de tus favoritos. Esto no significa que se borra de Twitter, solo deja de estar en tu lista de favoritos.
* Ver Tuit: Abre un diálogo donde puedes ver el Tuit, mensaje directo, amigo o seguidor sobre el que esté el foco de la aplicación. Puedes leer el texto con los cursores. El diálogo es el mismo que el que se usa para escribir un Tuit.
* Eliminar: Elimina el Tuit o mensaje directo sobre el que estés, borrándolo definitivamente de Twitter y qitándolo de tus listas. Ten en cuenta que en el caso de los Tuits, Twitter solo permite borrar los que tú mismo has escrito.
##### Menú usuario {#usuario}
Ten en cuenta que las primeras seis opciones de este menú abren un mismo diálogo. Este diálogo tiene un cuadro de edición donde puedes seleccionar el usuario sobre el que deseas actuar, bien con los cursores arriba y abajo o escribiendo tú mismo el nombre. Después, hay un grupo de botones de radio para seguir, dejar de seguir, silenciar, des-silenciar, reportar como Spam y bloquear. Si seleccionas desde el menú la opción seguir, el botón del cuadro de diálogo estará marcado con esa opción, así como sucederá respectivamente con dejar de seguir, reportar como Spam y bloquear. Pulsa el botón Aceptar para que el programa trate de hacer lo que le pides. Si no se ha podido, escucharás el error en inglés.
A continuación se describen las opciones restantes para este menú:
* Mensaje Directo: La misma acción que el botón.
* Añadir a lista: Para que puedas ver los tweets de un usuario en tus listas, primero hay que añadirlo. Esta opción abrirá un diálogo desde donde puedes seleccionar al usuario que deseas añadir, para después abrir otra ventana donde puedes seleccionar la lista a la cual añadir a ese usuario. Una vez hecho esto, la lista contendrá un nuevo usuario y podrás ver sus tweets.
* Ver Perfil del usuario: Abre un diálogo desde donde te permite seleccionar el usuario al que quieres ver el perfil.
* Línea temporal: Abre un diálogo desde donde puedes seleccionar el usuario para el que se creará la línea temporal. Al presionar intro, se creará. Si se hace una línea temporal de un usuario que no tenga Tuits, el programa fallará. Si se crea una línea que ya existe el programa te avisará y no permitirá crearla de nuevo.
* Ver favoritos: Abre un buffer para seguir los favoritos que marca el usuario seleccionado.
##### Menú Buffer {#buffer}
* Silenciar: Silencia completamente el buffer, con lo que no escucharás sonido alguno cuando nuevos elementos aparezcan.
* Leer automáticamente tuits para este buffer: Esta opción activa o desactiva la lectura automática de tuits. Si está activada, el lector de pantalla o la voz Sapi5 (si está activada una) leerá automáticamente los nuevos tuits conforme estos vayan llegando al buffer.
* Limpiar Buffer: Vacía los elementos de este buffer.
* Eliminar buffer: Borra la lista sobre la que te encuentras actualmente.
##### Menú Ayuda {#ayuda}
* Documentación: Abre este archivo, donde puedes leer algunos conceptos interesantes del programa.
* ¿Qué hay de nuevo en esta versión?: Abre un documento con la lista de cambios desde la versión actual, hasta la primera en existencia.
* Buscar actualizaciones: Cada que se abre el programa él mismo busca automáticamente si hay una nueva versión. Si lo hay, te preguntará si quieres descargarla; si aceptas, TW Blue descargará la actualización, la instalará y te pedirá reiniciarla (algo que hace automáticamente). Esta opción comprueba si hay actualizaciones sin tener que reiniciar la aplicación.
* Sitio web de TW Blue. Ve a nuestra [página principal](http://twblue.com.mx) donde podrás encontrar toda la información y descargas relativas a TW Blue, así como participar de la comunidad.
* Reportar un error: Lanza un diálogo desde donde puedes reportar un error solo llenando un par de campos. El título y una pequeña descripción de lo que pasó. Al pulsar en "enviar" el error se reportará. Si no se ha podido el programa te mostrará un mensaje informándolo.
* Sobre TW Blue: Muestra información de créditos del programa.
### Interfaz no visible {#interfaz_no_visible}
Si presionas Control+M, o si desde el menú aplicación seleccionas esconder ventana, estarás activando una interfaz a la que no se podrá acceder por la manera convencional, porque no se ve.
En la interfaz no visible todo lo que hagas será mediante atajos de teclado, incluso para recorrer las listas. Eventualmente se abrirán diálogos y estos sí serán visibles, pero la ventana principal de la aplicación no. Ve a la sección de atajos de teclado de la interfaz no visible para saber cuales puedes usar de momento.
### Atajos de teclado para la Interfaz Gráfica {#atajos}
Además de los botones y menús, la mayoría de las acciones pueden hacerse presionando una combinación de teclado. Aquí están las existentes en este momento:
* Intro: Abrir una dirección URL. Si hay más de una podrás ver una lista que te permitirá seleccionar la que quieras. Si estás en la lista de amigos o seguidores, mostrará detalles del seleccionado.
* Control+Intro: Intenta reproducir un audio si en el Tuit hay una dirección URL.
* F5: Baja un 5% el volumen de los sonidos. Esto afecta a los sonidos que reproduce el programa y al audio que puedas escuchar a través de él.
* F6: Sube un 5% el volumen de los sonidos de la aplicación.
* Control+N: Abre el diálogo para escribir un nuevo Tuit.
* Control+M: Oculta la ventana.
* Control+Q: Sale de la aplicación.
* Control+R: Abre el diálogo para responder.
* Control+Shift+R: Equivalente a la acción Retuit.
* Control+D: Enviar mensaje directo.
* Control+F: Marcar como favorito.
* Control+Shift+F: Quitar de favoritos.
* Control+Shift+V: Ver Tuit.
* Control+S: Seguir a un usuario.
* Control+Shift+S: Dejar de seguir a un usuario.
* Control+K: Bloquear a un usuario.
* Control+Shift+K: Reportar como Spam.
* Control+I: Abrir línea temporal a un usuario.
* Control+Shift+I: Eliminar línea temporal.
* Control+p: Editar tu perfil.
* Suprimir: Eliminar tuit o mensaje directo.
* Shift+suprimir: vacía el buffer, quitando todos los elementos hasta ese entonces. Esto ocurre sin borrar nada de Twitter.
### Atajos de teclado para la Interfaz no Visible {#atajos_invisibles}
Estos son los atajos de teclado que puedes usar desde la interfaz no visible. Ten en cuenta que cuando la vista de la interfaz gráfica esté activada ninguno de ellos podrá usarse. Al decir "windows", nos estamos refiriendo a la tecla de Windows izquierda.
* Control+Windows+Flecha Arriba: Va arriba en la lista actual.
* Control+Windows+Flecha abajo: Va hacia abajo en la lista actual.
* Control+Windows+Izquierda: Se desplaza a la pestaña de la izquierda.
* Control+Windows+Derecha: Se desplaza hacia la pestaña de la derecha.
* Control+Windows+Inicio: Ir al primer elemento de la lista.
* Control+Windows+Fin: Ir al final de la lista.
* Control+Windows+Avance de página: Ir 20 elementos hacia abajo en la lista actual.
* Control+Windows+Retroceso de página: ir 20 elementos hacia arriba en la lista actual.
* Control+Windows+Alt+Flecha Arriba: Subir volumen un 5%.
* Control+Windows+Alt+Flecha Abajo: Bajar volumen un 5%.
* Control+Windows+Intro: Abrir URL en el tuit, o ver detalles del usuario si estás en la lista de amigos o seguidores.
* Control+Windows+Alt+Intro: Intentar reproducir un audio.
* Control+Windows+M: Muestra la interfaz gráfica, desactivando la no visible.
* Control+Windows+N: Hacer un nuevo Tuit.
* Control+Windows+R: Responder a un tuit.
* Control+Windows+Shift+R: Hacer un retuit.
* Control+Windows+D: Enviar un mensaje directo.
* Control+Windows+Suprimir: Eliminar un tuit o mensaje directo.
* control+win+Shift+suprimir: vacía el buffer, quitando todos los elementos hasta ese entonces. Esto ocurre sin borrar nada de Twitter.
* Windows+Alt+F: Marcar como favorito.
* Windows+Alt+Shift+F: Quitar de favoritos.
* Control+Windows+S: Seguir a un usuario.
* Control+Windows+Shift+S: Dejar de seguir a alguien.
* Control+Windows+Alt+N: Ver detalles de un usuario,
* Control+Windows+V: Ver tuit en un cuadro de texto.
* Control+Windows+I: Abrir línea temporal.
* Control+Windows+Shift+I: Eliminar línea temporal de un usuario.
* Alt+Windows+P: Editar tu perfil.
* Control+win+espacio: ver tweet actual.
* Control+win+c: Copiar tweet al portapapeles.
* Control+windows+a: Añadir a un usuario a la lista.
* Control+shift+windows+a: qitar de la lista.
* Control+Windows+Shift+Flecha arriba: Ir un tuit hacia arriba en la conversación.
* Control+Windows+Flecha Abajo: Ir un tuit hacia abajo en la conversación.
* Control+Windows+Shift+M: Activar o desactivar el sonido para el buffer actual.
* Windows+Alt+M: Activar o desactivar el silencio global de TW Blue.
* Control+Windows+E: Activar o desactivar la lectura automática de los tuits en el buffer actual.
* Control+windows+Guion: buscar en Twitter.
* Control+Windows+F4: Cerrar el programa.
## Listas {#listas}
Una de las características más interesantes de Twitter son las listas, ya que son una manera de mantenerse actualizado sin tener que leer los tweets de todos los usuarios a los que sigues. Con una lista de Twitter solo verás los tweets de sus miembros (la gente que está dentro de la lista). Es parecido a una línea temporal, pero para muchos más usuarios.
En TW blue hemos empezado a dar soporte para esta característica. De momento vamos poco a poco, pero ya es posible usar esta función. Te presentamos los pasos que hay que dar para poder tener una lista abierta en TW Blue.
* Primero necesitarás ir al gestor de listas, ubicado bajo el menú aplicación.
* en el gestor de listas podrás ver todas las listas a las que estás unido, empezando por las que tú has creado. Si no ves ninguna lista en este diálogo, significa que no has creado ni te has unido a ninguna lista. Está bien.
* Verás un grupo de botones que se explican por sí solos: Crear nueva lista, editar, eliminar, abrir en buffer (este quizá es el menos claro, se refiere a abrir un nuevo buffer para que TW Blue actualice los tweets de la lista, como cuando pasa con las líneas temporales).
Una vez que hayas creado una nueva lista, no deberías abrirla en buffer. Al menos no de inmediato, porque en este momento no tiene miembro alguno y eso significa que cuando se carguen los tweets para empezar a actualizarla no verás nada. Es recomendable primero añadir a gente a la lista, tal como sigue:
* Cuando hayas cerrado el gestor de listas y estés navegando por entre los tweets de los usuarios, busca el usuario al que quieres añadir a la lista.
* Una vez encontrado, presiona el atajo Ctrl+Win+A o ve al menú usuario y selecciona la opción "Añadir a lista".
* Lo siguiente que verás es un diálogo que te permitirá seleccionar el usuario, asegúrate que el que está como predeterminado es el que deseas, o cámbialo si es necesario, y presiona Aceptar.
* Ahora verás otro diálogo, pero aquí están todas tus listas. Selecciona una (simplemente lleva el cursor hacia ella), y presiona el botón añadir.
* Para qitar a un usuario de una lista repite el mismo proceso, pero presiona Control+Win+Shift+A o selecciona la opción "Quitar de lista", y en el diálogo de las listas presiona sobre el botón "remover".
## Reportando Errores Desde la Web {#reportar}
Nota: Si estás usando el programa también puedes reportar un error desde el mismo, usando para ello la opción del menú ayuda. Este proceso solo te pide llenar dos cuadros de edición, y se encarga del resto. Estos pasos están escritos para quienes no pueden abrir el programa, no lo tienen en uso en este momento o sencillamente quieran reportar desde la web en lugar del sistema integrado de reporte de errores.
Las cosas en este mundo (sí, incluidos los programas informáticos) están muy lejos de ser perfectas, con lo que a menudo te encontrarás con errores no previstos en la aplicación. Pero como la intención es siempre mejorar, eres libre (es más, sería genial que lo hicieras) de reportar los errores que vayas encontrando del programa para que se puedan revisar y eventualmente corregir.
Para entrar a la web de reporte de incidencias, sigue [Este enlace.](http://twblue.com.mx/errores/bug_report_page.php) Es una web con un formulario donde tienes que llenar varios campos. Solo tres de ellos son realmente obligatorios (los que tienen marcado un asterisco), pero entre más campos puedas llenar, será mejor.
Aquí están los diferentes campos del formulario y lo que deberías introducir en cada uno de ellos. Recuerda que son obligatorios solamente los campos marcados con un asterisco (*):
* Categoría: Este cuadro combinado permite seleccionar a qué categoría asignar el error. Puede ser a la categoría General, si es un error del programa, o a documentación, si has encontrado un error en este archivo o en la lista de cambios. Este campo es obligatorio.
* Reproducibilidad: Aquí deberías indicar qué tan fácil o no es de reproducir el error. Las opciones disponibles son Desconocido, No reproducible, No se ha intentado (por defecto), aleatorio, a veces o siempre. Dependiendo de si se puede reproducir el error o no, deberías indicar lo que se parezca más a tu caso. Si estás solicitando una nueva funcionalidad, no importa este cuadro combinado.
* Severidad: Aquí se selecciona que tanto afecta esto al programa. Las opciones disponibles son funcionalidad (selecciona esto para solicitar una nueva funcionalidad), Trivial, Texto, Ajuste, Menor, Mayor, fallo o bloqueo. Nota que las opciones aumentan de nivel. Selecciona lo que más creas. Si no estás seguro de que seleccionar puedes dejarlo como está.
* Prioridad: En este cuadro se selecciona la opción de acuerdo con la importancia del error o funcionalidad solicitada. Las opciones disponibles son Ninguna, baja, normal, alta, hurgente e inmediata.
* Seleccionar Perfil: Aquí puedes escojer entre la configuración de arquitectura (32 o 64 bits), y el sistema operativo (Windows siete de momento). Si no, puedes llenar los tres cuadros de edición que están en la siguiente tabla con tus datos en específico.
* Versión del producto: Selecciona la versión del programa que estás utilizando para poder averiguar donde se ha generado el error. Este cuadro combinado tendrá la lista de las versiones en orden. Si bien no es obligatorio, ayudaría mucho a resolver más rápidamente el error.
* Resumen: Un título para el error, que explique en pocas palabras qué ocurre. Es un cuadro de texto obligatorio.
* Descripción: Este campo también obligatorio, te pide que describas con más detalles qué fue lo que ha ocurrido con el programa.
* Pasos para reproducir: Este campo de texto te sirve si sabes como hacer que la aplicación genere el error. Esto no es obligatorio, pero ayudaría mucho conocer como hacer que el programa tenga este error para rastrearlo mejor.
* Información adicional: Si tienes un comentario o nota que añadir, aquí puede ir. No es obligatorio.
* Subir archivo: Puedes subir aquí el archivo TW Blue.exe.log que se creó con el error que el programa tuvo. No es obligatorio.
* Visibilidad: Selecciona si quieres que el error sea público o privado. Por defecto es público, y es recomendable que así continúe.
* Enviar reporte. Presiona aquí para publicar el error y que este sea atendido.
Muchas gracias por participar reportando errores y probando las funciones nuevas.
## Contacto {#contacto}
Si lo que se expone en este documento no es suficiente, si deseas colaborar de alguna otra forma o si simplemente deseas mantenerte en contacto con quien hace esta aplicación, sigue a la cuenta [@tw_blue2](https://twitter.com/tw_blue2) o a [@manuelcortez00.](https://twitter.com/manuelcortez00) También puedes visitar nuestro [Sitio web](http://twblue.com.mx)
---
Copyright © 2013-2014. Manuel Cortéz.

BIN
doc/locales/ru/lc_messages/twblue-documentation.mo Normal file
View File

Binary file not shown.

1266
doc/locales/ru/lc_messages/twblue-documentation.po Normal file
View File

File diff suppressed because it is too large Load Diff

BIN
doc/locales/tr/lc_messages/twblue-documentation.mo Normal file
View File

Binary file not shown.

1265
doc/locales/tr/lc_messages/twblue-documentation.po Normal file
View File

File diff suppressed because it is too large Load Diff

341
doc/strings.py Normal file
View File

@ -0,0 +1,341 @@
# -*- coding: utf-8 -*-
documentation = []
documentation.append(_(u"""Documentation for TW Blue 0.46"""))
# Translators: This is the new line character, don't change it in the translations.
documentation.append(_(u"""
"""))
documentation.append(_(u"""## Table of contents"""))
documentation.append("""[TOC]""")
#documentation.append(_(u"""# Version 0.46 (alpha)"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""## Warning!"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""You're reading documentation produced for a program still in development. The object of this manual is explaining some details of the operation of the program. Bear in mind that as the software is in the process of active development, parts of this document may change in the near future, so it is advisable to keep an eye on it from time to time to avoid missing too much out."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""If you want to see what has changed from the previous version, [read the list of updates here.](changes.html)"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""## Introduction"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""TW Blue is an application to make Twitter simple and fast, while using as few resources as possible. With it, you can do things like the following:"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""* Tweet, reply, retweet and delete tweets,"""))
documentation.append(_(u"""* Mark and unmark a tweet as a favourite,"""))
documentation.append(_(u"""* Send and delete direct messages,"""))
documentation.append(_(u"""* See your friends and followers,"""))
documentation.append(_(u"""* Follow, unfollow, report as spam and block a user,"""))
documentation.append(_(u"""* Open a user's timeline to see only their tweets,"""))
documentation.append(_(u"""* Open URLs from a tweet or direct message,"""))
documentation.append(_(u"""* Play several types of audio files from addresses,"""))
documentation.append(_(u"""* And more."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""## Usage"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""In order to use an application like TW Blue which allows you to manage your Twitter account, you must first be registered on it. It's beyond the scope of this document to explain how to do so. We'll start from the premise that you have an account with its corresponding user name and password."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""## Authorising the application"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""First off, it's necessary to authorise the program so it can access your Twitter account and act on your behalf. The authorisation process is quite simple, and the program never gets data such as your username and password. In order to authorise the application, you just need to run the main executable file, called TWBlue.exe (on some computers it may appear simply as TWBlue)."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""When executed, if you have not previously configured the program, it will show a dialogue box where it tells you'll be taken to Twitter in order to authorise the application as soon as you press OK. To begin the authorisation process, press the only available button on the box."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""Your default browser will open on the Twitter page to request authorisation. Enter your user name and password if you're not already logged in, look for the authorise button, and press it."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""Read the instructions you will get if the process is successful. In summary, you will be given a numeric code with several digits you must paste on an edit field open by the application on another window."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""Paste the verification code, and press the enter key. """))
documentation.append(_(u"""
"""))
documentation.append(_(u"""If all went well, the application will start playing sounds, indicating your data are being updated."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""When the process is finished,the program will play another sound, and the screen reader will say "ready"."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""## The program's interface {#interface}"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""The easiest way to describe the graphical interface of the application is a window with a menu bar with four menus (application, tweet, user and help), a list with several elements, and, in most cases, three buttons: tweet, retweet and reply. The actions available for each element are described below."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""Elements on the lists may be tweets, direct messages or users. TW Blue creates different tabs for each list, which can be sent tweets, main timeline tweets, favourites, or direct messages, and each tab contains a single type of tweet. These tabs are called lists or buffers."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""To switch from list to list press control-tab to go forward, and control-shift-tab to go back. Screen readers will announce the list that gains the focus at all times. These are the basic lists of TW Blue, which are configured by default."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""* Home: it shows all the tweets on the main timeline. These are the tweets by users you follow."""))
documentation.append(_(u"""* Mentions: if a user, whether you follow them or not, mentions you on Twitter, you will find it on this list."""))
documentation.append(_(u"""* Direct messages: here go the private direct messages you exchange with users you follow and who follow you back. This list only shows received messages."""))
documentation.append(_(u"""* Sent: it shows all the tweets and direct messages sent from your account."""))
documentation.append(_(u"""* Favourites: here you will see all tweets you have favourited."""))
documentation.append(_(u"""* Followers: when users follow you, you'll be able to see them on this list, with some of their account information."""))
documentation.append(_(u"""* Friends: the same as the previous list, but these are the users you follow."""))
documentation.append(_(u"""* User timelines: these are lists you may create. They contain only the tweets by a specific user. They're used so you can see the tweets by a single person and you don't want to look all over your timeline. You may create as many as you like."""))
documentation.append(_(u"""* Events: An event is anything that happens on Twitter, such as when someone follows you, when someone adds or removes one of your tweets from their favorites list, or when you subscribe to a list. There are many more but TW Blue shows the most common ones in the events buffer so that you can easily keep track of what is happening on your account."""))
documentation.append(_(u"""* Lists: A list is similar to a temporary timeline, except that you can configure it to contain tweets from multiple users. This is currently an experimental feature. If you decide to use it, please report any problems you encounter."""))
documentation.append(_(u"""* Search: A search buffer contains the results of a search operation."""))
documentation.append(_(u"""* User favorites: You can have TW Blue create a buffer containing tweets favorited by a particular user."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""Note: In this version of TW Blue, you will be able to see up to (or around) 400 friends and followers in their respective buffers. In the next version, we will provide a solution for those who have more to be able to see them."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""Bear in mind the default configuration only allows getting the last 200 tweets for the home,, mentions, direct messages, and user timeline lists. You can change this on the setup dialogue. For the sent list, the last 200 tweets and the last 200 sent direct messages will be retrieved. Future versions will allow changing this parameter."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""If there's a URL on a tweet TW Blue will try to open it when you press enter on it. If there are several, it will show you a list with all of them so you choose the one you want. If you're on the followers or friends dialogue, the enter key will show you additional information on them."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""If you press control-enter, TW Blue will try to play the audio from the focused tweet, as long as it has a URL. If it has the #audio hashtag, you will hear a sound when it is selected, letting you know you can try to play it. However, a tweet can be missing the hashtag and TW Blue will still be able to play it so long as it contains a URL with audio."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""## Controls {#controls}"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""Beginning with the latest version, there's support for an interface which does not require a visible window. It can be activated by pressing control-m, or choosing hide window from the application menu. This interface is entirely driven through shortcut keys. These shortcuts are different from those used to drive the graphical interface. Each interface can use only its own shortcuts, so you may not use the invisible shortcuts if you have the graphical interface opened. This section describes both the graphical and the invisible interface."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""### The graphical user interface (GUI) {#gui}"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""Here you have a list divided into two parts. On the one hand, the buttons you will find while tabbing around on the program's interface, and on the other, the different elements present on the menu bar."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""#### Buttons on the application {#buttons}"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""* Tweet: this button opens up a dialogue box to write your tweet. The message must not exceed 140 characters. If you write past this limit, a sound will play to warn you. You may use the shorten and expand URL buttons to comply with the character limit. Press enter to send the tweet. If all goes well, you'll hear a sound confirming it. Otherwise, the screen reader will say an error message in English describing the problem."""))
documentation.append(_(u"""* Retweet: this button retweets the message you're reading. After you press it, you'll be asked if you want to add a comment or simply send it as written."""))
documentation.append(_(u"""* Reply: when you're viewing a tweet, you can reply to the user who sent it by pressing this button. A dialogue will open up like the one for tweeting, but with the name of the user already filled in (for example @user) so you only need to write your message. If there are more users mentioned on the tweet, you can press shift-tab and press the mention all users button. When you're on the friends or followers lists, the button will be called mention instead."""))
documentation.append(_(u"""* Direct message: exactly like sending a tweet, but it's a private message which can only be read by the user you send it to. Press shift-tab to see the recipient. If there were other users mentioned on the tweet you were reading, you can arrow up or down to choose which one to send it to, or write the username yourself without the at sign."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""Bear in mind that buttons will appear according to which actions are possible on the list you are browsing. For example, on the home timeline, mentions, sent, favourites and user timelines you will see the four buttons, while on the direct messages list you'll only get the direct message and tweet buttons, and on friends and followers lists you will get the direct message, tweet, and mention buttons."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""#### Menus {#menus}"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""On top of the program window there's a menu bar which has the same functions, and some more. To access the menu bar, press alt. You will find four menus: application, tweet, user and help. This section describes the items on each one of them."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""##### Application menu {#app}"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""* Update profile: opens a dialogue box where you can update your information on Twitter: name, location, URL and bio. If you have already set this up the fields will be prefilled with the existing information. Also, you can upload a photo to your profile."""))
documentation.append(_(u"""* Hide window: turns off the Graphical User Interface. Read the section on the invisible interface for further details."""))
documentation.append(_(u"""* Search: shows a dialog where you can search for tweets or users on Twitter."""))
documentation.append(_(u"""* Lists Manager: This dialog allows you to manage your Twitter lists. In order to use them, you must first create them. Here, you can view, edit, create, delete or, optionally, open them in buffers similar to temporary timelines."""))
documentation.append(_(u"""* Sound tutorial: Opens a dialog where you can familiarize yourself with the different sounds of the program."""))
documentation.append(_(u"""* Preferences: opens up a preference dialogue box from which you can control some of the program settings. The options need no explanation."""))
documentation.append(_(u"""* Quit: asks whether you want to exit the program. If the answer is yes, it shuts the application down."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""##### Tweet menu {#tweet}"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""* You will first find the items to tweet, reply and retweet, which are equivalent to the buttons with the same name."""))
documentation.append(_(u"""* Mark as favourite: marks the tweet you're viewing as a favourite."""))
documentation.append(_(u"""* Remove tweet from favourites: removes the tweet from your favourites, but not from Twitter."""))
documentation.append(_(u"""* Show tweet: opens up a dialogue box where you can read the tweet, direct message, friend or follower under focus. You can read the text with the cursors. It's the same dialogue box used to write tweets on."""))
documentation.append(_(u"""* Delete: permanently removes the tweet or direct message you're on from Twitter and from your lists. Bear in mind that Twitter only allows you to delete tweets you have posted yourself."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""##### User menu {#user}"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""Bear in mind the four topmost items on this menu open up the same dialogue box. This box has an edit field where you can choose the user you want to act on, by using up and down arrows or by writing the text in yourself. Afterwards you will find a group with four radio buttons to follow, unfollow, report as spam and block. If you choose the follow menu item, the radio button on the dialogue box will be set to follow, and the same applies to unfollow, report as spam and block. Press OK to try to carry out the action. If it doesn't succeed, you'll hear the error message in English."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""The remaining items on the menu are described below:"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""* Direct message: same action as the button."""))
documentation.append(_(u"""* Add to List: In order to see someone's tweets in one or more of your lists, you must add them first. This option will open a dialog where you can select the user you wish to add. Next, you will be asked to select the list you wish to add them to. Afterwards, the list will contain a new member and their tweets will show up there."""))
documentation.append(_(u"""* View user profile: opens up a dialogue box to choose the user whose profile you want to browse."""))
documentation.append(_(u"""* Timeline: opens up a dialogue box to choose whose user you want a timeline for. Create it by pressing enter. If you try it with a user that has no tweets, the program will fail. If you try creating an already existing timeline the program will warn you and will not create it again."""))
documentation.append(_(u"""* View favourites: Opens a buffer where you can see what tweets have been favorited by a particular user."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""##### Buffer menu{#buffer}"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""* Mute buffer: Mutes notifications of a particular buffer so you will not hear when new tweets arrive."""))
documentation.append(_(u"""* autoread tweets for this buffer: When enabled, the screen reader or SAPI 5 (if enabled) will read the text of incoming tweets. Please note that this could get rather chatty if there are a lot of incoming tweets."""))
documentation.append(_(u"""* Clear buffer: Deletes all items from the buffer."""))
documentation.append(_(u"""* Remove buffer: dismiss the list you're on."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""##### Help menu {#help}"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""* Documentation: opens up this file, where you can read some useful program concepts."""))
documentation.append(_(u"""* What's new in this version?: opens up a document with the list of changes from the current version down to the first."""))
documentation.append(_(u"""* Check for updates: every time you open the program it automatically checks for new versions. If there are, it will ask you if you want to download it. If you accept, it will do so, after which it will install it and ask you to let it restart itself, which it does automatically. This item checks for new updates without having to restart the application."""))
documentation.append(_(u"""* TW Blue's website: visit our [home page](http://twblue.com.mx) where you can find all relevant information and downloads for TW Blue and become a part of the community."""))
documentation.append(_(u"""* Report a bug: opens up a dialogue box to report a bug by filling a couple of fields: the title and a short description of what happened. Pressing enter will send the report. If the operation doesn't succeed the program will show a warning."""))
documentation.append(_(u"""* About TW Blue: shows the credits of the program."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""### Invisible interface {#invisible_interface}"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""If you press control-m, or if you choose hide window from the application menu, you will activate an interface that cannot be used in the usual way, because it is invisible."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""Every action on the invisible interface is done through keyboard shortcuts, even browsing lists. Eventually you may open dialogue boxes and these will be visible, but not the application's main window. Read the section on invisible interface shortcuts to know which ones you can use for the time being."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""### Keyboard shortcuts for the graphical interface {#shortcuts}"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""Instead of using the buttons and menus, most actions can be carried out by pressing a key combination. The ones available at present are described below:"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""* Enter: open a URL. If there are more than one you will get a list that will allow you to choose the one you want. On the friends or followers lists it will show details on the selected item."""))
documentation.append(_(u"""* Control-enter: attempt to play audio from URL."""))
documentation.append(_(u"""* F5: decrease sounds volume. It affects the program sounds as well as audio played from the program."""))
documentation.append(_(u"""* F6: increase application sounds volume."""))
documentation.append(_(u"""* Control-n: open new tweet dialogue."""))
documentation.append(_(u"""* Control-m: hide window."""))
documentation.append(_(u"""* Control-q: quit."""))
documentation.append(_(u"""* Control-r: open reply tweet dialogue."""))
documentation.append(_(u"""* Control-shift-r: Retweet."""))
documentation.append(_(u"""* Control-d: send direct message."""))
documentation.append(_(u"""* Control-f: mark as favourite."""))
documentation.append(_(u"""* Control-shift-f: remove from favourites."""))
documentation.append(_(u"""* Control-shift-v: view tweet."""))
documentation.append(_(u"""* Control-s: follow a user."""))
documentation.append(_(u"""* Control-shift-s: unfollow a user."""))
documentation.append(_(u"""* Control-k: block a user."""))
documentation.append(_(u"""* Control-shift-k: report as spam."""))
documentation.append(_(u"""* Control-i: open user's timeline."""))
documentation.append(_(u"""* Control-shift-i: remove timeline."""))
documentation.append(_(u"""* Control-p: edit profile."""))
documentation.append(_(u"""* Delete: remove tweet or direct message."""))
documentation.append(_(u"""* Shift-delete: empty the buffer removing all the elements. This doesn't remove them from Twitter itself."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""### Keyboard shortcuts for the invisible interface {#invisible_shortcuts}"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""These are the shortcuts you may use from the invisible interface. Bear in mind that when the graphical user interface is shown you may not use these. By "win" the left windows key is intended."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""* Control+win+up arrow: go up on the current list."""))
documentation.append(_(u"""* Control+win+down arrow: go down on the current list."""))
documentation.append(_(u"""* Control+win+left arrow: go to the previous tab."""))
documentation.append(_(u"""* Control+win+right arrow: go to the next tab."""))
documentation.append(_(u"""* Control+win+home: go to the first element on the list."""))
documentation.append(_(u"""* Control+win+end: go to the last element on the list."""))
documentation.append(_(u"""* Control+win+page down: move 20 elements down on the current list."""))
documentation.append(_(u"""* Control+win+page up: move 20 elements up on the current list."""))
documentation.append(_(u"""* Control+win+alt+up arrow: increase volume by 5%."""))
documentation.append(_(u"""* control+win+alt+down arrow: decrease volume by 5%."""))
documentation.append(_(u"""* Control+win+enter: open URL on the current tweet, or further information for a friend or follower."""))
documentation.append(_(u"""* control+win+alt+enter: attempt to play audio."""))
documentation.append(_(u"""* control+win+m: show the graphical interface, turning the invisible one off."""))
documentation.append(_(u"""* Control+win+n: new tweet."""))
documentation.append(_(u"""* Control+win+r: reply to tweet."""))
documentation.append(_(u"""* Control+win+shift-r: retweet."""))
documentation.append(_(u"""* Control+win+d: send direct message."""))
documentation.append(_(u"""* Control+win+delete: remove a tweet or direct message."""))
documentation.append(_(u"""* Control+win+shift+delete: empty the buffer removing all the elements. This doesn't remove them from Twitter itself."""))
documentation.append(_(u"""* Win+alt+f: mark as favourite."""))
documentation.append(_(u"""* Win+alt+shift+f: remove from favourites."""))
documentation.append(_(u"""* Control+win+s: follow a user."""))
documentation.append(_(u"""* Control+win+shift+s: unfollow a user."""))
documentation.append(_(u"""* Control+win+alt+n: see user details."""))
documentation.append(_(u"""* Control+win+v: show tweet on an edit box."""))
documentation.append(_(u"""* Control+win+i: open user timeline."""))
documentation.append(_(u"""* Control+win+shift+i: remove user timeline."""))
documentation.append(_(u"""* Alt+win+p: edit profile."""))
documentation.append(_(u"""* Control+win+c: Copy to clipboard."""))
documentation.append(_(u"""* Control+win+space: Listen the current message."""))
documentation.append(_(u"""* Control+win+a: Add to list."""))
documentation.append(_(u"""* Control+win+shift+a: Remove from list."""))
documentation.append(_(u"""* Control+Win+Shift+M: Mutes/unmutes the active buffer."""))
documentation.append(_(u"""* Control+Win+E: toggles the automatic reading of incoming tweets in the active buffer."""))
documentation.append(_(u"""* Control+Win+Shift+Up arrow: move up one tweet in the conversation."""))
documentation.append(_(u"""* Control+Win+Shift+Down arrow: move down one tweet in the conversation."""))
documentation.append(_(u"""* Win+Alt+M: Globally mute/unmute TW Blue."""))
documentation.append(_(u"""* control+win+minus: Search on twitter."""))
documentation.append(_(u"""* Control+win+f4: quit."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""## Lists {#lists}"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""One of the most useful features of Twitter is the ability to create lists. Lists allow you to group users whose tweets you wish to see together instead of viewing their individual buffers. A common example of this would be if you follow multiple tech news accounts; it would be more convenient to have, for example, a "Tech News" list in which you can see tweets from these similar accounts together. A temporary buffer, such as what is created when you are viewing an individual person's timeline, is created and you can add/remove people from the list."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""In TW Blue, we have begun working on this feature little by little. It is still experimental but is in working condition. Below, we will explain how to configure lists."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""* First, you will need to open the lists manager which can be found under the application menu."""))
documentation.append(_(u"""* In the lists manager, you will first see the lists you have created followed by those which you are a member. If you see no lists, it means that you have not created any and that you are not a part of any list."""))
documentation.append(_(u"""* You will then see a group of buttons: Create a New List, Edit, Remove and Open in Buffer. Perhaps the last one is a bit less self-explanatory: it will open the list in a buffer similar to when opening someone's timeline. """))
documentation.append(_(u"""
"""))
documentation.append(_(u"""Once you have created a new list, the next step will be to add users to it. If you were to open it in a buffer right now, it would be empty and no tweets would show up in it. To add users, follow these steps:"""))
documentation.append(_(u"""* While browsing your tweets, find a tweet from the user which you wish to add to a list. Next, press ctrl+win+A or select "Add to List" from the User menu."""))
documentation.append(_(u"""* A dialog will then appear asking for the user which you wish to add. The name of the user whose tweet you just selected should already be in the box. Simply confirm that it is correct and press the "OK" button."""))
documentation.append(_(u"""* Another dialog will appear showing all of your lists. Arrow to the one you want and press the "Add" button."""))
documentation.append(_(u"""* To remove a user from a list, repeat the same process but press ctrl+win+shift+A and, from the dialog that appears, choose the list from which you wish to remove the selected user."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""## Reporting bugs from the web {#reporting}"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""Note: if you're running the program you can also report a bug from it, by using the help menu item. This process only allows for two edit fields and takes care of the rest. These steps are described for those who can't run the program, don't have it opened at a given moment, or simply want to report from the web instead of using the integrated bug reporting system."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""All things under the sun (yes, this includes computer programs) are very far from being perfect, so often you may find unforeseen bugs in the application. But as our intent is to always improve you're free (what's more, it would be great if you did) to report the bugs you find on the program so they can be reviewed and eventually fixed"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""In order to open the bug tracker's web, [follow this link](http://twblue.com.mx/errores/bug_report_page.php) It's a website with a form where you must fill several fields. Only three of them are really required (those marked with a star), but the more you can fill the better."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""Here are the different form fields and what you must enter on each. Remember only fields mark witha star are required:"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""* Category: this field allows to choose what category to assign the bug to. You can choose general, if it's a program error, or documentation, if you have found a mistake in this manual or the changes list. This is a required field."""))
documentation.append(_(u"""* Reproducibility: here you must indicate how easy or hard it is to reproduce the bug. Available options are unknown, not reproducible, not attempted (by default), random, sometimes, or always. Depending on whether you can reproduce the error or not, you should choose the one closest to your situation. If you're making a feature request, this field is irrelevant."""))
documentation.append(_(u"""* Severity: here you choose how much it affects the program. Available options are functionality (choose this for a feature request), trivial, text, setting, minor, major, failure, or crash. Note the options go in increasing order. Choose the one which fits the situation best. If you're not sure which to choose you can leave it as it is."""))
documentation.append(_(u"""* Priority: choose according to the importance of the bug or feature requested. Available options are none, low, normal, high, urgent, and immediate."""))
documentation.append(_(u"""* Choose profile: here you can choose between 32 or 64 bit architecture and OS (Windows 7 for now). If they don't fit, you can fill the edit fields below with your specific information."""))
documentation.append(_(u"""* Product version: choose the version of the program you're running in order to find out when the error was introduced. This field will contain a sorted list of the available versions. Although it's not required, it would help a lot in quickly finding the bug."""))
documentation.append(_(u"""* Summary: a title for the bug, explaining in a few words what the problem is. It's a required text field."""))
documentation.append(_(u"""* Description: this required field asks you to describe in more detail what happened to the program."""))
documentation.append(_(u"""* Steps to reproduce: this field is used if you know how to cause the error. It's not required, but it would help a lot knowing how the program gets to the error in order to track it down."""))
documentation.append(_(u"""* Additional information: if you have a comment or note to add, it can go here. It's not required."""))
documentation.append(_(u"""* File attachment: you can attach the TW Blue.exe.log generated due to the bug. It is not required."""))
documentation.append(_(u"""* Visibility: choose if you want the bug to be publically visible or private. By default it's public, and it's recommended to keep it that way."""))
documentation.append(_(u"""* Send report: press the button to send the report and have it looked into."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""Many thanks for your participation in reporting bugs and trying out new functionality."""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""## Contact {#contact}"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""If what's explained in this document is not enough, if you want to collaborate in some other way, or if you simply want to get in touch with the application developer, follow the Twitter account [@tw_blue2](https://twitter.com/tw_blue2) or [@manuelcortez00.](https://twitter.com/manuelcortez00) You can also visit [our website](http://twblue.com.mx)"""))
documentation.append(_(u"""
"""))
documentation.append(_(u"""---"""))
documentation.append(_(u"""Copyright © 2013-2014. Manuel Cortéz"""))

339
license.txt Normal file
View File

@ -0,0 +1,339 @@
 GNU GENERAL PUBLIC LICENSE
Version 2, June 1991
Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
Preamble
The licenses for most software are designed to take away your
freedom to share and change it. By contrast, the GNU General Public
License is intended to guarantee your freedom to share and change free
software--to make sure the software is free for all its users. This
General Public License applies to most of the Free Software
Foundation's software and to any other program whose authors commit to
using it. (Some other Free Software Foundation software is covered by
the GNU Lesser General Public License instead.) You can apply it to
your programs, too.
When we speak of free software, we are referring to freedom, not
price. Our General Public Licenses are designed to make sure that you
have the freedom to distribute copies of free software (and charge for
this service if you wish), that you receive source code or can get it
if you want it, that you can change the software or use pieces of it
in new free programs; and that you know you can do these things.
To protect your rights, we need to make restrictions that forbid
anyone to deny you these rights or to ask you to surrender the rights.
These restrictions translate to certain responsibilities for you if you
distribute copies of the software, or if you modify it.
For example, if you distribute copies of such a program, whether
gratis or for a fee, you must give the recipients all the rights that
you have. You must make sure that they, too, receive or can get the
source code. And you must show them these terms so they know their
rights.
We protect your rights with two steps: (1) copyright the software, and
(2) offer you this license which gives you legal permission to copy,
distribute and/or modify the software.
Also, for each author's protection and ours, we want to make certain
that everyone understands that there is no warranty for this free
software. If the software is modified by someone else and passed on, we
want its recipients to know that what they have is not the original, so
that any problems introduced by others will not reflect on the original
authors' reputations.
Finally, any free program is threatened constantly by software
patents. We wish to avoid the danger that redistributors of a free
program will individually obtain patent licenses, in effect making the
program proprietary. To prevent this, we have made it clear that any
patent must be licensed for everyone's free use or not licensed at all.
The precise terms and conditions for copying, distribution and
modification follow.
GNU GENERAL PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. This License applies to any program or other work which contains
a notice placed by the copyright holder saying it may be distributed
under the terms of this General Public License. The "Program", below,
refers to any such program or work, and a "work based on the Program"
means either the Program or any derivative work under copyright law:
that is to say, a work containing the Program or a portion of it,
either verbatim or with modifications and/or translated into another
language. (Hereinafter, translation is included without limitation in
the term "modification".) Each licensee is addressed as "you".
Activities other than copying, distribution and modification are not
covered by this License; they are outside its scope. The act of
running the Program is not restricted, and the output from the Program
is covered only if its contents constitute a work based on the
Program (independent of having been made by running the Program).
Whether that is true depends on what the Program does.
1. You may copy and distribute verbatim copies of the Program's
source code as you receive it, in any medium, provided that you
conspicuously and appropriately publish on each copy an appropriate
copyright notice and disclaimer of warranty; keep intact all the
notices that refer to this License and to the absence of any warranty;
and give any other recipients of the Program a copy of this License
along with the Program.
You may charge a fee for the physical act of transferring a copy, and
you may at your option offer warranty protection in exchange for a fee.
2. You may modify your copy or copies of the Program or any portion
of it, thus forming a work based on the Program, and copy and
distribute such modifications or work under the terms of Section 1
above, provided that you also meet all of these conditions:
a) You must cause the modified files to carry prominent notices
stating that you changed the files and the date of any change.
b) You must cause any work that you distribute or publish, that in
whole or in part contains or is derived from the Program or any
part thereof, to be licensed as a whole at no charge to all third
parties under the terms of this License.
c) If the modified program normally reads commands interactively
when run, you must cause it, when started running for such
interactive use in the most ordinary way, to print or display an
announcement including an appropriate copyright notice and a
notice that there is no warranty (or else, saying that you provide
a warranty) and that users may redistribute the program under
these conditions, and telling the user how to view a copy of this
License. (Exception: if the Program itself is interactive but
does not normally print such an announcement, your work based on
the Program is not required to print an announcement.)
These requirements apply to the modified work as a whole. If
identifiable sections of that work are not derived from the Program,
and can be reasonably considered independent and separate works in
themselves, then this License, and its terms, do not apply to those
sections when you distribute them as separate works. But when you
distribute the same sections as part of a whole which is a work based
on the Program, the distribution of the whole must be on the terms of
this License, whose permissions for other licensees extend to the
entire whole, and thus to each and every part regardless of who wrote it.
Thus, it is not the intent of this section to claim rights or contest
your rights to work written entirely by you; rather, the intent is to
exercise the right to control the distribution of derivative or
collective works based on the Program.
In addition, mere aggregation of another work not based on the Program
with the Program (or with a work based on the Program) on a volume of
a storage or distribution medium does not bring the other work under
the scope of this License.
3. You may copy and distribute the Program (or a work based on it,
under Section 2) in object code or executable form under the terms of
Sections 1 and 2 above provided that you also do one of the following:
a) Accompany it with the complete corresponding machine-readable
source code, which must be distributed under the terms of Sections
1 and 2 above on a medium customarily used for software interchange; or,
b) Accompany it with a written offer, valid for at least three
years, to give any third party, for a charge no more than your
cost of physically performing source distribution, a complete
machine-readable copy of the corresponding source code, to be
distributed under the terms of Sections 1 and 2 above on a medium
customarily used for software interchange; or,
c) Accompany it with the information you received as to the offer
to distribute corresponding source code. (This alternative is
allowed only for noncommercial distribution and only if you
received the program in object code or executable form with such
an offer, in accord with Subsection b above.)
The source code for a work means the preferred form of the work for
making modifications to it. For an executable work, complete source
code means all the source code for all modules it contains, plus any
associated interface definition files, plus the scripts used to
control compilation and installation of the executable. However, as a
special exception, the source code distributed need not include
anything that is normally distributed (in either source or binary
form) with the major components (compiler, kernel, and so on) of the
operating system on which the executable runs, unless that component
itself accompanies the executable.
If distribution of executable or object code is made by offering
access to copy from a designated place, then offering equivalent
access to copy the source code from the same place counts as
distribution of the source code, even though third parties are not
compelled to copy the source along with the object code.
4. You may not copy, modify, sublicense, or distribute the Program
except as expressly provided under this License. Any attempt
otherwise to copy, modify, sublicense or distribute the Program is
void, and will automatically terminate your rights under this License.
However, parties who have received copies, or rights, from you under
this License will not have their licenses terminated so long as such
parties remain in full compliance.
5. You are not required to accept this License, since you have not
signed it. However, nothing else grants you permission to modify or
distribute the Program or its derivative works. These actions are
prohibited by law if you do not accept this License. Therefore, by
modifying or distributing the Program (or any work based on the
Program), you indicate your acceptance of this License to do so, and
all its terms and conditions for copying, distributing or modifying
the Program or works based on it.
6. Each time you redistribute the Program (or any work based on the
Program), the recipient automatically receives a license from the
original licensor to copy, distribute or modify the Program subject to
these terms and conditions. You may not impose any further
restrictions on the recipients' exercise of the rights granted herein.
You are not responsible for enforcing compliance by third parties to
this License.
7. If, as a consequence of a court judgment or allegation of patent
infringement or for any other reason (not limited to patent issues),
conditions are imposed on you (whether by court order, agreement or
otherwise) that contradict the conditions of this License, they do not
excuse you from the conditions of this License. If you cannot
distribute so as to satisfy simultaneously your obligations under this
License and any other pertinent obligations, then as a consequence you
may not distribute the Program at all. For example, if a patent
license would not permit royalty-free redistribution of the Program by
all those who receive copies directly or indirectly through you, then
the only way you could satisfy both it and this License would be to
refrain entirely from distribution of the Program.
If any portion of this section is held invalid or unenforceable under
any particular circumstance, the balance of the section is intended to
apply and the section as a whole is intended to apply in other
circumstances.
It is not the purpose of this section to induce you to infringe any
patents or other property right claims or to contest validity of any
such claims; this section has the sole purpose of protecting the
integrity of the free software distribution system, which is
implemented by public license practices. Many people have made
generous contributions to the wide range of software distributed
through that system in reliance on consistent application of that
system; it is up to the author/donor to decide if he or she is willing
to distribute software through any other system and a licensee cannot
impose that choice.
This section is intended to make thoroughly clear what is believed to
be a consequence of the rest of this License.
8. If the distribution and/or use of the Program is restricted in
certain countries either by patents or by copyrighted interfaces, the
original copyright holder who places the Program under this License
may add an explicit geographical distribution limitation excluding
those countries, so that distribution is permitted only in or among
countries not thus excluded. In such case, this License incorporates
the limitation as if written in the body of this License.
9. The Free Software Foundation may publish revised and/or new versions
of the General Public License from time to time. Such new versions will
be similar in spirit to the present version, but may differ in detail to
address new problems or concerns.
Each version is given a distinguishing version number. If the Program
specifies a version number of this License which applies to it and "any
later version", you have the option of following the terms and conditions
either of that version or of any later version published by the Free
Software Foundation. If the Program does not specify a version number of
this License, you may choose any version ever published by the Free Software
Foundation.
10. If you wish to incorporate parts of the Program into other free
programs whose distribution conditions are different, write to the author
to ask for permission. For software which is copyrighted by the Free
Software Foundation, write to the Free Software Foundation; we sometimes
make exceptions for this. Our decision will be guided by the two goals
of preserving the free status of all derivatives of our free software and
of promoting the sharing and reuse of software generally.
NO WARRANTY
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
REPAIR OR CORRECTION.
12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.
END OF TERMS AND CONDITIONS
How to Apply These Terms to Your New Programs
If you develop a new program, and you want it to be of the greatest
possible use to the public, the best way to achieve this is to make it
free software which everyone can redistribute and change under these terms.
To do so, attach the following notices to the program. It is safest
to attach them to the start of each source file to most effectively
convey the exclusion of warranty; and each file should have at least
the "copyright" line and a pointer to where the full notice is found.
<one line to give the program's name and a brief idea of what it does.>
Copyright (C) <year> <name of author>
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
Also add information on how to contact you by electronic and paper mail.
If the program is interactive, make it output a short notice like this
when it starts in an interactive mode:
Gnomovision version 69, Copyright (C) year name of author
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
This is free software, and you are welcome to redistribute it
under certain conditions; type `show c' for details.
The hypothetical commands `show w' and `show c' should show the appropriate
parts of the General Public License. Of course, the commands you use may
be called something other than `show w' and `show c'; they could even be
mouse-clicks or menu items--whatever suits your program.
You should also get your employer (if you work as a programmer) or your
school, if any, to sign a "copyright disclaimer" for the program, if
necessary. Here is a sample; alter the names:
Yoyodyne, Inc., hereby disclaims all copyright interest in the program
`Gnomovision' (which makes passes at compilers) written by James Hacker.
<signature of Ty Coon>, 1 April 1989
Ty Coon, President of Vice
This General Public License does not permit incorporating your program into
proprietary programs. If your program is a subroutine library, you may
consider it more useful to permit linking proprietary applications with the
library. If this is what you want to do, use the GNU Lesser General
Public License instead of this License.

2
src/gui/buffers/dm.py
View File

@ -41,7 +41,7 @@ class dmPanel(basePanel):
sound.player.play("error.ogg")
def onResponse(self, ev):
dlg = gui.dialogs.message.dm(_("Direct message to %s") % (self.db.settings[self.name_buffer][self.list.get_selected()]["sender"]["screen_name"]), "", "", self)
dlg = gui.dialogs.message.dm(_("Direct message to %s") % (self.db.settings[self.name_buffer][self.list.get_selected()]["sender"]["screen_name"]), _(u"New direct message"), "", self)
if dlg.ShowModal() == wx.ID_OK:
call_threaded(self.twitter.api_call, call_name="send_direct_message", _sound="dm_sent.ogg", text=dlg.text.GetValue(), screen_name=dlg.cb.GetValue())
if ev != None:

4
src/gui/buffers/people.py
View File

@ -53,7 +53,7 @@ class peoplePanel(basePanel):
self.onResponse(ev)
else:
user = self.db.settings[self.name_buffer][self.list.get_selected()]["screen_name"]
dlg = gui.dialogs.message.dm(_("Direct message to %s") % (user,), "", "", self)
dlg = gui.dialogs.message.dm(_("Direct message to %s") % (user,), _(u"New direct message"), "", self)
if dlg.ShowModal() == wx.ID_OK:
call_threaded(self.twitter.api_call, call_name="send_direct_message", _sound="dm_sent.ogg", text=dlg.text.GetValue(), screen_name=dlg.cb.GetValue())
# dlg.Destroy()
@ -61,7 +61,7 @@ class peoplePanel(basePanel):
self.list.list.SetFocus()
def onResponse(self, ev):
dlg = gui.dialogs.message.reply(_(u"Reply to %s") % (self.db.settings[self.name_buffer][self.list.get_selected()]["screen_name"]), "", u"@%s " % (self.db.settings[self.name_buffer][self.list.get_selected()]["screen_name"]), self)
dlg = gui.dialogs.message.reply(_(u"Mention to %s") % (self.db.settings[self.name_buffer][self.list.get_selected()]["screen_name"]), _(u"Mention"), u"@%s " % (self.db.settings[self.name_buffer][self.list.get_selected()]["screen_name"]), self)
if dlg.ShowModal() == wx.ID_OK:
if dlg.image == None:
call_threaded(self.twitter.api_call, call_name="update_status", _sound="reply_send.ogg", in_reply_to_status_id=dlg.in_reply_to, status=dlg.text.GetValue())