Wikis aprovisionadas frente a código publicado como wiki
Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018
En Azure DevOps, tiene las siguientes opciones para mantener el contenido wiki.
- Aprovisione una wiki para el proyecto de equipo. Esta opción solo admite una wiki para el proyecto de equipo.
- Publique los archivos Markdown definidos en un repositorio git en una wiki. Con esta opción, puede mantener varias wikis con versiones para satisfacer 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 manera de agregar, actualizar y administrar el contenido de la wiki difiere.
Nota
La característica publicar código como wiki está disponible actualmente en Azure DevOps Server 2018 y versiones posteriores. Para las versiones anteriores, solo puede aprovisionar una wiki para el proyecto de equipo.
Opciones de menú de la página Wiki
Con una wiki aprovisionada,puede agregar y editar páginas directamente dentro dewiki. Todas las actualizaciones de contenido de una wiki aprovisionada se producen en la wiki.
Con un código de publicación como wiki, agrega, edita y actualiza contenido desde Repos o Code.
Las opciones de menú no disponibles para las páginas wiki se muestran en la ilustración siguiente. Como puede ver, no se admiten varias opciones para la publicación como páginas wiki de código.
Wiki aprovisionada
Publicación de código como wiki
Por ejemplo, la opción Editar en Repos para el código de publicación como wiki 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 que seleccionó para la wiki se publicarán automáticamente en la wiki.
Características admitidas y diferencias operativas
Las wikis aprovisionadas ylas wikis de publicación como código admiten las siguientes características:
- Formato markdown
- Etiquetas HTML
- Inserción y cambio de tamaño de imágenes
- Notación matemática y caracteres
- Vínculo a elementos de trabajo mediante #
- Adjuntar archivos
- Filtrado del contenido de wiki
- Imprimir una página Wiki
- Actualización del contenido sin conexión
- Adición o edición de páginas desde la wiki
En la tabla siguiente se resumen las operaciones o características que pueden diferir, según el tipo de wiki.
| Operación | Wiki aprovisionada | Publicación de código como wiki |
|---|---|---|
| Compatibilidad con varias wikis, nombre wiki | ✔️ | |
| Agregar o editar páginas desde Reposoarchivos decódigo | ✔️ | |
| Revertir a una revisión anterior desde la wiki | ✔️ | |
| Revertir a una revisión anterior desde Repos o Código | ✔️ | ✔️ |
| Mantenimiento de wikis con control de versiones | ✔️ | |
| Selección de una versión de wiki | ✔️ | |
| Anular la publicación de una wiki | ✔️ |
Agregar páginas
Para una wiki aprovisionada opublicar código como wiki,seleccione Nueva página o Agregar subpágina. Para más información, consulte Adición y edición de páginas wiki.
Secuencia de página y lista de páginas en el panel de navegación
La wiki aprovisionada administra la secuencia de páginas y la lista de páginas automáticamente 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 un código de publicación como wiki,defina el archivo .order en la raíz y para cada subcarpeta o página primaria que contenga subpáginas.
Ambos tipos de wikis siguen la misma estructura de archivos, solo que el código de publicación como wiki requiere que mantenga la secuencia de páginas manualmente.
Para más información sobre cómo trabajar con archivos .order, consulte Wiki Git repository files and file structure (Archivos de repositorio y estructura de archivos de Git de Wiki).
Revisiones de página y reversión a una versión anterior
En la wiki,puede ver las revisiones de cualquier página wiki eligiendo Revisiones o seleccionando la opción de menú Ver revisiones.
Sin embargo, 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 de publicación como código, trabaje desde una rama local y envíe una solicitud de extracción para actualizar la rama desde la que está trabajando.
Control de versiones y despublicación de una wiki
Con el control de versiones, puede publicar diferentes versiones de contenido en distintas wikis, en función de una rama con versiones de un repositorio de Git. El control de versiones y la publicación de contenido que ha publicado previamente en una wiki solo se admite para las wikis que ha creado mediante la publicación de código en una wiki.
Para más información, consulte Versión, selección o anular la publicación de una wiki publicada.
Eliminar wiki del proyecto
La eliminación de una wiki de proyecto no es compatible con las API de wiki, pero puede eliminar el repositorio wiki siguiendo estos pasos.
Clone el repositorio wiki para realizar una copia de seguridad de todo su contenido. Seleccione el menú contextual y, a continuación, seleccione Clone wiki (Clonar wiki),copiando la dirección URL de clonación.
Obtenga el identificador del repositorio de Git que está detrás de esta wiki. Use esta API REST para obtener todos los wikis del proyecto.
Por ejemplo: GET https://dev.azure.com/fabrikam/_apis/wiki/wikis?api-version=4.1 Devuelve todos los wikis del proyecto, "sampleProject". Aquí puede obtener el identificador del repositorio de la wiki que desea eliminar.
Use la siguiente API rest para eliminar el repositorio de Git.
Por ejemplo: DELETE https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}?api-version=4.1 Use el identificador del repositorio de la wiki del proyecto que se encontró con el paso anterior. Asegúrese de que el identificador del repositorio coincide con la wiki del proyecto que desea quitar.
Actualización de una wiki trabajando 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 más información, consulte Clonar y actualizar páginas wiki sin conexión.