Wikipagina's toevoegen en bewerken
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
U kunt een titel en inhoud toevoegen aan een pagina nadat de Git-opslagplaats voor wiki's is ingericht voor uw teamproject. Er is een side-by-side bewerkings- en voorbeeldervaring waar u de pagina kunt bewerken en een voorbeeld van de inhoud kunt bekijken terwijl u verdergaat.
Terwijl u pagina's ontwerpt met de Markdown-indeling, kunt u ook het opmaakvenster gebruiken voor opmaak met opmaak en het invoegen van afbeeldingen, bijlagen en koppelingen.
Wanneer u de pagina bewerkt, slaat u deze op door Ctrl+S in te voeren. Als u wilt opslaan met een aangepast revisiebericht, selecteert u naast Opslaan. Zie Sneltoetsen voor het beheren van wikipagina's voor meer sneltoetsen.
Wiki-opdrachtregelprogramma's
Opdracht | Beschrijving |
---|---|
az devops wiki show | Een wiki openen |
az devops wiki page show | De inhoud van een pagina ophalen of een pagina openen |
az devops wiki page create | Een nieuwe pagina toevoegen |
az devops wiki page update | Een pagina bewerken |
az devops wiki page delete | Een pagina verwijderen |
Notitie
Als u pagina's wilt toevoegen aan of bewerken aan een wiki die u hebt gepubliceerd vanuit een Git-opslagplaats, raadpleegt u Een Git-opslagplaats publiceren naar een wiki. Dit artikel bevat informatie over het toevoegen en bewerken van pagina's van een wiki die u hebt ingericht voor een teamproject.
Vereisten
- Een ingerichte wiki hebben.
- Wees lid van het teamproject als inzender om wikipagina's toe te voegen of bij te werken.
- Toegangsniveau Basic hebben om de projectwiki te bewerken.
De wiki openen
U kunt een wikipagina voor uw project openen en weergeven.
Maak verbinding met uw project via een ondersteunde webbrowser en kies Wiki.
Als u van teamproject wilt wisselen, kiest u Azure DevOps om door alle teamprojecten en teams te bladeren.
Een wikipagina toevoegen
Als u een andere pagina wilt toevoegen, kiest u Nieuwe pagina. Als u een subpagina wilt toevoegen, opent u het contextmenu van een bestaande pagina en selecteert u Subpagina toevoegen.
Geef een unieke titel van 235 tekens of minder op. Paginatitels zijn hoofdlettergevoelig. Zie Wiki Git-opslagplaatsbestanden en bestandsstructuur, naamconventies voor bestandsnamen voor andere titelbeperkingen.
U kunt ook sneltoetsen gebruiken om een nieuwe pagina toe te voegen door op n te drukken of een subpagina toe te voegen door op c te drukken. Zie Sneltoetsen voor het beheren van wikipagina's voor een volledige lijst met sneltoetsen.
Naamgevingsbeperkingen voor wikipagina's
Elke wikipagina komt overeen met een bestand in de Git-opslagplaats van de wiki. Namen die u aan een wikipaginatitel toewijst, moeten voldoen aan de volgende beperkingen.
Beperkingstype | Beperking |
---|---|
Bestandsnaam | Het volledig gekwalificeerde paginapad mag niet langer zijn dan 235 tekens. |
Uniciteit | Paginatitels zijn hoofdlettergevoelig en moeten uniek zijn binnen de wiki-hiërarchie. |
Speciale tekens | - Mag geen Unicode-besturingstekens of surrogaattekens bevatten. - Mag niet de volgende afdrukbare tekens bevatten: / \ # .- Mag niet beginnen of eindigen met een punt . . |
Bestandsgrootte | Mag niet groter zijn dan 18 MB. |
Bestandsnaam van bijlage | Mag niet groter zijn dan 19 MB. |
Speciale tekens in wikipaginatitels
U kunt paginatitels opgeven die een of meer van deze speciale tekens : < > * ? | -
bevatten. U kunt bijvoorbeeld een Markdown-bestand een naam geven als 'Veelgestelde vragen?' of 'Handleiding instellen'. De tekens hebben de volgende gecodeerde URI-tekenreeksen:
Teken | Gecodeerde tekenreeks |
---|---|
: |
%3A |
< |
%3C |
> |
%3E |
* |
%2A |
? |
%3F |
| |
%7C |
- |
%2D |
" |
22% |
Wikipagina's bewerken en verwijderen
Als u een bestaande wikipagina wilt bewerken, opent u de pagina en selecteert u Bewerken of opent u het contextmenu en selecteert u Bewerken. U kunt ook sneltoets e gebruiken om snel naar de bewerking van de huidige pagina te gaan. Zie Markdown-richtlijnen gebruiken voor meer informatie over specifieke bewerkingsfuncties.
Voor codewiki's kunt u een pagina bewerken in de editor naast elkaar, met behulp van de markdownwerkbalk om uw inhoud te maken. Deze ervaring is identiek aan het proces in een projectwiki. U kunt ook wikipagina's in de opslagplaatsenhub bewerken met behulp van de optie Bewerken in opslagplaatsen.
Selecteer Bewerken in opslagplaatsen om een vertakking te maken en door te gaan met bewerken. De knop Bewerken in opslagplaatsen is alleen beschikbaar voor codewiki's waarvoor vertakkingsbeleid is ingeschakeld. Als u de knop niet ziet, kan het zijn dat uw wiki geen codewiki of vertakkingsbeleid is ingeschakeld. Zie Vertakkingsbeleid en -instellingen voor meer informatie over vertakkingsbeleid.
Als u een pagina wilt verwijderen, opent u het contextmenu in de structuur of in de structuur en selecteert u Verwijderen. Bevestig de verwijdering in het dialoogvenster dat wordt geopend.
Notitie
Wanneer u een wikipagina verwijdert, verwijdert u ook alle metagegevens en eventuele subpagina's in de hiërarchie.
Een wikipagina opnieuw ordenen
U kunt de volgorde van pagina's in de wikistructuurweergave wijzigen zodat pagina's in de gewenste volgorde en hiërarchie worden weergegeven. U kunt een paginatitel slepen en neerzetten in de structuurweergave om de volgende bewerkingen uit te voeren:
- De relatie tussen bovenliggende en onderliggende items van een pagina wijzigen.
- Wijzig de volgorde van de pagina in de hiërarchie.
Notitie
Als u een pagina in de hiërarchie verplaatst, kunnen koppelingen van andere pagina's worden verbroken. U kunt deze koppelingen handmatig herstellen nadat u de pagina hebt verplaatst. Het opnieuw ordenen van een pagina in de hiërarchie heeft geen invloed op paginakoppelingen.
Handmatig een verbroken koppeling herstellen na het verplaatsen van een pagina
Als u handmatig een verbroken koppeling wilt herstellen nadat u een pagina in de hiërarchie hebt verplaatst, voert u de volgende stappen uit:
- Verbroken koppelingen identificeren:
- Ga naar de pagina's die oorspronkelijk zijn gekoppeld aan de verplaatste pagina.
- Zoek naar verbroken koppelingen, die kunnen worden weergegeven als fouten of ontbrekende inhoud.
- De koppelingspagina bewerken: Open de pagina met de verbroken koppeling in de bewerkingsmodus.
- Werk de koppeling bij:
- Zoek de verbroken koppeling in de inhoud.
- Werk de koppeling bij zodat deze verwijst naar de nieuwe locatie van de verplaatste pagina, waarbij doorgaans de URL of het pad in de koppeling moet worden gewijzigd.
- Wijzigingen opslaan: sla de wijzigingen op de pagina op om de bijgewerkte koppeling toe te passen.
- Controleer de oplossing: ga naar de bijgewerkte koppeling om ervoor te zorgen dat deze correct verwijst naar de verplaatste pagina.
Opmerking
Als u een pagina hebt verplaatst van /docs/old-path/page.md
naar /docs/new-path/page.md
, voert u de volgende stappen uit:
- Zoek de verbroken koppeling in de inhoud, zoals
Link to Page
. - Bewerk de koppeling naar het nieuwe pad:
Link to Page
. - Sla de wijzigingen op en controleer of de koppeling nu correct verwijst naar de nieuwe locatie.
Sneltoetsen gebruiken om pagina's opnieuw te ordenen
U kunt ook sneltoetsen gebruiken om pagina's opnieuw te ordenen. Selecteer een pagina en druk op Ctrl+Pijl-omhoog of Ctrl+Pijl-omlaag om paginavolgordes te wijzigen. Als u de relatie tussen bovenliggende en onderliggende items van een pagina wilt wijzigen, opent u het contextmenu en selecteert u Verplaatsen. Het dialoogvenster Pagina verplaatsen wordt geopend. Selecteer een bovenliggende pagina waaronder u de huidige pagina kunt verplaatsen.
Zie Sneltoetsen voor het beheren van wikipagina's voor een volledige lijst met sneltoetsen.
Een pagina maken op de startpagina van de wiki
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 door de pagina naar de bovenkant van de structuur te slepen en neer te plaatsen.