Requisitos para submissões de complementos
Para enviar um novo complemento ou uma nova versão de um complemento incluído no site:
- Hospede-o, de preferência no GitHub, o modelo de complemento — add-on template — facilita isso.
- Siga o Processo para adicionar uma nova versão de complemento do NVDA, explicado no guia de submissão de armazenamento de dados de complemento — addon-datastore submission guide —, na seção Submetendo uma versão do complemento.
Para adicionar ou atualizar a página Web do seu complemento:
- Solicite um convite na lista de discussão de traduções. Você precisa fazer isso mesmo que o complemento não precise de traduções neste momento.
- Siga as instruções para baixar o repositório. Você pode acessar — fazer checkout — apenas o website adicionando "/website" ao URL para gerenciar a documentação do complemento.
Na subpasta addons, adicione um arquivo nomeDoRepositórioDoComplemento.mdwn. Certifique-se de que contém um título e tags — identificadores — como dev, stable ou legacy, para que a página web possa ser renderizada nas seções correspondentes do site. Os exemplos a seguir podem ser úteis:
- access8math.mdwn, com tags dev e stable.
- AudioThemes.mdwn, com tag dev.
- teamViewer.mdwn, com tag legacy.
Preste atenção à sintaxe markdown:
- Use asteriscos seguidos de espaço, não hifens, para listas. Hifens são permitidos no Github e no website, mas apenas em inglês. Quando a documentação é convertida para arquivos .po, o uso de hifens não divide a lista nos itens desejados.
- Se os URLs não forem muito longos, use o estilo "referência" para links, ou seja, inclua os URLs correspondentes na parte inferior do arquivo, com uma linha em branco entre URLs e uma linha em branco no final do arquivo.
- Tente usar parágrafos curtos, listas, e títulos de nível 2 ou 3, para uma boa estrutura e documentação compreensível.
- Para listas aninhadas, coloque uma linha em branco antes do primeiro subitem e depois do último, e use quatro espaços para recuar.
Se você deseja gerenciar as traduções do seu complemento através do sistema de tradução do NVDA, solicite-o na lista de discussão de complementos — add-ons mailing list.
https://github.com/nvaccess/addon-datastore/blob/master/docs/submitters/submissionGuide.md