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.
- Installare Git
- Installare Visual Studio Code
- Installare Learn Authoring Pack
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
Scaricare Git per Windows.
Eseguire il file eseguibile scaricato (.EXE) e seguire le istruzioni da installare. Selezionare Avanti a ogni richiesta per accettare tutte le impostazioni predefinite.
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.
Selezionare Fine per completare l'installazione.
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:
Avviare Visual Studio Code.
Selezionare l'icona estensioni quadrate nel riquadro di spostamento a sinistra. Viene visualizzato il riquadro Estensioni: Marketplace .
Nella casella di ricerca estensioni del Marketplace digitare il nome di un'estensione da trovare.
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": true
utente .
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.