Clonación y actualización del contenido wiki sin conexión

  • Artículo

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

Puede actualizar las páginas wiki sin conexión de la misma manera en que desarrolla código en un repositorio de Git.

Puede usar cualquier cliente que quiera o las herramientas de línea de comandos de Git para actualizar la wiki sin conexión. Para más información sobre cómo trabajar con repositorios de Git y herramientas compatibles, consulte Repositorios de Git.

Los pasos básicos para actualizar el contenido wiki sin conexión son los siguientes:

  1. Clone el repositorio de Git wiki en el IDE o área de trabajo local.
  2. Agregue archivos o carpetas a la rama git local.
  3. Actualice los archivos .order para reflejar las páginas y subpáginas.
  4. Confirme e inserte las actualizaciones realizadas en la rama git local.

Requisitos previos

Realice los pasos siguientes para migrar páginas de Markdown de otra wiki al wiki del proyecto de equipo o al contenido que publique como código en una wiki.

Clonación de la wiki

El repositorio wiki almacena páginas, imágenes, datos adjuntos y la secuencia de páginas y subpáginas. Clone la wiki para comenzar.

  1. Inicie sesión en el proyecto (https://dev.azure.com/{Your_Organization/Your_Project}) y seleccione la wiki.

  2. Abra el menú contextual Más acciones y seleccione Clonar wiki.

    Clonación del repositorio de Git wiki

  3. En el cuadro de diálogo Clonar repositorio, seleccione Copiar dirección URL de clonación en el Portapapeles.

    Copia de la dirección URL de wiki

    Escríbalo en el explorador para ver los archivos definidos en la rama wikiMaster.

    Archivos principales de wiki

  4. Use la dirección URL que copió para clonar el repositorio en el IDE que use. Para obtener más información, vea uno de los siguientes artículos:

Adición de páginas al repositorio git local

Creamos páginas con formato Markdown. Agregue un archivo Markdown a la rama local para cada página y subpágina que quiera agregar a la wiki.

Agregar páginas

Para agregar páginas en la raíz del árbol wiki, agregue un archivo Markdown en la raíz del repositorio de Git.

  1. Para cada página que quiera agregar, cree un archivo Markdown con el contenido de la página y, a continuación, agréguelo en la carpeta raíz del repositorio.

    Para el proyecto de equipo de CanaryBuilds, se encuentra en la carpeta siguiente:

    C:\Users\UserName\Source\Repos\CanaryBuilds.wiki

  2. Para agregar páginas en la raíz del árbol wiki, agregue un archivo Markdown para cada página en la raíz del repositorio de Git.

    Repositorio git de wiki de rama local

  3. Después de agregar todas las páginas que desea agregar en la raíz, actualice el archivo .order en la raíz. Debe tener una entrada para cada archivo Markdown definido en la raíz. Cada entrada debe coincidir con el título del archivo con espacios reemplazados por un guión.

    Por ejemplo:

     Welcome
 Roadmap  
 How-to-contribute  
 Home  
 Reference

Agregar subpáginas

  1. Cree una carpeta para la página principal y agregue archivos Markdown para cada subpágina de la carpeta.

    Por ejemplo, agregamos los siguientes archivos a la carpeta How-to-contribute. Estas subpáginas aparecen en la página Cómo contribuir en la wiki.

    Captura de pantalla de las subpáginas.

  2. Agregue un archivo .order en la carpeta con el orden de las subpáginas tal como deberían aparecer en la wiki. Para comprender el uso del archivo .order para secuenciar páginas, consulte Wiki Git repository files and file structure (Archivos de repositorio de Git wiki y estructura de archivos).

    Por ejemplo, el archivo tiene las subpáginas siguientes:

     Request-extensions  
 Licensing  
 Smoke-test  
 Coding-guidelines

Enviar los cambios

Cuando haya terminado con todas las actualizaciones, inserte los archivos en el repositorio de Git.

Las páginas y subpáginas agregadas aparecen inmediatamente en la wiki.

Árbol wiki actualizado

Si hay algún error en el proceso, las páginas aparecen en la wiki con un signo de advertencia.

Advertencia cuando el archivo .order no se actualiza correctamente.