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

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Puede agregar un título y contenido a una página, una vez que se haya aprovisionado el repositorio de Git wiki para el proyecto de equipo. Hay una experiencia de edición y vista previa en paralelo en la que puede editar la página y obtener una vista previa del contenido a medida que avance.

Obtenga información sobre cómo realizar las siguientes tareas:

  • Abrir wiki
  • Agregar una página wiki
  • Visualización de revisiones de una página
  • Edición y eliminación de páginas wiki
  • Reordenar páginas wiki
  • Convertir una página en la página principal de wiki

Al crear páginas con el formato Markdown,también puede usar el panel de formato para aplicar formato de texto enriquecido e insertar imágenes, datos adjuntos y vínculos.

Página principal de wiki

A medida que edite la página, guárdela; para ello, escriba Ctrl+S. Para guardar con un mensaje de revisión personalizado, seleccione junto a Guardar. Para más métodos abreviados, consulte Métodos abreviados de teclado para administrar páginas wiki.

Guardar página con un mensaje personalizado

Herramientas de línea de comandos wiki

Comandos: Descripción
az devops wiki show Abrir una wiki
az devops wiki page show Obtener el contenido de una página o abrir una página
az devops wiki page create Agregar una nueva página
az devops wiki page update Edición de una página
az devops wiki page delete Eliminación de una página

Nota

Para agregar o editar páginas a una wiki que ha publicado desde un repositorio de Git, consulte Publicación de un repositorio de Git en una wiki. En este artículo se explica cómo agregar y editar páginas de una wiki que ha aprovisionado para un proyecto de equipo.

Requisitos previos

  • Debe tener una wiki aprovisionada. Si aún no se ha creado la wiki, cándala ahora.
  • Debe ser miembro del proyecto de equipo como colaborador para agregar o actualizar páginas wiki.
  • Debe tener el nivel de acceso Básico para editar la wiki del proyecto.

Abrir la wiki

Conectar al proyecto mediante un explorador web compatible y elija Wiki.

Creación de una wiki, aprovisionamiento de un repositorio de Git para la wiki o publicación de archivos Markdown del repositorio existente

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

Agregar una página wiki

Para agregar otra página, elija Nueva página. O bien, para agregar una subpágina, abra el menú contextual de una página existente y seleccione Agregar subpágina.

Especifique un título único de 235 caracteres o menos. Los títulos de página distinguen mayúsculas de minúsculas. Para ver otras restricciones de título, consulte Wiki Git repository files and file structure ( Archivos de repositorio de Git wiki y estructura de archivos), Convenciones de nomenclatura de archivos.

Creación de wiki y primera página

También puede usar métodos abreviados de teclado para agregar una nueva página presionando n o agregando una subpágina presionando c. Para obtener una lista completa de los métodos abreviados de teclado, consulte Métodos abreviados de teclado para administrar páginas wiki.

Restricciones de nomenclatura de títulos de página Wiki

Cada página wiki corresponde a un archivo dentro del repositorio de Git wiki. Los nombres que asigne a un título de página wiki deben cumplir las restricciones siguientes.

Tipo de restricción Restricción
Nombre de archivo La ruta de acceso completa de la página no debe superar los 235 caracteres.
Unicidad Los títulos de página distinguen mayúsculas de minúsculas y deben ser únicos dentro de la jerarquía wiki.
Caracteres especiales
  1. No debe contener caracteres de control Unicode ni caracteres suplentes.
  2. No debe contener los siguientes caracteres imprimibles: / \ #
  3. No debe empezar ni finalizar en punto (.)
Tamaño de archivo No debe superar el máximo de 18 MB
Tamaño del archivo de datos adjuntos No debe superar el máximo de 19 MB

Caracteres especiales en los títulos de la página Wiki

Puede especificar títulos de página que contengan uno o varios de estos caracteres : < > * ? | - especiales. Por ejemplo, puede nombrar un archivo Markdown como "P+F" o "Guía de configuración". Los caracteres tienen las siguientes cadenas codificadas en URI:

Carácter Cadena codificada
: %3A
< %3C
> %3E
* %2A
? %3F
| %7C
- %2D
" %22
Tipo de restricción Restricción
Nombre de archivo La ruta de acceso completa de la página no debe superar los 235 caracteres.
Unicidad Los títulos de página distinguen mayúsculas de minúsculas y deben ser únicos dentro de la jerarquía wiki.
Caracteres especiales
  1. No debe contener caracteres de control Unicode ni caracteres suplentes.
  2. No debe contener los siguientes caracteres imprimibles: / : < \ * ? \ | - #
  3. No debe empezar ni finalizar en punto (.)
  4. Los títulos de las páginas agregadas sin conexión no deben contener un espacio en blanco.
Tamaño de archivo No debe superar el máximo de 18 MB
Tamaño del archivo de datos adjuntos No debe superar el máximo de 19 MB

Edición y eliminación de páginas wiki

Para editar una página wiki existente, ábrala y seleccione Editaro abra el menú contextual y seleccione Editar. También puede usar el método abreviado de teclado e para ir rápidamente a la edición de la página actual.

En el caso de las wikis de código, puede editar una página en el editor en paralelo mediante la barra de herramientas de Markdown para crear el contenido. Esta experiencia es idéntica al proceso de una wiki del proyecto. También puede editar páginas wiki en el centro Repos mediante la opción Editar en Repos.

Edite la página wiki.

Nota

Si tiene directivas de rama en la wiki de código, use Editar en Repos crear una rama y continuar con la edición.

Para eliminar una página, abra el menú contextual del árbol o el que se encuentra dentro de la página y seleccione Eliminar. Confirme la eliminación en el cuadro de diálogo que se abre.

Nota

Al eliminar una página, se elimina la página junto con todos los metadatos y todas sus sub páginas (si las hay) en la jerarquía.

Reordenar una página wiki

Puede reordenar las páginas dentro de la vista de árbol wiki para que las páginas aparezcan en el orden y la jerarquía que desee. Puede arrastrar y colocar un título de página en la vista de árbol para realizar las siguientes operaciones:

  • Cambiar la relación de elementos primarios y secundarios de una página
  • Cambiar el orden de la página dentro de la jerarquía

Nota

Mover una página de la jerarquía puede interrumpir los vínculos a ella desde otras páginas. Siempre puede corregir los vínculos manualmente después de moverlos. Reordenar una página dentro de una jerarquía no tiene ningún impacto en los vínculos de página.

También puede usar métodos abreviados de teclado para reordenar páginas. Seleccione una página y presione CTRL + FLECHA ARRIBA o CTRL + FLECHA ABAJO para cambiar los pedidos de página. Para cambiar la relación de elementos primarios y secundarios de una página, abra su menú contextual y seleccione Mover. Se abre el cuadro de diálogo Mover página. Seleccione una página primaria en la que puede mover la página actual.

Mover página wiki en la jerarquía

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

Convertir una página en 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 resulta más relevante arrastrando y colocando la página en la parte superior del árbol.

Pasos siguientes