Freeplane/C4/Groovy-Script-and-Freeplane/English

Visual Cue	Narration
Slide Number 1 Title Slide	Welcome to the tutorial on Groovy Script and Freeplane
Slide Number 2 Learning Objectives	In this tutorial, we will, Learn about Groovy script Write Groovy scripts Add the Groovy scripts to the Freeplane scripts folder Run the script in the Freeplane interface
Slide Number 3 Learning Objectives	Add child nodes to a map using the script Add a hyperlink to a node using script
Slide Number 4 System and Software Requirement	To record this tutorial, I am using Ubuntu Linux v16.04 OS Freeplane v1.7.10 Firefox web browser v78 A working Internet connection
Slide Number 5 Pre-requisites https://www.spoken-tutorial.org	To follow this tutorial, Learner must be familiar with the Freeplane interface. For pre-requisite tutorials, please visit this site.
Slide Number 10 Introduction to Scripting https://groovy-lang.org/ [https://www.freeplane.org/wiki/index.php/Scripting	Link for the Groovy website is shown here. Link for simple example scripts for use in Freeplane is also shown here.
Slide Number 7 Possible Uses	Teachers can extend the Groovy scripting method to import, Student names Marks and grades or To collate results
Slide Number 8 Groovy	Groovy is an object oriented programming language, based on Java platform. Groovy scripts can be executed in the nodes in Freeplane.
Open Freeplane.	Let’s open Freeplane.
Click on Tools, Scripts.	Click on Tools, in the menu and select Scripts. Notice that, there are no scripts present in the sub-menu now.
Click on Tools, Open user directory.	Next, click on Tools and select Open user directory.
	A new window opens with Freeplane related files and folders.
Hover mouse next to .config.	Notice the path for the scripts from here. It is in the dot config directory, under freeplane 1.7.x. Learner must note down the path for the scripts folder in his/her computer.
Hover mouse next to .config.	Scripts must be saved in this scripts directory to be executed. They are named with extension dot groovy.
Click on x sign to close the file manager window.	Click on the x sign to close this window.
Press the Windows.	Press the Windows key on the keyboard.
Type gedit and press Enter.	Type gedit in the search form and press Enter. A gedit window opens. Let's open a text editor to write a script.
Cursor on gedit window.	Windows users may use notepad.
Slide Number 8 Adding Student Names	A teacher wants to add 20 students as 20 child nodes to a Language class. They need to be named as student 1 to student 20, according to roll numbers.
Cursor on gedit window.	I will write a short for loop structure and set the number of names required.
Type, for (i=1;i<21;i++) and press Enter.	Start a for loop as seen on the screen. Here, i is a variable.
Cursor on i=1, i<21 and i++.	This means for values change from i from one to i less than 21. Value of i is incremented in units of one.
Type { and press Enter. Type } and press Enter.	I will type a curly brace. I will also close the curly brace in the next line. We will enter the required commands inside the curly braces.
Type def child = node.createChild("student$i")	Next, let's write a command to add the 20 student nodes. Enter command as seen on the screen.
Cursor on def child and student$i.	Here we define a child and create a child node as student$i.
Cursor on the command line.	Learner must retain the syntax for the program to be functional.
Click on File , Save.	Click on File, Save in the menu to open the save a dialogue box.
	We cannot change the folder to .config via menu. It is because, the name starts with dot.
Cursor on the path folder.	So, we will first save the script in the home directory. Later move the file to the scripts folder using terminal command.
Type addchild.groovy Click on save	I will give file name addchild.groovy and click on Save.
Click on the x sign.	Click on the x sign on the top to close gedit.
Press Ctrl+Alt+T.	Open a terminal by pressing Ctrl, Alt and T keys together.
Type, mv addchild.groovy ~/.config/freeplane/1.7.x/scripts	Move the script file to the scripts directory using the command as seen here.
Press Enter.	Press Enter to execute the command.
Type cd .config/freeplane/1.7.x/scripts.	Change to the scripts directory using the command as seen here.
Type ls and press Enter.	Type ls to list the files in the directory.
Cursor on the scripts folder.	Notice that the script file is now in the scripts folder.
Cursor on the path in the terminal.	Learners must save the script in the correct script folder in their computer.
Type gedit hyperlink.groovy and press Enter.	I will write one more script. Type gedit hyperlink dot groovy and press Enter. The text editor opens.
Show screenshot of spoken tutorial web page.	For demonstration, I will choose the web address of the Freeplane tutorial link.
Type, node.link.text = ' . Do not press Enter.	Type, node.link.text =, following by a single quote.
Type, 'https://spoken-tutorial.org/tutorial-search/?search_foss=Freeplane&search_language=English' and press Enter.	Now, copy and paste the desired web address. I have already copied the desired web address link. Pate the desired web address and close the single quote.
Press Ctrl+S . Press Ctrl+Q .	You may pause the video to add the desired web address of your choice. Press Control-S to save the file and press Control-Q to quit gedit. Press Control-Q to quit gedit. The new scripts are saved in the correct path and Freeplane can read it.
Slide Number 9 Reading the script	We must close and reopen Freeplane for the scripts folder to be read. Then, the newly added script will be read when Freeplane starts.
Click on File, Quit Freeplane.	Click on File , Quit Freeplane, to Close Freeplane.
	A save map dialogue box appears.
Click on No.	I will Click on No, and will not save the present map.
Open Freeplane.	Let’s reopen Freeplane.
Click on Tools, scripts.	Click on Tools, scripts in the menu. Notice that the addchild and hyperlink scripts are visible now.
Type classes in the root node.	I will rename the root node to classes.
Press Insert to add a child node and name it Software skill.	I will add child nodes to the map and name it Software skill. Let’s add two more children to the root node.
Press Enter, name the child node language 2.	I will name them, language1 and language2.
Cursor on language1 node.	Let’s add the 20 student names to the language1 node.
Select the language1 node.	For this first select the language1 node.
Click on Tools, Scripts, addchild.	Next, run the script by clicking on Tools, Scripts, addchild.
Click on Yes.	A confirmation prompt appears on the screen with a warning message. It prompts the user whether to run the script. Click on Yes to run the script.
Hover mouse over the newly added nodes.	Notice that 20 child nodes are added to the map. They are named student 1 to student 20.
Cursor on the map.	We can also modify node properties in a similar fashion using scripts.
Press Control+Z.	We can run the script on any number of selected nodes. Let’s press Control-Z to undo the addition of child nodes in the map.
Select language1 and language2 nodes.	Let’s select language1 and language2 nodes.
Click on Tools, Scripts, addchild.	Run the addchild script again.
Click on Yes.	Again, the confirmation prompt appears on the screen. Let’s click on Yes.
Show the added nodes.	Now, the list of 20 students gets added to both the selected nodes.
Select the Software skill node.	Let’s hyperlink the Freeplane tutorial web address to the Software skill node. Select the Software skill node.
Click on Tools, Scripts, addchild.	Next, run the script by clicking on Tools, Scripts, and hyperlink.
Click on Yes.	Click on Yes on the prompt to run the script.
Cursor next to the Software skill node.	Notice the red arrow, next to the node, indicating the link.
Click on the Software skill node.	Click on the Software skill node. A web browser opens.
Cursor on the web page.	If you have a working internet connection, the page will load. You can also link to files in your computer in this manner.
	Many scripts and examples are available online.
Highlight in web browser https://www.freeplane.org/wiki/index.php/Scripting.	Go to the Freeplane web address, as seen here.
Scroll down.	Scroll down and notice the example Groovy scripts available here.
Cursor on groove-learn and Script collection links.	Notice the learn Groovy and Script collection link. Learner may use these resources for learning purposes.
Close the web browser and go back to Freeplane.	Close the web browser and go back to Freeplane.
Cursor on Press File , Save map.	You may choose to save this file.
Cursor on File , Quit Freeplane.	Click on File, Quit Freeplane or press Control-Qto quit Freeplane.
Slide Number 11 Summary	Now let's summarize. In this tutorial we, Learned about Groovy script Wrote Groovy scripts Added the Groovy scripts to the Freeplane scripts folder
Slide Number 12 Summary	Executed the script in the Freeplane interface to add Child nodes in the map and Hyperlink to a node
Slide Number 13 Assignment	For assignment activity, please do the following. Write a Groovy script of your choice and execute it in Freeplane.
Slide Number 14 Spoken Tutorial Project	This video summarises the Spoken Tutorial Project. Please download and watch it.
Slide Number 15 Spoken Tutorial workshops	The Spoken Tutorial team: conducts workshops and give certificates. For more details, please write to us.
Slide Number 16 Forum for specific questions	Please post your timed queries in this forum.
Slide Number 17 Acknowledgement	Spoken Tutorial Project is funded by NMEICT, MHRD, Government of India.
	This is Rani from IIT, Bombay. Thank you for joining.

Contributors and Content Editors

Madhurig, PoojaMoolya, Ranipv076, Snehalathak