Adición de Markdown a un panel

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

Use el widget de Markdown para dar soporte a su equipo y a las partes interesadas agregando información como:

  • Objetivos del equipo.
  • Vínculos a:
    • Trabajo pendiente de equipo o paneles.
    • Métricas.
    • Otros elementos ubicados en un recurso compartido de red, como un OneNote, SharePoint sitio web o páginas wiki.
  • Fechas importantes o fechas límite de destino.

Veamos un ejemplo:
Portal web, widget de Markdown de ejemplo

Requisitos previos

  • Debe ser miembro de un proyecto. Si aún no tiene un proyecto, cree uno.
  • Si no se ha agregado como miembro del proyecto, ahora se agrega.
  • Cualquier persona con acceso a un proyecto, incluidas las partes interesadas,puede ver los paneles.
  • Para agregar, editar o administrar un panel de equipo, debe tener acceso básico o superior y ser administrador de equipo,administrador de proyecto o tener permisos de panel. En general, debe ser miembro del equipo seleccionado actualmente para editar paneles.
  • Debe ser miembro de un proyecto. Si aún no tiene un proyecto, cree uno.
  • Si no se ha agregado como miembro del proyecto, ahora se agrega.
  • Instale o habilite la extensión de Marketplace de Analytics. Los widgets de Analytics no están disponibles si Analytics no está instalado, habilitado o en ejecución.
  • Cualquier persona con acceso a un proyecto, incluidas las partes interesadas,puede ver los paneles.
  • Para agregar, editar o administrar un panel de equipo, debe tener acceso básico o superior y ser administrador de equipo, administrador de proyectos o tener permisos de panel. En general, debe ser administrador de equipo para que el equipo seleccionado actualmente edite los paneles. Solicite al administrador actual del equipo o del proyecto que le agregue como administrador del equipo.
  • Debe ser miembro de un proyecto. Si aún no tiene un proyecto, cree uno.
  • Si no se ha agregado como miembro del proyecto, ahora se agrega.
  • Cualquier persona con acceso a un proyecto, incluidas las partes interesadas,puede ver los paneles.
  • Para agregar, editar o administrar un panel de equipo, debe tener acceso básico o superior y ser administrador de equipo, administrador de proyectos o tener permisos de panel. En general, debe ser administrador de equipo para que el equipo seleccionado actualmente edite los paneles. Solicite al administrador actual del equipo o del proyecto que le agregue como administrador del equipo.
  • Debe ser miembro de un proyecto. Si aún no tiene un proyecto, cree uno.
  • Si no se ha agregado como miembro del proyecto, ahora se agrega.
  • Cualquier persona con acceso a un proyecto, incluidas las partes interesadas,puede ver los paneles.
  • Para agregar, editar o administrar un panel de equipo, debe tener acceso básico o superior y agregarse al rol de administrador del equipo para el equipo.

Sintaxis de Markdown admitida

El widget de Markdown admite características estándar de CommonMark, como:

  • Encabezados
  • Párrafos y saltos de línea
  • Blockquotes
  • Regla horizontal
  • Resaltado (negrita, cursiva, tachado)
  • Tablas
  • Listas, ordenadas y desordenadas
  • Vínculos
  • Imágenes
  • Caracteres de escape

Para más información sobre el uso, consulte Guía de sintaxis para el uso básico de Markdown.

Por motivos de rendimiento, el widget de Markdown no agrega compatibilidad con muchas características extendidas, muchas de las cuales se admiten en la wiki. Las funcionalidades extendidas impedirían el tiempo de carga del widget. Por ejemplo, las siguientes características extendidas de Markdown no se admiten en el widget de Markdown:

  • Sintaxis HTML incrustada
  • Resaltado de código (wiki/otros admiten la codificación de colores compatible con la sintaxis del lenguaje, CommonMark simplemente representa el código como texto sin formato)
  • Checklists
  • Caracteres emoji
  • Datos adjuntos
  • Fórmulas matemáticas

Conectar al proyecto

Para agregar el widget de Markdown a un panel, conéctese al proyecto mediante un explorador web compatible.

Abra un explorador web, conéctese al proyecto y seleccione Paneles de información general.

Portal web, abrir paneles

Si necesita cambiar a otro proyecto, seleccione el logotipo Azure DevOps para examinar todos los proyectos.

Abra un explorador web, conéctese al proyecto y seleccione Paneles.

Abrir paneles

Si necesita cambiar a otro proyecto, seleccione el logotipo Azure DevOps para examinar todos los proyectos y equipos.

Adición del widget de Markdown

Si necesita agregar un panel, consulte Agregar, cambiar el nombre y eliminar paneles.

Nota

Requiere TFS 2015.1 o una versión posterior.

Para agregar el widget de Markdown al panel, seleccione Editar. El catálogo de widget se abrirá automáticamente.

  1. Agregue o arrastre el widget de Markdown al panel donde desea que se encuentra.

    Widget de Markdown
  2. Seleccione Edición lista para salir de la edición del panel. Esto descartará el catálogo de widget. A continuación, puede configurar el widget de Markdown según sea necesario.

  3. Seleccione el icono de engranaje icono de engranaje para abrir el cuadro de diálogo de configuración del widget.

    Para editar un widget de Markdown, es posible que deba ser administrador del equipo, miembro del grupo Project Administrators o tener permisos concedidos. Para más información, consulte Establecer permisos de panel.

  4. Ajuste el tamaño del widget según sea necesario para ajustar el contenido del markdown que va a especificar. El tamaño más grande es de 10 mosaicos de ancho por 10 de alto. Siempre puede ajustarlo más adelante.

    Cambio del tamaño del widget de Markdown
  5. Escriba el texto y la sintaxis de Markdown en la configuración del cuadro de diálogo de configuración. Para obtener una sintaxis compatible, consulte Guía de sintaxis para archivos Markdown, widgets, wikis y comentarios de solicitud de extracción.

    Aquí se muestra texto simple con una lista con viñetas de cuatro vínculos.

    Configuración de Markdown

    Sugerencia

    Para vincular a una página wiki, use la sintaxis siguiente:
    /ProjectName/_wiki/wikis/WikiRepositoryName?pagePath=/FileName

    Para vincular a un archivo de repositorio, página o imagen dentro del proyecto, haga clic con el botón secundario en el archivo y use la dirección URL completa.

    Esto representa el siguiente widget:

    Portal web, widget de Markdown de ejemplo

    Nota

    No se admiten vínculos a documentos en recursos file:// compartidos de archivos mediante . Esta restricción se ha implementado por motivos de seguridad.

  6. Opcionalmente, puede seleccionar apuntar a un archivo en el repositorio.

    Configuración del widget de Markdown con un archivo de repositorio
  1. Seleccione el icono Editar panel para modificar un panel.

  2. Seleccione agregar un icono de widget para abrir el catálogo de widgets.

  3. Arrastre el widget de Markdown al panel donde desea que se encuentra.

    Widget de Markdown
  4. Seleccione el icono de engranaje icono de engranaje para abrir el cuadro de diálogo de configuración del widget.

    Para editar un widget de Markdown, es posible que deba ser administrador del equipo, miembro del grupo Project Administradores o tener permisos concedidos. Para más información, consulte Establecer permisos de panel.

  5. Ajuste el tamaño del widget según sea necesario para ajustar el contenido del markdown que va a especificar. El tamaño más grande es de 10 mosaicos de ancho por 10 de alto. Siempre puede ajustarlo más adelante.

    Cambio del tamaño del widget de Markdown
  6. Escriba el texto y la sintaxis de Markdown en la configuración del cuadro de diálogo de configuración. Para obtener una sintaxis compatible, consulte Guía de sintaxis para archivos Markdown, widgets, wikis y comentarios de solicitud de extracción.

    Aquí se muestra texto simple con una lista con viñetas de cuatro vínculos.

    Configuración de Markdown

    Para vincular a una página wiki, un archivo de repositorio o una página dentro del proyecto, use este formato:

    /DefaultCollection/Fabrikam%20Fiber/Voice/_wiki?pagePath=%2FHome /DefaultCollection/Fabrikam%20Fiber/Voice/_git/Fabrikam%20Fiber?path=%2FREADME.md /DefaultCollection/Fabrikam%20Fiber/Voice/_backlogs?level=Backlog%20items&showParents=false&_a=backlog

    Esto representa el siguiente widget:

    Portal web, widget de Markdown de ejemplo

    Nota

    Los vínculos a documentos en recursos compartidos de archivos que usan no se file:// admiten en TFS 2017.1 y versiones posteriores. Esta restricción se ha implementado por motivos de seguridad.

  7. Opcionalmente, puede seleccionar apuntar a un archivo en el repositorio.

    Configuración del widget de Markdown con un archivo de repositorio
  8. Si aún no ha cerrado el catálogo de widgets, haga esto ahora.

  9. Si desea cambiar la posición del widget de Markdown u otros widgets en el panel, haga esto ahora mientras sigue en modo de edición del panel.

  10. Cuando haya terminado con los cambios, seleccione salir del icono editar-panel-modo para salir de la edición del panel.