Nová vydaná verze Balíčku pro vytváření obsahu na webu Docs pro VS Code
Tento příspěvek napsala Megan Bradley, senior programová manažerka docs.microsoft.com týmu.
V dubnu jsme oznámili vydání prvního balíčku pro vytváření obsahu na webu Docs pro VS Code, který obsahuje rozšíření Docs Markdown, rozšíření pro náhled úprav založených na DocFX a také markdownlint. Dnes s radostí oznamujeme druhou hlavní verzi balíčku Docs Authoring Pack, která obsahuje následující nová rozšíření:
- Kontrola pravopisu kódu. Na základě poptávky jsme přidali tuto offline kontrolu pravopisu od společnosti Street Side Software, aby přispěvatelé mohli kontrolovat pravopis a kontrolovat veškerý obsah, včetně ukázek kódu, aniž by to museli provádět 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 konzistentní vytváření obsahu a metadat.
- Docs Preview. Náhrada za DocFx Preview, která je součástí první verze Balíčku pro vytváření obsahu na webu Docs. Nové rozšíření verze Preview je mnohem robustnější a představuje docs.microsoft.com šablon stylů CSS s vyšší věrností.
Rozšíření můžete nainstalovat jednotlivě, prostřednictvím výše uvedených odkazů nebo v jedné sadě prostřednictvím balíčku pro vytváření obsahu na webu Docs.
Šablony článků jsou kostru souborů Markdown, které poskytují standardní nadpisy, metadata souborů, často používaný text a další základní prvky, které splňují docs.microsoft.com pokyny, což usnadňuje přispívání nových článků a eliminuje hádání 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 Šablona:
Bývalý modul Preview založený na DocFX byl nahrazen zcela novou verzí Docs Preview, která obsahuje následující vylepšení:
- Podpora analyzátoru Markdig kompatibilního s CommonMarkem místo DFM (DocFx-flavored Markdown).
- Aktuální docs.microsoft.com ŠABLONY STYLŮ CSS, které vykreslují vlastní prvky Markdownu s vyšší věrností.
- Vylepšená spolehlivost, díky čemuž je vykreslování náhledů rychlejší a bez prodlev.
- Podpora neustále se rozšiřujícího seznamu rozšíření Markdownu specifických pro Docs, jakmile budou k dispozici.
Rozšíření Docs Markdown jsou opensourcová – uví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 skutečně nám udělujete práva používat váš příspěvek 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. Ve všech úložištích vlastněných Microsoftem to budete muset udělat jenom jednou.
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!