A general information page giving a high-level overview of what DSpace is, and some ideas and pointers for implementing DSpace in your organisation.
Where you are right now!
A Wiki is a dynamic Web site that can easily be edited by anyone (yes, anyone). This makes it a great collaboration tool. The DSpace Wiki contains up-to-the-minute technical information about the DSpace platform, and what people around the world are doing with DSpace. If you're working with DSpace, please post what you're doing to the Wiki! You can also find out if others are doing or have done similar work!
Particularly useful pages on the Wiki:
- Home – Most of the latest and greatest information can be found directly off the homepage. Check out the "DSpace Community" section for general information, the "Running DSpace" section for how to get started, and the "Developers" section for latest Developer news and a current roadmap.
- ContributionGuidelines – An evolving guide to developing code and documentation for contributing back to the DSpace community
- HowToContribute – Find out how to contribute to and participate in DSpace
- LessonsLearned – Learn from other DSpace teams and share lessons you learned about building a DSpace service.
DSpace Code / Downloads
- You may also checkout the source code via Subversion (SVN) from our source code repository. This code repository is also browseable via the web.
DSpace Issue Tracking, Feature Requests, and Patches
The DSpace Jira system tracks bugs, feature requests and patches for current and future versions of DSpace. It also permits voting on those issues you are interested in, and registering to receive updates - if you create yourself an account.
There are currently two main sections in DSpace Jira:
- DSpace 1.x section - This is for reporting of any bugs, feature requests or patches within any of the DSpace 1.x versions.
- DSpace 2.x section - This section is being used by the DSpace+2.0 development team to track issues or feature requests that have come up in their work.
DSpace Community Sandbox
We maintain a community sandbox at Google Code at http://code.google.com/p/dspace-sandbox/
Instructions on usage
Follow the instructions there for getting a google code account and requesting membership to the project.
Generally, the rules are such...
- There is no fine grained access control so "be careful" and don't change others work without talking about it first.
- Ask about project structure etc, we are working to try to organize the space so it stays clean
- If you want commit rights, email the developers list with your GoogleCode account and you will be added.
- Addon Projects Projects that are designed to "add on" to dspace without altering core libraries
- Prototypes Prototypes are branches of the core codebase, where experimental development of the core codebase can happen
- Team Custom build plugins that are part of the DSpace build process.
- Read Only Mirror The Mirror is an automated sync with the S.F. repository and off limits to commits by regular users.
Documentation and Guides
DSpace System Documentation
Standard System Documentation
DSpace System Documentation is included with each DSpace download. Look in the
/dspace/docs/ folder once you unzip the download.
Documentation for recent versions of DSpace is also available online:
- DSpace 1.6.2: HTML or PDF
- DSpace 1.6.1: HTML or PDF
- DSpace 1.6.0: HTML or PDF
- DSpace 1.5.2: HTML or PDF
- DSpace 1.5.1: HTML or PDF
- DSpace 1.5.0: HTML
Finally, the latest DSpace System Documentation is browsable from Subversion.
Other formats and translations
- Printable PDF of DSpace System Docs
- DSpace 1.5 Instaling DSpace 1.5 in Centos 5 contributed by Juan Carlos Mardones Koning in Chile
- Start with the DSpace System Documentation.
- Platform and distribution-specific tips and guides can be found on the DSpace Installation page.
- XMLUI Customization:
- Making DSpace XMLUI Your Own - Concentrates on using Maven to build Overlays in the XMLUI (Manakin). Also has very basic examples for JSPUI. Based on DSpace 1.6.x.
- Learning to Use Manakin (XMLUI) - Overview of how to use Manakin and how it works. Based on DSpace 1.5, but also valid for 1.6.
- Introduction Manakin (XMLUI)
- General Tips:
- Build Cookbook has examples of adding your local changes to a DSpace distribution.
- How-To Guides has a list of all wiki pages which provide "how-to" hints for changing/customizing your DSpace install.
- DSpace how-to guide: tips and tricks for managing common DSpace chores (DSpace version 1.4.2 and Manakin 1.1) by Tim Donohue, Scott Phillips and Dorothea Salo - This short booklet is intended to introduce the common, non-obvious customization-related tasks for newcomers to DSpace administration. It has been written against the version 1.4.x of DSpace (1.4.2 specifically) and Manakin 1.x (1.1 specifically) . It's meant to be usable across all platforms (Linux, Windows, Mac). This booklet was a handout from the "Making DSpace Your Own" tutorial from JCDL 2007 taught by Tim Donohue and Scott Phillips. The full presentations and materials from this tutorial are also available from the DSpace Presentations page. Spanish translation by the University of León
- DSpace 1.4.1 Customization (by Claudia Jürgen) available at Eldorado, the institutional repository of the University of Dortmund. This is the English translation of a customization presentation held at the DSpace Workshop in Kassel (Germany) March 07. The presentation gives an overview to basic customization and configuration techniques and possibilities of DSpace 1.4.1. Thanx to Chris Yates of The University of Wales, Aberystwyth for proofreading it.
- DSpace how-to guide: tips and tricks for managing common DSpace chores (DSpace version 1.3.2) by Dorothea Salo and Tim Donohue, also available at http://hdl.handle.net/1920/1045 - This short booklet is intended to introduce the common, non-obvious customization-related tasks for newcomers to DSpace administration. It has been written against the current stable version 1.3.2 of DSpace. It's meant to be usable across all platforms (Linux, Windows, Mac). For even more information, the slides from their "Making DSpace Your Own" Tutorial at JCDL 2006 are available on the DSpace Presentations page. Spanish translation by the University of León
Developing with DSpace
- An overall reference for developing code with DSpace (and creating patches) is available on the Guide to Developing with DSpace page.
- ContributionGuidelines - How to get your code accepted into DSpace.
Documentation for New DSpace Administrators
- Intro to DSpace (August 19, 2009) - written by Cameron Kainerstorfer and Heather Perkins (both of University of Texas Southwestern Medical Center)
- Instructions for New Admin - This is a simple guide to print off for people who will start uploading documents to your instance of DSpace, by Shawna Sadler.
- Lessons learned building an Institutional Repository with DSpace
There are several public DSpace mailing lists you can join, depending on what your particular interest is.
General discussion about the DSpace platform, and setting up and running a DSpace service. It is open to all DSpace users to ask questions, share news, and spark discussion about DSpace with people managing other DSpace sites.
Technical discussion about the DSpace platform. If you have a technical query, or are having problems getting DSpace up and running, this is the place to go (refer to the Troubleshoot an error page for additional help and suggestions). If you are technically savvy, and would like to contribute by helping out those in need, please join!
People working on the DSpace code hang out here.
This is for "hardcore" developers only. This listserv reports the latest SVN commits, allowing developers to keep in touch with the latest DSpace code changes.
While we hope that the community works together by using the above lists, some mailing lists enabling non-English speakers to participate are emerging. We strongly encourage people on those lists who speak English to liaise between them.
- Japanese (日本語) - The National Institute of Informatics runs an email list for institutional repositories, including DSpace. Contact co5 (at) nii.ac.jp for further information.
- Spanish - DSpace Spanish User Group, Gude
There are two dedicated DSpace IRC (internet relay chat) channels (i.e. "rooms") on the irc.freenode.net server:
- #dspace - all DSpace discussions and live Q & A
- #duraspace - for DSpace Committer/Developer meetings, and wider DuraSpace community discussions
If you do not have access to an IRC client, or are new to IRC, the following web interface is very easy way to get started:
- Enter in a nickname (of your choice, e.g. firstName_lastName)
- Enter in one of the IRC channels above (e.g. "#dspace" or "#duraspace")
- Leave the "Auth to Services" setting unchecked.
For a list of IRC client software, see:
Many current Instant Messaging (IM) clients also support IRC. Here's a list of widely used software you can install that will allow you to connect to IRC: