tutorial tag repositorio remove que español crear git github uml markdown gitlab

tag - gitlab tutorial español pdf



Cómo integrar diagramas UML en GitLab o GitHub (2)

Después de intentar la otra respuesta , descubrí que el servicio era lento y aparentemente no estaba a la altura de la última versión de PlantUML.

He encontrado una forma diferente que no es tan sencilla, pero funciona a través del servidor de PlantUML.com (en la nube). Como tal, debería funcionar en cualquier lugar donde pueda enlazar a una imagen .

Explota la función !includeurl y es esencialmente una indirección. El archivo de rebajas enlaza a una fuente de PlantUML que incluye la fuente del diagrama. Este método permite modificar la fuente en GitHub, y cualquier imagen en los archivos de rebaja de GitHub se actualizará automáticamente. Pero requiere un paso complicado para crear la URL a la dirección indirecta.

  1. Obtenga la URL de la fuente de PlantUML sin formato, por ejemplo, https://raw.githubusercontent.com/linux-china/plantuml-gist/master/src/main/uml/plantuml_gist.puml (usando el ejemplo en la respuesta de joanq)
  2. Vaya a http://plantuml.com/plantuml/form (o PlantText.com) y cree una fuente PlantUML de una línea que use la función !includeurl URL-TO-RAW-PLANTUML-SOURCE-ON-GITHUB . Continuando con la URL de ejemplo, la fuente de PlantUML (meta) es:

    !includeurl https://raw.githubusercontent.com/linux-china/plantuml-gist/master/src/main/uml/plantuml_gist.puml

  3. Copie la URL de la imagen de la fuente de la escuela, p. Ej., Http://plantuml.com. F. Esta URL no cambiará.

    ![PlantUML model](http://plantuml.com:80/plantuml/png/3SNB4K8n2030LhI0XBlTy0YQpF394D2nUztBtfUHrE0AkStCVHu0WP_-MZdhgiD1RicMdLpXMJCK3TC3o2iEDwHSxvNVjWNDE43nv3zt731SSLbJ7onzbyeF)

Bonificación : incluso puede obtener acceso al formato SVG modificando el plantuml/png/ parte de la URL para que sea plantuml/svg/ como sigue

![PlantUML model](http://plantuml.com:80/plantuml/svg/3SNB4K8n2030LhI0XBlTy0YQpF394D2nUztBtfUHrE0AkStCVHu0WP_-MZdhgiD1RicMdLpXMJCK3TC3o2iEDwHSxvNVjWNDE43nv3zt731SSLbJ7onzbyeF)

Ejemplo en GitHub

https://github.com/fuhrmanator/course-activity-planner/blob/master/ooad/overview.md

Edición: Alternativa con servicio Proxy

Esta forma es significativamente diferente y más simple que la respuesta anterior; utiliza el servicio de proxy PlantUML :

http://www.plantuml.com/plantuml/proxy?src=https://raw.github.com/plantuml/plantuml-server/master/src/main/webapp/resource/test2diagrams.txt

La rebaja de GitHub para esto sería:

![alternative text](http://www.plantuml.com/plantuml/proxy?src=https://raw.github.com/plantuml/plantuml-server/master/src/main/webapp/resource/test2diagrams.txt)

Este método no puede especificar el formato SVG (por defecto es PNG) y quizás no sea posible solucionar el error de almacenamiento en caché mencionado en los comentarios.

Quiero publicar algunos documentos de programación que tengo en un repositorio público disponible. Esta documentación tiene texto con formato, algunos diagramas UML y muchos ejemplos de código. Creo que GitHub o GitLab son buenos lugares para publicar esto.

Para publicar los diagramas UML, me gustaría tener alguna manera fácil de mantenerlos actualizados en el repositorio y visibles como imágenes en la wiki. No quiero guardar los diagramas en mi computadora (o en la nube), editarlos, generar una imagen y luego publicarla cada vez.

¿Hay alguna forma de colocar los diagramas en el repositorio (lo ideal sería la sintaxis de PlantUML), vincularlos en el texto de reducción y hacer que las imágenes se actualicen automáticamente cada vez que se actualice el diagrama?


Encontré que es posible hacer esto usando plantuml-gist en http://uml.mvnsearch.org/

Simplemente coloque un archivo puml válido en el repositorio e incluya un enlace a este sitio en la documentación.

Por ejemplo, para el archivo https://github.com/linux-china/plantuml-gist/blob/master/src/main/uml/plantuml_gist.puml en GitHub, usaría http://uml.mvnsearch.org/github/linux-china/plantuml-gist/blob/master/src/main/uml/plantuml_gist.puml como su enlace.

Esto es lo que parece vinculado en :

http://uml.mvnsearch.org/github/linux-china/plantuml-gist/blob/master/src/main/uml/plantuml_gist.puml

Desafortunadamente, no parece funcionar con GitLab. Siempre me aparece el mensaje "No se encontró ningún archivo PUML", aunque he revisado la ruta varias veces.

EDITAR : servidor en uml.mvnsearch.org parece abajo.