Merge branch 'ruifontes-master'

.gitattributes

@@ -0,0 +1,8 @@
+# Set default behaviour, in case users don't have core.autocrlf set.
+* text=auto
+
+# Try to ensure that po files in the repo does not include
+# source code line numbers.
+# Every person expected to commit po files should change their personal config file as described here:
+# https://mail.gnome.org/archives/kupfer-list/2010-June/msg00002.html
+*.po filter=cleanpo

.gitignore

@@ -0,0 +1,10 @@
+addon/doc/*.css
+addon/doc/en/
+*_docHandler.py
+*.html
+*.ini
+*.mo
+*.pot
+*.py[co]
+*.nvda-addon
+.sconsign.dblite

README.md

@@ -31,4 +31,25 @@ When you are finished configuring the timezones, press the "Save" button.
 
 From here on, you can press NVDA+ALT+T to announce times and dates in your timezone ring.
 
-When you first install the add-on, NVDA will default to your local timezone if it can get it.
+When you first install the add-on, NVDA will default to your local timezone if it can get it.
+
+## Change Log
+
+### Version 1.02, released on 03/18/2020
+- When installing a new version of this add-on, the settings from a previous installation are no longer lost.
+- Other changes to conform to NVDA add-on standard compliance.
+
+### Version 1.01, released on 03/12/2020
+- The time and date are announced in the user's locale, meaning that 24-hour time is honored if set.
+- NVDA will announce either the abbreviated or full timezone depending on the user's setting in the Timezone Ring dialog. For example, it will either say Europe/London, or it will say GMT or BST. This setting is controlled by checking or unchecking the "Announce abbreviated timezones" checkbox.
+- Add-on includes translator comments (@ruifontes.)
+- Add-on now includes header comments (@ruifontes.)
+- The Escape key closes the Timezone Ring Dialog (@ruifontes.)
+- The menu item to open the Timezone Ring dialog is now named appropriately (@ruifontes.)
+- NVDA now defaults to the local timezone on installation of this add-on, if the local timezone is available.
+- Support for multiple timezones through the use of a timezone ring.
+- This add-on now uses the key NVDA+ALT+T to prevent conflict with the Clock add-on.
+- The timezone selector dialog now has a filter box. NVDA will announce the number of results as the user starts typing into the filter field.
+- Python 2 support
+- The date and time is now announced in a separate thread to prevent hanging the NVDA thread in case retrieval takes a little while.
+- The timezone selector dialog now has a cancel button and no longer prevents NVDA from shutting down.

addon/doc/pt_BR/README.md

@@ -0,0 +1,63 @@
+# Anúncio de horas em diferentes fusos horários
+
+## Informações
+* Autor: "Munawar"
+* Descarregar a [versão estável: ][1]
+* Compatibilidade: NVDA versão 2019.2 até 2020.1
+
+## Introdução
+Um extra para o NVDA para anunciar a hora e data em fusos horários seleccionados.
+
+Desde há muito tempo que o Windows permite visualizar relógios para diferentes fusos horários. Quando os utilizadores configuram estes relógios, eles ficam imediatamente visíveis.
+Infelizmente, para utilizadores de leitores de ecrã, como o NVDA] (https://www.nvaccess.org/) ou o [Jaws](http://www.freedomscientific.com), não há uma maneira simples de ler essa informação.
+Os leitores de ecrã não suportam relógios adicionais, pelo que os utilizadores de leitores de ecrã têm de utilizar outras soluções, algumas delas pagas.
+
+Uma parte do trabalho que eu faço implica trabalhar em vários fusos horários, e, eventualmente, canso-me de calcular manualmente os horários na minha cabeça, eespecialmente nos casos em que as diferenças incluem meia-hora, como a Índia, que tem uma diferença de +5:30 em relação ao UTC.
+
+Por isso, criei este extra para o NVDA.
+O extra permite ouvir as horas nos diferentes fusos horários seleccionados através do "Anel de fusos horários".
+
+## Uso
+Após instalar o extra, abra o menu do NVDA, vá para ""Preferências", depois para "Anúncio de horas em diferentes fusos horários", e por fim pressione Enter em "Configurar o anel de fusos horários...".
+
+Será aberta a janela para configurar os fusos horários que quer ouvir.
+Marque os itens na lista de fusos horários para os adicionar ao seu "Anel de fusos horários". Desmarque, ou pressione o botão "Remover" para remover um fuso horário adicionado.
+Também pode reordenar os vários fusos horários no anel com os botões "Mover para cima" ou "Mover para baixo".
+Use o campo "Filtrar" para restringir a pesquisa.
+Marque a caixa de verificação "Anunciar fusos horários abreviados" para ouvir a designação abreviada dos fusos horários, como IST or GMT, ou desmarque para ouvir o nome completo, como "Asia/Kolkata" ou "Europe/London".
+Para terminar a configuração, pressione o botão "Guardar".
+
+Agora, pode pressionar "NVDA+Alt+t" para ouvir a hora e data nos fusos horários configurados no anel.
+
+Quando o extra é instalado, é definido como padrão o seu fuso horário, se possível.
+
+
+## Histórico de versões
+
+### Versão 1.5, lançada em 12/03/2020
+* A hora e data passam a ser anunciadas na configuração regional do utilizador, sendo assim respeitada a configuração de 12 ou 24 horas.
+* O NVDA anunciará o fuso horário abreviadamente, ou não, dependendo da marcação da respectiva caixa de verificação na janela "Configurar o anel de fusos horários". Por exemplo, anunciará "Europe/London," ou "GMT" ou BST.
+* O extra passa a incluir comentários para os tradutores. (@ruifontes.)
+* O extra já inclui no código os cabeçalhos. (@ruifontes.)
+* A tecla "Escape" fecha a janela "Configurar o anel de fusos horários". (@ruifontes.)
+* O item de menu para abrir a janela "Configurar o anel de fusos horários" é nomeado apropriadamente. (@ruifontes.)
+
+### Versão 1.4, lançada em 09/03/2020:
+* O extra passa a assumir como padrão o fuso horário local, se disponível.
+* Suporte para múltiplos fusos horários através do "Anel de fusos horários".
+* O comando passa a ser "NVDA+Alt+t", para não haver conflitos com o extra "Relógio".
+
+### Versão 1.3, lançada em 08/03/2020:
+* O diálogo "Selector de fuso horário" passa a ter um campo para filtrar os resultados, e o NVDA vai anunciando o número de resultados enquanto se escreve.
+
+### Versão 1.2, lançada em 08/03/2020
+* Suporte ao Python 3
+
+### Versão 1.1, Lançada em 08/03/2020
+* O anúncio da hora e data é agora feito numa sequência separada para prevenir problemas no NVDA, caso o processamento demore muito tempo. .
+* O diálogo "Selector de fuso horário" passa a ter um botão "Cancelar" e já não impede o NVDA de fechar.
+
+### Versão 1.0, Lançada em 07/03/2020
+Versão inicial, ainda experimental.
+
+[1] https://github.com/munawarb/NVDA-Time-Zoner/releases/download/v1.5/TimeZoner.nvda-addon

addon/doc/pt_PT/README.md

@@ -0,0 +1,63 @@
+# Anúncio de horas em diferentes fusos horários
+
+## Informações
+* Autor: "Munawar"
+* Descarregar a [versão estável: ][1]
+* Compatibilidade: NVDA versão 2019.2 até 2020.1
+
+## Introdução
+Um extra para o NVDA para anunciar a hora e data em fusos horários seleccionados.
+
+Desde há muito tempo que o Windows permite visualizar relógios para diferentes fusos horários. Quando os utilizadores configuram estes relógios, eles ficam imediatamente visíveis.
+Infelizmente, para utilizadores de leitores de ecrã, como o NVDA] (https://www.nvaccess.org/) ou o [Jaws](http://www.freedomscientific.com), não há uma maneira simples de ler essa informação.
+Os leitores de ecrã não suportam relógios adicionais, pelo que os utilizadores de leitores de ecrã têm de utilizar outras soluções, algumas delas pagas.
+
+Uma parte do trabalho que eu faço implica trabalhar em vários fusos horários, e, eventualmente, canso-me de calcular manualmente os horários na minha cabeça, eespecialmente nos casos em que as diferenças incluem meia-hora, como a Índia, que tem uma diferença de +5:30 em relação ao UTC.
+
+Por isso, criei este extra para o NVDA.
+O extra permite ouvir as horas nos diferentes fusos horários seleccionados através do "Anel de fusos horários".
+
+## Uso
+Após instalar o extra, abra o menu do NVDA, vá para ""Preferências", depois para "Anúncio de horas em diferentes fusos horários", e por fim pressione Enter em "Configurar o anel de fusos horários...".
+
+Será aberta a janela para configurar os fusos horários que quer ouvir.
+Marque os itens na lista de fusos horários para os adicionar ao seu "Anel de fusos horários". Desmarque, ou pressione o botão "Remover" para remover um fuso horário adicionado.
+Também pode reordenar os vários fusos horários no anel com os botões "Mover para cima" ou "Mover para baixo".
+Use o campo "Filtrar" para restringir a pesquisa.
+Marque a caixa de verificação "Anunciar fusos horários abreviados" para ouvir a designação abreviada dos fusos horários, como IST or GMT, ou desmarque para ouvir o nome completo, como "Asia/Kolkata" ou "Europe/London".
+Para terminar a configuração, pressione o botão "Guardar".
+
+Agora, pode pressionar "NVDA+Alt+t" para ouvir a hora e data nos fusos horários configurados no anel.
+
+Quando o extra é instalado, é definido como padrão o seu fuso horário, se possível.
+
+
+## Histórico de versões
+
+### Versão 1.5, lançada em 12/03/2020
+* A hora e data passam a ser anunciadas na configuração regional do utilizador, sendo assim respeitada a configuração de 12 ou 24 horas.
+* O NVDA anunciará o fuso horário abreviadamente, ou não, dependendo da marcação da respectiva caixa de verificação na janela "Configurar o anel de fusos horários". Por exemplo, anunciará "Europe/London," ou "GMT" ou BST.
+* O extra passa a incluir comentários para os tradutores. (@ruifontes.)
+* O extra já inclui no código os cabeçalhos. (@ruifontes.)
+* A tecla "Escape" fecha a janela "Configurar o anel de fusos horários". (@ruifontes.)
+* O item de menu para abrir a janela "Configurar o anel de fusos horários" é nomeado apropriadamente. (@ruifontes.)
+
+### Versão 1.4, lançada em 09/03/2020:
+* O extra passa a assumir como padrão o fuso horário local, se disponível.
+* Suporte para múltiplos fusos horários através do "Anel de fusos horários".
+* O comando passa a ser "NVDA+Alt+t", para não haver conflitos com o extra "Relógio".
+
+### Versão 1.3, lançada em 08/03/2020:
+* O diálogo "Selector de fuso horário" passa a ter um campo para filtrar os resultados, e o NVDA vai anunciando o número de resultados enquanto se escreve.
+
+### Versão 1.2, lançada em 08/03/2020
+* Suporte ao Python 3
+
+### Versão 1.1, Lançada em 08/03/2020
+* O anúncio da hora e data é agora feito numa sequência separada para prevenir problemas no NVDA, caso o processamento demore muito tempo. .
+* O diálogo "Selector de fuso horário" passa a ter um botão "Cancelar" e já não impede o NVDA de fechar.
+
+### Versão 1.0, Lançada em 07/03/2020
+Versão inicial, ainda experimental.
+
+[1] https://github.com/munawarb/NVDA-Time-Zoner/releases/download/v1.5/TimeZoner.nvda-addon