juandesant / dmptool

Home of the DMP Roadmap-based version of the DMPTool

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

DMPTool

The DMPTool is a free, open-source, online application that helps researchers create data management plans. These plans, or DMPs, are now required by many funding agencies as part of the grant proposal submission process. The DMPTool provides a click-through wizard for creating a DMP that complies with funder requirements. It also has direct links to funder websites, help text for answering questions, and resources for best practices surrounding data management.

The DMPTool is based on the DMPRoadmap open source project. DMPRoadmap is being collaboratively developed by members of the University of California Curation Center (UC3), the Digital Curation Centre (DCC) and contributions from the community.

Support

Issues should be reported here on Github Issues Please be advised though that we can only provide limited support for your local installations. Issues will be triaged by our team and if applicable will be moved/opened in the DMPRoadmap repository.

Translations

See the Translations Guide

Installation

If you would like to install and run this application, we encourage you to start with a basic installation of DMPRoadmap. Follow the instructions and determine if the functionality it provides meets your requirements.

If the basic DMPRoadmap system does not provide the functionality you require please review the list of customizations that we have made below. If our additional changes do not meet your needs, you are encouraged to fork the DMPRoadmap codebase and customize it to your needs. If you do customize it please contact the DMPRoadmap team to let the community know about the additional functionality you plan to offer. It may be useful to the larger community.

If DMPTool meets your organization's needs, you should install it following the DMPRoadmap installation instructions and then perform the folowing tasks:

  • Homepage images: While you are free to use the images provided along with this repository, it is advisable to replace them with ones more relevant to your user base. The system randomly serves up one of five images that are located in lib/assets/images/homepage/. Each image has 3 sizes geared towards various device resolutions/format (e.g. smart phone). Follow the image sizes in the provided examples for your images. You must also retain the file names as the lib/assets/stylesheets/dmptool.scss references them by name
  • Rotating news on the homepage: Update the config.rss value in config/application.rb with the address of your blog's RSS feed.
  • Styles: The system loads the base DMPRoadmap stylesheet first then the DMPTool stylesheet. We recommend that you add your own additional stylesheet if your changes are extensive or update lib/assets/stylesheets/dmptool.scss directly. Do not make changes to the other stylesheets as they are managed as part of the DMPRoadmap project.
  • Static Content: Update the files in app/views/static_pages/ so that they are appropriate for your installation.
  • Shibboleth: Setting up your own Shibboleth service provider (SP) is beyond the scope of this application. If you have an SP available and want to use it, make sure that you enable the shibboleth settings in config/application.rb and then add your organization's entity id (found in your Shib SP's list of registered IdPs) within the UI. Then log out and log back in via your institution's credentials to test that things are working properly. Note that the DMPTool only allows users to authenticate via Shibboleth if the organization is regsitered within the system (meaning that it appears in the application's orgs table)

Variations between DMPRoadmap and DMPTool

The following is a list of customizations that we have made to the base DMPRoadmap codebase:

  • Homepage: A complete redesign of the homepage
  • Navigation: A complete redesign of the header and footer navigation. All of the custom menus have been placed in views/layouts/dmptool/.
  • Static Content: Added a gem to allow the views/static_pages to be managed via Markdown instead of HTML. Changed the content of existing pages and added new pages
  • Sigin in/Create account: The sign in and create account workflows has been overhauled to place more emphasis on logging in via institutional credentials (Shibboleth). All of the DMPTool code for these items have been separated into its own views/shared/dmptool/ subdirectory. The corresponding JS file can be found at lib/assets/javascripts/dmptool/.
  • Public participating institutions page: A new Participating Institutions page has been added and is accessible to the public.
  • Styling: We have added a lib/assets/stylesheets/dmptool.scss file that gets loaded after the base DMPRoadmap stylesheets
  • Create buttons: All of the create buttons (e.g. Create Plan, Create Template) have been moved so that they appear on the upper right of their associated tables.
  • Accordion plus/minus (+/-) icons: The plus/minus icons on the accordions have been moved so that they appear on the left.
  • Project details page: The id field and contact phone numbers have been removed.
  • External links: All external links (except ORCID) open in a new tab/window
  • Asset fingerprinting: A new configuration option has been added to allow you to specify whether or not you want the webpack managed assets to be fingerprinted. These options are set in the config/environments/ files.
  • Max number of organization links: Added a new constant for the max number of organization links that can appear in the header
  • Text/Labels: Various text and labels have been updated.
  • Set min size for table columns with dates: Added a 'last-edited' class to all table columns that contain a date to prevent their contents from wrapping.

Troubleshooting

See the Troubleshooting Guide on the Wiki

Contributing

See the Contributing Guide

License

The DMPTool project uses the MIT License.

About

Home of the DMP Roadmap-based version of the DMPTool

License:MIT License


Languages

Language:HTML 60.9%Language:Ruby 30.2%Language:JavaScript 6.4%Language:CSS 2.5%Language:Shell 0.0%