Delen via


Wikipagina's toevoegen en bewerken

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

Nadat u een Wiki Git-opslagplaats voor uw teamproject hebt ingesteld, kunt u een titel toevoegen voor de wiki- en pagina-inhoud. De Gebruikersinterface van Azure DevOps biedt een ervaring naast elkaar waar u pagina's kunt bewerken en een voorbeeld van uw wijzigingen kunt bekijken terwijl u werkt.

In het deelvenster Bewerken voert u pagina-inhoud in met de syntaxis van de Markdown-indeling. U kunt ook afbeeldingen, bijlagen en koppelingen invoegen. Wanneer u wijzigingen aanbrengt, worden de inhoudsupdates in het voorbeeldvenster bijgewerkt. Inhoud met speciale opmaak, zoals koppen, lijsten, koppelingen en afbeeldingen, worden weergegeven als tekst met opmaak in het voorbeeldvenster .

Schermopname van de wiki-startpagina in Azure DevOps met de ervaring naast elkaar waar u pagina-inhoud kunt bewerken en tegelijkertijd een voorbeeld van uw wijzigingen kunt bekijken.

Terwijl u de pagina bewerkt, gebruikt u de sneltoets Ctrl+S om uw werk snel op te slaan. U kunt uw werk ook opslaan met een aangepast revisiebericht, zoals 'Paginakoppelingen toegevoegd'. Deze optie is beschikbaar in het vervolgkeuzemenu Opslaan :

Schermopname van het selecteren van de optie Opslaan met revisiebericht in Azure DevOps.

Er zijn andere sneltoetsen beschikbaar. Zie Sneltoetsen voor het beheren van wikipagina's voor meer informatie.

Notitie

In dit artikel wordt beschreven hoe u pagina's toevoegt en bewerkt in een wiki die is gemaakt voor een teamproject. Als u pagina's wilt toevoegen aan of bewerken aan een wiki die is gepubliceerd vanuit een Git-opslagplaats, raadpleegt u Een Git-opslagplaats publiceren naar een wiki.

Wiki-opdrachtregelprogramma's

U kunt Azure DevOps CLI-opdrachten gebruiken om uw wiki-inhoud te beheren. De volgende tabel bevat koppelingen naar secties in dit artikel waarin wordt beschreven hoe u met specifieke opdrachten kunt werken.

Opdracht Beschrijving
az devops wiki show Open de wiki en geef de startpagina van de wiki weer.
az devops wiki pagina tonen Een specifieke pagina weergeven in de wiki.
az devops wiki pagina maken Voeg een nieuwe pagina toe aan de wiki.
Bijwerken van de wiki-pagina in Azure DevOps Een bestaande pagina in de wiki bewerken.
az devops wiki pagina verwijderen Een pagina in de wiki verwijderen.

Vereisten

Categorie Eisen
projecttoegang Lid van het project waar de wiki zich bevindt. U kunt indien nodig toegang aanvragen bij de projectbeheerder.
Machtigingen Lid van de Inzenders groep.
Toegangsniveaus Ten minste Basis toegang.
taken Bereid een ingerichte wiki voor uw project voor.

De wiki openen

U kunt de wikipagina voor uw teamproject openen en weergeven vanuit Azure DevOps in de browser of de Azure DevOps CLI gebruiken.

Maak verbinding met uw project met behulp van een ondersteunde webbrowser en selecteer Wiki:

Schermopname van een wiki die is geopend in de browser en de wikioverzichtspagina weergeeft.

Als u van teamproject wilt wisselen, selecteert u Azure DevOps om door alle teamprojecten en teams te bladeren.

Een wikipagina toevoegen

In deze sectie wordt beschreven hoe u een pagina toevoegt aan uw wiki. U kunt rechtstreeks met de Gebruikersinterface van Azure DevOps werken in de browser of de Azure DevOps CLI gebruiken.

Als u een nieuwe pagina wilt toevoegen aan uw wiki, hebt u twee opties. Selecteer eerst een pagina in de lijst, zoals de startpagina.

  • Als u een pagina op hetzelfde niveau als de huidige pagina wilt toevoegen, selecteert u Nieuwe pagina onder aan de Azure DevOps-gebruikersinterface.

  • Als u een subpagina wilt toevoegen aan de huidige pagina, selecteert u Meer opties (...) >Subpagina toevoegen.

Schermopname die laat zien hoe u een nieuwe pagina of nieuwe subpagina toevoegt aan een wiki in Azure DevOps.

U kunt ook sneltoetsen gebruiken om pagina's toe te voegen. Selecteer de huidige pagina en voeg een nieuwe pagina toe door n te selecteren of een subpagina toe te voegen door c te selecteren. Zie Sneltoetsen voor het beheren van wikipagina's voor meer informatie.

Paginatitel en bestandsnaam

Voer een unieke titel in voor de pagina. De waarde is hoofdlettergevoelig. De titel wordt gebruikt als bestandsnaam voor de pagina. In de bestandsnaam worden spaties in de paginatitel vervangen door afbreekstreepjes (-). De paginatitel 'Hoe bij te dragen' komt bijvoorbeeld overeen met de bestandsnaam How-to-contribute.md. Het volledig gekwalificeerde pad naar het bestand moet 235 tekens of minder zijn.

Zie Wiki Git-opslagplaatsbestanden en bestandsstructuur, naamconventies voor bestandsnamen voor andere beperkingen voor bestandsnaam.

Beperkingen voor paginatitel en bestandsnaam

Elke wikipagina komt overeen met een bestand in de Git-opslagplaats van de wiki. De volgende beperkingen gelden voor paginabestandsnamen en de bestandsgrootte:

  • Bestandsnaam: Houd er rekening mee dat bij het kiezen van een naam voor het paginabestand het volledig gekwalificeerde pad naar het bestand 235 tekens of minder moet zijn. Het volledige pad naar de pagina bestaat uit de URL van de opslagplaats, het mappad naar het paginabestand en de naam van het paginabestand. Bijvoorbeeld: https://github.com/ExampleWiki/Contributors/Code/How-to-add-code-to-the-project.md.

  • Uniekheid: de naam van het paginabestand moet uniek zijn binnen de maplocatie in de wikiopslagplaatshiĆ«rarchie. De naam is hoofdlettergevoelig.

  • Speciale tekens: De bestandsnaam van de pagina heeft beperkingen voor de volgende speciale tekens:

    • Geen Unicode-besturingstekens of surrogaattekens
    • Geen afdrukbare tekens: slash /, back-slash \, hash #
    • Geen puntsymbool . aan het begin of einde van de naam
  • Bestandsgrootte: de maximale grootte van het paginabestand is 18 MB.

  • Grootte van bijlagebestand: de maximale grootte voor bijlagen bij een paginabestand is 19 MB.

Toegestane speciale tekens

Er zijn verschillende speciale tekens toegestaan in een paginabestandsnaam, zoals de dubbele punt : en het afbreekstreepje -. U kunt bijvoorbeeld een Markdown-bestand een naam geven als veelgestelde vragen:0525 of installatiehandleiding.

Belangrijk

Als u fouten in paginasyntaxis en browsernavigatie wilt voorkomen, gebruikt u het spatieteken ( ) niet in de namen van paginabestanden. Als u de paginabestanden een naam opgeeft op basis van de paginatitel, vervangt u spaties in de paginatitel door een afbreekstreepje (-) in de bestandsnaam.

De volgende tabel bevat de speciale tekens die zijn toegestaan in de namen van wikipaginabestanden en de bijbehorende URI-gecodeerde tekenreeks:

Karakter Symbool URI-tekenreeks
Dikke darm : %3A
Vierkante haak links < %3C
Rechte hoekhaak > %3E
Sterretje (jokerteken) * %2A
Vraagteken ? %3F
Pijp | %7C
Afbreekstreepje (streepje) - %2D
Dubbele aanhalingstekens " 22%

De bestandsnaam FAQ:0525 wordt bijvoorbeeld gecodeerd als FAQ%3A0525.

De startpagina van de wiki instellen

De eerste pagina die u toevoegt wanneer u een wiki maakt, wordt standaard ingesteld als de startpagina van de wiki. U kunt de startpagina van uw wiki wijzigen als een andere pagina relevanter wordt. Zie Wikipagina's opnieuw ordenen of verplaatsen voor meer informatie.

Wikipagina's bewerken en verwijderen

In deze sectie wordt beschreven hoe u een pagina in uw wiki bewerkt of verwijdert. U kunt rechtstreeks met de Gebruikersinterface van Azure DevOps werken in de browser of de Azure DevOps CLI gebruiken.

Er zijn verschillende manieren om een bestaande wikipagina in de browser te bewerken:

  • Open de wikipagina en selecteer Bewerken.
  • Open de wikipagina en gebruik de sneltoets e.
  • Selecteer de wikipagina in de paginalijst en selecteer vervolgens Meer opties (...) >Bewerken.

Zie Markdown-richtlijnen gebruiken voor meer informatie over specifieke bewerkingsfuncties.

Bewerken in opslagplaatsen voor codewiki's

Wanneer u code publiceert als wiki, kunt u de wikipagina's bewerken in de hub Repos. Dezelfde side-by-side editorervaring is beschikbaar met de opmaakopties van de Markdown-werkbalk. Selecteer Bewerken>Bewerken in opslagplaatsen om een vertakking te maken en door te gaan met bewerken:

Schermopname van het selecteren van de optie Bewerken in opslagplaatsen in Azure DevOps.

De optie Bewerken in Repositories is alleen beschikbaar voor codewiki's waarvoor het vertakkingsbeleid is ingeschakeld. Als u de optie niet ziet, kan dat zijn omdat uw wiki geen codewiki is of omdat vertakkingsbeleid niet is ingeschakeld. Zie Vertakkingsbeleid en -instellingen voor meer informatie.

Wikipagina verwijderen in de browser

Als u een wikipagina wilt verwijderen, selecteert u de wikipagina in de paginalijst en selecteert u vervolgens Meer opties (...) >Verwijderen. U kunt ook Verwijderen selecteren in het contextmenu voor de pagina.

Nadat u Verwijderen hebt geselecteerd, bevestigt u de verwijdering in het dialoogvenster.

Notitie

Wanneer u een wikipagina verwijdert, verwijdert u ook alle metagegevens voor de pagina en eventuele subpagina's die aan de pagina zijn gekoppeld.

Wikipagina's opnieuw ordenen of verplaatsen

In de browser kunt u pagina's in de wikistructuurweergave opnieuw ordenen, zodat de pagina's worden weergegeven in de volgorde van uw voorkeur. De standaardvolgorde is alfabetisch op bestandsnaam. U kunt de volgorde wijzigen om pagina's opnieuw te ordenen op artikel, categorie of beoogde doelgroep.

U kunt de actie slepen en neerzetten op paginatitels in de structuurweergave gebruiken om de volgende taken uit te voeren:

  • Verplaatsen: De pagina-/subpaginarelatie van een pagina wijzigen. Als u een pagina binnen de wikireeks verplaatst, kunnen koppelingen naar de pagina van andere wikipagina's worden verbroken. U kunt deze koppelingen handmatig herstellen nadat u de pagina hebt verplaatst.

  • Volgorde wijzigen: Wijzig de volgorde van een pagina in de wikireeks. Het opnieuw ordenen van pagina's in de wikireeks heeft geen invloed op paginakoppelingen.

Als u een verbroken koppeling wilt herstellen nadat u een pagina in de wikireeks hebt verplaatst, voert u de volgende stappen uit:

  1. Test de andere pagina's in uw wiki en zoek naar koppelingen naar de verplaatste pagina.

    Controleer op foutberichten op de pagina of ontbrekende inhoud.

  2. Open de pagina met een verbroken koppeling, selecteer Bewerken en ga naar de verbroken koppeling in de pagina-inhoud.

    Als u de verbroken koppeling in de inhoud wilt vinden, kunt u zoeken naar de naam van de verplaatste pagina, het oorspronkelijke bestandspad van de verplaatste pagina of de koppelingstekst voor de verbroken koppeling.

  3. Werk de verbroken koppeling bij. De gebruikelijke oplossing is het wijzigen van de URL of het pad in de koppeling om de nieuwe locatie voor de verplaatste pagina te targeten.

  4. Sla uw wijzigingen op de pagina op, zodat de koppeling wordt bijgewerkt.

  5. Open de bijgewerkte pagina in de browser en test de koppeling. Bevestig dat de verplaatste pagina is geopend.

Volgorde van pagina's op het hoogste niveau wijzigen

U kunt sneltoetsen gebruiken om pagina's op het hoogste niveau opnieuw te ordenen in de wikireeks. Deze actie werkt niet voor subpagina's.

Selecteer een pagina in de wikipaginalijst en gebruik de sneltoets CTRL + PIJL-OMHOOG of CTRL + PIJL-OMLAAG om de pagina binnen de reeks te verplaatsen. De wijziging is onmiddellijk van toepassing.

Pagina-/subpaginavolgorde wijzigen

U kunt ook de volgorde van de pagina/subpagina wijzigen voor elke pagina in de wikireeks.

  1. Selecteer de pagina die u wilt verplaatsen in de lijst met wikipagina's.

  2. Meer opties selecteren (...) >Verplaatsen, waarmee het dialoogvenster Pagina verplaatsen wordt geopend.

  3. Selecteer in het dialoogvenster Pagina verplaatsen de pagina die u wilt gebruiken als de nieuwe bovenliggende pagina.

    Schermopname die laat zien hoe u een wikipagina verplaatst, zodat deze een subpagina van een andere pagina in de reeks wordt.

  4. Nadat u de nieuwe bovenliggende pagina hebt geselecteerd, scant het systeem op mogelijke verbroken koppelingen op basis van de verplaatsing van de pagina. Er worden de koppelingen gerapporteerd die moeten worden aangepast:

    Schermopname die laat zien hoe u het systeem paginakoppelingen laat aanpassen die worden veroorzaakt door een pagina-verplaatsing in de wikireeks.

  5. Selecteer de optie Links bijwerken in pagina's en werkitems (aanbevolen) en selecteer vervolgens Verplaatsen om de pagina te voltooien.

Zie Sneltoetsen voor het beheren van wikipagina's voor een volledige lijst met sneltoetsen.