Delen via

Ingerichte wiki versus gepubliceerd als codewiki

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

U kunt uw wiki-inhoud in een teamprojectwiki of een gepubliceerde als codewiki onderhouden. Met een als code gepubliceerde wiki kunt u verschillende versiewiki's onderhouden om aan uw inhoudsbehoeften te voldoen. Deze optie is beschikbaar wanneer u Azure-opslagplaatsen inschakelt.

Hoewel beide opties de wiki-inhoud in Git-opslagplaatsen behouden, verschilt de manier waarop u de wiki-inhoud toevoegt, bijwerkt en beheert.

Wiki-inhoud onderhouden

Voor beide typen wiki's kunt u rechtstreeks in GitHub werken of offline werken en vervolgens uw wijzigingen naar de opslagplaats pushen.

Voor een ingerichte wiki voegt u wikipagina's toe en onderhoudt u deze rechtstreeks binnen de sectie Wiki>Pagina's van de opslagplaats. Alle inhoudsupdates voor een ingerichte wiki vinden plaats in de wiki zelf.

Voor een als codewiki gepubliceerd project voegt u wiki-inhoud toe en onderhoudt u deze als codebestanden in de repository. U opent de bestanden in de secties Opslagplaatsen of Code van de opslagplaats op GitHub.

In de volgende afbeelding ziet u menuopties voor een ingerichte wiki:

Schermopname van menuopties die beschikbaar zijn voor een ingerichte wiki vanuit de sectie Wikipagina's.

Sommige menuopties worden niet ondersteund voor pagina's gepubliceerd als een code-wiki. Voor een gepubliceerd als codewiki opent de optie Bewerken in repositories de huidige pagina, zodat u de inhoud ter plekke kunt bewerken. Uw updates aan een pagina in de geselecteerde tak van de wiki worden automatisch naar de wiki gepubliceerd.

Wikipagina's toevoegen

De menuopties Nieuwe pagina en Subpagina toevoegen zijn beschikbaar voor beide typen wiki's in GitHub. Zie Wikipagina's toevoegen en bewerken voor meer informatie.

Paginareeks en paginalijst aanpassen

Beide typen wiki passen dezelfde map en bestandsstructuur toe in de Git-opslagplaats. Het verschil is hoe u de paginareeks onderhoudt.

Voor een ingerichte wiki beheert GitHub de paginareeks en paginalijst automatisch wanneer u pagina's toevoegt of verplaatst in het navigatiedeelvenster.

Voor een gepubliceerde codewiki moet u de paginavolgorde handmatig bijhouden. Als u de lijst met pagina's in het navigatiedeelvenster wilt structuren, definieert u een .orderbestand in de hoofdmap en voor elke submap of bovenliggende pagina die subpagina's bevat. Zie Wiki Git-opslagplaatsbestanden en -bestandsstructuur voor meer informatie.

Paginarevisies weergeven en terugkeren naar een eerdere versie

Op de Wiki-pagina voor de Git-opslagplaats kunt u de revisies van elke pagina in de wiki bekijken. Gebruik de menuopties Revisies of Revisies weergeven . Het proces verschilt afhankelijk van het wikipaginatype om de huidige pagina-inhoud terug te keren naar een eerdere versie.

Voor een geprepareerde wikipagina selecteert u de menuoptie Herstellen. Zie Een commit ongedaan maken naar een geconfigureerde wikipagina voor meer informatie.

Voor een gepubliceerde wikipagina als code werkt u vanuit een lokale vertakking en verzendt u een pull-aanvraag om de vertakking van waaruit u werkt bij te werken.

Versiebeheer gebruiken en de publicatie van de wiki ongedaan maken

Met versiebeheerondersteuning kunt u verschillende inhoudsversies publiceren naar verschillende wiki's, op basis van een versievertakking van een Git-opslagplaats.

U kunt een wiki alleen versie geven en de publicatie ongedaan maken als u de gebruiker bent die de code heeft gepubliceerd om wiki te maken. Zie Publicatie van een codewiki ongedaan maken voor meer informatie.

Projectwiki verwijderen

In de volgende stappen wordt beschreven hoe u een projectwiki verwijdert.

Notitie

U kunt de REST API niet gebruiken om een projectwiki te verwijderen. Verwijder in plaats daarvan de wikiopslagplaats rechtstreeks.

  1. Kloon de wikiopslagplaats om een back-up te maken van alle inhoud. U vindt de wiki-URL in het menu Meer opties (...).

  2. Haal de Git-opslagplaats-id op die is gekoppeld aan uw wiki. U kunt de REST API gebruiken om alle wiki's in het project op te halen.

    Met de GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 opdracht worden bijvoorbeeld alle wiki's in het project geretourneerd. Voer de opdracht uit en kies de wiki die u wilt verwijderen.

  3. Verwijder de Git-opslagplaats die is gekoppeld aan uw wiki met behulp van de REST API. Gebruik de opslagplaats-id van de projectwiki die u eerder hebt gevonden. Controleer de opslagplaats-id om ervoor te zorgen dat u de verkeerde wiki niet verwijdert.

    Met de DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/<repositoryId>?api-version=4.1 opdracht wordt bijvoorbeeld de wiki verwijderd. Vervang door <repositoryId> de opslagplaats-id van de wiki die u wilt verwijderen.

Wiki bijwerken terwijl u offline bent

U kunt offline werken of in een lokaal verband om de inhoud voor beide typen wiki's bij te werken. Zie Wikipagina's offline klonen en bijwerken voor meer informatie.

Andere functies en bewerkingen verkennen

Beide typen wiki ondersteunen verschillende andere functies en bewerkingen:

Er zijn enkele bewerkingen en functies beschikbaar voor slechts één type wiki of de gebruiksbenadering verschilt:

Operatie Geconfigureerd Gepubliceerd als programmeercode
Ondersteuning voor meerdere wiki's, naamwiki ✔️
Pagina's toevoegen of bewerken vanuit Repos>Bestanden
of uit codebestanden>		 ✔️
Teruggaan naar eerdere revisie vanaf wikipagina ✔️
Teruggaan naar eerdere revisie vanuit opties voor repositories
of vanuit codeopties		 ✔️ ✔️
Geversioneerde wiki's onderhouden ✔️
Wikiversie selecteren ✔️
Publicatie van codewiki ongedaan maken ✔️

Verwante inhoud