Seminarul Internaţional „Implementarea tehnologiei IR (repozitorii instituţionale): Sistemul DSpace”, 14-15 aprilie 2011. Chişinău, Ambasada Regală a Norvegiei în România, Asociaţia Bibliotecarilor din Republica Moldova, Consorţiul REM, Programul EIFL-OA, Biblioteca Ştiinţifică a Academiei de Studii Economice din Moldova. Instructor: Kuzma KUDIM, Institutul Sisteme Software al Academiei de Ştiinţe din Kiev, Ucraina.

1. III — Настройка DSpace
© 2011 Кузьма Кудим

2. 1. Файлы настроек

3. Два расположения
[dspace-source]/dspace/config/dspace.cfg
считается основным
[dspace]/config/dspace.cfg
копия предыдущего

4. Применение изменений
1. Редактируем [dspace-source]/dspace/config/*
2. Применяем изменения
cd [dspace-source]/dspace
mvn package
cd target/dspace-1.7.0-build.dir
ant -Doverwrite=true update
3. Копируем веб-приложение на сервер
cp -R [dspace]/webapps/* [tomcat]/webapps
5. Перезапускаем tomcat

5. Формат файлов настроек
Файл настроек содержит:
пары свойство-значение
имеют вид 'имя.свойства = значение свойства'
бывает не установлено или закомментировано
строки комментариев
начинаются с символа '#'
пустые строки

6. Формат файлов настроек
Булевские значения
да/включить/разрешить — true
useProxies = true
нет/отключить/запретить — false
useProxies = false
Перенос длинных строк
пробел + обратный слэш
filter.plugins = PDF Text Extractor,
HTML Text Extractor,
PowerPoint Text Extractor

7. Формат файлов настроек
Ссылки на другие свойства:
dspace.dir = /dspace
dspace.history = ${dspace.dir}/history

8. 2. Основные настройки

9. Необходимо знать заранее
Адрес сервера
lib.isofts.kiev.ua
Email администратора
kuzma@isofts.kiev.ua
SMTP сервер
smtp.isofts.kiev.ua

10. Основные параметры
Корневая папка инсталляции
dspace.dir = /opt/dspace
dspace.dir = c:/dspace
Короткое название сайта
dspace.name = ISS Library
Адрес сервера
dspace.hostname = lib.isofts.kiev.ua

11. Основные параметры
Основной URL веб-приложения
dspace.baseUrl = http://lib.isofts.kiev.ua:8080
Основной URL веб-интерфейса
dspace.url = ${dspace.baseUrl}/xmlui
Основной URL приложения OAI
dspace.oai.url = ${dspace.baseUrl}/oai

12. База данных
Какая СУБД используется
db.name = postgres
db.name = oracle
Имя пользователя
db.username = dspace
Пароль
db.password = dspace

13. Почтовый сервер
Адрес и порт SMTP сервера
mail.server = smtp.isofts.kiev.ua
mail.server.port = 25
Имя и пароль, если нужно
mail.server.username = kuzma
mail.server.password = top!secret
Отключить отправку писем? (true/false)
mail.server.disabled = false

14. Email адреса
Поле From: в письмах
mail.from.address = lib.noreply@isofts.kiev.ua
Обратная связь
feedback.recipient = lib.help@isofts.kiev.ua
Администратор
mail.admin = lib.admin@isofts.kiev.ua

15. Email адреса
Уведомления об ошибках
alert.recipient = lib.alert@isofts.kiev.ua
Уведомления о новых регистрациях
registration.notify = lib.reg@isofts.kiev.ua

16. Шаблоны писем
[dspace]/config/emails
комментарии
#закомментированная строка
параметры
текст {0} текст {1} текст
изменить контактные данные
dspace-help@myu.edu
xxx-555-xxxx

17. Язык для метаданных
Язык по умолчанию для ввода метаданных
default.language = uk_UA

18. Хранилище файлов
Путь к хранилищу номер 0
assetstore.dir = ${dspace.dir}/assetstore
Путь к хранилищу номер 1, 2, 3, ...
assetstore.dir.1 = /another/assetstore
Номер хранилища для новых поступлений
assetstore.incoming = 1

19. Логи
Файл настройки логов
log.init.config = ${dspace.dir}/config/log4j.properties
Путь сохранения логов
log.dir = ${dspace.dir}/log

20. Поисковый индекс Lucene
Где хранить файлы индекса
search.dir = ${dspace.dir}/search
Какой анализатор Lucene использовать
search.analyzer = org.dspace.search.DSAnalyzer
search.analyzer =
org.apache.lucene.analysis.ru.RussianAnalyzer
AND или OR в запросе
search.operator = OR

21. Поисковый индекс Lucene
Количество индексируемых слов, не больше
search.maxfieldlength = 10000
search.maxfieldlength = -1
Какие поля метаданных индексировать
search.index.[n] = [метка]:[поле метаданных]
search.index.1 = author:dc.contributor.*
search.index.2 = author:dc.creator.*
search.index.3 = title:dc.title.*
...

22. Handle-сервер
URL сервиса постоянных ссылок
handle.canonical.prefix = http://hdl.handle.net/
handle.canonical.prefix = ${dspace.url}/handle/
Префикс постоянной ссылки
handle.prefix = 123456789

23. Видимость скрытого
Показывать (true) или нет (false) скрытые
документы
в RSS
harvest.includerestricted.rss = true
в OAI
harvest.includerestricted.oai = true
в подписках
harvest.includerestricted.subscription = true

24. Прокси
Сервер
http.proxy.host = proxy.isofts.kiev.ua
Порт
http.proxy.port = 2048
DSpace за прокси-сервером?
useProxies = true

25. *Суб-администраторы
Разрешить или запретить администраторам
отдельных разделов:
создавать/удалять подразделы
управлять
правилами
администраторами
шаблонами
...

26. *Методы аутентификации
Стек методов аутентификации
Методы:
По паролю
Shibboleth
Сертификаты X.509
По IP-адресу
LDAP
Собственный метод

27. 3. Эмбарго

28. Свойства в dspace.cfg
Поле метаданных для сроков
embargo.field.terms = dc.embargo.terms
Поле метаданных для окончания
embargo.field.lift = dc.embargo.liftdate
Значение неограниченного эмбарго
embargo.terms.open = всегда

29. Продолжение настройки
1. Добавить в реестр метаданных новые поля
2. В файле [dspace]/config/input-forms.xml
добавить поле ввода для embargo.field.terms
3. Обновить DSpace
4. Регулярно запускать проверку сроков
[dspace]/bin/dspace embargo-lifter -l

30. Изменения в input-forms.xml
<field>
<dc-schema>dc</dc-schema>
<dc-element>embargo</dc-element>
<dc-qualifier>terms</dc-qualifier>
<repeatable>false</repeatable>
<label>Дата эмбарго</label>
<input-type>onebox</input-type>
<hint>Если необходимо, введите дату истечения
эмбарго в формате 'гггг-мм-дд' или 'всегда'.</hint>
<required></required>
</field>

31. 4. Статистика

32. Настройка
dspace.cfg
раздел SOLR Statistics
dstat.cfg
дата начала
список полей
и другие параметры статистики

33. Инициализация
Первый сбор статистики
[dspace]/bin/dspace stat-initial
Создание первого отчёта
[dspace]/bin/dspace stat-report-initial

34. Регулярное выполнение
Задания cron
0 1 * * * [dspace]/bin/dspace stat-general
0 1 * * * [dspace]/bin/dspace stat-monthly
0 2 * * * [dspace]/bin/dspace stat-report-general
0 2 * * * [dspace]/bin/dspace stat-report-monthly

35. Просмотр
В административном интерфейсе:
→Статистика

36. Google Analitics
Преимущества
Универсальный и мощный инструмент
Подробная статистика всего сайта
Установка
Регистрация
dspace.cfg:
xmlui.google.analytics.key=UA-XXXXXX-X

37. 5. Локализация XMLUI

38. Языки интерфейса
dspace.cfg
xmlui.supported.locales = ru, uk, en
соответствующие файлы переводов
messages.xml — основной (русский)
messages_uk.xml
messages_en.xml

39. Файлы переводов
1. Создать каталог
[dspace-source]/dspace/modules/xmlui/src/main/webapp/i18n/
2. Скопировать в него файл
[dspace-source]/dspace-xmlui/dspace-xmlui-webapp/
src/main/webapp/i18n/messages.xml
и перевести его
3. Дополнительные языки
messages_de.xml, messages_uk.xml, ...

40. Проблемы
Нет переключения кнопками
Не всё переводится
Письма
Названия/описания
разделов/коллекций/документов

41. 6. XMLUI

42. Регистрация
Разрешить регистрацию?
xmlui.user.registration = true
Разрешить редактировать профиль?
xmlui.user.editmetadata = true
Куда после входа?
xmlui.user.loginredirect=/profile

43. Текст на главной
Шаблон в файле:
[dspace-source]/dspace/config/news-xmlui.xml
Не HTML
пример ссылки
<xref target="http://myuni.edu/">My University</xref>
Можно локализовать
пример фразы
<i18n:text>myuni.repo.intro</i18n:text>

44. Статический контент
Куда положить?
[dspace-source]/dspace/modules/xmlui/src/main/webapp/static/
Как ссылаться?
<link href="./static/mystyle.css" rel="stylesheet" type="text/css"/>
<img src="./static/images/some-image.jpg" alt="Картинка"/>

45. Темы
Установленные темы
[dspace]/config/xmlui.xconf
в разделе <themes>
<theme name="Theme 1" regex=".*" path="theme1/"/>

46. Добавление новой темы
1. Скопируйте готовую тему из
[dspace-source]/dspace-xmlui/dspace-xmlui-webapp/
src/main/webbapp/themes/
в
[dspace-source]/dspace/modules/xmlui/src/main/
webbapp/themes/
2. Переименуйте каталог темы
3. Модифицируйте файлы темы
в sitemap.xmap раздел <global-variables>
4. Добавьте строку в xmlui.conf
5. Обновите DSpace

47. 7. Процесс внесения
Open Archives Initiative — Protocol for Metadata Harvesting

48. Файл настроек
[dspace-source]/dspace/config/item-submission.xml
подробно откомментирован
XML формат
порядок внесения по умолчанию
Выбрать коллекцию -> Вопросы -> Описание ->
Загрузка -> Проверка -> Лицензия -> Конец
можно изменить шаги или порядок
<submission-definition>
для разных коллекций
<submission-map>

49. Формы ввода
[dspace-source]/dspace/config/input-forms.xml
количество полей ввода
их последовательность и размещение
текстовые надписи
списки вариантов

50. III — Настройка DSpace
© 2011 Кузьма Кудим

51. 1. Файлы настроек

52. Два расположения
[dspace-source]/dspace/config/dspace.cfg
считается основным
[dspace]/config/dspace.cfg
копия предыдущего
После установки DSpace все конфигурационные
файлы можно найти в двух различных папках.
Первая, которую повсюду обозначена как
[dspace-source], это папка, где находятся
исходные коды DSpace, полученная при
распаковке архива. Вторая, обозначенная везде
как [dspace], это место, в которое DSpace
устанавливался из исходных кодов, именно эту
папку DSpace использует во время работы.
Папка [dspace-source] счиается основной при
внесении изменений.

53. Применение изменений
1. Редактируем [dspace-source]/dspace/config/*
2. Применяем изменения
cd [dspace-source]/dspace
mvn package
cd target/dspace-1.7.0-build.dir
ant -Doverwrite=true update
3. Копируем веб-приложение на сервер
cp -R [dspace]/webapps/* [tomcat]/webapps
5. Перезапускаем tomcat
Так как DSpace хранит настройки в двух местах
(см. пред. слайд), а использует при работе
только папку [dspace], то возникает соблазн
изменять только файлы в папке [dspace]. Так
делать не следует, иначе можно потерять свои
изменения при обновлениях! Правильная
последовательность действий такая: любые
изменения вносятся в [dspace-source], после
чего обновляется инсталляция DSpace.
Описанный способ пригоден для внесения любых
изменений в DSpace.

54. Формат файлов настроек
Файл настроек содержит:
пары свойство-значение
имеют вид 'имя.свойства = значение свойства'
бывает не установлено или закомментировано
строки комментариев
начинаются с символа '#'
пустые строки

55. Формат файлов настроек
Булевские значения
да/включить/разрешить — true
useProxies = true
нет/отключить/запретить — false
useProxies = false
Перенос длинных строк
пробел + обратный слэш
filter.plugins = PDF Text Extractor,
HTML Text Extractor,
PowerPoint Text Extractor
Многие свойства могут иметь лишь два значения
типа да/нет или включить/выключить. Для таких
свойтств-флагов используются специальные
значения true (правда) и false (ложь).
С целью улучшения читабельности для переноса
слишком длинных строк вставьте пробел и
обратный слэш (' ') непосредственно перед
местом переноса.

56. Формат файлов настроек
Ссылки на другие свойства:
dspace.dir = /dspace
dspace.history = ${dspace.dir}/history
Значение свойства может ссылаться на другие
свойства как в примере.

57. 2. Основные настройки
Главный файл настроек DSpace — dspace.cfg.

58. Необходимо знать заранее
Адрес сервера
lib.isofts.kiev.ua
Email администратора
kuzma@isofts.kiev.ua
SMTP сервер
smtp.isofts.kiev.ua
Прежде, чем приступать к установке, нужно как
минимум знать следующие вещи:
- адрес сервера, на котором проводится
установка;
- email первого администратора;
- адрес SMTP сервера для отправки писем (при
регистрации, для рассылок, и т. п.).

59. Основные параметры
Корневая папка инсталляции
dspace.dir = /opt/dspace
dspace.dir = c:/dspace
Короткое название сайта
dspace.name = ISS Library
Адрес сервера
dspace.hostname = lib.isofts.kiev.ua
Короткое название сайта используется в веб-
интерфейсе, в письмах и других местах
(например, в OAI).

60. Основные параметры
Основной URL веб-приложения
dspace.baseUrl = http://lib.isofts.kiev.ua:8080
Основной URL веб-интерфейса
dspace.url = ${dspace.baseUrl}/xmlui
Основной URL приложения OAI
dspace.oai.url = ${dspace.baseUrl}/oai
Свойство dspace.baseUrl задаёт URL, по которому
доступно развёрнутое на сервере веб-
приложение DSpace.
Свойство dspace.url задаёт URL, по которому
доступен веб-интерфейс DSpace. Поскольку
изначально DSpace состоит из нескольких
приложений, то это значение обычно отличается
от первого.

61. База данных
Какая СУБД используется
db.name = postgres
db.name = oracle
Имя пользователя
db.username = dspace
Пароль
db.password = dspace
С помощью указанных параметров задаётся
доступ к базе данных. Поддерживается две
СУБД — Postgre и Oracle.

62. Почтовый сервер
Адрес и порт SMTP сервера
mail.server = smtp.isofts.kiev.ua
mail.server.port = 25
Имя и пароль, если нужно
mail.server.username = kuzma
mail.server.password = top!secret
Отключить отправку писем? (true/false)
mail.server.disabled = false
Параметры SMTP сервера для отправки писем.
Если требуется авторизация, укажите имя и
пароль.
В отладочных целях отправку почты можно
отключить.

63. Email адреса
Поле From: в письмах
mail.from.address = lib.noreply@isofts.kiev.ua
Обратная связь
feedback.recipient = lib.help@isofts.kiev.ua
Администратор
mail.admin = lib.admin@isofts.kiev.ua
Здесь указываются основные адреса электронной
почты.
Обратная связь (feedback) доступна по переходу
по соответствующей ссылке в интерфейсе.

64. Email адреса
Уведомления об ошибках
alert.recipient = lib.alert@isofts.kiev.ua
Уведомления о новых регистрациях
registration.notify = lib.reg@isofts.kiev.ua
Дополнительно можно указать адреса
электронной почты для получения уведомлений
об ошибках и получения уведомлений о
регистрации новых пользователей.

65. Шаблоны писем
[dspace]/config/emails
комментарии
#закомментированная строка
параметры
текст {0} текст {1} текст
изменить контактные данные
dspace-help@myu.edu
xxx-555-xxxx
В некоторых ситуациях DSpace автоматически
рассылает письма пользователям. Например,
для оповещения о новых пополнения или при
смене пароля. Шаблоны всех таких писем
хранятся в папке [dspace]/config/emails.
Каждый файл содержит закомментированные
пояснения. Строки комментариев начинаются с
символа '#' и не вставляются в текст письма.
В шаблонах писем также используются
подстановочные параметры в виде числа в
фигурных скобках: {0}, {1}, {2}, .... В письме
вместо параметров подставляется нужный текст,
какой именно — разъяснено в комментариях.
Встречающиеся в файлах контактные данные
приведы лишь для примера, их следует
отредактировать.

66. Язык для метаданных
Язык по умолчанию для ввода метаданных
default.language = uk_UA
Свойство default.language используется, если язык
не указан явно в файле input-forms.xml

67. Хранилище файлов
Путь к хранилищу номер 0
assetstore.dir = ${dspace.dir}/assetstore
Путь к хранилищу номер 1, 2, 3, ...
assetstore.dir.1 = /another/assetstore
Номер хранилища для новых поступлений
assetstore.incoming = 1
Файлы не хранятся в базе данных вместе с
метаданными, а сохраняются в папке на диске.
Изначально используется хранилище под
номером 0, путь к которому задаётся
параметром assetstore.dir.
В последствии для размещения новых файлов в
другую папку можно задать хранилище номер 1,
2, 3, ... с помощью свойства assetstore.dir.1 (с
нужным номером вместо 1).
Свойство assetstore.incoming определяет какое
именно хранилище используется для
добавления новых фалов в настоящий момент.

68. Логи
Файл настройки логов
log.init.config = ${dspace.dir}/config/log4j.properties
Путь сохранения логов
log.dir = ${dspace.dir}/log

69. Поисковый индекс Lucene
Где хранить файлы индекса
search.dir = ${dspace.dir}/search
Какой анализатор Lucene использовать
search.analyzer = org.dspace.search.DSAnalyzer
search.analyzer =
org.apache.lucene.analysis.ru.RussianAnalyzer
AND или OR в запросе
search.operator = OR
По умолчанию используется поисковый
анализатор DSpace для английского языка. В
свойстве search.analyzer можно указать другой
анализатор.
Свойство search.operator указывает, должны ли
все ключевые слова из запроса встречаться в
документе (значение AND) или не обязательно
все (значение OR).
Чтобы применить изменения настроек поискового
индекса, нужно запустить
[dspace]/bin/dspace index-init

70. Поисковый индекс Lucene
Количество индексируемых слов, не больше
search.maxfieldlength = 10000
search.maxfieldlength = -1
Какие поля метаданных индексировать
search.index.[n] = [метка]:[поле метаданных]
search.index.1 = author:dc.contributor.*
search.index.2 = author:dc.creator.*
search.index.3 = title:dc.title.*
...
Свойство search.maxfieldlength задаёт
максимальное количество слов в поле
метаданных, которое будет проиндексировано.
Если предполагается выполнять полнотекстовый
поиск по достаточно большим документам, это
значение нужно увеличить. Значение -1 снимает
ограничение.
В списке свойств вида
search.index.[n] = [метка]:[поле метаданных]
перечислены поля метаданных, которые будут
проиндексированы. Символ '*' означает любое
окончание. Метка задаёт имя для поискового
поля, несколько полей метаданных могут
соответствовать одному поисковому полю
(одинаковая метка). Изменение перечня не
изменяет поисковый интерфейс.

71. Handle-сервер
URL сервиса постоянных ссылок
handle.canonical.prefix = http://hdl.handle.net/
handle.canonical.prefix = ${dspace.url}/handle/
Префикс постоянной ссылки
handle.prefix = 123456789
Сервис постоянных ссылок (handle service)
используется для сохранения URL одним и тем
же даже при перемещении ресурса на другой
сервер. Это достигается введением
дополнительного сервера постоянных ссылок
(handle server). При ссылке на документ
указывается ссылка на этот сервер, который
перенаправляет запросы на фактический URL.
Один из таких сервисов — hdl.handle.net
(платный).
Свойство handle.canonical.prefix задаёт URL
сервера постоянных ссылок. Чтобы не
использовать эту возможность, можно указать
свой сервер DSpace.
В свойстве handle.prefix указывается префикс,
выданный службой постоянных ссылок. Если
служба не используется, то любая строка.

72. Видимость скрытого
Показывать (true) или нет (false) скрытые
документы
в RSS
harvest.includerestricted.rss = true
в OAI
harvest.includerestricted.oai = true
в подписках
harvest.includerestricted.subscription = true
Если для доступа к некоторым документам у
анонимных пользователей нет права на чтение,
то по умолчанию такие документы всё равно
будут видны в RSS, OAI и подписках.
С помощью перечисленных свойств можно
ограничить видимость скрытых документов. При
этом для больших архивов может упасть
производительность.

73. Прокси
Сервер
http.proxy.host = proxy.isofts.kiev.ua
Порт
http.proxy.port = 2048
DSpace за прокси-сервером?
useProxies = true
Свойство useProxies используется для ведения
логов и для авторизации по IP-адресу, чтобы
правильно определять IP-адрес из заголовков
запросов HTTP.

74. *Суб-администраторы
Разрешить или запретить администраторам
отдельных разделов:
создавать/удалять подразделы
управлять
правилами
администраторами
шаблонами
...
Кроме супер-администратора, можно создавать
администраторов отдельных
разделов/коллекций. По умолчанию этим
администраторам назначаются права на
совершение всех административных действий
со всеми объектаи в своём разделе. Чтобы
ограничить такое поведение, например
запретить удаление подразделов, можно
соответствующим свойствам поставить
значение false.

75. *Методы аутентификации
Стек методов аутентификации
Методы:
По паролю
Shibboleth
Сертификаты X.509
По IP-адресу
LDAP
Собственный метод
Можно указать несколько методов
аутентификации, тогда они будут применяться
последовательно, пока один один из них не
сработает.
По умолчанию действует единственный метод —
аутентификация по паролю.
Существует поддержка и других методов.
Возможно подключение своего метода.

76. 3. Эмбарго
Главный файл настроек DSpace — dspace.cfg.

77. Свойства в dspace.cfg
Поле метаданных для сроков
embargo.field.terms = dc.embargo.terms
Поле метаданных для окончания
embargo.field.lift = dc.embargo.liftdate
Значение неограниченного эмбарго
embargo.terms.open = всегда
Чтобы установить эмбарго, изменить несколько
свойств в файле dspace.cfg.
Выбирайте новые, несуществующие названия для
полей метаданных, в которых будут храниться
срок эмбарго и дата окончания.
Можно также выбрать слово, которое будет
обозначать неограниченное эмбарго.

78. Продолжение настройки
1. Добавить в реестр метаданных новые поля
2. В файле [dspace]/config/input-forms.xml
добавить поле ввода для embargo.field.terms
3. Обновить DSpace
4. Регулярно запускать проверку сроков
[dspace]/bin/dspace embargo-lifter -l
Здесь приведен порядок действий по настройке
эмбарго.
Новые поля, введённые на предыдущем слайде,
посредством административного веб-
интерфейса нужно добавить в реестр
метаданных, иначе они останутся неизвестны
системе.
Для отображения поля ввода для срока эмбарго
необходимо изменить интерфейс в файле
input-forms.xml как показано на следующем
слайде.
После всех изменений не забудьте обновить
DSpace как рассказано на слайде "Обновление
настроек".
Необходимо регулярно выполнять проверку
истечения сроков эмбарго с помощью указанной
программы.

79. Изменения в input-forms.xml
<field>
<dc-schema>dc</dc-schema>
<dc-element>embargo</dc-element>
<dc-qualifier>terms</dc-qualifier>
<repeatable>false</repeatable>
<label>Дата эмбарго</label>
<input-type>onebox</input-type>
<hint>Если необходимо, введите дату истечения
эмбарго в формате 'гггг-мм-дд' или 'всегда'.</hint>
<required></required>
</field>
Здесь приведены изменения в файле
input-forms.xml для отображения в
пользовательском интерфесе поля ввода для
даты эмбарго.

80. 4. Статистика
Главный файл настроек DSpace — dspace.cfg.

81. Настройка
dspace.cfg
раздел SOLR Statistics
dstat.cfg
дата начала
список полей
и другие параметры статистики
Настройка статистики производится в двух местах
— в основном файле настроек dspace.cfg в
разделе SOLR Statistics Configuration, и в файле
настроек статистики dstat.cfg, который находится
в том же каталоге.

82. Инициализация
Первый сбор статистики
[dspace]/bin/dspace stat-initial
Создание первого отчёта
[dspace]/bin/dspace stat-report-initial
Подготовительный запуск системы сбора
статистики.

83. Регулярное выполнение
Задания cron
0 1 * * * [dspace]/bin/dspace stat-general
0 1 * * * [dspace]/bin/dspace stat-monthly
0 2 * * * [dspace]/bin/dspace stat-report-general
0 2 * * * [dspace]/bin/dspace stat-report-monthly
После инициализации программы обработки
статистистики следует запускать регулярно. Как
и при инициализации, первые две строки
отвечают за анализ статистики, а вторые — за
создание отчётов в html. Первая и третья строка
анализирует статистику от стартовой даты,
указанной в файле dstat.cfg. Вторая и четвёртая
строка — это статистика с разбивкой по
месяцам.

84. Просмотр
В административном интерфейсе:
→Статистика
Администратор может просматривать
статистические отчёты в веб-интерфейсе.

85. Google Analitics
Преимущества
Универсальный и мощный инструмент
Подробная статистика всего сайта
Установка
Регистрация
dspace.cfg:
xmlui.google.analytics.key=UA-XXXXXX-X
Как и любой сайт, ваш архив можно подключить к
Google Analitics — удобному и мощному
средству отслеживания статистики.
Для подключения статистики от Google,
необходимо зарегистрироваться.
Если вы используете интерфейс XMLUI, то
подключение к Google Analitics обеспечивается
простым изменением свойства в файле
dspace.cfg. В противном случае код,
предоставляемый Google, следует включить в
шаблоны страниц там, где это необходимо.

86. 5. Локализация XMLUI
Главный файл настроек DSpace — dspace.cfg.

87. Языки интерфейса
dspace.cfg
xmlui.supported.locales = ru, uk, en
соответствующие файлы переводов
messages.xml — основной (русский)
messages_uk.xml
messages_en.xml
В файле настроек dspace.cfg нужно перечислить
двухбуквенные коды языков, которые будет
поддерживать интерфейс вашего архива.
Для каждого языка должен существовать свой
файл перевода.

88. Файлы переводов
1. Создать каталог
[dspace-source]/dspace/modules/xmlui/src/main/webapp/i18n/
2. Скопировать в него файл
[dspace-source]/dspace-xmlui/dspace-xmlui-webapp/
src/main/webapp/i18n/messages.xml
и перевести его
3. Дополнительные языки
messages_de.xml, messages_uk.xml, ...
В версии 1.7.0 переключение языков с помощью
кнопок не поддерживается, ожидается в версии
1.8.0, но может быть установлено отдельно.
Сейчас XMLUI использует предпочтения
пользователя, указанные в настройках
браузера. Если для предпочтительного языка
найден соответствующий файл
messages_XX.xml (XX — двухбуквенный код
языка), то используется этот перевод. Если не
найден, то используется основной файл
messages.xml.
Все файлы нужно сохранять в кодировке UTF-8.

89. Проблемы
Нет переключения кнопками
Не всё переводится
Письма
Названия/описания
разделов/коллекций/документов
Более привычная практика переключения языков
— кнопки или ссылки вверху страницы — в
DSpace пока что не реализована. В браузерах с
разными языковыми настройками можно
увидеть различный интерфейс, что тоже может
быть неудобно, поскольку переключение языка
происходит незаметно для пользователя.
К недостаткам также можно отнести, что
переводятся только основные элементы
интерфейса, но не данные, добавляемые в
процессе работы архива.

90. 6. XMLUI
Главный файл настроек DSpace — dspace.cfg.

91. Регистрация
Разрешить регистрацию?
xmlui.user.registration = true
Разрешить редактировать профиль?
xmlui.user.editmetadata = true
Куда после входа?
xmlui.user.loginredirect=/profile
Можно запретить новым пользователям
самостоятельно регистрироваться. В этом
случае зарегистрировать новых пользователей
сможет администратор.
Аналогично можно запретить пользователям
изменять свой профиль.
Можно указать на какую именно страницу
попадает пользователь после входа в систему.

92. Текст на главной
Шаблон в файле:
[dspace-source]/dspace/config/news-xmlui.xml
Не HTML
пример ссылки
<xref target="http://myuni.edu/">My University</xref>
Можно локализовать
пример фразы
<i18n:text>myuni.repo.intro</i18n:text>
Текст на домашней странице сайта можно менять
в указанном файле.
Этот файл не HTML, а файл специального
формата DRI, разработанного для XMLUI.
Примеры использования этого формата можно
найти повсюду в XMLUI. Подробное описание
выходит за рамки настоящего изложения.
Файл можно адаптировать для того, чтобы
работало переключение языков. Делается это
способом, аналогичным другим частям
интерфейса.

93. Статический контент
Куда положить?
[dspace-source]/dspace/modules/xmlui/src/main/webapp/static/
Как ссылаться?
<link href="./static/mystyle.css" rel="stylesheet" type="text/css"/>
<img src="./static/images/some-image.jpg" alt="Картинка"/>
В XMLUI есть специальный каталог для
статитического содержимого — файлов HTML,
CSS, изображений.
Чтобы сослаться на эти объекты, формируйте
ссылку как показано на слайде.

94. Темы
Установленные темы
[dspace]/config/xmlui.xconf
в разделе <themes>
<theme name="Theme 1" regex=".*" path="theme1/"/>
XMLUI позволяет легко изменять стиль
интерфейса благодаря т.н. темам.
Установленные темы можно отредактировать в
файле xmlui.conf в разделе <themes>. Для темы
указывается имя, регулярное выражение для
сопоставления с URL-ами, которые должны
отображаться этой темой, а также путь, по
которому расположены файлы темы.
Сопоставление с URL-ами служит для того, чтобы
можно было разные части архива отображать
разными темами.

95. Добавление новой темы
1. Скопируйте готовую тему из
[dspace-source]/dspace-xmlui/dspace-xmlui-webapp/
src/main/webbapp/themes/
в
[dspace-source]/dspace/modules/xmlui/src/main/
webbapp/themes/
2. Переименуйте каталог темы
3. Модифицируйте файлы темы
в sitemap.xmap раздел <global-variables>
4. Добавьте строку в xmlui.conf
5. Обновите DSpace
Добавление новой темы заключается в
копировании существующей темы или шаблона
темы, который находится там же.
Изменяйте файлы темы по своему усмотрению и
не забудьте применить изменения, обновив
инсталяцию DSpace.

96. 7. Процесс внесения
Open Archives Initiative — Protocol for Metadata Harvesting
Главный файл настроек DSpace — dspace.cfg.

97. Файл настроек
[dspace-source]/dspace/config/item-submission.xml
подробно откомментирован
XML формат
порядок внесения по умолчанию
Выбрать коллекцию -> Вопросы -> Описание ->
Загрузка -> Проверка -> Лицензия -> Конец
можно изменить шаги или порядок
<submission-definition>
для разных коллекций
<submission-map>

98. Формы ввода
[dspace-source]/dspace/config/input-forms.xml
количество полей ввода
их последовательность и размещение
текстовые надписи
списки вариантов