Instalar as ferramentas de criação de conteúdo
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 o Git
- Instalar o Visual Studio Code
- Instalar o Pacote de Criação do Learn
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.
Baixe o Git para Windows.
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.
Selecione um editor de código, quando solicitado. O editor de código padrão é o Vim.
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
gitna 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.