Page History

...

Open dspace.cfg and find the heading "###### Browse Configuration ######"  Scrolling down you will see uncommented lines that read " webui.browse.index...index…" this is where you will edit and add lines. 

Wiki MarkupThe browse functions are written as "webui.browse.index.# = \ [name\]:metadata:\[schema\].\[element\].\[qualifier\]:\[field type\]"

• The name is what you want to call the browse field you are creating
• After the name some fields have the word "item" these fields special and do not conform to the same syntax as others, for the field you are adding use "metadata" after the name.
• Set the schema, element and qualifier to the field you want to browse by.  Qualifiers can be replaced with "" and all occurrences of that element will be listed regardless of qualifiers, for example "dc.subject." lists both dc.subject and dc.subject.lcsh.
• For field type select "text" for most fields.  The other options are "date" for date fields and "title" for fields that have unique entries only allowing the browse items to link to a single item.
• The order these items are listed in is the order they will appear in the browse navigation pane.

...

Open message.xml and find the heading <!- org.dspace.app.xmlui.artifactbrowser.ConfigureableBrowse.java ->.  You need to add four lines for each new browse category in this section. If you look through the section you will see the same lines for the preexisting browse categories scattered through the text.

Wiki MarkupFirst add "<message key="xmlui.ArtifactBrowser.ConfigurableBrowse.\[name\].column_heading">\[Browse Name\]</message>" Where \ [name\] is the name you assigned in dspace.cfg and \ [Browse Name\] is the title you want to appear in browse menu in DSpace.&nbsp;   These fields are the text displayed at the top of a browse list.

Then add the lines

<message key="xmlui.ArtifactBrowser.ConfigurableBrowse.title.metadata.[name]">Browsing {0} by [Browse Field] {1}</message>
<message key="xmlui.ArtifactBrowser.ConfigurableBrowse.trail.metadata.[name]">Browsing {0} by [Browse Field] </message>

Wiki MarkupWhere \ [name\] is the name you assigned in dspace.cfg and \ [Browse Field\] is the field you are browsing by.&nbsp;   These fields create the different browse page headings.

You will also need to add a line to artifactbrowser.Navigation.java section.  Find the heading <!- org.dspace.app.xmlui.artifactbrowser.Navigation.java -> and you will see fields for the existing browse options.

Wiki MarkupAdd the line <message key="xmlui.ArtifactBrowser.Navigation.browse_\[name\]">\[Browse Field\]</message>. Where \ [name\] is the name you assigned in dspace.cfg and \ [Browse Field\] is the field you are browsing by. These lines are the text displayed in the browse navigation bar.

Re-index and Restart DSpace

Before existing items can be searched or browsed you need to re-index you instance. 

Wiki MarkupNavigate to cd \ [dspace\]/bin then type"./dspace index-init".&nbsp;   After have finished indexing restart DSpace.

Panel
This section was contributed by Catalina Oyler from the Five Colleges of Ohio