Delen via


Voltooiing van Dev Lang

Extensienaam

De Visual Studio Code-meta-extensie Learn Authoring Pack bestaat uit meerdere subextensies. Deze functie is opgenomen in de Learn Markdown-extensie . De Learn Markdown-extensie maakt deel uit van het Learn Authoring Pack. U hoeft deze niet afzonderlijk te installeren.

Samenvatting

Inzenders hebben hulp nodig bij het bepalen van de geldige taal-id's (dev langs) die in een Markdown-bestand driedubbele backticks (codeomheiningsopeningen) kunnen volgen. Helaas bestaat de build-time-validatie van dev-langs niet. Het resultaat is verschillende representaties van één taal binnen dezelfde conceptuele docset.

Neem C# als voorbeeld. Inzenders hebben , C#, cs, csharpen anderen gebruikt c#als dev lang-representaties van de taal. Welke van de voorgaande representaties is juist?

De voltooiingsfunctie Dev lang verdrijft de verwarring door een lijst met bekende ontwikkelaars weer te geven. Bij het selecteren van een dev lang-naam in IntelliSense:

  • De code omheining is gesloten.
  • De caret bevindt zich in de code omheining.

Voorkeuren

Het is niet mogelijk om deze functie uit te schakelen. De volgende instellingen zijn beschikbaar:

Veelgebruikte dev-langs weergeven

Er wordt slechts een subset van de geldige dev langs gebruikt in één docset. De gebruikerservaring verbeteren:

  1. Open in Visual Studio Code de docset naar de hoofdmap.

  2. Selecteer Instellingen voor bestandsvoorkeuren>>en filter op Markdown-extensie voor Learn.

  3. Klik op de koppeling Bewerken in settings.json in de sectie Markdown: Docset Languages .

  4. Voeg de volgende markdown.docsetLanguages eigenschap toe aan het bestand settings.json :

    {
        "markdown.docsetLanguages": [
    
        ]
    }
    
  5. Plaats de caret in de lege matrix van de eigenschap en activeer IntelliSense (via Ctrl Spatie + ). Er wordt een lijst met bekende dev lang-namen weergegeven.

  6. Voeg ontwikkelaarsnamen toe aan de matrix totdat u tevreden bent met de lijst. In de volgende lijst worden bijvoorbeeld vier dev lang-namen weergegeven voor de gebruiker na het typen van drie keer tikken:

    {
        "markdown.docsetLanguages": [
            ".NET Core CLI",
            "C#",
            "Markdown",
            "YAML"
        ]
    }
    
  7. Sla uw wijzigingen op in het bestand settings.json .

Waarschuwing

Een lege markdown.docsetLanguages matrix zorgt ervoor dat alle bekende ontwikkelaars worden weergegeven.

Alle bekende ontwikkelaars weergeven

Standaard worden alle bekende dev lang-namen weergegeven in IntelliSense. Deze instelling overschrijft de markdown.docsetLanguages eigenschap die wordt beschreven in Veelgebruikte dev langs weergeven.

Ga als volgt te werk om deze instelling te wijzigen:

  1. Selecteer Instellingen voor bestandsvoorkeuren>>en filter op Markdown-extensie voor Learn.
  2. Schakel de instelling in de sectie Markdown: alle beschikbare talen in.

In actie

Hieronder ziet u een korte demonstratie van deze functie:

Voltooiing van Dev Lang