Get best of the week

Documentation en anglais pour Angular

La version russe de la documentation Angular est désormais accessible à tous sur le site angular24.ru.

image

C'est le résultat de 6 mois de travail, de plusieurs tentatives infructueuses pour écrire tous les plugins de remarques nécessaires, un analyseur personnalisé et une chaîne de deux Magic Strings, qui vous permettent de traduire des fichiers Markdown sans perdre la mise en forme.

Cela valait-il la peine de souffrir autant? Oui.

Premièrement , il a été possible de créer un utilitaire extensible pour traduire des fichiers de démarques sans perdre le formatage, ce qui jusqu'à présent n'a pas été résolu avec beaucoup de succès. Pour vous en assurer, prenez le fichier de démarque avec des exemples de code, des tableaux et des morceaux html.

Deuxièmement , il sera désormais possible de traduire la documentation Angular dans les 103 langues prises en charge par Google Translate.

Troisièmement , il a été possible de tirer le code de documentation angulaire dans un schéma séparé, ce qui vous permettra d'ajouter de la documentation angulaire à votre projet (avec prise en charge de la recherche, des techniciens de maintenance et du mode hors ligne).

Je ne pourrai pas parler de tout cela dans un seul article, alors maintenant vous découvrirez comment vous pouvez aider et quels articles vous attendent à l'avenir.

Comment puis-je vous aider?


La documentation n'est pas encore parfaite, car elle a été traduite à l'aide de Google Translate, et c'est là que vous pouvez aider. Comment? Il y a 2 options:

1) Lorsque vous voyez une phrase pas très bien formulée ou erronée, sélectionnez-la - un menu contextuel apparaîtra à partir de plusieurs options:

image

Cliquez sur "offrir la traduction" et entrez l'option de traduction dans la fenêtre qui apparaît. Un problème Github sera automatiquement généré pour vous - la seule chose que vous devrez faire est de vous connecter à Github et de cliquer sur Soumettre un nouveau problème.

Si vous voulez voir l'original de cette page, sélectionnez "Ouvrir l'original" et la page s'ouvrira automatiquement dans la version anglaise originale. Vous pouvez obtenir le même effet si vous changez «24.ru» en «.io» dans la ligne du navigateur. De plus, en remplaçant simplement la barre d'adresse «.io» par «24.ru» dans la barre d'adresse, vous pouvez passer de la version anglaise de la documentation à la version russe.

2) Si vous vous sentez suffisamment en confiance avec Markdown et Github, vous pouvez:

  • aller directement au dépôt angular-ru-docs
  • passer au brunch angular-v9-final
  • prenez n'importe quel fichier .md du répertoire aio / content, corrigez-le et faites une demande de tirage dans le brunch angular-v9-final

Plus d'articles connexes


Maintenant, brièvement sur les articles qui vous attendent dans un proche avenir:

1️⃣ Qu'est-ce que MagicString et ces lignes sont-elles si magiques? (terminé)

2️⃣ Double Magic String - microparser et utilitaire de traduction de démarques.

3️⃣ Caractéristiques de Google Translate, nuances et hacks. Comment traduire gratuitement dans un navigateur?

4️⃣ Ajoutez la documentation Angular à votre projet, faites de l'équipe Angular le noyau :)

J'espère que cette liste vous a intrigué :)

Abonnez-vous à ma chaîne Telegram @obenjiro_notes et Twitter obenjiro afin de ne pas manquer les articles suivants sur le sujet et bien d'autres choses intéressantes.

More articles:


All Articles