Instalace nástrojů pro vytváření obsahu
Tento článek popisuje, jak nainstalovat doporučené nástroje, které potřebujete k efektivnímu nebo rozsáhlému příspěvku do Microsoft Learn. Mezi příklady hlavních aktualizací patří:
- Dlouhé revize více článků
- Vytvoření nového článku
- Pracujte s dostupnými rozšířeními editoru Visual Studio Code, jako je Například Learn Authoring Pack.
Důležité
Pokud provádíte jenom menší změny, nemusíte provádět kroky v tomto článku. V části Upravit v prohlížeči se dozvíte, jak provádět rychlé úpravy bez instalace nástrojů.
K provedení těchto kroků doporučujeme přispěvatelům, kteří budou provádět významné změny. I když máte oprávnění k zápisu v hlavním úložišti, důrazně doporučujeme (a v této příručce se předpokládá), že vytvoříte fork a naklonujete úložiště a uložíte navrhované změny ve forku.
V tomto článku:
- Instalace Gitu
- Instalace Visual Studio Code
- Instalace balíčku pro vytváření obsahu Learn
Instalace klientských nástrojů Gitu pro Windows
Tato instalace zahrnuje systém správy verzí Gitu a Git Bash, což je aplikace příkazového řádku, kterou používáte k interakci s místním úložištěm Git.
Stáhněte si Git pro Windows.
Spusťte stažený spustitelný soubor (.EXE) a postupujte podle pokynů k instalaci. Výběrem možnosti Další na každé výzvě přijměte všechna výchozí nastavení.
Po zobrazení výzvy vyberte editor kódu. Výchozí editor kódu je Vim.
Výběrem možnosti Dokončit dokončete instalaci.
Po instalaci Gitu pro Windows nakonfigurujte své jméno Gitu a svoji e-mailovou adresu.
Instalace klientských nástrojů Gitu pro Mac a Linux
- Git pro Mac se dodává jakou součást nástrojů příkazového řádku Xcode. Jednoduše spusťte
gitz příkazového řádku. V případě potřeby budete vyzváni k instalaci nástrojů příkazového řádku. Git pro Mac si také můžete stáhnout od Software Freedom Conservancy. - Git pro Linux a Unix
Postupujte podle pokynů k instalaci a konfiguraci zvoleného klienta.
Instalace Visual Studio Code
Visual Studio Code je jednoduchý editor, který funguje ve Windows, Linuxu a Macu. Zahrnuje integraci Gitu a podporu rozšíření.
Stáhněte a nainstalujte Visual Studio Code pro váš operační systém:
Během instalace přijměte všechna výchozí nastavení.
Tip
Pokud chcete spustit VS Code a otevřít aktuální složku, spusťte příkaz code . v příkazovém řádku nebo prostředí Bash. Pokud je aktuální složka součástí místního úložiště Git, integrace GitHubu se v editoru Visual Studio Code zobrazí automaticky.
Instalace balíčku pro vytváření obsahu Learn
Sada Learn Authoring Pack pro Visual Studio Code zahrnuje základní pomoc při vytváření markdownu, náhledy stránek, podporu šablon Markdownu, markdownlint a kontrolu pravopisu kódu. Tyto funkce usnadňují a zjednodušují proces přispívání. Proto považujeme balíček pro vytváření obsahu Learn jako požadované rozšíření pro přispěvatele.
Pokud chcete nainstalovat balíček pro vytváření obsahu Learn, zvolte Nainstalovat ze stránky Balíčku pro tvorbu na webu VS Code Marketplace.
Pokud chcete použít funkci sady Learn Authoring Pack, stiskněte Alt+M v editoru Visual Studio Code. Pokud chcete nakonfigurovat panel nástrojů pro zobrazení dostupných funkcí, upravte nastavení editoru Visual Studio Code (Control+čárka) a přidejte uživatelské nastavení "markdown.showToolbar": true.
Další informace naleznete v tématu Learn Authoring Pack pro Visual Studio Code.
Princip editorů Markdownu
Markdown je jednoduchý jazyk značek, který slouží k vytváření obsahu. Preferovaným nástrojem pro editaci Markdownu v Microsoftu je Visual Studio Code. K dispozici jsou další nástroje pro úpravy Markdownu. Článek Referenční informace o Markdownu popisuje základy Markdownu a funkce podporované webem learn.microsoft.com .
Další kroky
Teď jste připraveni nastavit místní úložiště Git.