Installare gli strumenti di creazione del contenuto

In questo articolo vengono descritti i passaggi per installare in modo interattivo gli strumenti client Git e Visual Studio Code.

Importante

Per apportare solo modifiche minime agli articoli, non è necessario completare i passaggi contenuti in questo articolo ed è possibile passare direttamente al flusso di lavoro le per modifiche rapide.

I collaboratori che apportano modifiche importanti sono invitati a completare questi passaggi, consentendo di usare il flusso di lavoro delle modifiche principali/a esecuzione prolungata. Anche se sono disponibili le autorizzazioni di scrittura nel repository principale, è caldamente consigliata la creazione di un fork e di un clone del repository (e le informazioni nella presente guida la danno per scontata), in modo da disporre di autorizzazioni di lettura/scrittura per archiviare le modifiche proposte nel fork.

Installare gli strumenti client Git

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

Installare gli strumenti client Git per Windows

  1. Scaricare Git per Windows.

  2. Eseguire il file eseguibile scaricato (.EXE) e seguire le istruzioni da installare. 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, che è difficile da usare se non si ha già familiarità con esso. Per modificare l'editor di codice predefinito, vedere Configurare un editor.

  4. Selezionare Fine per completare l'installazione.

    Pagina di installazione git per il completamento della configurazione.

Dopo aver installato Git per Windows, è necessario configurare il nome Git e l'indirizzo di posta elettronica prima di installare Visual Studio Code.

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.

Nel prossimo articolo verrà descritto come configurare un repository Git locale.

Le risorse Git aggiuntive sono disponibili qui: terminologia | Git basics | Learning Git e GitHub

Installare Visual Studio Code

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

Suggerimento

Per avviare Visual Studio 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 Visual Studio Code per Window, mac e Linux

  • Windows. La home page di Visual Studio Code dovrebbe rilevare correttamente il sistema operativo.
  • Mac
  • Linux

Installare le estensioni di Visual Studio Code

Per installare le estensioni:

  1. Avviare Visual Studio Code.

  2. Selezionare l'icona estensioni quadrate nel riquadro di spostamento a sinistra. Viene visualizzato il riquadro Estensioni: Marketplace .

  3. Nella casella di ricerca estensioni del Marketplace digitare il nome di un'estensione da trovare.

    Screenshot che mostra l'icona delle estensioni e punta alle estensioni di ricerca nella barra di ricerca del Marketplace nel codice VS.

  4. Nei risultati visualizzati individuare l'estensione desiderata e selezionare Installa.

Installare Learn Authoring Pack

Importante

Learn Authoring Pack per Visual Studio Code include assistenza di base per la creazione di Markdown, le anteprime di pagina, il supporto per modelli Markdown, markdownlint e Controllo ortografico del codice. Queste funzionalità semplificano e semplificano il processo di contributi. Di conseguenza, si considera 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 (Controllo+virgola) e aggiungere l'impostazione "markdown.showToolbar": trueutente .

Per altre informazioni, vedere Learn Authoring Pack for 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 markdown illustra le nozioni di base di Markdown e le funzionalità supportate dalle estensioni Markdown personalizzate di Open Publishing Services (OPS).

Passaggi successivi

A questo punto si è pronti per configurare un repository Git locale.