Page History
Excerpt |
---|
Guidelines for developing with DSpace, including Git hints, IDE setup, other useful tools, etc. |
Table of Contents | ||||
---|---|---|---|---|
|
Code Contribution Guidelines
- Code Contribution Guidelines - Provides details on our Code Approval processes and our DSpace code conventions! Before you get started on your project, make sure you understand our Code Contribution Guidelines!
Developing With Git/GitHub
The DSpace codebase is in GitHub:
- Backend/Java codebase: https://github.com/DSpace/DSpace
- DSpace 7 UI codebase: https://github.com/DSpace/dspace-angular
If you are new to Git or GitHub development, the following resources that may be of interest to you.
- DSpace Development with Git - Some hints/tips on DSpace Development with Git/GitHub
- Git Resources - Useful third-party resources/tutorials on Git or GitHub
Still want to use SVN locally, even though DSpace is on GitHub?
- GitHub does provide some basic SVN client support (e.g. checkout via SVN): https://github.com/blog/966-improved-subversion-client-support
- Or, you could obviously download the zipped up DSpace release packages and import them into your local SVN
Developing Environments (IDEs)
This page describes how to develop with DSpace.
The SVN repository is at http://scm.dspace.org/svn/repo/dspace
.
If you are doing development work you'd like to contribute to the community, please consider checking DSpace out of our Subversion repository rather than using a packaged download. Also, please be sure to read ContributionGuidelines.
See also: updating your local code base if you've already made many modifications to a downloaded DSpace version.
If you have more than one developer, or need to manage versions or releases yourself (e.g. deploying customised DSpace software to a production server), you should consider using your own CVS tree with the DSpace core code on a vendor branch. see Running your own CVS repository
This presentation explains the new ways to add your local customizations to the DSpace 1.5 codebase:
How to customize your DSpace 1.5 and make overlays, April 4th 2008, presented by Tim Donohue at Open Repositories 2008
...
You are free to use whatever developer environment works for you. Here are some guides for setting up and using particular environments.
- IntelliJ IDEA
- IDE Integration - DSpace and IDEA (covers IDEA + maven + ant + tomcat).
- NetBeansEclipse
- IDE Integration ___DSpace, Eclipse and Tomcat- DSpace and NetBeans
- Eclipse (Instructions are outdated: Most of our active developers/committers tend to use either IDEA or NetBeans.)
- NetBeans
- Docker Compose - A great way to get started quickly with DSpace development! Docker scripts can be found in the source code
- Backend: https://github.com/DSpace/DSpace/blob/main/dspace/src/main/docker-compose/README.md
- Frontend: https://github.com/DSpace/dspace-angular/blob/main/docker/README.md
- IDE Integration___DSpace and IDEA (covers IDEA + maven + ant + tomcat).
- Any source editor
Also, if you are interested in using Git/Github for local DSpace development see this for hints/tips:
Useful tools
- Luke - for work with Lucene indexes & queries, see Debug lucene query
- Eclipse ResourceBundleEditor - for work with i18n Internationalization in JSPUI, see I18nSupport I18nSupport#Eclipse_Resource_Bundle_Editor
Other Resources
...