Instalar as ferramentas de criação de conteúdo

  • Artigo

Este artigo descreve como instalar as ferramentas recomendadas necessárias para fazer contribuições eficientes e detalhadas ou grandes para o Microsoft Learn. Exemplos de atualizações importantes incluem:

  • revisões longas de vários artigos
  • Criando um artigo
  • Trabalho para o qual você gostaria de usar as extensões do Visual Studio Code disponíveis, como o Pacote de Criação do Learn.

Importante

Se você estiver fazendo apenas alterações menores em um artigo, não é necessário concluir as etapas deste artigo. Confira Editar no browser para saber como fazer edições rápidas sem instalar nenhuma ferramenta.

Os contribuidores que farão alterações importantes são incentivados a concluir essas etapas. Mesmo que você tenha permissões de gravação no repositório principal, é altamente recomendável (e pré-requisito para seguir este guia) que você crie um fork, clone o repositório e armazene suas alterações propostas no fork.

Neste artigo, você vai:

Instalar as ferramentas de cliente do Git para Windows

Esta instalação inclui o sistema de controle de versão do Git e o Git Bash, o aplicativo de linha de comando que você usa para interagir com o repositório Git local.

  1. Baixe o Git para Windows.

  2. Execute o .EXE (arquivo executável baixado) e siga os prompts para instalar. Selecione Avançar em cada prompt para aceitar todas as configurações padrão.

  3. Selecione um editor de código, quando solicitado. O editor de código padrão é o Vim.

  4. Selecione Concluir para concluir a instalação.

Depois de instalar o Git para Windows, configure o nome do Git e o seu endereço de email.

Instalar as ferramentas de cliente do Git para Mac e Linux

  • O Git para Mac é fornecido como parte das Ferramentas de linha de comando do Xcode. Basta executar git na linha de comando. Você será solicitado a instalar as ferramentas de linha de comando, se necessário. Também é possível baixar o Git para Mac do Software Freedom Conservancy.
  • Git para Linux e Unix

Siga as instruções para o cliente escolhido para instalação e configuração.

Instalar o Visual Studio Code

O Visual Studio Code é um editor leve que funciona no Windows, Linux e Mac. Ele inclui integração com o Git e suporte a extensões.

Baixe e instale o Visual Studio Code em seu sistema operacional.

Aceite todas as configurações padrão durante a instalação.

Dica

Para iniciar o VS Code e abrir a pasta atual, execute o comando code . na linha de comando ou no shell do Bash. Se a pasta atual for parte de um repositório Git local, a integração do GitHub aparecerá no Visual Studio Code automaticamente.

Instalar o Pacote de Criação do Learn

O Pacote de Criação do Learn para o Visual Studio Code inclui assistência básica à criação de Markdown, previews de página, suporte para modelos de Markdown, markdownlint e verificador ortográfico de código. Esses recursos facilitam e simplificam o processo de contribuição. Assim, o Pacote de Criação do Learn é considerado como uma extensão obrigatória para contribuidores.

Para instalar o Pacote de Criação do Learn, escolha Instalar na página do Pacote de Criação do Learn no Marketplace do VS Code.

Para usar a funcionalidade do Pacote de Criação do Learn, pressione Alt+M no Visual Studio Code. Para configurar uma barra de ferramentas para mostrar as funções disponíveis, edite as configurações de Visual Studio Code (Control + vírgula) e adicione a configuração de usuário "markdown.showToolbar": true.

Para saber mais, confira Pacote de Criação do Learn para o Visual Studio Code.

Entender os editores de Markdown

Markdown é uma linguagem de marcação leve usada para criar o conteúdo. O Visual Studio Code é a ferramenta preferida para edição de Markdown na Microsoft. Outras ferramentas de edição de Markdown estão disponíveis. O artigo Referência de Markdown aborda os conceitos básicos de Markdown e os recursos suportados pelo site learn.microsoft.com.

Próximas etapas

Agora você está pronto para Configurar um repositório Git local.