Uma Nova Versão do Pacote de Criação de Documentos para Visual Studio Code
Esta publicação foi escrita por Megan Bradley, Gerente sénior de Programas na equipa de docs.microsoft.com.
Em abril, anunciámos o primeiro lançamento do Pacote de Criação do Docs para VS Code, que inclui a extensão Markdown do Docs, uma extensão para pré-visualizar edições com base no DocFX, bem como markdownlint. Hoje temos o prazer de anunciar o segundo grande lançamento do Pacote de Criação do Docs, que inclui as seguintes novas extensões:
- Verificador ortográfico de código. Por procura popular, agrupámos este verificador ortográfico offline pela Street Side Software, para que os contribuintes possam verificar ortográficos todos os seus conteúdos, incluindo exemplos de código, sem terem de o fazer através de um serviço online.
- Modelos de Artigos do Docs. Esta extensão permite-lhe aplicar um modelo markdown a um novo ficheiro, facilitando a criação de conteúdos e metadados de forma consistente.
- Pré-visualização do Docs. Uma substituição da pré-visualização do DocFx incluída na primeira versão do Pacote de Criação do Docs. A nova extensão de pré-visualização é muito mais robusta e representa o docs.microsoft.com CSS em maior fidelidade.
Pode instalar as extensões individualmente, através das ligações acima ou num único pacote, através do Pacote de Criação do Docs.
Os modelos de artigos são ficheiros Markdown de estrutura que fornecem cabeçalhos padrão, metadados de ficheiros, texto de placa automática e outros elementos básicos que seguem as diretrizes do docs.microsoft.com, facilitando a contribuição de novos artigos e eliminando as estimativas dos requisitos de publicação!
Para criar um novo ficheiro com base num modelo de saída, basta premir Alt+M e selecionar Modelo:
O antigo motor de pré-visualização baseado no DocFX foi substituído pela nova Pré-visualização do Docs, que apresenta os seguintes melhoramentos:
- Suporte para o analisador Markdig compatível com CommonMark, em vez de Markdown com sabor DocFx (DFM).
- Atualizado docs.microsoft.com CSS, compor elementos markdown personalizados com maior fidelidade.
- Maior fiabilidade, tornando as pré-visualizações mais rápidas e sem atrasos.
- Suporte para a lista cada vez maior de extensões markdown específicas do Docs, à medida que estas ficam disponíveis.
As extensões markdown do Docs são open source - agradecemos as contribuições!
Tenha em atenção que a maioria das contribuições exige que concorde com um Contrato de Licença de Contribuidor (CLA) afirmando que tem o direito de, na verdade, conceder-nos os direitos de utilização da sua contribuição no nosso software e conteúdo. Para mais detalhes, visite https://cla.microsoft.com. Quando submete um pedido Pull, um bot do CLA determina automaticamente se tem de fornecer um CLA e decorar o PR de forma adequada (por exemplo, etiqueta, comentário). Só tem de seguir as instruções fornecidas pelo bot. Só terá de o fazer uma vez em todos os repositórios da Microsoft.
Tem ideias sobre como podemos melhorar as extensões? Basta abrir uma nova questão!
E não se esqueça de seguir a nossa conta do Twitter para conhecer as atualizações mais recentes.
Sonha em tornar o mundo melhor para os programadores? Junte-se à nossa equipa!