Nyelvazonosítók kiegészítése

  • Cikk

Bővítmény neve

A Learn Authoring Pack, Visual Studio Code metabővítmény több albővítményből áll. Ezt a funkciót a Learn Markdown bővítmény tartalmazza. A Learn Markdown bővítmény a Learn Authoring Pack része, nem szükséges külön telepíteni.

Összefoglalás

A közreműködőknek segítségre van szükségük az érvényes nyelvi azonosítók (dev langs) meghatározásához, amelyek követhetik a Tripla-backticks (kódkerítési nyílások) követését egy Markdown-fájlban. Sajnos a dev langs build-time ellenőrzése nem létezik. Az eredmény egy nyelv eltérő ábrázolása ugyanazon a fogalmi dokumentumkészleten belül.

Vegyük példaként a C#-t. A közreműködők a , C#, cs, csharpés más nyelveket használták c#dev lang-reprezentációként. Az előző ábrázolások közül melyik helyes?

A Dev lang-befejezés funkció az ismert dev langs-listák listájának megjelenítésével eloszlatja a félreértéseket. Ha kiválaszt egy dev lang nevet az IntelliSense-ből:

  • A kódkerítés zárva van.
  • A gondviselet a kódkerítésben van elhelyezve.

Beállítások

Ez a funkció nem tiltható le. A következő beállítások érhetők el:

Gyakran használt dev langs megjelenítése

Egyetlen docsetben csak az érvényes dev langs egy részhalmaza lesz használva. A felhasználói élmény javítása:

  1. A Visual Studio Code-ban nyissa meg a docsetet a gyökérkönyvtárban.

  2. Válassza aFájlbeállítások>>beállítások lehetőséget, és szűrjön a Learn Markdown-bővítmény alapján.

  3. Kattintson a Szerkesztés a settings.json fájlban hivatkozásra a Markdown: Docset-nyelvek szakaszban.

  4. Adja hozzá a következő markdown.docsetLanguages tulajdonságot a settings.json fájlhoz:

    {
    "markdown.docsetLanguages": [

    ]
}

  5. Helyezze a gondviselőt a tulajdonság üres tömbjéhez, és aktiválja az IntelliSense-t ( a Ctrl + szóközzel). Megjelenik az ismert dev lang-nevek listája.

  6. Adjon dev lang-neveket a tömbhöz, amíg nem elégedett a listával. Az alábbi listában például négy dev lang-név jelenik meg a felhasználónak, miután beírta a triplajeleket:

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

  7. Mentse a beállítások.json fájl módosításait.

Figyelmeztetés

Egy üres markdown.docsetLanguages tömb hatására az összes ismert dev lang megjelenik.

Az összes ismert dev lang megjelenítése

Alapértelmezés szerint az összes ismert dev lang-név megjelenik az IntelliSense-ben. Ez a beállítás felülbírálja a markdown.docsetLanguagesGyakran használt dev langs megjelenítése című cikkben leírt tulajdonságot.

A beállítás módosítása:

  1. Válassza aFájlbeállítások>>beállítások lehetőséget, és szűrjön a Learn Markdown-bővítmény alapján.
  2. Állítsa be a beállítást a Markdown: Minden elérhető nyelv szakaszban.

Működés közben

Az alábbiakban röviden bemutatjuk ezt a funkciót:

Nyelvazonosítók kiegészítése