Installare gli strumenti di creazione di contenuti

  • Articolo

Questo articolo descrive come installare gli strumenti consigliati necessari per fornire contributi approfonditi o di grandi dimensioni in Microsoft Learn. Esempi di aggiornamenti principali includono:

  • Revisioni lunghe a più articoli
  • Creare un nuovo articolo
  • Usare le estensioni di Visual Studio Code disponibili, ad esempio Learn Authoring Pack.

Importante

Se si apportano solo modifiche secondarie, non è necessario completare i passaggi descritti in questo articolo. Per informazioni su come apportare modifiche rapide senza installare strumenti, vedere Modifica nel browser .

I collaboratori che apportano modifiche importanti sono invitati a completare questi passaggi. Anche se si dispone di autorizzazioni di scrittura nel repository principale, è consigliabile (e questa guida presuppone) di creare una copia tramite fork e clonare il repository e archiviare le modifiche proposte nel fork.

Contenuto dell'articolo:

Installare gli strumenti client Git per Windows

Questa installazione include il sistema di controllo della versione Git e Git Bash, l'app da riga di comando usata per interagire con il repository Git locale.

  1. Scaricare Git per Windows.

  2. Eseguire il file eseguibile (EXE) scaricato e seguire le istruzioni per l'installazione. Selezionare Avanti a ogni richiesta per accettare tutte le impostazioni predefinite.

  3. Selezionare un editor di codice, quando richiesto. L'editor di codice predefinito è Vim.

  4. Selezionare Fine per completare l'installazione.

Dopo aver installato Git per Windows, configurare il nome Git e l'indirizzo di posta elettronica.

Installare gli strumenti client Git per Mac e Linux

  • Git per Mac è incluso negli strumenti della riga di comando Xcode. Eseguire semplicemente git dalla riga di comando. Verrà richiesto di installare gli strumenti della riga di comando, se necessario. È anche possibile scaricare Git per Mac da Software Freedom Conservancy.
  • Git per Linux e Unix

Seguire le istruzioni relative al client selezionato per l'installazione e configurazione.

Installare Visual Studio Code

Visual Studio Code è un editor leggero che funziona in Windows, Linux e Mac. Include l'integrazione Git e il supporto per le estensioni.

Scaricare e installare Visual Studio Code per il sistema operativo:

Durante l'installazione accettare tutte le impostazioni predefinite.

Suggerimento

Per avviare VS Code e aprire la cartella corrente, eseguire il comando code . nella riga di comando o nella shell Bash. Se la cartella corrente fa parte di un repository Git locale, l'integrazione di GitHub viene visualizzata automaticamente in Visual Studio Code.

Installare Learn Authoring Pack

Learn Authoring Pack per Visual Studio Code include l'assistenza di base per la creazione di markdown, le anteprime di pagina, il supporto per i modelli Markdown, markdownlint e il correttore ortografico del codice. Queste funzionalità semplificano e semplificano il processo di contributo. Di conseguenza, si consideri Learn Authoring Pack un'estensione necessaria per i collaboratori.

Per installare Learn Authoring Pack, scegliere Installa dalla pagina Learn Authoring Pack in VS Code Marketplace.

Per usare la funzionalità Learn Authoring Pack, premere Alt+M in Visual Studio Code. Per configurare una barra degli strumenti per visualizzare le funzioni disponibili, modificare le impostazioni di Visual Studio Code (Ctrl+virgola) e aggiungere l'impostazione "markdown.showToolbar": trueutente .

Per altre informazioni, vedere Learn Authoring Pack per Visual Studio Code.

Informazioni sugli editor Markdown

Markdown è un linguaggio di markup leggero usato per creare il contenuto. Visual Studio Code è lo strumento preferito per la modifica di Markdown in Microsoft. Sono disponibili altri strumenti di modifica markdown. L'articolo di riferimento su Markdown illustra le nozioni di base di Markdown e le funzionalità supportate dal learn.microsoft.com sito Web.

Passaggi successivi

A questo momento è possibile configurare un repository Git locale.