I'm currently manually restoring (don't ask!) some documentation from an old Confluence Server to Confluence Cloud.
During the process, I find a number of things in the PlantUML plugin to no longer work or have errors and I can't seem to find any documentation for a number of things.
I'm using the latest cloud version, which is 1.2021.3 - one version higher than the current online PlantUML guide.
1. Math is sometimes not rendered on the confluence page.
Latex math formulas are working in the preview editor and most of the time on the Confluence page.
However once in a while, the raw formula is displayed on the Confluence page, instead of the rendered version.
There appears to be no pattern to this, it occurs on several browsers and can suddenly appear on a page reload. May be subject to caching as it often requires many reloads (5-10 times) to switch from working to a broken state.
Tested with this code:
@startmath
scale 5
color red
f(t)=(a_0)/2 + sum_(n=1)^ooa_ncos((npit)/L)+sum_(n=1)^oo b_n\ sin((npit)/L)
@endmath
2. Inline <math> does not render on the page
It does render in the preview editor, though.
This may be related to the issue described above.
Tested with this code:
@startuml
Bob -> Alice : Can you solve: <math>ax^2+bx+c=0</math>
Alice --> Bob: <math>x = (-b+-sqrt(b^2-4ac))/(2a)</math>
@enduml
3. XEarth produces syntax errors
The xearth keywords produces a syntax error.
Did the syntax change compared to how it's documented?
Tested with this code:
@startuml
xearth
@enduml
4. JCCKit crashes the preview editor.
It looks like support for jcckit has either dissapeared or been renamed. When I try using @startjcckit and @endjcckitd, the preview editor appears to crash => Nothing happens, including no errors are shown , and it's not possible to exit the preview editor. This results in all edits to the Confluence page being lost, as you have to reload the page to recover. It isn't even possible to save code starting with @startjcckit before the rendering.
It looks like to documentation has dissapeared, too, as the only documentation and examples I can find are on the wayback machine.
Tested with (among others) this code:
@startjcckit(600,300)
data/curves = curve2 errors2 curve1 errors1
data/curve1/title = curve 1
data/curve1/x = 0.02 0.11 0.18 0.3 0.42 0.49 0.61
data/curve1/y = 0.68 0.61 0.52 0.41 0.27 0.21 0.11
data/errors1/x = 0.021 0.01 0.017 0.024 0.023 0.025 0.027
data/errors1/y = 0.034 0.028 0.031 0.039 0.03 0.032 0.041
data/curve2/title = curve 2
data/curve2/x = 0.4 0.5 0.6 0.7 0.8 0.9
data/curve2/y = 0.17 0.29 0.45 0.61 0.64 0.66
data/errors2/x = 0 0 0 0 0 0
data/errors2/y = 0.05 0.036 0.059 0.07 0.061 0.053
background = White
defaultCoordinateSystem/ticLabelAttributes/fontSize = 0.03
defaultCoordinateSystem/axisLabelAttributes/fontSize = 0.04
defaultCoordinateSystem/axisLabelAttributes/fontStyle = bold
plot/coordinateSystem/xAxis/ = defaultCoordinateSystem/
plot/coordinateSystem/xAxis/minimum = 0.1
plot/coordinateSystem/yAxis/ = defaultCoordinateSystem/
plot/initialHintForNextCurve/className = jcckit.plot.PositionHint
plot/initialHintForNextCurve/origin = 0.06 0.1
#plot/initialHintForNextCurve/position = 0 0
plot/curveFactory/definitions = cdef1 edef1 cdef2 edef2
plot/curveFactory/cdef1/symbolFactory/className = jcckit.plot.ErrorBarFactory
plot/curveFactory/edef1/symbolFactory/className = jcckit.plot.ErrorBarFactory
plot/curveFactory/edef1/symbolFactory/attributes/className = jcckit.graphic.ShapeAttributes
plot/curveFactory/edef1/symbolFactory/attributes/fillColor = 0xcafe
plot/curveFactory/edef1/symbolFactory/attributes/lineColor = 0
plot/curveFactory/edef1/symbolFactory/size = 0.01
plot/curveFactory/edef1/withLine = false
plot/curveFactory/edef1/softClipping = false
plot/curveFactory/cdef2/symbolFactory/className = jcckit.plot.ErrorBarFactory
plot/curveFactory/cdef2/symbolFactory/symbolFactory/className = jcckit.plot.SquareSymbolFactory
plot/curveFactory/cdef2/symbolFactory/symbolFactory/attributes/className = jcckit.graphic.ShapeAttributes
plot/curveFactory/cdef2/symbolFactory/symbolFactory/attributes/fillColor = 0x40c0
plot/curveFactory/cdef2/symbolFactory/symbolFactory/attributes/lineColor =
plot/curveFactory/edef2/ = plot/curveFactory/edef1/
plot/curveFactory/edef2/symbolFactory/attributes/fillColor =
plot/curveFactory/edef2/symbolFactory/attributes/lineColor = 0
plot/curveFactory/edef2/symbolFactory/size = 0
<span>@endjcckitd</span>
Note: Above edited to include full graph.
5. @pause and @unpause sometimes fails.
It seems that sometimes @pause is treated as @enduml, causing the subsequent @unpause to generate a syntax error.
This always happens on the Confluence page, never in the preview editor.
I can only find limited documentation of the feature.
Tested with this code:
@startuml
actor bob
@pause
@unpause
actor alice
@enduml
