Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
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 .
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 :
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:
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.
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:
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.
Verbroken koppelingen herstellen na verplaatsingen van pagina's
Als u een verbroken koppeling wilt herstellen nadat u een pagina in de wikireeks hebt verplaatst, voert u de volgende stappen uit:
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.
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.
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.
Sla uw wijzigingen op de pagina op, zodat de koppeling wordt bijgewerkt.
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.
Selecteer de pagina die u wilt verplaatsen in de lijst met wikipagina's.
Meer opties selecteren (...) >Verplaatsen, waarmee het dialoogvenster Pagina verplaatsen wordt geopend.
Selecteer in het dialoogvenster Pagina verplaatsen de pagina die u wilt gebruiken als de nieuwe bovenliggende pagina.
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:
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.