Post on 25-Dec-2014
description
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 администратораkuzma@isofts.kiev.ua
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 = lib.noreply@isofts.kiev.ua
feedback.recipient = lib.help@isofts.kiev.ua
mail.admin = lib.admin@isofts.kiev.ua
Email адресаEmail адреса
Уведомления об ошибках
Уведомления о новых регистрациях
alert.recipient = lib.alert@isofts.kiev.ua
registration.notify = lib.reg@isofts.kiev.ua
Шаблоны писемШаблоны писем
[dspace]/config/emailsкомментарии
#закомментированная строкапараметры
текст {0} текст {1} текстизменить контактные данные
dspace-help@myu.eduxxx-555-xxxx
Язык для метаданныхЯзык для метаданных
Язык по умолчанию для ввода метаданных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
Поисковый индекс LuceneПоисковый индекс Lucene
Количество индексируемых слов, не больше
Какие поля метаданных индексировать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 администратораkuzma@isofts.kiev.ua
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 сервера для отправки писем.Если требуется авторизация, укажите имя и
пароль.В отладочных целях отправку почты можно
отключить.
Email адреса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) доступна по переходу по соответствующей ссылке в интерфейсе.
Email адресаEmail адреса
Уведомления об ошибках
Уведомления о новых регистрациях
alert.recipient = lib.alert@isofts.kiev.ua
registration.notify = lib.reg@isofts.kiev.ua
Дополнительно можно указать адреса электронной почты для получения уведомлений об ошибках и получения уведомлений о регистрации новых пользователей.
Шаблоны писемШаблоны писем
[dspace]/config/emailsкомментарии
#закомментированная строкапараметры
текст {0} текст {1} текстизменить контактные данные
dspace-help@myu.eduxxx-555-xxxx
В некоторых ситуациях 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Поисковый индекс 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
По умолчанию используется поисковый анализатор DSpace для английского языка. В свойстве search.analyzer можно указать другой анализатор.
Свойство search.operator указывает, должны ли все ключевые слова из запроса встречаться в документе (значение AND) или не обязательно все (значение OR).
Чтобы применить изменения настроек поискового индекса, нужно запустить
[dspace]/bin/dspace index-init
Поисковый индекс LuceneПоисковый индекс Lucene
Количество индексируемых слов, не больше
Какие поля метаданных индексировать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 — dspace.cfg.
Свойства в 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 — dspace.cfg.
НастройкаНастройка
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 — dspace.cfg.
Языки интерфейсаЯзыки интерфейса
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
Главный файл настроек DSpace — dspace.cfg.
РегистрацияРегистрация
Разрешить регистрацию?
Разрешить редактировать профиль?
Куда после входа?
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 — dspace.cfg.
Файл настроекФайл настроек
[dspace-source]/dspace/config/item-submission.xmlподробно откомментированXML форматпорядок внесения по умолчанию
Выбрать коллекцию -> Вопросы -> Описание -> Загрузка -> Проверка -> Лицензия -> Конец
можно изменить шаги или порядок<submission-definition>
для разных коллекций<submission-map>
Формы вводаФормы ввода
[dspace-source]/dspace/config/input-forms.xmlколичество полей вводаих последовательность и размещениетекстовые надписисписки вариантов