Creación de una wiki para el proyecto

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

En Azure DevOps, cada proyecto de equipo tiene una wiki. Puede usar el wiki para compartir información con su equipo y apoyar la contribución al proyecto. La wiki está impulsada por un repositorio de Git en el backend. En este artículo se describe cómo abrir la wiki del proyecto y crear el repositorio de Git.

Al crear un proyecto de equipo, un repositorio git wiki no se crea de forma predeterminada. Puede crear el repositorio para almacenar los archivos de Markdown wiki o publicar archivos Markdown existentes desde un repositorio de Git en una wiki.

Requisitos previos

Categoría	Requisitos
Acceso al proyecto	Miembro del proyecto donde se encuentra la wiki. Si no tienes acceso, solicítalo al administrador de tu proyecto. Cualquier persona con acceso al proyecto de equipo puede ver la wiki, incluidas las partes interesadas.
Permisos	- Para agregar o editar páginas wiki: miembro del grupo Colaboradores . - Para publicar código como wiki: Crear repositorio permiso. De forma predeterminada, este permiso se establece para los miembros del grupo de Administradores del proyecto.
Niveles de acceso	Al menos acceso Básico.

Abrir la Wiki

Puede abrir y ver la página wiki del proyecto de equipo desde Azure DevOps en el explorador o usar la CLI de Azure DevOps.

Navegador
CLI de Azure DevOps

Conéctese al proyecto mediante un explorador web compatible y seleccione Wiki:

Si necesita cambiar el proyecto de equipo, seleccione Azure DevOps para examinar todos los proyectos y equipos de equipo.

Puede ver y abrir una página wiki de un proyecto mediante el az devops wiki show comando :

az devops wiki show --wiki
                      [--open]
                      [--project]
                      [--subscription]

Para más información, consulte Introducción a la CLI de Azure DevOps.

Parámetros básicos

Los parámetros siguientes están disponibles para el wiki show comando :

Parámetro	Obligatorio	Descripción
`--wiki`	Sí	Nombre o identificador de la wiki.
`--open`	No	Abra la página wiki en el explorador web.
`--project -p`	No	Nombre o identificador del proyecto.
`--subscription`	No	Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada con el `az account set -s NAME_OR_ID` comando .

Para más información, consulte la referencia de comandos de la CLI de Azure DevOps.

Ejemplo: Visualización de la wiki del proyecto

En el ejemplo siguiente se muestra cómo abrir una wiki denominada "MyProjectwiki":

az devops wiki show --wiki MyProjectwiki --open

Ver una página wiki

Puede ver el contenido de una página específica mediante el comando de la CLI az devops wiki show de Azure DevOps:

az devops wiki page show --path
                         --wiki
                         [--include-content]
                         [--open]
                         [--project]
                         [--subscription]
                         [--version]

Más parámetros

En la tabla siguiente se enumeran más parámetros para el wiki show comando cuando desea ver una página específica:

Parámetro	Obligatorio	Descripción
`--path`	Sí	Ruta de acceso completamente cualificada para la página wiki.
`--include-content`	No	Muestra el contenido de la página completa junto con los metadatos de la página.
`--version -v`	No	La versión de la página wiki, que corresponde al valor de la etiqueta de la entidad `ETag`.

Para más información, consulte la referencia de comandos de la CLI de Azure DevOps.

Ejemplo: Ver una página específica

En el ejemplo siguiente se muestra cómo obtener contenido para la página "Introducción" de la wiki "MyProjectwiki":

az devops wiki page show --path 'Get Started' --wiki 'MyProjectwiki' --content "Hello World"

Los comandos de la CLI de Azure DevOps no son compatibles con Azure DevOps Server.

Creación de un repositorio de Git wiki

En esta sección se describe cómo crear el repositorio de Git para la wiki. Puede trabajar directamente con la interfaz de usuario de Azure DevOps en el explorador o usar la CLI de Azure DevOps.

Navegador
CLI de Azure DevOps

En el explorador, puede crear un nuevo repositorio de Git para almacenar las páginas wiki y los artefactos relacionados. En la página de aterrizaje wiki , seleccione Crear wiki del proyecto. Incluso si usa el control de versiones de Team Foundation (TFVC) para el control de código fuente, puede crear una wiki con un repositorio de Git.

Si no tiene los permisos necesarios para crear un repositorio git wiki o no puede acceder a ninguna wiki existente, verá el siguiente mensaje:

Captura de pantalla del mensaje para los usuarios con permisos insuficientes para crear un repositorio de Git wiki.

Los usuarios con acceso de nivel de administrador de Project pueden crear el repositorio de Git wiki. Los usuarios con acceso a partes interesadas no pueden crear una wiki porque no tienen permisos para trabajar en las secciones Repositorios o Código del proyecto.

El nombre del repositorio wiki se basa en el nombre del proyecto. La convención es <ProjectName>.wiki. Si el nombre del proyecto de equipo es Contoso , el nombre del repositorio wiki es Contoso.wiki.

Sugerencia

Puede crear varias wikis para un solo proyecto publicando el código como wiki.

Acceso al repositorio wiki

El repositorio git de la wiki (ProjectName.wiki) no se incluye en la lista desplegable de repositorios en las secciones Repositorios o Código del proyecto. El repositorio wiki tampoco aparece en las > o Control de versiones. En lugar de eso, puede acceder a su repositorio wiki desde la página Repos>Archivos de su wiki.

Cree la dirección URL para la página Repos>Archivos. En la siguiente dirección URL, sustituya el servidor, la organización, el proyecto y el nombre del wiki en las partes <Placeholder>.

https://dev.azure.com/<Organization>/<ProjectName>/_git/<WikiName>

https://<ServerName>/Default_Collection/<ProjectName>/_git/<WikiName>
Pegue la dirección URL en un explorador y abra la página Archivos de la wiki.
En la página Archivos de repositorios>, busque el nombre del repositorio wiki y seleccione Más opciones (...) >Clone.

La opción Clonar abre un cuadro de diálogo que incluye la dirección URL del repositorio wiki.
En el cuadro de diálogo, seleccione HTTP y, a continuación, seleccione el icono Copiar (página doble):

La dirección URL se copia en el Portapapeles.

Cierre el cuadro de diálogo.
Para acceder al repositorio wiki, pegue la dirección URL copiada en el explorador.

Puede crear una wiki con el comando az devops wiki create :

az devops wiki create [--mapped-path]
                      [--name]
                      [--org]
                      [--project]
                      [--repository]
                      [--type {codewiki, projectwiki}]
                      [--version]

Para más información, consulte Introducción a la CLI de Azure DevOps.

Nota:

Si desea crear más de una wiki, debe publicar el código del proyecto como wiki. Puede configurar varios repositorios wiki para un solo proyecto.

Parámetros

Los parámetros siguientes están disponibles para el wiki create comando . El type parámetro especifica el tipo de wiki que se va a crear: Wiki del proyecto (projectwiki) o Publicar código como wiki (codewiki).

Parámetro	Obligatorio	Descripción
`mapped-path`	Sí (`codewiki`)	Ruta de acceso mapeada para la wiki. Puede especificar la barra diagonal inversa (`/`) para publicar desde la raíz del repositorio wiki.
`name`	Sí (`codewiki`)	Nombre de la wiki. Para el `projectwiki` tipo, cuando no se especifica ningún nombre, el nombre wiki es `TeamProjectName.wiki`.
`org`	Es posible	Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada con el `az devops configure -d organization=ORG_URL` comando . Nota: Cuando la organización no está configurada de forma predeterminada o se selecciona mediante el `git config` comando , el parámetro es Obligatorio. Ejemplo: `--org https://dev.azure.com/<OrganizationName>/`.
`project`	Es posible	Nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante el `az devops configure -d project=NAME_OR_ID` comando . Nota: Cuando el proyecto no está configurado de forma predeterminada o se selecciona mediante el `git config` comando , el parámetro es Obligatorio.
`repository`	Sí (`codewiki`)	Nombre o identificador del repositorio de Git desde el que se va a publicar la wiki.
`type`	No	Tipo de wiki que se va a crear: Wiki del proyecto (`projectwiki`) o Publicar código como wiki (`codewiki`). El valor predeterminado es `projectwiki`.
`version`	Sí (`codewiki`)	Nombre de la rama del repositorio de Git desde el que se va a publicar la wiki del código.

Ejemplo: Creación de una wiki de proyecto

El siguiente comando crea una wiki del proyecto denominada "Fabrikam Fiber" y muestra la salida en formato de tabla:

az devops wiki create --name "Fabrikam Fiber" --output table

ID                                    Name                 Type
------------------------------------  -------------------  -----------
7edcc35b-89be-465e-855e-377ba8660af7  Fabrikam Fiber.wiki  projectWiki

Los comandos de la CLI de Azure DevOps no son compatibles con Azure DevOps Server.

Paso siguiente

Adición y edición de páginas de wiki

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-12-17