Compartilhar via

Preenchimento de dev lang

  • Artigo

Nome da extensão

O Pacote de Criação do Learn, Visual Studio Code extensão meta é composto por várias subextensão. Esse recurso está incluído na extensão Markdown do Learn . A extensão Do Learn Markdown faz parte do Pacote de Criação do Learn. Não é necessário instalá-lo separadamente.

Resumo

Os colaboradores precisam de assistência para determinar os identificadores de linguagem de programação válidos (dev langs) que podem seguir os acentos graves triplos (aberturas de isolamento de código) em um arquivo Markdown. A validação de tempo de build de dev langs não existe. O resultado são representações distintas de uma única linguagem de programação dentro do mesmo conjunto de documentos conceitual.

Considere o C# como um exemplo. Os colaboradores usaram c#, C#, cs, csharp e outros como representações de dev lang da linguagem de programação. Qual das representações anteriores está correta?

O recurso Preenchimento de dev lang acaba com a confusão exibindo uma lista de dev langs conhecidos. Ao selecionar um nome de dev lang do IntelliSense:

  • O limite de código é fechado.
  • O cursor é posicionado no limite do código.

Preferências

Não é possível desabilitar esse recurso. As seguintes configurações estão disponíveis:

Exibir os dev langs usados com frequência

Somente um subconjunto dos dev langs válidos será usado em um único conjunto de documentos. Para aprimorar a experiência do usuário:

  1. No Visual Studio Code, abra o conjunto de documentos no diretório raiz.

  2. SelecioneConfigurações de Preferências> de Arquivo> e filtre por Extensão de Markdown do Learn.

  3. Clique no link Editar no settings.json na seção Markdown: idiomas do conjunto de documentos.

  4. Adicione a seguinte propriedade markdown.docsetLanguages ao arquivo settings.json:

    {
    "markdown.docsetLanguages": [

    ]
}

  5. Posicione o cursor na matriz vazia da propriedade e ative o IntelliSense (via Ctrl + Barra de espaço). É exibida uma lista de nomes dev lang conhecidos.

  6. Adicione os nomes de dev lang à matriz até estar satisfeito com a lista. Por exemplo, a lista a seguir exibirá quatro nomes de dev lang para o usuário depois de digitar as marcações triplas:

    {
    "markdown.docsetLanguages": [
        ".NET Core CLI",
        "C#",
        "Markdown",
        "YAML"
    ]
}

  7. Salve as alterações no arquivo settings.json.

Aviso

Uma matriz markdown.docsetLanguages vazia faz com que todos os dev langs conhecidos sejam exibidos.

Exibir todos os dev langs conhecidos

Por padrão, todos os nomes de dev lang conhecidos são exibidos no IntelliSense. Essa configuração substitui a propriedade markdown.docsetLanguages descrita em Exibir os dev langs usados com frequência.

Para alterar essa configuração:

  1. SelecioneConfigurações de Preferências> de Arquivo> e filtre por Extensão de Markdown do Learn.
  2. Alterne a configuração na seção Markdown: Todos os Idiomas disponíveis.

Em ação

Veja abaixo uma breve demonstração desse recurso:

Preenchimento de dev lang