-
Notifications
You must be signed in to change notification settings - Fork 0
/
desktopActions-v0.1.addon.mm
528 lines (486 loc) · 26.9 KB
/
desktopActions-v0.1.addon.mm
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
<map version="freeplane 1.7.0">
<!--To view this file, download free mind mapping software Freeplane from http://freeplane.sourceforge.net -->
<node TEXT="Desktop Actions" FOLDED="false" ID="ID_1910557408" CREATED="1587042042523" MODIFIED="1587042898086" LINK="https://github.com/giulioscattolin/freeplane-desktop-actions-addon" BACKGROUND_COLOR="#97c7dc" STYLE="oval">
<font SIZE="16" BOLD="true" ITALIC="true"/>
<hook NAME="MapStyle">
<properties fit_to_viewport="false" edgeColorConfiguration="#808080ff,#ff0000ff,#0000ffff,#00ff00ff,#ff00ffff,#00ffffff,#7c0000ff,#00007cff,#007c00ff,#7c007cff,#007c7cff,#7c7c00ff"/>
<map_styles>
<stylenode LOCALIZED_TEXT="styles.root_node" STYLE="oval" UNIFORM_SHAPE="true" VGAP_QUANTITY="24.0 pt">
<font SIZE="24"/>
<stylenode LOCALIZED_TEXT="styles.predefined" POSITION="right" STYLE="bubble">
<stylenode LOCALIZED_TEXT="default" ICON_SIZE="12.0 pt" COLOR="#000000" STYLE="fork">
<font NAME="SansSerif" SIZE="10" BOLD="false" ITALIC="false"/>
</stylenode>
<stylenode LOCALIZED_TEXT="defaultstyle.details"/>
<stylenode LOCALIZED_TEXT="defaultstyle.attributes">
<font SIZE="9"/>
</stylenode>
<stylenode LOCALIZED_TEXT="defaultstyle.note" COLOR="#000000" BACKGROUND_COLOR="#ffffff" TEXT_ALIGN="LEFT"/>
<stylenode LOCALIZED_TEXT="defaultstyle.floating">
<edge STYLE="hide_edge"/>
<cloud COLOR="#f0f0f0" SHAPE="ROUND_RECT"/>
</stylenode>
</stylenode>
<stylenode LOCALIZED_TEXT="styles.user-defined" POSITION="right" STYLE="bubble">
<stylenode LOCALIZED_TEXT="styles.topic" COLOR="#18898b" STYLE="fork">
<font NAME="Liberation Sans" SIZE="10" BOLD="true"/>
</stylenode>
<stylenode LOCALIZED_TEXT="styles.subtopic" COLOR="#cc3300" STYLE="fork">
<font NAME="Liberation Sans" SIZE="10" BOLD="true"/>
</stylenode>
<stylenode LOCALIZED_TEXT="styles.subsubtopic" COLOR="#669900">
<font NAME="Liberation Sans" SIZE="10" BOLD="true"/>
</stylenode>
<stylenode LOCALIZED_TEXT="styles.important">
<icon BUILTIN="yes"/>
</stylenode>
</stylenode>
<stylenode LOCALIZED_TEXT="styles.AutomaticLayout" POSITION="right" STYLE="bubble">
<stylenode LOCALIZED_TEXT="AutomaticLayout.level.root" COLOR="#000000" STYLE="oval" SHAPE_HORIZONTAL_MARGIN="10.0 pt" SHAPE_VERTICAL_MARGIN="10.0 pt">
<font SIZE="18"/>
</stylenode>
<stylenode LOCALIZED_TEXT="AutomaticLayout.level,1" COLOR="#0033ff">
<font SIZE="16"/>
</stylenode>
<stylenode LOCALIZED_TEXT="AutomaticLayout.level,2" COLOR="#00b439">
<font SIZE="14"/>
</stylenode>
<stylenode LOCALIZED_TEXT="AutomaticLayout.level,3" COLOR="#990000">
<font SIZE="12"/>
</stylenode>
<stylenode LOCALIZED_TEXT="AutomaticLayout.level,4" COLOR="#111111">
<font SIZE="10"/>
</stylenode>
<stylenode LOCALIZED_TEXT="AutomaticLayout.level,5"/>
<stylenode LOCALIZED_TEXT="AutomaticLayout.level,6"/>
<stylenode LOCALIZED_TEXT="AutomaticLayout.level,7"/>
<stylenode LOCALIZED_TEXT="AutomaticLayout.level,8"/>
<stylenode LOCALIZED_TEXT="AutomaticLayout.level,9"/>
<stylenode LOCALIZED_TEXT="AutomaticLayout.level,10"/>
<stylenode LOCALIZED_TEXT="AutomaticLayout.level,11"/>
</stylenode>
</stylenode>
</map_styles>
</hook>
<hook NAME="AutomaticEdgeColor" COUNTER="11" RULE="ON_BRANCH_CREATION"/>
<attribute NAME="name" VALUE="desktopActions"/>
<attribute NAME="version" VALUE="v0.1"/>
<attribute NAME="author" VALUE="Giulio Scattolin <giulio.scattolin@gmail.com>"/>
<attribute NAME="freeplaneVersionFrom" VALUE="1.7.2"/>
<attribute NAME="freeplaneVersionTo" VALUE=""/>
<attribute NAME="updateUrl" VALUE="https://github.com/giulioscattolin/freeplane-desktop-actions-addon"/>
<richcontent TYPE="NOTE">
<html>
<head>
</head>
<body>
<p>
The homepage of this add-on should be set as the link of the root node.
</p>
<p>
The basic properties of this add-on. They can be used in script names and other attributes, e.g. "${name}.groovy".
</p>
<ul>
<li>
name: The name of the add-on, normally a technically one (no spaces, no special characters except _.-).
</li>
<li>
author: Author's name(s) and (optionally) email adresses.
</li>
<li>
version: Since it's difficult to protect numbers like 1.0 from Freeplane's number parser it's advised to prepend a 'v' to the number, e.g. 'v1.0'.
</li>
<li>
freeplane-version-from: The oldest compatible Freeplane version. The add-on will not be installed if the Freeplane version is too old.
</li>
<li>
freeplane-version-to: Normally empty: The newest compatible Freeplane version. The add-on will not be installed if the Freeplane version is too new.
</li>
<li>
updateUrl: URL of the file containing information (version, download url) on the latest version of this add-on. By default: "${homepage}/version.properties"
</li>
</ul>
</body>
</html>
</richcontent>
<node TEXT="description" POSITION="left" ID="ID_640589168" CREATED="1587042155194" MODIFIED="1587042155204">
<edge COLOR="#ff0000"/>
<richcontent TYPE="NOTE">
<html>
<head>
</head>
<body>
<p>
Description would be awkward to edit as an attribute.
</p>
<p>
So you have to put the add-on description as a child of the <i>'description'</i> node.
</p>
<p>
To translate the description you have to define a translation for the key 'addons.${name}.description'.
</p>
</body>
</html>
</richcontent>
<node ID="ID_1113048946" CREATED="1587042394444" MODIFIED="1587043784363"><richcontent TYPE="NODE">
<html>
<head>
</head>
<body>
<p>
This add-on provides a meaningful script to open files, directories and URIs using the <a href="https://docs.oracle.com/javase/8/docs/api/java/awt/Desktop.html">java.awt.Desktop</a> class: it looks for the associated application registered on the current platform, and launch it to handle a URI or file.
</p>
</body>
</html>
</richcontent>
</node>
</node>
<node TEXT="changes" POSITION="left" ID="ID_1150606695" CREATED="1587042155205" MODIFIED="1587042155208">
<edge COLOR="#0000ff"/>
<richcontent TYPE="NOTE">
<html>
<head>
</head>
<body>
<p>
Change log of this add-on: append one node for each noteworthy version and put the details for each version into a child node.
</p>
</body>
</html>
</richcontent>
</node>
<node TEXT="license" FOLDED="true" POSITION="left" ID="ID_924171899" CREATED="1587042155209" MODIFIED="1587042155213">
<edge COLOR="#00ff00"/>
<richcontent TYPE="NOTE">
<html>
<head>
</head>
<body>
<p>
The add-ons's license that the user has to accept before she can install it.
</p>
<p>
</p>
<p>
The License text has to be entered as a child of the <i>'license'</i> node, either as plain text or as HTML.
</p>
</body>
</html>
</richcontent>
<node TEXT="
This add-on is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
" ID="ID_1745521829" CREATED="1587042155214" MODIFIED="1587042155215"/>
</node>
<node TEXT="preferences.xml" POSITION="left" ID="ID_142859732" CREATED="1587042155223" MODIFIED="1587042155227">
<edge COLOR="#ff00ff"/>
<richcontent TYPE="NOTE">
<html>
<head>
</head>
<body>
<p>
<font color="#000000" face="SansSerif, sans-serif">The child node contains the add-on configuration as an extension to mindmapmodemenu.xml (in Tools->Preferences->Add-ons). </font>
</p>
<p>
<font color="#000000" face="SansSerif, sans-serif">Every property in the configuration should receive a default value in <i>default.properties</i> node.</font>
</p>
</body>
</html>
</richcontent>
</node>
<node TEXT="default.properties" POSITION="left" ID="ID_1874393552" CREATED="1587042155228" MODIFIED="1587042155231">
<edge COLOR="#00ffff"/>
<richcontent TYPE="NOTE">
<html>
<head>
</head>
<body>
<p>
These properties are used for:
</p>
<ul>
<li>
Each property defined in the preferences should have a default value in the attributes of this node.
</li>
<li>
For each menu item with an icon add an attribute with the icon key (use developer tool menuItemInfo) as key and the icon path as value. Example: '${name}.icon': '/images/${name}-icon.png'
</li>
</ul>
</body>
</html>
</richcontent>
</node>
<node TEXT="translations" POSITION="left" ID="ID_278898916" CREATED="1587042155232" MODIFIED="1587042155235">
<edge COLOR="#7c0000"/>
<richcontent TYPE="NOTE">
<html>
<head>
</head>
<body>
<p>
The translation keys that this script uses. Define one child node per supported locale. The attributes contain the translations. Define at least
</p>
<ul>
<li>
'addons.${name}' for the add-on's name
</li>
<li>
'addons.${name}.description' for the description, e.g. in the add-on overview dialog (not necessary for English)
</li>
<li>
'addons.${name}.<scriptname>' for each script since it will be the menu title.
</li>
</ul>
</body>
</html>
</richcontent>
<node TEXT="en" ID="ID_1722186393" CREATED="1587042155236" MODIFIED="1587042643678">
<attribute_layout NAME_WIDTH="116.99999651312838 pt" VALUE_WIDTH="116.99999651312838 pt"/>
<attribute NAME="addons.${name}" VALUE="Desktop Actions"/>
<attribute NAME="addons.${name}.Open" VALUE="Open or browse resource.."/>
</node>
</node>
<node TEXT="deinstall" POSITION="left" ID="ID_1062736255" CREATED="1587042155268" MODIFIED="1587042604842">
<edge COLOR="#00007c"/>
<richcontent TYPE="NOTE">
<html>
<head>
</head>
<body>
<p>
List of files and/or directories to remove on uninstall
</p>
</body>
</html>
</richcontent>
<attribute NAME="delete" VALUE="${installationbase}/addons/${name}.script.xml"/>
<attribute NAME="delete" VALUE="${installationbase}/addons/${name}/scripts/Open.groovy"/>
</node>
<node TEXT="scripts" POSITION="right" ID="ID_1016645595" CREATED="1587042155281" MODIFIED="1587042155288">
<edge COLOR="#007c00"/>
<richcontent TYPE="NOTE">
<html>
<head>
</head>
<body>
<p>
An add-on may contain multiple scripts. The node text defines the script name (e.g. insertInlineImage.groovy). The name must have a suffix of a supported script language like .groovy or .js and may only consist of letters and digits. The script properties have to be configured via attributes:
</p>
<p>
</p>
<p>
* menuLocation: <locationkey>
</p>
<p>
   - Defines the menu location, defaults a sub menu 'main_menu_scripting/addons.${name}'.
</p>
<p>
   - Use developer tool menuItemInfo to inspect menu location keys.
</p>
<p>
   - This attribute is mandatory
</p>
<p>
</p>
<p>
* menuTitleKey: <key>
</p>
<p>
   - The menu item title will be looked up under the translation key <key> - don't forget to define its translation.
</p>
<p>
   - This attribute is mandatory
</p>
<p>
</p>
<p>
* executionMode: <mode>
</p>
<p>
   - The execution mode as described in the Freeplane wiki (http://freeplane.sourceforge.net/wiki/index.php/Scripting)
</p>
<p>
   - ON_SINGLE_NODE: Execute the script once. The <i>node</i> variable is set to the selected node.
</p>
<p>
   - ON_SELECTED_NODE: Execute the script n times for n selected nodes, once for each node.
</p>
<p>
   - ON_SELECTED_NODE_RECURSIVELY: Execute the script on every selected node and recursively on all of its children.
</p>
<p>
   - In doubt use ON_SINGLE_NODE.
</p>
<p>
   - This attribute is mandatory
</p>
<p>
</p>
<p>
* keyboardShortcut: <shortcut>
</p>
<p>
   - Optional: keyboard combination / accelerator for this script, e.g. control alt I
</p>
<p>
   - Use lowercase letters for modifiers and uppercase for letters. Use no + signs.
</p>
<p>
   - The available key names are listed at http://download.oracle.com/javase/1.4.2/docs/api/java/awt/event/KeyEvent.html#VK_0
</p>
<p>
     In the list only entries with a 'VK_' prefix count. Omit the prefix in the shortcut definition.
</p>
<p>
</p>
<p>
* Permissions that the script(s) require, each either false or true:
</p>
<p>
   - execute_scripts_without_asking
</p>
<p>
   - execute_scripts_without_file_restriction: permission to read files
</p>
<p>
   - execute_scripts_without_write_restriction: permission to create/change/delete files
</p>
<p>
   - execute_scripts_without_exec_restriction: permission to execute other programs
</p>
<p>
   - execute_scripts_without_network_restriction: permission to access the network
</p>
<p>
  Notes:
</p>
<p>
  - The set of permissions is fixed.
</p>
<p>
  - Don't change the attribute names, don't omit one.
</p>
<p>
  - Set the values either to true or to false
</p>
<p>
  - In any case set execute_scripts_without_asking to true unless you want to annoy users.
</p>
</body>
</html>
</richcontent>
<node TEXT="Open.groovy" FOLDED="true" ID="ID_57172042" CREATED="1587042540840" MODIFIED="1587042627834">
<attribute_layout NAME_WIDTH="207.7499938085677 pt" VALUE_WIDTH="207.7499938085677 pt"/>
<attribute NAME="menuTitleKey" VALUE="addons.${name}.Open"/>
<attribute NAME="menuLocation" VALUE="main_menu_scripting/addons.${name}"/>
<attribute NAME="executionMode" VALUE="on_single_node"/>
<attribute NAME="keyboardShortcut" VALUE=""/>
<attribute NAME="execute_scripts_without_asking" VALUE="true"/>
<attribute NAME="execute_scripts_without_file_restriction" VALUE="true"/>
<attribute NAME="execute_scripts_without_write_restriction" VALUE="true"/>
<attribute NAME="execute_scripts_without_exec_restriction" VALUE="true"/>
<attribute NAME="execute_scripts_without_network_restriction" VALUE="true"/>
<node TEXT="// @ExecutionModes({ON_SELECTED_NODE})

/*
 
 Open.groovy

 It launches the associated application to open or browse the resource using the java.awt.Desktop class (see https://docs.oracle.com/javase/8/docs/api/java/awt/Desktop). It handles files and directories by their path (being absolute or relative to the directory containing the map file) and URIs.

 */

package giulioscattolin.freeplane.desktopactions

import java.awt.Desktop
import java.nio.file.Files
import java.nio.file.Path
import java.nio.file.Paths
import org.freeplane.plugin.script.FreeplaneScriptBaseClass

class Open extends FreeplaneScriptBaseClass {
 def run() {
 // Define flags for action support.
 def isOpenActionSupportedFlag = false
 def isBrowseActionSupportedFlag = false

 // Obtain the desktop instance.
 def desktop = obtainDesktopInstance()
 // If desktop is an invalid reference..
 if (desktop == null) {
 // Quit.
 return
 }

 // If the OPEN action is supported..
 if (isOpenActionSupported(desktop)) {
 // Activate the appropriate flag.
 isOpenActionSupportedFlag = true

 // If the resource has been opened successfully using the content of the selected node as an absolute path..
 if (openResourceUsingAbsolutePath(node.text, desktop)) {
 // Quit.
 return
 }

 // If the resource has been opened successfully using the content of the selected node as a relative path to the directory containing the map file..
 if (openResourceUsingPathRelativeToMapFileDirectory(node.text, desktop)) {
 // Quit.
 return
 }
 }
 // If the BROWSE action is supported..
 if (isBrowseActionSupported(desktop)) {
 // Activate the appropriate flag.
 isBrowseActionSupportedFlag = true
 
 // If the resource has been opened successfully using the content of the selected node as an URI..
 if (openResourceUsingURI(node.text, desktop)) {
 // Quit.
 return
 }
 }

 if (isOpenActionSupportedFlag && isBrowseActionSupportedFlag) {
 // There are no more options, the resource won't be opened.
 // Inform the user.
 setStatusInfo("The resource cannot be opened because the node does not contain the path of an existent file / directory or a valid URI.")
 // Finally, quit.
 }

 // The user should have already been informed, quit.
 }

 def obtainDesktopInstance() {
 // If the Desktop object is supported..
 if (Desktop.isDesktopSupported()) {
 // Return the Desktop instance.
 return Desktop.getDesktop()
 } else {
 // Inform the user.
 setStatusInfo("The resource cannot be opened because the Desktop class is not supported on the current platform.")
 // Finally, report error.
 return null
 }
 }

 def isOpenActionSupported(desktop) {
 // If the OPEN action is supported..
 if (desktop.isSupported(Desktop.Action.OPEN)) {
 // Return true
 return true
 } else {
 // Inform the user.
 setStatusInfo("The resource cannot be opened because the OPEN action is not supported on the current platform.")
 // Finally, return false.
 return false
 }
 }

 def isBrowseActionSupported(desktop) {
 // If the BROWSE action is supported..
 if (desktop.isSupported(Desktop.Action.BROWSE)) {
 // Return true
 return true
 } else {
 // Inform the user.
 setStatusInfo("The resource cannot be opened because the BROWSE action is not supported on the current platform.")
 // Finally, return false.
 return false
 }
 }

 def openResourceUsingAbsolutePath(nodeText, desktop) {
 // Supposing the content of the selected node is the absolute path of a resource, create a Path instance from its string representation.
 def path = Paths.get(nodeText)
 // Obtain the associated file instance.
 def file = path.toFile()
 // If the file exists..
 if (file.exists()) {
 // Inform the user.
 setStatusInfo("Opening the resource using its absolute path..")
 
 // If the file is opened successfully..
 if (openFile(file, desktop)) {
 // Report success.
 return true
 } else {
 // Report insuccess.
 return false
 }
 } else {
 // Report insuccess.
 return false
 }
 }
 
 def openResourceUsingPathRelativeToMapFileDirectory(nodeText, desktop) {
 // Supposing the content of the selected node is the path of a resource relative to the directory containing the map file, obtain the parent directory as a file.
 def parentDirectory = node.map.file.getParentFile()
 // Create the appropriate File instance.
 File file = new File(parentDirectory, node.text)
 // If the file exists..
 if (file.exists()) {
 // Inform the user.
 setStatusInfo("Opening the resource using the path relative to map file directory..")

 // If the file is opened successfully..
 if (openFile(file, desktop)) {
 // Report success.
 return true
 } else {
 // Report insuccess.
 return false
 }
 } else {
 // Report insuccess.
 return false
 }
 }

 def openFile(file, desktop) {
 // Try to open the file..
 try {
 desktop.open(file)
 } catch (IOException e) {
 // If the specified file has no associated application or the associated application fails to be launched, inform the user.
 setStatusInfo("The resource cannot be opened because it has no associated application or the associated application failed to be launched.")
 
 // Report insuccess.
 return false
 } catch (SecurityException e) {
 // If a security manager exists and its SecurityManager.checkRead (java.lang.String) method denies read access to the file, or it denies the AWTPermission("showWindowWithoutWarningBanner") permission, or the calling thread is not allowed to create a subprocess.
 setStatusInfo("The resource cannot be opened because a security exception has been thrown.")
 
 // Report insuccess.
 return false
 }

 // Inform the user.
 setStatusInfo("The resource has been successfully opened!")
 // Report success.
 return true
 }

 def openResourceUsingURI(nodeText, desktop) {
 // Supposing the content of the selected node is the URI of the resource, tries to create an URI instance.
 try {
 def uri = new URI(nodeText)

 // If the uri is browsed successfully..
 if (browseUri(uri, desktop)) {
 // Report success.
 return true
 }
 } catch (URISyntaxException e) {
 // The given string violates RFC 2396.
 // Ignore and continue.
 }

 // Report insuccess.
 return false
 }

 def browseUri(uri, desktop) {
 // Try to open the file..
 try {
 desktop.browse(uri)
 } catch (IOException e) {
 // If the user default browser is not found, or it fails to be launched, or the default handler application failed to be launched, inform the user.
 setStatusInfo("The resource cannot be opened because the user default browser is not found, or it fails to be launched, or the default handler application failed to be launched.")
 
 // Report insuccess.
 return false
 } catch (SecurityException e) {
 // If a security manager exists and its SecurityManager.checkRead (java.lang.String) method denies read access to the file, or it denies the AWTPermission("showWindowWithoutWarningBanner") permission, or the calling thread is not allowed to create a subprocess.
 setStatusInfo("The resource cannot be opened because a security exception has been thrown.")
 
 // Report insuccess.
 return false
 } catch (IllegalArgumentException e) {
 // If the necessary permissions are not available and the URI can not be converted to a URL.
 setStatusInfo("The resource cannot be opened because the necessary permissions are not available and the URI can not be converted to an URL.")
 
 // Report insuccess.
 return false
 }

 // Inform the user.
 setStatusInfo("The resource has been successfully browsed!")
 // Report success.
 return true
 }

 def setStatusInfo(text) {
 c.setStatusInfo(text)
 }
}

" ID="ID_1826042621" CREATED="1587043824152" MODIFIED="1587043824156"/>
</node>
</node>
<node TEXT="lib" POSITION="right" ID="ID_1113283769" CREATED="1587042155310" MODIFIED="1587042155314">
<edge COLOR="#7c007c"/>
<richcontent TYPE="NOTE">
<html>
<head>
</head>
<body>
<p>
An add-on may contain any number of nodes containing binary files (normally .jar files) to be added to the add-on's classpath.
</p>
<p>
</p>
<p>
 - The immediate child nodes contain the name of the file, e.g. 'mysql-connector-java-5.1.25.jar'). Put the file into a 'lib' subdirectory of the add-on base directory.
</p>
<p>
</p>
<p>
 - The child nodes of these nodes contain the actual files.
</p>
<p>
</p>
<p>
 - Any lib file will be extracted in <installationbase>/<addonname>/lib.
</p>
<p>
</p>
<p>
 - The files will be processed in the sequence as seen in the map.
</p>
</body>
</html>
</richcontent>
</node>
<node TEXT="zips" POSITION="right" ID="ID_1041050067" CREATED="1587042155316" MODIFIED="1587042155321">
<edge COLOR="#007c7c"/>
<richcontent TYPE="NOTE">
<html>
<head>
</head>
<body>
<p>
An add-on may contain any number of nodes containing zip files.
</p>
<p>
</p>
<p>
 - The immediate child nodes contain a description of the zip. The devtools script releaseAddOn.groovy allows automatic zip creation if the name of this node matches a directory in the current directory.
</p>
<p>
</p>
<p>
 - The child nodes of these nodes contain the actual zip files.
</p>
<p>
</p>
<p>
 - Any zip file will be extracted in the <installationbase>. Currently, <installationbase> is always Freeplane's <userhome>, e.g. ~/.freeplane/1.3.
</p>
<p>
</p>
<p>
 - The files will be processed in the sequence as seen in the map.
</p>
</body>
</html>
</richcontent>
</node>
<node TEXT="images" POSITION="right" ID="ID_1835384402" CREATED="1587042155322" MODIFIED="1587042155326">
<edge COLOR="#7c7c00"/>
<richcontent TYPE="NOTE">
<html>
<head>
</head>
<body>
<p>
An add-on may define any number of images as child nodes of the images node. The actual image data has to be placed as base64 encoded binary data into the text of a subnode.
</p>
<p>
The images are saved to the <i>${installationbase}/resources/images</i> directory.
</p>
<p>
</p>
<p>
The following images should be present:
</p>
<ul>
<li>
<i>${name}-icon.png</i>, like <i>oldicons-theme-icon.png</i>. This will be used in the app-on overview.
</li>
<li>
<i>${name}-screenshot-1.png</i>, like <i>oldicons-theme-screenshot-1.png</i>. This will be used in the app-on details dialog. Further images can be included but they are not used yet.
</li>
</ul>
<p>
Images can be added automatically by releaseAddOn.groovy or must be uploaded into the map via the script <i>Tools->Scripts->Insert Binary</i> since they have to be (base64) encoded as simple strings.
</p>
</body>
</html>
</richcontent>
</node>
</node>
</map>