Nueva versión de Docs Authoring Pack para VS Code

Esta publicación fue escrita por Megan Bradley, Gerente senior del programa en el equipo de docs.microsoft.com.

En abril, anunciamos la primera versión del paquete de creación de Docs para VS Code, que incluye la extensión Docs Markdown, una extensión para obtener una vista previa de las ediciones basadas en DocFX, así como markdownlint. Hoy estamos encantados de anunciar la segunda versión principal del Paquete de creación de Docs, que incluye las siguientes extensiones nuevas:

• corrector ortográfico de código. A petición popular, hemos agrupado este corrector ortográfico sin conexión Street Side Software, para que los colaboradores puedan revisar con ortografía todo su contenido, incluidos los ejemplos de código, sin tener que hacerlo a través de un servicio en línea.
• plantillas de artículo de Docs. Esta extensión le permite aplicar una plantilla de Markdown a un nuevo archivo, lo que facilita la creación de contenido y metadatos de forma coherente.
• vista previa de Docs. Reemplazo de la versión preliminar de DocFx incluida en la primera versión del paquete de creación de Docs. La nueva extensión de vista previa es mucho más sólida y representa el docs.microsoft.com CSS en mayor fidelidad.

Puede instalar las extensiones individualmente, a través de los vínculos anteriores o en una sola agrupación, a través de la Docs Authoring Pack.

Presentación de plantillas de artículo

Las plantillas de artículo son archivos de Markdown esqueleto que proporcionan encabezados estándar, metadatos de archivo, texto reutilizable y otros elementos básicos que siguen las directrices de docs.microsoft.com, lo que facilita la contribución a nuevos artículos y elimina las estimaciones de los requisitos de publicación.

Para crear un nuevo archivo basado en una plantilla de salida, simplemente presione Alt+M y seleccione Plantilla:

de plantilla

Versión preliminar mejor

El antiguo motor de vista previa basado en DocFX se reemplazó por el nuevo Docs Preview, que incluye las siguientes mejoras:

• Compatibilidad con el analizador Markdig compatible con CommonMark, en lugar de Markdown con sabor a DocFx (DFM).
• Actualizado docs.microsoft.com CSS, representando elementos Markdown personalizados con mayor fidelidad.
• Se ha mejorado la confiabilidad, lo que hace que las vistas previas se represente más rápido y sin retrasos.
• Compatibilidad con la lista cada vez mayor de extensiones de Markdown específicas de Docs, a medida que están disponibles.

Contribuir

Las extensiones de Docs Markdown son de código abierto, ¡agradecemos las contribuciones!

Tenga en cuenta que la mayoría de las contribuciones requieren que acepte un Contrato de licencia de colaborador (CLA) afirmando que tiene derecho a, y en realidad, concedanos los derechos para usar su contribución en nuestro software y contenido. Para obtener más información, visite https://cla.microsoft.com. Al enviar una solicitud de incorporación de cambios, un bot CLA determinará automáticamente si necesita proporcionar un CLA y decorar la solicitud de incorporación de cambios de forma adecuada (por ejemplo, etiqueta, comentario). Solo tiene que seguir las instrucciones proporcionadas por el bot. Solo tendrá que hacerlo una vez en todos los repositorios propiedad de Microsoft.

Enviar comentarios

¿Has pensado en cómo podemos mejorar las extensiones? Simplemente abrir un nuevo problema!

Y no olvide seguir nuestra cuenta de Twitter de para obtener las actualizaciones más recientes.

¿Sueñas con mejorar el mundo para los desarrolladores? Unirse a nuestro equipo!