Instalación de herramientas de creación de contenido

En este artículo se describe cómo instalar las herramientas recomendadas que necesita para realizar buenas contribuciones de mayor tamaño o con conocimientos más especializados en Microsoft Learn. Entre los ejemplos de actualizaciones principales se incluyen:

• Revisiones largas de varios artículos
• Creación de un nuevo artículo
• Trabajo para el que desea usar las extensiones de Visual Studio Code disponibles, como el paquete de creación de Learn.

Importante

Si solo va a realizar cambios de menor importancia, no necesita realizar los pasos de este artículo. Consulte Edición en el explorador para obtener información sobre cómo realizar modificaciones rápidas sin instalar ninguna herramienta.

Se recomienda a los colaboradores que realizan cambios importantes que completen estos pasos. Aunque disponga de permisos de escritura en el repositorio principal, se recomienda encarecidamente que bifurque y clone el repositorio (y en esta guía se supone que así lo ha hecho) para almacenar los cambios propuestos en la bifurcación.

En este artículo, hará lo siguiente:

• Instalar Git
• Instalar Visual Studio Code
• Instalar el paquete de creación de Learn

Instalación de las herramientas de cliente para Git para Windows

Esta instalación incluye el sistema de control de versiones de Git y Git Bash, la aplicación de línea de comandos que usa para interactuar con el repositorio de Git local.

1. Descargue Git para Windows.

2. Ejecute el archivo ejecutable descargado (.EXE) y siga las indicaciones de instalación. Seleccione Siguiente en cada mensaje para aceptar toda la configuración predeterminada.

3. Seleccione un editor de código cuando se le solicite. El editor de código predeterminado es Vim.

4. Seleccione Finalizar para completar la instalación.

Después de instalar Git para Windows, tendrá que configurar el nombre de Git y la dirección de correo electrónico.

Instalación de las herramientas de cliente para Git para Mac y Linux

• Git para Mac se proporciona como parte de las herramientas de la línea de comandos de Xcode. Simplemente ejecute git desde la línea de comandos. Se le pedirá que instale las herramientas de línea de comandos si es necesario. También puede descargar Git para Mac de Software Freedom Conservancy.
• Git para Linux y Unix

Siga las instrucciones de su cliente elegido para la instalación y configuración.

Instalar Visual Studio Code

Visual Studio Code es un editor ligero que funciona en Windows, Linux y Mac. Incluye integración de Git y compatibilidad con las extensiones.

Descargue e instale Visual Studio Code para su sistema operativo:

• Windows.
• Mac
• Linux

Acepte toda la configuración predeterminada durante la instalación.

Sugerencia

Para ejecutar VS Code y abrir la carpeta actual, ejecute el comando code . en la línea de comandos o el shell de Bash. Si la carpeta actual forma parte de un repositorio de Git local, la integración de GitHub aparece de forma automática en Visual Studio Code.

Instalación del paquete de creación de Learn

La extensión Learn Authoring Pack para Visual Studio Code incluye asistencia de creación de Markdown básica, vistas previas de páginas y compatibilidad con plantillas de Markdown, markdownlint y Code Spell Checker. Estas características facilitan y simplifican el proceso de las contribuciones. Por lo tanto, consideramos que Learn Authoring Pack es una extensión necesaria para los colaboradores.

Para instalar Learn Authoring Pack, elija Instalar en la página de Learn Authoring Pack en el Marketplace de VS Code.

Para usar la funcionalidad del paquete de creación de Learn, presione Alt+M en Visual Studio Code. Para configurar una barra de herramientas en la que se muestren las funciones disponibles, edite la configuración Visual Studio Code (Control+coma) y agregue la configuración de usuario "markdown.showToolbar": true.

Para obtener más información, consulte Learn Authoring Pack para Visual Studio Code.

Descripción de los editores de Markdown

Markdown es un lenguaje de marcado ligero que se usa para crear contenido. Visual Studio Code es la herramienta preferida para la edición de Markdown en Microsoft. Hay otras herramientas de edición de Markdown disponibles. En el artículo Referencia de Markdown se describen los aspectos básicos de Markdown y las características admitidas por el sitio web learn.microsoft.com.

Pasos siguientes

Ahora está listo para la configuración de un repositorio de Git local.