Delen via

Wiki-inhoud offline klonen en bijwerken

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

U kunt uw wikipagina's offline bijwerken op dezelfde manier als u code ontwikkelt in een Git-opslagplaats.

U kunt elke gewenste client of git-opdrachtregelprogramma's gebruiken om uw wiki offline bij te werken. Zie Git-opslagplaatsen voor meer informatie over het werken met Git-opslagplaatsen en ondersteunde hulpprogramma's.

De basisstappen voor het offline bijwerken van wiki-inhoud zijn als volgt:

  1. Kloon uw Wiki Git-opslagplaats naar uw lokale IDE of werkruimte.
  2. Voeg bestanden of mappen toe aan uw lokale Git-vertakking.
  3. Werk de .orderbestanden bij om uw pagina's en subpagina's weer te geven.
  4. Voer de updates die u hebt aangebracht, door en push deze naar uw lokale Git-vertakking.

Vereisten

Voer de volgende stappen uit om Markdown-pagina's te migreren van een andere wiki naar uw teamprojectwiki of naar inhoud die u als code naar een wiki publiceert.

Uw wiki klonen

In uw wikiopslagplaats worden pagina's, afbeeldingen, bijlagen en de volgorde van pagina's en subpagina's opgeslagen. Kloon uw wiki om te beginnen.

  1. Meld u aan bij uw project (https://dev.azure.com/{Your_Organization/Your_Project}) en selecteer vervolgens uw wiki.

  2. Open het contextmenu Meer acties en selecteer Wiki klonen.

    Git-opslagplaats voor wiki klonen

  3. Selecteer in het dialoogvenster Kloonopslagplaats de kloon-URL naar het Klembord kopiëren.

    De wiki-URL kopiëren

    Voer deze in uw browser in om de bestanden weer te geven die zijn gedefinieerd onder de wikiMaster-vertakking.

    Hoofdbestanden van wiki

  4. Gebruik de URL die u hebt gekopieerd om de opslagplaats te klonen in de IDE die u gebruikt. Zie een van de volgende artikelen voor meer informatie:

Pagina's toevoegen aan uw lokale Git-opslagplaats

We maken pagina's met de Markdown-indeling. Voeg een Markdown-bestand toe aan uw lokale vertakking voor elke pagina en subpagina die u wilt toevoegen aan uw wiki.

Pagina's toevoegen

Als u pagina's wilt toevoegen aan de hoofdmap van de wikistructuur, voegt u een Markdown-bestand toe aan de hoofdmap van de Git-opslagplaats.

  1. Voor elke pagina die u wilt toevoegen, maakt u een Markdown-bestand met de pagina-inhoud en voegt u het vervolgens toe onder de hoofdmap voor uw opslagplaats.

    Voor het CanaryBuilds-teamproject bevindt het zich in de volgende map:

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

  2. Als u pagina's wilt toevoegen aan de hoofdmap van de wikistructuur, voegt u een Markdown-bestand toe voor elke pagina in de hoofdmap van de Git-opslagplaats.

    Git-opslagplaats voor lokale vertakking

  3. Nadat u alle pagina's hebt toegevoegd die u wilt toevoegen aan de hoofdmap, werkt u het .orderbestand bij in de hoofdmap. Het moet één vermelding hebben voor elk Markdown-bestand dat is gedefinieerd in de hoofdmap. Elke vermelding moet overeenkomen met de bestandstitel door spaties vervangen door een streepje.

    Voorbeeld:

     Welcome
 Roadmap  
 How-to-contribute  
 Home  
 Reference

Subpagina's toevoegen

  1. Maak een map voor de bovenliggende pagina en voeg markdown-bestanden toe voor elke subpagina in de map.

    We hebben bijvoorbeeld de volgende bestanden toegevoegd aan de map How-to-contribute. Deze subpagina's worden weergegeven onder de pagina Bijdragen in de wiki.

    Schermopname van de subpagina's.

  2. Voeg een .orderbestand toe aan de map met de volgorde van de subpagina's, zoals ze moeten worden weergegeven in de wiki. Zie Wiki Git-opslagplaatsbestanden en -bestandsstructuur voor meer informatie over het gebruik van het .orderbestand om pagina's te orden.

    Het bestand heeft bijvoorbeeld de volgende subpagina's:

     Request-extensions  
 Licensing  
 Smoke-test  
 Coding-guidelines

Uw wijzigingen pushen

Wanneer u klaar bent met al uw updates, pusht u de bestanden naar de Git-opslagplaats.

De toegevoegde pagina's en subpagina's worden direct in uw wiki weergegeven.

Wikistructuur bijgewerkt

Als er fouten zijn in het proces, worden de pagina's in uw wiki weergegeven met een waarschuwingsteken.

Waarschuwing wanneer het .orderbestand niet correct wordt bijgewerkt.