Get best of the week

Documentación en inglés para Angular

La versión rusa de la documentación angular ahora está disponible para todos en el sitio web angular24.ru.

imagen

Esto es el resultado de 6 meses de trabajo, varios intentos fallidos de escribir todos los complementos de comentarios necesarios, un analizador personalizado y una cadena de dos cadenas mágicas, que le permiten traducir archivos Markdown sin perder el formato.

¿Valió la pena sufrir tanto? Si.

En primer lugar , fue posible crear una utilidad extensible para traducir archivos de descuento sin perder el formato, que hasta ahora no se había resuelto con mucho éxito. Para asegurarse de esto, tome el archivo de descuento con código de muestra, tablas y piezas html.

En segundo lugar , ahora será posible traducir la documentación angular a los 103 idiomas que admite Google Translate.

En tercer lugar , fue posible extraer el código de documentación angular en un esquema separado, lo que le permitirá agregar documentación angular a su proyecto (con soporte para búsqueda, trabajadores de servicio y modo fuera de línea).

No podré hablar de todo esto en un artículo, así que ahora descubrirás cómo puedes ayudar y qué artículos te esperan en el futuro.

¿Como puedes ayudar?


La documentación aún no es perfecta, porque fue traducida usando Google Translate, y aquí es donde puede ayudar. ¿Cómo? Hay 2 opciones:

1) Cuando vea una oración no muy bien formulada o errónea, selecciónela: aparecerá un menú emergente entre varias opciones:

imagen

haga clic en "ofrecer traducción" e ingrese la opción de traducción en la ventana que aparece. Se genera automáticamente un problema de Github: lo único que tendrá que hacer es iniciar sesión en Github y hacer clic en Enviar nuevo problema.

Si desea ver el original de esta página, seleccione "Abrir original" y luego la página se abrirá automáticamente en la versión original en inglés. Puede lograr el mismo efecto si cambia "24.ru" a ".io" en la línea del navegador. Además, simplemente reemplazando la barra de direcciones ".io" con "24.ru" en la barra de direcciones, puede cambiar de la versión en inglés de la documentación a la rusa.

2) Si te sientes lo suficientemente seguro con Markdown y Github, puedes:

  • ir directamente al repositorio angular-ru-docs
  • cambiar a brunch angular-v9-final
  • tome cualquier archivo .md del directorio aio / content, corríjalo y haga una solicitud de extracción en el brunch angular-v9-final

Más artículos relacionados


Ahora brevemente sobre qué artículos te esperan en el futuro cercano:

1️⃣ ¿Qué es MagicString y estas líneas son tan mágicas? (hecho)

2️⃣ Double Magic String: utilidad de traducción de microparser y markdown.

3️⃣ Características de Google Translate, matices y hacks. ¿Cómo traducir gratis en un navegador?

4️⃣ Agregue documentación angular a su proyecto, haga del equipo angular el equipo central :)

Espero que esta lista lo haya intrigado :)

Suscríbase a mi canal de Telegram @obenjiro_notes y Twitter obenjiro para no perderse los siguientes artículos sobre el tema y muchas otras cosas interesantes.

More articles:


All Articles