Dela via


Klona och uppdatera wiki-innehåll offline

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Du kan uppdatera wiki-sidorna offline på samma sätt som du utvecklar kod på en Git-lagringsplats.

Du kan använda valfri klient som du vill eller git-kommandoradsverktyg för att uppdatera wikin offline. Mer information om hur du arbetar med Git-lagringsplatser och verktyg som stöds finns i Git-lagringsplatser.

Här är de grundläggande stegen för att uppdatera wiki-innehåll offline:

  1. Klona din Wiki Git-lagringsplats till din lokala IDE eller arbetsyta.
  2. Lägg till filer eller mappar i din lokala git-gren.
  3. Uppdatera .order-filerna så att de återspeglar dina sidor och undersidor.
  4. Checka in och push-överföra uppdateringarna som du har gjort till din lokala git-gren.

Förutsättningar

Utför följande steg för att migrera Markdown-sidor från en annan wiki till din gruppprojekt-wiki eller till innehåll som du publicerar som kod till en wiki.

Klona din wiki

Wiki-lagringsplatsen lagrar sidor, bilder, bifogade filer och sekvensen med sidor och undersidor. Klona wikin för att börja.

  1. Logga in på projektet (https://dev.azure.com/{Your_Organization/Your_Project}) och välj sedan din wiki.

  2. Öppna snabbmenyn Fler åtgärder och välj Klona wiki.

    Klona Wiki Git-lagringsplats

  3. I dialogrutan Klona lagringsplats väljer du Kopiera klonings-URL till Urklipp.

    Kopiera wiki-URL:en

    Ange det i webbläsaren för att visa de filer som definierats under wikiMaster-grenen.

    Wiki-huvudfiler

  4. Använd den URL som du kopierade för att klona lagringsplatsen i den IDE som du använder. Mer information finns i någon av följande artiklar:

Lägga till sidor i din lokala Git-lagringsplats

Vi skapar sidor med Markdown-format. Lägg till en Markdown-fil i din lokala gren för varje sida och undersida som du vill lägga till i wikin.

Lägg till sidor

Om du vill lägga till sidor i wiki-trädets rot lägger du till en Markdown-fil i roten på Git-lagringsplatsen.

  1. För varje sida som du vill lägga till skapar du en Markdown-fil med sidinnehållet och lägger sedan till den under rotmappen för lagringsplatsen.

    För CanaryBuilds-teamprojektet finns det i följande mapp:

    C:\Users\UserName\Source\Repos\CanaryBuilds.wiki

  2. Om du vill lägga till sidor i wiki-trädets rot lägger du till en Markdown-fil för varje sida i roten på Git-lagringsplatsen.

    Git-lagringsplats för lokal gren

  3. När du har lagt till alla sidor som du vill lägga till i roten uppdaterar du .order-filen i roten. Den bör ha en post för varje Markdown-fil som definieras i roten. Varje post ska matcha filrubriken med blanksteg som ersätts med ett bindestreck.

    Till exempel:

     Welcome
     Roadmap  
     How-to-contribute  
     Home  
     Reference  
    

Lägg till undersidor

  1. Skapa en mapp för den överordnade sidan och lägg sedan till Markdown-filer för varje undersida i mappen.

    Vi har till exempel lagt till följande filer i mappen How-to-contribute. Dessa undersidor visas under sidan Så här bidrar du i wikin.

    Skärmbild av undersidorna.

  2. Lägg till en .order-fil i mappen med ordningen på undersidorna som de ska visas i wikin. Information om hur du använder .order-filen för att sekvensera sidor finns i Wiki Git-lagringsplatsfiler och filstruktur.

    Filen har till exempel följande undersidor:

     Request-extensions  
     Licensing  
     Smoke-test  
     Coding-guidelines  
    

Push-överför ändringarna

När du är klar med alla dina uppdateringar skickar du filerna till Git-lagringsplatsen.

De tillagda sidorna och undersidorna visas omedelbart i wikin.

Wiki-träd har uppdaterats

Om det finns fel i processen visas sidorna i wikin med ett varningstecken.

Varning när .order-filen inte uppdateras korrekt.