Get best of the week

Documentação em inglês para Angular

A versão em russo da documentação do Angular agora está disponível para todos no site angular24.ru.Este

imagem

é o resultado de 6 meses de trabalho, várias tentativas malsucedidas de escrever todos os plugins de observação necessários, um analisador personalizado e uma cadeia de duas Magic Strings, que permitem converter arquivos Markdown sem perder a formatação.

Valeu a pena sofrer tanto? Sim.

Primeiramente , foi possível criar um utilitário extensível para converter arquivos de remarcação sem perder a formatação, que até agora não havia sido resolvida com muito sucesso. Para garantir isso, pegue o arquivo de remarcação com código de exemplo, tabelas e partes de html.

Em segundo lugar , agora será possível traduzir a documentação do Angular para todos os 103 idiomas suportados pelo Google Tradutor.

Em terceiro lugar , foi possível extrair o código da documentação Angular em um esquema separado, o que permitirá adicionar a documentação Angular ao seu projeto (com suporte para pesquisa, profissionais de serviço e modo offline).

Não poderei falar sobre tudo isso em um artigo. Agora, você descobrirá como pode ajudar e quais artigos esperam por você no futuro.

Como você pode ajudar?


A documentação ainda não está perfeita, porque foi traduzida usando o Google Translate, e é aqui que você pode ajudar. Quão? Existem 2 opções:

1) Quando vir uma frase que não está muito bem formulada ou incorreta, selecione-a - um menu pop-up aparecerá com várias opções:

imagem

Clique em "oferecer tradução" e digite a opção de tradução na janela que aparece. Um problema no Github será gerado automaticamente para você - a única coisa que você precisará fazer é fazer login no Github e clicar em Enviar novo problema.

Se você quiser ver o original desta página, selecione "Abrir original" e a página abrirá automaticamente na versão original em inglês. Você pode obter o mesmo efeito se alterar "24.ru" para ".io" na linha do navegador. Além disso, simplesmente substituindo a barra de endereços “.io” por “24.ru” na barra de endereços, você pode alternar da versão em inglês da documentação para a russa.

2) Se você se sentir confiante o suficiente com o Markdown e o Github, poderá:

  • vá diretamente para o repositório angular-ru-docs
  • mudar para brunch angular-v9-final
  • pegue qualquer arquivo .md do diretório aio / content, corrija-o e faça solicitação pull no brunch angular-v9-final

Mais artigos relacionados


Agora, brevemente, sobre quais artigos estão esperando por você no futuro próximo:

1️⃣ O que é MagicString e essas linhas são tão mágicas? (feito)

2️⃣ Double Magic String - utilitário de tradução microparser e markdown.

3️⃣ Recursos do Google Translate, nuances e hacks. Como traduzir gratuitamente em um navegador?

4️⃣ Adicione a documentação Angular ao seu projeto, faça da equipe Angular a equipe principal :)

Espero que esta lista tenha intrigado você :)

Inscreva-se no canal Telegram @obenjiro_notes e no Twitter obenjiro para não perder os seguintes artigos sobre o assunto e muitas outras coisas interessantes.

More articles:


All Articles