Nová vydaná verze Balíčku pro vytváření obsahu na webu Docs pro VS Code

Tento příspěvek napsal Megan Bradley, vedoucí programový manažer na docs.microsoft.com týmu.

V dubnu jsme oznámili první vydání sady Docs Authoring Pack pro VS Code, která zahrnuje rozšíření Docs Markdown, rozšíření pro náhled úprav založených na DocFX a markdownlintu. Dnes s radostí oznamujeme druhou hlavní verzi sady Docs Authoring Pack, která zahrnuje následující nová rozšíření:

  • Kontrola pravopisu kódu Podle oblíbené poptávky jsme tuto offline kontrolu pravopisu sbalili pomocí Street Side Software, aby přispěvatelé mohli kontrolovat veškerý jejich obsah, včetně ukázek kódu, aniž by to museli dělat prostřednictvím online služby.
  • Šablony článků na webu Docs Toto rozšíření umožňuje použít šablonu Markdownu na nový soubor, což usnadňuje vytváření obsahu a metadat konzistentním způsobem.
  • Docs Preview. Nahrazení verze DocFx Preview zahrnuté v první verzi balíčku pro vytváření obsahu Docs. Nové rozšíření Preview je mnohem robustnější a představuje docs.microsoft.com CSS ve vyšší věrnosti.

Rozšíření můžete nainstalovat jednotlivě, prostřednictvím odkazů uvedených výše nebo v jedné sadě prostřednictvím sady Docs Authoring Pack.

Představujeme šablony článků

Šablony článků jsou kostra souborů Markdownu, které poskytují standardní nadpisy, metadata souborů, zaváděný text a další základní prvky, které následují docs.microsoft.com pokyny, což usnadňuje přispívání nových článků a eliminuje odhady z požadavků na publikování!

Pokud chcete vytvořit nový soubor založený na ukončovací šabloně, jednoduše stiskněte Alt+M a vyberte Šablonu:

apply template

Lepší náhled

Bývalý modul Preview založený na DocFX byl nahrazen úplně novým modulem Docs Preview, který nabízí následující vylepšení:

  • Podpora analyzátoru Markdig kompatibilního s CommonMarkem místo Markdownu s příchutí DocFx (DFM).
  • Aktuální docs.microsoft.com CSS a vykreslování vlastních prvků Markdownu s vyšší věrností
  • Vylepšená spolehlivost a rychlejší vykreslování náhledů a bez prodlev.
  • Podpora stále rostoucího seznamu rozšíření Markdownu specifických pro Docs, jakmile budou k dispozici.

Přispět

Rozšíření Docs Markdown jsou opensourcová – vítáme příspěvky!

Mějte na paměti, že většina příspěvků vyžaduje, abyste souhlasili s licenční smlouvou s přispěvatelem (CLA), která potvrzuje, že máte právo a ve skutečnosti nám udělíte práva k používání vašeho příspěvku v našem softwaru a obsahu. Podrobnosti najdete tady: https://cla.microsoft.com Při odesílání žádosti o přijetí změn robot CLA automaticky určí, jestli je potřeba poskytnout smlouvu CLA, a příslušným způsobem žádost o přijetí změn upraví (např. přidáním jmenovky nebo komentáře). Stačí postupovat podle pokynů robota. Budete to muset udělat jenom jednou napříč všemi úložišti vlastněnými Microsoftem.

Váš názor

Máte nápady na to, jak můžeme rozšíření vylepšit? Stačí vytvořit nový problém!

A nezapomeňte sledovat nejnovější informace na našem twitterovém účtu.

Sníte o tom, že zlepšíte svět pro vývojáře? Připojte se k našemu týmu!