setarea dspace

III — Настройка DSpaceIII — Настройка DSpace

© 2011© 2011 Кузьма Кудим Кузьма Кудим

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

Два расположенияДва расположения

[dspace-source]/dspace/config/dspace.cfgсчитается основным

[dspace]/config/dspace.cfgкопия предыдущего

Применение измененийПрименение изменений

1. Редактируем [dspace-source]/dspace/config/*2. Применяем изменения

3. Копируем веб-приложение на сервер

5. Перезапускаем tomcat

cd [dspace-source]/dspacemvn packagecd target/dspace-1.7.0-build.dirant -Doverwrite=true update

cp -R [dspace]/webapps/* [tomcat]/webapps

Формат файлов настроекФормат файлов настроек

Файл настроек содержит:пары свойство-значение

имеют вид 'имя.свойства = значение свойства'бывает не установлено или закомментировано

строки комментариевначинаются с символа '#'

пустые строки


Булевские значенияда/включить/разрешить — true

useProxies = trueнет/отключить/запретить — false

useProxies = false

Перенос длинных строкпробел + обратный слэш

filter.plugins = PDF Text Extractor, \ HTML Text Extractor, \ PowerPoint Text Extractor


Ссылки на другие свойства:

dspace.dir = /dspacedspace.history = ${dspace.dir}/history

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

Необходимо знать заранееНеобходимо знать заранее

Адрес сервераlib.isofts.kiev.ua

Email администратора[email protected]

SMTP серверsmtp.isofts.kiev.ua

Основные параметрыОсновные параметры

Корневая папка инсталляции

Короткое название сайта

Адрес сервера

dspace.dir = /opt/dspacedspace.dir = c:/dspace

dspace.name = ISS Library

dspace.hostname = lib.isofts.kiev.ua


Основной URL веб-приложения

Основной URL веб-интерфейса

Основной URL приложения OAI

dspace.baseUrl = http://lib.isofts.kiev.ua:8080

dspace.url = ${dspace.baseUrl}/xmlui

dspace.oai.url = ${dspace.baseUrl}/oai

База данныхБаза данных

Какая СУБД используется

Имя пользователя

Пароль

db.name = postgresdb.name = oracle

db.username = dspace

db.password = dspace

Почтовый серверПочтовый сервер

Адрес и порт SMTP сервера

Имя и пароль, если нужно

Отключить отправку писем? (true/false)

mail.server.username = kuzmamail.server.password = top!secret

mail.server = smtp.isofts.kiev.uamail.server.port = 25

mail.server.disabled = false

Email адресаEmail адреса

Поле From: в письмах

Обратная связь

Администратор

mail.from.address = [email protected]

feedback.recipient = [email protected]

mail.admin = [email protected]


Уведомления об ошибках

Уведомления о новых регистрациях

alert.recipient = [email protected]

registration.notify = [email protected]

Шаблоны писемШаблоны писем

[dspace]/config/emailsкомментарии

#закомментированная строкапараметры

текст {0} текст {1} текстизменить контактные данные

[email protected]

Язык для метаданныхЯзык для метаданных

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

Хранилище файловХранилище файлов

Путь к хранилищу номер 0

Путь к хранилищу номер 1, 2, 3, ...

Номер хранилища для новых поступлений

assetstore.dir = ${dspace.dir}/assetstore

assetstore.dir.1 = /another/assetstore

assetstore.incoming = 1

ЛогиЛоги

Файл настройки логов

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

log.dir = ${dspace.dir}/log

Поисковый индекс LuceneПоисковый индекс Lucene

Где хранить файлы индекса

Какой анализатор Lucene использовать

AND или OR в запросе

search.dir = ${dspace.dir}/search

search.analyzer = org.dspace.search.DSAnalyzer

search.analyzer = org.apache.lucene.analysis.ru.RussianAnalyzer

search.operator = OR


Количество индексируемых слов, не больше

Какие поля метаданных индексироватьsearch.index.[n] = [метка]:[поле метаданных]

search.maxfieldlength = 10000search.maxfieldlength = -1

search.index.1 = author:dc.contributor.*search.index.2 = author:dc.creator.*search.index.3 = title:dc.title.*...

Handle-серверHandle-сервер

URL сервиса постоянных ссылок

Префикс постоянной ссылки

handle.canonical.prefix = http://hdl.handle.net/handle.canonical.prefix = ${dspace.url}/handle/

handle.prefix = 123456789

Видимость скрытогоВидимость скрытого

Показывать (true) или нет (false) скрытые документы

в RSS

в OAI

в подписках

harvest.includerestricted.rss = true

harvest.includerestricted.oai = true

harvest.includerestricted.subscription = true

ПроксиПрокси

Сервер

Порт

DSpace за прокси-сервером?

http.proxy.host = proxy.isofts.kiev.ua

http.proxy.port = 2048

useProxies = true

*Суб-администраторы*Суб-администраторы

Разрешить или запретить администраторам отдельных разделов:

создавать/удалять подразделыуправлять

правиламиадминистраторамишаблонами. . .

*Методы аутентификации*Методы аутентификации

Стек методов аутентификацииМетоды:

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

3. Эмбарго3. Эмбарго

Свойства в dspace.cfgСвойства в dspace.cfg

Поле метаданных для сроков

Поле метаданных для окончания

Значение неограниченного эмбарго

embargo.field.terms = dc.embargo.terms

embargo.field.lift = dc.embargo.liftdate

embargo.terms.open = всегда

Продолжение настройкиПродолжение настройки

1. Добавить в реестр метаданных новые поля2. В файле [dspace]/config/input-forms.xml

добавить поле ввода для embargo.field.terms3. Обновить DSpace4. Регулярно запускать проверку сроков[dspace]/bin/dspace embargo-lifter -l

Изменения в input-forms.xmlИзменения в 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>

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

НастройкаНастройка

dspace.cfgраздел SOLR Statistics

dstat.cfgдата началасписок полейи другие параметры статистики

ИнициализацияИнициализация

Первый сбор статистики

Создание первого отчёта[dspace]/bin/dspace stat-initial

[dspace]/bin/dspace stat-report-initial

Регулярное выполнениеРегулярное выполнение

Задания cron0 1 * * * [dspace]/bin/dspace stat-general0 1 * * * [dspace]/bin/dspace stat-monthly0 2 * * * [dspace]/bin/dspace stat-report-general0 2 * * * [dspace]/bin/dspace stat-report-monthly

ПросмотрПросмотр

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

Google AnaliticsGoogle Analitics

ПреимуществаУниверсальный и мощный инструментПодробная статистика всего сайта

УстановкаРегистрацияdspace.cfg:

xmlui.google.analytics.key=UA-XXXXXX-X

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

Языки интерфейсаЯзыки интерфейса

dspace.cfg

соответствующие файлы переводовmessages.xml — основной (русский)messages_uk.xmlmessages_en.xml

xmlui.supported.locales = ru, uk, en

Файлы переводовФайлы переводов

1. Создать каталог

2. Скопировать в него файл

и перевести его3. Дополнительные языки

[dspace-source]/dspace/modules/xmlui/src/main/webapp/i18n/

[dspace-source]/dspace-xmlui/dspace-xmlui-webapp/ src/main/webapp/i18n/messages.xml

messages_de.xml, messages_uk.xml, ...

ПроблемыПроблемы

Нет переключения кнопкамиНе всё переводится

ПисьмаНазвания/описания разделов/коллекций/документов

6. XMLUI6. XMLUI

РегистрацияРегистрация

Разрешить регистрацию?

Разрешить редактировать профиль?

Куда после входа?

xmlui.user.registration = true

xmlui.user.editmetadata = true

xmlui.user.loginredirect=/profile

Текст на главнойТекст на главной

Шаблон в файле:

Не HTMLпример ссылки

Можно локализоватьпример фразы

[dspace-source]/dspace/config/news-xmlui.xml

<xref target="http://myuni.edu/">My University</xref>

<i18n:text>myuni.repo.intro</i18n:text>

Статический контентСтатический контент

Куда положить?

Как ссылаться?

[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="Картинка"/>

ТемыТемы

Установленные темы

в разделе <themes>

[dspace]/config/xmlui.xconf

<theme name="Theme 1" regex=".*" path="theme1/"/>

Добавление новой темыДобавление новой темы

1. Скопируйте готовую тему из

в

2. Переименуйте каталог темы3. Модифицируйте файлы темы

в sitemap.xmap раздел <global-variables>

4. Добавьте строку в xmlui.conf5. Обновите DSpace

[dspace-source]/dspace-xmlui/dspace-xmlui-webapp/ src/main/webbapp/themes/

[dspace-source]/dspace/modules/xmlui/src/main/webbapp/themes/

7. Процесс внесения7. Процесс внесения

Open Archives Initiative — Protocol for Metadata HarvestingOpen Archives Initiative — Protocol for Metadata Harvesting

Файл настроекФайл настроек

[dspace-source]/dspace/config/item-submission.xmlподробно откомментированXML форматпорядок внесения по умолчанию

Выбрать коллекцию -> Вопросы -> Описание -> Загрузка -> Проверка -> Лицензия -> Конец

можно изменить шаги или порядок<submission-definition>

для разных коллекций<submission-map>

Формы вводаФормы ввода

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

III — Настройка DSpaceIII — Настройка DSpace

© 2011© 2011 Кузьма Кудим Кузьма Кудим

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

Два расположенияДва расположения

[dspace-source]/dspace/config/dspace.cfgсчитается основным

[dspace]/config/dspace.cfgкопия предыдущего

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

Папка [dspace-source] счиается основной при внесении изменений.

Применение измененийПрименение изменений

1. Редактируем [dspace-source]/dspace/config/*2. Применяем изменения

3. Копируем веб-приложение на сервер

5. Перезапускаем tomcat

cd [dspace-source]/dspacemvn packagecd target/dspace-1.7.0-build.dirant -Doverwrite=true update

cp -R [dspace]/webapps/* [tomcat]/webapps

Так как DSpace хранит настройки в двух местах (см. пред. слайд), а использует при работе только папку [dspace], то возникает соблазн изменять только файлы в папке [dspace]. Так делать не следует, иначе можно потерять свои изменения при обновлениях! Правильная последовательность действий такая: любые изменения вносятся в [dspace-source], после чего обновляется инсталляция DSpace.

Описанный способ пригоден для внесения любых изменений в DSpace.


Файл настроек содержит:пары свойство-значение

имеют вид 'имя.свойства = значение свойства'бывает не установлено или закомментировано

строки комментариевначинаются с символа '#'

пустые строки


Булевские значенияда/включить/разрешить — true

useProxies = trueнет/отключить/запретить — false

useProxies = false

Перенос длинных строкпробел + обратный слэш

filter.plugins = PDF Text Extractor, \ HTML Text Extractor, \ PowerPoint Text Extractor

Многие свойства могут иметь лишь два значения типа да/нет или включить/выключить. Для таких свойтств-флагов используются специальные значения true (правда) и false (ложь).

С целью улучшения читабельности для переноса слишком длинных строк вставьте пробел и обратный слэш (' \') непосредственно перед местом переноса.


Ссылки на другие свойства:

dspace.dir = /dspacedspace.history = ${dspace.dir}/history

Значение свойства может ссылаться на другие свойства как в примере.

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

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

Необходимо знать заранееНеобходимо знать заранее

Адрес сервераlib.isofts.kiev.ua

Email администратора[email protected]

SMTP серверsmtp.isofts.kiev.ua

Прежде, чем приступать к установке, нужно как минимум знать следующие вещи:

- адрес сервера, на котором проводится установка;

- email первого администратора;- адрес SMTP сервера для отправки писем (при

регистрации, для рассылок, и т. п.).


Корневая папка инсталляции

Короткое название сайта

Адрес сервера

dspace.dir = /opt/dspacedspace.dir = c:/dspace

dspace.name = ISS Library

dspace.hostname = lib.isofts.kiev.ua

Короткое название сайта используется в веб-интерфейсе, в письмах и других местах (например, в OAI).


Основной URL веб-приложения

Основной URL веб-интерфейса

Основной URL приложения OAI

dspace.baseUrl = http://lib.isofts.kiev.ua:8080

dspace.url = ${dspace.baseUrl}/xmlui

dspace.oai.url = ${dspace.baseUrl}/oai

Свойство dspace.baseUrl задаёт URL, по которому доступно развёрнутое на сервере веб-приложение DSpace.

Свойство dspace.url задаёт URL, по которому доступен веб-интерфейс DSpace. Поскольку изначально DSpace состоит из нескольких приложений, то это значение обычно отличается от первого.

База данныхБаза данных

Какая СУБД используется

Имя пользователя

Пароль

db.name = postgresdb.name = oracle

db.username = dspace

db.password = dspace

С помощью указанных параметров задаётся доступ к базе данных. Поддерживается две СУБД — Postgre и Oracle.

Почтовый серверПочтовый сервер

Адрес и порт SMTP сервера

Имя и пароль, если нужно

Отключить отправку писем? (true/false)

mail.server.username = kuzmamail.server.password = top!secret

mail.server = smtp.isofts.kiev.uamail.server.port = 25

mail.server.disabled = false

Параметры SMTP сервера для отправки писем.Если требуется авторизация, укажите имя и

пароль.В отладочных целях отправку почты можно

отключить.


Поле From: в письмах

Обратная связь

Администратор

mail.from.address = [email protected]

feedback.recipient = [email protected]

mail.admin = [email protected]

Здесь указываются основные адреса электронной почты.

Обратная связь (feedback) доступна по переходу по соответствующей ссылке в интерфейсе.


Уведомления об ошибках

Уведомления о новых регистрациях

alert.recipient = [email protected]

registration.notify = [email protected]

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

Шаблоны писемШаблоны писем

[dspace]/config/emailsкомментарии

#закомментированная строкапараметры

текст {0} текст {1} текстизменить контактные данные

[email protected]

В некоторых ситуациях DSpace автоматически рассылает письма пользователям. Например, для оповещения о новых пополнения или при смене пароля. Шаблоны всех таких писем хранятся в папке [dspace]/config/emails.

Каждый файл содержит закомментированные пояснения. Строки комментариев начинаются с символа '#' и не вставляются в текст письма.

В шаблонах писем также используются подстановочные параметры в виде числа в фигурных скобках: {0}, {1}, {2}, .... В письме вместо параметров подставляется нужный текст, какой именно — разъяснено в комментариях.

Встречающиеся в файлах контактные данные приведы лишь для примера, их следует отредактировать.

Язык для метаданныхЯзык для метаданных

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

Свойство default.language используется, если язык не указан явно в файле input-forms.xml

Хранилище файловХранилище файлов

Путь к хранилищу номер 0

Путь к хранилищу номер 1, 2, 3, ...

Номер хранилища для новых поступлений

assetstore.dir = ${dspace.dir}/assetstore

assetstore.dir.1 = /another/assetstore

assetstore.incoming = 1

Файлы не хранятся в базе данных вместе с метаданными, а сохраняются в папке на диске. Изначально используется хранилище под номером 0, путь к которому задаётся параметром assetstore.dir.

В последствии для размещения новых файлов в другую папку можно задать хранилище номер 1, 2, 3, ... с помощью свойства assetstore.dir.1 (с нужным номером вместо 1).

Свойство assetstore.incoming определяет какое именно хранилище используется для добавления новых фалов в настоящий момент.

ЛогиЛоги

Файл настройки логов

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

log.dir = ${dspace.dir}/log


Где хранить файлы индекса

Какой анализатор Lucene использовать

AND или OR в запросе

search.dir = ${dspace.dir}/search

search.analyzer = org.dspace.search.DSAnalyzer

search.analyzer = org.apache.lucene.analysis.ru.RussianAnalyzer

search.operator = OR

По умолчанию используется поисковый анализатор DSpace для английского языка. В свойстве search.analyzer можно указать другой анализатор.

Свойство search.operator указывает, должны ли все ключевые слова из запроса встречаться в документе (значение AND) или не обязательно все (значение OR).

Чтобы применить изменения настроек поискового индекса, нужно запустить

[dspace]/bin/dspace index-init


Количество индексируемых слов, не больше

Какие поля метаданных индексироватьsearch.index.[n] = [метка]:[поле метаданных]

search.maxfieldlength = 10000search.maxfieldlength = -1

search.index.1 = author:dc.contributor.*search.index.2 = author:dc.creator.*search.index.3 = title:dc.title.*...

Свойство search.maxfieldlength задаёт максимальное количество слов в поле метаданных, которое будет проиндексировано. Если предполагается выполнять полнотекстовый поиск по достаточно большим документам, это значение нужно увеличить. Значение -1 снимает ограничение.

В списке свойств вида search.index.[n] = [метка]:[поле метаданных]

перечислены поля метаданных, которые будут проиндексированы. Символ '*' означает любое окончание. Метка задаёт имя для поискового поля, несколько полей метаданных могут соответствовать одному поисковому полю (одинаковая метка). Изменение перечня не изменяет поисковый интерфейс.

Handle-сервер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 указывается префикс, выданный службой постоянных ссылок. Если служба не используется, то любая строка.

Видимость скрытогоВидимость скрытого

Показывать (true) или нет (false) скрытые документы

в RSS

в OAI

в подписках

harvest.includerestricted.rss = true

harvest.includerestricted.oai = true

harvest.includerestricted.subscription = true

Если для доступа к некоторым документам у анонимных пользователей нет права на чтение, то по умолчанию такие документы всё равно будут видны в RSS, OAI и подписках.

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

ПроксиПрокси

Сервер

Порт

DSpace за прокси-сервером?

http.proxy.host = proxy.isofts.kiev.ua

http.proxy.port = 2048

useProxies = true

Свойство useProxies используется для ведения логов и для авторизации по IP-адресу, чтобы правильно определять IP-адрес из заголовков запросов HTTP.

*Суб-администраторы*Суб-администраторы

Разрешить или запретить администраторам отдельных разделов:

создавать/удалять подразделыуправлять

правиламиадминистраторамишаблонами. . .

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

*Методы аутентификации*Методы аутентификации

Стек методов аутентификацииМетоды:

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

Можно указать несколько методов аутентификации, тогда они будут применяться последовательно, пока один один из них не сработает.

По умолчанию действует единственный метод — аутентификация по паролю.

Существует поддержка и других методов.Возможно подключение своего метода.

3. Эмбарго3. Эмбарго


Свойства в dspace.cfgСвойства в dspace.cfg

Поле метаданных для сроков

Поле метаданных для окончания

Значение неограниченного эмбарго

embargo.field.terms = dc.embargo.terms

embargo.field.lift = dc.embargo.liftdate

embargo.terms.open = всегда

Чтобы установить эмбарго, изменить несколько свойств в файле dspace.cfg.

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

Можно также выбрать слово, которое будет обозначать неограниченное эмбарго.

Здесь приведен порядок действий по настройке эмбарго.

Новые поля, введённые на предыдущем слайде, посредством административного веб-интерфейса нужно добавить в реестр метаданных, иначе они останутся неизвестны системе.

Для отображения поля ввода для срока эмбарго необходимо изменить интерфейс в файле input-forms.xml как показано на следующем слайде.

После всех изменений не забудьте обновить DSpace как рассказано на слайде "Обновление настроек".

Необходимо регулярно выполнять проверку истечения сроков эмбарго с помощью указанной программы.

Продолжение настройкиПродолжение настройки

1. Добавить в реестр метаданных новые поля2. В файле [dspace]/config/input-forms.xml

добавить поле ввода для embargo.field.terms3. Обновить DSpace4. Регулярно запускать проверку сроков[dspace]/bin/dspace embargo-lifter -l

Изменения в input-forms.xmlИзменения в 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 для отображения в пользовательском интерфесе поля ввода для даты эмбарго.

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


НастройкаНастройка

dspace.cfgраздел SOLR Statistics

dstat.cfgдата началасписок полейи другие параметры статистики

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

ИнициализацияИнициализация

Первый сбор статистики

Создание первого отчёта[dspace]/bin/dspace stat-initial

[dspace]/bin/dspace stat-report-initial

Подготовительный запуск системы сбора статистики.

Регулярное выполнениеРегулярное выполнение

Задания cron0 1 * * * [dspace]/bin/dspace stat-general0 1 * * * [dspace]/bin/dspace stat-monthly0 2 * * * [dspace]/bin/dspace stat-report-general0 2 * * * [dspace]/bin/dspace stat-report-monthly

После инициализации программы обработки статистистики следует запускать регулярно. Как и при инициализации, первые две строки отвечают за анализ статистики, а вторые — за создание отчётов в html. Первая и третья строка анализирует статистику от стартовой даты, указанной в файле dstat.cfg. Вторая и четвёртая строка — это статистика с разбивкой по месяцам.

ПросмотрПросмотр

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

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

Google AnaliticsGoogle Analitics

ПреимуществаУниверсальный и мощный инструментПодробная статистика всего сайта

УстановкаРегистрацияdspace.cfg:

xmlui.google.analytics.key=UA-XXXXXX-X

Как и любой сайт, ваш архив можно подключить к Google Analitics — удобному и мощному средству отслеживания статистики.

Для подключения статистики от Google, необходимо зарегистрироваться.

Если вы используете интерфейс XMLUI, то подключение к Google Analitics обеспечивается простым изменением свойства в файле dspace.cfg. В противном случае код, предоставляемый Google, следует включить в шаблоны страниц там, где это необходимо.

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


Языки интерфейсаЯзыки интерфейса

dspace.cfg

соответствующие файлы переводовmessages.xml — основной (русский)messages_uk.xmlmessages_en.xml

xmlui.supported.locales = ru, uk, en

В файле настроек dspace.cfg нужно перечислить двухбуквенные коды языков, которые будет поддерживать интерфейс вашего архива.

Для каждого языка должен существовать свой файл перевода.

Файлы переводовФайлы переводов

1. Создать каталог

2. Скопировать в него файл

и перевести его3. Дополнительные языки

[dspace-source]/dspace/modules/xmlui/src/main/webapp/i18n/

[dspace-source]/dspace-xmlui/dspace-xmlui-webapp/ src/main/webapp/i18n/messages.xml

messages_de.xml, messages_uk.xml, ...

В версии 1.7.0 переключение языков с помощью кнопок не поддерживается, ожидается в версии 1.8.0, но может быть установлено отдельно.

Сейчас XMLUI использует предпочтения пользователя, указанные в настройках браузера. Если для предпочтительного языка найден соответствующий файл messages_XX.xml (XX — двухбуквенный код языка), то используется этот перевод. Если не найден, то используется основной файл messages.xml.

Все файлы нужно сохранять в кодировке UTF-8.

ПроблемыПроблемы

Нет переключения кнопкамиНе всё переводится

ПисьмаНазвания/описания разделов/коллекций/документов

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

К недостаткам также можно отнести, что переводятся только основные элементы интерфейса, но не данные, добавляемые в процессе работы архива.

6. XMLUI6. XMLUI


РегистрацияРегистрация

Разрешить регистрацию?

Разрешить редактировать профиль?

Куда после входа?

xmlui.user.registration = true

xmlui.user.editmetadata = true

xmlui.user.loginredirect=/profile

Можно запретить новым пользователям самостоятельно регистрироваться. В этом случае зарегистрировать новых пользователей сможет администратор.

Аналогично можно запретить пользователям изменять свой профиль.

Можно указать на какую именно страницу попадает пользователь после входа в систему.

Текст на главнойТекст на главной

Шаблон в файле:

Не HTMLпример ссылки

Можно локализоватьпример фразы

[dspace-source]/dspace/config/news-xmlui.xml

<xref target="http://myuni.edu/">My University</xref>

<i18n:text>myuni.repo.intro</i18n:text>

Текст на домашней странице сайта можно менять в указанном файле.

Этот файл не HTML, а файл специального формата DRI, разработанного для XMLUI. Примеры использования этого формата можно найти повсюду в XMLUI. Подробное описание выходит за рамки настоящего изложения.

Файл можно адаптировать для того, чтобы работало переключение языков. Делается это способом, аналогичным другим частям интерфейса.

Статический контентСтатический контент

Куда положить?

Как ссылаться?

[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, изображений.

Чтобы сослаться на эти объекты, формируйте ссылку как показано на слайде.

ТемыТемы

Установленные темы

в разделе <themes>

[dspace]/config/xmlui.xconf

<theme name="Theme 1" regex=".*" path="theme1/"/>

XMLUI позволяет легко изменять стиль интерфейса благодаря т.н. темам. Установленные темы можно отредактировать в файле xmlui.conf в разделе <themes>. Для темы указывается имя, регулярное выражение для сопоставления с URL-ами, которые должны отображаться этой темой, а также путь, по которому расположены файлы темы.

Сопоставление с URL-ами служит для того, чтобы можно было разные части архива отображать разными темами.

Добавление новой темыДобавление новой темы

1. Скопируйте готовую тему из

в

2. Переименуйте каталог темы3. Модифицируйте файлы темы

в sitemap.xmap раздел <global-variables>4. Добавьте строку в xmlui.conf5. Обновите DSpace

[dspace-source]/dspace-xmlui/dspace-xmlui-webapp/ src/main/webbapp/themes/

[dspace-source]/dspace/modules/xmlui/src/main/webbapp/themes/

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

Изменяйте файлы темы по своему усмотрению и не забудьте применить изменения, обновив инсталяцию DSpace.

7. Процесс внесения7. Процесс внесения

Open Archives Initiative — Protocol for Metadata HarvestingOpen Archives Initiative — Protocol for Metadata Harvesting


Файл настроекФайл настроек

[dspace-source]/dspace/config/item-submission.xmlподробно откомментированXML форматпорядок внесения по умолчанию

Выбрать коллекцию -> Вопросы -> Описание -> Загрузка -> Проверка -> Лицензия -> Конец

можно изменить шаги или порядок<submission-definition>

для разных коллекций<submission-map>

Формы вводаФормы ввода

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

setarea dspace

Education