wiki:DevEnv

Install docx4all

/projects/docx4all/DevEnv

(last checked 12 Nov 2008)

Subversion - Quick Instructions

svn co  http://dev.plutext.org/svn/docx4all/trunk/docx4all docx4all

open pom.xml, find the line which reads

<systemPath>/usr/lib/jvm/java-6-sun/jre/lib/rt.jar</systemPath>

and edit it to suit your system.

mvn install

Eclipse

These detailed instructions are for Eclipse. If you use a different IDE, you will have to follow your nose. Please take note of your steps, and post here. IntelliJ

Prerequisites

  • Java 6
  • Download and install Eclipse (of course)
  • Install an Eclipse subversion plugin

Instructions

  • File > New "Project .." > SVN > Checkout Projects from SVN
  • Click folder "trunk", and select docx4all; click next
  • You want to check it out as a project configured using the New Project Wizard
  • Then select Java > Java Project; click Next
  • Choose a project name (eg docx4all) then click Next
  • Click Finish (we'll define the Java build settings in a later step)

After a couple of other dialog boxes, you should have the new project in your workspace.

Now, we need to configure the class path etc within Eclipse so that it can build.

  1. Build Path > Configure Build Path > Java Build Path > Source tab

Add src/main/java

Add src/main/resources

  1. Make sure you have Maven and its plugin installed - see Prerequisites above.

Right click on project > Maven 2 > Enable Dependency Management

Verify that Build Path > Configure Build Path > Java Build Path > Libraries now includes Maven2 Managed Dependencies

The project should now be working in Eclipse without errors.

Run the Editor

In order to run as a JavaFX application you need to configure a launch configuration for the project.

  1. Go to Run > Open Run Dialog ('Run Configuration' in later versions of Eclipse)
  1. In the left side pane of the dialog, choose Java application and click the 'New' button on the toolbar.
  1. In the right side pane, type in any name you like as the name of the launch configuration. Make sure the project name in the Main tab is docx4all
  1. For Main class, press the search button, and choose org.docx4all.ui.main.WordMLEditor

Set the VM argument:

-Dlog4j.configuration=log4j.properties -Xmx512M -Xss1024K

Classpath tab > User Entries > Advanced:

Add Folder "docx4all/src/main/resources"

  1. It may be necessary to go to docx4all project properties > Build Path > Libraries > JRE System Library > Access Rules, and define a rule "Accessible" for ""
  1. Run

You should be able to open a simple docx document, for example, the provided sample-docs/earth.docx

On Ubuntu, it is currently necessary to set Application.lookAndFeel = default in WordMLEditor.properties (src/org.docx4all.ui.main.resources), or the File > Open dialog will not work.