Learn Authoring Pack for Visual Studio Code

A Learn Authoring Pack Visual Studio Code-bővítmények gyűjteménye, amelyek a Microsoft Learn-tartalmak Markdown-szerkesztését segítik. A csomagot a VS Code piacteréről töltheti le, és a következő bővítményeket tartalmazza:

Előfeltételek és feltételezések

Ha relatív hivatkozásokat, képeket és más beágyazott tartalmakat szeretne beszúrni a Learn Markdown bővítménysel, a VS Code-munkaterületet a klónozott nyílt közzétételi rendszer (OPS) adattárának gyökerére kell korlátoznia. Ha például klónozta a dokumentumtáratC:\git\SomeDocsRepo\, nyissa meg a mappát vagy egy almappát a VS Code: Fájl>megnyitása mappa menüjében vagy code C:\git\SomeDocsRepo\ a parancssorból.

A bővítmény által támogatott szintaxis bizonyos részei, például a figyelmeztetések és kódrészletek OPS-alapú egyedi Markdown-kiterjesztések. Az egyedi Markdown-kiterjesztések nem jelennek meg megfelelően, ha nem az OPS-en keresztül teszi őket közzé.

A Learn Markdown bővítmény használata

A Learn Markdown menü eléréséhez írja be az Alt M parancsot+. A kívánt parancsot kattintással vagy a Fel és a Le nyílbillentyűvel is kiválaszthatja. Vagy gépelhet a szűrés elindításához, majd lenyomhatja az ENTER billentyűt, amikor a menüben a kívánt funkció van kiemelve.

A parancsok naprakész listáját a Learn Markdown-olvasóban találja.

Fő átirányítási fájl létrehozása

A Learn Markdown bővítmény tartalmaz egy szkriptet egy adattár fő átirányítási fájljának létrehozásához vagy frissítéséhez az redirect_url egyes fájlok metaadatai alapján. Ez a szkript ellenőrzi az adattár redirect_urlminden Markdown-fájlját, hozzáadja az átirányítási metaadatokat a fő átirányítási fájlhoz (.openpublishing.redirection.json) az adattárhoz, és áthelyezi az átirányított fájlokat az adattáron kívüli mappába. A szkript futtatása:

1. Válassza az F1 gombot a VS Code parancspalettájának megnyitásához.
2. Kezdje el beírni a következőt: "Learn: Generate..."
3. Válassza a Learn: Generate main redirection file parancsot.
4. Amikor a szkript fut, az átirányítási eredmények megjelennek a VS Code kimeneti ablaktábláján, és az eltávolított Markdown-fájlok bekerülnek a Learn Authoring\redirects mappába az alapértelmezett elérési út alatt.
5. Tekintse át az eredményeket. Ha a vártnak megfelelőek, küldjön egy lekéréses kérelmet az adattár frissítéséhez.

Billentyűparancsok társítása

1. Írja be a Ctrl+K, majd a Ctrl S billentyűkombinációt+a billentyűparancsok listájának megnyitásához.

2. Keresse meg azt a parancsot (példa: formatBold), amelyhez egyéni billentyűparancs-társítást kíván létrehozni.

3. Kattintson a pluszjelre, amely a parancs neve mellett jelenik meg, amikor az egérmutatót a sor fölé viszi.

4. Miután megjelent az új beviteli mező, írja be az adott parancshoz társítani kívánt billentyűparancsot. Ha például félkövérre szeretné használni a gyakori parancsikont, írja be a Ctrl+B billentyűt.

5. Javasolt when záradékot beilleszteni a billentyűparancs-társításba, hogy az csak a Markdown-fájlokban legyen elérhető. Ehhez nyissa meg a keybindings.json fájlt, és szúrja be az alábbi sort a parancs neve alá (fontos, hogy tegyen egy vesszőt a megelőző sor végére):

   "when": "editorTextFocus && editorLangId == 'markdown'"
   

   A kész billentyűparancs-társításnak az alábbihoz hasonlóan kell kinéznie a keybindings.json fájlban:

   [
       {
           "key": "ctrl+b",
           "command": "formatBold",
           "when": "editorTextFocus && editorLangId == 'markdown'"
       }
   ]
   

   Tipp.

   Az alapértelmezett értékek felülírásához ebben a fájlban helyezze el a billentyűparancs-társításokat

6. Mentse a keybindings.json fájlt.

A billentyűparancs-társításokkal kapcsolatos további információért lásd a VS Code dokumentációját.

A régi „Gauntlet” eszköztár megjelenítése

A "Gauntlet" nevű bővítmény korábbi felhasználói észre fogják venni, hogy a szerzői eszköztár már nem jelenik meg a VS Code ablak alján a Learn Markdown bővítmény telepítésekor. Ennek az oka az, hogy az eszköztár túl sok helyet foglalt el a VS Code állapotsávján, és nem követte a bővítmények felhasználói élményre vonatkozó ajánlásait, ezért az új bővítményben ezt a funkciót kivontuk a használatból. De ha szeretné, továbbra is megjelenítheti ezt az eszköztárat úgy, hogy frissíti a VS Code alkalmazás settings.json fájlját a következő módon:

1. A VS Code-ban válassza a Fájlbeállítások>> Gépház vagy a Ctrl billentyűkombinációt.+

2. Válassza a Felhasználói beállítások lehetőséget az összes VS Code-munkaterület beállításainak módosításához, vagy a Munkaterület-beállítások lehetőséget, ha csak az aktuális munkaterület beállításait szeretné módosítani.

3. Válassza a Bővítmények>Learn Markdown-bővítménykonfigurációja lehetőséget, majd az alsó állapotsoron válassza az örökölt eszköztár megjelenítése lehetőséget.

   

A kijelölés után a VS Code frissíti a settings.json fájlt. Ekkor a rendszer arra kéri, hogy a módosítások érvénybe léptetéséhez töltse be újra az ablakot.

A bővítményhez hozzáadott újabb parancsok nem lesznek elérhetők az eszköztárból.

Learn-sablonok használata

A Learn Article Templates bővítmény lehetővé teszi, hogy a VS Code írói lekérjenek egy Markdown-sablont egy központosított áruházból, és alkalmazzák egy fájlra. A sablonokkal egyszerűbben biztosítható sok más mellet például az, hogy a szükséges metaadatok szerepeljenek a cikkben, vagy hogy a tartalmi követelményeknek eleget tegyünk. A sablonok Markdown-fájlként vannak tárolva és kezelve egy nyilvános GitHub-tárházban.

Sablon alkalmazása a VS Code-ban

1. Győződjön meg arról, hogy a Learn Cikksablonok bővítmény telepítve van és engedélyezve van.
2. Ha nincs telepítve a Learn Markdown bővítmény, kattintson az F1 gombra a parancskatalógus megnyitásához, kezdje el beírni a "sablont" a szűréshez, majd kattintson Learn: Templatea gombra. Ha telepítve van a Learn Markdown, használhatja a parancskatalógust, vagy kattintson az Alt+M gombra a Learn Markdown QuickPick menü megjelenítéséhez, majd válasszon Template a listából.
3. A megjelenő listából válassza ki a kívánt sablont.

A GitHub-azonosító és/vagy a Microsoft-alias hozzáadása a VS Code-beállításokhoz

A Templates bővítmény a következő három dinamikus metaadat-mezőt támogatja: author, ms.author és ms.date. Ez azt jelenti, hogy ha egy sablon létrehozója használja ezeket a mezőket Markdown-sablon metaadat-fejlécében, akkor a sablon alkalmazásakor ezek automatikusan ki lesznek töltve a fájlban az alábbiak szerint:

Az author és/vagy az ms.author mező beállítása

1. A VS Code-ban válassza a Fájlbeállítások>> Gépház vagy a Ctrl billentyűkombinációt.+
2. Válassza a Felhasználói beállításokat az összes VS Code-munkaterület beállításainak módosításához, vagy a Munkaterület beállításait, ha csak az aktuális munkaterület beállításait szeretné módosítani.
3. A bal oldali Alapértelmezett Gépház panelen keresse meg a Learn Cikksablonok bővítménykonfigurációját, kattintson a kívánt beállítás melletti ceruza ikonra, majd kattintson a Csere gombra Gépház.
4. A Felhasználói beállítások panel mellette jelenik majd meg, az alján egy új bejegyzéssel.
5. Adja hozzá a GitHub-azonosítóját vagy a Microsoft-aliasát, és mentse a fájlt.
6. Előfordulhat, hogy a módosítások életbe lépése érdekében be kell zárnia, majd újra el kell indítania a VS Code-ot.
7. Ha most dinamikus mezőket használó sablont alkalmaz, a metaadatok fejléc automatikusan ki lesz töltve a GitHub-azonosítójával vagy a Microsoft-aliasával.

Új sablon elérhetővé tétele a VS Code-ban

1. Készítse el a sablon vázlatát Markdown-fájlként.
2. Küldjön el egy lekéréses kérelmet a MicrosoftDocs/content-templates adattár templates (sablonok) mappájára vonatkozóan.

A tartalomért felelős csapat áttekinti a sablont, és egyesíti a pr-t, ha az megfelel a stílusra vonatkozó irányelveknek. Az egyesített sablon a Learn Cikksablonok bővítmény minden felhasználója számára elérhetővé válik.

Bemutató számos funkcióról

Íme egy rövid videó, amely a Learn Authoring Pack alábbi funkcióit mutatja be:

• YAML-fájlok
  • A "Learn: Link to file in repo" (Információ: Hivatkozás a fájlra az adattárban) támogatása
• Markdown-fájlok
  • A helyi menü „Az „ms.date” metaadatérték frissítése” menüpontja
  • A kód automatikus kiegészítésének támogatása a kódelkerítési nyelvi azonosítók esetében
  • Ismeretlen kódelkerítési nyelvi azonosítókra vonatkozó figyelmeztetések / automatikus javítás támogatása
  • A kijelölés növekvő (A – Z) sorrendbe rendezése
  • A kijelölés csökkenő (Z – A) sorrendbe rendezése

További lépések

Ismerje meg a Learn Authoring Pack, Visual Studio Code bővítményben elérhető különféle funkciókat.

• Nyelvazonosítók kiegészítése
• Képtömörítés
• Metaadatok frissítése
• Táblázat újraformázása
• Intelligens idézőjelek cseréje
• Átirányítások rendezése
• Kijelölés rendezése