Wiki aprovisionada frente a publicada como wiki de código

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

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 versionadas para satisfacer sus necesidades de contenido. Esta opción está disponible al habilitar Azure Repos.

Aunque ambas opciones mantienen el contenido wiki en los repositorios de Git, la forma de agregar, actualizar y administrar el contenido wiki difiere.

Mantener contenido wiki

Para ambos tipos de wiki, puede trabajar directamente en GitHub o trabajar sin conexión y, a continuación, insertar los cambios en el repositorio.

Para una wiki aprovisionada, agrega y mantiene páginas wiki directamente dentro de la sección Páginas wiki> del repositorio. Todas las actualizaciones de contenido de una wiki aprovisionada se producen dentro de la propia wiki.

Para una wiki publicada como código, añade y mantiene el contenido de la wiki como archivos de código en el repositorio. Puede acceder a los archivos dentro de las secciones Repositorios o Código del repositorio en GitHub.

En la imagen siguiente se muestran las opciones de menú de una wiki aprovisionada:

Algunas opciones de menú no se admiten para las páginas publicadas como wiki de código. Para una wiki de código publicada como, la opción Editar en Repos abre la página actual, de modo que puede editar el contenido directamente. Las actualizaciones que realice en una página de la rama seleccionada para la wiki se publican automáticamente en la wiki.

Agregar páginas wiki

Las opciones de menú Nueva página y Agregar subpágina están disponibles para ambos tipos de wiki en GitHub. Para obtener más información, vea Agregar y editar páginas wiki.

Ajustar la secuencia de páginas y la lista de páginas

Ambos tipos de wiki aplican la misma estructura de carpetas y archivos dentro del repositorio de Git. La diferencia es cómo se mantiene la secuencia de páginas.

Para una wiki aprovisionada, GitHub 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 una publicada como wiki de código, debe mantener la secuencia de páginas manualmente. Para estructurar la lista de páginas en el panel de navegación, defina un archivo .order en la raíz y para cada subcarpeta o página principal que contenga subpáginas. Para obtener más información, consulte Wiki Git repository files and file structure (Archivos de repositorio de Git wiki y estructura de archivos).

Ver revisiones de página y revertir a una versión anterior

En la página Wiki del repositorio de Git, puede ver las revisiones de cualquier página dentro de la wiki. Use las opciones de menú Revisiones o Ver revisiones . Para revertir el contenido de la página actual a una versión anterior, el proceso difiere en función del tipo de página wiki.

Para una página wiki aprovisionada , seleccione la opción de menú Revertir . Para obtener más información, consulte Revertir una confirmación en una página wiki aprovisionada.

Para una página wiki publicada como código, trabajas desde una rama local y envías una solicitud de incorporación de cambios para actualizar la rama desde la que estás trabajando.

Uso del control de versiones y despublicar la wiki

La compatibilidad con el control de versiones permite publicar diferentes versiones de contenido en wikis distintas, en función de una rama con versiones de un repositorio de Git.

Solo puede versionar y despublicar la wiki si es el usuario que publicó el código para crearla. Para obtener más información, consulte Unpublish a code wiki.

Eliminar wiki del proyecto

En los pasos siguientes se describe cómo eliminar una wiki del proyecto.

1. Clone el repositorio wiki para realizar una copia de seguridad de todo el contenido. Puede encontrar la dirección URL de wiki en el menú Más opciones (...).

2. Obtenga el identificador del repositorio de Git asociado a la wiki. Puede usar la API REST para obtener todas las wikis del proyecto.

   Por ejemplo, el GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 comando devuelve todas las wikis del proyecto. Ejecute el comando y elija la wiki que desea eliminar.

3. Elimine el repositorio de Git asociado a la wiki mediante la API REST. Use el identificador de repositorio de la wiki del proyecto que encontró anteriormente. Compruebe el identificador del repositorio para asegurarse de que no quite la wiki incorrecta.

   Por ejemplo, el DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/<repositoryId>?api-version=4.1 comando elimina la wiki. Reemplace por <repositoryId> el identificador de repositorio de la wiki que se va a eliminar.

Actualizar wiki mientras está sin conexión

Puede trabajar sin conexión o en una rama local para actualizar el contenido de ambos tipos de wiki. Para obtener más información, vea Clonar y actualizar páginas wiki sin conexión.

Exploración de otras características y operaciones

Ambos tipos de wiki admiten otras características y operaciones:

• Formato Markdown
• Etiquetas HTML
• Insertar y cambiar el tamaño de las imágenes
• Notación matemática y caracteres
• Vínculo a elementos con etiqueta hash (#)
• 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

Algunas operaciones y características solo están disponibles para un tipo de wiki o el enfoque de uso difiere:

Contenido relacionado

• Creación de una wiki para el proyecto de equipo
• Archivos de repositorio y estructura de archivos de Git wiki
• Publicación de un repositorio de Git en una wiki