Toolinstallaties

Belangrijk

Als u alleen kleine wijzigingen aanbrengt in een artikel, hoeft u de stappen in dit artikel niet uit te voeren en kunt u rechtstreeks doorgaan naar de werkstroom voor kleine/onregelmatige wijzigingen.

Belangrijke inzenders en Microsoft-medewerkers wordt aangeraden deze stappen uit te voeren, zodat ze de werkstroom voor belangrijke/langdurige wijzigingen kunnen gebruiken. Zelfs als u over schrijfmachtigingen beschikt in de hoofdopslagplaats, is het raadzaam (en wordt het in deze handleiding aangenomen) dat u de opslagplaats splitst en kloont naar een locatie waar u over lees-/schrijfmachtigingen beschikt om de door u voorgestelde wijzigingen op te slaan.

Raadpleeg Installing tools using a Package Manager / Commandline (Hulpprogramma's installeren met behulp van een pakketbeheerder/opdrachtregelinterface) als u liever de clienthulpprogramma's installeert via een pakketbeheerder of opdrachtregelinterface.

Git-clienttools installeren

Installeer de nieuwste versie van de Git-clienttools van Software Freedom Conservancy. Hiermee wordt het Git-versiebeheersysteem geïnstalleerd, waaronder Git Bash, de opdrachtregel-app waarmee commando’s worden uitgevoerd voor de lokale Git-opslagplaats.

Voor deze handleiding installeren we Git voor Windows. U kunt alle standaardinstellingen accepteren, tenzij u andere opties wilt gebruiken.

Pagina voor het selecteren van onderdelen

Pagina voor het aanpassen van de PATH-omgeving

Pagina voor het configureren van conversies die regeleindes veroorzaken

Pagina voor het configureren van de terminaleditor

Pagina voor het configureren van extra opties

Notitie

Als u de voorkeur geeft aan een grafische gebruikersinterface (GUI) boven een opdrachtregelinterface (CLI), raadpleegt u de pagina met beschikbare GUI-clients van Software Freedom Conservancy, GitHub Desktop van GitHub of Visual Studio Code voor een aantal veelgebruikte opties. In deze handleiding richten we ons op het gebruik van de opdrachtregelinterface.

De Git Bash-configuratie bijwerken

Om ervoor te zorgen dat u juist wordt vermeld als inzender moet u lokaal in Git uw gebruikersnaam en e-mailadres opgeven.

  1. Start de Git Bash-opdrachtprompt.

  2. Geef de gebruikersnaam op die u hebt ingesteld in uw GitHub-profiel:

    git config --global user.name "jandevries"

  3. Configure your email to match the primary email that you designated in your GitHub profile. Use your Microsoft email address:

    git config --global user.email "alias@microsoft.com"

  4. Voer git config -l in (dat is de letter 'l' en niet het cijfer '1') en controleer uw lokale instellingen zodat u er zeker van bent dat de gebruikersnaam en het e-mailadres in de configuratie juist zijn.

Aanvullende Git-resources

Een Markdown-editor installeren

Markdown is een eenvoudige opmaaktaal die gemakkelijk is te lezen en te leren. Daarom is het al snel een standaardopmaaktaal geworden. Als u artikelen wilt schrijven in Markdown, kunt u het beste eerst een Markdown-editor downloaden en installeren.

Aanvullende informatie over het schrijven met Markdown, waaronder de basisprincipes van Markdown en de functies die worden ondersteund door de aangepaste Markdown-extensies van OPS, worden verderop beschreven in het artikel Markdown gebruiken.

Belangrijk

Voor Microsoft-inzenders is de aanbevolen Markdown-editor Visual Studio Code. Sommige teams vereisen het gebruik van uitbreidingen van Visual Studio Code (zoals Gauntlet en Acrolinx).

Visual Studio Code

Visual Studio Code, ook wel bekend als VS Code, is het eerste product van Microsoft op dit gebied. Er verschijnen regelmatig updates voor het product en het wordt steeds beter. Ga naar de documentatiepagina voor Visual Studio Code voor meer informatie over.

Voor Microsoft-medewerkers biedt het engineeringteam voor OPS ook extensies voor het schrijven met VS Code en voor Acrolynx ter ondersteuning voor het schrijven van artikelen voor Docs die compatibel zijn met OPS.

Atom

Atom is een gratis Markdown-editor die wordt aangeboden door GitHub. Voor Atom is geen licentie voor zakelijk gebruik vereist en de editor beschikt over een spellingcontrole.

Als u Atom gebruikt, moet u een aantal dingen instellen:

  1. Atom heeft een standaardinstelling van twee spaties voor tabs, maar in Markdown wordt uitgegaan van vier spaties. Als u de standaardinstelling van twee spaties hanteert, ziet uw artikel er goed uit wanneer u lokaal een voorbeeld bekijkt, maar dit is niet het geval wanneer het wordt geïmporteerd naar Azure. U moet Atom dus configureren voor het gebruik van vier spaties. U vindt deze instelling onder Bestand > Instellingen > Instellingen van editor > Lengte van tabs.
  2. Schakel Zachte terugloop in deze sectie in. Dit heeft hetzelfde resultaat als Tekstterugloop in Kladblok.
  3. Als u het Markdown-voorbeeld wilt inschakelen, klikt u op Pakketten > Markdown-voorbeeld > Voorbeeld in-/uitschakelen. U kunt Ctrl+Shift+M gebruiken om de HTML-weergave van het voorbeeld in en uit te schakelen.

Hulpprogramma's installeren met behulp van een pakketbeheerder/opdrachtregelinterface

Pakketbeheerders zijn een veelgebruikte manier om toepassingen vanuit een centrale bron te installeren op een computer. Dit proces maakt het veel eenvoudiger om de installatie van vereiste toepassingen in een organisatie volgens een script te laten verlopen. De onderstaande instructies beschrijven hoe u Git en Visual Studio Code kunt installeren met behulp van een installatieprogramma, voor zowel Mac als Windows.

Homebrew (Mac)

Homebrew is een pakketbeheerder die beschikbaar is voor Mac OSX. Deze kan worden geïnstalleerd met behulp van het volgende opdrachtregel-script:

Waarschuwing

Het uitvoeren van willekeurige scripts van het internet wordt doorgaans uit veiligheidsoverwegingen afgeraden, dus controleer altijd of een script veilig uitgevoerd kan worden en of het gebruik maakt van een beveiligd protocol (zoals https).

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Nadat u Homebrew op uw computer hebt geïnstalleerd, kunt u toepassingen op uw computer installeren met behulp van de opdracht brew install. Voer de volgende opdracht uit om Git te installeren:

brew install git

Volg na het installeren van Git de instructies om uw Git Bash-configuratie bij te werken.

Om Visual Studio Code te installeren, gebruik u de opdracht brew cask install, omdat deze toepassing op een andere manier wordt gedistribueerd dan Git. U installeert Visual Studio Code door de volgende opdracht uit te voeren:

brew cask install visual-studio-code

Wanneer u Visual Studio Code hebt geïnstalleerd, volgt u de instructies om Visual Studio Code-extensies te installeren om de Gauntlet- en Acrolinx-hulpprogramma's te verkrijgen.

PowerShell Package Management (Windows)

Sinds Windows 10 bevat PowerShell een PackageManagement-module met de mogelijkheid voor het beheren van pakketbeheerders in Windows.

Als u Git en Visual Studio Code wilt installeren met behulp van PackageManagement, kunt u de provider nuget gebruiken om de Chocolatey-opslagplaats aan te spreken.

Als u Git wilt installeren, voert u de volgende opdracht uit in een PowerShell-venster met beheerdersmachtigingen:

Install-Package git.install -ProviderName nuget -Source https://chocolatey.org/api/v2

Volg na het installeren van Git de instructies om uw Git Bash-configuratie bij te werken.

Voer de volgende opdracht uit om Visual Studio Code te installeren:

Install-Package VisualStudioCode -ProviderName nuget -Source https://chocolatey.org/api/v2

Wanneer u Visual Studio Code hebt geïnstalleerd, volgt u de instructies om Visual Studio Code-extensies te installeren om de Gauntlet- en Acrolinx-hulpprogramma's te verkrijgen.

Volgende stappen

  • Voor Microsoft-medewerkers:
    • Als u deel uitmaakt van een groep waarin het gebruik van de extensies voor het schrijven met VS Code Gauntlet of voor Acrolynx is vereist ter ondersteuning voor het schrijven van artikelen voor Docs die compatibel zijn met OPS, moet u eerst de installaties uitvoeren voordat u verdergaat.
    • Als uw groep gebruikmaakt van de VS Code Gauntlet-extensie en u bent eigenaar/beheerder van het portfolio, neem dan ook de Gauntlet Template Service door.
  • Voltooi de sectie 'Instellen' van deze handleiding door naar Lokale opslagplaats instellen te gaan. Hier ziet u hoe u een lokale kopie van de opslagplaats voor uw bijdragen instelt.