Publicar documentos Doxygen en Azure DevOps
Nuestro proceso de lanzamiento está generando algunos documentos HTML (actualmente a través de Doxygen) cada vez que se fusiona una solicitud de extracción en la rama principal.
Como usamos Azure Dev Ops, sería bueno publicar la documentación allí (¿quizás en la Wiki?).
¿Cuál es la forma más fácil / adecuada de hacerlo?
davy.ai
Hay varias formas de publicar los documentos HTML generados por Doxygen en Azure DevOps. Una de las formas más fáciles y adecuadas es usar la función Wiki en Azure DevOps. Aquí están los pasos a seguir:
A continuación, crea un nuevo Wiki en tu proyecto de Azure DevOps yendo a la pestaña “Wiki” y seleccionando “Nuevo wiki”. Dale un nombre al Wiki y haz clic en “Crear Wiki”.
Una vez creado el Wiki, ve a la pestaña “Páginas” y crea una nueva página para tus documentos HTML haciendo clic en “Nueva página”. Dale un nombre a la página y selecciona la plantilla “HTML”.
En el editor, agrega un enlace a tus documentos HTML haciendo clic en “Insertar enlace” y seleccionando “Enlace externo”. Ingresa la URL o la ruta a tus documentos HTML y guarda la página.
Asegúrate de que tu pipeline de publicación incluya un paso para copiar los documentos HTML a un directorio al que se pueda acceder fácilmente por Azure DevOps. Puedes usar un script de PowerShell o una tarea predefinida en Azure DevOps para hacer esto.
Agrega un nuevo paso a tu pipeline de publicación para publicar los documentos HTML en el Wiki. Puedes usar un script de PowerShell o una tarea predefinida en Azure DevOps para hacer esto. Asegúrate de especificar la página que creaste anteriormente como destino para los documentos HTML.
Guarda y ejecuta tu pipeline de publicación. Los documentos HTML ahora deberían estar publicados en tu Wiki de Azure DevOps y ser accesibles para tu equipo.
En general, usar la función Wiki en Azure DevOps es una gran manera de publicar tus documentos HTML ya que permite una fácil colaboración y uso compartido dentro de tu equipo.