Wiki-inhoud offline klonen en bijwerken

2025-06-06

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

Het proces voor het offline bijwerken van wiki is hetzelfde als het ontwikkelen van code in een Git-opslagplaats. U kunt uw favoriete client en git-opdrachtregelprogramma's gebruiken om uw wikipagina's offline bij te werken. Zie de Git-documentatie voor Azure-opslagplaatsen voor meer informatie over het werken met Git-opslagplaatsen en ondersteunde hulpprogramma's.

De basisstappen voor het offline bijwerken van wiki-inhoud zijn onder andere:

Kloon uw Wiki Git-opslagplaats naar uw lokale IDE (Interactive Development Environment) of werkruimte.
Voeg bestanden of mappen toe aan uw lokale Git-opslagplaatsvertakking.
Werk de .orderbestanden bij om de volgordewijzigingen voor pagina's en subpagina's weer te geven.
Voer de updates door en push deze naar uw lokale Git-vertakking.

Vereisten

Categorie	Eisen
projecttoegang	Lid van het project waar de wiki's zich bevinden. U kunt indien nodig toegang aanvragen bij de projectbeheerder.
machtigingen	- Lid van de inzenders groep. - Om code als wiki te publiceren, hebt u de machtiging 'Opslagplaats aanmaken' nodig. Deze machtiging is standaard ingesteld voor leden van de groep Projectbeheerders.
Toegangsniveaus	Ten minste Toegang tot Basic.
taken	- De onderliggende structuur van uw Git-opslagplaats voor wiki's begrijpen. - Inzicht in de verschillen tussen een ingerichte wiki en een gepubliceerde code als wiki.

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.

Meld u aan bij uw project (https://dev.azure.com/<Organization>/<Project>).
Selecteer uw wiki, selecteer Meer acties (...) >Wiki klonen:

Schermopname die laat zien hoe je de optie Meer opties kunt selecteren en vervolgens de Git-actie Wiki klonen voor de geselecteerde wiki.
Selecteer in het dialoogvenster Opslagplaats klonen het pictogram 'Kloon-URL naar klembord kopiëren':
Plak de URL in uw browser. De git-opslagplaatspagina wordt geopend, waar u de bestanden kunt bekijken die zijn gedefinieerd onder de wikiMain-vertakking. In het volgende voorbeeld ziet u de bestanden in de Git-opslagplaats voor het CanaryBuilds-project:

Belangrijk

De functie Git-referenties genereren is gepland voor verwijdering. Raadpleeg de Documentatie voor Git-verificatie voor alle verificatiemethoden die voor u beschikbaar zijn voor git-kloonbewerkingen.
Gebruik de URL die u hebt gekopieerd om de opslagplaats te klonen in uw favoriete IDE. Zie de volgende artikelen voor meer informatie:

Pagina's toevoegen aan uw lokale Git-opslagplaats

Git-opslagplaatspagina's zijn opgemaakt als Markdown-bestanden (.md). Voor elke pagina die u aan uw wiki wilt toevoegen, maakt u een Markdown-bestand in uw lokale vertakking. Nadat u pagina's hebt toegevoegd, werkt u het .orderbestand bij om de paginavolgorde aan te passen om de nieuwe pagina's op te nemen.

Pagina's toevoegen

U kunt pagina's boven aan de wikistructuur toevoegen in de hoofdmap (\) en ook in andere mappen.

Maak het Markdown-bestand (.md) met de inhoud voor de nieuwe pagina. In de meeste gevallen komt de bestandsnaam overeen met de paginatitel. Vervang in de bestandsnaam eventuele spaties in de titel door afbreekstreepjes (-). Zie Een wikipagina toevoegen voor meer informatie over het maken van pagina-inhoud.
Plaats het bestand in de gewenste map in de wikistructuur in uw lokale vertakking, zoals de hoofdmap. De hoofdmap van het CanaryBuilds-project is C:\Users\UserName\Source\Repos\CanaryBuilds.wiki.
Werk het .orderbestand bij in dezelfde map waarin u het nieuwe paginabestand hebt geplaatst. De invoertekst voor de pagina is de bestandsnaam zonder de Markdown-extensie (.md). In het project CanaryBuilds wordt de nieuwe pagina 'Hoe bij te dragen' toegevoegd, die overeenkomt met de invoertekst How-to-contribute:
```
Welcome
Roadmap  
How-to-contribute  
Home  
Reference  
```
Zie Paginareeks en het .orderbestand voor meer informatie over het .orderbestand.

Subpagina's toevoegen

U kunt ook subpagina's maken voor een pagina in uw wiki:

Maak een map die moet fungeren als de bovenliggende pagina. Zie Opslagplaatsbestanden en mapstructuur voor meer informatie.
Maak het Markdown-bestand voor elke subpagina en plaats het bestand in de hoofdmap van de hoofdpagina. In het voorbeeld van het CanaryBuilds-project wordt de map How-to-contribute toegevoegd als de bovenliggende pagina:
Maak een .orderbestand in de bovenliggende paginamap om de volgorde voor de subpagina's te definiëren, zoals ze in de wiki moeten worden weergegeven. In het voorbeeld ziet u een mogelijke volgorde van subpagina's:
```
Request-extensions  
Licensing  
Smoke-test  
Coding-guidelines  
```

Uw wijzigingen pushen

Wanneer uw lokale updates gereed zijn, pusht u de bestanden naar de Git-opslagplaats.

De toegevoegde pagina's en subpagina's worden direct in uw wiki weergegeven. In het volgende voorbeeld ziet u de updates voor het CanaryBuilds-project:

Schermopname van de bijgewerkte wikistructuur voor het CanaryBuilds-project.

Als er fouten zijn opgetreden tijdens het proces, wordt de pagina weergegeven in de lijst met wikibestanden met een waarschuwingssymbool:

Schermopname van een pagina met een fout zoals aangegeven met het waarschuwingssymbool.

Delen via