2007年10月23日更新

カスタマイズ

このページでは、

  • DSpaceのソースディレクトリを、[dspace-source](このサイトでは、/usr/local/src/dspace-1.4.2-source)
  • DSpaceのインストールディレクトリを[dspace](このサイトでは、/usr/local/dspace)
  • Apache Tomcatのインストールディレクトリを[tomcat](このサイトでは、/usr/local/apache-tomcat-6.0.14)

とする。また、特に断りのない限り、DSpace 1.4.2について記述している。

ダブリンコアレジストリのカスタマイズ

2つの方法がある。ただし、メタデータ入力画面には変更が反映されないので、次項の操作を行なう必要がある。なお、DSpace 1.4から複数のメタデータスキーマを設定できるようになった。

XMLファイルを編集

[dspace-source]/config/registries/dublin-core-types.xmlを編集する。これは、初回の構築時(ant fresh_install)にのみ適用可能。

例えば、Element:subject, qualifier:ndcを追加したい場合には、

  <dc-type>
    <schema>dc</schema>
    <element>subject</element>
    <qualifier>ndc</qualifier>
    <scope_note>Nippon Decimal Classification</scope_note>
  </dc-type>

を追加する。そして、"ant fresh_install"を実行する。

管理用のページで設定する

http://[ホスト名]/dspace/dspace-adminに、管理者でログインし、ダブリン・コアタイプレジストリを編集してもよい。

メタデータ入力画面のカスタマイズ

[dspace]/config/input-forms.xmlを編集する。

例(NDCを追加する)

   <form name="traditional">
     <page number="1">
       ........
       <field>
         <dc-element>subject</dc-element>
         <dc-qualifier>ndc</dc-qualifier>
         <!-- An input-type of twobox MUST be marked as repeatable -->
         <repeatable>false</repeatable>
         <label>NDC</label>
         <input-type>onebox</input-type>
         <hint>NDCを入力してください。<br/>
         Input the NDC of the main content of the item. <br/>
         </hint>
         <required></required>
       </field>
       ........
     </page>

検索インデックスの設定

[dspace-source]/docs/configure.html#search-indexの"Configuring Lucene Search Indexes"を参考に、[dspace]/config/dspace.cfgを変更する。

Webユーザインターフェースのカスタマイズ

[dspace-source]/jsp以下のファイルを、[dspace-source]/jsp/local以下に同じ構造で作成する。

例えば、ヘッダのロゴを変更したい場合、

> cd [dspace-source]/jsp/local
> mkdir layout
> mkdir image
> cd layout
> cp [dspace-source]/jsp/layout/header-default.jsp .
> vi header-default.jsp
<a href="<%= request.getContextPath() %>/"><img src="<%= req
uest.getContextPath() %>/image/dspace-blue.gif" alt="<fmt:message key="jsp.layou
t.header-default.alt"/>" width="198" height="79" border="0"/></a></td>
<td class="tagLine" width="99%"> <%-- Make as wide as possib
le. cellpadding repeated for broken NS 4.x --%>
<a class="tagLineText" target="_blank" href="http://www.dspa
ce.org/"><fmt:message key="jsp.layout.header-default.about"/></a>

上記の、dspace-blue.gifをロゴの画像ファイル名に変更。width, heightをそれに合わせる。

> cp [ロゴ画像ファイル] ../image
(再コンパイルする。)
> cd [dspace-source]
> ant -Dconfig=[dspace]/config/dspace.cfg build_wars
> cp build/dspace.war /usr/local/apache-6.0.14/webapp/
> rm -r /usr/local/apache-6.0.14/webapp/dspace
> [tomcat]/bin/shutdown.sh
> [tomcat]/bin/startup.sh

ライセンス表示のカスタマイズ

DSpaceに管理者でログインすると、左メニューに「デフォルトライセンス編集」がある。ここでライセンスを編集することができる。または、[dspace]/config/default.licenseを編集し、DSpaceを再構築してもよい。

電子メールの雛形

[dspace]/config/emails以下にあるファイルを修正する。Tomcatの再起動および再コンパイルは不要。

NIIからのメタデータ・ハーベスティング対応

メタデータをNIIからハーベスティングされるようにするには、junii(NIIメタデータ記述要素)に対応する必要がある。

※ 今後、junii2へ移行する予定

Crosswalkソースの追加

[dspace-source]/src/org/dspace/app/oai/に、JUNIICrosswalk.javaを作成する。この例は、学術機関リポジトリ構築ソフトウェア実装実験プロジェクト報告書の、61-62ページにあるので、適宜修正して使用すればよい。

[dspace]/config/templates/oaicat.propertiesの修正

Crosswalks.oai_dc=org.dspace.app.oai.OAIDCCrosswalk
の次に、
Crosswalks.junii=org.dspace.app.oai.JUNIICrosswalk
を追加

[dspace]/config/dspace.cfgの修正

最後に、

junii.userid = A00000 <-- 利用者番号
junii.fano = FA000000 <-- 参加組織ID
junii.institution = Hoge University Library

を追加する。値は、それぞれの機関に合わせて変更すること。日本語を使用する場合には、native2asciiを用いてエンコードする。

確認

DSpaceを更新した後、ブラウザで、

http://[ホスト名(:ポート番号)]/dspace-oai/request?verb=ListRecords&metadataPrefix=junii

にアクセスしてみて、正常に表示されるか確認してみる。

なお、"http://[ホスト名(:ポート番号)]/dspace-oai/request"の部分を、baseURLという。