DSpace

Документация DSpace | Релизы DSpace | Вики DSpace | Поддержка

Обзор

Программное обеспечение DSpace с открытым исходным кодом — это готовое приложение-репозиторий «под ключ», используемое более чем 2000 организациями и учреждениями по всему миру для обеспечения долговременного доступа к цифровым ресурсам. Для получения дополнительной информации посетите http://www.dspace.org/

DSpace состоит из бэкенда на Java и фронтенда на Angular.

• Бэкенд (данная кодовая база) предоставляет REST API, а также другие машинные интерфейсы (например, OAI-PMH, SWORD и т. д.)
  • REST-контракт находится по адресу https://github.com/DSpace/RestContract
• Фронтенд (https://github.com/DSpace/dspace-angular/) — это пользовательский интерфейс, построенный на основе REST API

В предыдущих версиях DSpace (v6.x и ниже) использовались два разных пользовательских интерфейса (XMLUI и JSPUI). Эти интерфейсы больше не поддерживаются в v7 и более поздних версиях.

• Для более старых версий по-прежнему доступна ветка сопровождения, см. dspace-6_x для сопровождения 6.x.

Загрузки

• Бэкенд (REST API): https://github.com/DSpace/DSpace/releases
• Фронтенд (пользовательский интерфейс): https://github.com/DSpace/dspace-angular/releases

Документация / Установка

Документация для каждого выпуска может быть просмотрена онлайн или загружена через нашу вики-документацию.

Последние инструкции по установке DSpace доступны по адресу: https://wiki.lyrasis.org/display/DSDOC9x/Installing+DSpace

Обратите внимание: как Java-веб-приложение, DSpace требует для работы базу данных (PostgreSQL) и контейнер сервлетов (обычно Tomcat). Более подробная информация об этих и всех других предварительных требованиях приведена в инструкциях по установке выше.

Запуск DSpace 9 в Docker

ПРИМЕЧАНИЕ. На данный момент у нас нет готовых к производственному использованию образов Docker для DSpace. Тем не менее, у нас есть скрипты Docker Compose для быстрого запуска в целях разработки или тестирования.

См. Запуск DSpace 9 с помощью Docker Compose

Участие в разработке

См. Документацию по участию в разработке

Получение помощи

DSpace предоставляет общедоступные списки рассылки, где вы можете задавать вопросы или поднимать темы для обсуждения. Мы приглашаем всех к участию в этих списках:

• [email protected] : Общее обсуждение платформы DSpace, объявления, обмен передовым опытом
• [email protected] : Список рассылки технической поддержки. См. также наше руководство по устранению ошибок.
• [email protected] : Список рассылки для разработчиков / по разработке

Отличные вопросы и ответы также доступны по тегу DSpace на Stackoverflow

Дополнительные возможности поддержки доступны на странице https://wiki.lyrasis.org/display/DSPACE/Support

DSpace также имеет активную сеть поставщиков услуг. Если вы предпочитаете нанять поставщика услуг для установки, обновления, настройки или размещения DSpace, мы рекомендуем связаться с одним из наших зарегистрированных поставщиков услуг.

Трекер проблем

DSpace использует GitHub для отслеживания проблем:

• Проблемы бэкенда (REST API): https://github.com/DSpace/DSpace/issues
• Проблемы фронтенда (пользовательского интерфейса): https://github.com/DSpace/dspace-angular/issues

Тестирование

Запуск тестов

По умолчанию в DSpace модульные и интеграционные тесты отключены. Однако они запускаются автоматически с помощью GitHub Actions для всех pull request и коммитов кода.

• Как запустить одновременно модульные тесты (через maven-surefire-plugin) и интеграционные тесты (через maven-failsafe-plugin):
  root@kitploit:~

  mvn install -DskipUnitTests=false -DskipIntegrationTests=false
  

• Как запустить только модульные тесты:
  root@kitploit:~

  mvn test -DskipUnitTests=false
  

• Как запустить отдельный модульный тест:
  root@kitploit:~

  # Run all tests in a specific test class
  # NOTE: failIfNoTests=false is required to skip tests in other modules
  mvn test -DskipUnitTests=false -Dtest=[full.package.testClassName] -DfailIfNoTests=false
  
  # Run one test method in a specific test class
  mvn test -DskipUnitTests=false -Dtest=[full.package.testClassName]#[testMethodName] -DfailIfNoTests=false
  

• Как запустить только интеграционные тесты:
  root@kitploit:~

  mvn install -DskipIntegrationTests=false
  

• Как запустить отдельный интеграционный тест:
  root@kitploit:~

  # Run all integration tests in a specific test class
  # NOTE: failIfNoTests=false is required to skip tests in other modules
  mvn install -DskipIntegrationTests=false -Dit.test=[full.package.testClassName] -DfailIfNoTests=false
  
  # Run one test method in a specific test class
  mvn install -DskipIntegrationTests=false -Dit.test=[full.package.testClassName]#[testMethodName] -DfailIfNoTests=false
  

Лицензия

Исходный код DSpace свободно доступен на условиях стандартной лицензии BSD 3-Clause. Полный текст лицензии доступен в файле LICENSE или онлайн по адресу http://www.dspace.org/license/

DSpace использует сторонние библиотеки, которые могут распространяться на условиях других лицензий. Эти лицензии перечислены в файле LICENSES_THIRD_PARTY.