Compartir a través de


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

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

Después de configurar un repositorio git wiki para el proyecto de equipo, puede agregar un título para el contenido wiki y de página. La interfaz de usuario de Azure DevOps proporciona una experiencia en paralelo en la que puede editar páginas y obtener una vista previa de los cambios a medida que trabaja.

En el panel Editar , escriba contenido de página mediante la sintaxis de formato Markdown. También puede insertar imágenes, datos adjuntos y vínculos. A medida que realice cambios, el contenido se actualiza en el panel Vista previa . El contenido con formato especial, como encabezados, listas, vínculos e imágenes, se muestran como texto enriquecido en el panel Vista previa .

Captura de pantalla de la página principal wiki de Azure DevOps en la que se muestra la experiencia en paralelo en la que puede editar el contenido de la página y obtener una vista previa de los cambios al mismo tiempo.

Mientras edita la página, use el método abreviado de teclado Ctrl+S para guardar rápidamente el trabajo. También puede guardar el trabajo con un mensaje de revisión personalizado como "Se han agregado vínculos de página". Esta opción está disponible en el menú desplegable Guardar :

Captura de pantalla que muestra cómo seleccionar la opción Guardar con mensaje de revisión en Azure DevOps.

Hay otros métodos abreviados de teclado disponibles. Para obtener más información, consulte Métodos abreviados de teclado para administrar páginas wiki.

Nota:

En este artículo se describe cómo agregar y editar páginas en una wiki creada para un proyecto de equipo. Si desea agregar o editar páginas a una wiki publicada desde un repositorio de Git, consulte Publicación de un repositorio de Git en una wiki.

Herramientas de línea de comandos wiki

Puede usar comandos de la CLI de Azure DevOps para administrar el contenido wiki. En la tabla siguiente se proporcionan vínculos a secciones de este artículo que describen cómo trabajar con comandos específicos.

Comando Descripción
az devops wiki show (muestra el wiki de DevOps) Abra la wiki y muestre la página principal de wiki.
az devops wiki page show (mostrar página del wiki en DevOps) Mostrar una página específica en la wiki.
comando "az devops wiki page create" para crear una página wiki en Azure DevOps Agregue una nueva página a la wiki.
actualización de la página de wiki de az devops Edite una página existente en la wiki.
az devops eliminar página de wiki Eliminar una página en la wiki.

Requisitos previos

Categoría Requisitos
Acceso al proyecto Miembro del proyecto donde se encuentra la wiki. Puede solicitar acceso desde el administrador del proyecto, según sea necesario.
Permisos Miembro del grupo de colaboradores .
Niveles de acceso Al menos acceso Básico.
Tareas Prepare una wiki aprovisionada para el proyecto.

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.

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

Captura de pantalla de una wiki abierta en el explorador y que muestra la página de información general de wiki.

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

Agregar una página wiki

En esta sección se describe cómo agregar una página a la wiki. Puede trabajar directamente con la interfaz de usuario de Azure DevOps en el explorador o usar la CLI de Azure DevOps.

Para agregar una nueva página a la wiki, tiene dos opciones. Para empezar, seleccione una página en la lista, como la página principal.

  • Para agregar una página en el mismo nivel que la página actual, seleccione Nueva página en la parte inferior de la interfaz de usuario de Azure DevOps.

  • Para agregar una subpágina a la página actual, seleccione Más opciones (...) >Agregar subpágina.

Captura de pantalla que muestra cómo agregar una página nueva o una subpágina nueva a una wiki en Azure DevOps.

También puede usar métodos abreviados de teclado para agregar páginas. Seleccione la página actual y agregue una nueva página seleccionando n o agregue una subpágina seleccionando c. Para obtener más información, consulte Métodos abreviados de teclado para administrar páginas wiki.

Título de página y nombre de archivo

Escriba un título único para la página. El valor distingue mayúsculas de minúsculas. El título se usa como nombre de archivo de la página. En el nombre del archivo, los espacios del título de la página se reemplazan por guiones (-). Por ejemplo, el título de página "Cómo contribuir" corresponde al nombre de archivo How-to-contribute.md. La ruta de acceso completa al archivo debe tener 235 caracteres o menos.

Para ver otras restricciones de nombres de archivo, consulte Wiki Git repository files and file structure, File naming conventions( Convenciones de nomenclatura de archivos).

Restricciones de título de página y nombre de archivo

Cada página wiki corresponde a un archivo en el repositorio de Git wiki. Las restricciones siguientes se aplican a los nombres de archivo de página y al tamaño del archivo:

  • Nombre de archivo: al elegir un nombre para el archivo de página, tenga en cuenta que la ruta de acceso completa al archivo debe tener 235 caracteres o menos. La ruta de acceso completa a la página consta de la dirección URL del repositorio, la ruta de acceso de carpeta al archivo de página y el nombre del archivo de página. Por ejemplo: https://github.com/ExampleWiki/Contributors/Code/How-to-add-code-to-the-project.md.

  • Unicidad: el nombre del archivo de página debe ser único dentro de su ubicación de carpeta en la jerarquía del repositorio wiki. El nombre es sensible a mayúsculas y minúsculas.

  • Caracteres especiales: el nombre del archivo de página tiene restricciones sobre los siguientes caracteres especiales:

    • Sin caracteres de control Unicode ni caracteres suplentes
    • Sin caracteres imprimibles: barra diagonal /, barra diagonal inversa \, hash #
    • Ningún símbolo de punto . al principio o al final del nombre
  • Tamaño del archivo: el tamaño máximo del archivo de página es de 18 MB.

  • Tamaño del archivo adjunto: el tamaño máximo de los datos adjuntos a un archivo de página es de 19 MB.

Caracteres especiales permitidos

En un nombre de archivo de página se pueden incluir varios caracteres especiales, como los dos puntos : y el guion -. Por ejemplo, podría asignar un nombre a un archivo Markdown como faq:0525 o Setup-Guide.

Importante

Para evitar errores en la sintaxis de página y la navegación del explorador, no use el carácter de espacio ( ) en los nombres de archivo de página. Si asigna un nombre a los archivos de página en función del título de la página, reemplace los espacios del título de la página por un guion (-) en el nombre de archivo.

En la tabla siguiente se enumeran los caracteres especiales permitidos en los nombres de archivo de página wiki y la cadena codificada en URI correspondiente:

Carácter Símbolo Cadena de URI
Colon : %3A
Corchete angular izquierdo < %3C
Corchete angular derecho > %3E
Asterisco (comodín) * %2A
Signo de interrogación ? %3F
de canalización de | %7C
Guión (guión) - %2D
Comilla doble " %22

Por ejemplo, el nombre de archivo FAQ:0525 se codifica como FAQ%3A0525.

Establecer la página principal de wiki

De forma predeterminada, la primera página que agregue al crear una wiki se establece como la página principal de wiki. Puede cambiar la página principal de la wiki si otra página es más relevante. Para obtener más información, consulte Reordenar o mover páginas wiki.

Editar y eliminar páginas wiki

En esta sección se describe cómo editar o eliminar una página en la wiki. Puede trabajar directamente con la interfaz de usuario de Azure DevOps en el explorador o usar la CLI de Azure DevOps.

Hay varias maneras de editar una página wiki existente en el explorador:

  • Abra la página wiki y seleccione Editar.
  • Abra la página wiki y use el método abreviado de teclado e.
  • Seleccione la página wiki en la lista de páginas y, a continuación, seleccione Más opciones (...) >Editar.

Para obtener más información sobre las funciones de edición específicas, consulte La guía de Uso de Markdown.

Editar en repositorios para wikis de programación

Al publicar código como wiki, puedes editar las páginas del wiki en el hub Repos. La misma experiencia del editor en paralelo está disponible con las opciones de formato de la barra de herramientas de Markdown. Seleccione Editar>Editar en Repos para crear una nueva rama y continuar editando:

Captura de pantalla que muestra cómo seleccionar la opción Editar en repositorios en Azure DevOps.

La opción Editar en repositorios solo está disponible para wikis de código que tienen habilitadas políticas de rama. Si no ve la opción , puede deberse a que la wiki no es una wiki de código ni las directivas de rama no están habilitadas. Para obtener más información, consulte Directivas y configuraciones de rama.

Eliminar página wiki en el explorador

Para eliminar una página wiki, seleccione la página wiki en la lista de páginas y, a continuación, seleccione Más opciones (...) >Eliminar. También puede seleccionar Eliminar en el menú contextual de la página.

Después de seleccionar Eliminar, confirme la eliminación en el cuadro de diálogo.

Nota:

Al eliminar una página wiki, también se eliminan todos los metadatos de la página y las subpáginas adjuntas a la página.

Reordenar o mover páginas wiki

En el explorador, puede reordenar páginas en la vista de árbol wiki para que las páginas se muestren en la secuencia preferida. La secuencia predeterminada es alfabéticamente por nombre de archivo. Puede cambiar la secuencia para reordenar las páginas por artículo, categoría o audiencia prevista.

Puede usar la acción de arrastrar y colocar en los títulos de página de la vista de árbol para completar las tareas siguientes:

  • Cambio: Cambiar la relación de página/sub-página de una página. Si mueve una página dentro de la secuencia wiki, es posible que se rompan los hipervínculos a la página desde otras páginas wiki. Puede corregir manualmente estos vínculos después de mover la página.

  • Reordenar: cambie el orden de una página dentro de la secuencia wiki. La reordenación de páginas dentro de la secuencia wiki no afecta a los vínculos de página.

Para corregir un vínculo roto después de mover una página en la secuencia wiki, siga estos pasos:

  1. Pruebe las otras páginas de la wiki y busque vínculos a la página movida.

    Compruebe si hay mensajes de error en la página o en el contenido que falta.

  2. Abra la página que tiene un vínculo roto, seleccione Editar y vaya al vínculo roto en el contenido de la página.

    Para buscar el vínculo roto en el contenido, puede buscar el nombre de la página movida, la ruta de acceso del archivo original de la página movida o el texto del vínculo roto.

  3. Actualice el vínculo roto. La corrección típica consiste en cambiar la dirección URL o la ruta de acceso del vínculo para dirigirse a la nueva ubicación de la página movida.

  4. Guarde los cambios en la página para que el vínculo se actualice.

  5. Abra la página actualizada en el explorador y pruebe el vínculo. Confirme que se abre correctamente la página movida.

Cambiar el orden de las páginas de nivel superior

Puede usar métodos abreviados de teclado para reordenar páginas de nivel superior en la secuencia wiki. Esta acción no funciona para las subpáginas.

Seleccione una página en la lista de páginas wiki y use el acceso directo CTRL + FLECHA ARRIBA o CTRL + FLECHA ABAJO para mover la página dentro de la secuencia. El cambio se aplica inmediatamente.

Cambiar el orden de página o subpágina

También puede cambiar el orden de página o subpágina de cualquier página de la secuencia wiki.

  1. Seleccione la página que desea mover en la lista de páginas wiki.

  2. Seleccione Más opciones (...) >Mover, que abre el cuadro de diálogo Mover página .

  3. En el cuadro de diálogo Mover página , seleccione la página que va a servir como la nueva página principal .

    Captura de pantalla que muestra cómo mover una página wiki para que se convierta en una subpágina de otra página en la secuencia.

  4. Después de seleccionar la nueva página primaria, el sistema examina los posibles vínculos rotos en función del movimiento de página. Informa de los vínculos que deben ajustarse:

    Captura de pantalla que muestra cómo hacer que el sistema ajuste los vínculos de página causados por un movimiento de página en la secuencia wiki.

  5. Seleccione la opción Actualizar vínculos afectados en páginas y elementos de trabajo (recomendado) y, a continuación, seleccione Mover para completar el movimiento de página.

Para obtener una lista completa de los métodos abreviados de teclado, consulte Métodos abreviados de teclado para administrar páginas wiki.