{"id":199,"date":"2012-05-18T12:47:45","date_gmt":"2012-05-18T02:47:45","guid":{"rendered":"http:\/\/www.docx4java.org\/blog\/?p=199"},"modified":"2015-06-16T14:21:28","modified_gmt":"2015-06-16T04:21:28","slug":"docx4j-from-github-in-eclipse","status":"publish","type":"post","link":"https:\/\/www.docx4java.org\/blog\/2012\/05\/docx4j-from-github-in-eclipse\/","title":{"rendered":"docx4j from GitHub in Eclipse"},"content":{"rendered":"

This post is old. \u00a0Please see instead 2015\/06\/docx4j-from-github-in-eclipse-5-years-on\/<\/a><\/strong><\/p>\n

docx4j is now on GitHub! \u00a0https:\/\/github.com\/plutext\/docx4j<\/a><\/p>\n

This should make it easier for users to maintain their own branches (public or private), and contribute improvements back.<\/p>\n

As of now, GitHub is the project’s authoritative version control. \u00a0We’re no longer updating<\/strong> the existing svn <\/strong>repository.<\/p>\n

Its pretty easy to work with docx4j sources in Eclipse. This post shows you how.<\/p>\n

First, make sure you have eGit installed in Eclipse. \u00a0Install it from here<\/a>. \u00a0On Windows, it is also useful to have msysgit<\/a>. \u00a0Refer elsewhere for how to set these up. Update:<\/strong> there is a GitHub Windows client<\/a> now (I haven’t tried it) which apparently includes msysgit.<\/p>\n

You also need m2eclipse<\/a><\/p>\n

Assuming you’ve done all that, setting up the docx4j source code is just a few steps.<\/p>\n

But first, be aware there is a difference between cloning and forking. \u00a0Cloning <\/strong>gives you a copy of the source code you can work on, but without more, no easy way to contribute changes back. \u00a0Forking <\/strong>sets you up with the source code, and makes it easy to contribute changes back.<\/p>\n

If you think you might be making changes to the docx4j source code, you’re probably best to create a fork on GitHub right from the start.<\/p>\n

Step 1 (optional, but recommended):<\/strong> To create a fork, log in to GitHub, visit https:\/\/github.com\/plutext\/docx4j<\/a> then press the “Fork” button.<\/p>\n

Step 2: Create your local repository<\/strong> (git clone<\/span><\/strong>)<\/p>\n

This can be done from within Eclipse, or using Git Gui (easiest), or Git Bash Shell.<\/p>\n

To do it from within Eclipse, File > Import .. > Repositories from GitHub:<\/p>\n

\"\"<\/a><\/p>\n

If you forked docx4j, find your fork (it might not appear immediately, which is why Git Gui or Git Bash Shell are better for this step), select it, and click next.<\/p>\n

If you didn’t fork docx4j, type ‘docx4j’ then press ‘search’, the plutext\/docxj<\/strong> repository should come up:<\/p>\n

\"\"<\/a><\/p>\n

Select plutext\/docx4j, then click next.<\/p>\n

This creates a local git repository on your computer.<\/p>\n

Step 3:<\/strong> Now you need to import that repository into Eclipse as a project:<\/p>\n

File > Import .. > Projects from Git<\/p>\n

\"\"<\/a><\/p>\n

Eclipse should find the existing project settings:<\/p>\n

\"\"<\/a><\/p>\n

(If it didn’t and you had to use the new projects wizard; be sure to set the file location to wherever your git repository is, rather than letting Eclipse create a new empty project in the workspace)<\/p>\n

Now you should have a docx4j project in Eclipse, and it should be properly configured (since the project settings come with the project).<\/p>\n

You should be done.<\/strong> But if something isn’t right, you can\u00a0configure it manually (see further below).<\/p>\n

Next steps? \u00a0Improve the docx4j source code in Eclipse :-), then Team > Commit, to commit those changes to your local repository.<\/p>\n

Made a change which would be useful to others? \u00a0If you forked docx4j as per step 1 above, you can push your changes to your repository on GitHub, then send a pull request<\/a>.<\/p>\n

If you didn’t fork docx4j, do that now on GitHub, then configure things locally to push your changes to your repository on GitHub, then you’ll be right to push your changes to your repository on GitHub, then\u00a0send a pull request<\/a>. \u00a0Other docx4j users will thank you for this \ud83d\ude42<\/p>\n

Manual configuration:<\/strong><\/p>\n

Configure > Convert to Maven Project<\/p>\n

Properties > Java Compiler > Compiler compliance level: change to 1.6<\/p>\n

Java Build Path > Libraries: remove 1.5 system library; Add Library … JRE System Library .. 1.6<\/p>\n

Java Build Path > Source: check none of the entries say “Excluded: **” (remove the exclusion)<\/p>\n","protected":false},"excerpt":{"rendered":"

This post is old. \u00a0Please see instead 2015\/06\/docx4j-from-github-in-eclipse-5-years-on\/ docx4j is now on GitHub! \u00a0https:\/\/github.com\/plutext\/docx4j This should make it easier for users to maintain their own branches (public or private), and contribute improvements back. As of now, GitHub is the project’s authoritative version control. \u00a0We’re no longer updating the existing svn repository. Its pretty easy to […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[4,85,86],"class_list":["post-199","post","type-post","status-publish","format-standard","hentry","category-uncategorized","tag-docx4j","tag-git","tag-github"],"_links":{"self":[{"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/posts\/199","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/comments?post=199"}],"version-history":[{"count":5,"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/posts\/199\/revisions"}],"predecessor-version":[{"id":214,"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/posts\/199\/revisions\/214"}],"wp:attachment":[{"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/media?parent=199"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/categories?post=199"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.docx4java.org\/blog\/wp-json\/wp\/v2\/tags?post=199"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}