You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[](https://github.com/plantuml/plantuml-eclipse/actions/workflows/release-plantuml-lib.yml)
# PlantUML - Generate UML diagrams from files and view them in Eclipse
2
8
3
9
The plantuml library implements a DSL and renderer for many UML diagrams (class, sequence, objects, states, activities, ...).
4
10
See http://plantuml.com for more info about the DSL and renderer.
@@ -18,10 +24,12 @@ Diagram generation is handled by (implementations of) an extension point, called
18
24
19
25
Each diagram intent provider may support properties that affect details of how diagrams are generated, that may be changed pr. workspace by adding properties in a specific **properties** file in a specific folder. The folder is settable in the PlantUML property sheet. E.g. the diagram intent provider for class diagrams supports two properties, that controls how attributes' name and type are rendered. Certain other behavior is also controlled by properties in **properties** files, details can be found in Customization.
20
26
27
+
21
28
# License
22
29
23
30
This repo uses the [EPL license vers. 1.0](plantuml4eclipse/features/net.sourceforge.plantuml.feature/epl-v10.html).
24
31
32
+
25
33
# Community
26
34
27
35
We use [Issues](https://github.com/plantuml/plantuml-eclipse/issues) for issue tracking,
@@ -33,37 +41,72 @@ Of course, you can also ask questions about how to use PlantUML, tell us about h
33
41
34
42
*Originally, this repository was created and hosted by [Hallvard Trætteberg](https://github.com/hallvard). You'll find previous issues and discussions in the [original repository](https://github.com/hallvard/plantuml).*
35
43
44
+
36
45
# Installation
37
46
38
-
We use github pages at [https://plantuml.github.io/plantuml-eclipse/](https://plantuml.github.io/plantuml-eclipse/) as the update site URL.
47
+
We use GitHub pages at [https://plantuml.github.io/plantuml-eclipse/](https://plantuml.github.io/plantuml-eclipse/) as the update site URL.
39
48
Just install the plug-ins in Eclipse via the Help > Install New Software... dialog using that URL.
49
+
Previous versions can be installed using the update site [https://hallvard.github.io/plantuml/](https://hallvard.github.io/plantuml/).
50
+
51
+
Beginning with version 1.2.0, you'll need at least the following features
52
+
-*PlantUML Feature* (the PlantUML diagramming support for Eclipse)
53
+
-*PlantUML Library Feature* (the PlantUML library needed for rendering diagrams, it inlcudes the ELK layouting library)
54
+
55
+
The following features are optional
56
+
-*PlantUML Ecore Feature* (for drawing class diagrams from ecore files)
57
+
-*PlantUML UML2 Feature* (for drawing UML diagrams from UML 2 model files)
58
+
40
59
41
60
# For developers / contributors
42
61
43
62
You'll find some developer documentation here:
44
-
- net.sourceforge.plantuml.composite/README.md (how to build, run, and release)
45
-
- net.sourceforge.plantuml.lib/README.md (how to update PlantUML library)
63
+
- plantuml4eclipse/releng/net.sourceforge.plantuml.parent/README.md (how to build, run, and release)
64
+
- plantuml4eclipse/releng/net.sourceforge.plantuml.parent/Customization.md (how to adapt diagrams)
65
+
66
+
The PlantUML4Eclipse plug-ins depend on the PlantUML library bundle, i.e. net.sourceforge.plantuml.library.
67
+
This bundle is automatically built and published on an Eclipse update site
68
+
(this repo's GitHub pages publish a composite update site with PlantUML library and PlantUML4Eclipse plug-ins)
69
+
as soon as there is a new PlantUML release (see GitHub workflows).
70
+
The net.sourceforge.plantuml.library bundle uses the EPL-licensed version of the PlantUML library.
71
+
46
72
47
73
# Main plugins (net.sourceforge.plantuml.)
48
-
- lib - plantuml.jar packaged as a bundle
49
-
- lib.jlatexmath - fragment to the lib bundle that adds the jlatexmath lib
50
-
- lib.elk - fragment to the lib bundle that adds the ELK layout engine lib
51
74
- eclipse - core Eclipse integration, including the extension point for providing diagrams
52
75
- eclipse.imagecontrol - the control for viewing the generated images
53
76
- svg - the browser-based svg view
54
77
- text - diagrams based on explicit DSL code, with support for editors based on the standard Eclipse text editor
55
78
- jdt - diagrams based on the Eclipse Java model, with support for Java and Class File editors
56
79
- ecore - diagrams based on Ecore models, with support for most Ecore editors
80
+
- uml2 - diagrams based on UML2 models
57
81
- osgi - component diagrams based on OSGi meta-data
58
82
- (xcore - diagrams based on Xcore models, with support for the Xtext editor)
59
-
- (uml2 - diagrams based on UML2 models, *obsolete*)
60
83
61
-
# Releases
62
-
63
-
Notable features in recent releases, details are found in [releases](https://github.com/hallvard/plantuml/releases).
64
-
Note that the version numbers of the plantuml.lib plugin are a bit special, since they use the version of the included plantuml.jar
65
84
85
+
# Releases
66
86
87
+
Notable features in recent releases are listed below.
88
+
You'll find all versions in the [releases](https://github.com/plantuml/plantuml-eclipse/releases) section.
89
+
(Previously, [releases were published by Hallvard Trætteberg](https://github.com/hallvard/plantuml/releases)).
90
+
91
+
Note that the net.sourceforge.plantuml.library plugin's versions are similar to those of the included PlantUML library release versions.
92
+
This plugin's life cycle is strictly coupled with that of the PlantUML library releases.
- Update dependency to PlantUML library version 1.2025.10 (see [changes](https://plantuml.com/changes))
106
+
and remove some obsolete plug-ins since we no longer need ELK library (it is now included in the PlantUML library).
107
+
- Improve saving a diagram as an SVG file, suggest the same folder for the new .svg file as the original .puml file.
108
+
- Add UML 2 model support (rendering various diagrams from UML 2 models), original plug-ins implemented by [@hallvard](https://github.com/hallvard) were updated and extended.
109
+
Thanks for the [PR](https://github.com/hallvard/plantuml/pull/187) to [@ansgarradermacher](https://github.com/ansgarradermacher).
0 commit comments