Wiki aprovisionada frente a publicada como wiki de código
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Puede mantener el contenido wiki en una wiki del proyecto de equipo o en un wiki publicado como wiki de código. Con una wiki de código publicada, puede mantener varias wikis con versiones para admitir sus necesidades de contenido, aunque solo está disponible si Azure Repos está habilitado.
Aunque ambas opciones mantienen el contenido wiki en los repositorios de Git, la forma de agregar, actualizar y administrar el contenido wiki difiere.
Nota:
La característica wiki publicada como código está disponible actualmente en Azure DevOps Server 2018 y versiones posteriores. Para versiones anteriores, solo puede aprovisionar una wiki para el proyecto de equipo.
Opciones de menú de página wiki
Con una wiki aprovisionada, puede agregar y editar páginas directamente dentro de la wiki. Todas las actualizaciones de contenido de una wiki aprovisionada se producen dentro de la wiki.
Con una wiki de código publicada, puede agregar, editar y actualizar contenido desde repositorios o código.
En la imagen siguiente se muestran las opciones de una wiki aprovisionada. No se admiten varias de estas opciones para las páginas wiki publicadas como código.
Por ejemplo, la opción Editar en repositorios para la wiki de código publicada le lleva a la página Repositorio para editar esa página específica. Las actualizaciones que realice en una página de la rama seleccionada para la wiki se publicarán automáticamente en la wiki.
Características admitidas y diferencias operativas
Ambos tipos de wiki admiten las siguientes características:
- Formato Markdown
- Etiquetas HTML
- Insertar y cambiar el tamaño de las imágenes
- Notación matemática y caracteres
- Vínculo a elementos de trabajo mediante #
- Adjuntar archivos
- Filtrar el contenido de wiki
- Imprimir una página Wiki
- Actualizar contenido sin conexión
- Agregar o editar páginas desde la Wiki
En la tabla siguiente se resumen esas operaciones o características que pueden diferir, en función del tipo wiki.
| Operación | Wiki aprovisionada | Publicado como wiki de código |
|---|---|---|
| Compatibilidad con varias wikis, wiki de nombres | ✔️ | |
| Agregar o editar páginas desde archivos de repositorios>o archivos de código> | ✔️ | |
| Revertir a una revisión anterior de la Wiki | ✔️ | |
| Revertir a una revisión anterior de repositorios o código | ✔️ | ✔️ |
| Mantenimiento de wikis con versiones | ✔️ | |
| Selección de una versión wiki | ✔️ | |
| Anulación de la publicación de una wiki de código | ✔️ |
Agregar páginas
Para ambos tipos de wiki, seleccione Nueva página o Agregar subpágina. Para obtener más información, vea Agregar y editar páginas wiki.
Secuencia de páginas y lista de páginas en el panel de navegación
La wiki aprovisionada administra automáticamente la secuencia de páginas y la lista de páginas a medida que agrega o mueve páginas dentro del panel de navegación.
Para estructurar la lista de páginas en el panel de navegación de una wiki de código publicada, defina el *.order* archivo en la raíz y para cada subcarpeta o página principal que contenga subpáginas.
Ambos tipos de wikis siguen la misma estructura de archivos, es solo que el wiki publicado como código requiere que mantenga manualmente la secuencia de páginas.
Para obtener más información sobre cómo trabajar con .order archivos, consulte Wiki Git repository files and file structure (Archivos de repositorio de Git wiki y estructura de archivos).
Revisiones de página y reversión a una versión anterior
En la wiki, puede ver las revisiones de cualquier página wiki. Seleccione Revisiones o la opción de menú Ver revisiones .
Pero el proceso de reversión difiere en función del tipo de página wiki.
- Para una página wiki aprovisionada, seleccione Revertir, como se describe en Revertir una confirmación a una página wiki aprovisionada.
- Para una página wiki publicada como código, trabaje desde una rama local y envíe una solicitud de incorporación de cambios para actualizar la rama desde la que trabaja.
Control de versiones y anulación de la publicación de una wiki
Con el control de versiones, puede publicar diferentes versiones de contenido en wikis distintas, en función de una rama con versiones de un repositorio de Git. Solo puede publicar una wiki si es la que la creó mediante la publicación de código en una wiki. Para obtener más información, consulte Unpublish a code wiki.
Eliminar una wiki del proyecto
Nota:
Las API REST de wiki no admiten la eliminación de una wiki del proyecto. Por lo tanto, debe eliminar el repositorio wiki en su lugar.
Clone el repositorio wiki para realizar copias de seguridad de todo su contenido. Las opciones Más tienen la dirección URL de la wiki clonada, que se puede usar para clonar la wiki.
Obtenga el identificador del repositorio de Git que respalda la wiki. Puede usar la API REST para obtener todas las wikis del proyecto.
Por ejemplo,
GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1devuelve todas las wikis del proyecto, por lo que puede elegir cuál eliminar.Use la API REST para eliminar el repositorio de Git de respaldo. Use el identificador de repositorio de la wiki del proyecto que encontró en el paso anterior y compruebe el identificador del repositorio, por lo que no quita el incorrecto.
Por ejemplo:
DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/{repositoryId}?api-version=4.1
Actualizar una wiki sin conexión
Puede trabajar sin conexión o en una rama local para actualizar el contenido de una wiki aprovisionada y publicar como wiki de código. Para obtener más información, vea Clonar y actualizar páginas wiki sin conexión.