!!1. Allocation Every project has to be allocated to one of the three main repositories: * __d3web-core__ * __d3web-KnowWe__ * __Reasearch__ !!2. Creating the project in Eclipse * Do a right click on the main project (one of the three projects mentioned above) → New → Other… (or press Ctrl + N). In the window, select Maven → Maven Module * Check the checkbox called "Create a simple project (skip Archetype selection)", give the project a "Module Name" and hit Next * Enter a human-readable name into the field "Name", fill in "Description" as needed * Click "Finish". You will see the new project in the Eclipse Project Explorer. Now you can start creating or copying source files. Using the __UTF-8 encoding__ is __mandatory__ !!3. License Header Every {{.java}} file must contain the license header, starting in the first line. Be sure to have an empty line between the license and the {{package}} declaration. The license has to look like this: {{{ /* * Copyright (C) 2012 denkbares GmbH * * This is free software; you can redistribute it and/or modify it under the * terms of the GNU Lesser General Public License as published by the Free * Software Foundation; either version 3 of the License, or (at your option) any * later version. * * This software 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 Lesser General Public License for more * details. * * You should have received a copy of the GNU Lesser General Public License * along with this software; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA, or see the FSF * site: http://www.fsf.org. */ }}} !!4. First Check-In You have to perform the first check-in using the chosen main repository (c.f. above). * Right click the main project → Team → Commit * Now __exclude__ the folders {{target/}} __and__ {{.settings/}}! (Uncheck the check boxes) * Enter your commit message (comment) → Commit Now you can enable SVN access directly for your newly created project: * Perform a right click on the new project → Team → Share * Select SVN, you will find the repository location already set up * Hit Finish. To complete the process, you have to ignore {{target/}} and {{.settings}} permanently. There are two ways to do this: Either: * Select both folders in the Project Explorer with Ctrl/Command, right click → Team → Add to svn:ignore. Click OK in the window that opens. Or: * Right click on your project → Properties * In the window, select SVN Info on the left * In the table at the bottom, double click on the line with name "svn:ignore" * In the new window, enter ".settings" and "target" __separated by a newline__ in the "Enter a property value:" field * Hit Ok twice [{Image src='How%20to%20create%20your%20own%20plugin%20project/ignores.jpg' align='right' link='http://denkbares.dyndns.org/d3web/Wiki.jsp?page=How%20to%20create%20your%20own%20plugin%20project/ignores.jpg'}] Finally, commit the ignore settings: right click → Team → Commit. Enter a commit message like "ignores" and press Ok. !!5. Selecting plugins to build [{Image src='FAQ/m2eclipse-plugins.png' width='232' height='202' align='right' link='http://d3webwiki.informatik.uni-wuerzburg.de/attach/FAQ/m2eclipse-plugins.png'}] You need to enable the plugins you want to build into KnowWE when using Eclipse. Here's how: Open your Run Configuration for the KnowWE build by Hitting Run As... → Run Configurations... and add parameters for the plug-ins you want to have. For instance: You want to enable the Comment plug-in. Here, you have to add a comment-plugin parameter. You can set it to an arbitrary value ('true' for instance). See the screenshot on the right for another example.