Komplettering av dev-språk

Artikel
08/10/2023

Tilläggsnamn

Metatillägget Learn Authoring Pack och Visual Studio Code består av flera undertillägg. Den här funktionen ingår i Learn Markdown-tillägget . Tillägget Learn Markdown är en del av Learn Authoring Pack. Du behöver inte installera det separat.

Sammanfattning

Deltagare behöver hjälp med att fastställa giltiga språkidentifierare (dev langs) som kan följa triple-backticks (öppningar av kodstängsel) i en Markdown-fil. Tyvärr finns det inte någon validering av utvecklingstid för dev langs. Resultatet är olika representationer av ett enda språk i samma konceptuella dokumentuppsättning.

Se C# som ett exempel. Deltagare har använt c#, C#, cs, csharpoch andra som dev lang-representationer av språket. Vilken av föregående återgivningar är korrekt?

Funktionen dev lang completion skingrar förvirringen genom att visa en lista över kända dev langs. När du väljer ett dev lang-namn från IntelliSense:

Kodstängslet är stängt.
Cirkumflexen är placerad i kodstängslet.

Inställningar

Det går inte att inaktivera den här funktionen. Följande inställningar är tillgängliga:

Visa vanliga dev langs
Visa alla kända dev langs

Visa vanliga dev langs

Endast en delmängd av de giltiga dev-språken används i en enda dokumentuppsättning. Så här förbättrar du användarupplevelsen:

Öppna dokumentuppsättningen i Visual Studio Code till rotkatalogen.
VäljInställningar för filinställningar>> och filtrera efter Learn Markdown-tillägg.
Klicka på länken Edit in settings.json (Redigera i settings.json) i avsnittet Markdown: Docset Languages (Språk för dokumentuppsättning).
Lägg till följande markdown.docsetLanguages egenskap i filen settings.json :
```
{
    "markdown.docsetLanguages": [

    ]
}
```
Placera din cirkumflex i egenskapens tomma matris och aktivera IntelliSense (via Ctrl-blanksteg + ). En lista över kända dev lang-namn visas.
Lägg till dev lang-namn i matrisen tills du är nöjd med listan. Följande lista visar till exempel fyra dev lang-namn för användaren efter att ha skrivit triple-ticks:
```
{
    "markdown.docsetLanguages": [
        ".NET Core CLI",
        "C#",
        "Markdown",
        "YAML"
    ]
}
```
Spara ändringarna i filen settings.json .

Varning

En tom markdown.docsetLanguages matris gör att alla kända dev-språk visas.

Visa alla kända dev langs

Som standard visas alla kända dev lang-namn i IntelliSense. Den här inställningen åsidosätter egenskapen markdown.docsetLanguages som beskrivs i Visa vanliga dev-språk.

Så här ändrar du den här inställningen:

VäljInställningar för filinställningar>> och filtrera efter Learn Markdown-tillägg.
Växla inställningen i avsnittet Markdown: Alla tillgängliga språk .

I praktiken

Nedan visas en kort demonstration av den här funktionen:

Dela via