Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 .
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 :
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:
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.
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:
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.
Corregir vínculos rotos después de que se mueva la página
Para corregir un vínculo roto después de mover una página en la secuencia wiki, siga estos pasos:
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.
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.
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.
Guarde los cambios en la página para que el vínculo se actualice.
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.
Seleccione la página que desea mover en la lista de páginas wiki.
Seleccione Más opciones (...) >Mover, que abre el cuadro de diálogo Mover página .
En el cuadro de diálogo Mover página , seleccione la página que va a servir como la nueva página principal .
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:
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.