Installere verktøy for innholdsredigering

Artikkel
12/13/2023

Denne artikkelen beskriver hvordan du installerer de anbefalte verktøyene du trenger for å gjøre effektive eller store bidrag til Microsoft Learn. Eksempler på viktige oppdateringer inkluderer:

Lange revisjoner av flere artikler
Opprette en ny artikkel
Arbeid som du vil bruke de tilgjengelige Visual Studio Code-utvidelsene for, for eksempel Learn Authoring Pack.

Viktig

Hvis du bare gjør mindre endringer, trenger du ikke å fullføre trinnene i denne artikkelen. Se Rediger i nettleseren for å lære hvordan du gjør raske endringer uten å installere noen verktøy.

Bidragsytere som skal gjøre store endringer, oppfordres til å fullføre disse trinnene. Selv om du har skrivetillatelser i hovedrepositoriet, anbefaler vi på det sterkeste (og denne veiledningen forutsetter) at du forgrener og kloner repositoriet og lagrer de foreslåtte endringene i forgreningen.

I denne artikkelen gjør du følgende:

Installere Git-klientverktøy for Windows

Denne installasjonen inkluderer Git-versjonskontrollsystemet og Git Bash, kommandolinjeappen du bruker til å samhandle med det lokale Git-repositoriet.

Last ned Git for Windows.
Kjør den nedlastede kjørbare filen (EXE), og følg instruksjonene for å installere. Velg Neste ved hver ledetekst for å godta alle standardinnstillingene.
Velg et koderedigeringsprogram når du blir bedt om det. Standard koderedigeringsprogram er Vim.
Velg Fullfør for å fullføre installasjonen.

Når du har installert Git for Windows, konfigurerer du Git-navnet og e-postadressen din.

Installere Git-klientverktøy for Mac og Linux

Git for Mac tilbys som del av kommandolinjeverktøyene for Xcode. Bare kjør git fra kommandolinjen. Du vil bli bedt om å installere kommandolinjeverktøyene hvis det ikke allerede er gjort. Du kan også laste ned Git for Mac fra Software Freedom Conservancy.
Git for Linux og Unix

Følg instruksjonene for den valgte klienten for installasjon og konfigurasjon.

Installer Visual Studio Code

Visual Studio Code er et lett redigeringsprogram som fungerer på Windows, Linux og Mac. Det inkluderer Git-integrasjon og støtte for utvidelser.

Last ned og installer Visual Studio Code for operativsystemet:

Godta alle standardinnstillingene under installasjonen.

Tips

Hvis du vil starte VS Code og åpne gjeldende mappe, kjører du kommandoen code . i kommandolinjen eller Bash-skallet. Hvis gjeldende mappe er en del av en lokal Git-repositorium, vises GitHub-integreringen automatisk i Visual Studio Code.

Installer Learn Authoring Pack

Learn Authoring Pack for Visual Studio Code inkluderer grunnleggende markdown-redigeringshjelp, sideforhåndsvisninger, støtte for Markdown-maler, markdownlint og stavekontroll for kode. Disse funksjonene forenkler og effektiviserer bidragsprosessen. Som sådan anser vi Learn Authoring Pack som en nødvendig utvidelse for bidragsytere.

Hvis du vil installere Learn Authoring Pack, velger du Installer fra siden Learn Authoring Pack i VS Code Marketplace.

Hvis du vil bruke funksjonen Learn Authoring Pack, trykker du Alt+M på Visual Studio Code. Hvis du vil konfigurere en verktøylinje for å vise funksjonene som er tilgjengelige, redigerer du innstillingene for Visual Studio Code (Kontroll+komma) og legger til brukerinnstilling "markdown.showToolbar": true.

Hvis du vil ha mer informasjon, kan du se Learn Authoring Pack for Visual Studio Code.

Forstå Markdown-redigeringsprogrammer

Markdown er et lett markeringsspråk som brukes til å redigere innholdet. Visual Studio Code er det foretrukne verktøyet for redigering av Markdown hos Microsoft. Andre redigeringsverktøy for Markdown er tilgjengelige. Markdown Reference-artikkelen dekker grunnleggende om Markdown og funksjonene som støttes av learn.microsoft.com nettstedet.

Neste trinn

Nå er du klar til å konfigurere et lokalt Git-repositorium.