Instalar ferramentas de criação de conteúdo
Este artigo descreve como instalar as ferramentas recomendadas de que você precisa para fazer contribuições eficientes e detalhadas ou grandes para o Microsoft Learn. Exemplos de atualizações importantes incluem:
- Longas revisões de vários artigos
- Criar um novo artigo
- Trabalho para o qual você gostaria de usar as extensões de código do Visual Studio disponíveis, como o Learn Authoring Pack.
Importante
Se você estiver fazendo apenas pequenas alterações, não precisará concluir as etapas neste artigo. Consulte Editar no navegador para saber como fazer edições rápidas sem instalar ferramentas.
Os colaboradores que farão grandes alterações são incentivados a concluir essas etapas. Mesmo que você tenha permissões de gravação no repositório principal, é altamente recomendável (e este guia pressupõe) que você bifurque e clone o repositório e armazene as alterações propostas em sua bifurcação.
Neste artigo, você:
- Instalar o Git
- Instalar o Visual Studio Code
- Instalar o Pacote de Criação do Learn
Instalar ferramentas de cliente 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 seu repositório Git local.
Baixe o Git para Windows.
Execute o ficheiro executável (.EXE) descarregado e siga as instruções 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 seu nome Git e seu endereço de e-mail.
Instale as ferramentas do cliente Git para Mac e Linux
- O Git para Mac é fornecido com as Xcode Command Line Tools (Ferramentas de Linha de Comandos do Xcode). Execute o
gita partir da linha de comandos. Ser-lhe-á pedido para instalar as ferramentas de linha de comandos, caso seja necessário. Também pode transferir o Git para Mac da Software Freedom Conservancy. - Git para Linux e Unix
Siga as instruções para o cliente escolhido para a instalação e a configuração.
Instalar o Visual Studio Code
O Visual Studio Code é um editor leve que funciona em Windows, Linux e Mac. Inclui integração com Git e suporte para extensões.
Baixe e instale o Visual Studio Code para seu sistema operacional:
Durante a instalação, aceite todas as configurações padrão.
Gorjeta
Para iniciar o VS Code e abrir a pasta atual, execute o comando na linha de comando code . ou shell Bash. Se a pasta atual fizer parte de um repositório Git local, a integração do GitHub aparecerá no Visual Studio Code automaticamente.
Instalar o Learn Authoring Pack
O Learn Authoring Pack para Visual Studio Code inclui assistência básica de criação de Markdown, visualizações de página, suporte para modelos Markdown, markdownlint e Corretor Ortográfico de Código. Esses recursos facilitam e agilizam o processo de contribuição. Como tal, consideramos o Learn Authoring Pack uma extensão necessária para os contribuidores.
Para instalar o Learn Authoring Pack, escolha Instalar na página Learn Authoring Pack no VS Code Marketplace.
Para usar a funcionalidade Learn Authoring Pack, pressione Alt+M em Visual Studio Code. Para configurar uma barra de ferramentas para mostrar as funções disponíveis, edite as configurações do Visual Studio Code (Control+comma) e adicione a configuração "markdown.showToolbar": truedo usuário .
Para obter mais informações, consulte Learn Authoring Pack for Visual Studio Code.
Compreender os editores de Markdown
Markdown é uma linguagem de marcação leve usada para criar o conteúdo. O Visual Studio Code é a ferramenta preferencial para editar o Markdown na Microsoft. Outras ferramentas de edição Markdown estão disponíveis. O artigo Markdown Reference aborda os conceitos básicos do Markdown e os recursos suportados learn.microsoft.com pelo site.
Próximos passos
Agora você está pronto para configurar um repositório Git local.