The XWiki war project source does not really contain anything so we will mimic what maven will do when building to create a full web project.

Clone xwiki-platform

xwiki-debug-eclipse is made of pieces of xwiki-platform so you need to clone it somewhere so that xwiki-debug-eclipse can find what it needs. It's recommended to clone xwiki-platform and xwiki-dev-tools in the same place.

git clone [email protected]:xwiki/xwiki-platform.git
# If you want to work on xwiki-commons modules
git clone [email protected]:xwiki/xwiki-commons.git
# If you want to work on xwiki-rendering modules
git clone [email protected]:xwiki/xwiki-rendering.git

Clone xwiki-debug-eclipse project

Clone it from and look at the xwiki-debug-eclipse/README.txt file instructions.

git clone

Make sure to import xwiki-debug-eclipse as an Eclipse project and not as a Maven project or it could break several pre-configured properties and it contains Eclipse linked resources based folders/files.

[OPTIONAL] Change XWIKIPLATFORM path variable

By default xwiki-debug-eclipse find xwiki-platform repository in ${PROJECT_LOC}/../../xwiki-platform (which means in the same parent folder than where you cloned xwiki-dev-tools). If that's not true for you, you can change it by going to project Properties -> Resources -> Linked Resources.

Add xwiki and hibernate config

This project comes with some example configuration you need to copy/paste and set as you need it to be:

  • src/main/webapp/WEB-INF/xwiki.cfg.default -> src/main/webapp/WEB-INF/xwiki.cfg
  • src/main/webapp/WEB-INF/ -> src/main/webapp/WEB-INF/
  • src/main/webapp/WEB-INF/hibernate.<database>.cfg.xml.default -> src/main/webapp/WEB-INF/hibernate.cfg.xml

home | next


Get Connected