Instalación de herramientas de creación de contenido

  • Artículo
  • 4 minutos para leer

En este artículo se describen los pasos para instalar de forma interactiva herramientas de cliente de Git y Visual Studio Code.

Importante

Si solo va a realizar cambios de menor importancia en un artículo, no necesita realizar todos los pasos del artículo y, por tanto, puede continuar directamente con el flujo de trabajo para cambios rápidos.

Se anima a los colaboradores que se encargarán de los cambios principales a completar estos pasos, lo que permite usar el flujo de trabajo de cambios mayores y de larga duración. 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), de manera que tendrá permisos de lectura y escritura para almacenar los cambios propuestos en la bifurcación.

Instalación de las herramientas de cliente para Git

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.

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

Nota

  1. Download Git for Windows.

  2. Run the downloaded executable (.EXE) file and follow the prompts to install. Select Next at each prompt to accept all default settings.

    Git Setup page for selecting components.

  3. Select Finish to complete the installation.

    Git Setup page for completing setup.

After installing the Git for Windows, you'll have to configure your Git name and your email address, before installing Visual Studio Code.

Advertencia

Git on Windows: Enable long path names. By default, Git for Windows disables support for long filepaths, which prevents any file with a destination path longer than 255 characters from being cloned. Enable long filepaths to avoid this issue by running the following command as an administrator:
git config --global core.longpaths true

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.

En el siguiente artículo, podrá configurar un repositorio de Git local.

Aquí encontrará recursos adicionales de Git: Git terminology (Terminología de Git) | Git basics (Conceptos básicos de Git) | Learning Git and GitHub (Información sobre Git y GitHub)

Instalar Visual Studio Code

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

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 de Visual Studio Code para Windows, Mac y Linux

  • Windows. La página principal de VS Code debería detectar correctamente el sistema operativo.
  • Mac
  • Linux

Instalación de extensiones de Visual Studio Code

To install the extensions:

  1. Start Visual Studio Code.

  2. Select the square Extensions icon on the left nav. The Extensions: Marketplace pane appears.

  3. In the Search Extensions in the Marketplace search box, type the name of an extension you want to find.

    Screenshot showing the extensions icon and pointing to the Search Extensions in Marketplace search bar on VS code.

  4. In the results that appear, locate the extension you want and select Install.

Instalación del paquete de creación de Docs

Importante

The Docs Authoring Pack for Visual Studio Code includes basic Markdown authoring assistance, page previews, support for Markdown templates, markdownlint, and Code Spell Checker. These features ease and streamline the contributions process. As such, we consider the Docs Authoring Pack a required extension for contributors.

To install the Docs Authoring Pack, choose Install from the Docs Authoring Pack page in the VS Code Marketplace.

To use the Docs Authoring Pack functionality, press Alt+M in Visual Studio Code. To configure a toolbar to show the functions available, edit the Visual Studio Code settings (Control+comma), and add user setting "markdown.showToolbar": true.

For more information, see Docs Authoring Pack for 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. Atom es otra herramienta popular para la edición de Markdown. En el artículo Referencia de Markdown se incluyen los aspectos básicos y las características de Markdown compatibles con las extensiones de Markdown personalizadas para Servicios de publicación abierta (OPS).

Pasos siguientes

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