Summary

• Page properties (1 modified, 0 added, 0 removed)
• Objects (1 modified, 0 added, 0 removed)
  • Confluence.Code.ConfluencePageClass[0]

Details

Page properties

Content

...	...	@@ -56,29 +56,32 @@
56	56
57	57	== Preparing the Repository ==
58	58
59		-We have created a Git repository for everyone to do his tutorials in. You can access the repository online through our Stash tool [[over here>>url:http://git.rtsys.informatik.uni-kiel.de:7990/projects/PRAK/repos/12ws-eclipse-tutorials/browse||shape="rect"]]. You will first have to configure your Stash account:
	59	+We have created a Git repository for everyone to do his tutorials in. You can access the repository online through our Stash tool [[over here>>url:http://git.rtsys.informatik.uni-kiel.de:7990/projects/PRAK/repos/12ws-eclipse-tutorials/browse||shape="rect"]]. (% style="font-size: 10.0pt;line-height: 13.0pt;" %)Clone that repository:
60	60
61		-1. Login with your Rtsys account information.
62		-1. Through the button in the top right corner, access your profile.
63		-1. Switch to the //SSH keys// tab.
64		-1. Click //Add Key// and upload a public SSH key that you want to use to access the repository.
65		-
66		-You should now be able to access the repository. Clone it:
67		-
68	68	1. Open a console window and navigate to an empty directory that the repository should be placed in.
69		-1. Enter the command [[ssh:~~/~~/git@git.rtsys.informatik.uni-kiel.de:7999/PRAK/13ss-layout-tutorials.git>>url:ssh://git@git.rtsys.informatik.uni-kiel.de:7999/PRAK/13ss-layout-tutorials.git||shape="rect"]]{{code language="none"}} .{{/code}} (including the final dot, which tells git to clone the repository into the current directory instead of a subdirectory).
	62	+1. Enter the command [[ssh:~~/~~/git@git.rtsys.informatik.uni-kiel.de:7999/PRAK/13ss-layout-tutorials.git>>url:ssh://git@git.rtsys.informatik.uni-kiel.de:7999/PRAK/13ss-layout-tutorials.git||shape="rect"]]{{code language="none"}}git clone  .{{/code}}  (including the final dot, which tells git to clone the repository into the current directory instead of a subdirectory)
70	70	1. You should now have a clone of the repository in the current directory.
71	71
72	72	You will use this repository for all your tutorial work, along with everyone else. To make sure that you don't interfere with each other, everyone will work on a different branch. This is not exactly how people usually use Git, but goes to demonstrate Git's flexibility... Add a branch for you to work in:
73	73
74		-1. Enter {{code language="none"}}git checkout -b login_name{{/code}}
	67	+1. Enter {{code language="none"}}git checkout -b login_name{{/code}}
75	75
76	76	You have just added and checked out a new branch. Everything you commit will go to this branch. To push your local commits to the server (which you will need to do so we can access your results), do the following:
77	77
78		-1. Enter {{code language="none"}}git push origin login_name{{/code}}
	71	+1. Enter {{code language="none"}}git push origin login_name{{/code}}
79	79
80	80	You would usually have to enter {{code language="none"}}git pull{{/code}} first, but since nobody will mess with your branch anyway this won't be necessary. By the way, you only need to mention {{code language="none"}}origin login_name{{/code}} with the first {{code language="none"}}git push{{/code}}, since Git doesn't know where to push the branch yet. After the first time, Git remembers the information and it will be enough to just enter {{code language="none"}}git push{{/code}}.
81	81
	75	+== Finding the KIML Sources ==
	76	+
	77	+If you want to develop a layout algorithm using KIML, you will have to get your hands at the KIML source code first. Of course, the code is available through a Git repository.
	78	+
	79	+1. Open a console window and navigate to an empty directory that the repository should be placed in.
	80	+1. Enter the command [[ssh:~~/~~/git@git.rtsys.informatik.uni-kiel.de:7999/KIELER/pragmatics.git>>url:ssh://git@git.rtsys.informatik.uni-kiel.de:7999/KIELER/pragmatics.git||shape="rect"]]{{code language="none"}}git clone  .{{/code}}
	81	+1. You should now have a clone of the repository in the current directory.
	82	+
	83	+KIML is implemented as an Eclipse plug-in that you will have to import into your Eclipse workspace. We won't do this now; it will be one of the first steps in the development of your layout algorithm.
	84	+
82	82	= Developing Your First Layout Algorithm =
83	83
84	84	Now that the preliminaries are out of the way, it's time to develop your first layout algorithm! It will, however, be a very simple one. This tutorial focuses on creating Eclipse plug-ins and on learning how to develop with KIML; thinking of and implementing cool layout algorithms is what the rest of the practical will focus on, and that is where the fun will be had!
...	...	@@ -87,12 +87,44 @@
87	87	Remember to replace each occurrence of {{code language="none"}}login_name{{/code}} with your own login name (e.g. {{code language="none"}}msp{{/code}}), and each occurrence of {{code language="none"}}Login_name{{/code}} with your capitalized login name (e.g. {{code language="none"}}Msp{{/code}}).
88	88	{{/note}}
89	89
90		-
	93	+== Setting Up Your Workspace ==
91	91
92		-
	95	+You will start by importing the plug-ins necessary to program with KIML.
93	93
	97	+1. Start Eclipse and create a new workspace.
	98	+1. Setup your workspace as explained in [[this guide>>doc:KIELER.Configuring Eclipse]].
	99	+1. We will now make the two local clones of our Git repositories known to Eclipse. To that end, open the //Git Repository Exploring// perspective through //Window// -> //Open Perspective// -> //Other//.
	100	+1. Click on //Add an existing local Git repository// and choose the location of the tutorial repository.
	101	+1. Add the KIML repository.
	102	+1. We will now import the projects required for KIML development to your workspace. Right-click on the KIML repository and choose //Import Projects//.
	103	+1. Choose //Import existing projects//, and select the //plugins// folder from the //Working Directory//. Then click //Next//.
	104	+1. Import the following plug-ins. This consitutes a basic configuration for the development of layout algorithms.\\
	105	+1*. de.cau.cs.kieler.core
	106	+1*. de.cau.cs.kieler.core.kgraph
	107	+1*. de.cau.cs.kieler.kiml
	108	+1*. de.cau.cs.kieler.kiml.gmf
	109	+1*. de.cau.cs.kieler.kiml.service
	110	+1*. de.cau.cs.kieler.kiml.ui
	111	+1*. de.cau.cs.kieler.klay.layered
	112	+1. To actually test your layout algorithms, you will need some kind of simple graph editor. The following plug-ins will add our KEG editor to your installation, which is just that.\\
	113	+1*. de.cau.cs.kieler.core.annotations
	114	+1*. de.cau.cs.kieler.core.kgraph.edit
	115	+1*. de.cau.cs.kieler.core.kivi
	116	+1*. de.cau.cs.kieler.core.model
	117	+1*. de.cau.cs.kieler.core.model.gmf
	118	+1*. de.cau.cs.kieler.core.ui
	119	+1*. de.cau.cs.kieler.karma
	120	+1*. de.cau.cs.kieler.keg
	121	+1*. de.cau.cs.kieler.keg.diagram
	122	+1*. de.cau.cs.kieler.keg.diagram.custom
	123	+1*. de.cau.cs.kieler.keg.edit
	124	+
	125	+== Adding a New Plug-in ==
	126	+
94	94
95	95
	129	+== Writing the Layout Algorithm ==
	130	+
96	96
97	97
98	98
...	...	@@ -101,14 +101,6 @@
101	101
102	102	This exercise will introduce the usage of the Eclipse Plugin Development Environment for developing new layout algorithms to be used in Eclipse diagram editors. Replace each <login> by your own login name (e.g. msp), and each <Login> by your login name with capitalized first letter (e.g. Msp). For any questions contact msp.
103	103
104		-1. Install and set up Eclipse ((% style="color: rgb(255,0,0);" %)TODO: describe steps to install and set up Eclipse(%%))
105		-1. Import the following KIELER plugins: ((% style="color: rgb(255,0,0);" %)TODO: describe steps to access and import the KIELER plugins and update the list(%%))\\
106		-1*. de.cau.cs.kieler.core
107		-1*. de.cau.cs.kieler.core.kgraph
108		-1*. (% style="font-size: 10.0pt;line-height: 13.0pt;" %)de.cau.cs.kieler.kiml
109		-1*. (% style="font-size: 10.0pt;line-height: 13.0pt;" %)de.cau.cs.kieler.kiml.service
110		-1*. de.cau.cs.kieler.kiml.ui
111		-1*. (% style="font-size: 10.0pt;line-height: 13.0pt;" %)de.cau.cs.kieler.klay.layered
112	112	1. Create a new plugin\\
113	113	11. //File → New →// Other... //→// Plug-in Development //→// Plug-in Project
114	114	11. Project name: de.cau.cs.rtprak.<login>.tutorial2

Confluence.Code.ConfluencePageClass[0]

Id

...	...	@@ -1,1 +1,1 @@
1		-6160457
	1	+6160472

URL

...	...	@@ -1,1 +1,1 @@
1		-https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/SS13LayPract/pages/6160457/KIML
	1	+https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/SS13LayPract/pages/6160472/KIML